From fcacc8df1fe17c127021dffcfa1c8de93b593466 Mon Sep 17 00:00:00 2001 From: Maik1999 Date: Sun, 25 Feb 2018 18:33:59 +0100 Subject: [PATCH 01/29] Added link to pull request 62 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 5f169e1..a7a35d7 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ Here are some demos running directly in the browser: * only use testing data * [ ] Support for saving / restoring network (see [#50](https://github.com/CodingTrain/Toy-Neural-Network-JS/pull/50)) * [ ] Support for different activation functions (see [#45](https://github.com/CodingTrain/Toy-Neural-Network-JS/pull/45), [#62](https://github.com/CodingTrain/Toy-Neural-Network-JS/pull/62)) -* [ ] Support for multiple hidden layers (see #61) +* [ ] Support for multiple hidden layers (see [#61](https://github.com/CodingTrain/Toy-Neural-Network-JS/pull/61)) * [ ] Support for neuro-evolution * [ ] play flappy bird (many players at once). * [ ] play pong (many game simulations at once) From d641c86be90c83834b34dff68749a10a9b24c8e6 Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Fri, 2 Mar 2018 18:29:15 -0500 Subject: [PATCH 02/29] adding new doodle classifier example Dear Diary, I spent the day recording a set of video tutorials about how to do image classification with a simple "toy" neural network. There are lots of problems with this and the goal is purely educational and to have some fun. I hope to improve this example in the future. It could use an intrface and some animations, the softmax function, and working with a larger dataset and ml5/deeplearn.js. yours forever, The Coding Train (choo choo) --- .../doodle_classification/data/cats1000.bin | Bin 0 -> 784000 bytes .../data/rainbows1000.bin | Bin 0 -> 784000 bytes .../doodle_classification/data/trains1000.bin | Bin 0 -> 784000 bytes examples/doodle_classification/dataprep.js | 15 +++ examples/doodle_classification/index.html | 34 ++++++ .../libraries/p5.dom.min.js | 1 + .../doodle_classification/libraries/p5.min.js | 13 +++ examples/doodle_classification/loadbinary.js | 21 ++++ examples/doodle_classification/sketch.js | 107 ++++++++++++++++++ examples/doodle_classification/traintest.js | 41 +++++++ 10 files changed, 232 insertions(+) create mode 100644 examples/doodle_classification/data/cats1000.bin create mode 100644 examples/doodle_classification/data/rainbows1000.bin create mode 100644 examples/doodle_classification/data/trains1000.bin create mode 100644 examples/doodle_classification/dataprep.js create mode 100644 examples/doodle_classification/index.html create mode 100644 examples/doodle_classification/libraries/p5.dom.min.js create mode 100644 examples/doodle_classification/libraries/p5.min.js create mode 100644 examples/doodle_classification/loadbinary.js create mode 100644 examples/doodle_classification/sketch.js create mode 100644 examples/doodle_classification/traintest.js diff --git a/examples/doodle_classification/data/cats1000.bin b/examples/doodle_classification/data/cats1000.bin new file mode 100644 index 0000000000000000000000000000000000000000..d26d9690de498d35f0112292c57c8a40401bdf63 GIT binary patch literal 784000 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®JYfiMeS?py!Qb@%f?KFav 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
L*-%<}C!)uST^R^cn-2?VLWMoDABkyqeO!;&T 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

@y`K9BxNbjAaTYXQ_b7YTb(IlF$)ER1>tVlG> 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 y>`%M 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 literal 0 HcmV?d00001 diff --git a/examples/doodle_classification/data/rainbows1000.bin b/examples/doodle_classification/data/rainbows1000.bin new file mode 100644 index 0000000000000000000000000000000000000000..dba9598feb894b1e1c62ba42357e7a19fa074978 GIT binary patch literal 784000 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 KRnfmH@_zt|c$l*Q literal 0 HcmV?d00001 diff --git a/examples/doodle_classification/data/trains1000.bin b/examples/doodle_classification/data/trains1000.bin new file mode 100644 index 0000000000000000000000000000000000000000..881c337a5f47f233912edcf90b1bfbc3f9591782 GIT binary patch literal 784000 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 literal 0 HcmV?d00001 diff --git a/examples/doodle_classification/dataprep.js b/examples/doodle_classification/dataprep.js new file mode 100644 index 0000000..9ae5084 --- /dev/null +++ b/examples/doodle_classification/dataprep.js @@ -0,0 +1,15 @@ +function prepareData(category, data, label) { + category.training = []; + category.testing = []; + for (let i = 0; i < totalData; i++) { + let offset = i * len; + let threshold = floor(0.8 * totalData); + if (i < threshold) { + category.training[i] = data.bytes.subarray(offset, offset + len); + category.training[i].label = label; + } else { + category.testing[i - threshold] = data.bytes.subarray(offset, offset + len); + category.testing[i - threshold].label = label; + } + } +} diff --git a/examples/doodle_classification/index.html b/examples/doodle_classification/index.html new file mode 100644 index 0000000..1419153 --- /dev/null +++ b/examples/doodle_classification/index.html @@ -0,0 +1,34 @@ + + + + + + + + doodle classifier + + + + + + + + + + + + + + + + + + diff --git a/examples/doodle_classification/libraries/p5.dom.min.js b/examples/doodle_classification/libraries/p5.dom.min.js new file mode 100644 index 0000000..ece75c0 --- /dev/null +++ b/examples/doodle_classification/libraries/p5.dom.min.js @@ -0,0 +1 @@ +/*! p5.js v0.6.0 January 19, 2018 */ !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,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 d(a,b,d,e){var f=document.createElement(b);"string"==typeof(d=d||"")&&(d=[d]);for(var g=0;g0&&c.every(function(a){return"INPUT"===a.tagName||"LABEL"===a.tagName})?this.createRadio(new a.Element(b)):new a.Element(b)},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.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,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};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;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)},{}],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(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=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)we[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 ne;for(a.sourceIndex+=4,d=b;d;--d)a.dest[a.destLen++]=a.source[a.sourceIndex++];return a.bitcount=0,me}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,oe,pe);break;case 2:l(f,f.ltree,f.dtree),e=m(f,f.ltree,f.dtree);break;default:e=ne}if(e!==me)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 Ne.Parser(c,d+e+14),h=new Ne.Parser(c,d+e+16+2*f),i=new Ne.Parser(c,d+e+16+4*f),j=new Ne.Parser(c,d+e+16+6*f),k=d+e+16+8*f,l=0;l=0;e-=1){var f=Ne.getUShort(a,b+4+8*e),g=Ne.getUShort(a,b+4+8*e+2);if(3===f&&(0===g||1===g||10===g)){d=Ne.getULong(a,b+4+8*e+4);break}}if(-1===d)throw new Error("No valid cmap sub-tables found.");var h=new Ne.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})}function V(a){a.segments.push({end:65535,start:65535,delta:1,offset:0})}function W(a){var b=new Ke.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}]);b.segments=[];for(var c=0;c0?(f=a.parseByte(),0==(b&e)&&(f=-f),f=c+f):f=(b&e)>0?c:c+a.parseShort(),f}function ca(a,b,c){var d=new Ne.Parser(b,c);a.numberOfContours=d.parseShort(),a._xMin=d.parseShort(),a._yMin=d.parseShort(),a._xMax=d.parseShort(),a._yMax=d.parseShort();var e,f;if(a.numberOfContours>0){for(var g=a.endPointIndices=[],h=0;h0)for(var l=d.parseByte(),m=0;m0){var n,o=[];if(j>0){for(var p=0;p=0,o.push(n);for(var q=0,r=0;r0?(2&e)>0?(v.dx=d.parseShort(),v.dy=d.parseShort()):v.matchedPoints=[d.parseUShort(),d.parseUShort()]:(2&e)>0?(v.dx=d.parseChar(),v.dy=d.parseChar()):v.matchedPoints=[d.parseByte(),d.parseByte()],(8&e)>0?v.xScale=v.yScale=d.parseF2Dot14():(64&e)>0?(v.xScale=d.parseF2Dot14(),v.yScale=d.parseF2Dot14()):(128&e)>0&&(v.xScale=d.parseF2Dot14(),v.scale01=d.parseF2Dot14(),v.scale10=d.parseF2Dot14(),v.yScale=d.parseF2Dot14()),a.components.push(v),u=!!(32&e)}if(256&e){a.instructionLength=d.parseUShort(),a.instructions=[];for(var w=0;wb.points.length-1||d.matchedPoints[1]>e.points.length-1)throw Error("Matched points out of range in "+b.name);var g=b.points[d.matchedPoints[0]],h=e.points[d.matchedPoints[1]],i={xScale:d.xScale,scale01:d.scale01,scale10:d.scale10,yScale:d.yScale,dx:0,dy:0};h=da([h],i)[0],i.dx=g.x-h.x,i.dy=g.y-h.y,f=da(e.points,i)}b.points=b.points.concat(f)}}return fa(b.points)}function ha(a,b,c,d){for(var e=new Ve.GlyphSet(d),f=0;f>4,g=15&e;if(f===c)break;if(b+=d[f],g===c)break;b+=d[g]}return parseFloat(b)}function ta(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 sa(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 ua(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 Fa(a,b,c,d){var e,f=[],g=new Ne.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+Pe.length:(c=Pe.length+b.length,b.push(a)),c}function Ia(){return new Ke.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 Ja(a){var b=new Ke.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 mb(a){return new Ke.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 nb(a,b){var c={},d=new Ne.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=Se.slice();break;case 2:c.numberOfGlyphs=d.parseUShort(),c.glyphNameIndex=new Array(c.numberOfGlyphs);for(var e=0;e=Se.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;hb.value.tag?1:-1}),b.fields=b.fields.concat(d),b.fields=b.fields.concat(e),b}function xb(a,b,c){for(var d=0;d0){return a.glyphs.get(e).getMetrics()}}return c}function yb(a){for(var b=0,c=0;cq||void 0===b)&&q>0&&(b=q),j 123 are reserved for internal usage");n|=1<0?af.make(G):void 0,J=nf.make(),K=Ye.make(a.glyphs,{version:a.getEnglishName("version"),fullName:C,familyName:A,weightName:B,postScriptName:D,unitsPerEm:a.unitsPerEm,fontBBox:[0,t.yMin,t.ascender,t.advanceWidthMax]}),L=a.metas&&Object.keys(a.metas).length>0?sf.make(a.metas):void 0,M=[u,v,w,x,H,z,J,K,y];I&&M.push(I),a.tables.gsub&&M.push(rf.make(a.tables.gsub)),L&&M.push(L);for(var N=wb(M),O=N.encode(),P=ub(O),Q=N.fields,R=!1,S=0;S>>1,f=a[e].tag;if(f===b)return e;f>>1,f=a[e];if(f===b)return e;f=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 Xb(b,c){a.DEBUG&&console.log(c.step,"SVTCA["+b.axis+"]"),c.fv=c.pv=c.dpv=b}function Yb(b,c){a.DEBUG&&console.log(c.step,"SPVTCA["+b.axis+"]"),c.pv=c.dpv=b}function Zb(b,c){a.DEBUG&&console.log(c.step,"SFVTCA["+b.axis+"]"),c.fv=b}function $b(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SPVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.pv=c.dpv=Sb(i,j)}function _b(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SFVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.fv=Sb(i,j)}function ac(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SPVFS[]",d,e),b.pv=b.dpv=Sb(e,d)}function bc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SPVFS[]",d,e),b.fv=Sb(e,d)}function cc(b){var c=b.stack,d=b.pv;a.DEBUG&&console.log(b.step,"GPV[]"),c.push(16384*d.x),c.push(16384*d.y)}function dc(b){var c=b.stack,d=b.fv;a.DEBUG&&console.log(b.step,"GFV[]"),c.push(16384*d.x),c.push(16384*d.y)}function ec(b){b.fv=b.pv,a.DEBUG&&console.log(b.step,"SFVTPV[]")}function fc(b){var c=b.stack,d=c.pop(),e=c.pop(),f=c.pop(),g=c.pop(),h=c.pop(),i=b.z0,j=b.z1,k=i[d],l=i[e],m=j[f],n=j[g],o=b.z2[h];a.DEBUG&&console.log("ISECT[], ",d,e,f,g,h);var p=k.x,q=k.y,r=l.x,s=l.y,t=m.x,u=m.y,v=n.x,w=n.y,x=(p-r)*(u-w)-(q-s)*(t-v),y=p*s-q*r,z=t*w-u*v;o.x=(y*(t-v)-z*(p-r))/x,o.y=(y*(u-w)-z*(q-s))/x}function gc(b){b.rp0=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP0[]",b.rp0)}function hc(b){b.rp1=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP1[]",b.rp1)}function ic(b){b.rp2=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP2[]",b.rp2)}function jc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP0[]",c),b.zp0=c,c){case 0:b.tZone||Vb(b),b.z0=b.tZone;break;case 1:b.z0=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function kc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP1[]",c),b.zp1=c,c){case 0:b.tZone||Vb(b),b.z1=b.tZone;break;case 1:b.z1=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function lc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP2[]",c),b.zp2=c,c){case 0:b.tZone||Vb(b),b.z2=b.tZone;break;case 1:b.z2=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function mc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZPS[]",c),b.zp0=b.zp1=b.zp2=c,c){case 0:b.tZone||Vb(b),b.z0=b.z1=b.z2=b.tZone;break;case 1:b.z0=b.z1=b.z2=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function nc(b){b.loop=b.stack.pop(),a.DEBUG&&console.log(b.step,"SLOOP[]",b.loop)}function oc(b){a.DEBUG&&console.log(b.step,"RTG[]"),b.round=Mb}function pc(b){a.DEBUG&&console.log(b.step,"RTHG[]"),b.round=Ob}function qc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SMD[]",c),b.minDis=c/64}function rc(b){a.DEBUG&&console.log(b.step,"ELSE[]"),Wb(b,!1)}function sc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"JMPR[]",c),b.ip+=c-1}function tc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCVTCI[]",c),b.cvCutIn=c/64}function uc(b){var c=b.stack;a.DEBUG&&console.log(b.step,"DUP[]"),c.push(c[c.length-1])}function vc(b){a.DEBUG&&console.log(b.step,"POP[]"),b.stack.pop()}function wc(b){a.DEBUG&&console.log(b.step,"CLEAR[]"),b.stack.length=0}function xc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SWAP[]"),c.push(d),c.push(e)}function yc(b){var c=b.stack;a.DEBUG&&console.log(b.step,"DEPTH[]"),c.push(c.length)}function zc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"LOOPCALL[]",d,e);var f=b.ip,g=b.prog;b.prog=b.funcs[d];for(var h=0;h1?"loop "+(c.loop-i)+": ":"")+"SHP["+(b?"rp1":"rp2")+"]",k)}c.loop=1}function Hc(b,c){var d=c.stack,e=b?c.rp1:c.rp2,f=(b?c.z0:c.z1)[e],g=c.fv,h=c.pv,i=d.pop(),j=c.z2[c.contours[i]],k=j;a.DEBUG&&console.log(c.step,"SHC["+b+"]",i);var l=h.distance(f,f,!1,!0);do{k!==f&&g.setRelative(k,k,l,h),k=k.nextPointOnContour}while(k!==j)}function Ic(b,c){var d=c.stack,e=b?c.rp1:c.rp2,f=(b?c.z0:c.z1)[e],g=c.fv,h=c.pv,i=d.pop();a.DEBUG&&console.log(c.step,"SHZ["+b+"]",i);var j;switch(i){case 0:j=c.tZone;break;case 1:j=c.gZone;break;default:throw new Error("Invalid zone")}for(var k,l=h.distance(f,f,!1,!0),m=j.length-2,n=0;n1?"loop "+(b.loop-d)+": ":"")+"SHPIX[]",h,f),e.setRelative(i,i,f),e.touch(i)}b.loop=1}function Kc(b){for(var c=b.stack,d=b.rp1,e=b.rp2,f=b.loop,g=b.z0[d],h=b.z1[e],i=b.fv,j=b.dpv,k=b.z2;f--;){var l=c.pop(),m=k[l];a.DEBUG&&console.log(b.step,(b.loop>1?"loop "+(b.loop-f)+": ":"")+"IP[]",l,d,"<->",e),i.interpolate(m,g,h,j),i.touch(m)}b.loop=1}function Lc(b,c){var d=c.stack,e=d.pop()/64,f=d.pop(),g=c.z1[f],h=c.z0[c.rp0],i=c.fv,j=c.pv;i.setRelative(g,h,e,j),i.touch(g),a.DEBUG&&console.log(c.step,"MSIRP["+b+"]",e,f),c.rp1=c.rp0,c.rp2=f,b&&(c.rp0=f)}function Mc(b){for(var c=b.stack,d=b.rp0,e=b.z0[d],f=b.loop,g=b.fv,h=b.pv,i=b.z1;f--;){var j=c.pop(),k=i[j];a.DEBUG&&console.log(b.step,(b.loop>1?"loop "+(b.loop-f)+": ":"")+"ALIGNRP[]",j),g.setRelative(k,e,0,h),g.touch(k)}b.loop=1}function Nc(b){a.DEBUG&&console.log(b.step,"RTDG[]"),b.round=Nb}function Oc(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z0[f],h=c.fv,i=c.pv,j=c.cvt[e];b&&(j=c.round(j)),a.DEBUG&&console.log(c.step,"MIAP["+b+"]",e,"(",j,")",f),h.setRelative(g,Bf,j,i),0===c.zp0&&(g.xo=g.x,g.yo=g.y),h.touch(g),c.rp0=c.rp1=f}function Pc(b){var c=b.prog,d=b.ip,e=b.stack,f=c[++d];a.DEBUG&&console.log(b.step,"NPUSHB[]",f);for(var g=0;g",i),c.stack.push(Math.round(64*i))}function Xc(b){a.DEBUG&&console.log(b.step,"MPPEM[]"),b.stack.push(b.ppem)}function Yc(b){a.DEBUG&&console.log(b.step,"FLIPON[]"),b.autoFlip=!0}function Zc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"LT[]",d,e),c.push(ed?1:0)}function ad(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"GTEQ[]",d,e),c.push(e>=d?1:0)}function bd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"EQ[]",d,e),c.push(d===e?1:0)}function cd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"NEQ[]",d,e),c.push(d!==e?1:0)}function dd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"ODD[]",d),c.push(Math.trunc(d)%2?1:0)}function ed(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"EVEN[]",d),c.push(Math.trunc(d)%2?0:1)}function fd(b){var c,d=b.stack.pop();a.DEBUG&&console.log(b.step,"IF[]",d),d||(Wb(b,!0),a.DEBUG&&console.log(b.step,27===c?"ELSE[]":"EIF[]"))}function gd(b){a.DEBUG&&console.log(b.step,"EIF[]")}function hd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"AND[]",d,e),c.push(d&&e?1:0)}function id(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"OR[]",d,e),c.push(d||e?1:0)}function jd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"NOT[]",d),c.push(d?0:1)}function kd(b,c){var d=c.stack,e=d.pop(),f=c.fv,g=c.pv,h=c.ppem,i=c.deltaBase+16*(b-1),j=c.deltaShift,k=c.z0;a.DEBUG&&console.log(c.step,"DELTAP["+b+"]",e,d);for(var l=0;l>4)===h){var o=(15&n)-8;o>=0&&o++,a.DEBUG&&console.log(c.step,"DELTAPFIX",m,"by",o*j);var p=k[m];f.setRelative(p,p,o*j,g)}}}function ld(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"SDB[]",d),b.deltaBase=d}function md(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"SDS[]",d),b.deltaShift=Math.pow(.5,d)}function nd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"ADD[]",d,e),c.push(e+d)}function od(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SUB[]",d,e),c.push(e-d)}function pd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"DIV[]",d,e),c.push(64*e/d)}function qd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MUL[]",d,e),c.push(e*d/64)}function rd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"ABS[]",d),c.push(Math.abs(d))}function sd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"NEG[]",d),c.push(-d)}function td(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"FLOOR[]",d),c.push(64*Math.floor(d/64))}function ud(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"CEILING[]",d),c.push(64*Math.ceil(d/64))}function vd(b,c){var d=c.stack,e=d.pop();a.DEBUG&&console.log(c.step,"ROUND[]"),d.push(64*c.round(e/64))}function wd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"WCVTF[]",d,e),b.cvt[e]=d*b.ppem/b.font.unitsPerEm}function xd(b,c){var d=c.stack,e=d.pop(),f=c.ppem,g=c.deltaBase+16*(b-1),h=c.deltaShift;a.DEBUG&&console.log(c.step,"DELTAC["+b+"]",e,d);for(var i=0;i>4)===f){var l=(15&k)-8;l>=0&&l++;var m=l*h;a.DEBUG&&console.log(c.step,"DELTACFIX",j,"by",m),c.cvt[j]+=m}}}function yd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SROUND[]",c),b.round=yf;var d;switch(192&c){case 0:d=.5;break;case 64:d=1;break;case 128:d=2;break;default:throw new Error("invalid SROUND value")}switch(b.srPeriod=d,48&c){case 0:b.srPhase=0;break;case 16:b.srPhase=.25*d;break;case 32:b.srPhase=.5*d;break;case 48:b.srPhase=.75*d;break;default:throw new Error("invalid SROUND value")}c&=15,b.srThreshold=0===c?0:(c/8-.5)*d}function zd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"S45ROUND[]",c),b.round=yf;var d;switch(192&c){case 0:d=Math.sqrt(2)/2;break;case 64:d=Math.sqrt(2);break;case 128:d=2*Math.sqrt(2);break;default:throw new Error("invalid S45ROUND value")}switch(b.srPeriod=d,48&c){case 0:b.srPhase=0;break;case 16:b.srPhase=.25*d;break;case 32:b.srPhase=.5*d;break;case 48:b.srPhase=.75*d;break;default:throw new Error("invalid S45ROUND value")}c&=15,b.srThreshold=0===c?0:(c/8-.5)*d}function Ad(b){a.DEBUG&&console.log(b.step,"ROFF[]"),b.round=Lb}function Bd(b){a.DEBUG&&console.log(b.step,"RUTG[]"),b.round=Pb}function Cd(b){a.DEBUG&&console.log(b.step,"RDTG[]"),b.round=Qb}function Dd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCANCTRL[]",c)}function Ed(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SDPVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.dpv=Sb(i,j)}function Fd(b){var c=b.stack,d=c.pop(),e=0;a.DEBUG&&console.log(b.step,"GETINFO[]",d),1&d&&(e=35),32&d&&(e|=4096),c.push(e)}function Gd(b){var c=b.stack,d=c.pop(),e=c.pop(),f=c.pop();a.DEBUG&&console.log(b.step,"ROLL[]"),c.push(e),c.push(d),c.push(f)}function Hd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MAX[]",d,e),c.push(Math.max(e,d))}function Id(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MIN[]",d,e),c.push(Math.min(e,d))}function Jd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCANTYPE[]",c)}function Kd(b){var c=b.stack.pop(),d=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"INSTCTRL[]",c,d),c){case 1:return void(b.inhibitGridFit=!!d);case 2:return void(b.ignoreCvt=!!d);default:throw new Error("invalid INSTCTRL[] selector")}}function Ld(b,c){var d=c.stack,e=c.prog,f=c.ip;a.DEBUG&&console.log(c.step,"PUSHB["+b+"]");for(var g=0;g=0?1:-1,i=Math.abs(i),b&&(k=g.cvt[m],e&&Math.abs(i-k)":"_")+(e?"R":"_")+(0===f?"Gr":1===f?"Bl":2===f?"Wh":"")+"]",b?m+"("+g.cvt[m]+","+k+")":"",n,"(d =",h,"->",j*i,")"),g.rp1=g.rp0,g.rp2=n,c&&(g.rp0=n)}function Od(a){a=a||{},a.empty||(Jb(a.familyName,"When creating a new Font object, familyName is required."),Jb(a.styleName,"When creating a new Font object, styleName is required."),Jb(a.unitsPerEm,"When creating a new Font object, unitsPerEm is required."),Jb(a.ascender,"When creating a new Font object, ascender is required."), +Jb(a.descender,"When creating a new Font object, descender is required."),Jb(a.descender<0,"Descender should be negative (e.g. -512)."),this.names={fontFamily:{en:a.familyName||" "},fontSubfamily:{en:a.styleName||" "},fullName:{en:a.fullName||a.familyName+" "+a.styleName},postScriptName:{en:a.postScriptName||a.familyName+a.styleName},designer:{en:a.designer||" "},designerURL:{en:a.designerURL||" "},manufacturer:{en:a.manufacturer||" "},manufacturerURL:{en:a.manufacturerURL||" "},license:{en:a.license||" "},licenseURL:{en:a.licenseURL||" "},version:{en:a.version||"Version 0.1"},description:{en:a.description||" "},copyright:{en:a.copyright||" "},trademark:{en:a.trademark||" "}},this.unitsPerEm=a.unitsPerEm||1e3,this.ascender=a.ascender,this.descender=a.descender,this.createdTimestamp=a.createdTimestamp,this.tables={os2:{usWeightClass:a.weightClass||this.usWeightClasses.MEDIUM,usWidthClass:a.widthClass||this.usWidthClasses.MEDIUM,fsSelection:a.fsSelection||this.fsSelectionValues.REGULAR}}),this.supported=!0,this.glyphs=new Ve.GlyphSet(this,a.glyphs||[]),this.encoding=new X(this),this.substitution=new Db(this),this.tables=this.tables||{},Object.defineProperty(this,"hinting",{get:function(){return this._hinting?this._hinting:"truetype"===this.outlinesFormat?this._hinting=new Kb(this):void 0}})}function Pd(a,b){var c=JSON.stringify(a),d=256;for(var e in b){var f=parseInt(e);if(f&&!(f<256)){if(JSON.stringify(b[e])===c)return f;d<=f&&(d=f+1)}}return b[d]=a,d}function Qd(a,b,c){var d=Pd(b.name,c);return[{name:"tag_"+a,type:"TAG",value:b.tag},{name:"minValue_"+a,type:"FIXED",value:b.minValue<<16},{name:"defaultValue_"+a,type:"FIXED",value:b.defaultValue<<16},{name:"maxValue_"+a,type:"FIXED",value:b.maxValue<<16},{name:"flags_"+a,type:"USHORT",value:0},{name:"nameID_"+a,type:"USHORT",value:d}]}function Rd(a,b,c){var d={},e=new Ne.Parser(a,b);return d.tag=e.parseTag(),d.minValue=e.parseFixed(),d.defaultValue=e.parseFixed(),d.maxValue=e.parseFixed(),e.skip("uShort",1),d.name=c[e.parseUShort()]||{},d}function Sd(a,b,c,d){for(var e=Pd(b.name,d),f=[{name:"nameID_"+a,type:"USHORT",value:e},{name:"flags_"+a,type:"USHORT",value:0}],g=0;g>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;fthis.x2&&(this.x2=a)),"number"==typeof b&&((isNaN(this.y1)||isNaN(this.y2))&&(this.y1=b,this.y2=b),bthis.y2&&(this.y2=b))},q.prototype.addX=function(a){this.addPoint(a,null)},q.prototype.addY=function(a){this.addPoint(null,a)},q.prototype.addBezier=function(a,b,c,d,e,f,g,h){var i=this,j=[a,b],k=[c,d],l=[e,f],m=[g,h];this.addPoint(a,b),this.addPoint(g,h);for(var n=0;n<=1;n++){var o=6*j[n]-12*k[n]+6*l[n],q=-3*j[n]+9*k[n]-9*l[n]+3*m[n],r=3*k[n]-3*j[n];if(0!==q){var s=Math.pow(o,2)-4*r*q;if(!(s<0)){var t=(-o+Math.sqrt(s))/(2*q);0=0&&d>0&&(c+=" "),c+=b(e)}return c}var d=this;a=void 0!==a?a:2;for(var e="",f=0;f=0&&a<=255,"Byte value should be between 0 and 255."),[a]},Ee.BYTE=u(1),De.CHAR=function(a){return[a.charCodeAt(0)]},Ee.CHAR=u(1),De.CHARARRAY=function(a){for(var b=[],c=0;c>8&255,255&a]},Ee.USHORT=u(2),De.SHORT=function(a){return a>=Ae&&(a=-(2*Ae-a)),[a>>8&255,255&a]},Ee.SHORT=u(2),De.UINT24=function(a){return[a>>16&255,a>>8&255,255&a]},Ee.UINT24=u(3),De.ULONG=function(a){return[a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.ULONG=u(4),De.LONG=function(a){return a>=Be&&(a=-(2*Be-a)),[a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.LONG=u(4),De.FIXED=De.ULONG,Ee.FIXED=Ee.ULONG,De.FWORD=De.SHORT,Ee.FWORD=Ee.SHORT,De.UFWORD=De.USHORT,Ee.UFWORD=Ee.USHORT,De.LONGDATETIME=function(a){return[0,0,0,0,a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.LONGDATETIME=u(8),De.TAG=function(a){return ze.argument(4===a.length,"Tag should be exactly 4 ASCII characters."),[a.charCodeAt(0),a.charCodeAt(1),a.charCodeAt(2),a.charCodeAt(3)]},Ee.TAG=u(4),De.Card8=De.BYTE,Ee.Card8=Ee.BYTE,De.Card16=De.USHORT,Ee.Card16=Ee.USHORT,De.OffSize=De.BYTE,Ee.OffSize=Ee.BYTE,De.SID=De.USHORT,Ee.SID=Ee.USHORT,De.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?De.NUMBER16(a):De.NUMBER32(a)},Ee.NUMBER=function(a){return De.NUMBER(a).length},De.NUMBER16=function(a){return[28,a>>8&255,255&a]},Ee.NUMBER16=u(3),De.NUMBER32=function(a){return[29,a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.NUMBER32=u(5),De.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()}for(var e="",f=0,g=b.length;f>8&255,b[b.length]=255&d}return b},Ee.UTF16=function(a){return 2*a.length};var Fe={"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":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ"};Ce.MACSTRING=function(a,b,c,d){var e=Fe[d];if(void 0!==e){for(var f="",g=0;g=128&&void 0===(f=c[f]))return;d[e]=f}return d}},Ee.MACSTRING=function(a,b){var c=De.MACSTRING(a,b);return void 0!==c?c.length:0},De.VARDELTAS=function(a){for(var b=0,c=[];b=-128&&d<=127?x(a,b,c):y(a,b,c)}return c},De.INDEX=function(a){for(var b=1,c=[b],d=[],e=0;e>8,b[l+1]=255&m,b=b.concat(d[k])}return b},Ee.TABLE=function(a){for(var b=0,c=a.fields.length,d=0;d0)return new Q(this.data,this.offset+b).parseStruct(a)},Q.prototype.parseListOfLists=function(a){for(var b=this,c=this.parseOffset16List(),d=c.length,e=this.relativeOffset,f=new Array(d),g=0;g=0)return d[e].script;if(b){var f={tag:a,script:{defaultLangSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]},langSysRecords:[]}};return d.splice(-1-e,0,f),f.script}}},getLangSysTable:function(a,b,c){var d=this.getScriptTable(a,c);if(d){if(!b||"dflt"===b||"DFLT"===b)return d.defaultLangSys;var e=Ab(d.langSysRecords,b);if(e>=0)return d.langSysRecords[e].langSys;if(c){var f={tag:b,langSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]}};return d.langSysRecords.splice(-1-e,0,f),f.langSys}}},getFeatureTable:function(a,b,c,d){var e=this.getLangSysTable(a,b,d);if(e){for(var f,g=e.featureIndexes,h=this.font.tables[this.tableName].features,i=0;i=h[j-1].tag,"Features must be added in alphabetical order."),f={tag:c,feature:{params:0,lookupListIndexes:[]}},h.push(f),g.push(j),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;k=0){for(var k=f.ligatureSets[j],l=0;l0&&a<0?c:e<0&&a>0?-c:a*e},zf={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 zf.setRelative(a,a,(i+j)/2,d,!0):void zf.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}},Af={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 Af.setRelative(a,a,(i+j)/2,d,!0):void Af.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(zf),Object.freeze(Af),Rb.prototype.distance=function(a,b,c,d){return this.x*zf.distance(a,b,c,d)+this.y*Af.distance(a,b,c,d)},Rb.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)},Rb.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},Rb.prototype.touch=function(a){a.xTouched=!0,a.yTouched=!0},Tb.prototype.nextTouched=function(a){for(var b=this.nextPointOnContour;!a.touched(b)&&b!==this;)b=b.nextPointOnContour;return b},Tb.prototype.prevTouched=function(a){for(var b=this.prevPointOnContour;!a.touched(b)&&b!==this;)b=b.prevPointOnContour;return b};var Bf=Object.freeze(new Tb(0,0)),Cf={cvCutIn:17/16,deltaBase:9,deltaShift:.125,loop:1,minDis:1,autoFlip:!0};Kb.prototype.exec=function(b,c){if("number"!=typeof c)throw new Error("Point size is not a number!");if(!(this._errorState>2)){var d=this.font,e=this._prepState;if(!e||e.ppem!==c){var f=this._fpgmState;if(!f){Ub.prototype=Cf,f=this._fpgmState=new Ub("fpgm",d.tables.fpgm),f.funcs=[],f.font=d,a.DEBUG&&(console.log("---EXEC FPGM---"),f.step=-1);try{vf(f)}catch(a){return console.log("Hinting error in FPGM:"+a),void(this._errorState=3)}}Ub.prototype=f,e=this._prepState=new Ub("prep",d.tables.prep),e.ppem=c;var g=d.tables.cvt;if(g)for(var h=e.cvt=new Array(g.length),i=c/d.unitsPerEm,j=0;j1))try{return wf(b,e)}catch(a){return this._errorState<1&&(console.log("Hinting error:"+a),console.log("Note: further hinting errors are silenced")),void(this._errorState=1)}}},wf=function(b,c){var d,e,f,g=c.ppem/c.font.unitsPerEm,h=g,i=b.components;if(Ub.prototype=c,i){var j=c.font;e=[],d=[];for(var k=0;k0,"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.")},Od.prototype.toTables=function(){return tf.fontToTable(this)},Od.prototype.toBuffer=function(){return console.warn("Font.toBuffer is deprecated. Use Font.toArrayBuffer instead."),this.toArrayBuffer()},Od.prototype.toArrayBuffer=function(){for(var a=this.toTables(),b=a.encode(),c=new ArrayBuffer(b.length),d=new Uint8Array(c),e=0;e1)for(var c=1;c-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(-1===w.indexOf(b))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");var b="response"in f?f.response:f.responseText;c(new q(b,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)},{}],12:[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":14,"./color/p5.Color":15,"./color/setting":16,"./core/2d_primitives":17,"./core/attributes":18,"./core/constants":20,"./core/core":21,"./core/curves":22,"./core/environment":23,"./core/init.js":25,"./core/p5.Element":26,"./core/p5.Graphics":27,"./core/p5.Renderer2D":29,"./core/rendering":30,"./core/structure":32,"./core/transform":33,"./core/vertex":34,"./data/p5.TypedDict":35,"./events/acceleration":36,"./events/keyboard":37,"./events/mouse":38,"./events/touch":39,"./image/image":41,"./image/loading_displaying":42,"./image/p5.Image":43,"./image/pixels":44,"./io/files":45,"./io/p5.Table":46,"./io/p5.TableRow":47,"./io/p5.XML":48,"./math/calculation":49,"./math/math":50,"./math/noise":51,"./math/p5.Vector":52,"./math/random":54,"./math/trigonometry":55,"./typography/attributes":56,"./typography/loading_displaying":57,"./typography/p5.Font":58,"./utilities/array_functions":59,"./utilities/conversion":60,"./utilities/string_functions":61,"./utilities/time_date":62,"./webgl/camera":63,"./webgl/interaction":64,"./webgl/light":65,"./webgl/loading":66,"./webgl/material":67,"./webgl/p5.Geometry":68,"./webgl/p5.Matrix":69,"./webgl/p5.RendererGL":72,"./webgl/p5.RendererGL.Immediate":70,"./webgl/p5.RendererGL.Retained":71,"./webgl/p5.Shader":73,"./webgl/primitives":75}],13:[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":21}],14:[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(){if(d._validateParameters("color",arguments),arguments[0]instanceof d.Color)return arguments[0];var a=arguments[0]instanceof Array?arguments[0]:arguments;return new d.Color(this,a)},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._colorMode,m=this._colorMaxes;if(l===e.RGB)j=a.levels.map(function(a){return a/255}),k=b.levels.map(function(a){return a/255});else if(l===e.HSB)a._getBrightness(),b._getBrightness(),j=a.hsba,k=b.hsba;else{if(l!==e.HSL)throw new Error(l+"cannot be used for interpolation.");a._getLightness(),b._getLightness(),j=a.hsla,k=b.hsla}return c=Math.max(Math.min(c,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":20,"../core/core":21,"../core/error_helpers":24,"./p5.Color":15}],15:[function(a,b,c){"use strict";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(a,b,c,h){var i=arguments.length,j=this.mode,k=this.maxes,m=[];if(i>=3)return m[0]=a/k[j][0],m[1]=b/k[j][1],m[2]=c/k[j][2],m[3]="number"==typeof h?h/k[j][3]:1,m=m.map(function(a){return Math.max(Math.min(a,1),0)}),j===e.HSL?f._hslaToRGBA(m):j===e.HSB?f._hsbaToRGBA(m):m;if(1===i&&"string"==typeof a){var n=a.trim().toLowerCase();if(g[n])return d.Color._parseInputs.call(this,g[n]);if(l.HEX3.test(n))return m=l.HEX3.exec(n).slice(1).map(function(a){return parseInt(a+a,16)/255}),m[3]=1,m;if(l.HEX6.test(n))return m=l.HEX6.exec(n).slice(1).map(function(a){return parseInt(a,16)/255}),m[3]=1,m;if(l.HEX4.test(n))return m=l.HEX4.exec(n).slice(1).map(function(a){return parseInt(a+a,16)/255});if(l.HEX8.test(n))return m=l.HEX8.exec(n).slice(1).map(function(a){return parseInt(a,16)/255});if(l.RGB.test(n))return m=l.RGB.exec(n).slice(1).map(function(a){return a/255}),m[3]=1,m;if(l.RGB_PERCENT.test(n))return m=l.RGB_PERCENT.exec(n).slice(1).map(function(a){return parseFloat(a)/100}),m[3]=1,m;if(l.RGBA.test(n))return m=l.RGBA.exec(n).slice(1).map(function(a,b){return 3===b?parseFloat(a):a/255});if(l.RGBA_PERCENT.test(n))return m=l.RGBA_PERCENT.exec(n).slice(1).map(function(a,b){return 3===b?parseFloat(a):parseFloat(a)/100});if(l.HSL.test(n)?(m=l.HSL.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),m[3]=1):l.HSLA.test(n)&&(m=l.HSLA.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),m=m.map(function(a){return Math.max(Math.min(a,1),0)}),m.length)return f._hslaToRGBA(m);if(l.HSB.test(n)?(m=l.HSB.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),m[3]=1):l.HSBA.test(n)&&(m=l.HSBA.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),m=m.map(function(a){return Math.max(Math.min(a,1),0)}),m.length)return f._hsbaToRGBA(m);m=[1,1,1,1]}else{if(1!==i&&2!==i||"number"!=typeof a)throw new Error(arguments+"is not a valid color representation.");m[0]=a/k[j][2],m[1]=a/k[j][2],m[2]=a/k[j][2],m[3]="number"==typeof b?b/k[j][3]:1,m=m.map(function(a){return Math.max(Math.min(a,1),0)})}return m},b.exports=d.Color},{"../core/constants":20,"../core/core":21,"./color_conversion":13}],16:[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(a,b,c,f,g){if(d._validateParameters("colorMode",arguments),a===e.RGB||a===e.HSB||a===e.HSL){this._colorMode=a;var h=this._colorMaxes[a];2===arguments.length?(h[0]=b,h[1]=b,h[2]=b,h[3]=b):4===arguments.length?(h[0]=b,h[1]=c,h[2]=f):5===arguments.length&&(h[0]=b,h[1]=c,h[2]=f,h[3]=g)}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._setProperty("_doFill",!1),this},d.prototype.noStroke=function(){return 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":20,"../core/core":21,"./p5.Color":15}],17:[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){if(d._validateParameters("arc",arguments),!this._renderer._doStroke&&!this._renderer._doFill)return this;for(this._angleMode===e.DEGREES&&(g=this.radians(g),h=this.radians(h));g<0;)g+=e.TWO_PI;for(;h<0;)h+=e.TWO_PI;return g%=e.TWO_PI,h%=e.TWO_PI,h===g&&(h+=e.TWO_PI),g=g<=e.HALF_PI?Math.atan(c/f*Math.tan(g)):g>e.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(a,b,c,e,g,h){if(d._validateParameters("ellipse",arguments),c<0&&(c=Math.abs(c)),void 0===e?e=c:e<0&&(e=Math.abs(e)),this._renderer._doStroke||this._renderer._doFill){var i=f.modeAdjust(a,b,c,e,this._renderer._ellipseMode);this._renderer.ellipse([i.x,i.y,i.w,i.h,g,h])}return this},d.prototype.line=function(){return d._validateParameters("line",arguments),this._renderer._doStroke&&this._renderer.line.apply(this._renderer,arguments),this},d.prototype.point=function(){return d._validateParameters("point",arguments),this._renderer._doStroke&&this._renderer.point.apply(this._renderer,arguments),this},d.prototype.quad=function(){return d._validateParameters("quad",arguments),(this._renderer._doStroke||this._renderer._doFill)&&this._renderer.quad.apply(this._renderer,arguments),this},d.prototype.rect=function(a,b,c,e,g,h){if(d._validateParameters("rect",arguments),this._renderer._doStroke||this._renderer._doFill){var i=f.modeAdjust(a,b,c,e,this._renderer._rectMode);this._renderer.rect([i.x,i.y,i.w,i.h,g,h])}return this},d.prototype.triangle=function(){return d._validateParameters("triangle",arguments),(this._renderer._doStroke||this._renderer._doFill)&&this._renderer.triangle(arguments),this},b.exports=d},{"./canvas":19,"./constants":20,"./core":21,"./error_helpers":24}],18:[function(a,b,c){"use strict";var d=a("./core"),e=a("./constants");d.prototype.ellipseMode=function(a){return d._validateParameters("ellipseMode",arguments),a!==e.CORNER&&a!==e.CORNERS&&a!==e.RADIUS&&a!==e.CENTER||(this._renderer._ellipseMode=a),this},d.prototype.noSmooth=function(){return this._renderer.noSmooth(),this},d.prototype.rectMode=function(a){return d._validateParameters("rectMode",arguments),a!==e.CORNER&&a!==e.CORNERS&&a!==e.RADIUS&&a!==e.CENTER||(this._renderer._rectMode=a),this},d.prototype.smooth=function(){return this._renderer.smooth(),this},d.prototype.strokeCap=function(a){return d._validateParameters("strokeCap",arguments),a!==e.ROUND&&a!==e.SQUARE&&a!==e.PROJECT||this._renderer.strokeCap(a),this},d.prototype.strokeJoin=function(a){return d._validateParameters("strokeJoin",arguments),a!==e.ROUND&&a!==e.BEVEL&&a!==e.MITER||this._renderer.strokeJoin(a),this},d.prototype.strokeWeight=function(a){return d._validateParameters("strokeWeight",arguments),this._renderer.strokeWeight(a),this},b.exports=d},{"./constants":20,"./core":21}],19:[function(a,b,c){"use strict";var d=a("./constants");b.exports={modeAdjust:function(a,b,c,e,f){return f===d.CORNER?{x:a,y:b,w:c,h:e}:f===d.CORNERS?{x:a,y:b,w:c-a,h:e-b}:f===d.RADIUS?{x:a-c,y:b-e,w:2*c,h:2*e}:f===d.CENTER?{x:a-.5*c,y:b-.5*e,w:c,h:e}:void 0},arcModeAdjust:function(a,b,c,e,f){return f===d.CORNER?{x:a+.5*c,y:b+.5*e,w:c,h:e}:f===d.CORNERS?{x:a,y:b,w:c+a,h:e+b}:f===d.RADIUS?{x:a,y:b,w:2*c,h:2*e}:f===d.CENTER?{x:a,y:b,w:c,h:e}:void 0}}},{"./constants":20}],20:[function(a,b,c){"use strict";var d=Math.PI;b.exports={P2D:"p2d",WEBGL:"webgl",ARROW:"default",CROSS:"crosshair",HAND:"pointer",MOVE:"move",TEXT:"text",WAIT:"wait",HALF_PI:d/2,PI:d,QUARTER_PI:d/4,TAU:2*d,TWO_PI:2*d,DEGREES:"degrees",RADIANS:"radians",DEG_TO_RAD:d/180,RAD_TO_DEG:180/d,CORNER:"corner",CORNERS:"corners",RADIUS:"radius",RIGHT:"right",LEFT:"left",CENTER:"center",TOP:"top",BOTTOM:"bottom",BASELINE:"alphabetic",POINTS:0,LINES:1,LINE_STRIP:3,LINE_LOOP:2,TRIANGLES:4,TRIANGLE_FAN:6,TRIANGLE_STRIP:5,QUADS:"quads",QUAD_STRIP:"quad_strip",CLOSE:"close",OPEN:"open",CHORD:"chord",PIE:"pie",PROJECT:"square",SQUARE:"butt",ROUND:"round",BEVEL:"bevel",MITER:"miter",RGB:"rgb",HSB:"hsb",HSL:"hsl",AUTO:"auto",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,BLEND:"source-over",ADD:"lighter",DARKEST:"darken",LIGHTEST:"lighten",DIFFERENCE:"difference",EXCLUSION:"exclusion",MULTIPLY:"multiply",SCREEN:"screen",REPLACE:"copy",OVERLAY:"overlay",HARD_LIGHT:"hard-light",SOFT_LIGHT:"soft-light",DODGE:"color-dodge",BURN:"color-burn",THRESHOLD:"threshold",GRAY:"gray",OPAQUE:"opaque",INVERT:"invert",POSTERIZE:"posterize",DILATE:"dilate",ERODE:"erode",BLUR:"blur",NORMAL:"normal",ITALIC:"italic",BOLD:"bold",_DEFAULT_TEXT_FILL:"#000000",_DEFAULT_LEADMULT:1.25,_CTX_MIDDLE:"middle",LINEAR:"linear",QUADRATIC:"quadratic",BEZIER:"bezier",CURVE:"curve",STROKE:"stroke",FILL:"fill",TEXTURE:"texture",IMMEDIATE:"immediate",LANDSCAPE:"landscape",PORTRAIT:"portrait",_DEFAULT_STROKE:"#000000",_DEFAULT_FILL:"#FFFFFF"}},{}],21:[function(a,b,c){"use strict";a("./shim");var d=a("./constants"),e=function(a,b,c){"boolean"==typeof b&&void 0===c&&(c=b,b=void 0),this._setupDone=!1,this._pixelDensity=Math.ceil(window.devicePixelRatio)||1,this._userNode=b,this._curElement=null,this._elements=[],this._requestAnimId=0,this._preloadCount=0,this._isGlobal=!1,this._loop=!0,this._initializeInstanceVariables(),this._defaultCanvasSize={width:100,height:100},this._events={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",this._registeredMethods={};for(var d=Object.getOwnPropertyNames(e.prototype._registeredMethods),f=0;f=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 h._validateParameters("frameRate",arguments),"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(h._validateParameters("fullscreen",arguments),void 0===a)return document.fullscreenElement||document.webkitFullscreenElement||document.mozFullScreenElement||document.msFullscreenElement;a?f(document.documentElement):g()},h.prototype.pixelDensity=function(a){if(h._validateParameters("pixelDensity",arguments),"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":20,"./core":21}],24:[function(a,b,c){"use strict";var d=a("./core");a("./constants");d._validateParameters=d._friendlyFileLoadError=function(){};var e=null,f="https://github.com/processing/p5.js/wiki/Frequently-Asked-Questions#why-cant-i-assign-variables-using-p5-functions-and-variables-before-setup",g=function(){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}})};e=[].concat(c(d.prototype),c(a("./constants"))),e.sort(function(a,b){return b.name.length-a.name.length})},h=function(a,b){b||(b=console.log.bind(console)),e||g(),e.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: "+f),!0})};d.prototype._helpForMisusedAtTopLevelCode=h,"complete"!==document.readyState&&(window.addEventListener("error",h,!1),window.addEventListener("load",function(){window.removeEventListener("error",h,!1)})),b.exports=d},{"../../docs/reference/data.json":void 0,"./constants":20,"./core":21}],25:[function(a,b,c){"use strict";var d=a("../core/core"),e=function(){window.PHANTOMJS||window.mocha||(window.setup&&"function"==typeof window.setup||window.draw&&"function"==typeof window.draw)&&!d.instance&&new d};"complete"===document.readyState?e():window.addEventListener("load",e,!1)},{"../core/core":21}],26:[function(a,b,c){"use strict";function d(a,b,c){return!1===b?f(a,c):e(a,b,c),this}function e(a,b,c){c._events[a]&&f(a,c);var d=b.bind(c);c.elt.addEventListener(a,d,!1),c._events[a]=d}function f(a,b){var c=b._events[a];b.elt.removeEventListener(a,c,!1),b._events[a]=null}var g=a("./core");g.Element=function(a,b){this.elt=a,this._pInst=b,this._events={},this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this.name="p5.Element"},g.Element.prototype.parent=function(a){return void 0===a?this.elt.parentNode:("string"==typeof a?("#"===a[0]&&(a=a.substring(1)),a=document.getElementById(a)):a instanceof g.Element&&(a=a.elt),a.appendChild(this.elt),this)},g.Element.prototype.id=function(a){return void 0===a?this.elt.id:(this.elt.id=a,this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this)},g.Element.prototype.class=function(a){return void 0===a?this.elt.className:(this.elt.className=a,this)},g.Element.prototype.mousePressed=function(a){return d("mousedown",a,this),d("touchstart",a,this),this},g.Element.prototype.doubleClicked=function(a){return d("dblclick",a,this),this},g.Element.prototype.mouseWheel=function(a){return d("wheel",a,this),this},g.Element.prototype.mouseReleased=function(a){return d("mouseup",a,this),d("touchend",a,this),this},g.Element.prototype.mouseClicked=function(a){return d("click",a,this),this},g.Element.prototype.mouseMoved=function(a){return d("mousemove",a,this),d("touchmove",a,this),this},g.Element.prototype.mouseOver=function(a){return d("mouseover",a,this),this},g.Element.prototype.changed=function(a){return d("change",a,this),this},g.Element.prototype.input=function(a){return d("input",a,this),this},g.Element.prototype.mouseOut=function(a){return d("mouseout",a,this),this},g.Element.prototype.touchStarted=function(a){return d("touchstart",a,this),d("mousedown",a,this),this},g.Element.prototype.touchMoved=function(a){return d("touchmove",a,this),d("mousemove",a,this),this},g.Element.prototype.touchEnded=function(a){return d("touchend",a,this),d("mouseup",a,this),this},g.Element.prototype.dragOver=function(a){return d("dragover",a,this),this},g.Element.prototype.dragLeave=function(a){return d("dragleave",a,this),this},g.Element.prototype.drop=function(a,b){function c(b){var c=new g.File(b);return function(b){c.data=b.target.result,a(c)}}return window.File&&window.FileReader&&window.FileList&&window.Blob?(e("dragover",function(a){a.stopPropagation(),a.preventDefault()},this),e("dragleave",function(a){a.stopPropagation(),a.preventDefault()},this),void 0!==b&&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":21}],27:[function(a,b,c){"use strict";var d=a("./core"),e=a("./constants");d.Graphics=function(a,b,c,f){var g=c||e.P2D;this.canvas=document.createElement("canvas"),(f._userNode||document.body).appendChild(this.canvas),d.Element.call(this,this.canvas,f,!1);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 d.prototype._initializeInstanceVariables.apply(this),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),f._elements.push(this),this._renderer.resize(a,b),this._renderer._applyDefaults(),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":20,"./core":21}],28:[function(a,b,c){"use strict";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},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"number"==typeof a?(this._setProperty("_textLeading",a),this):this._textLeading},e.Renderer.prototype.textSize=function(a){return"number"==typeof a?(this._setProperty("_textSize",a),this._setProperty("_textLeading",a*f._DEFAULT_LEADMULT),this._applyTextProperties()):this._textSize},e.Renderer.prototype.textStyle=function(a){return a?(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":20,"./core":21}],29:[function(a,b,c){"use strict";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._pInst,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._pInst,arguments);this._setFill(a.toString())},d.Renderer2D.prototype.stroke=function(){var a=this._pInst.color.apply(this._pInst,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(void 0!==a)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":40,"./canvas":19,"./constants":20,"./core":21,"./p5.Renderer":28}],30:[function(a,b,c){"use strict";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){d._validateParameters("createCanvas",arguments);var g,h=c||e.P2D;if(h===e.WEBGL){if(g=document.getElementById(f)){g.parentNode.removeChild(g);var i=this._renderer;this._elements=this._elements.filter(function(a){return a!==i})}g=document.createElement("canvas"),g.id=f}else if(this._defaultGraphicsCreated)g=this.canvas;else{g=document.createElement("canvas");for(var j=0;document.getElementById("defaultCanvas"+j);)j++;f="defaultCanvas"+j,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(d._validateParameters("resizeCanvas",arguments),this._renderer){var e={};for(var f in this.drawingContext){var g=this.drawingContext[f];"object"!=typeof g&&"function"!=typeof g&&(e[f]=g)}this._renderer.resize(a,b);for(var h in e)try{this.drawingContext[h]=e[h]}catch(a){}c||this.redraw()}},d.prototype.noCanvas=function(){this.canvas&&this.canvas.parentNode.removeChild(this.canvas)},d.prototype.createGraphics=function(a,b,c){return d._validateParameters("createGraphics",arguments),new d.Graphics(a,b,c,this)},d.prototype.blendMode=function(a){if(d._validateParameters("blendMode",arguments),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":72,"./constants":20,"./core":21,"./p5.Graphics":27,"./p5.Renderer2D":29}],31:[function(a,b,c){"use strict";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(){"undefined"==typeof Uint8ClampedArray||Uint8ClampedArray.prototype.slice||Object.defineProperty(Uint8ClampedArray.prototype,"slice",{value:Array.prototype.slice,writable:!0,configurable:!0,enumerable:!1})}()},{}],32:[function(a,b,c){"use strict";function d(a,b){for(var c=1;c0))throw"vertex() must be used once before calling quadraticVertex()";k=!0;for(var j=[],m=0;mn||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":21}],37:[function(a,b,c){"use strict";function d(){for(var a in f)if(f.hasOwnProperty(a)&&!0===f[a])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){!1===c(a)&&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){!1===b(a)&&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){!1===b(a)&&a.preventDefault()}}},e.prototype._onblur=function(a){f={}},e.prototype.keyIsDown=function(a){return e._validateParameters("keyIsDown",arguments),f[a]},b.exports=e},{"../core/core":21}],38:[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?!1===b.mouseDragged(a)&&a.preventDefault():"function"==typeof b.touchMoved&&!1===b.touchMoved(a)&&a.preventDefault():"function"==typeof b.mouseMoved&&!1===b.mouseMoved(a)&&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?!1===b.mousePressed(a)&&a.preventDefault():"function"==typeof b.touchStarted&&!1===b.touchStarted(a)&&a.preventDefault()},e.prototype._onmouseup=function(a){var b=this._isGlobal?window:this;this._setProperty("mouseIsPressed",!1),"function"==typeof b.mouseReleased?!1===b.mouseReleased(a)&&a.preventDefault():"function"==typeof b.touchEnded&&!1===b.touchEnded(a)&&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){!1===b.mouseClicked(a)&&a.preventDefault()}},e.prototype._ondblclick=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.doubleClicked){!1===b.doubleClicked(a)&&a.preventDefault()}},e.prototype._onwheel=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.mouseWheel){a.delta=a.deltaY;!1===b.mouseWheel(a)&&a.preventDefault()}},b.exports=e},{"../core/constants":20,"../core/core":21}],39:[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[(-16777216&H)>>>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(){var a,b,c,e,f,g,h,i,j;if(9===arguments.length)a=arguments[0],b=arguments[1],c=arguments[2],e=arguments[3],f=arguments[4],g=arguments[5],h=arguments[6],i=arguments[7],j=arguments[8];else{if(8!==arguments.length)throw new Error("Signature not supported");a=this,b=arguments[0],c=arguments[1],e=arguments[2],f=arguments[3],g=arguments[4],h=arguments[5],i=arguments[6],j=arguments[7]}d.Renderer2D._copyHelper(this,a,b,c,e,f,g,h,i,j)},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){d.prototype.saveCanvas(this.canvas,a,b)},b.exports=d.Image},{"../core/core":21,"./filters":40}],44:[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._validateParameters("copy",arguments),d.Renderer2D.prototype.copy.apply(this._renderer,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":15,"../core/core":21,"./filters":40}],45:[function(a,b,c){"use strict";function d(a,b){var c={};if(void 0===(b=b||[]))for(var d=0;d/g,">").replace(/"/g,""").replace(/'/g,"'")}function f(a,b){b&&!0!==b&&"true"!==b||(b=""),a||(a="untitled");var c="";return a&&a.indexOf(".")>-1&&(c=a.split(".").pop()),b&&c!==b&&(c=b,a=a+"."+c),[a,c]}function g(a){document.body.removeChild(a.target)}var h=a("../core/core");a("whatwg-fetch"),a("es6-promise").polyfill();var i=a("fetch-jsonp");a("../core/error_helpers"),h.prototype.loadJSON=function(){for(var a,b,c,d=arguments[0],e={},f="json",g=1;g0&&"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=-1!==c.url.indexOf("json")?"json":-1!==c.url.indexOf("xml")?"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});h.prototype.downloadFile(e,b,c)},h.prototype.downloadFile=function(b,c,d){var e=f(c,d),i=e[0];if(b instanceof Blob){return void a("file-saver").saveAs(b,i)}var j=document.createElement("a");if(j.href=b,j.download=i,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 --\x3e Save As.\n",k+='2. Choose "Page Source" as the Format.\n',k+='3. Name it with this extension: ."'+e[1]+'"',alert(k)}j.click()},h.prototype._checkFileExtension=f,h.prototype._isSafari=function(){return Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor")>0},b.exports=h},{"../core/core":21,"../core/error_helpers":24,"es6-promise":4,"fetch-jsonp":5,"file-saver":6,"whatwg-fetch":11}],46:[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)).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,b){return this.p5&&this.p5._angleMode===f.DEGREES&&(a=e.degreesToRadians(a)),void 0===b&&(b=1),this.p5?new d.Vector(this.p5,[b*Math.cos(a),b*Math.sin(a),0]):new d.Vector(b*Math.cos(a),b*Math.sin(a),0)},d.Vector.fromAngles=function(a,b,c){this.p5&&this.p5._angleMode===f.DEGREES&&(a=e.degreesToRadians(a),b=e.degreesToRadians(b)),void 0===c&&(c=1);var g=Math.cos(b),h=Math.sin(b),i=Math.cos(a),j=Math.sin(a);return this.p5?new new d.Vector(this.p5,c*j*h,-c*i,c*j*g):new d.Vector(c*j*h,-c*i,c*j*g)},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()*f.TWO_PI,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()*f.TWO_PI,b=2*Math.random()-1);var c=Math.sqrt(1-b*b),e=c*Math.cos(a),g=c*Math.sin(a);return this.p5?new d.Vector(this.p5,[e,g,b]):new d.Vector(e,g,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":20,"../core/core":21,"./polargeometry":53}],53:[function(a,b,c){"use strict";b.exports={degreesToRadians:function(a){return 2*Math.PI*a/360},radiansToDegrees:function(a){return 360*a/(2*Math.PI)}}},{}],54:[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":21}],55:[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":20,"../core/core":21,"./polargeometry":53}],56:[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":21}],57:[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":20,"../core/core":21,"../core/error_helpers":24,"opentype.js":9}],58:[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 f=a[b];f.length;)h[b]="A",e&&(i[b]="A"),a.splice(b++,0,["C"].concat(f.splice(0,6)));a.splice(b,1),c=Math.max(d.length,e&&e.length||0)}},l=function(a,b,f,g,h){a&&b&&"M"===a[h][0]&&"M"!==b[h][0]&&(b.splice(h,0,["M",g.x,g.y]),f.bx=0,f.by=0,f.x=a[h][1],f.y=a[h][2],c=Math.max(d.length,e&&e.length||0))},m="",n="";c=Math.max(d.length,e&&e.length||0);for(var p=0;p1&&(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+=(j=0;--b){var c=arguments[b];a+=c===Object(c)?JSON.stringify(c):c}return a}var y=a("../core/core"),z=a("../core/constants");y.Font=function(a){this.parent=a,this.cache={},this.font=void 0,this.name="p5.Font"},y.Font.prototype.list=function(){throw"not yet implemented"},y.Font.prototype.textBounds=function(a,b,c,d,e){b=void 0!==b?b:0,c=void 0!==c?c:0,d=d||this.parent._renderer._textSize;var f=e&&e.renderer&&e.renderer._pInst||this.parent,g=f._renderer.drawingContext,h=g.textAlign||z.LEFT,i=g.textBaseline||z.BASELINE,j=x("textBounds",a,b,c,d,h,i),k=this.cache[j];if(!k){var l,m,n,o,p,q=[],r=[],s=this._scale(d);this.font.forEachGlyph(a,b,c,d,e,function(a,b,c,d){var e=a.getMetrics();q.push(b+e.xMin*s),q.push(b+e.xMax*s),r.push(c+-e.yMin*s),r.push(c+-e.yMax*s)}),l=Math.min.apply(null,q),m=Math.min.apply(null,r),n=Math.max.apply(null,q),o=Math.max.apply(null,r),k={x:l,y:m,h:o-m,w:n-l,advance:l-b},p=this._handleAlignment(f,g,a,k.x,k.y,k.w+k.advance),k.x=p.x,k.y=p.y,this.cache[x("textBounds",a,b,c,d,h,i)]=k}return k},y.Font.prototype.textToPoints=function(a,b,c,e,g){function h(b){return k[b].name&&"space"===k[b].name||a.length===k.length&&" "===a[b]||k[b].index&&3===k[b].index}var i=0,j=[],k=this._getGlyphs(a);e=e||this.parent._renderer._textSize;for(var l=0;l2?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":21}],60:[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":21}],61:[function(a,b,c){"use strict";function d(a,b,c){var d=a<0,e=d?a.toString().substring(1):a.toString(),f=e.indexOf("."),g=-1!==f?e.substring(0,f):e,h=-1!==f?e.substring(f+1):"",i=d?"-":"";if(void 0!==c){var j="";(-1!==f||c-h.length>0)&&(j="."),h.length>c&&(h=h.substring(0,c));for(var k=0;kd.length){d+=-1===c?".":"";for(var f=b-d.length+1,g=0;g0?"+"+a.toString():a.toString()}function g(a){return parseFloat(a)>0?" "+a.toString():a.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(a,b,c){return h._validateParameters("nf",arguments),a instanceof Array?a.map(function(a){return d(a,b,c)}):"[object Arguments]"===Object.prototype.toString.call(a)?3===a.length?this.nf(a[0],a[1],a[2]):2===a.length?this.nf(a[0],a[1]):this.nf(a[0]):d(a,b,c)},h.prototype.nfc=function(a,b){return h._validateParameters("nfc",arguments),a instanceof Array?a.map(function(a){return e(a,b)}):e(a,b)},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(a,b){h._validateParameters("splitTokens",arguments);var c;if(void 0!==b){var d=b,e=/\]/g.exec(d),f=/\[/g.exec(d);f&&e?(d=d.slice(0,e.index)+d.slice(e.index+1),f=/\[/g.exec(d),d=d.slice(0,f.index)+d.slice(f.index+1),c=new RegExp("[\\["+d+"\\]]","g")):e?(d=d.slice(0,e.index)+d.slice(e.index+1),c=new RegExp("["+d+"\\]]","g")):f?(d=d.slice(0,f.index)+d.slice(f.index+1),c=new RegExp("["+d+"\\[]","g")):c=new RegExp("["+d+"]","g")}else c=/\s/g;return a.split(c).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":21,"../core/error_helpers":24}],62:[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":21}],63:[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(a,b,c,d,e,f,g,h,i){void 0===a&&(a=this.defaultCameraX,b=this.defaultCameraY,c=this.defaultCameraZ,d=a,e=b,f=0,g=0,h=1,i=0),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(a,b,c,e){void 0===a&&(a=this.defaultCameraFOV),void 0===b&&(b=this.defaultCameraAspect),void 0===c&&(c=this.defaultCameraNear),void 0===e&&(e=this.defaultCameraFar),this.cameraFOV=a,this.cameraAspect=b,this.cameraNear=c,this.cameraFar=e,this.uPMatrix=d.Matrix.identity(this.pInst);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(){return this._renderer.ortho.apply(this._renderer,arguments),this},d.RendererGL.prototype.ortho=function(a,b,c,e,f,g){void 0===a&&(a=-this.width/2),void 0===b&&(b=+this.width/2),void 0===c&&(c=-this.height/2),void 0===e&&(e=+this.height/2),void 0===f&&(f=0),void 0===g&&(g=Math.max(this.width,this.height)),this.uPMatrix=d.Matrix.identity(this._pInst);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.uPMatrix=d.Matrix.identity(),this.uPMatrix.set(k,0,0,0,0,-l,0,0,0,0,m,0,n,o,p,1),this._curCamera="custom"},b.exports=d},{"../core/core":21}],64:[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":21}],65:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.ambientLight=function(a,b,c,d){var e=this.color.apply(this,arguments),f=this._renderer._useLightShader();return f.setUniform("uUseLighting",!0),f.setUniform("uMaterialColor",this._renderer.curFillColor),this._renderer.ambientLightColors.push(e._array[0],e._array[1],e._array[2]),f.setUniform("uAmbientColor",this._renderer.ambientLightColors),f.setUniform("uAmbientLightCount",this._renderer.ambientLightColors.length/3),this},d.prototype.directionalLight=function(a,b,c,d,e,f){var g,h,i,j=this._renderer._useLightShader(),k=this.color.apply(this,[a,b,c]),l=arguments[arguments.length-1];"number"==typeof l?(g=arguments[arguments.length-3],h=arguments[arguments.length-2],i=arguments[arguments.length-1]):(g=l.x,h=l.y,i=l.z),j.setUniform("uUseLighting",!0),j.setUniform("uMaterialColor",this._renderer.curFillColor);var m=Math.sqrt(g*g+h*h+i*i);return this._renderer.directionalLightDirections.push(g/m,h/m,i/m),j.setUniform("uLightingDirection",this._renderer.directionalLightDirections),this._renderer.directionalLightColors.push(k._array[0],k._array[1],k._array[2]),j.setUniform("uDirectionalColor",this._renderer.directionalLightColors),j.setUniform("uDirectionalLightCount",this._renderer.directionalLightColors.length/3),this},d.prototype.pointLight=function(a,b,c,d,e,f){var g,h,i,j=this._renderer._pInst.color.apply(this,[a,b,c]),k=arguments[arguments.length-1];"number"==typeof k?(g=arguments[arguments.length-3],h=arguments[arguments.length-2],i=arguments[arguments.length-1]):(g=k.x,h=k.y,i=k.z);var l=this._renderer._useLightShader();return l.setUniform("uUseLighting",!0),l.setUniform("uMaterialColor",this._renderer.curFillColor),this._renderer.pointLightPositions.push(g,h,i),l.setUniform("uPointLightLocation",this._renderer.pointLightPositions),this._renderer.pointLightColors.push(j._array[0],j._array[1],j._array[2]),l.setUniform("uPointLightColor",this._renderer.pointLightColors),l.setUniform("uPointLightCount",this._renderer.pointLightColors.length/3),this},b.exports=d},{"../core/core":21}],66:[function(a,b,c){"use strict";function d(a,b){for(var c={v:[],vt:[],vn:[]},d={},f=0;f0)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":21,"./p5.Geometry":68}],67:[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.createShader=function(a,b){return new d.Shader(this._renderer,a,b)},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.curFillColor=[1,1,1,1],this.noStroke(),this},d.prototype.texture=function(a){this._renderer.GL.depthMask(!0),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=e.TEXTURE;var b=this._renderer._useLightShader();return b.setUniform("uSpecular",!1),b.setUniform("isTexture",!0),b.setUniform("uSampler",a),this.noStroke(),this},d.prototype.ambientMaterial=function(a,b,c,e){var f=d.prototype.color.apply(this,arguments);this._renderer.curFillColor=f._array;var g=this._renderer._useLightShader();return g.setUniform("uMaterialColor",this._renderer.curFillColor),g.setUniform("uSpecular",!1),g.setUniform("isTexture",!1),this},d.prototype.specularMaterial=function(a,b,c,e){var f=d.prototype.color.apply(this,arguments);this._renderer.curFillColor=f._array;var g=this._renderer._useLightShader();return g.setUniform("uMaterialColor",this._renderer.curFillColor),g.setUniform("uSpecular",!0),g.setUniform("isTexture",!1),this},d.RendererGL.prototype._applyColorBlend=function(a){var b=this.GL;return a[a.length-1]<1?(b.depthMask(!1),b.enable(b.BLEND),b.blendEquation(b.FUNC_ADD),b.blendFunc(b.SRC_ALPHA,b.ONE_MINUS_SRC_ALPHA)):(b.depthMask(!0),b.disable(b.BLEND)),a},b.exports=d},{"../core/constants":20,"../core/core":21,"./p5.Texture":74}],68:[function(a,b,c){"use strict";var d=a("../core/core");d.Geometry=function(a,b,c){return this.vertices=[],this.lineVertices=[],this.lineNormals=[],this.vertexNormals=[],this.faces=[],this.uvs=[],this.edges=[],this.detailX=void 0!==a?a:1,this.detailY=void 0!==b?b:1,c instanceof Function&&c.call(this),this.name="p5.Geometry",this},d.Geometry.prototype.computeFaces=function(){for(var a,b,c,d,e=this.detailX+1,f=0;fthis.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--}this.gHash[a]={}},d.RendererGL.prototype._freeBuffers=function(a){var b=this.gHash[a];if(b){delete this.gHash[a],e--;var c=this.GL;b.vertexBuffer&&c.deleteBuffer(b.vertexBuffer),b.normalBuffer&&c.deleteBuffer(b.normalBuffer),b.lineNormalBuffer&&c.deleteBuffer(b.lineNormalBuffer),b.uvBuffer&&c.deleteBuffer(b.uvBuffer),b.indexBuffer&&c.deleteBuffer(b.indexBuffer), +b.lineVertexBuffer&&c.deleteBuffer(b.lineVertexBuffer)}},d.RendererGL.prototype.createBuffers=function(a,b){var c=this.GL;this._setDefaultCamera(),this._initBufferDefaults(a);var d=this.gHash[a];d.numberOfItems=3*b.faces.length,d.lineVertexCount=b.lineVertices.length,this._useColorShader(),this.curStrokeShader.attributes.aPosition&&(d.lineVertexBuffer=c.createBuffer(),this._bindBuffer(d.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.curStrokeShader.attributes.aDirection&&(d.lineNormalBuffer=c.createBuffer(),this._bindBuffer(d.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.curFillShader.attributes.aPosition&&(d.vertexBuffer=c.createBuffer(),this._bindBuffer(d.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)),d.indexBuffer=c.createBuffer(),this._bindBuffer(d.indexBuffer,c.ELEMENT_ARRAY_BUFFER,this._flatten(b.faces),Uint16Array,c.STATIC_DRAW),this.curFillShader.attributes.aNormal&&(d.normalBuffer=c.createBuffer(),this._bindBuffer(d.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.curFillShader.attributes.aTexCoord&&(d.uvBuffer=c.createBuffer(),this._bindBuffer(d.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;this._useColorShader();var c=this.gHash[a];return this._doStroke&&c.lineVertexCount>0&&(this.curStrokeShader.bindShader(),c.lineVertexBuffer&&(this._bindBuffer(c.lineVertexBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0)),c.lineNormalBuffer&&(this._bindBuffer(c.lineNormalBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aDirection.location,4,b.FLOAT,!1,0,0)),this._applyColorBlend(this.curStrokeColor),this._drawArrays(b.TRIANGLES,a),this.curStrokeShader.unbindShader()),!1!==this._doFill&&(this.curFillShader.bindShader(),c.vertexBuffer&&(this._bindBuffer(c.vertexBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0)),c.indexBuffer&&this._bindBuffer(c.indexBuffer,b.ELEMENT_ARRAY_BUFFER),c.normalBuffer&&(this._bindBuffer(c.normalBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aNormal.location,3,b.FLOAT,!1,0,0)),c.uvBuffer&&(this._bindBuffer(c.uvBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aTexCoord.location,2,b.FLOAT,!1,0,0)),this._applyColorBlend(this.curFillColor),this._drawElements(b.TRIANGLES,a),this.curFillShader.unbindShader()),this},d.RendererGL.prototype.drawBuffersScaled=function(a,b,c,d){var e=this.uMVMatrix.copy();try{this.uMVMatrix.scale(b,c,d),this.drawBuffers(a)}finally{this.uMVMatrix=e}},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":21}],72:[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 = 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}",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;\nvec3 scale = vec3(1.0);\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}"};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.attributes.perPixelLighting=void 0!==e.perPixelLighting&&e.perPixelLighting,this._initContext(),this.isP3D=!0,this.GL=this.drawingContext,this.ambientLightColors=[],this.directionalLightDirections=[],this.directionalLightColors=[],this.pointLightPositions=[],this.pointLightColors=[],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(b),this.camera(),this.gHash={},this._defaultLightShader=void 0,this._defaultImmediateModeShader=void 0,this._defaultNormalShader=void 0,this._defaultColorShader=void 0,this.curFillShader=void 0,this.curStrokeShader=void 0,this._useColorShader(),this.setStrokeShader(this._getLineShader()),this.isImmediateDrawing=!1,this.immediateMode={},this.fill(255,255,255,255),this.pointSize=5,this.strokeWeight(2),this.stroke(0,0,0),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),this._viewport=this.drawingContext.getParameter(this.drawingContext.VIEWPORT)}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;var i=new d.RendererGL(this._pInst.canvas,this._pInst,!0,a);this._pInst._setProperty("_renderer",i),i.resize(e,f),i._applyDefaults(),this._pInst._elements.push(i),"function"==typeof c&&setTimeout(function(){c.apply(window._renderer,b)},0)},d.prototype.setAttributes=function(a,b){var c;void 0!==b?(c={},c[a]=b):a instanceof Object&&(c=a),this._renderer._resetContext(c)},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.ambientLightColors.length=0,this.directionalLightDirections.length=0,this.directionalLightColors.length=0,this.pointLightPositions.length=0,this.pointLightColors.length=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.depthMask(!0),this.GL.clear(this.GL.COLOR_BUFFER_BIT|this.GL.DEPTH_BUFFER_BIT)},d.RendererGL.prototype.fill=function(a,b,c,f){var g=d.prototype.color.apply(this._pInst,arguments);this.curFillColor=g._array,this.isImmediateDrawing?this.setFillShader(this._getImmediateModeShader()):this.setFillShader(this._getColorShader()),this.drawMode=e.FILL,this.curFillShader.setUniform("uMaterialColor",this.curFillColor)},d.RendererGL.prototype.stroke=function(a,b,c,e){arguments[3]=255;var f=d.prototype.color.apply(this._pInst,arguments);this.curStrokeColor=f._array,this.curStrokeShader.setUniform("uMaterialColor",this.curStrokeColor)},d.RendererGL.prototype.strokeWeight=function(a){this.curStrokeWeight!==a&&(this.pointSize=a,this.curStrokeWeight=a,this.curStrokeShader.setUniform("uStrokeWeight",a))},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(!0!==this.attributes.preserveDrawingBuffer)return void console.log("loadPixels only works in WebGL when preserveDrawingBuffer is true.");var a=this._pInst._pixelDensity,b=this.width,c=this.height;b*=a,c*=a,void 0===this.pixels&&(this.pixels=new Uint8Array(this.GL.drawingBufferWidth*this.GL.drawingBufferHeight*4)),this.GL.readPixels(0,0,b,c,this.GL.RGBA,this.GL.UNSIGNED_BYTE,this.pixels),this._pInst._setProperty("pixels",this.pixels)},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),this._viewport=this.GL.getParameter(this.GL.VIEWPORT),null!==this._curCamera&&"default"!==this._curCamera||(this._curCamera=null,this._setDefaultCamera()),void 0!==this.pixels&&(this.pixels=new Uint8Array(this.GL.drawingBufferWidth*this.GL.drawingBufferHeight*4))},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 void 0===b?this.rotateZ(a):(d.Matrix.prototype.rotate.apply(this.uMVMatrix,arguments),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._pInst),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},d.RendererGL.prototype.setStrokeShader=function(a){return this.curStrokeShader!==a&&(this.curStrokeShader=a,this.curStrokeShader.init()),this.curStrokeShader},d.RendererGL.prototype._useLightShader=function(){return this.curFillShader&&this.curFillShader.isLightShader()||this.setFillShader(this._getLightShader()),this.curFillShader},d.RendererGL.prototype._useColorShader=function(){return this.curFillShader&&this.curFillShader!==this._defaultImmediateModeShader||this.setFillShader(this._getColorShader()),this.curFillShader},d.RendererGL.prototype._useImmediateModeShader=function(){return this.curFillShader&&this.curFillShader!==this._defaultColorShader||this.setFillShader(this._getImmediateModeShader()),this.curFillShader},d.RendererGL.prototype._getLightShader=function(){return this._defaultLightShader||(this.attributes.perPixelLighting?this._defaultLightShader=new d.Shader(this,h.phongVert,h.phongFrag):this._defaultLightShader=new d.Shader(this,h.lightVert,h.lightTextureFrag)),this._defaultLightShader},d.RendererGL.prototype._getImmediateModeShader=function(){return this._defaultImmediateModeShader||(this._defaultImmediateModeShader=new d.Shader(this,h.immediateVert,h.vertexColorFrag)),this._defaultImmediateModeShader},d.RendererGL.prototype._getNormalShader=function(){return this._defaultNormalShader||(this._defaultNormalShader=new d.Shader(this,h.normalVert,h.normalFrag)),this._defaultNormalShader},d.RendererGL.prototype._getColorShader=function(){return this._defaultColorShader||(this._defaultColorShader=new d.Shader(this,h.normalVert,h.basicFrag)),this._defaultColorShader},d.RendererGL.prototype._getLineShader=function(){return this._defaultLineShader||(this._defaultLineShader=new d.Shader(this,h.lineVert,h.lineFrag)),this._defaultLineShader},d.RendererGL.prototype._getEmptyTexture=function(){if(!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 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){if(0===a.length)return[];if(a.length>2e4){var b,c=Object.prototype.toString,d="[object Array]",e=[],f=a.slice();b=f.pop();do{c.call(b)===d?f.push.apply(f,b):e.push(b)}while(f.length&&void 0!==(b=f.pop()));return e.reverse(),e}return[].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":20,"../core/core":21,"../core/p5.Renderer":28,"./p5.Matrix":69,"./p5.Shader":73}],73:[function(a,b,c){"use strict";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?e.uniform1iv(d,b):e.uniform1i(d,b);break;case e.FLOAT:c.size>1?e.uniform1fv(d,b):e.uniform1f(d,b);break;case e.FLOAT_MAT3:e.uniformMatrix3fv(d,!1,b);break;case e.FLOAT_MAT4:e.uniformMatrix4fv(d,!1,b);break;case e.FLOAT_VEC2:c.size>1?e.uniform2fv(d,b):e.uniform2f(d,b[0],b[1]);break;case e.FLOAT_VEC3:c.size>1?e.uniform3fv(d,b):e.uniform3f(d,b[0],b[1],b[2]);break;case e.FLOAT_VEC4:c.size>1?e.uniform4fv(d,b):e.uniform4f(d,b[0],b[1],b[2],b[3]);break;case e.SAMPLER_2D:e.activeTexture(e.TEXTURE0+c.samplerIndex),c.texture=this._renderer.getTexture(b),e.uniform1i(c.location,c.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-1!==a&&(g.enableVertexAttribArray(a),g.vertexAttribPointer(a,b,c,d,e,f)),this},b.exports=d.Shader},{"../core/core":21}],74:[function(a,b,c){"use strict";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&&!(b instanceof d.Graphics),this.isSrcP5Image=b instanceof d.Image,this.isSrcP5Graphics=b instanceof d.Graphics;var e=this._getTextureDataFromSource();return this.width=e.width,this.height=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":21}],75:[function(a,b,c){"use strict";var d=a("../core/core");a("./p5.Geometry"),d.prototype.plane=function(a,b,c,e){void 0===a&&(a=50),void 0===b&&(b=a),void 0===c&&(c=1),void 0===e&&(e=1);var f="plane|"+c+"|"+e;if(!this._renderer.geometryInHash(f)){var g=function(){for(var a,b,c,e=0;e<=this.detailY;e++){b=e/this.detailY;for(var f=0;f<=this.detailX;f++)a=f/this.detailX,c=new d.Vector(a-.5,b-.5,0),this.vertices.push(c),this.uvs.push([a,b])}},h=new d.Geometry(c,e,g);h.computeFaces().computeNormals(),c<=1&&e<=1?(h._makeTriangleEdges(),this._renderer._edgesToVertices(h)):console.log("Cannot draw stroke on plane objects with more than 1 detailX or 1 detailY"),this._renderer.createBuffers(f,h)}this._renderer.drawBuffersScaled(f,a,b,0)},d.prototype.box=function(a,b,c,e,f){void 0===a&&(a=50),void 0===b&&(b=a),void 0===c&&(c=b),void 0===e&&(e=4),void 0===f&&(f=4);var g="box|"+e+"|"+f;if(!this._renderer.geometryInHash(g)){var h=function(){var a=[[0,4,2,6],[1,3,5,7],[0,1,4,5],[2,6,3,7],[0,2,1,3],[4,5,6,7]];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 b=0;bf?(r=c,q=1,p=b):p=a+i/f*(b-a),-2!==i&&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;i x / 255); + let label = training[i].label; + let targets = [0, 0, 0]; + targets[label] = 1; + // console.log(inputs); + // console.log(targets); + nn.train(inputs, targets); + } +} + +function testAll(testing) { + + let correct = 0; + // Train for one epoch + for (let i = 0; i < testing.length; i++) { + // for (let i = 0; i < 1; i++) { + let data = testing[i]; + let inputs = Array.from(data).map(x => x / 255); + let label = testing[i].label; + let guess = nn.predict(inputs); + + let m = max(guess); + let classification = guess.indexOf(m); + // console.log(guess); + // console.log(classification); + // console.log(label); + + if (classification === label) { + correct++; + } + } + let percent = 100 * correct / testing.length; + return percent; + +} From 761575779c296dc8d2fa5183fc478ef920c68b52 Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Mon, 5 Mar 2018 19:19:18 -0500 Subject: [PATCH 03/29] Create README.md --- examples/doodle_classification/README.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 examples/doodle_classification/README.md diff --git a/examples/doodle_classification/README.md b/examples/doodle_classification/README.md new file mode 100644 index 0000000..1e50afc --- /dev/null +++ b/examples/doodle_classification/README.md @@ -0,0 +1 @@ +https://codingtrain.github.io/Toy-Neural-Network-JS/examples/doodle_classification/ From c8ae50a438207420346b139e095f47cdbd242e0f Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Fri, 9 Mar 2018 16:10:21 -0500 Subject: [PATCH 04/29] adding new neuro-evolution example nothing to see here yet! --- examples/neuro-evolution/index.html | 12 ++++++++++++ examples/neuro-evolution/libraries/p5.dom.min.js | 1 + examples/neuro-evolution/libraries/p5.min.js | 13 +++++++++++++ examples/neuro-evolution/sketch.js | 4 ++++ 4 files changed, 30 insertions(+) create mode 100755 examples/neuro-evolution/index.html create mode 100644 examples/neuro-evolution/libraries/p5.dom.min.js create mode 100644 examples/neuro-evolution/libraries/p5.min.js create mode 100644 examples/neuro-evolution/sketch.js diff --git a/examples/neuro-evolution/index.html b/examples/neuro-evolution/index.html new file mode 100755 index 0000000..8caf295 --- /dev/null +++ b/examples/neuro-evolution/index.html @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/examples/neuro-evolution/libraries/p5.dom.min.js b/examples/neuro-evolution/libraries/p5.dom.min.js new file mode 100644 index 0000000..ece75c0 --- /dev/null +++ b/examples/neuro-evolution/libraries/p5.dom.min.js @@ -0,0 +1 @@ +/*! p5.js v0.6.0 January 19, 2018 */ !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,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 d(a,b,d,e){var f=document.createElement(b);"string"==typeof(d=d||"")&&(d=[d]);for(var g=0;g0&&c.every(function(a){return"INPUT"===a.tagName||"LABEL"===a.tagName})?this.createRadio(new a.Element(b)):new a.Element(b)},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.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,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};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;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)},{}],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(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=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)we[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 ne;for(a.sourceIndex+=4,d=b;d;--d)a.dest[a.destLen++]=a.source[a.sourceIndex++];return a.bitcount=0,me}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,oe,pe);break;case 2:l(f,f.ltree,f.dtree),e=m(f,f.ltree,f.dtree);break;default:e=ne}if(e!==me)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 Ne.Parser(c,d+e+14),h=new Ne.Parser(c,d+e+16+2*f),i=new Ne.Parser(c,d+e+16+4*f),j=new Ne.Parser(c,d+e+16+6*f),k=d+e+16+8*f,l=0;l=0;e-=1){var f=Ne.getUShort(a,b+4+8*e),g=Ne.getUShort(a,b+4+8*e+2);if(3===f&&(0===g||1===g||10===g)){d=Ne.getULong(a,b+4+8*e+4);break}}if(-1===d)throw new Error("No valid cmap sub-tables found.");var h=new Ne.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})}function V(a){a.segments.push({end:65535,start:65535,delta:1,offset:0})}function W(a){var b=new Ke.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}]);b.segments=[];for(var c=0;c0?(f=a.parseByte(),0==(b&e)&&(f=-f),f=c+f):f=(b&e)>0?c:c+a.parseShort(),f}function ca(a,b,c){var d=new Ne.Parser(b,c);a.numberOfContours=d.parseShort(),a._xMin=d.parseShort(),a._yMin=d.parseShort(),a._xMax=d.parseShort(),a._yMax=d.parseShort();var e,f;if(a.numberOfContours>0){for(var g=a.endPointIndices=[],h=0;h0)for(var l=d.parseByte(),m=0;m0){var n,o=[];if(j>0){for(var p=0;p=0,o.push(n);for(var q=0,r=0;r0?(2&e)>0?(v.dx=d.parseShort(),v.dy=d.parseShort()):v.matchedPoints=[d.parseUShort(),d.parseUShort()]:(2&e)>0?(v.dx=d.parseChar(),v.dy=d.parseChar()):v.matchedPoints=[d.parseByte(),d.parseByte()],(8&e)>0?v.xScale=v.yScale=d.parseF2Dot14():(64&e)>0?(v.xScale=d.parseF2Dot14(),v.yScale=d.parseF2Dot14()):(128&e)>0&&(v.xScale=d.parseF2Dot14(),v.scale01=d.parseF2Dot14(),v.scale10=d.parseF2Dot14(),v.yScale=d.parseF2Dot14()),a.components.push(v),u=!!(32&e)}if(256&e){a.instructionLength=d.parseUShort(),a.instructions=[];for(var w=0;wb.points.length-1||d.matchedPoints[1]>e.points.length-1)throw Error("Matched points out of range in "+b.name);var g=b.points[d.matchedPoints[0]],h=e.points[d.matchedPoints[1]],i={xScale:d.xScale,scale01:d.scale01,scale10:d.scale10,yScale:d.yScale,dx:0,dy:0};h=da([h],i)[0],i.dx=g.x-h.x,i.dy=g.y-h.y,f=da(e.points,i)}b.points=b.points.concat(f)}}return fa(b.points)}function ha(a,b,c,d){for(var e=new Ve.GlyphSet(d),f=0;f>4,g=15&e;if(f===c)break;if(b+=d[f],g===c)break;b+=d[g]}return parseFloat(b)}function ta(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 sa(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 ua(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 Fa(a,b,c,d){var e,f=[],g=new Ne.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+Pe.length:(c=Pe.length+b.length,b.push(a)),c}function Ia(){return new Ke.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 Ja(a){var b=new Ke.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 mb(a){return new Ke.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 nb(a,b){var c={},d=new Ne.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=Se.slice();break;case 2:c.numberOfGlyphs=d.parseUShort(),c.glyphNameIndex=new Array(c.numberOfGlyphs);for(var e=0;e=Se.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;hb.value.tag?1:-1}),b.fields=b.fields.concat(d),b.fields=b.fields.concat(e),b}function xb(a,b,c){for(var d=0;d0){return a.glyphs.get(e).getMetrics()}}return c}function yb(a){for(var b=0,c=0;cq||void 0===b)&&q>0&&(b=q),j 123 are reserved for internal usage");n|=1<0?af.make(G):void 0,J=nf.make(),K=Ye.make(a.glyphs,{version:a.getEnglishName("version"),fullName:C,familyName:A,weightName:B,postScriptName:D,unitsPerEm:a.unitsPerEm,fontBBox:[0,t.yMin,t.ascender,t.advanceWidthMax]}),L=a.metas&&Object.keys(a.metas).length>0?sf.make(a.metas):void 0,M=[u,v,w,x,H,z,J,K,y];I&&M.push(I),a.tables.gsub&&M.push(rf.make(a.tables.gsub)),L&&M.push(L);for(var N=wb(M),O=N.encode(),P=ub(O),Q=N.fields,R=!1,S=0;S>>1,f=a[e].tag;if(f===b)return e;f>>1,f=a[e];if(f===b)return e;f=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 Xb(b,c){a.DEBUG&&console.log(c.step,"SVTCA["+b.axis+"]"),c.fv=c.pv=c.dpv=b}function Yb(b,c){a.DEBUG&&console.log(c.step,"SPVTCA["+b.axis+"]"),c.pv=c.dpv=b}function Zb(b,c){a.DEBUG&&console.log(c.step,"SFVTCA["+b.axis+"]"),c.fv=b}function $b(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SPVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.pv=c.dpv=Sb(i,j)}function _b(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SFVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.fv=Sb(i,j)}function ac(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SPVFS[]",d,e),b.pv=b.dpv=Sb(e,d)}function bc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SPVFS[]",d,e),b.fv=Sb(e,d)}function cc(b){var c=b.stack,d=b.pv;a.DEBUG&&console.log(b.step,"GPV[]"),c.push(16384*d.x),c.push(16384*d.y)}function dc(b){var c=b.stack,d=b.fv;a.DEBUG&&console.log(b.step,"GFV[]"),c.push(16384*d.x),c.push(16384*d.y)}function ec(b){b.fv=b.pv,a.DEBUG&&console.log(b.step,"SFVTPV[]")}function fc(b){var c=b.stack,d=c.pop(),e=c.pop(),f=c.pop(),g=c.pop(),h=c.pop(),i=b.z0,j=b.z1,k=i[d],l=i[e],m=j[f],n=j[g],o=b.z2[h];a.DEBUG&&console.log("ISECT[], ",d,e,f,g,h);var p=k.x,q=k.y,r=l.x,s=l.y,t=m.x,u=m.y,v=n.x,w=n.y,x=(p-r)*(u-w)-(q-s)*(t-v),y=p*s-q*r,z=t*w-u*v;o.x=(y*(t-v)-z*(p-r))/x,o.y=(y*(u-w)-z*(q-s))/x}function gc(b){b.rp0=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP0[]",b.rp0)}function hc(b){b.rp1=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP1[]",b.rp1)}function ic(b){b.rp2=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP2[]",b.rp2)}function jc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP0[]",c),b.zp0=c,c){case 0:b.tZone||Vb(b),b.z0=b.tZone;break;case 1:b.z0=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function kc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP1[]",c),b.zp1=c,c){case 0:b.tZone||Vb(b),b.z1=b.tZone;break;case 1:b.z1=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function lc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP2[]",c),b.zp2=c,c){case 0:b.tZone||Vb(b),b.z2=b.tZone;break;case 1:b.z2=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function mc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZPS[]",c),b.zp0=b.zp1=b.zp2=c,c){case 0:b.tZone||Vb(b),b.z0=b.z1=b.z2=b.tZone;break;case 1:b.z0=b.z1=b.z2=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function nc(b){b.loop=b.stack.pop(),a.DEBUG&&console.log(b.step,"SLOOP[]",b.loop)}function oc(b){a.DEBUG&&console.log(b.step,"RTG[]"),b.round=Mb}function pc(b){a.DEBUG&&console.log(b.step,"RTHG[]"),b.round=Ob}function qc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SMD[]",c),b.minDis=c/64}function rc(b){a.DEBUG&&console.log(b.step,"ELSE[]"),Wb(b,!1)}function sc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"JMPR[]",c),b.ip+=c-1}function tc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCVTCI[]",c),b.cvCutIn=c/64}function uc(b){var c=b.stack;a.DEBUG&&console.log(b.step,"DUP[]"),c.push(c[c.length-1])}function vc(b){a.DEBUG&&console.log(b.step,"POP[]"),b.stack.pop()}function wc(b){a.DEBUG&&console.log(b.step,"CLEAR[]"),b.stack.length=0}function xc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SWAP[]"),c.push(d),c.push(e)}function yc(b){var c=b.stack;a.DEBUG&&console.log(b.step,"DEPTH[]"),c.push(c.length)}function zc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"LOOPCALL[]",d,e);var f=b.ip,g=b.prog;b.prog=b.funcs[d];for(var h=0;h1?"loop "+(c.loop-i)+": ":"")+"SHP["+(b?"rp1":"rp2")+"]",k)}c.loop=1}function Hc(b,c){var d=c.stack,e=b?c.rp1:c.rp2,f=(b?c.z0:c.z1)[e],g=c.fv,h=c.pv,i=d.pop(),j=c.z2[c.contours[i]],k=j;a.DEBUG&&console.log(c.step,"SHC["+b+"]",i);var l=h.distance(f,f,!1,!0);do{k!==f&&g.setRelative(k,k,l,h),k=k.nextPointOnContour}while(k!==j)}function Ic(b,c){var d=c.stack,e=b?c.rp1:c.rp2,f=(b?c.z0:c.z1)[e],g=c.fv,h=c.pv,i=d.pop();a.DEBUG&&console.log(c.step,"SHZ["+b+"]",i);var j;switch(i){case 0:j=c.tZone;break;case 1:j=c.gZone;break;default:throw new Error("Invalid zone")}for(var k,l=h.distance(f,f,!1,!0),m=j.length-2,n=0;n1?"loop "+(b.loop-d)+": ":"")+"SHPIX[]",h,f),e.setRelative(i,i,f),e.touch(i)}b.loop=1}function Kc(b){for(var c=b.stack,d=b.rp1,e=b.rp2,f=b.loop,g=b.z0[d],h=b.z1[e],i=b.fv,j=b.dpv,k=b.z2;f--;){var l=c.pop(),m=k[l];a.DEBUG&&console.log(b.step,(b.loop>1?"loop "+(b.loop-f)+": ":"")+"IP[]",l,d,"<->",e),i.interpolate(m,g,h,j),i.touch(m)}b.loop=1}function Lc(b,c){var d=c.stack,e=d.pop()/64,f=d.pop(),g=c.z1[f],h=c.z0[c.rp0],i=c.fv,j=c.pv;i.setRelative(g,h,e,j),i.touch(g),a.DEBUG&&console.log(c.step,"MSIRP["+b+"]",e,f),c.rp1=c.rp0,c.rp2=f,b&&(c.rp0=f)}function Mc(b){for(var c=b.stack,d=b.rp0,e=b.z0[d],f=b.loop,g=b.fv,h=b.pv,i=b.z1;f--;){var j=c.pop(),k=i[j];a.DEBUG&&console.log(b.step,(b.loop>1?"loop "+(b.loop-f)+": ":"")+"ALIGNRP[]",j),g.setRelative(k,e,0,h),g.touch(k)}b.loop=1}function Nc(b){a.DEBUG&&console.log(b.step,"RTDG[]"),b.round=Nb}function Oc(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z0[f],h=c.fv,i=c.pv,j=c.cvt[e];b&&(j=c.round(j)),a.DEBUG&&console.log(c.step,"MIAP["+b+"]",e,"(",j,")",f),h.setRelative(g,Bf,j,i),0===c.zp0&&(g.xo=g.x,g.yo=g.y),h.touch(g),c.rp0=c.rp1=f}function Pc(b){var c=b.prog,d=b.ip,e=b.stack,f=c[++d];a.DEBUG&&console.log(b.step,"NPUSHB[]",f);for(var g=0;g",i),c.stack.push(Math.round(64*i))}function Xc(b){a.DEBUG&&console.log(b.step,"MPPEM[]"),b.stack.push(b.ppem)}function Yc(b){a.DEBUG&&console.log(b.step,"FLIPON[]"),b.autoFlip=!0}function Zc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"LT[]",d,e),c.push(ed?1:0)}function ad(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"GTEQ[]",d,e),c.push(e>=d?1:0)}function bd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"EQ[]",d,e),c.push(d===e?1:0)}function cd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"NEQ[]",d,e),c.push(d!==e?1:0)}function dd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"ODD[]",d),c.push(Math.trunc(d)%2?1:0)}function ed(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"EVEN[]",d),c.push(Math.trunc(d)%2?0:1)}function fd(b){var c,d=b.stack.pop();a.DEBUG&&console.log(b.step,"IF[]",d),d||(Wb(b,!0),a.DEBUG&&console.log(b.step,27===c?"ELSE[]":"EIF[]"))}function gd(b){a.DEBUG&&console.log(b.step,"EIF[]")}function hd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"AND[]",d,e),c.push(d&&e?1:0)}function id(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"OR[]",d,e),c.push(d||e?1:0)}function jd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"NOT[]",d),c.push(d?0:1)}function kd(b,c){var d=c.stack,e=d.pop(),f=c.fv,g=c.pv,h=c.ppem,i=c.deltaBase+16*(b-1),j=c.deltaShift,k=c.z0;a.DEBUG&&console.log(c.step,"DELTAP["+b+"]",e,d);for(var l=0;l>4)===h){var o=(15&n)-8;o>=0&&o++,a.DEBUG&&console.log(c.step,"DELTAPFIX",m,"by",o*j);var p=k[m];f.setRelative(p,p,o*j,g)}}}function ld(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"SDB[]",d),b.deltaBase=d}function md(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"SDS[]",d),b.deltaShift=Math.pow(.5,d)}function nd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"ADD[]",d,e),c.push(e+d)}function od(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SUB[]",d,e),c.push(e-d)}function pd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"DIV[]",d,e),c.push(64*e/d)}function qd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MUL[]",d,e),c.push(e*d/64)}function rd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"ABS[]",d),c.push(Math.abs(d))}function sd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"NEG[]",d),c.push(-d)}function td(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"FLOOR[]",d),c.push(64*Math.floor(d/64))}function ud(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"CEILING[]",d),c.push(64*Math.ceil(d/64))}function vd(b,c){var d=c.stack,e=d.pop();a.DEBUG&&console.log(c.step,"ROUND[]"),d.push(64*c.round(e/64))}function wd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"WCVTF[]",d,e),b.cvt[e]=d*b.ppem/b.font.unitsPerEm}function xd(b,c){var d=c.stack,e=d.pop(),f=c.ppem,g=c.deltaBase+16*(b-1),h=c.deltaShift;a.DEBUG&&console.log(c.step,"DELTAC["+b+"]",e,d);for(var i=0;i>4)===f){var l=(15&k)-8;l>=0&&l++;var m=l*h;a.DEBUG&&console.log(c.step,"DELTACFIX",j,"by",m),c.cvt[j]+=m}}}function yd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SROUND[]",c),b.round=yf;var d;switch(192&c){case 0:d=.5;break;case 64:d=1;break;case 128:d=2;break;default:throw new Error("invalid SROUND value")}switch(b.srPeriod=d,48&c){case 0:b.srPhase=0;break;case 16:b.srPhase=.25*d;break;case 32:b.srPhase=.5*d;break;case 48:b.srPhase=.75*d;break;default:throw new Error("invalid SROUND value")}c&=15,b.srThreshold=0===c?0:(c/8-.5)*d}function zd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"S45ROUND[]",c),b.round=yf;var d;switch(192&c){case 0:d=Math.sqrt(2)/2;break;case 64:d=Math.sqrt(2);break;case 128:d=2*Math.sqrt(2);break;default:throw new Error("invalid S45ROUND value")}switch(b.srPeriod=d,48&c){case 0:b.srPhase=0;break;case 16:b.srPhase=.25*d;break;case 32:b.srPhase=.5*d;break;case 48:b.srPhase=.75*d;break;default:throw new Error("invalid S45ROUND value")}c&=15,b.srThreshold=0===c?0:(c/8-.5)*d}function Ad(b){a.DEBUG&&console.log(b.step,"ROFF[]"),b.round=Lb}function Bd(b){a.DEBUG&&console.log(b.step,"RUTG[]"),b.round=Pb}function Cd(b){a.DEBUG&&console.log(b.step,"RDTG[]"),b.round=Qb}function Dd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCANCTRL[]",c)}function Ed(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SDPVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.dpv=Sb(i,j)}function Fd(b){var c=b.stack,d=c.pop(),e=0;a.DEBUG&&console.log(b.step,"GETINFO[]",d),1&d&&(e=35),32&d&&(e|=4096),c.push(e)}function Gd(b){var c=b.stack,d=c.pop(),e=c.pop(),f=c.pop();a.DEBUG&&console.log(b.step,"ROLL[]"),c.push(e),c.push(d),c.push(f)}function Hd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MAX[]",d,e),c.push(Math.max(e,d))}function Id(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MIN[]",d,e),c.push(Math.min(e,d))}function Jd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCANTYPE[]",c)}function Kd(b){var c=b.stack.pop(),d=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"INSTCTRL[]",c,d),c){case 1:return void(b.inhibitGridFit=!!d);case 2:return void(b.ignoreCvt=!!d);default:throw new Error("invalid INSTCTRL[] selector")}}function Ld(b,c){var d=c.stack,e=c.prog,f=c.ip;a.DEBUG&&console.log(c.step,"PUSHB["+b+"]");for(var g=0;g=0?1:-1,i=Math.abs(i),b&&(k=g.cvt[m],e&&Math.abs(i-k)":"_")+(e?"R":"_")+(0===f?"Gr":1===f?"Bl":2===f?"Wh":"")+"]",b?m+"("+g.cvt[m]+","+k+")":"",n,"(d =",h,"->",j*i,")"),g.rp1=g.rp0,g.rp2=n,c&&(g.rp0=n)}function Od(a){a=a||{},a.empty||(Jb(a.familyName,"When creating a new Font object, familyName is required."),Jb(a.styleName,"When creating a new Font object, styleName is required."),Jb(a.unitsPerEm,"When creating a new Font object, unitsPerEm is required."),Jb(a.ascender,"When creating a new Font object, ascender is required."), +Jb(a.descender,"When creating a new Font object, descender is required."),Jb(a.descender<0,"Descender should be negative (e.g. -512)."),this.names={fontFamily:{en:a.familyName||" "},fontSubfamily:{en:a.styleName||" "},fullName:{en:a.fullName||a.familyName+" "+a.styleName},postScriptName:{en:a.postScriptName||a.familyName+a.styleName},designer:{en:a.designer||" "},designerURL:{en:a.designerURL||" "},manufacturer:{en:a.manufacturer||" "},manufacturerURL:{en:a.manufacturerURL||" "},license:{en:a.license||" "},licenseURL:{en:a.licenseURL||" "},version:{en:a.version||"Version 0.1"},description:{en:a.description||" "},copyright:{en:a.copyright||" "},trademark:{en:a.trademark||" "}},this.unitsPerEm=a.unitsPerEm||1e3,this.ascender=a.ascender,this.descender=a.descender,this.createdTimestamp=a.createdTimestamp,this.tables={os2:{usWeightClass:a.weightClass||this.usWeightClasses.MEDIUM,usWidthClass:a.widthClass||this.usWidthClasses.MEDIUM,fsSelection:a.fsSelection||this.fsSelectionValues.REGULAR}}),this.supported=!0,this.glyphs=new Ve.GlyphSet(this,a.glyphs||[]),this.encoding=new X(this),this.substitution=new Db(this),this.tables=this.tables||{},Object.defineProperty(this,"hinting",{get:function(){return this._hinting?this._hinting:"truetype"===this.outlinesFormat?this._hinting=new Kb(this):void 0}})}function Pd(a,b){var c=JSON.stringify(a),d=256;for(var e in b){var f=parseInt(e);if(f&&!(f<256)){if(JSON.stringify(b[e])===c)return f;d<=f&&(d=f+1)}}return b[d]=a,d}function Qd(a,b,c){var d=Pd(b.name,c);return[{name:"tag_"+a,type:"TAG",value:b.tag},{name:"minValue_"+a,type:"FIXED",value:b.minValue<<16},{name:"defaultValue_"+a,type:"FIXED",value:b.defaultValue<<16},{name:"maxValue_"+a,type:"FIXED",value:b.maxValue<<16},{name:"flags_"+a,type:"USHORT",value:0},{name:"nameID_"+a,type:"USHORT",value:d}]}function Rd(a,b,c){var d={},e=new Ne.Parser(a,b);return d.tag=e.parseTag(),d.minValue=e.parseFixed(),d.defaultValue=e.parseFixed(),d.maxValue=e.parseFixed(),e.skip("uShort",1),d.name=c[e.parseUShort()]||{},d}function Sd(a,b,c,d){for(var e=Pd(b.name,d),f=[{name:"nameID_"+a,type:"USHORT",value:e},{name:"flags_"+a,type:"USHORT",value:0}],g=0;g>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;fthis.x2&&(this.x2=a)),"number"==typeof b&&((isNaN(this.y1)||isNaN(this.y2))&&(this.y1=b,this.y2=b),bthis.y2&&(this.y2=b))},q.prototype.addX=function(a){this.addPoint(a,null)},q.prototype.addY=function(a){this.addPoint(null,a)},q.prototype.addBezier=function(a,b,c,d,e,f,g,h){var i=this,j=[a,b],k=[c,d],l=[e,f],m=[g,h];this.addPoint(a,b),this.addPoint(g,h);for(var n=0;n<=1;n++){var o=6*j[n]-12*k[n]+6*l[n],q=-3*j[n]+9*k[n]-9*l[n]+3*m[n],r=3*k[n]-3*j[n];if(0!==q){var s=Math.pow(o,2)-4*r*q;if(!(s<0)){var t=(-o+Math.sqrt(s))/(2*q);0=0&&d>0&&(c+=" "),c+=b(e)}return c}var d=this;a=void 0!==a?a:2;for(var e="",f=0;f=0&&a<=255,"Byte value should be between 0 and 255."),[a]},Ee.BYTE=u(1),De.CHAR=function(a){return[a.charCodeAt(0)]},Ee.CHAR=u(1),De.CHARARRAY=function(a){for(var b=[],c=0;c>8&255,255&a]},Ee.USHORT=u(2),De.SHORT=function(a){return a>=Ae&&(a=-(2*Ae-a)),[a>>8&255,255&a]},Ee.SHORT=u(2),De.UINT24=function(a){return[a>>16&255,a>>8&255,255&a]},Ee.UINT24=u(3),De.ULONG=function(a){return[a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.ULONG=u(4),De.LONG=function(a){return a>=Be&&(a=-(2*Be-a)),[a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.LONG=u(4),De.FIXED=De.ULONG,Ee.FIXED=Ee.ULONG,De.FWORD=De.SHORT,Ee.FWORD=Ee.SHORT,De.UFWORD=De.USHORT,Ee.UFWORD=Ee.USHORT,De.LONGDATETIME=function(a){return[0,0,0,0,a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.LONGDATETIME=u(8),De.TAG=function(a){return ze.argument(4===a.length,"Tag should be exactly 4 ASCII characters."),[a.charCodeAt(0),a.charCodeAt(1),a.charCodeAt(2),a.charCodeAt(3)]},Ee.TAG=u(4),De.Card8=De.BYTE,Ee.Card8=Ee.BYTE,De.Card16=De.USHORT,Ee.Card16=Ee.USHORT,De.OffSize=De.BYTE,Ee.OffSize=Ee.BYTE,De.SID=De.USHORT,Ee.SID=Ee.USHORT,De.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?De.NUMBER16(a):De.NUMBER32(a)},Ee.NUMBER=function(a){return De.NUMBER(a).length},De.NUMBER16=function(a){return[28,a>>8&255,255&a]},Ee.NUMBER16=u(3),De.NUMBER32=function(a){return[29,a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.NUMBER32=u(5),De.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()}for(var e="",f=0,g=b.length;f>8&255,b[b.length]=255&d}return b},Ee.UTF16=function(a){return 2*a.length};var Fe={"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":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ"};Ce.MACSTRING=function(a,b,c,d){var e=Fe[d];if(void 0!==e){for(var f="",g=0;g=128&&void 0===(f=c[f]))return;d[e]=f}return d}},Ee.MACSTRING=function(a,b){var c=De.MACSTRING(a,b);return void 0!==c?c.length:0},De.VARDELTAS=function(a){for(var b=0,c=[];b=-128&&d<=127?x(a,b,c):y(a,b,c)}return c},De.INDEX=function(a){for(var b=1,c=[b],d=[],e=0;e>8,b[l+1]=255&m,b=b.concat(d[k])}return b},Ee.TABLE=function(a){for(var b=0,c=a.fields.length,d=0;d0)return new Q(this.data,this.offset+b).parseStruct(a)},Q.prototype.parseListOfLists=function(a){for(var b=this,c=this.parseOffset16List(),d=c.length,e=this.relativeOffset,f=new Array(d),g=0;g=0)return d[e].script;if(b){var f={tag:a,script:{defaultLangSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]},langSysRecords:[]}};return d.splice(-1-e,0,f),f.script}}},getLangSysTable:function(a,b,c){var d=this.getScriptTable(a,c);if(d){if(!b||"dflt"===b||"DFLT"===b)return d.defaultLangSys;var e=Ab(d.langSysRecords,b);if(e>=0)return d.langSysRecords[e].langSys;if(c){var f={tag:b,langSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]}};return d.langSysRecords.splice(-1-e,0,f),f.langSys}}},getFeatureTable:function(a,b,c,d){var e=this.getLangSysTable(a,b,d);if(e){for(var f,g=e.featureIndexes,h=this.font.tables[this.tableName].features,i=0;i=h[j-1].tag,"Features must be added in alphabetical order."),f={tag:c,feature:{params:0,lookupListIndexes:[]}},h.push(f),g.push(j),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;k=0){for(var k=f.ligatureSets[j],l=0;l0&&a<0?c:e<0&&a>0?-c:a*e},zf={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 zf.setRelative(a,a,(i+j)/2,d,!0):void zf.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}},Af={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 Af.setRelative(a,a,(i+j)/2,d,!0):void Af.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(zf),Object.freeze(Af),Rb.prototype.distance=function(a,b,c,d){return this.x*zf.distance(a,b,c,d)+this.y*Af.distance(a,b,c,d)},Rb.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)},Rb.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},Rb.prototype.touch=function(a){a.xTouched=!0,a.yTouched=!0},Tb.prototype.nextTouched=function(a){for(var b=this.nextPointOnContour;!a.touched(b)&&b!==this;)b=b.nextPointOnContour;return b},Tb.prototype.prevTouched=function(a){for(var b=this.prevPointOnContour;!a.touched(b)&&b!==this;)b=b.prevPointOnContour;return b};var Bf=Object.freeze(new Tb(0,0)),Cf={cvCutIn:17/16,deltaBase:9,deltaShift:.125,loop:1,minDis:1,autoFlip:!0};Kb.prototype.exec=function(b,c){if("number"!=typeof c)throw new Error("Point size is not a number!");if(!(this._errorState>2)){var d=this.font,e=this._prepState;if(!e||e.ppem!==c){var f=this._fpgmState;if(!f){Ub.prototype=Cf,f=this._fpgmState=new Ub("fpgm",d.tables.fpgm),f.funcs=[],f.font=d,a.DEBUG&&(console.log("---EXEC FPGM---"),f.step=-1);try{vf(f)}catch(a){return console.log("Hinting error in FPGM:"+a),void(this._errorState=3)}}Ub.prototype=f,e=this._prepState=new Ub("prep",d.tables.prep),e.ppem=c;var g=d.tables.cvt;if(g)for(var h=e.cvt=new Array(g.length),i=c/d.unitsPerEm,j=0;j1))try{return wf(b,e)}catch(a){return this._errorState<1&&(console.log("Hinting error:"+a),console.log("Note: further hinting errors are silenced")),void(this._errorState=1)}}},wf=function(b,c){var d,e,f,g=c.ppem/c.font.unitsPerEm,h=g,i=b.components;if(Ub.prototype=c,i){var j=c.font;e=[],d=[];for(var k=0;k0,"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.")},Od.prototype.toTables=function(){return tf.fontToTable(this)},Od.prototype.toBuffer=function(){return console.warn("Font.toBuffer is deprecated. Use Font.toArrayBuffer instead."),this.toArrayBuffer()},Od.prototype.toArrayBuffer=function(){for(var a=this.toTables(),b=a.encode(),c=new ArrayBuffer(b.length),d=new Uint8Array(c),e=0;e1)for(var c=1;c-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(-1===w.indexOf(b))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");var b="response"in f?f.response:f.responseText;c(new q(b,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)},{}],12:[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":14,"./color/p5.Color":15,"./color/setting":16,"./core/2d_primitives":17,"./core/attributes":18,"./core/constants":20,"./core/core":21,"./core/curves":22,"./core/environment":23,"./core/init.js":25,"./core/p5.Element":26,"./core/p5.Graphics":27,"./core/p5.Renderer2D":29,"./core/rendering":30,"./core/structure":32,"./core/transform":33,"./core/vertex":34,"./data/p5.TypedDict":35,"./events/acceleration":36,"./events/keyboard":37,"./events/mouse":38,"./events/touch":39,"./image/image":41,"./image/loading_displaying":42,"./image/p5.Image":43,"./image/pixels":44,"./io/files":45,"./io/p5.Table":46,"./io/p5.TableRow":47,"./io/p5.XML":48,"./math/calculation":49,"./math/math":50,"./math/noise":51,"./math/p5.Vector":52,"./math/random":54,"./math/trigonometry":55,"./typography/attributes":56,"./typography/loading_displaying":57,"./typography/p5.Font":58,"./utilities/array_functions":59,"./utilities/conversion":60,"./utilities/string_functions":61,"./utilities/time_date":62,"./webgl/camera":63,"./webgl/interaction":64,"./webgl/light":65,"./webgl/loading":66,"./webgl/material":67,"./webgl/p5.Geometry":68,"./webgl/p5.Matrix":69,"./webgl/p5.RendererGL":72,"./webgl/p5.RendererGL.Immediate":70,"./webgl/p5.RendererGL.Retained":71,"./webgl/p5.Shader":73,"./webgl/primitives":75}],13:[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":21}],14:[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(){if(d._validateParameters("color",arguments),arguments[0]instanceof d.Color)return arguments[0];var a=arguments[0]instanceof Array?arguments[0]:arguments;return new d.Color(this,a)},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._colorMode,m=this._colorMaxes;if(l===e.RGB)j=a.levels.map(function(a){return a/255}),k=b.levels.map(function(a){return a/255});else if(l===e.HSB)a._getBrightness(),b._getBrightness(),j=a.hsba,k=b.hsba;else{if(l!==e.HSL)throw new Error(l+"cannot be used for interpolation.");a._getLightness(),b._getLightness(),j=a.hsla,k=b.hsla}return c=Math.max(Math.min(c,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":20,"../core/core":21,"../core/error_helpers":24,"./p5.Color":15}],15:[function(a,b,c){"use strict";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(a,b,c,h){var i=arguments.length,j=this.mode,k=this.maxes,m=[];if(i>=3)return m[0]=a/k[j][0],m[1]=b/k[j][1],m[2]=c/k[j][2],m[3]="number"==typeof h?h/k[j][3]:1,m=m.map(function(a){return Math.max(Math.min(a,1),0)}),j===e.HSL?f._hslaToRGBA(m):j===e.HSB?f._hsbaToRGBA(m):m;if(1===i&&"string"==typeof a){var n=a.trim().toLowerCase();if(g[n])return d.Color._parseInputs.call(this,g[n]);if(l.HEX3.test(n))return m=l.HEX3.exec(n).slice(1).map(function(a){return parseInt(a+a,16)/255}),m[3]=1,m;if(l.HEX6.test(n))return m=l.HEX6.exec(n).slice(1).map(function(a){return parseInt(a,16)/255}),m[3]=1,m;if(l.HEX4.test(n))return m=l.HEX4.exec(n).slice(1).map(function(a){return parseInt(a+a,16)/255});if(l.HEX8.test(n))return m=l.HEX8.exec(n).slice(1).map(function(a){return parseInt(a,16)/255});if(l.RGB.test(n))return m=l.RGB.exec(n).slice(1).map(function(a){return a/255}),m[3]=1,m;if(l.RGB_PERCENT.test(n))return m=l.RGB_PERCENT.exec(n).slice(1).map(function(a){return parseFloat(a)/100}),m[3]=1,m;if(l.RGBA.test(n))return m=l.RGBA.exec(n).slice(1).map(function(a,b){return 3===b?parseFloat(a):a/255});if(l.RGBA_PERCENT.test(n))return m=l.RGBA_PERCENT.exec(n).slice(1).map(function(a,b){return 3===b?parseFloat(a):parseFloat(a)/100});if(l.HSL.test(n)?(m=l.HSL.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),m[3]=1):l.HSLA.test(n)&&(m=l.HSLA.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),m=m.map(function(a){return Math.max(Math.min(a,1),0)}),m.length)return f._hslaToRGBA(m);if(l.HSB.test(n)?(m=l.HSB.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),m[3]=1):l.HSBA.test(n)&&(m=l.HSBA.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),m=m.map(function(a){return Math.max(Math.min(a,1),0)}),m.length)return f._hsbaToRGBA(m);m=[1,1,1,1]}else{if(1!==i&&2!==i||"number"!=typeof a)throw new Error(arguments+"is not a valid color representation.");m[0]=a/k[j][2],m[1]=a/k[j][2],m[2]=a/k[j][2],m[3]="number"==typeof b?b/k[j][3]:1,m=m.map(function(a){return Math.max(Math.min(a,1),0)})}return m},b.exports=d.Color},{"../core/constants":20,"../core/core":21,"./color_conversion":13}],16:[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(a,b,c,f,g){if(d._validateParameters("colorMode",arguments),a===e.RGB||a===e.HSB||a===e.HSL){this._colorMode=a;var h=this._colorMaxes[a];2===arguments.length?(h[0]=b,h[1]=b,h[2]=b,h[3]=b):4===arguments.length?(h[0]=b,h[1]=c,h[2]=f):5===arguments.length&&(h[0]=b,h[1]=c,h[2]=f,h[3]=g)}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._setProperty("_doFill",!1),this},d.prototype.noStroke=function(){return 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":20,"../core/core":21,"./p5.Color":15}],17:[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){if(d._validateParameters("arc",arguments),!this._renderer._doStroke&&!this._renderer._doFill)return this;for(this._angleMode===e.DEGREES&&(g=this.radians(g),h=this.radians(h));g<0;)g+=e.TWO_PI;for(;h<0;)h+=e.TWO_PI;return g%=e.TWO_PI,h%=e.TWO_PI,h===g&&(h+=e.TWO_PI),g=g<=e.HALF_PI?Math.atan(c/f*Math.tan(g)):g>e.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(a,b,c,e,g,h){if(d._validateParameters("ellipse",arguments),c<0&&(c=Math.abs(c)),void 0===e?e=c:e<0&&(e=Math.abs(e)),this._renderer._doStroke||this._renderer._doFill){var i=f.modeAdjust(a,b,c,e,this._renderer._ellipseMode);this._renderer.ellipse([i.x,i.y,i.w,i.h,g,h])}return this},d.prototype.line=function(){return d._validateParameters("line",arguments),this._renderer._doStroke&&this._renderer.line.apply(this._renderer,arguments),this},d.prototype.point=function(){return d._validateParameters("point",arguments),this._renderer._doStroke&&this._renderer.point.apply(this._renderer,arguments),this},d.prototype.quad=function(){return d._validateParameters("quad",arguments),(this._renderer._doStroke||this._renderer._doFill)&&this._renderer.quad.apply(this._renderer,arguments),this},d.prototype.rect=function(a,b,c,e,g,h){if(d._validateParameters("rect",arguments),this._renderer._doStroke||this._renderer._doFill){var i=f.modeAdjust(a,b,c,e,this._renderer._rectMode);this._renderer.rect([i.x,i.y,i.w,i.h,g,h])}return this},d.prototype.triangle=function(){return d._validateParameters("triangle",arguments),(this._renderer._doStroke||this._renderer._doFill)&&this._renderer.triangle(arguments),this},b.exports=d},{"./canvas":19,"./constants":20,"./core":21,"./error_helpers":24}],18:[function(a,b,c){"use strict";var d=a("./core"),e=a("./constants");d.prototype.ellipseMode=function(a){return d._validateParameters("ellipseMode",arguments),a!==e.CORNER&&a!==e.CORNERS&&a!==e.RADIUS&&a!==e.CENTER||(this._renderer._ellipseMode=a),this},d.prototype.noSmooth=function(){return this._renderer.noSmooth(),this},d.prototype.rectMode=function(a){return d._validateParameters("rectMode",arguments),a!==e.CORNER&&a!==e.CORNERS&&a!==e.RADIUS&&a!==e.CENTER||(this._renderer._rectMode=a),this},d.prototype.smooth=function(){return this._renderer.smooth(),this},d.prototype.strokeCap=function(a){return d._validateParameters("strokeCap",arguments),a!==e.ROUND&&a!==e.SQUARE&&a!==e.PROJECT||this._renderer.strokeCap(a),this},d.prototype.strokeJoin=function(a){return d._validateParameters("strokeJoin",arguments),a!==e.ROUND&&a!==e.BEVEL&&a!==e.MITER||this._renderer.strokeJoin(a),this},d.prototype.strokeWeight=function(a){return d._validateParameters("strokeWeight",arguments),this._renderer.strokeWeight(a),this},b.exports=d},{"./constants":20,"./core":21}],19:[function(a,b,c){"use strict";var d=a("./constants");b.exports={modeAdjust:function(a,b,c,e,f){return f===d.CORNER?{x:a,y:b,w:c,h:e}:f===d.CORNERS?{x:a,y:b,w:c-a,h:e-b}:f===d.RADIUS?{x:a-c,y:b-e,w:2*c,h:2*e}:f===d.CENTER?{x:a-.5*c,y:b-.5*e,w:c,h:e}:void 0},arcModeAdjust:function(a,b,c,e,f){return f===d.CORNER?{x:a+.5*c,y:b+.5*e,w:c,h:e}:f===d.CORNERS?{x:a,y:b,w:c+a,h:e+b}:f===d.RADIUS?{x:a,y:b,w:2*c,h:2*e}:f===d.CENTER?{x:a,y:b,w:c,h:e}:void 0}}},{"./constants":20}],20:[function(a,b,c){"use strict";var d=Math.PI;b.exports={P2D:"p2d",WEBGL:"webgl",ARROW:"default",CROSS:"crosshair",HAND:"pointer",MOVE:"move",TEXT:"text",WAIT:"wait",HALF_PI:d/2,PI:d,QUARTER_PI:d/4,TAU:2*d,TWO_PI:2*d,DEGREES:"degrees",RADIANS:"radians",DEG_TO_RAD:d/180,RAD_TO_DEG:180/d,CORNER:"corner",CORNERS:"corners",RADIUS:"radius",RIGHT:"right",LEFT:"left",CENTER:"center",TOP:"top",BOTTOM:"bottom",BASELINE:"alphabetic",POINTS:0,LINES:1,LINE_STRIP:3,LINE_LOOP:2,TRIANGLES:4,TRIANGLE_FAN:6,TRIANGLE_STRIP:5,QUADS:"quads",QUAD_STRIP:"quad_strip",CLOSE:"close",OPEN:"open",CHORD:"chord",PIE:"pie",PROJECT:"square",SQUARE:"butt",ROUND:"round",BEVEL:"bevel",MITER:"miter",RGB:"rgb",HSB:"hsb",HSL:"hsl",AUTO:"auto",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,BLEND:"source-over",ADD:"lighter",DARKEST:"darken",LIGHTEST:"lighten",DIFFERENCE:"difference",EXCLUSION:"exclusion",MULTIPLY:"multiply",SCREEN:"screen",REPLACE:"copy",OVERLAY:"overlay",HARD_LIGHT:"hard-light",SOFT_LIGHT:"soft-light",DODGE:"color-dodge",BURN:"color-burn",THRESHOLD:"threshold",GRAY:"gray",OPAQUE:"opaque",INVERT:"invert",POSTERIZE:"posterize",DILATE:"dilate",ERODE:"erode",BLUR:"blur",NORMAL:"normal",ITALIC:"italic",BOLD:"bold",_DEFAULT_TEXT_FILL:"#000000",_DEFAULT_LEADMULT:1.25,_CTX_MIDDLE:"middle",LINEAR:"linear",QUADRATIC:"quadratic",BEZIER:"bezier",CURVE:"curve",STROKE:"stroke",FILL:"fill",TEXTURE:"texture",IMMEDIATE:"immediate",LANDSCAPE:"landscape",PORTRAIT:"portrait",_DEFAULT_STROKE:"#000000",_DEFAULT_FILL:"#FFFFFF"}},{}],21:[function(a,b,c){"use strict";a("./shim");var d=a("./constants"),e=function(a,b,c){"boolean"==typeof b&&void 0===c&&(c=b,b=void 0),this._setupDone=!1,this._pixelDensity=Math.ceil(window.devicePixelRatio)||1,this._userNode=b,this._curElement=null,this._elements=[],this._requestAnimId=0,this._preloadCount=0,this._isGlobal=!1,this._loop=!0,this._initializeInstanceVariables(),this._defaultCanvasSize={width:100,height:100},this._events={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",this._registeredMethods={};for(var d=Object.getOwnPropertyNames(e.prototype._registeredMethods),f=0;f=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 h._validateParameters("frameRate",arguments),"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(h._validateParameters("fullscreen",arguments),void 0===a)return document.fullscreenElement||document.webkitFullscreenElement||document.mozFullScreenElement||document.msFullscreenElement;a?f(document.documentElement):g()},h.prototype.pixelDensity=function(a){if(h._validateParameters("pixelDensity",arguments),"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":20,"./core":21}],24:[function(a,b,c){"use strict";var d=a("./core");a("./constants");d._validateParameters=d._friendlyFileLoadError=function(){};var e=null,f="https://github.com/processing/p5.js/wiki/Frequently-Asked-Questions#why-cant-i-assign-variables-using-p5-functions-and-variables-before-setup",g=function(){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}})};e=[].concat(c(d.prototype),c(a("./constants"))),e.sort(function(a,b){return b.name.length-a.name.length})},h=function(a,b){b||(b=console.log.bind(console)),e||g(),e.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: "+f),!0})};d.prototype._helpForMisusedAtTopLevelCode=h,"complete"!==document.readyState&&(window.addEventListener("error",h,!1),window.addEventListener("load",function(){window.removeEventListener("error",h,!1)})),b.exports=d},{"../../docs/reference/data.json":void 0,"./constants":20,"./core":21}],25:[function(a,b,c){"use strict";var d=a("../core/core"),e=function(){window.PHANTOMJS||window.mocha||(window.setup&&"function"==typeof window.setup||window.draw&&"function"==typeof window.draw)&&!d.instance&&new d};"complete"===document.readyState?e():window.addEventListener("load",e,!1)},{"../core/core":21}],26:[function(a,b,c){"use strict";function d(a,b,c){return!1===b?f(a,c):e(a,b,c),this}function e(a,b,c){c._events[a]&&f(a,c);var d=b.bind(c);c.elt.addEventListener(a,d,!1),c._events[a]=d}function f(a,b){var c=b._events[a];b.elt.removeEventListener(a,c,!1),b._events[a]=null}var g=a("./core");g.Element=function(a,b){this.elt=a,this._pInst=b,this._events={},this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this.name="p5.Element"},g.Element.prototype.parent=function(a){return void 0===a?this.elt.parentNode:("string"==typeof a?("#"===a[0]&&(a=a.substring(1)),a=document.getElementById(a)):a instanceof g.Element&&(a=a.elt),a.appendChild(this.elt),this)},g.Element.prototype.id=function(a){return void 0===a?this.elt.id:(this.elt.id=a,this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this)},g.Element.prototype.class=function(a){return void 0===a?this.elt.className:(this.elt.className=a,this)},g.Element.prototype.mousePressed=function(a){return d("mousedown",a,this),d("touchstart",a,this),this},g.Element.prototype.doubleClicked=function(a){return d("dblclick",a,this),this},g.Element.prototype.mouseWheel=function(a){return d("wheel",a,this),this},g.Element.prototype.mouseReleased=function(a){return d("mouseup",a,this),d("touchend",a,this),this},g.Element.prototype.mouseClicked=function(a){return d("click",a,this),this},g.Element.prototype.mouseMoved=function(a){return d("mousemove",a,this),d("touchmove",a,this),this},g.Element.prototype.mouseOver=function(a){return d("mouseover",a,this),this},g.Element.prototype.changed=function(a){return d("change",a,this),this},g.Element.prototype.input=function(a){return d("input",a,this),this},g.Element.prototype.mouseOut=function(a){return d("mouseout",a,this),this},g.Element.prototype.touchStarted=function(a){return d("touchstart",a,this),d("mousedown",a,this),this},g.Element.prototype.touchMoved=function(a){return d("touchmove",a,this),d("mousemove",a,this),this},g.Element.prototype.touchEnded=function(a){return d("touchend",a,this),d("mouseup",a,this),this},g.Element.prototype.dragOver=function(a){return d("dragover",a,this),this},g.Element.prototype.dragLeave=function(a){return d("dragleave",a,this),this},g.Element.prototype.drop=function(a,b){function c(b){var c=new g.File(b);return function(b){c.data=b.target.result,a(c)}}return window.File&&window.FileReader&&window.FileList&&window.Blob?(e("dragover",function(a){a.stopPropagation(),a.preventDefault()},this),e("dragleave",function(a){a.stopPropagation(),a.preventDefault()},this),void 0!==b&&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":21}],27:[function(a,b,c){"use strict";var d=a("./core"),e=a("./constants");d.Graphics=function(a,b,c,f){var g=c||e.P2D;this.canvas=document.createElement("canvas"),(f._userNode||document.body).appendChild(this.canvas),d.Element.call(this,this.canvas,f,!1);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 d.prototype._initializeInstanceVariables.apply(this),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),f._elements.push(this),this._renderer.resize(a,b),this._renderer._applyDefaults(),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":20,"./core":21}],28:[function(a,b,c){"use strict";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},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"number"==typeof a?(this._setProperty("_textLeading",a),this):this._textLeading},e.Renderer.prototype.textSize=function(a){return"number"==typeof a?(this._setProperty("_textSize",a),this._setProperty("_textLeading",a*f._DEFAULT_LEADMULT),this._applyTextProperties()):this._textSize},e.Renderer.prototype.textStyle=function(a){return a?(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":20,"./core":21}],29:[function(a,b,c){"use strict";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._pInst,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._pInst,arguments);this._setFill(a.toString())},d.Renderer2D.prototype.stroke=function(){var a=this._pInst.color.apply(this._pInst,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(void 0!==a)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":40,"./canvas":19,"./constants":20,"./core":21,"./p5.Renderer":28}],30:[function(a,b,c){"use strict";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){d._validateParameters("createCanvas",arguments);var g,h=c||e.P2D;if(h===e.WEBGL){if(g=document.getElementById(f)){g.parentNode.removeChild(g);var i=this._renderer;this._elements=this._elements.filter(function(a){return a!==i})}g=document.createElement("canvas"),g.id=f}else if(this._defaultGraphicsCreated)g=this.canvas;else{g=document.createElement("canvas");for(var j=0;document.getElementById("defaultCanvas"+j);)j++;f="defaultCanvas"+j,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(d._validateParameters("resizeCanvas",arguments),this._renderer){var e={};for(var f in this.drawingContext){var g=this.drawingContext[f];"object"!=typeof g&&"function"!=typeof g&&(e[f]=g)}this._renderer.resize(a,b);for(var h in e)try{this.drawingContext[h]=e[h]}catch(a){}c||this.redraw()}},d.prototype.noCanvas=function(){this.canvas&&this.canvas.parentNode.removeChild(this.canvas)},d.prototype.createGraphics=function(a,b,c){return d._validateParameters("createGraphics",arguments),new d.Graphics(a,b,c,this)},d.prototype.blendMode=function(a){if(d._validateParameters("blendMode",arguments),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":72,"./constants":20,"./core":21,"./p5.Graphics":27,"./p5.Renderer2D":29}],31:[function(a,b,c){"use strict";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(){"undefined"==typeof Uint8ClampedArray||Uint8ClampedArray.prototype.slice||Object.defineProperty(Uint8ClampedArray.prototype,"slice",{value:Array.prototype.slice,writable:!0,configurable:!0,enumerable:!1})}()},{}],32:[function(a,b,c){"use strict";function d(a,b){for(var c=1;c0))throw"vertex() must be used once before calling quadraticVertex()";k=!0;for(var j=[],m=0;mn||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":21}],37:[function(a,b,c){"use strict";function d(){for(var a in f)if(f.hasOwnProperty(a)&&!0===f[a])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){!1===c(a)&&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){!1===b(a)&&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){!1===b(a)&&a.preventDefault()}}},e.prototype._onblur=function(a){f={}},e.prototype.keyIsDown=function(a){return e._validateParameters("keyIsDown",arguments),f[a]},b.exports=e},{"../core/core":21}],38:[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?!1===b.mouseDragged(a)&&a.preventDefault():"function"==typeof b.touchMoved&&!1===b.touchMoved(a)&&a.preventDefault():"function"==typeof b.mouseMoved&&!1===b.mouseMoved(a)&&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?!1===b.mousePressed(a)&&a.preventDefault():"function"==typeof b.touchStarted&&!1===b.touchStarted(a)&&a.preventDefault()},e.prototype._onmouseup=function(a){var b=this._isGlobal?window:this;this._setProperty("mouseIsPressed",!1),"function"==typeof b.mouseReleased?!1===b.mouseReleased(a)&&a.preventDefault():"function"==typeof b.touchEnded&&!1===b.touchEnded(a)&&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){!1===b.mouseClicked(a)&&a.preventDefault()}},e.prototype._ondblclick=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.doubleClicked){!1===b.doubleClicked(a)&&a.preventDefault()}},e.prototype._onwheel=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.mouseWheel){a.delta=a.deltaY;!1===b.mouseWheel(a)&&a.preventDefault()}},b.exports=e},{"../core/constants":20,"../core/core":21}],39:[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[(-16777216&H)>>>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(){var a,b,c,e,f,g,h,i,j;if(9===arguments.length)a=arguments[0],b=arguments[1],c=arguments[2],e=arguments[3],f=arguments[4],g=arguments[5],h=arguments[6],i=arguments[7],j=arguments[8];else{if(8!==arguments.length)throw new Error("Signature not supported");a=this,b=arguments[0],c=arguments[1],e=arguments[2],f=arguments[3],g=arguments[4],h=arguments[5],i=arguments[6],j=arguments[7]}d.Renderer2D._copyHelper(this,a,b,c,e,f,g,h,i,j)},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){d.prototype.saveCanvas(this.canvas,a,b)},b.exports=d.Image},{"../core/core":21,"./filters":40}],44:[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._validateParameters("copy",arguments),d.Renderer2D.prototype.copy.apply(this._renderer,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":15,"../core/core":21,"./filters":40}],45:[function(a,b,c){"use strict";function d(a,b){var c={};if(void 0===(b=b||[]))for(var d=0;d/g,">").replace(/"/g,""").replace(/'/g,"'")}function f(a,b){b&&!0!==b&&"true"!==b||(b=""),a||(a="untitled");var c="";return a&&a.indexOf(".")>-1&&(c=a.split(".").pop()),b&&c!==b&&(c=b,a=a+"."+c),[a,c]}function g(a){document.body.removeChild(a.target)}var h=a("../core/core");a("whatwg-fetch"),a("es6-promise").polyfill();var i=a("fetch-jsonp");a("../core/error_helpers"),h.prototype.loadJSON=function(){for(var a,b,c,d=arguments[0],e={},f="json",g=1;g0&&"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=-1!==c.url.indexOf("json")?"json":-1!==c.url.indexOf("xml")?"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});h.prototype.downloadFile(e,b,c)},h.prototype.downloadFile=function(b,c,d){var e=f(c,d),i=e[0];if(b instanceof Blob){return void a("file-saver").saveAs(b,i)}var j=document.createElement("a");if(j.href=b,j.download=i,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 --\x3e Save As.\n",k+='2. Choose "Page Source" as the Format.\n',k+='3. Name it with this extension: ."'+e[1]+'"',alert(k)}j.click()},h.prototype._checkFileExtension=f,h.prototype._isSafari=function(){return Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor")>0},b.exports=h},{"../core/core":21,"../core/error_helpers":24,"es6-promise":4,"fetch-jsonp":5,"file-saver":6,"whatwg-fetch":11}],46:[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)).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,b){return this.p5&&this.p5._angleMode===f.DEGREES&&(a=e.degreesToRadians(a)),void 0===b&&(b=1),this.p5?new d.Vector(this.p5,[b*Math.cos(a),b*Math.sin(a),0]):new d.Vector(b*Math.cos(a),b*Math.sin(a),0)},d.Vector.fromAngles=function(a,b,c){this.p5&&this.p5._angleMode===f.DEGREES&&(a=e.degreesToRadians(a),b=e.degreesToRadians(b)),void 0===c&&(c=1);var g=Math.cos(b),h=Math.sin(b),i=Math.cos(a),j=Math.sin(a);return this.p5?new new d.Vector(this.p5,c*j*h,-c*i,c*j*g):new d.Vector(c*j*h,-c*i,c*j*g)},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()*f.TWO_PI,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()*f.TWO_PI,b=2*Math.random()-1);var c=Math.sqrt(1-b*b),e=c*Math.cos(a),g=c*Math.sin(a);return this.p5?new d.Vector(this.p5,[e,g,b]):new d.Vector(e,g,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":20,"../core/core":21,"./polargeometry":53}],53:[function(a,b,c){"use strict";b.exports={degreesToRadians:function(a){return 2*Math.PI*a/360},radiansToDegrees:function(a){return 360*a/(2*Math.PI)}}},{}],54:[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":21}],55:[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":20,"../core/core":21,"./polargeometry":53}],56:[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":21}],57:[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":20,"../core/core":21,"../core/error_helpers":24,"opentype.js":9}],58:[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 f=a[b];f.length;)h[b]="A",e&&(i[b]="A"),a.splice(b++,0,["C"].concat(f.splice(0,6)));a.splice(b,1),c=Math.max(d.length,e&&e.length||0)}},l=function(a,b,f,g,h){a&&b&&"M"===a[h][0]&&"M"!==b[h][0]&&(b.splice(h,0,["M",g.x,g.y]),f.bx=0,f.by=0,f.x=a[h][1],f.y=a[h][2],c=Math.max(d.length,e&&e.length||0))},m="",n="";c=Math.max(d.length,e&&e.length||0);for(var p=0;p1&&(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+=(j=0;--b){var c=arguments[b];a+=c===Object(c)?JSON.stringify(c):c}return a}var y=a("../core/core"),z=a("../core/constants");y.Font=function(a){this.parent=a,this.cache={},this.font=void 0,this.name="p5.Font"},y.Font.prototype.list=function(){throw"not yet implemented"},y.Font.prototype.textBounds=function(a,b,c,d,e){b=void 0!==b?b:0,c=void 0!==c?c:0,d=d||this.parent._renderer._textSize;var f=e&&e.renderer&&e.renderer._pInst||this.parent,g=f._renderer.drawingContext,h=g.textAlign||z.LEFT,i=g.textBaseline||z.BASELINE,j=x("textBounds",a,b,c,d,h,i),k=this.cache[j];if(!k){var l,m,n,o,p,q=[],r=[],s=this._scale(d);this.font.forEachGlyph(a,b,c,d,e,function(a,b,c,d){var e=a.getMetrics();q.push(b+e.xMin*s),q.push(b+e.xMax*s),r.push(c+-e.yMin*s),r.push(c+-e.yMax*s)}),l=Math.min.apply(null,q),m=Math.min.apply(null,r),n=Math.max.apply(null,q),o=Math.max.apply(null,r),k={x:l,y:m,h:o-m,w:n-l,advance:l-b},p=this._handleAlignment(f,g,a,k.x,k.y,k.w+k.advance),k.x=p.x,k.y=p.y,this.cache[x("textBounds",a,b,c,d,h,i)]=k}return k},y.Font.prototype.textToPoints=function(a,b,c,e,g){function h(b){return k[b].name&&"space"===k[b].name||a.length===k.length&&" "===a[b]||k[b].index&&3===k[b].index}var i=0,j=[],k=this._getGlyphs(a);e=e||this.parent._renderer._textSize;for(var l=0;l2?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":21}],60:[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":21}],61:[function(a,b,c){"use strict";function d(a,b,c){var d=a<0,e=d?a.toString().substring(1):a.toString(),f=e.indexOf("."),g=-1!==f?e.substring(0,f):e,h=-1!==f?e.substring(f+1):"",i=d?"-":"";if(void 0!==c){var j="";(-1!==f||c-h.length>0)&&(j="."),h.length>c&&(h=h.substring(0,c));for(var k=0;kd.length){d+=-1===c?".":"";for(var f=b-d.length+1,g=0;g0?"+"+a.toString():a.toString()}function g(a){return parseFloat(a)>0?" "+a.toString():a.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(a,b,c){return h._validateParameters("nf",arguments),a instanceof Array?a.map(function(a){return d(a,b,c)}):"[object Arguments]"===Object.prototype.toString.call(a)?3===a.length?this.nf(a[0],a[1],a[2]):2===a.length?this.nf(a[0],a[1]):this.nf(a[0]):d(a,b,c)},h.prototype.nfc=function(a,b){return h._validateParameters("nfc",arguments),a instanceof Array?a.map(function(a){return e(a,b)}):e(a,b)},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(a,b){h._validateParameters("splitTokens",arguments);var c;if(void 0!==b){var d=b,e=/\]/g.exec(d),f=/\[/g.exec(d);f&&e?(d=d.slice(0,e.index)+d.slice(e.index+1),f=/\[/g.exec(d),d=d.slice(0,f.index)+d.slice(f.index+1),c=new RegExp("[\\["+d+"\\]]","g")):e?(d=d.slice(0,e.index)+d.slice(e.index+1),c=new RegExp("["+d+"\\]]","g")):f?(d=d.slice(0,f.index)+d.slice(f.index+1),c=new RegExp("["+d+"\\[]","g")):c=new RegExp("["+d+"]","g")}else c=/\s/g;return a.split(c).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":21,"../core/error_helpers":24}],62:[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":21}],63:[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(a,b,c,d,e,f,g,h,i){void 0===a&&(a=this.defaultCameraX,b=this.defaultCameraY,c=this.defaultCameraZ,d=a,e=b,f=0,g=0,h=1,i=0),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(a,b,c,e){void 0===a&&(a=this.defaultCameraFOV),void 0===b&&(b=this.defaultCameraAspect),void 0===c&&(c=this.defaultCameraNear),void 0===e&&(e=this.defaultCameraFar),this.cameraFOV=a,this.cameraAspect=b,this.cameraNear=c,this.cameraFar=e,this.uPMatrix=d.Matrix.identity(this.pInst);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(){return this._renderer.ortho.apply(this._renderer,arguments),this},d.RendererGL.prototype.ortho=function(a,b,c,e,f,g){void 0===a&&(a=-this.width/2),void 0===b&&(b=+this.width/2),void 0===c&&(c=-this.height/2),void 0===e&&(e=+this.height/2),void 0===f&&(f=0),void 0===g&&(g=Math.max(this.width,this.height)),this.uPMatrix=d.Matrix.identity(this._pInst);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.uPMatrix=d.Matrix.identity(),this.uPMatrix.set(k,0,0,0,0,-l,0,0,0,0,m,0,n,o,p,1),this._curCamera="custom"},b.exports=d},{"../core/core":21}],64:[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":21}],65:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.ambientLight=function(a,b,c,d){var e=this.color.apply(this,arguments),f=this._renderer._useLightShader();return f.setUniform("uUseLighting",!0),f.setUniform("uMaterialColor",this._renderer.curFillColor),this._renderer.ambientLightColors.push(e._array[0],e._array[1],e._array[2]),f.setUniform("uAmbientColor",this._renderer.ambientLightColors),f.setUniform("uAmbientLightCount",this._renderer.ambientLightColors.length/3),this},d.prototype.directionalLight=function(a,b,c,d,e,f){var g,h,i,j=this._renderer._useLightShader(),k=this.color.apply(this,[a,b,c]),l=arguments[arguments.length-1];"number"==typeof l?(g=arguments[arguments.length-3],h=arguments[arguments.length-2],i=arguments[arguments.length-1]):(g=l.x,h=l.y,i=l.z),j.setUniform("uUseLighting",!0),j.setUniform("uMaterialColor",this._renderer.curFillColor);var m=Math.sqrt(g*g+h*h+i*i);return this._renderer.directionalLightDirections.push(g/m,h/m,i/m),j.setUniform("uLightingDirection",this._renderer.directionalLightDirections),this._renderer.directionalLightColors.push(k._array[0],k._array[1],k._array[2]),j.setUniform("uDirectionalColor",this._renderer.directionalLightColors),j.setUniform("uDirectionalLightCount",this._renderer.directionalLightColors.length/3),this},d.prototype.pointLight=function(a,b,c,d,e,f){var g,h,i,j=this._renderer._pInst.color.apply(this,[a,b,c]),k=arguments[arguments.length-1];"number"==typeof k?(g=arguments[arguments.length-3],h=arguments[arguments.length-2],i=arguments[arguments.length-1]):(g=k.x,h=k.y,i=k.z);var l=this._renderer._useLightShader();return l.setUniform("uUseLighting",!0),l.setUniform("uMaterialColor",this._renderer.curFillColor),this._renderer.pointLightPositions.push(g,h,i),l.setUniform("uPointLightLocation",this._renderer.pointLightPositions),this._renderer.pointLightColors.push(j._array[0],j._array[1],j._array[2]),l.setUniform("uPointLightColor",this._renderer.pointLightColors),l.setUniform("uPointLightCount",this._renderer.pointLightColors.length/3),this},b.exports=d},{"../core/core":21}],66:[function(a,b,c){"use strict";function d(a,b){for(var c={v:[],vt:[],vn:[]},d={},f=0;f0)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":21,"./p5.Geometry":68}],67:[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.createShader=function(a,b){return new d.Shader(this._renderer,a,b)},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.curFillColor=[1,1,1,1],this.noStroke(),this},d.prototype.texture=function(a){this._renderer.GL.depthMask(!0),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=e.TEXTURE;var b=this._renderer._useLightShader();return b.setUniform("uSpecular",!1),b.setUniform("isTexture",!0),b.setUniform("uSampler",a),this.noStroke(),this},d.prototype.ambientMaterial=function(a,b,c,e){var f=d.prototype.color.apply(this,arguments);this._renderer.curFillColor=f._array;var g=this._renderer._useLightShader();return g.setUniform("uMaterialColor",this._renderer.curFillColor),g.setUniform("uSpecular",!1),g.setUniform("isTexture",!1),this},d.prototype.specularMaterial=function(a,b,c,e){var f=d.prototype.color.apply(this,arguments);this._renderer.curFillColor=f._array;var g=this._renderer._useLightShader();return g.setUniform("uMaterialColor",this._renderer.curFillColor),g.setUniform("uSpecular",!0),g.setUniform("isTexture",!1),this},d.RendererGL.prototype._applyColorBlend=function(a){var b=this.GL;return a[a.length-1]<1?(b.depthMask(!1),b.enable(b.BLEND),b.blendEquation(b.FUNC_ADD),b.blendFunc(b.SRC_ALPHA,b.ONE_MINUS_SRC_ALPHA)):(b.depthMask(!0),b.disable(b.BLEND)),a},b.exports=d},{"../core/constants":20,"../core/core":21,"./p5.Texture":74}],68:[function(a,b,c){"use strict";var d=a("../core/core");d.Geometry=function(a,b,c){return this.vertices=[],this.lineVertices=[],this.lineNormals=[],this.vertexNormals=[],this.faces=[],this.uvs=[],this.edges=[],this.detailX=void 0!==a?a:1,this.detailY=void 0!==b?b:1,c instanceof Function&&c.call(this),this.name="p5.Geometry",this},d.Geometry.prototype.computeFaces=function(){for(var a,b,c,d,e=this.detailX+1,f=0;fthis.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--}this.gHash[a]={}},d.RendererGL.prototype._freeBuffers=function(a){var b=this.gHash[a];if(b){delete this.gHash[a],e--;var c=this.GL;b.vertexBuffer&&c.deleteBuffer(b.vertexBuffer),b.normalBuffer&&c.deleteBuffer(b.normalBuffer),b.lineNormalBuffer&&c.deleteBuffer(b.lineNormalBuffer),b.uvBuffer&&c.deleteBuffer(b.uvBuffer),b.indexBuffer&&c.deleteBuffer(b.indexBuffer), +b.lineVertexBuffer&&c.deleteBuffer(b.lineVertexBuffer)}},d.RendererGL.prototype.createBuffers=function(a,b){var c=this.GL;this._setDefaultCamera(),this._initBufferDefaults(a);var d=this.gHash[a];d.numberOfItems=3*b.faces.length,d.lineVertexCount=b.lineVertices.length,this._useColorShader(),this.curStrokeShader.attributes.aPosition&&(d.lineVertexBuffer=c.createBuffer(),this._bindBuffer(d.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.curStrokeShader.attributes.aDirection&&(d.lineNormalBuffer=c.createBuffer(),this._bindBuffer(d.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.curFillShader.attributes.aPosition&&(d.vertexBuffer=c.createBuffer(),this._bindBuffer(d.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)),d.indexBuffer=c.createBuffer(),this._bindBuffer(d.indexBuffer,c.ELEMENT_ARRAY_BUFFER,this._flatten(b.faces),Uint16Array,c.STATIC_DRAW),this.curFillShader.attributes.aNormal&&(d.normalBuffer=c.createBuffer(),this._bindBuffer(d.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.curFillShader.attributes.aTexCoord&&(d.uvBuffer=c.createBuffer(),this._bindBuffer(d.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;this._useColorShader();var c=this.gHash[a];return this._doStroke&&c.lineVertexCount>0&&(this.curStrokeShader.bindShader(),c.lineVertexBuffer&&(this._bindBuffer(c.lineVertexBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0)),c.lineNormalBuffer&&(this._bindBuffer(c.lineNormalBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aDirection.location,4,b.FLOAT,!1,0,0)),this._applyColorBlend(this.curStrokeColor),this._drawArrays(b.TRIANGLES,a),this.curStrokeShader.unbindShader()),!1!==this._doFill&&(this.curFillShader.bindShader(),c.vertexBuffer&&(this._bindBuffer(c.vertexBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0)),c.indexBuffer&&this._bindBuffer(c.indexBuffer,b.ELEMENT_ARRAY_BUFFER),c.normalBuffer&&(this._bindBuffer(c.normalBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aNormal.location,3,b.FLOAT,!1,0,0)),c.uvBuffer&&(this._bindBuffer(c.uvBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aTexCoord.location,2,b.FLOAT,!1,0,0)),this._applyColorBlend(this.curFillColor),this._drawElements(b.TRIANGLES,a),this.curFillShader.unbindShader()),this},d.RendererGL.prototype.drawBuffersScaled=function(a,b,c,d){var e=this.uMVMatrix.copy();try{this.uMVMatrix.scale(b,c,d),this.drawBuffers(a)}finally{this.uMVMatrix=e}},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":21}],72:[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 = 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}",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;\nvec3 scale = vec3(1.0);\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}"};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.attributes.perPixelLighting=void 0!==e.perPixelLighting&&e.perPixelLighting,this._initContext(),this.isP3D=!0,this.GL=this.drawingContext,this.ambientLightColors=[],this.directionalLightDirections=[],this.directionalLightColors=[],this.pointLightPositions=[],this.pointLightColors=[],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(b),this.camera(),this.gHash={},this._defaultLightShader=void 0,this._defaultImmediateModeShader=void 0,this._defaultNormalShader=void 0,this._defaultColorShader=void 0,this.curFillShader=void 0,this.curStrokeShader=void 0,this._useColorShader(),this.setStrokeShader(this._getLineShader()),this.isImmediateDrawing=!1,this.immediateMode={},this.fill(255,255,255,255),this.pointSize=5,this.strokeWeight(2),this.stroke(0,0,0),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),this._viewport=this.drawingContext.getParameter(this.drawingContext.VIEWPORT)}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;var i=new d.RendererGL(this._pInst.canvas,this._pInst,!0,a);this._pInst._setProperty("_renderer",i),i.resize(e,f),i._applyDefaults(),this._pInst._elements.push(i),"function"==typeof c&&setTimeout(function(){c.apply(window._renderer,b)},0)},d.prototype.setAttributes=function(a,b){var c;void 0!==b?(c={},c[a]=b):a instanceof Object&&(c=a),this._renderer._resetContext(c)},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.ambientLightColors.length=0,this.directionalLightDirections.length=0,this.directionalLightColors.length=0,this.pointLightPositions.length=0,this.pointLightColors.length=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.depthMask(!0),this.GL.clear(this.GL.COLOR_BUFFER_BIT|this.GL.DEPTH_BUFFER_BIT)},d.RendererGL.prototype.fill=function(a,b,c,f){var g=d.prototype.color.apply(this._pInst,arguments);this.curFillColor=g._array,this.isImmediateDrawing?this.setFillShader(this._getImmediateModeShader()):this.setFillShader(this._getColorShader()),this.drawMode=e.FILL,this.curFillShader.setUniform("uMaterialColor",this.curFillColor)},d.RendererGL.prototype.stroke=function(a,b,c,e){arguments[3]=255;var f=d.prototype.color.apply(this._pInst,arguments);this.curStrokeColor=f._array,this.curStrokeShader.setUniform("uMaterialColor",this.curStrokeColor)},d.RendererGL.prototype.strokeWeight=function(a){this.curStrokeWeight!==a&&(this.pointSize=a,this.curStrokeWeight=a,this.curStrokeShader.setUniform("uStrokeWeight",a))},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(!0!==this.attributes.preserveDrawingBuffer)return void console.log("loadPixels only works in WebGL when preserveDrawingBuffer is true.");var a=this._pInst._pixelDensity,b=this.width,c=this.height;b*=a,c*=a,void 0===this.pixels&&(this.pixels=new Uint8Array(this.GL.drawingBufferWidth*this.GL.drawingBufferHeight*4)),this.GL.readPixels(0,0,b,c,this.GL.RGBA,this.GL.UNSIGNED_BYTE,this.pixels),this._pInst._setProperty("pixels",this.pixels)},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),this._viewport=this.GL.getParameter(this.GL.VIEWPORT),null!==this._curCamera&&"default"!==this._curCamera||(this._curCamera=null,this._setDefaultCamera()),void 0!==this.pixels&&(this.pixels=new Uint8Array(this.GL.drawingBufferWidth*this.GL.drawingBufferHeight*4))},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 void 0===b?this.rotateZ(a):(d.Matrix.prototype.rotate.apply(this.uMVMatrix,arguments),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._pInst),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},d.RendererGL.prototype.setStrokeShader=function(a){return this.curStrokeShader!==a&&(this.curStrokeShader=a,this.curStrokeShader.init()),this.curStrokeShader},d.RendererGL.prototype._useLightShader=function(){return this.curFillShader&&this.curFillShader.isLightShader()||this.setFillShader(this._getLightShader()),this.curFillShader},d.RendererGL.prototype._useColorShader=function(){return this.curFillShader&&this.curFillShader!==this._defaultImmediateModeShader||this.setFillShader(this._getColorShader()),this.curFillShader},d.RendererGL.prototype._useImmediateModeShader=function(){return this.curFillShader&&this.curFillShader!==this._defaultColorShader||this.setFillShader(this._getImmediateModeShader()),this.curFillShader},d.RendererGL.prototype._getLightShader=function(){return this._defaultLightShader||(this.attributes.perPixelLighting?this._defaultLightShader=new d.Shader(this,h.phongVert,h.phongFrag):this._defaultLightShader=new d.Shader(this,h.lightVert,h.lightTextureFrag)),this._defaultLightShader},d.RendererGL.prototype._getImmediateModeShader=function(){return this._defaultImmediateModeShader||(this._defaultImmediateModeShader=new d.Shader(this,h.immediateVert,h.vertexColorFrag)),this._defaultImmediateModeShader},d.RendererGL.prototype._getNormalShader=function(){return this._defaultNormalShader||(this._defaultNormalShader=new d.Shader(this,h.normalVert,h.normalFrag)),this._defaultNormalShader},d.RendererGL.prototype._getColorShader=function(){return this._defaultColorShader||(this._defaultColorShader=new d.Shader(this,h.normalVert,h.basicFrag)),this._defaultColorShader},d.RendererGL.prototype._getLineShader=function(){return this._defaultLineShader||(this._defaultLineShader=new d.Shader(this,h.lineVert,h.lineFrag)),this._defaultLineShader},d.RendererGL.prototype._getEmptyTexture=function(){if(!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 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){if(0===a.length)return[];if(a.length>2e4){var b,c=Object.prototype.toString,d="[object Array]",e=[],f=a.slice();b=f.pop();do{c.call(b)===d?f.push.apply(f,b):e.push(b)}while(f.length&&void 0!==(b=f.pop()));return e.reverse(),e}return[].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":20,"../core/core":21,"../core/p5.Renderer":28,"./p5.Matrix":69,"./p5.Shader":73}],73:[function(a,b,c){"use strict";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?e.uniform1iv(d,b):e.uniform1i(d,b);break;case e.FLOAT:c.size>1?e.uniform1fv(d,b):e.uniform1f(d,b);break;case e.FLOAT_MAT3:e.uniformMatrix3fv(d,!1,b);break;case e.FLOAT_MAT4:e.uniformMatrix4fv(d,!1,b);break;case e.FLOAT_VEC2:c.size>1?e.uniform2fv(d,b):e.uniform2f(d,b[0],b[1]);break;case e.FLOAT_VEC3:c.size>1?e.uniform3fv(d,b):e.uniform3f(d,b[0],b[1],b[2]);break;case e.FLOAT_VEC4:c.size>1?e.uniform4fv(d,b):e.uniform4f(d,b[0],b[1],b[2],b[3]);break;case e.SAMPLER_2D:e.activeTexture(e.TEXTURE0+c.samplerIndex),c.texture=this._renderer.getTexture(b),e.uniform1i(c.location,c.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-1!==a&&(g.enableVertexAttribArray(a),g.vertexAttribPointer(a,b,c,d,e,f)),this},b.exports=d.Shader},{"../core/core":21}],74:[function(a,b,c){"use strict";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&&!(b instanceof d.Graphics),this.isSrcP5Image=b instanceof d.Image,this.isSrcP5Graphics=b instanceof d.Graphics;var e=this._getTextureDataFromSource();return this.width=e.width,this.height=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":21}],75:[function(a,b,c){"use strict";var d=a("../core/core");a("./p5.Geometry"),d.prototype.plane=function(a,b,c,e){void 0===a&&(a=50),void 0===b&&(b=a),void 0===c&&(c=1),void 0===e&&(e=1);var f="plane|"+c+"|"+e;if(!this._renderer.geometryInHash(f)){var g=function(){for(var a,b,c,e=0;e<=this.detailY;e++){b=e/this.detailY;for(var f=0;f<=this.detailX;f++)a=f/this.detailX,c=new d.Vector(a-.5,b-.5,0),this.vertices.push(c),this.uvs.push([a,b])}},h=new d.Geometry(c,e,g);h.computeFaces().computeNormals(),c<=1&&e<=1?(h._makeTriangleEdges(),this._renderer._edgesToVertices(h)):console.log("Cannot draw stroke on plane objects with more than 1 detailX or 1 detailY"),this._renderer.createBuffers(f,h)}this._renderer.drawBuffersScaled(f,a,b,0)},d.prototype.box=function(a,b,c,e,f){void 0===a&&(a=50),void 0===b&&(b=a),void 0===c&&(c=b),void 0===e&&(e=4),void 0===f&&(f=4);var g="box|"+e+"|"+f;if(!this._renderer.geometryInHash(g)){var h=function(){var a=[[0,4,2,6],[1,3,5,7],[0,1,4,5],[2,6,3,7],[0,2,1,3],[4,5,6,7]];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 b=0;bf?(r=c,q=1,p=b):p=a+i/f*(b-a),-2!==i&&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;i Date: Fri, 9 Mar 2018 16:46:00 -0500 Subject: [PATCH 05/29] Adding code from March 9 live stream This here is the start of code I need for my neuro-evolution examples. So far I have only implemented "copy()" and "mutate()" ok! I still need to do "crossover()" and implement the GA itself of course. For reference the live stream is here: https://www.youtube.com/watch?v=ASnCXW6pPSY --- examples/neuro-evolution/sketch.js | 8 +++ lib/matrix.js | 23 ++++++--- lib/nn.js | 78 ++++++++++++++++++++++-------- 3 files changed, 81 insertions(+), 28 deletions(-) diff --git a/examples/neuro-evolution/sketch.js b/examples/neuro-evolution/sketch.js index e7499c1..3c3423a 100644 --- a/examples/neuro-evolution/sketch.js +++ b/examples/neuro-evolution/sketch.js @@ -1,4 +1,12 @@ +let brain; + function setup() { + noCanvas(); + brain = new NeuralNetwork(2, 4, 1); + console.log(brain); + let child = brain.copy(); + child.mutate(0.01); + // child.mutate(); } diff --git a/lib/matrix.js b/lib/matrix.js index 5897718..34b2d97 100644 --- a/lib/matrix.js +++ b/lib/matrix.js @@ -8,12 +8,22 @@ class Matrix { this.data = Array(this.rows).fill().map(() => Array(this.cols).fill(0)); } + copy() { + let m = new Matrix(this.rows, this.cols); + for (let i = 0; i < this.rows; i++) { + for (let j = 0; j < this.cols; j++) { + m.data[i][j] = this.data[i][j]; + } + } + return m; + } + static fromArray(arr) { return new Matrix(arr.length, 1).map((e, i) => arr[i]); } static subtract(a, b) { - if(a.rows!==b.rows || a.cols!==b.cols){ + if (a.rows !== b.rows || a.cols !== b.cols) { console.log('Columns and Rows of A must match Columns and Rows of B.'); return; } @@ -39,11 +49,11 @@ class Matrix { add(n) { if (n instanceof Matrix) { - if(this.rows!==n.rows || this.cols!==n.cols){ + if (this.rows !== n.rows || this.cols !== n.cols) { console.log('Columns and Rows of A must match Columns and Rows of B.'); return; } - return this.map((e, i, j) => e + n.data[i][j]); + return this.map((e, i, j) => e + n.data[i][j]); } else { return this.map(e => e + n); } @@ -74,7 +84,7 @@ class Matrix { multiply(n) { if (n instanceof Matrix) { - if(this.rows!==n.rows || this.cols!==n.cols){ + if (this.rows !== n.rows || this.cols !== n.cols) { console.log('Columns and Rows of A must match Columns and Rows of B.'); return; } @@ -114,8 +124,7 @@ class Matrix { } static deserialize(data) { - if(typeof data == 'string') - { + if (typeof data == 'string') { data = JSON.parse(data); } let matrix = new Matrix(data.rows, data.cols); @@ -126,4 +135,4 @@ class Matrix { if (typeof module !== 'undefined') { module.exports = Matrix; -} \ No newline at end of file +} diff --git a/lib/nn.js b/lib/nn.js index 5cce746..0260280 100644 --- a/lib/nn.js +++ b/lib/nn.js @@ -1,7 +1,7 @@ // Other techniques for learning -class ActivationFunction{ - constructor(func, dfunc){ +class ActivationFunction { + constructor(func, dfunc) { this.func = func; this.dfunc = dfunc; } @@ -9,34 +9,49 @@ class ActivationFunction{ let sigmoid = new ActivationFunction( x => 1 / (1 + Math.exp(-x)), - y => y * (1- y) + y => y * (1 - y) ); let tanh = new ActivationFunction( x => Math.tanh(x), - y => 1-(y*y) + y => 1 - (y * y) ); class NeuralNetwork { - constructor(input_nodes, hidden_nodes, output_nodes) { - this.input_nodes = input_nodes; - this.hidden_nodes = hidden_nodes; - this.output_nodes = output_nodes; - - this.weights_ih = new Matrix(this.hidden_nodes, this.input_nodes); - this.weights_ho = new Matrix(this.output_nodes, this.hidden_nodes); - this.weights_ih.randomize(); - this.weights_ho.randomize(); - - this.bias_h = new Matrix(this.hidden_nodes, 1); - this.bias_o = new Matrix(this.output_nodes, 1); - this.bias_h.randomize(); - this.bias_o.randomize(); - this.setLearningRate(); + // TODO: document what a, b, c are + constructor(a, b, c) { + if (a instanceof NeuralNetwork) { + this.input_nodes = a.input_nodes; + this.hidden_nodes = a.hidden_nodes; + this.output_nodes = a.output_nodes; + + this.weights_ih = a.weights_ih.copy(); + this.weights_ho = a.weights_ho.copy(); + + this.bias_h = a.bias_h.copy(); + this.bias_o = a.bias_o.copy(); + } else { + this.input_nodes = a; + this.hidden_nodes = b; + this.output_nodes = c; + + this.weights_ih = new Matrix(this.hidden_nodes, this.input_nodes); + this.weights_ho = new Matrix(this.output_nodes, this.hidden_nodes); + this.weights_ih.randomize(); + this.weights_ho.randomize(); + + this.bias_h = new Matrix(this.hidden_nodes, 1); + this.bias_o = new Matrix(this.output_nodes, 1); + this.bias_h.randomize(); + this.bias_o.randomize(); + } + // TODO: copy these as well + this.setLearningRate(); this.setActivationFunction(); + } predict(input_array) { @@ -128,8 +143,7 @@ class NeuralNetwork { } static deserialize(data) { - if(typeof data == 'string') - { + if (typeof data == 'string') { data = JSON.parse(data); } let nn = new NeuralNetwork(data.input_nodes, data.hidden_nodes, data.output_nodes); @@ -141,4 +155,26 @@ class NeuralNetwork { return nn; } + + // Adding function for neuro-evolution + copy() { + return new NeuralNetwork(this); + } + + mutate(rate) { + function mutate(val) { + if (Math.random() < rate) { + return Math.random() * 1000 - 1; + } else { + return val; + } + } + this.weights_ih.map(mutate); + this.weights_ho.map(mutate); + this.bias_h.map(mutate); + this.bias_o.map(mutate); + } + + + } From 03718ae2971c4297e30b7b22e3727a5bfc9c1a65 Mon Sep 17 00:00:00 2001 From: Engine Feeder Date: Sat, 10 Mar 2018 18:28:21 +0100 Subject: [PATCH 06/29] Add Matrix copy() test This adds a test for the `Matrix.copy()` function. --- lib/matrix.test.js | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/lib/matrix.test.js b/lib/matrix.test.js index 4933895..49fc653 100644 --- a/lib/matrix.test.js +++ b/lib/matrix.test.js @@ -363,6 +363,7 @@ test('static map with row and column params', () => { ] }); }); + test('matrix (de)serialization', () => { let m = new Matrix(5, 5); m.randomize(); @@ -375,3 +376,16 @@ test('matrix (de)serialization', () => { data: m.data }); }); + +test('matrix copy', () => { + let m = new Matrix(5, 5); + m.randomize(); + + let n = m.copy(); + + expect(n).toEqual({ + rows: m.rows, + cols: m.cols, + data: m.data + }); +}); From 1bbf0ca98b88a42ec491efb1fdee7a7e2a242c95 Mon Sep 17 00:00:00 2001 From: Engine Feeder Date: Thu, 15 Mar 2018 21:19:12 +0100 Subject: [PATCH 07/29] Examples added doodleclassifier and Youtube links The doodle classifier example was missing under the examples list. Also links to the youtube videos coding these examples are added. --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a7a35d7..20a46a7 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,9 @@ Neural Network JavaScript library for Coding Train tutorials ## Examples / Demos Here are some demos running directly in the browser: -* [XOR problem](https://codingtrain.github.io/Toy-Neural-Network-JS/examples/xor/) +* [XOR problem](https://codingtrain.github.io/Toy-Neural-Network-JS/examples/xor/), [Coding Challenge on YouTube](https://www.youtube.com/watch?v=188B6k_F9jU) * [Handwritten digit recognition](https://codingtrain.github.io/Toy-Neural-Network-JS/examples/mnist/) +* [Doodle classifier](https://codingtrain.github.io/Toy-Neural-Network-JS/examples/doodle_classification/), [Coding Challenge on YouTube](https://www.youtube.com/watch?v=pqY_Tn2SIVA&list=PLRqwX-V7Uu6Zs14zKVuTuit6jApJgoYZQ) ## To-Do List From 36223430b325bbafa0a0373f1df0214809dc729c Mon Sep 17 00:00:00 2001 From: Jonathan Richer <36356746+codeMeHtm@users.noreply.github.com> Date: Wed, 21 Mar 2018 16:41:12 -0400 Subject: [PATCH 08/29] Create a README in the xor example --- examples/xor/README.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 examples/xor/README.md diff --git a/examples/xor/README.md b/examples/xor/README.md new file mode 100644 index 0000000..7f9c89d --- /dev/null +++ b/examples/xor/README.md @@ -0,0 +1,6 @@ +## Variations: + +I literally copied this code from the video, +but then, I added a little bit more. Here is +the project that I made: +* [NN XOR](https://codemehtm.github.io/nn) From 20bc3db6bc54a48dc9f1bcaa6a52bcc805c673ce Mon Sep 17 00:00:00 2001 From: Jonathan Richer <36356746+codeMeHtm@users.noreply.github.com> Date: Thu, 22 Mar 2018 17:22:11 -0400 Subject: [PATCH 09/29] Update the structure of the README file --- examples/xor/README.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/examples/xor/README.md b/examples/xor/README.md index 7f9c89d..dfc9875 100644 --- a/examples/xor/README.md +++ b/examples/xor/README.md @@ -1,6 +1,3 @@ ## Variations: -I literally copied this code from the video, -but then, I added a little bit more. Here is -the project that I made: -* [NN XOR](https://codemehtm.github.io/nn) +* [NN XOR](https://codemehtm.github.io/nn) by cdeMtHtm - "I literally copied this from the video, but then, I added a little bit more." From 24540b8749a0eb53542c085e753c767dc48cdd4d Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Mon, 9 Apr 2018 14:05:09 -0400 Subject: [PATCH 10/29] attempting flappy neuro-evolution first pass --- examples/neuroevolution-flappybird/bird.js | 103 ++++++++ examples/neuroevolution-flappybird/ga.js | 81 ++++++ .../graphics/background.png | Bin 0 -> 235935 bytes .../graphics/horn_body_filled.png | Bin 0 -> 31514 bytes .../graphics/horn_tip_filled.png | Bin 0 -> 25760 bytes .../graphics/pipe_body.png | Bin 0 -> 7481 bytes .../graphics/pipe_marshmallow.png | Bin 0 -> 23812 bytes .../graphics/pipe_marshmallow_fix.png | Bin 0 -> 20787 bytes .../graphics/train.png | Bin 0 -> 29665 bytes examples/neuroevolution-flappybird/index.html | 28 +++ examples/neuroevolution-flappybird/pipe.js | 76 ++++++ examples/neuroevolution-flappybird/sketch.js | 238 ++++++++++++++++++ lib/nn.js | 12 +- 13 files changed, 534 insertions(+), 4 deletions(-) create mode 100644 examples/neuroevolution-flappybird/bird.js create mode 100644 examples/neuroevolution-flappybird/ga.js create mode 100644 examples/neuroevolution-flappybird/graphics/background.png create mode 100644 examples/neuroevolution-flappybird/graphics/horn_body_filled.png create mode 100644 examples/neuroevolution-flappybird/graphics/horn_tip_filled.png create mode 100644 examples/neuroevolution-flappybird/graphics/pipe_body.png create mode 100644 examples/neuroevolution-flappybird/graphics/pipe_marshmallow.png create mode 100644 examples/neuroevolution-flappybird/graphics/pipe_marshmallow_fix.png create mode 100644 examples/neuroevolution-flappybird/graphics/train.png create mode 100644 examples/neuroevolution-flappybird/index.html create mode 100644 examples/neuroevolution-flappybird/pipe.js create mode 100644 examples/neuroevolution-flappybird/sketch.js diff --git a/examples/neuroevolution-flappybird/bird.js b/examples/neuroevolution-flappybird/bird.js new file mode 100644 index 0000000..bac989b --- /dev/null +++ b/examples/neuroevolution-flappybird/bird.js @@ -0,0 +1,103 @@ +// Daniel Shiffman +// http://codingtra.in +// http://patreon.com/codingtrain +// Code for: https://youtu.be/cXgA1d_E-jY + +// Class is exported (eslint flag) +/* exported Bird */ + +class Bird { + constructor(brain) { + this.y = height / 2; + this.x = 64; + + this.gravity = 0.6; + this.lift = -7; + this.velocity = 0; + + this.icon = birdSprite; + this.width = 36; + this.height = 36; + + + // Is this a copy of another Bird or a new one? + // The Neural Network is the bird's "brain" + if (brain instanceof NeuralNetwork) { + this.brain = brain.copy(); + this.brain.mutate(0.1); + } else { + this.brain = new NeuralNetwork(4, 16, 2); + } + + // Score is how many frames it's been alive + this.score = 0; + // Fitness is normalized version of score + this.fitness = 0; + } + + // Create a copy of this bird + copy() { + return new Bird(this.brain); + } + + // This is the key function now that decides + // if it should jump or not jump! + think(pipes) { + // First find the closest pipe + var closest = null; + var record = Infinity; + for (var i = 0; i < pipes.length; i++) { + var diff = pipes[i].x - this.x; + if (diff > 0 && diff < record) { + record = diff; + closest = pipes[i]; + } + } + + if (closest != null) { + // Now create the inputs to the neural network + var inputs = []; + // x position of closest pipe + inputs[0] = map(closest.x, this.x, width, -1, 1); + // top of closest pipe opening + inputs[1] = map(closest.top, 0, height, -1, 1); + // bottom of closest pipe opening + inputs[2] = map(closest.bottom, 0, height, -1, 1); + // bird's y position + inputs[3] = map(this.y, 0, height, -1, 1); + // Get the outputs from the network + var action = this.brain.predict(inputs); + // Decide to jump or not! + if (action[1] > action[0]) { + this.up(); + } + } + } + + show() { + // draw the icon CENTERED around the X and Y coords of the bird object + image(this.icon, this.x - this.width / 2, this.y - this.height / 2, this.width, this.height); + } + + up() { + this.velocity = this.lift; + } + + update() { + this.velocity += this.gravity; + this.y += this.velocity; + + if (this.y >= height - this.height / 2) { + this.y = height - this.height / 2; + this.velocity = 0; + } + + if (this.y <= this.height / 2) { + this.y = this.height / 2; + this.velocity = 0; + } + + // Every frame it is alive increases the score + this.score++; + } +} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird/ga.js b/examples/neuroevolution-flappybird/ga.js new file mode 100644 index 0000000..6d143ba --- /dev/null +++ b/examples/neuroevolution-flappybird/ga.js @@ -0,0 +1,81 @@ +// Daniel Shiffman + +// This flappy bird implementation is adapted from: +// https://youtu.be/cXgA1d_E-jY& + +// This file includes functions for creating a new generation +// of birds. + +// Start the game over +function resetGame() { + counter = 0; + pipes = []; +} + +// Create the next generation +function nextGeneration() { + resetGame(); + // Normalize the fitness values 0-1 + normalizeFitness(allBirds); + // Generate a new set of birds + activeBirds = generate(allBirds); + // Copy those birds to another array + allBirds = activeBirds.slice(); +} + +// Generate a new population of birds +function generate(oldBirds) { + var newBirds = []; + for (var i = 0; i < oldBirds.length; i++) { + // Select a bird based on fitness + var bird = poolSelection(oldBirds); + newBirds[i] = bird; + } + return newBirds; +} + +// Normalize the fitness of all birds +function normalizeFitness(birds) { + // Make score exponentially better? + for (var i = 0; i < birds.length; i++) { + birds[i].score = pow(birds[i].score, 2); + } + + // Add up all the scores + var sum = 0; + for (var i = 0; i < birds.length; i++) { + sum += birds[i].score; + } + // Divide by the sum + for (var i = 0; i < birds.length; i++) { + birds[i].fitness = birds[i].score / sum; + } + console.log(birds); +} + + +// An algorithm for picking one bird from an array +// based on fitness +function poolSelection(birds) { + // Start at 0 + var index = 0; + + // Pick a random number between 0 and 1 + var r = random(1); + + // Keep subtracting probabilities until you get less than zero + // Higher probabilities will be more likely to be fixed since they will + // subtract a larger number towards zero + while (r > 0) { + r -= birds[index].fitness; + // And move on to the next + index += 1; + } + + // Go back one + index -= 1; + + // Make sure it's a copy! + // (this includes mutation) + return birds[index].copy(); +} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird/graphics/background.png b/examples/neuroevolution-flappybird/graphics/background.png new file mode 100644 index 0000000000000000000000000000000000000000..c856c95b18467169b55d7f879d27d6cd00d44797 GIT binary patch literal 235935 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�XU&5!JiVW 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 n`e*H#$>0j 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 oQ8D19WHRma{~6%zUjXbYuf+* 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 literal 0 HcmV?d00001 diff --git a/examples/neuroevolution-flappybird/graphics/pipe_marshmallow_fix.png b/examples/neuroevolution-flappybird/graphics/pipe_marshmallow_fix.png new file mode 100644 index 0000000000000000000000000000000000000000..0e0296eaa8e062b17ddfc1318839ddbe6c31051f GIT binary patch literal 20787 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 + + + + + + + + + + + + + + + +

+

+ speed: 1 +
high score: 0 +
all time high score: 0 +

+

+ +

+ + + \ No newline at end of file diff --git a/examples/neuroevolution-flappybird/pipe.js b/examples/neuroevolution-flappybird/pipe.js new file mode 100644 index 0000000..e436822 --- /dev/null +++ b/examples/neuroevolution-flappybird/pipe.js @@ -0,0 +1,76 @@ +// Daniel Shiffman +// http://codingtra.in +// http://patreon.com/codingtrain +// Code for: https://youtu.be/cXgA1d_E-jY + +// Pipe is exported (eslint flags) +/* exported Pipe */ + +class Pipe { + constructor() { + this.spacing = 200; + this.top = random(height / 6, 3 / 4 * height); + this.bottom = this.top + this.spacing; + + this.x = width; + this.w = 80; + this.speed = pipeSpeed; + + this.passed = false; + this.highlight = false; + } + + hits(bird) { + if (bird.y - bird.height / 2 < this.top || bird.y + bird.height / 2 > this.bottom) { + //if this.w is huge, then we need different collision model + if (bird.x + bird.width / 2 > this.x && bird.x - bird.width / 2 < this.x + this.w) { + this.highlight = true; + this.passed = true; + return true; + } + } + this.highlight = false; + return false; + } + + // this function is used to calculate scores and checks if we've went through the pipes + // pass(bird) { + // if (bird.x > this.x && !this.passed) { + // this.passed = true; + // return true; + // } + // return false; + // } + + drawHalf() { + let howManyNedeed = 0; + let peakRatio = pipePeakSprite.height / pipePeakSprite.width; + let bodyRatio = pipeBodySprite.height / pipeBodySprite.width; + //this way we calculate, how many tubes we can fit without stretching + howManyNedeed = Math.round(height / (this.w * bodyRatio)); + //this <= and start from 1 is just my HACK xD But it's working + for (let i = 0; i < howManyNedeed; ++i) { + let offset = this.w * (i * bodyRatio + peakRatio); + image(pipeBodySprite, -this.w / 2, offset, this.w, this.w * bodyRatio); + } + image(pipePeakSprite, -this.w / 2, 0, this.w, this.w * peakRatio); + } + + show() { + push(); + translate(this.x + this.w / 2, this.bottom); + this.drawHalf(); + translate(0, -this.spacing); + rotate(PI); + this.drawHalf(); + pop(); + } + + update() { + this.x -= this.speed; + } + + offscreen() { + return (this.x < -this.w); + } +} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird/sketch.js b/examples/neuroevolution-flappybird/sketch.js new file mode 100644 index 0000000..642eb61 --- /dev/null +++ b/examples/neuroevolution-flappybird/sketch.js @@ -0,0 +1,238 @@ +// Daniel Shiffman +// http://codingtra.in +// http://patreon.com/codingtrain +// Code for: https://youtu.be/cXgA1d_E-jY + + +// GA additions +// How big is the population +let totalPopulation = 250; +// All active birds (not yet collided with pipe) +let activeBirds = []; +// All birds for any given population +let allBirds = []; +// Pipes +let pipes = []; +// A frame counter to determine when to add a pipe +let counter = 0; + +// Interface elements +let speedSlider; +let speedSpan; +let highScoreSpan; +let allTimeHighScoreSpan; + +// All time high score +let highScore = 0; + +// Training or just showing the current best +let runBest = false; +let runBestButton; + +//// Game stuff + +// let bird; +// let pipes; +let parallax = 0.8; +let score = 0; +let maxScore = 0; +let birdSprite; +let pipeBodySprite; +let pipePeakSprite; +let bgImg; +let bgX = 0; +let gameoverFrame = 0; +let isOver = false; +let pipeSpeed = 2; + +let touched = false; +let prevTouched = touched; + + +function preload() { + pipeBodySprite = loadImage('graphics/pipe_marshmallow_fix.png'); + pipePeakSprite = loadImage('graphics/pipe_marshmallow_fix.png'); + birdSprite = loadImage('graphics/train.png'); + bgImg = loadImage('graphics/background.png'); +} + +function setup() { + + let canvas = createCanvas(600, 600); + canvas.parent('canvascontainer'); + + // Access the interface elements + speedSlider = select('#speedSlider'); + speedSpan = select('#speed'); + highScoreSpan = select('#hs'); + allTimeHighScoreSpan = select('#ahs'); + runBestButton = select('#best'); + runBestButton.mousePressed(toggleState); + + // Create a population + for (let i = 0; i < totalPopulation; i++) { + let bird = new Bird(); + activeBirds[i] = bird; + allBirds[i] = bird; + } + + +} + +// Toggle the state of the simulation +function toggleState() { + runBest = !runBest; + // Show the best bird + if (runBest) { + resetGame(); + bestBird.score = 0; + runBestButton.html('continue training'); + // Go train some more + } else { + nextGeneration(); + runBestButton.html('run best'); + } +} + + +function draw() { + // Should we speed up cycles per frame + let cycles = speedSlider.value(); + speedSpan.html(cycles); + + // How many times to advance the game + for (let n = 0; n < cycles; n++) { + //bgX -= pipes[0].speed * parallax; + bgX -= pipeSpeed * parallax; + + + // this handles the "infinite loop" by checking if the right + // edge of the image would be on the screen, if it is draw a + // second copy of the image right next to it + // once the second image gets to the 0 point, we can reset bgX to + // 0 and go back to drawing just one image. + if (bgX <= -bgImg.width + width) { + if (bgX <= -bgImg.width) { + bgX = 0; + } + } + + // Are we just running the best bird + if (runBest) { + bestBird.think(pipes); + bestBird.update(); + for (let j = 0; j < pipes.length; j++) { + // Start over, bird hit pipe + if (pipes[j].hits(bestBird)) { + resetGame(); + break; + } + } + // Or are we running all the active birds + } else { + for (let i = pipes.length - 1; i >= 0; i--) { + pipes[i].update(); + + if (pipes[i].offscreen()) { + pipes.splice(i, 1); + } + } + + for (let i = activeBirds.length - 1; i >= 0; i--) { + let bird = activeBirds[i]; + // Bird uses its brain! + bird.think(pipes); + bird.update(); + // Check all the pipes + for (let j = 0; j < pipes.length; j++) { + // if (pipes[j].pass(bird)) { + // bird.score++; + // } + // It's hit a pipe + if (pipes[j].hits(bird)) { + // Remove this bird + activeBirds.splice(i, 1); + break; + } + } + } + } + + + if (counter % 250 == 0) { + pipes.push(new Pipe()); + } + counter++; + + + // What is highest score of the current population + let tempHighScore = 0; + // If we're training + if (!runBest) { + // Which is the best bird? + let tempBestBird = null; + for (let i = 0; i < activeBirds.length; i++) { + let s = activeBirds[i].score; + if (s > tempHighScore) { + tempHighScore = s; + tempBestBird = activeBirds[i]; + } + } + + // Is it the all time high scorer? + if (tempHighScore > highScore) { + highScore = tempHighScore; + bestBird = tempBestBird; + } + } else { + // Just one bird, the best one so far + tempHighScore = bestBird.score; + if (tempHighScore > highScore) { + highScore = tempHighScore; + } + } + + // Update DOM Elements + highScoreSpan.html(tempHighScore); + allTimeHighScoreSpan.html(highScore); + + // Draw everything! + + background(0); + // Draw our background image, then move it at the same speed as the pipes + image(bgImg, bgX, 0, bgImg.width, height); + image(bgImg, bgX + bgImg.width, 0, bgImg.width, height); + + for (let i = 0; i < pipes.length; i++) { + pipes[i].show(); + } + + if (runBest) { + bestBird.show(); + } else { + for (let i = 0; i < activeBirds.length; i++) { + activeBirds[i].show(); + } + // If we're out of birds go to the next generation + if (activeBirds.length == 0) { + nextGeneration(); + } + } + + } + +} + + + + +// function keyPressed() { +// if (key === ' ') { +// bird.up(); +// if (isOver) reset(); //you can just call reset() in Machinelearning if you die, because you cant simulate keyPress with code. +// } +// } + +// function touchStarted() { +// if (isOver) reset(); +// } \ No newline at end of file diff --git a/lib/nn.js b/lib/nn.js index 0260280..db53b8c 100644 --- a/lib/nn.js +++ b/lib/nn.js @@ -162,11 +162,15 @@ class NeuralNetwork { } mutate(rate) { - function mutate(val) { + // This is how we adjust weights ever so slightly + function mutate(x) { if (Math.random() < rate) { - return Math.random() * 1000 - 1; + var offset = randomGaussian() * 0.5; + // var offset = random(-0.1, 0.1); + var newx = x + offset; + return newx; } else { - return val; + return x; } } this.weights_ih.map(mutate); @@ -177,4 +181,4 @@ class NeuralNetwork { -} +} \ No newline at end of file From 50178410ad60ef742a42e9c4438776c3fec0bbb6 Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Mon, 9 Apr 2018 16:23:14 -0400 Subject: [PATCH 11/29] flappy bird attempts --- examples/neuroevolution-flappybird-1/bird.js | 103 + examples/neuroevolution-flappybird-1/ga.js | 83 + .../neuroevolution-flappybird-1/index.html | 30 + .../libraries/p5.dom.js | 2190 + .../libraries/p5.js | 35126 ++++++++++++++++ .../libraries/p5.sound.js | 9336 ++++ examples/neuroevolution-flappybird-1/pipe.js | 56 + .../neuroevolution-flappybird-1/sketch.js | 170 + .../bird.js | 0 .../ga.js | 0 .../graphics/background.png | Bin .../graphics/horn_body_filled.png | Bin .../graphics/horn_tip_filled.png | Bin .../graphics/pipe_body.png | Bin .../graphics/pipe_marshmallow.png | Bin .../graphics/pipe_marshmallow_fix.png | Bin .../graphics/train.png | Bin .../index.html | 2 +- .../pipe.js | 0 .../sketch.js | 2 +- 20 files changed, 47096 insertions(+), 2 deletions(-) create mode 100644 examples/neuroevolution-flappybird-1/bird.js create mode 100644 examples/neuroevolution-flappybird-1/ga.js create mode 100755 examples/neuroevolution-flappybird-1/index.html create mode 100644 examples/neuroevolution-flappybird-1/libraries/p5.dom.js create mode 100644 examples/neuroevolution-flappybird-1/libraries/p5.js create mode 100644 examples/neuroevolution-flappybird-1/libraries/p5.sound.js create mode 100644 examples/neuroevolution-flappybird-1/pipe.js create mode 100644 examples/neuroevolution-flappybird-1/sketch.js rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/bird.js (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/ga.js (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/graphics/background.png (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/graphics/horn_body_filled.png (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/graphics/horn_tip_filled.png (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/graphics/pipe_body.png (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/graphics/pipe_marshmallow.png (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/graphics/pipe_marshmallow_fix.png (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/graphics/train.png (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/index.html (99%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/pipe.js (100%) rename examples/{neuroevolution-flappybird => neuroevolution-flappybird-2}/sketch.js (99%) diff --git a/examples/neuroevolution-flappybird-1/bird.js b/examples/neuroevolution-flappybird-1/bird.js new file mode 100644 index 0000000..334becc --- /dev/null +++ b/examples/neuroevolution-flappybird-1/bird.js @@ -0,0 +1,103 @@ +// Daniel Shiffman +// Nature of Code: Intelligence and Learning +// https://github.com/shiffman/NOC-S17-2-Intelligence-Learning + +// This flappy bird implementation is adapted from: +// https://youtu.be/cXgA1d_E-jY& + +function Bird(brain) { + // position and size of bird + this.x = 64; + this.y = height / 2; + this.r = 12; + + // Gravity, lift and velocity + this.gravity = 0.4; + this.lift = -12; + this.velocity = 0; + + // Is this a copy of another Bird or a new one? + // The Neural Network is the bird's "brain" + if (brain instanceof NeuralNetwork) { + this.brain = brain.copy(); + this.brain.mutate(0.1); + } else { + this.brain = new NeuralNetwork(4, 16, 2); + } + + // Score is how many frames it's been alive + this.score = 0; + // Fitness is normalized version of score + this.fitness = 0; + + // Create a copy of this bird + this.copy = function() { + return new Bird(this.brain); + } + + // Display the bird + this.show = function() { + fill(255, 100); + stroke(255); + ellipse(this.x, this.y, this.r * 2, this.r * 2); + } + + // This is the key function now that decides + // if it should jump or not jump! + this.think = function(pipes) { + // First find the closest pipe + var closest = null; + var record = Infinity; + for (var i = 0; i < pipes.length; i++) { + var diff = pipes[i].x - this.x; + if (diff > 0 && diff < record) { + record = diff; + closest = pipes[i]; + } + } + + if (closest != null) { + // Now create the inputs to the neural network + var inputs = []; + // x position of closest pipe + inputs[0] = map(closest.x, this.x, width, -1, 1); + // top of closest pipe opening + inputs[1] = map(closest.top, 0, height, -1, 1); + // bottom of closest pipe opening + inputs[2] = map(closest.bottom, 0, height, -1, 1); + // bird's y position + inputs[3] = map(this.y, 0, height, -1, 1); + // Get the outputs from the network + var action = this.brain.predict(inputs); + // Decide to jump or not! + if (action[1] > action[0]) { + this.up(); + } + } + } + + // Jump up + this.up = function() { + this.velocity += this.lift; + } + + // Update bird's position based on velocity, gravity, etc. + this.update = function() { + this.velocity += this.gravity; + this.velocity *= 0.9; + this.y += this.velocity; + + // Keep it stuck to top or bottom + if (this.y > height) { + this.y = height; + this.velocity = 0; + } + if (this.y < 0) { + this.y = 0; + this.velocity = 0; + } + + // Every frame it is alive increases the score + this.score++; + } +} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-1/ga.js b/examples/neuroevolution-flappybird-1/ga.js new file mode 100644 index 0000000..8af440b --- /dev/null +++ b/examples/neuroevolution-flappybird-1/ga.js @@ -0,0 +1,83 @@ +// Daniel Shiffman +// Nature of Code: Intelligence and Learning +// https://github.com/shiffman/NOC-S17-2-Intelligence-Learning + +// This flappy bird implementation is adapted from: +// https://youtu.be/cXgA1d_E-jY& + + +// This file includes functions for creating a new generation +// of birds. + +// Start the game over +function resetGame() { + counter = 0; + pipes = []; +} + +// Create the next generation +function nextGeneration() { + resetGame(); + // Normalize the fitness values 0-1 + normalizeFitness(allBirds); + // Generate a new set of birds + activeBirds = generate(allBirds); + // Copy those birds to another array + allBirds = activeBirds.slice(); +} + +// Generate a new population of birds +function generate(oldBirds) { + var newBirds = []; + for (var i = 0; i < oldBirds.length; i++) { + // Select a bird based on fitness + var bird = poolSelection(oldBirds); + newBirds[i] = bird; + } + return newBirds; +} + +// Normalize the fitness of all birds +function normalizeFitness(birds) { + // Make score exponentially better? + for (var i = 0; i < birds.length; i++) { + birds[i].score = pow(birds[i].score, 2); + } + + // Add up all the scores + var sum = 0; + for (var i = 0; i < birds.length; i++) { + sum += birds[i].score; + } + // Divide by the sum + for (var i = 0; i < birds.length; i++) { + birds[i].fitness = birds[i].score / sum; + } +} + + +// An algorithm for picking one bird from an array +// based on fitness +function poolSelection(birds) { + // Start at 0 + var index = 0; + + // Pick a random number between 0 and 1 + var r = random(1); + + // Keep subtracting probabilities until you get less than zero + // Higher probabilities will be more likely to be fixed since they will + // subtract a larger number towards zero + while (r > 0) { + r -= birds[index].fitness; + // And move on to the next + index += 1; + } + + // Go back one + index -= 1; + + // Make sure it's a copy! + // (this includes mutation) + return birds[index].copy(); +} diff --git a/examples/neuroevolution-flappybird-1/index.html b/examples/neuroevolution-flappybird-1/index.html new file mode 100755 index 0000000..8e7acc3 --- /dev/null +++ b/examples/neuroevolution-flappybird-1/index.html @@ -0,0 +1,30 @@ + + + + + + + + + + + + + + + + +
+

+ speed: 1 +
high score: 0 +
all time high score: 0 +

+

+ +

+ + + + + diff --git a/examples/neuroevolution-flappybird-1/libraries/p5.dom.js b/examples/neuroevolution-flappybird-1/libraries/p5.dom.js new file mode 100644 index 0000000..561d300 --- /dev/null +++ b/examples/neuroevolution-flappybird-1/libraries/p5.dom.js @@ -0,0 +1,2190 @@ +/*! p5.dom.js v0.3.2 March 25, 2017 */ +/** + *

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 + * + * 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 + * section for information on how to include this library. p5.dom comes with + * p5 complete or you can download the single file + * + * here.

+ *

See tutorial: beyond the canvas + * for more info on how to use this libary. + * + * @module p5.dom + * @submodule p5.dom + * @for p5.dom + * @main + */ + +(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 +// ============================================================================= + + /** + * 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, + * 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 + * @example + *

+ * function setup() { + * 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 d = document.getElementById('beep'); + * var e = select('p', d); + *
+ * + */ + p5.prototype.select = function (e, p) { + var res = null; + var container = getContainer(p); + if (e[0] === '.'){ + e = e.slice(1); + res = container.getElementsByClassName(e); + if (res.length) { + res = res[0]; + } else { + res = null; + } + }else if (e[0] === '#'){ + e = e.slice(1); + res = container.getElementById(e); + }else { + res = container.getElementsByTagName(e); + if (res.length) { + res = res[0]; + } else { + res = null; + } + } + if (res) { + return wrapElement(res); + } else { + return null; + } + }; + + /** + * 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 + * in an array. + * The DOM node itself can be accessed with .elt. + * Returns an empty array if none found. + * You can also specify a container to search within. + * + * @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 + * @example + *
+ * function setup() { + * createButton('btn'); + * createButton('2nd btn'); + * createButton('3rd btn'); + * var buttons = selectAll('button'); + * + * 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'); + * var d = select('#container'); + * var e = selectAll('p', d); + * var f = document.getElementById('beep'); + * var g = select('.blah', f); + *
+ * + */ + p5.prototype.selectAll = function (e, p) { + var arr = []; + var res; + var container = getContainer(p); + if (e[0] === '.'){ + e = e.slice(1); + res = container.getElementsByClassName(e); + } else { + res = container.getElementsByTagName(e); + } + if (res) { + for (var j = 0; j < res.length; j++) { + var obj = wrapElement(res[j]); + arr.push(obj); + } + } + return arr; + }; + + /** + * Helper function for select and selectAll + */ + function getContainer(p) { + var container = document; + if (typeof p === 'string' && p[0] === '#'){ + p = p.slice(1); + container = document.getElementById(p) || document; + } else if (p instanceof p5.Element){ + container = p.elt; + } else if (p instanceof HTMLElement){ + container = p; + } + return container; + } + + /** + * 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; + }; + return converted; + } else if (elt.tagName === "VIDEO" || elt.tagName === "AUDIO") { + return new p5.MediaElement(elt); + } else { + return new p5.Element(elt); + } + } + + /** + * Removes all elements created by p5, except any canvas / graphics + * elements created by createCanvas or createGraphics. + * Event handlers are removed, and element is removed from the DOM. + * @method removeElements + * @example + *
+ * function setup() { + * createCanvas(100, 100); + * createDiv('this is some text'); + * createP('this is a paragraph'); + * } + * function mousePressed() { + * removeElements(); // this will remove the div and p, not canvas + * } + *
+ * + */ + p5.prototype.removeElements = function (e) { + for (var i=0; i + * var myDiv; + * function setup() { + * myDiv = createDiv('this is some text'); + * } + * + */ + + /** + * Creates a <p></p> element in the DOM with given inner HTML. Used + * for paragraph length text. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createP + * @param {String} html inner HTML for element created + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var myP; + * function setup() { + * myP = createP('this is some text'); + * } + *
+ */ + + /** + * Creates a <span></span> element in the DOM with given inner HTML. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createSpan + * @param {String} html inner HTML for element created + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var mySpan; + * function setup() { + * mySpan = createSpan('this is some text'); + * } + *
+ */ + var tags = ['div', 'p', 'span']; + tags.forEach(function(tag) { + var method = 'create' + tag.charAt(0).toUpperCase() + tag.slice(1); + p5.prototype[method] = function(html) { + var elt = document.createElement(tag); + elt.innerHTML = typeof html === undefined ? "" : html; + return addElement(elt, this); + } + }); + + /** + * Creates an <img> element in the DOM with given src and + * alternate text. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createImg + * @param {String} src src path or url for image + * @param {String} [alt] alternate text to be used if image does not load + * @param {Function} [successCallback] callback to be called once image data is loaded + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var img; + * function setup() { + * img = createImg('http://p5js.org/img/asterisk-01.png'); + * } + *
+ */ + p5.prototype.createImg = function() { + var elt = document.createElement('img'); + var args = arguments; + var self; + var setAttrs = function(){ + self.width = elt.offsetWidth || elt.width; + self.height = elt.offsetHeight || elt.height; + if (args.length > 1 && typeof args[1] === 'function'){ + self.fn = args[1]; + self.fn(); + }else if (args.length > 1 && typeof args[2] === 'function'){ + self.fn = args[2]; + self.fn(); + } + }; + elt.src = args[0]; + if (args.length > 1 && typeof args[1] === 'string'){ + elt.alt = args[1]; + } + elt.onload = function(){ + setAttrs(); + } + self = addElement(elt, this); + return self; + }; + + /** + * Creates an <a></a> element in the DOM for including a hyperlink. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createA + * @param {String} href url of page to link to + * @param {String} html inner html of link element to display + * @param {String} [target] target where new link should open, + * could be _blank, _self, _parent, _top. + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var myLink; + * function setup() { + * myLink = createA('http://p5js.org/', 'this is a link'); + * } + *
+ */ + p5.prototype.createA = function(href, html, target) { + var elt = document.createElement('a'); + elt.href = href; + elt.innerHTML = html; + if (target) elt.target = target; + return addElement(elt, this); + }; + + /** INPUT **/ + + + /** + * Creates a slider <input></input> element in the DOM. + * Use .size() to set the display length of the slider. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createSlider + * @param {Number} min minimum value of the slider + * @param {Number} max maximum value of the slider + * @param {Number} [value] default value of the slider + * @param {Number} [step] 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) + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var slider; + * function setup() { + * slider = createSlider(0, 255, 100); + * slider.position(10, 10); + * slider.style('width', '80px'); + * } + * + * function draw() { + * var val = slider.value(); + * background(val); + * } + *
+ * + *
+ * var slider; + * function setup() { + * colorMode(HSB); + * slider = createSlider(0, 360, 60, 40); + * slider.position(10, 10); + * slider.style('width', '80px'); + * } + * + * function draw() { + * var val = slider.value(); + * background(val, 100, 100, 1); + * } + *
+ */ + p5.prototype.createSlider = function(min, max, value, step) { + var elt = document.createElement('input'); + elt.type = 'range'; + elt.min = min; + elt.max = max; + if (step === 0) { + elt.step = .000000000000000001; // smallest valid step + } else if (step) { + elt.step = step; + } + if (typeof(value) === "number") elt.value = value; + return addElement(elt, this); + }; + + /** + * Creates a <button></button> element in the DOM. + * Use .size() to set the display size of the button. + * Use .mousePressed() to specify behavior on press. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createButton + * @param {String} label label displayed on the button + * @param {String} [value] value of the button + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var button; + * function setup() { + * createCanvas(100, 100); + * background(0); + * button = createButton('click me'); + * button.position(19, 19); + * button.mousePressed(changeBG); + * } + * + * function changeBG() { + * var val = random(255); + * background(val); + * } + *
+ */ + p5.prototype.createButton = function(label, value) { + var elt = document.createElement('button'); + elt.innerHTML = label; + elt.value = value; + if (value) elt.value = value; + return addElement(elt, this); + }; + + /** + * Creates a checkbox <input></input> element in the DOM. + * Calling .checked() on a checkbox returns if it is checked or not + * + * @method createCheckbox + * @param {String} [label] label displayed after checkbox + * @param {boolean} [value] value of the checkbox; checked is true, unchecked is false.Unchecked if no value given + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var checkbox; + * + * function setup() { + * checkbox = createCheckbox('label', false); + * checkbox.changed(myCheckedEvent); + * } + * + * function myCheckedEvent() { + * if (this.checked()) { + * console.log("Checking!"); + * } else { + * console.log("Unchecking!"); + * } + * } + *
+ */ + p5.prototype.createCheckbox = function() { + var elt = document.createElement('div'); + var checkbox = document.createElement('input'); + checkbox.type = 'checkbox'; + elt.appendChild(checkbox); + //checkbox must be wrapped in p5.Element before label so that label appears after + var self = addElement(elt, this); + self.checked = function(){ + var cb = self.elt.getElementsByTagName('input')[0]; + if (cb) { + if (arguments.length === 0){ + return cb.checked; + }else if(arguments[0]){ + cb.checked = true; + }else{ + cb.checked = false; + } + } + return self; + }; + this.value = function(val){ + self.value = val; + return this; + }; + if (arguments[0]){ + var ran = Math.random().toString(36).slice(2); + var label = document.createElement('label'); + checkbox.setAttribute('id', ran); + label.htmlFor = ran; + self.value(arguments[0]); + label.appendChild(document.createTextNode(arguments[0])); + elt.appendChild(label); + } + if (arguments[1]){ + checkbox.checked = true; + } + return self; + }; + + /** + * Creates a dropdown menu <select></select> element in the DOM. + * @method createSelect + * @param {boolean} [multiple] true if dropdown should support multiple selections + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var sel; + * + * function setup() { + * textAlign(CENTER); + * background(200); + * sel = createSelect(); + * sel.position(10, 10); + * sel.option('pear'); + * sel.option('kiwi'); + * sel.option('grape'); + * sel.changed(mySelectEvent); + * } + * + * function mySelectEvent() { + * var item = sel.value(); + * background(200); + * text("it's a "+item+"!", 50, 50); + * } + *
+ */ + p5.prototype.createSelect = function(mult) { + var elt = document.createElement('select'); + if (mult){ + elt.setAttribute('multiple', 'true'); + } + var self = addElement(elt, this); + self.option = function(name, value){ + var opt = document.createElement('option'); + opt.innerHTML = name; + if (arguments.length > 1) + opt.value = value; + else + opt.value = name; + elt.appendChild(opt); + }; + self.selected = function(value){ + var arr = []; + if (arguments.length > 0){ + for (var i = 0; i < this.elt.length; i++){ + if (value.toString() === this.elt[i].value){ + this.elt.selectedIndex = i; + } + } + return this; + }else{ + if (mult){ + for (var i = 0; i < this.elt.selectedOptions.length; i++){ + arr.push(this.elt.selectedOptions[i].value); + } + return arr; + }else{ + return this.elt.value; + } + } + }; + return self; + }; + + /** + * Creates a radio button <input></input> element in the DOM. + * The .option() method can be used to set options for the radio after it is + * created. The .value() method will return the currently selected option. + * + * @method createRadio + * @param {String} [divId] the id and name of the created div and input field respectively + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * var radio; + * + * function setup() { + * radio = createRadio(); + * radio.option("black"); + * radio.option("white"); + * radio.option("gray"); + * radio.style('width', '60px'); + * textAlign(CENTER); + * fill(255, 0, 0); + * } + * + * function draw() { + * var val = radio.value(); + * background(val); + * text(val, width/2, height/2); + * } + *
+ *
+ * var radio; + * + * function setup() { + * radio = createRadio(); + * radio.option('apple', 1); + * radio.option('bread', 2); + * radio.option('juice', 3); + * radio.style('width', '60px'); + * textAlign(CENTER); + * } + * + * function draw() { + * background(200); + * var val = radio.value(); + * if (val) { + * text('item cost is $'+val, width/2, height/2); + * } + * } + *
+ */ + p5.prototype.createRadio = function() { + var radios = document.querySelectorAll("input[type=radio]"); + var count = 0; + if(radios.length > 1){ + var length = radios.length; + var prev=radios[0].name; + var current = radios[1].name; + count = 1; + for(var i = 1; i < length; i++) { + current = radios[i].name; + if(prev != current){ + count++; + } + prev = current; + } + } + else if (radios.length == 1){ + count = 1; + } + var elt = document.createElement('div'); + var self = addElement(elt, this); + var times = -1; + self.option = function(name, value){ + var opt = document.createElement('input'); + opt.type = 'radio'; + opt.innerHTML = name; + if (arguments.length > 1) + opt.value = value; + else + opt.value = name; + opt.setAttribute('name',"defaultradio"+count); + elt.appendChild(opt); + if (name){ + times++; + var ran = Math.random().toString(36).slice(2); + var label = document.createElement('label'); + opt.setAttribute('id', "defaultradio"+count+"-"+times); + label.htmlFor = "defaultradio"+count+"-"+times; + label.appendChild(document.createTextNode(name)); + elt.appendChild(label); + } + return opt; + }; + self.selected = function(){ + var length = this.elt.childNodes.length; + if(arguments.length == 1) { + for (var i = 0; i < length; i+=2){ + if(this.elt.childNodes[i].value == arguments[0]) + this.elt.childNodes[i].checked = true; + } + return this; + } else { + for (var i = 0; i < length; i+=2){ + if(this.elt.childNodes[i].checked == true) + return this.elt.childNodes[i].value; + } + } + }; + self.value = function(){ + var length = this.elt.childNodes.length; + if(arguments.length == 1) { + for (var i = 0; i < length; i+=2){ + if(this.elt.childNodes[i].value == arguments[0]) + this.elt.childNodes[i].checked = true; + } + return this; + } else { + for (var i = 0; i < length; i+=2){ + if(this.elt.childNodes[i].checked == true) + return this.elt.childNodes[i].value; + } + return ""; + } + }; + return self + }; + + /** + * Creates an <input></input> element in the DOM for text input. + * 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} [type] type of text, ie text, password etc. Defaults to text + * @return {Object|p5.Element} pointer to p5.Element holding created node + * @example + *
+ * function setup(){ + * var inp = createInput(''); + * inp.input(myInputEvent); + * } + * + * function myInputEvent(){ + * console.log('you are typing: ', this.value()); + * } + * + *
+ */ + p5.prototype.createInput = function(value, type) { + var elt = document.createElement('input'); + elt.type = type ? type : 'text'; + if (value) elt.value = value; + return addElement(elt, this); + }; + + /** + * Creates an <input></input> element in the DOM of type 'file'. + * This allows users to select local files for use in a sketch. + * + * @method createFileInput + * @param {Function} [callback] callback function for when a file loaded + * @param {String} [multiple] optional to allow multiple files selected + * @return {Object|p5.Element} pointer to p5.Element holding created DOM element + * @example + * var input; + * var img; + * + * function setup() { + * input = createFileInput(handleFile); + * input.position(0, 0); + * } + * + * function draw() { + * if (img) { + * image(img, 0, 0, width, height); + * } + * } + * + * function handleFile(file) { + * print(file); + * if (file.type === 'image') { + * img = createImg(file.data); + * img.hide(); + * } + * } + */ + p5.prototype.createFileInput = function(callback, multiple) { + + // Is the file stuff supported? + if (window.File && window.FileReader && window.FileList && window.Blob) { + // Yup, we're ok and make an input file selector + var elt = document.createElement('input'); + elt.type = 'file'; + + // If we get a second argument that evaluates to true + // then we are looking for multiple files + if (multiple) { + // Anything gets the job done + elt.multiple = 'multiple'; + } + + // Function to handle when a file is selected + // We're simplifying life and assuming that we always + // want to load every selected file + function handleFileSelect(evt) { + // These are the files + var files = evt.target.files; + // Load each one and trigger a callback + for (var i = 0; i < files.length; i++) { + var f = files[i]; + var reader = new FileReader(); + function makeLoader(theFile) { + // Making a p5.File object + var p5file = new p5.File(theFile); + return function(e) { + p5file.data = e.target.result; + callback(p5file); + }; + }; + 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); + } + } + } + + // Now let's handle when a file was selected + elt.addEventListener('change', handleFileSelect, false); + return addElement(elt, this); + } else { + console.log('The File APIs are not fully supported in this browser. Cannot create element.'); + } + }; + + + /** VIDEO STUFF **/ + + function createMedia(pInst, type, src, callback) { + var elt = document.createElement(type); + + // allow src to be empty + var src = src || ''; + if (typeof src === 'string') { + src = [src]; + } + for (var i=0; i function. + * It was invented by Ken Perlin in the 1980s and been used since in + * graphical applications to produce procedural textures, natural motion, + * shapes, terrains etc.

The main difference to the + * random() function is that Perlin noise is defined in an infinite + * n-dimensional space where each pair of coordinates corresponds to a + * fixed semi-random value (fixed only for the lifespan of the program; see + * 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 + * and 3rd dimension can also be interpreted as time.

The actual + * noise is structured similar to an audio signal, in respect to the + * function's use of frequencies. Similar to the concept of harmonics in + * physics, perlin noise is computed over several octaves which are added + * together for the final result.

Another way to adjust the + * character of the resulting sequence is the scale of the input + * coordinates. As the function works within an infinite space the value of + * the coordinates doesn't matter as such, only the distance between + * successive coordinates does (eg. when using noise() within a + * loop). As a general rule the smaller the difference between coordinates, + * the smoother the resulting noise sequence will be. Steps of 0.005-0.03 + * work best for most applications, but this will differ depending on use. + * + * + * @method noise + * @param {Number} x x-coordinate in noise space + * @param {Number} y y-coordinate in noise space + * @param {Number} z z-coordinate in noise space + * @return {Number} Perlin noise value (between 0 and 1) at specified + * coordinates + * @example + *
+ * var xoff = 0.0; + * + * function draw() { + * background(204); + * xoff = xoff + .01; + * var n = noise(xoff) * width; + * line(n, 0, n, height); + * } + * + *
+ *
+ * var noiseScale=0.02; + * + * function draw() { + * background(0); + * for (var x=0; x < width; x++) { + * var noiseVal = noise((mouseX+x)*noiseScale, mouseY*noiseScale); + * stroke(noiseVal*255); + * line(x, mouseY+noiseVal*80, x, height); + * } + * } + * + *
+ * + * @alt + * vertical line moves left to right with updating noise values. + * horizontal wave pattern effected by mouse x-position & updating noise values. + * + */ + +p5.prototype.noise = function(x,y,z) { + y = y || 0; + z = z || 0; + + if (perlin == null) { + perlin = new Array(PERLIN_SIZE + 1); + for (var i = 0; i < PERLIN_SIZE + 1; i++) { + perlin[i] = Math.random(); + } + } + + 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 xf = x - xi; + var yf = y - yi; + var zf = z - zi; + var rxf, ryf; + + var r=0; + var ampl=0.5; + + 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--; } + } + return r; +}; + + +/** + * + * Adjusts the character and level of detail produced by the Perlin noise + * function. Similar to harmonics in physics, noise is computed over + * several octaves. Lower octaves contribute more to the output signal and + * as such define the overall intensity of the noise, whereas higher octaves + * create finer grained details in the noise sequence. + *

+ * By default, noise is computed over 4 octaves with each octave contributing + * exactly half than its predecessor, starting at 50% strength for the 1st + * octave. This falloff amount can be changed by adding an additional function + * parameter. Eg. a falloff factor of 0.75 means each octave will now have + * 75% impact (25% less) of the previous lower octave. Any value between + * 0.0 and 1.0 is valid, however note that values greater than 0.5 might + * result in greater than 1.0 values returned by noise(). + *

+ * By changing these parameters, the signal created by the noise() + * function can be adapted to fit very specific needs and characteristics. + * + * @method noiseDetail + * @param {Number} lod number of octaves to be used by the noise + * @param {Number} falloff falloff factor for each octave + * @example + *
+ * + * + * var noiseVal; + * var noiseScale=0.02; + * + * function setup() { + * 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); + * } + * } + * } + * + *
+ * + * @alt + * 2 vertical grey smokey patterns affected my mouse x-position and noise. + * + */ +p5.prototype.noiseDetail = function(lod, falloff) { + if (lod>0) { perlin_octaves=lod; } + if (falloff>0) { perlin_amp_falloff=falloff; } +}; + +/** + * Sets the seed value for noise(). By default, noise() + * produces different results each time the program is run. Set the + * value parameter to a constant to return the same pseudo-random + * numbers each time the software is run. + * + * @method noiseSeed + * @param {Number} seed the seed value + * @example + *
+ * var xoff = 0.0; + * + * function setup() { + * noiseSeed(99); + * stroke(0, 10); + * } + * + * function draw() { + * xoff = xoff + .01; + * var n = noise(xoff) * width; + * line(n, 0, n, height); + * } + * + *
+ * + * @alt + * vertical grey lines drawing in pattern affected by noise. + * + */ +p5.prototype.noiseSeed = function(seed) { + // Linear Congruential Generator + // Variant of a Lehman Generator + var lcg = (function() { + // 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, + // a - 1 should be divisible by m's prime factors + a = 1664525, + // c and m should be co-prime + c = 1013904223, + seed, z; + return { + 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() { + return seed; + }, + rand : function() { + // define the recurrence relationship + z = (a * z + c) % m; + // return a float in [0, 1) + // if z = m then z / m = 0 therefore (z % m) / m < 1 always + return z / m; + } + }; + }()); + + lcg.setSeed(seed); + perlin = new Array(PERLIN_SIZE + 1); + for (var i = 0; i < PERLIN_SIZE + 1; i++) { + perlin[i] = lcg.rand(); + } +}; + +module.exports = p5; + +},{"../core/core":42}],71:[function(_dereq_,module,exports){ +/** + * @module Math + * @submodule Math + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); +var polarGeometry = _dereq_('./polargeometry'); +var constants = _dereq_('../core/constants'); + +/** + * A class to describe 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. 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(). + *

+ * 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 + * the object's position changes per time unit, expressed as a vector), and + * acceleration (the rate at which the object's velocity changes per time + * unit, expressed as a vector). + *

+ * Since vectors represent groupings of values, we cannot simply use + * traditional addition/multiplication/etc. Instead, we'll need to do some + * "vector" math, which is made easy by the methods inside the 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 + * @example + *
+ * + * var v1 = createVector(40, 50); + * var v2 = createVector(40, 50); + * + * ellipse(v1.x, v1.y, 50, 50); + * ellipse(v2.x, v2.y, 50, 50); + * v1.add(v2); + * ellipse(v1.x, v1.y, 50, 50); + * + *
+ * + * @alt + * 2 white ellipses. One center-left the other bottom right and off canvas + * + */ +p5.Vector = function() { + var x,y,z; + // This is how it comes in with createVector() + 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() + } else { + x = arguments[0] || 0; + y = arguments[1] || 0; + z = arguments[2] || 0; + } + /** + * The x component of the vector + * @property x + * @type {Number} + */ + this.x = x; + /** + * The y component of the vector + * @property y + * @type {Number} + */ + this.y = y; + /** + * The z component of the vector + * @property z + * @type {Number} + */ + this.z = z; +}; + +/** + * Returns a string representation of a vector v by calling String(v) + * or v.toString(). This method is useful for logging vectors in the + * console. + * @method toString + * @example + *
+ * function setup() { + * var v = createVector(20,30); + * print(String(v)); // prints "p5.Vector Object : [20, 30, 0]" + * } + *
+ * + */ +p5.Vector.prototype.toString = function p5VectorToString() { + 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. + * @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 + * @example + *
+ * + * function setup() { + * 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] + * } + * + *
+ */ +p5.Vector.prototype.set = function (x, y, z) { + if (x instanceof p5.Vector) { + this.x = x.x || 0; + this.y = x.y || 0; + this.z = x.z || 0; + return this; + } + if (x instanceof Array) { + this.x = x[0] || 0; + this.y = x[1] || 0; + this.z = x[2] || 0; + return this; + } + this.x = x || 0; + this.y = y || 0; + this.z = z || 0; + return this; +}; + +/** + * Gets a copy of the vector, returns a p5.Vector object. + * + * @method copy + * @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); + * // Prints "true" + * + *
+ */ +p5.Vector.prototype.copy = function () { + if (this.p5) { + return new p5.Vector(this.p5,[this.x, this.y, this.z]); + } else { + 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 + * acts directly on the vector. See the examples for more context. + * + * @method add + * @chainable + * @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 + * @return {p5.Vector} the p5.Vector object. + * @example + *
+ * + * var v = createVector(1, 2, 3); + * v.add(4,5,6); + * // v's components are set to [5, 7, 9] + * + *
+ *
+ * + * // Static method + * var v1 = createVector(1, 2, 3); + * var v2 = createVector(2, 3, 4); + * + * var v3 = p5.Vector.add(v1, v2); + * // v3 has components [3, 5, 7] + * + *
+ */ +p5.Vector.prototype.add = function (x, y, z) { + if (x instanceof p5.Vector) { + this.x += x.x || 0; + this.y += x.y || 0; + this.z += x.z || 0; + return this; + } + if (x instanceof Array) { + this.x += x[0] || 0; + this.y += x[1] || 0; + this.z += x[2] || 0; + return this; + } + this.x += x || 0; + this.y += y || 0; + this.z += z || 0; + return this; +}; + +/** + * 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 + * other acts directly on the vector. See the examples for more context. + * + * @method sub + * @chainable + * @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 + * @return {p5.Vector} p5.Vector object. + * @example + *
+ * + * var v = createVector(4, 5, 6); + * v.sub(1, 1, 1); + * // v's components are set to [3, 4, 5] + * + *
+ * + *
+ * + * // Static method + * var v1 = createVector(2, 3, 4); + * var v2 = createVector(1, 2, 3); + * + * var v3 = p5.Vector.sub(v1, v2); + * // v3 has components [1, 1, 1] + * + *
+ */ +p5.Vector.prototype.sub = function (x, y, z) { + if (x instanceof p5.Vector) { + this.x -= x.x || 0; + this.y -= x.y || 0; + this.z -= x.z || 0; + return this; + } + if (x instanceof Array) { + this.x -= x[0] || 0; + this.y -= x[1] || 0; + this.z -= x[2] || 0; + return this; + } + this.x -= x || 0; + this.y -= y || 0; + this.z -= z || 0; + return this; +}; + +/** + * 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 + * directly. See the examples for more context. + * + * @method mult + * @chainable + * @param {Number} n the number to multiply with the vector + * @return {p5.Vector} a reference to the p5.Vector object (allow chaining) + * @example + *
+ * + * var v = createVector(1, 2, 3); + * v.mult(2); + * // v's components are set to [2, 4, 6] + * + *
+ * + *
+ * + * // Static method + * var v1 = createVector(1, 2, 3); + * var v2 = p5.Vector.mult(v1, 2); + * // v2 has components [2, 4, 6] + * + *
+ */ +p5.Vector.prototype.mult = function (n) { + this.x *= n || 0; + this.y *= n || 0; + this.z *= n || 0; + 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. + * See the examples for more context. + * + * @method div + * @chainable + * @param {number} n the number to divide the vector by + * @return {p5.Vector} a reference to the p5.Vector object (allow chaining) + * @example + *
+ * + * var v = createVector(6, 4, 2); + * v.div(2); //v's components are set to [3, 2, 1] + * + *
+ * + *
+ * + * // Static method + * var v1 = createVector(6, 4, 2); + * var v2 = p5.Vector.div(v, 2); + * // v2 has components [3, 2, 1] + * + *
+ */ +p5.Vector.prototype.div = function (n) { + this.x /= n; + this.y /= n; + this.z /= n; + return this; +}; + +/** + * Calculates the magnitude (length) of the vector and returns the result as + * a float (this is simply the equation sqrt(x*x + y*y + z*z).) + * + * @method mag + * @return {Number} magnitude of the vector + * @example + *
+ * + * var v = createVector(20.0, 30.0, 40.0); + * var m = v.mag(); + * print(m); // Prints "53.85164807134504" + * + *
+ */ +p5.Vector.prototype.mag = function () { + return Math.sqrt(this.magSq()); +}; + +/** + * Calculates the squared magnitude of the vector and returns the result + * as a float (this is simply the equation (x*x + y*y + z*z).) + * Faster if the real length is not required in the + * case of comparing vectors, etc. + * + * @method magSq + * @return {number} squared magnitude of the vector + * @example + *
+ * + * // Static method + * var v1 = createVector(6, 4, 2); + * print(v1.magSq()); // Prints "56" + * + *
+ */ +p5.Vector.prototype.magSq = function () { + var x = this.x, y = this.y, z = this.z; + return (x * x + y * y + z * z); +}; + +/** + * Calculates the dot product of two vectors. The version of the method + * that computes the dot product of two independent vectors is a static + * method. See the examples for more context. + * + * + * @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 + * + * @example + *
+ * + * var v1 = createVector(1, 2, 3); + * var v2 = createVector(2, 3, 4); + * + * print(v1.dot(v2)); // Prints "20" + * + *
+ * + *
+ * + * //Static method + * var v1 = createVector(1, 2, 3); + * var v2 = createVector(3, 2, 1); + * print (p5.Vector.dot(v1, v2)); // Prints "10" + * + *
+ */ +p5.Vector.prototype.dot = function (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); +}; + +/** + * 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. + * 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 + * @example + *
+ * + * var v1 = createVector(1, 2, 3); + * var v2 = createVector(1, 2, 3); + * + * v1.cross(v2); // v's components are [0, 0, 0] + * + *
+ * + *
+ * + * // Static method + * var v1 = createVector(1, 0, 0); + * var v2 = createVector(0, 1, 0); + * + * var crossProduct = p5.Vector.cross(v1, v2); + * // crossProduct has components [0, 0, 1] + * + *
+ */ +p5.Vector.prototype.cross = function (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]); + } else { + return new p5.Vector(x,y,z); + } +}; + +/** + * Calculates the Euclidean distance between two points (considering a + * point as a vector object). + * + * @method dist + * @param {p5.Vector} v the x, y, and z coordinates of a p5.Vector + * @return {Number} the distance + * @example + *
+ * + * var v1 = createVector(1, 0, 0); + * var v2 = createVector(0, 1, 0); + * + * var distance = v1.dist(v2); // distance is 1.4142... + * + *
+ *
+ * + * // Static method + * var v1 = createVector(1, 0, 0); + * var v2 = createVector(0, 1, 0); + * + * var distance = p5.Vector.dist(v1,v2); + * // distance is 1.4142... + * + *
+ */ +p5.Vector.prototype.dist = function (v) { + var d = v.copy().sub(this); + return d.mag(); +}; + +/** + * Normalize the vector to length 1 (make it a unit vector). + * + * @method normalize + * @return {p5.Vector} normalized p5.Vector + * @example + *
+ * + * var v = createVector(10, 20, 2); + * // v has components [10.0, 20.0, 2.0] + * v.normalize(); + * // v's components are set to + * // [0.4454354, 0.8908708, 0.089087084] + * + *
+ * + */ +p5.Vector.prototype.normalize = function () { + return this.mag() === 0 ? this : this.div(this.mag()); +}; + +/** + * Limit the magnitude of this vector to the value used for the max + * parameter. + * + * @method limit + * @param {Number} max the maximum magnitude for the vector + * @return {p5.Vector} the modified p5.Vector + * @example + *
+ * + * var v = createVector(10, 20, 2); + * // v has components [10.0, 20.0, 2.0] + * v.limit(5); + * // v's components are set to + * // [2.2271771, 4.4543543, 0.4454354] + * + *
+ */ +p5.Vector.prototype.limit = function (max) { + var mSq = this.magSq(); + if(mSq > max*max) { + this.div(Math.sqrt(mSq)); //normalize it + this.mult(max); + } + return this; +}; + +/** + * Set the magnitude of this vector to the value used for the len + * parameter. + * + * @method setMag + * @param {number} len the new length for this vector + * @return {p5.Vector} the modified p5.Vector + * @example + *
+ * + * var v = createVector(10, 20, 2); + * // v has components [10.0, 20.0, 2.0] + * v.setMag(10); + * // v's components are set to [6.0, 8.0, 0.0] + * + *
+ */ +p5.Vector.prototype.setMag = function (n) { + return this.normalize().mult(n); +}; + +/** + * Calculate the angle of rotation for this vector (only 2D vectors) + * + * @method heading + * @return {Number} the angle of rotation + * @example + *
+ * function setup() { + * var v1 = createVector(30,50); + * print(v1.heading()); // 1.0303768265243125 + * + * var v1 = createVector(40,50); + * print(v1.heading()); // 0.8960553845713439 + * + * var v1 = createVector(30,70); + * print(v1.heading()); // 1.1659045405098132 + * } + *
+ */ +p5.Vector.prototype.heading = function () { + 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; + } +}; + +/** + * Rotate the vector by an angle (only 2D vectors), magnitude remains the + * same + * + * @method rotate + * @param {number} angle the angle of rotation + * @return {p5.Vector} the modified p5.Vector + * @example + *
+ * + * var v = createVector(10.0, 20.0); + * // v has components [10.0, 20.0, 0.0] + * v.rotate(HALF_PI); + * // v's components are set to [-20.0, 9.999999, 0.0] + * + *
+ */ +p5.Vector.prototype.rotate = function (a) { + var newHeading = this.heading() + a; + if (this.p5) { + if (this.p5._angleMode === constants.DEGREES) { + newHeading = polarGeometry.degreesToRadians(newHeading); + } + } + var mag = this.mag(); + this.x = Math.cos(newHeading) * mag; + this.y = Math.sin(newHeading) * mag; + return this; +}; + +/** + * Linear interpolate the vector to another vector + * + * @method lerp + * @param {p5.Vector} x the x component or the p5.Vector to lerp to + * @param {p5.Vector} [y] y the y component + * @param {p5.Vector} [z] z the z component + * @param {Number} amt the amount of interpolation; some value between 0.0 + * (old vector) and 1.0 (new vector). 0.1 is very near + * the new vector. 0.5 is halfway in between. + * @return {p5.Vector} the modified p5.Vector + * @example + *
+ * + * var v = createVector(1, 1, 0); + * + * v.lerp(3, 3, 0, 0.5); // v now has components [2,2,0] + * + *
+ * + *
+ * + * var v1 = createVector(0, 0, 0); + * var v2 = createVector(100, 100, 0); + * + * var v3 = p5.Vector.lerp(v1, v2, 0.5); + * // v3 has components [50,50,0] + * + *
+ */ +p5.Vector.prototype.lerp = function (x, y, z, amt) { + if (x instanceof p5.Vector) { + return this.lerp(x.x, x.y, x.z, y); + } + this.x += (x - this.x) * amt || 0; + this.y += (y - this.y) * amt || 0; + this.z += (z - this.z) * amt || 0; + return this; +}; + +/** + * 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 + * array. + * + * @method array + * @return {Array} an Array with the 3 values + * @example + *
+ * function setup() { + * var v = createVector(20,30); + * print(v.array()); // Prints : Array [20, 30, 0] + * } + *
+ *
+ * + * var v = createVector(10.0, 20.0, 30.0); + * var f = v.array(); + * print(f[0]); // Prints "10.0" + * print(f[1]); // Prints "20.0" + * print(f[2]); // Prints "30.0" + * + *
+ */ +p5.Vector.prototype.array = function () { + return [this.x || 0, this.y || 0, this.z || 0]; +}; + +/** + * 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 + * @return {Boolean} whether the vectors are equals + * @example + *
+ * v1 = createVector(5,10,20); + * v2 = createVector(5,10,20); + * 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 + *
+ *
+ * + * 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 + * + *
+ */ +p5.Vector.prototype.equals = function (x, y, z) { + var a, b, c; + if (x instanceof p5.Vector) { + a = x.x || 0; + b = x.y || 0; + c = x.z || 0; + } else if (x instanceof Array) { + a = x[0] || 0; + b = x[1] || 0; + c = x[2] || 0; + } else { + a = x || 0; + b = y || 0; + c = z || 0; + } + return this.x === a && this.y === b && this.z === c; +}; + + +// Static Methods + + +/** + * Make a new 2D unit vector from an angle + * + * @method fromAngle + * @static + * @param {Number} angle the desired angle + * @return {p5.Vector} the new p5.Vector object + * @example + *
+ * + * function draw() { + * 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); + * + * // 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" + * noStroke(); + * 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 vx = v.x; + * var vy = v.y; + * + * push(); + * translate (width/2, height/2); + * noFill(); + * stroke (150); + * line (0,0, 30,0); + * stroke (0); + * line (0,0, 30*vx, 30*vy); + * pop() + * } + * + *
+ */ +p5.Vector.fromAngle = function(angle) { + if (this.p5) { + if (this.p5._angleMode === constants.DEGREES) { + angle = polarGeometry.degreesToRadians(angle); + } + } + 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); + } +}; + +/** + * Make a new 2D unit vector from a random angle + * + * @method random2D + * @static + * @return {p5.Vector} the new p5.Vector object + * @example + *
+ * + * var v = p5.Vector.random2D(); + * // May make v's attributes something like: + * // [0.61554617, -0.51195765, 0.0] or + * // [-0.4695841, -0.14366731, 0.0] or + * // [0.6091097, -0.22805278, 0.0] + * + *
+ */ +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); +}; + +/** + * Make a new random 3D unit vector. + * + * @method random3D + * @static + * @return {p5.Vector} the new p5.Vector object + * @example + *
+ * + * var v = p5.Vector.random3D(); + * // May make v's attributes something like: + * // [0.61554617, -0.51195765, 0.599168] or + * // [-0.4695841, -0.14366731, -0.8711202] or + * // [0.6091097, -0.22805278, -0.7595902] + * + *
+ */ +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); + } +}; + + +/** + * Adds two vectors together and returns a new one. + * + * @static + * @param {p5.Vector} v1 a p5.Vector to add + * @param {p5.Vector} v2 a p5.Vector to add + * @param {p5.Vector} target if undefined a new vector will be created + * @return {p5.Vector} the resulting p5.Vector + * + */ + +p5.Vector.add = function (v1, v2, target) { + if (!target) { + target = v1.copy(); + } else { + target.set(v1); + } + target.add(v2); + return target; +}; + +/** + * 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. + * + * @static + * @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 + * @return {p5.Vector} the resulting p5.Vector + */ + +p5.Vector.sub = function (v1, v2, target) { + if (!target) { + target = v1.copy(); + } else { + target.set(v1); + } + target.sub(v2); + return target; +}; + + +/** + * Multiplies a vector by a scalar and returns a new vector. + * + * @static + * @param {p5.Vector} v the p5.Vector to multiply + * @param {Number} n the scalar + * @param {p5.Vector} target if undefined a new vector will be created + * @return {p5.Vector} the resulting new p5.Vector + */ +p5.Vector.mult = function (v, n, target) { + if (!target) { + target = v.copy(); + } else { + target.set(v); + } + target.mult(n); + return target; +}; + +/** + * Divides a vector by a scalar and returns a new vector. + * + * @static + * @param {p5.Vector} v the p5.Vector to divide + * @param {Number} n the scalar + * @param {p5.Vector} target if undefined a new vector will be created + * @return {p5.Vector} the resulting new p5.Vector + */ +p5.Vector.div = function (v, n, target) { + if (!target) { + target = v.copy(); + } else { + target.set(v); + } + target.div(n); + return target; +}; + + +/** + * Calculates the dot product of two vectors. + * + * @static + * @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) { + return v1.dot(v2); +}; + +/** + * Calculates the cross product of two vectors. + * + * @static + * @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) { + return v1.cross(v2); +}; + +/** + * Calculates the Euclidean distance between two points (considering a + * point as a vector object). + * + * @static + * @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) { + return v1.dist(v2); +}; + +/** + * Linear interpolate a vector to another vector and return the result as a + * new vector. + * + * @static + * @param {p5.Vector} v1 a starting p5.Vector + * @param {p5.Vector} v2 the p5.Vector to lerp to + * @param {Number} the amount of interpolation; some value between 0.0 + * (old vector) and 1.0 (new vector). 0.1 is very near + * the new vector. 0.5 is halfway in between. + */ +p5.Vector.lerp = function (v1, v2, amt, target) { + if (!target) { + target = v1.copy(); + } else { + target.set(v1); + } + target.lerp(v2, amt); + return target; +}; + +/** + * Calculates and returns the angle (in radians) between two vectors. + * @method angleBetween + * @static + * @param {p5.Vector} v1 the x, y, and z components of a p5.Vector + * @param {p5.Vector} v2 the x, y, and z components of a p5.Vector + * @return {Number} the angle between (in radians) + * @example + *
+ * + * var v1 = createVector(1, 0, 0); + * var v2 = createVector(0, 1, 0); + * + * var angle = p5.Vector.angleBetween(v1, v2); + * // angle is PI/2 + * + *
+ */ +p5.Vector.angleBetween = function (v1, v2) { + var angle = Math.acos(v1.dot(v2) / (v1.mag() * v2.mag())); + if (this.p5) { + if (this.p5._angleMode === constants.DEGREES) { + angle = polarGeometry.radiansToDegrees(angle); + } + } + return angle; +}; + +/** + * @static + */ +p5.Vector.mag = function (vecT){ + var x = vecT.x, + y = vecT.y, + z = vecT.z; + var magSq = x * x + y * y + z * z; + return Math.sqrt(magSq); +}; + +module.exports = p5.Vector; + +},{"../core/constants":41,"../core/core":42,"./polargeometry":72}],72:[function(_dereq_,module,exports){ + +module.exports = { + + degreesToRadians: function(x) { + return 2 * Math.PI * x / 360; + }, + + radiansToDegrees: function(x) { + return 360 * x / (2 * Math.PI); + } + +}; + +},{}],73:[function(_dereq_,module,exports){ +/** + * @module Math + * @submodule Random + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +var seeded = false; +var previous = false; +var y2 = 0; + +// Linear Congruential Generator +// Variant of a Lehman Generator +var lcg = (function() { + // 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, + // a - 1 should be divisible by m's prime factors + a = 1664525, + // c and m should be co-prime + c = 1013904223, + seed, z; + return { + 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() { + return seed; + }, + rand : function() { + // define the recurrence relationship + z = (a * z + c) % m; + // return a float in [0, 1) + // if z = m then z / m = 0 therefore (z % m) / m < 1 always + return z / m; + } + }; +}()); + +/** + * Sets the seed value for random(). + * + * 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. + * + * @method randomSeed + * @param {Number} seed the seed value + * @example + *
+ * + * randomSeed(99); + * for (var i=0; i < 100; i++) { + * var r = random(0, 255); + * stroke(r); + * line(i, 0, i, 100); + * } + * + *
+ * + * @alt + * many vertical lines drawn in white, black or grey. + * + */ +p5.prototype.randomSeed = function(seed) { + lcg.setSeed(seed); + seeded = true; + previous = false; +}; + +/** + * Return a random floating-point number. + * + * Takes either 0, 1 or 2 arguments. + * + * If no argument is given, returns a random number from 0 + * up to (but not including) 1. + * + * If one argument is given and it is a number, returns a random number from 0 + * up to (but not including) the number. + * + * If one argument is given and it is an array, returns a random element from + * that array. + * + * If two arguments are given, returns a random number from the + * first argument up to (but not including) the second argument. + * + * @method random + * @param {Number} [min] the lower bound (inclusive) + * @param {Number} [max] the upper bound (exclusive) + * @return {Number} the random number + * @example + *
+ * + * for (var i = 0; i < 100; i++) { + * var r = random(50); + * stroke(r*5); + * line(50, i, 50+r, i); + * } + * + *
+ *
+ * + * for (var i = 0; i < 100; i++) { + * var r = random(-50, 50); + * 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 + * + *
+ * + * @alt + * 100 horizontal lines from center canvas to right. size+fill change each time + * 100 horizontal lines from center of canvas. height & side change each render + * word displayed at random. Either apple, bear, cat, or dog + * + */ +/** + * @method random + * @param {Array} choices the array to choose from + * @return {*} the random element from the array + * @example + */ +p5.prototype.random = function (min, max) { + + var rand; + + if (seeded) { + rand = lcg.rand(); + } else { + rand = Math.random(); + } + if (typeof min === 'undefined') { + return rand; + } else + if (typeof max === 'undefined') { + if (min instanceof Array) { + return min[Math.floor(rand * min.length)]; + } else { + return rand * min; + } + } else { + if (min > max) { + var tmp = min; + min = max; + max = tmp; + } + + 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 + * 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. + *

+ * Takes either 0, 1 or 2 arguments.
+ * If no args, returns a mean of 0 and standard deviation of 1.
+ * If one arg, that arg is the mean (standard deviation is 1).
+ * If two args, first is mean, second is standard deviation. + * + * @method randomGaussian + * @param {Number} mean the mean + * @param {Number} sd the standard deviation + * @return {Number} the random number + * @example + *
+ * 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); + * } + *} + * + *
+ * @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; + if (previous) { + y1 = y2; + previous = false; + } else { + do { + x1 = this.random(2) - 1; + x2 = this.random(2) - 1; + w = x1 * x1 + x2 * x2; + } while (w >= 1); + w = Math.sqrt((-2 * Math.log(w))/w); + y1 = x1 * w; + y2 = x2 * w; + previous = true; + } + + var m = mean || 0; + var s = sd || 1; + return y1*s + m; +}; + +module.exports = p5; + +},{"../core/core":42}],74:[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 constants = _dereq_('../core/constants'); + +p5.prototype._angleMode = constants.RADIANS; + +/** + * 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). + * + * @method acos + * @param {Number} value the value whose arc cosine is to be returned + * @return {Number} the arc cosine of the given value + * + * @example + *
+ * + * var a = PI; + * var c = cos(a); + * var ac = acos(c); + * // Prints: "3.1415927 : -1.0 : 3.1415927" + * print(a + " : " + c + " : " + ac); + * + *
+ * + *
+ * + * 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); + * + *
+ */ +p5.prototype.acos = function(ratio) { + if (this._angleMode === constants.RADIANS) { + return Math.acos(ratio); + } else { + return polarGeometry.radiansToDegrees(Math.acos(ratio)); + } +}; + +/** + * 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. + * + * @method asin + * @param {Number} value the value whose arc sine is to be returned + * @return {Number} the arc sine of the given value + * + * @example + *
+ * + * var a = PI + PI/3; + * var s = sin(a); + * var as = asin(s); + * // Prints: "1.0471976 : 0.86602545 : 1.0471976" + * print(a + " : " + s + " : " + as); + * + *
+ * + *
+ * + * 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); + * + *
+ * + */ +p5.prototype.asin = function(ratio) { + if (this._angleMode === constants.RADIANS) { + return Math.asin(ratio); + } else { + return polarGeometry.radiansToDegrees(Math.asin(ratio)); + } +}; + +/** + * 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. + * + * @method atan + * @param {Number} value the value whose arc tangent is to be returned + * @return {Number} the arc tangent of the given value + * + * @example + *
+ * + * var a = PI + PI/3; + * var t = tan(a); + * var at = atan(t); + * // Prints: "1.0471976 : 1.7320509 : 1.0471976" + * print(a + " : " + t + " : " + at); + * + *
+ * + *
+ * + * 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); + * + *
+ * + */ +p5.prototype.atan = function(ratio) { + if (this._angleMode === constants.RADIANS) { + return Math.atan(ratio); + } else { + return polarGeometry.radiansToDegrees(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 + * for orienting geometry to the position of the cursor. + *

+ * Note: The y-coordinate of the point is the first parameter, and the + * x-coordinate is the second parameter, due the the structure of calculating + * the tangent. + * + * @method atan2 + * @param {Number} y y-coordinate of the point + * @param {Number} x x-coordinate of the point + * @return {Number} the arc tangent of the given point + * + * @example + *
+ * + * function draw() { + * background(204); + * translate(width/2, height/2); + * var a = atan2(mouseY-height/2, mouseX-width/2); + * rotate(a); + * rect(-30, -5, 60, 10); + * } + * + *
+ * + * @alt + * 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)); + } +}; + +/** + * Calculates the cosine of an angle. This function takes into account the + * current angleMode. Values are returned in the range -1 to 1. + * + * @method cos + * @param {Number} angle the angle + * @return {Number} the cosine of the angle + * + * @example + *
+ * + * var a = 0.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); + * a = a + inc; + * } + * + *
+ * + * @alt + * vertical black lines form wave patterns, extend-down on left and right side + * + */ +p5.prototype.cos = function(angle) { + if (this._angleMode === constants.RADIANS) { + return Math.cos(angle); + } else { + return Math.cos(this.radians(angle)); + } +}; + +/** + * Calculates the sine of an angle. This function takes into account the + * current angleMode. Values are returned in the range -1 to 1. + * + * @method sin + * @param {Number} angle the angle + * @return {Number} the sine of the angle + * + * @example + *
+ * + * var a = 0.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); + * a = a + inc; + * } + * + *
+ * + * @alt + * vertical black lines extend down and up from center to form wave pattern + * + */ +p5.prototype.sin = function(angle) { + if (this._angleMode === constants.RADIANS) { + return Math.sin(angle); + } else { + return Math.sin(this.radians(angle)); + } +}; + +/** + * Calculates the tangent of an angle. This function takes into account + * the current angleMode. Values are returned in the range -1 to 1. + * + * @method tan + * @param {Number} angle the angle + * @return {Number} the tangent of the 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; + * } + * + * + * + * @alt + * vertical black lines end down and up from center to form spike pattern + * + */ +p5.prototype.tan = function(angle) { + if (this._angleMode === constants.RADIANS) { + return Math.tan(angle); + } else { + return Math.tan(this.radians(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. + * + * @method degrees + * @param {Number} radians the radians value to convert to degrees + * @return {Number} the converted angle + * + * + * @example + *
+ * + * var rad = PI/4; + * var deg = degrees(rad); + * print(rad + " radians is " + deg + " degrees"); + * // Prints: 0.7853981633974483 radians is 45 degrees + * + *
+ * + */ +p5.prototype.degrees = function(angle) { + return polarGeometry.radiansToDegrees(angle); +}; + +/** + * 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. + * + * @method radians + * @param {Number} degrees the degree value to convert to radians + * @return {Number} the converted angle + * + * @example + *
+ * + * var deg = 45.0; + * var rad = radians(deg); + * print(deg + " degrees is " + rad + " radians"); + * // Prints: 45 degrees is 0.7853981633974483 radians + * + *
+ */ +p5.prototype.radians = function(angle) { + return polarGeometry.degreesToRadians(angle); +}; + +/** + * Sets the current mode of p5 to given mode. Default mode is RADIANS. + * + * @method angleMode + * @param {Constant} mode either RADIANS or DEGREES + * + * @example + *
+ * + * 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); + * push(); + * rotate(a); + * rect(-20, -5, 40, 10); // Larger rectangle is rotating in degrees + * pop(); + * angleMode(RADIANS); // Change the mode to RADIANS + * rotate(a); // var a stays the same + * rect(-40, -5, 20, 10); // Smaller rectangle is rotating in radians + * } + * + *
+ * + * @alt + * 40 by 10 rect in center rotates with mouse moves. 20 by 10 rect moves faster. + * + * + */ +p5.prototype.angleMode = function(mode) { + if (mode === constants.DEGREES || mode === constants.RADIANS) { + this._angleMode = mode; + } +}; + +module.exports = p5; + +},{"../core/constants":41,"../core/core":42,"./polargeometry":72}],75:[function(_dereq_,module,exports){ +/** + * @module Typography + * @submodule Attributes + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +/** + * Sets the current alignment for drawing text. Accepts two + * arguments: horizAlign (LEFT, CENTER, or RIGHT) and + * 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 + * 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 + * 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. + * + * @method textAlign + * @param {Constant} horizAlign horizontal alignment, either LEFT, + * CENTER, or RIGHT + * @param {Constant} vertAlign vertical alignment, either TOP, + * BOTTOM, CENTER, or BASELINE + * @return {Number} + * @example + *
+ * + * textSize(16); + * textAlign(RIGHT); + * text("ABCD", 50, 30); + * textAlign(CENTER); + * text("EFGH", 50, 50); + * textAlign(LEFT); + * text("IJKL", 50, 70); + * + *
+ * + * @alt + *Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left. + * + */ +p5.prototype.textAlign = function(horizAlign, vertAlign) { + 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. + * + * @method textLeading + * @param {Number} leading the size in pixels for spacing between lines + * @return {Object|Number} + * @example + *
+ * + * // Text to display. The "\n" is a "new line" character + * lines = "L1\nL2\nL3"; + * textSize(12); + * + * textLeading(10); // Set leading to 10 + * text(lines, 10, 25); + * + * textLeading(20); // Set leading to 20 + * text(lines, 40, 25); + * + * textLeading(30); // Set leading to 30 + * text(lines, 70, 25); + * + *
+ * + * @alt + *set L1 L2 & L3 displayed vertically 3 times. spacing increases for each set + * + */ +p5.prototype.textLeading = function(theLeading) { + 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. + * + * @method textSize + * @param {Number} theSize the size of the letters in units of pixels + * @return {Object|Number} + * @example + *
+ * + * textSize(12); + * text("Font Size 12", 10, 30); + * textSize(14); + * text("Font Size 14", 10, 60); + * textSize(16); + * text("Font Size 16", 10, 90); + * + *
+ * + * @alt + *Font Size 12 displayed small, Font Size 14 medium & Font Size 16 large + * + */ +p5.prototype.textSize = function(theSize) { + return this._renderer.textSize.apply(this._renderer, arguments); +}; + +/** + * Sets/gets the style of the text for system fonts to NORMAL, ITALIC, or BOLD. + * Note: this may be is overridden by CSS styling. For non-system fonts + * (opentype, truetype, etc.) please load styled fonts instead. + * + * @method textStyle + * @param {Number|Constant} theStyle styling for text, either NORMAL, + * ITALIC, or BOLD + * @return {Object|String} + * @example + *
+ * + * strokeWeight(0); + * textSize(12); + * textStyle(NORMAL); + * text("Font Style Normal", 10, 30); + * textStyle(ITALIC); + * text("Font Style Italic", 10, 60); + * textStyle(BOLD); + * text("Font Style Bold", 10, 90); + * + *
+ * + * @alt + *words Font Style Normal displayed normally, Italic in italic and bold in bold + * + */ +p5.prototype.textStyle = function(theStyle) { + return this._renderer.textStyle.apply(this._renderer, arguments); +}; + +/** + * Calculates and returns the width of any character or text string. + * + * @method textWidth + * @param {String} theText the String of characters to measure + * @return {Number} + * @example + *
+ * + * textSize(28); + * + * var aChar = 'P'; + * var cWidth = textWidth(aChar); + * text(aChar, 0, 40); + * line(cWidth, 0, cWidth, 50); + * + * var aString = "p5.js"; + * var sWidth = textWidth(aString); + * text(aString, 0, 85); + * line(sWidth, 50, sWidth, 100); + * + *
+ * + * @alt + *Letter P and p5.js are displayed with vertical lines at end. P is wide + * + */ +p5.prototype.textWidth = function(theText) { + if (theText.length === 0) { + return 0; + } + return this._renderer.textWidth.apply(this._renderer, arguments); +}; + +/** + * Returns the ascent of the current font at its current size. The ascent + * represents the distance, in pixels, of the tallest character above + * the baseline. + * + * @return {Number} + * @example + *
+ * + * 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 + * line(0, base - asc, width, base - asc); + * text("dp", 0, base); // Draw text on baseline + * + * 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 + * + *
+ */ +p5.prototype.textAscent = function() { + return this._renderer.textAscent(); +}; + +/** + * Returns the descent of the current font at its current size. The descent + * represents the distance, in pixels, of the character with the longest + * descender below the baseline. + * + * @return {Number} + * @example + *
+ * + * 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(64); // Increase text size + * desc = textDescent() * scalar; // Recalc ascent + * line(40, base + desc, width, base + desc); + * text("dp", 40, base); // Draw text on baseline + * + *
+ */ +p5.prototype.textDescent = function() { + return this._renderer.textDescent(); +}; + +/** + * Helper function to measure ascent and descent. + */ +p5.prototype._updateTextMetrics = function() { + return this._renderer._updateTextMetrics(); +}; + +module.exports = p5; + +},{"../core/core":42}],76:[function(_dereq_,module,exports){ +/** + * @module Typography + * @submodule Loading & Displaying + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); +var constants = _dereq_('../core/constants'); + +_dereq_('../core/error_helpers'); + + +/** + * 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() + * functions. + *

+ * 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 + * does not fit completely within the rectangle specified will not be drawn + * to the screen. + * + * @method text + * @param {String} 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 + * @param {Number} y2 by default, the height of the text box, + * see rectMode() for more info + * @return {Object} this + * @example + *
+ * + * textSize(32); + * text("word", 10, 30); + * fill(0, 102, 153); + * text("word", 10, 60); + * fill(0, 102, 153, 51); + * text("word", 10, 90); + * + *
+ *
+ * + * s = "The quick brown fox jumped over the lazy dog."; + * fill(50); + * text(s, 10, 10, 70, 80); // Text wraps within text box + * + *
+ * + * @alt + *'word' displayed 3 times going from black, blue to translucent blue + * The quick brown fox jumped over the lazy dog. + * + */ +p5.prototype.text = function(str, x, y, maxWidth, maxHeight) { + 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. + * + * @method textFont + * @param {Object|String} f a font loaded via loadFont(), or a String + * representing a web safe font (a font + * that is generally available across all systems). + * @return {Object} this + * @example + *
+ * + * fill(0); + * textSize(12); + * 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"); + * } + * 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); + * } + * + *
+ * + * @alt + *words Font Style Normal displayed normally, Italic in italic and bold in bold + * + */ +p5.prototype.textFont = function(theFont, theSize) { + + if (arguments.length) { + + if (!theFont) { + + throw 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); + } + + return this._renderer._applyTextProperties(); + } + + return this; +}; + +module.exports = p5; + +},{"../core/constants":41,"../core/core":42,"../core/error_helpers":45}],77:[function(_dereq_,module,exports){ +/** + * This module defines the p5.Font class and functions for + * drawing text to the display canvas. + * @module Typography + * @submodule Font + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); +var constants = _dereq_('../core/constants'); + +/* + * TODO: + * + * API: + * -- textBounds() + * -- getPath() + * -- getPoints() + * + * =========================================== + * -- PFont functions: + * PFont.list() + * + * -- kerning + * -- alignment: justified? + * -- integrate p5.dom? (later) + */ + +/** + * Base class for font handling + * @class p5.Font + * @constructor + * @param {Object} [pInst] pointer to p5 instance + */ +p5.Font = function(p) { + + this.parent = p; + + this.cache = {}; + + /** + * Underlying opentype font implementation + * @property font + */ + this.font = undefined; +}; + +p5.Font.prototype.list = function() { + + // TODO + throw 'not yet implemented'; +}; + +/** + * Returns a tight bounding box for the given text string using this + * font (currently only supports single lines) + * + * @method textBounds + * @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) + * + * @return {Object} a rectangle object with properties: x, y, w, h + * + * @example + *
+ * + * var font; + * var textString = 'Lorem ipsum dolor sit amet.'; + * function preload() { + * 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); + * }; + * + *
+ * + * @alt + *words Lorem ipsum dol go off canvas and contained by white bounding box + * + */ +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; + + // 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 result = this.cache[cacheKey('textBounds', str, x, y, fontSize, alignment, + baseline)]; + + if (!result) { + + var xCoords = [], yCoords = [], self = this, + scale = this._scale(fontSize), minX, minY, maxX, maxY; + + this.font.forEachGlyph(str, x, y, fontSize, options, + function(glyph, gX, gY, gFontSize) { + + xCoords.push(gX); + yCoords.push(gY); + + var gm = glyph.getMetrics(); + + if (glyph.name !== 'space' && glyph.unicode !== 32) { + + xCoords.push(gX + (gm.xMax * scale)); + yCoords.push(gY + (-gm.yMin * scale)); + yCoords.push(gY + (-gm.yMax * scale)); + + } else { // NOTE: deals with broken metrics for spaces in opentype.js + + xCoords.push(gX + self.font.charToGlyph(' ').advanceWidth * + self._scale(fontSize)); + } + }); + + // fix to #1409 (not sure why these max() functions were here) + /*minX = Math.max(0, Math.min.apply(null, xCoords)); + minY = Math.max(0, Math.min.apply(null, yCoords)); + maxX = Math.max(0, Math.max.apply(null, xCoords)); + maxY = Math.max(0, Math.max.apply(null, yCoords));*/ + minX = Math.min.apply(null, xCoords); + minY = Math.min.apply(null, yCoords); + maxX = Math.max.apply(null, xCoords); + maxY = Math.max.apply(null, yCoords); + + result = { + x: minX, + y: minY, + h: maxY - minY, + w: maxX - minX, + advance: minX - x + }; + + // Bounds are now calculated, so shift the x & y to match alignment settings + var textWidth = result.w + result.advance; + var pos = this._handleAlignment(p, ctx, str, result.x, result.y, textWidth); + result.x = pos.x; + result.y = pos.y; + + this.cache[cacheKey('textBounds', str, x, y, fontSize, alignment, + baseline)] = result; + } + //else console.log('cache-hit'); + + return result; +}; + + +/** + * Computes an array of points following the path for specified text + * + * @param {String} txt 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 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 + * more precise + * + *
simplifyThreshold - if set to a non-zero value, collinear points will be + * be removed from the polygon; the value represents the threshold angle to use + * when determining whether two edges are collinear + * + * @return {Array} an array of points, each with x, y, alpha (the path angle) + */ +p5.Font.prototype.textToPoints = function(txt, x, y, fontSize, options) { + + var xoff = 0, result = [], glyphs = this._getGlyphs(txt); + + fontSize = fontSize || this.parent._renderer._textSize; + + for (var i = 0; i < glyphs.length; i++) { + + if (glyphs[i].name !== 'space') { // fix to #1817 + + 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++) { + pts[k].x += xoff; + result.push(pts[k]); + } + } + } + + xoff += glyphs[i].advanceWidth * this._scale(fontSize); + } + + return result; +}; + +// ----------------------------- End API ------------------------------ + +/** + * Returns the set of opentype glyphs for the supplied string. + * + * Note that there is not a 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} 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. + * + * @param {String} line a line of text + * @param {Number} x x-position + * @param {Number} y y-position + * @param {Object} options opentype options (optional) + * @return {Object} the opentype path + */ +p5.Font.prototype._getPath = function(line, x, y, options) { + + 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); +}; + +/* + * Creates an SVG-formatted path-data string + * (See http://www.w3.org/TR/SVG/paths.html#PathData) + * from the given opentype path or string/position + * + * @param {Object} path an opentype path, OR the following: + * + * @param {String} line a line of text + * @param {Number} x x-position + * @param {Number} y y-position + * @param {Object} options opentype options (optional), set options.decimals + * to set the decimal precision of the path-data + * + * @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') { + + options = x; + } + + // handle svg arguments + if (options && typeof options.decimals === 'number') { + + decimals = options.decimals; + } + + return line.toPathData(decimals); +}; + +/* + * Creates an SVG element, as a string, + * from the given opentype path or string/position + * + * @param {Object} path an opentype path, OR the following: + * + * @param {String} line a line of text + * @param {Number} x x-position + * @param {Number} y y-position + * @param {Object} options opentype options (optional), set options.decimals + * to set the decimal precision of the path-data in the element, + * options.fill to set the fill color for the element, + * options.stroke to set the stroke color for the element, + * options.strokeWidth to set the strokeWidth for the element. + * + * @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') { + + options = x; + } + + // handle svg arguments + if (options) { + if (typeof options.decimals === 'number') { + decimals = options.decimals; + } + if (typeof options.strokeWidth === 'number') { + line.strokeWidth = options.strokeWidth; + } + if (typeof options.fill !== 'undefined') { + line.fill = options.fill; + } + if (typeof options.stroke !== 'undefined') { + line.stroke = options.stroke; + } + } + + return line.toSVG(decimals); +}; + +/* + * Renders an opentype path or string/position + * to the current graphics context + * + * @param {Object} path an opentype path, OR the following: + * + * @param {String} line a line of text + * @param {Number} x x-position + * @param {Number} y y-position + * @param {Object} options opentype options (optional) + * + * @return {Object} this p5.Font object + */ +p5.Font.prototype._renderPath = function(line, x, y, options) { + + 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); + } 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(); + } + } + + // 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 + ctx.fillStyle = pg._fillSet ? ctx.fillStyle : constants._DEFAULT_TEXT_FILL; + ctx.fill(); + } + + return this; +}; + +p5.Font.prototype._textWidth = function(str, fontSize) { + + if (str === ' ') { // special case for now + + return this.font.charToGlyph(' ').advanceWidth * this._scale(fontSize); + } + + var bounds = this.textBounds(str, 0, 0, fontSize); + return bounds.w + bounds.advance; +}; + +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); +}; + +p5.Font.prototype._handleAlignment = function(p, ctx, line, x, y, textWidth) { + var fontSize = p._renderer._textSize, + textAscent = this._textAscent(fontSize), + textDescent = this._textDescent(fontSize); + + textWidth = textWidth !== undefined ? textWidth : + this._textWidth(line, fontSize); + + if (ctx.textAlign === constants.CENTER) { + x -= textWidth / 2; + } else if (ctx.textAlign === constants.RIGHT) { + x -= textWidth; + } + + 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; + } + + return { x: x, y: y }; +}; + +// path-utils + +function pathToPoints(cmds, options) { + + var opts = parseOpts(options, { + sampleFactor: 0.1, + simplifyThreshold: 0, + }); + + var len = pointAtLength(cmds,0,1), // total-length + t = len / (len * opts.sampleFactor), + pts = []; + + for (var i = 0; i < len; i += t) { + pts.push(pointAtLength(cmds, i)); + } + + if (opts.simplifyThreshold) { + /*var count = */simplify(pts, opts.simplifyThreshold); + //console.log('Simplify: removed ' + count + ' pts'); + } + + return pts; +} + +function simplify(pts, 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++; + } + } + return num; +} + +function splitPaths(cmds) { + + var paths = [], current; + for (var i = 0; i < cmds.length; i++) { + if (cmds[i].type === 'M') { + if (current) { + paths.push(current); + } + current = []; + } + current.push(cmdToArr(cmds[i])); + } + paths.push(current); + + return paths; +} + +function cmdToArr(cmd) { + + 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); + } else if (cmd.type === 'Q') { + arr.push(cmd.x1, cmd.y1, cmd.x, cmd.y); + } + // else if (cmd.type === 'Z') { /* no-op */ } + return arr; +} + +function parseOpts(options, defaults) { + + if (typeof options !== 'object') { + options = defaults; + } + else { + for (var key in defaults) { + if (typeof options[key] === 'undefined') { + options[key] = defaults[key]; + } + } + } + return options; +} + +//////////////////////// Helpers //////////////////////////// + +function at(v, i) { + var s = v.length; + return v[i < 0 ? i % s + s : i % s]; +} + +function collinear(a, b, c, thresholdAngle) { + + if (!thresholdAngle) { + return areaTriangle(a, b, c) === 0; + } + + if (typeof collinear.tmpPoint1 === 'undefined') { + collinear.tmpPoint1 = []; + 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; + bc.y = c.y - b.y; + + var dot = ab.x * bc.x + ab.y * bc.y, + magA = Math.sqrt(ab.x * ab.x + ab.y * ab.y), + magB = Math.sqrt(bc.x * bc.x + bc.y * bc.y), + angle = Math.acos(dot / (magA * magB)); + + return angle < thresholdAngle; +} + +function areaTriangle(a, b, c) { + 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), + 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); + + 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 + }; +} + +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; + for (var i = 0, ii = path.length; i < ii; i++) { + p = path[i]; + if (p[0] === 'M') { + x = +p[1]; + y = +p[2]; + } else { + 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); + return { x: point.x, y: point.y, alpha: point.alpha }; + } + } + len += l; + x = +p[5]; + y = +p[6]; + } + sp += p.shift() + p; + } + subpaths.end = sp; + + 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 }; + } + + return point; +} + +function pathToAbsolute(pathArray) { + + var res = [], x = 0, y = 0, mx = 0, my = 0, start = 0; + if (pathArray[0][0] === 'M') { + x = +pathArray[0][1]; + y = +pathArray[0][2]; + mx = x; + my = y; + start++; + 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'; + + for (var r, pa, i = start, ii = pathArray.length; i < ii; i++) { + res.push(r = []); + pa = pathArray[i]; + if (pa[0] !== String.prototype.toUpperCase.call(pa[0])) { + r[0] = String.prototype.toUpperCase.call(pa[0]); + switch (r[0]) { + case 'A': + r[1] = pa[1]; + r[2] = pa[2]; + r[3] = pa[3]; + r[4] = pa[4]; + r[5] = pa[5]; + r[6] = +(pa[6] + x); + r[7] = +(pa[7] + y); + break; + case 'V': + r[1] = +pa[1] + y; + break; + case 'H': + r[1] = +pa[1] + x; + break; + case 'R': + dots = [x, y].concat(pa.slice(1)); + for (var j = 2, jj = dots.length; j < jj; j++) { + dots[j] = +dots[j] + x; + dots[++j] = +dots[j] + y; + } + res.pop(); + res = res.concat(catmullRom2bezier(dots, crz)); + break; + case 'M': + mx = +pa[1] + x; + my = +pa[2] + y; + break; + default: + for (j = 1, jj = pa.length; j < jj; j++) { + r[j] = +pa[j] + ((j % 2) ? x : y); + } + } + } else if (pa[0] === 'R') { + dots = [x, y].concat(pa.slice(1)); + res.pop(); + res = res.concat(catmullRom2bezier(dots, crz)); + r = ['R'].concat(pa.slice(-2)); + } else { + for (var k = 0, kk = pa.length; k < kk; k++) { + r[k] = pa[k]; + } + } + switch (r[0]) { + case 'Z': + x = mx; + y = my; + break; + case 'H': + x = r[1]; + break; + case 'V': + y = r[1]; + break; + case 'M': + mx = r[r.length - 2]; + my = r[r.length - 1]; + break; + default: + x = r[r.length - 2]; + y = r[r.length - 1]; + } + } + return res; +} + +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; } + switch (path[0]) { + case 'M': + d.X = path[1]; + d.Y = path[2]; + break; + case 'A': + path = ['C'].concat(a2c.apply(0, [d.x, d.y].concat(path.slice(1)))); + break; + case 'S': + if (pcom === 'C' || pcom === 'S') { + nx = d.x * 2 - d.bx; + ny = d.y * 2 - d.by; + } else { + nx = d.x; + ny = d.y; + } + path = ['C', nx, ny].concat(path.slice(1)); + break; + case 'T': + if (pcom === 'Q' || pcom === 'T') { + d.qx = d.x * 2 - d.qx; + d.qy = d.y * 2 - d.qy; + } else { + d.qx = d.x; + d.qy = d.y; + } + path = ['C'].concat(q2c(d.x, d.y, d.qx, d.qy, path[1], path[2])); + break; + 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])); + break; + case 'L': + path = ['C'].concat(l2c(d.x, d.y, path[1], path[2])); + break; + case 'H': + path = ['C'].concat(l2c(d.x, d.y, path[1], d.y)); + break; + case 'V': + path = ['C'].concat(l2c(d.x, d.y, d.x, path[1])); + break; + case 'Z': + path = ['C'].concat(l2c(d.x, d.y, d.X, d.Y)); + break; + } + 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'; } + pp.splice(i++, 0, ['C'].concat(pi.splice(0, 6))); + } + pp.splice(i, 1); + 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]); + a1.bx = 0; + a1.by = 0; + a1.x = path1[i][1]; + a1.y = path1[i][2]; + 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 + + 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 + + if (pfirst !== 'C') { + pcoms1[i] = pfirst; // Save current path command + 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'; } + + 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 (pfirst !== 'C') { + pcoms2[i] = pfirst; + if (i) { pcom = pcoms2[i - 1]; } + } + p2[i] = processPath(p2[i], attrs2, pcom); + + 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, + seg2len = p2 && seg2.length; + attrs.x = seg[seglen - 2]; + attrs.y = seg[seglen - 1]; + attrs.bx = parseFloat(seg[seglen - 4]) || attrs.x; + attrs.by = parseFloat(seg[seglen - 3]) || attrs.y; + attrs2.bx = p2 && (parseFloat(seg2[seg2len - 4]) || attrs2.x); + attrs2.by = p2 && (parseFloat(seg2[seg2len - 3]) || attrs2.y); + attrs2.x = p2 && seg2[seg2len - 2]; + attrs2.y = p2 && seg2[seg2len - 1]; + } + + return p2 ? [p, p2] : p; +} + +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 X = x * Math.cos(rad) - y * Math.sin(rad), + Y = x * Math.sin(rad) + y * Math.cos(rad); + return { x: X, y: Y }; + }; + if (!recursive) { + xy = rotate(x1, y1, -rad); + x1 = xy.x; + y1 = xy.y; + 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); + 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))); + + cx = k * rx * y / ry + (x1 + x2) / 2; + cy = k * -ry * x / rx + (y1 + y2) / 2; + f1 = Math.asin(((y1 - cy) / ry).toFixed(9)); + f2 = Math.asin(((y2 - cy) / ry).toFixed(9)); + + 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 (sweep_flag && f1 > f2) { + f1 = f1 - PI * 2; + } + if (!sweep_flag && f2 > f1) { + f2 = f2 - PI * 2; + } + } else { + f1 = recursive[0]; + f2 = recursive[1]; + cx = recursive[2]; + cy = recursive[3]; + } + var df = f2 - f1; + if (Math.abs(df) > _120) { + 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]); + } + df = f2 - f1; + var c1 = Math.cos(f1), + s1 = Math.sin(f1), + c2 = Math.cos(f2), + s2 = Math.sin(f2), + t = Math.tan(df / 4), + hx = 4 / 3 * rx * t, + hy = 4 / 3 * ry * t, + m1 = [x1, y1], + m2 = [x1 + hx * s1, y1 - hy * c1], + m3 = [x2 + hx * s2, y2 - hy * c2], + m4 = [x2, y2]; + m2[0] = 2 * m1[0] - m2[0]; + m2[1] = 2 * m1[1] - m2[1]; + if (recursive) { + return [m2, m3, m4].concat(res); + } else { + 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; + } + return newres; + } +} + +// http://schepers.cc/getting-to-the-point +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] + }]; + if (z) { + if (!i) { + p[0] = { + x: +crp[iLen - 2], + y: +crp[iLen - 1] + }; + } else if (iLen - 4 === i) { + p[3] = { + x: +crp[0], + y: +crp[1] + }; + } else if (iLen - 2 === i) { + p[2] = { + x: +crp[0], + y: +crp[1] + }; + p[3] = { + x: +crp[2], + y: +crp[3] + }; + } + } else { + if (iLen - 4 === i) { + p[3] = p[2]; + } else if (!i) { + p[0] = { + x: +crp[i], + y: +crp[i + 1] + }; + } + } + 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 q2c(x1, y1, ax, ay, x2, y2) { + 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 + ]; +} + +function bezlen(x1, y1, x2, y2, x3, y3, x4, y4, z) { + 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 ]; + for (var i = 0; i < n; i++) { + var ct = z2 * Tvalues[i] + z2, + xbase = base3(ct, x1, x2, x3, x4), + ybase = base3(ct, y1, y2, y3, y4), + comb = xbase * xbase + ybase * ybase; + sum += Cvalues[i] * Math.sqrt(comb); + } + return z2 * sum; +} + +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; + l = bezlen(x1, y1, x2, y2, x3, y3, x4, y4, t2); + while (Math.abs(l - ll) > e) { + step /= 2; + t2 += (l < ll ? 1 : -1) * step; + l = bezlen(x1, y1, x2, y2, x3, y3, x4, y4, t2); + } + return t2; +} + +function base3(t, p1, p2, p3, p4) { + var t1 = -3 * p1 + 9 * p2 - 9 * p3 + 3 * p4, + t2 = t * t1 + 6 * p1 - 12 * p2 + 6 * p3; + return t * t2 - 3 * p1 + 3 * p2; +} + +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]; + } + return hash; +} + +module.exports = p5.Font; + +},{"../core/constants":41,"../core/core":42}],78:[function(_dereq_,module,exports){ +/** + * @module Data + * @submodule Array Functions + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +/** + * Adds a value to the end of an array. Extends the length of + * the array by one. Maps to Array.push(). + * + * @method append + * @param {Array} array Array to append + * @param {any} value to be added to the Array + * @example + *
+ * function setup() { + * + * var myArray = new Array("Mango", "Apple", "Papaya") + * print(myArray) // ["Mango", "Apple", "Papaya"] + * + * append(myArray, "Peach") + * print(myArray) // ["Mango", "Apple", "Papaya", "Peach"] + * + * } + *
+ */ +p5.prototype.append = function(array, value) { + array.push(value); + return array; +}; + +/** + * Copies an array (or part of an array) to another array. The src array is + * copied to the dst array, beginning at the position specified by + * 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(). + *

+ * The simplified version with only two arguments, arrayCopy(src, dst), + * copies an entire array to another of the same size. It is equivalent to + * arrayCopy(src, 0, dst, 0, src.length). + *

+ * Using this function is far more efficient for copying array data than + * iterating through a for() loop and copying each element individually. + * + * @method arrayCopy + * @param {Array} src the source Array + * @param {Number} [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 + * + * @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] + * + * } + *
+ */ +p5.prototype.arrayCopy = function( + src, + srcPosition, + dst, + dstPosition, + length) { + + // the index to begin splicing from dst array + var start, + 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 + // rename so we don't get confused + end = dst; + end = Math.min(end, src.length); + } else { // src, dst + end = src.length; + } + + start = 0; + // rename so we don't get confused + dst = srcPosition; + src = src.slice(0, end); + } + + // Since we are not returning the array and JavaScript is pass by reference + // we must modify the actual values of the array + // instead of reassigning arrays + Array.prototype.splice.apply(dst, [start, end].concat(src)); + +}; + +/** + * Concatenates two arrays, maps to Array.concat(). Does not modify the + * input arrays. + * + * @method concat + * @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 ); + * + * 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] + * + * } + *
+ */ +p5.prototype.concat = function(list0, list1) { + return list0.concat(list1); +}; + +/** + * Reverses the order of an array, maps to Array.reverse() + * + * @method reverse + * @param {Array} list Array to reverse + * @example + *
+ * function setup() { + * var myArray = new Array("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 + * @param {Array} list Array to shorten + * @return {Array} shortened Array + * @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"] + * } + *
+ */ +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 + * @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 + * @param {Array} list Array to sort + * @param {Number} [count] number of elements to sort, starting from 0 + * + * @example + *
+ * function setup() { + * var words = new Array("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 = 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 + * + * 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 + * @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 + * + * @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"] + * + * 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 + * @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 + * + * @example + *
+ * function setup() { + * var myArray = new Array(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/core":42}],79:[function(_dereq_,module,exports){ +/** + * @module Data + * @submodule Conversion + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +/** + * 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|Array} n value to parse + * @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] + *
+ */ +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 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|Array} 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(true)); // 1 + * print(byte([0, 255, "100"])); // [0, -1, 100] + *
+ */ +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|Array} 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" + *
+ */ +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|Array} 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 ] + *
+ */ +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|Array} n value to parse + * @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" ] + *
+ */ +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|Array} 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 ] + *
+ */ +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/core":42}],80:[function(_dereq_,module,exports){ +/** + * @module Data + * @submodule String Functions + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +//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.join = function(list, separator) { + return list.join(separator); +}; + +/** + * 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 {Array} Array of Strings found + * @example + *
+ * + * var string = "Hello p5js*!" + * var regexp = "p5js\\*" + * var match = match(string, regexp); + * text(match, 5, 50); + * + *
+ * + * @alt + * "p5js*" displayed middle left of canvas. + * + */ +p5.prototype.match = function(str, reg) { + return str.match(reg); +}; + +/** + * 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 {Array} 2d Array of Strings found + * @example + *
+ * + * var string = "Hello p5js*! Hello world!" + * var regexp = "Hello" + * matchAll(string, regexp); + * + *
+ + */ +p5.prototype.matchAll = function(str, reg) { + 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; +}; + +/** + * 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|Array} 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|Array} formatted String + * @example + *
+ * + * 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); + * + * // 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.nf = function () { + if (arguments[0] instanceof Array) { + var a = arguments[1]; + var b = arguments[2]; + return arguments[0].map(function (x) { + return doNf(x, a, b); + }); + } + 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); + } + } +}; + +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; + } + else { + for (var k = 0; k < Math.max(arguments[1] - intPart.length, 0); k++) { + str += '0'; + } + str += n; + return str; + } +} + +/** + * 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|Array} num the Number to format + * @param {Number} [right] number of digits to the right of the + * decimal point + * @return {String|Array} formatted String + * @example + *
+ * + * 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); + * + * // 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.nfc = function () { + 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); + } +}; +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 = ''; + } + 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); + } + } + return n + rem; +} + +/** + * 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|Array} 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|Array} formatted String + * @example + *
+ * + * 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); + * + * // Draw dividing line + * stroke(120); + * line(0, 50, width, 50); + * } + * + *
+ * + * @alt + * "+11253106.11" top middle and "-11253106.11" displayed bottom middle + * + */ +p5.prototype.nfp = function() { + var nfRes = this.nf.apply(this, arguments); + if (nfRes instanceof Array) { + return nfRes.map(addNfp); + } else { + return addNfp(nfRes); + } +}; + +function addNfp() { + return ( + parseFloat(arguments[0]) > 0) ? + '+'+arguments[0].toString() : + arguments[0].toString(); +} + +/** + * 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|Array} 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|Array} formatted String + * @example + *
+ * + * 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); + * + * // Draw dividing line + * stroke(120); + * line(0, 50, width, 50); + * } + * + *
+ * + * @alt + * "11253106.11" top middle and "-11253106.11" displayed bottom middle + * + */ +p5.prototype.nfs = function() { + var nfRes = this.nf.apply(this, arguments); + if (nfRes instanceof Array) { + return nfRes.map(addNfs); + } else { + return addNfs(nfRes); + } +}; + +function addNfs() { + return ( + parseFloat(arguments[0]) > 0) ? + ' '+arguments[0].toString() : + arguments[0].toString(); +} + +/** + * 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 {Array} Array of Strings + * @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); + * + *
+ * + * @alt + * "pat" top left, "Xio" mid left and "Alex" displayed bottom left + * + */ +p5.prototype.split = function(str, delim) { + return str.split(delim); +}; + +/** + * 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 {Array} Array of Strings + * @example + *
+ * + * function setup() { + * var myStr = "Mango, Banana, Lime"; + * var myStrArr = splitTokens(myStr, ","); + * + * print(myStrArr); // prints : ["Mango"," Banana"," Lime"] + * } + * + *
+ */ +p5.prototype.splitTokens = function() { + 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'); + } + } else { + d = /\s/g; + } + 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|Array} str a String or Array of Strings to be trimmed + * @return {String|Array} a trimmed String or Array of 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) { + if (str instanceof Array) { + return str.map(this.trim); + } else { + return str.trim(); + } +}; + +module.exports = p5; + +},{"../core/core":42}],81:[function(_dereq_,module,exports){ +/** + * @module IO + * @submodule Time & Date + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +/** + * 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 + * @example + *
+ * + * var d = day(); + * text("Current day: \n" + d, 5, 50); + * + *
+ * + * @alt + * Current day is displayed + * + */ +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(); +}; + +/** + * p5.js communicates with the clock on your computer. The minute() function + * returns the current minute as a value from 0 - 59. + * + * @method minute + * @return {Number} the current minute + * @example + *
+ * + * var m = minute(); + * text("Current minute: \n" + m, 5, 50); + * + *
+ * + * @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. + * + * @method millis + * @return {Number} the number of milliseconds since starting the program + * @example + *
+ * + * var millisecond = millis(); + * text("Milliseconds \nrunning: \n" + millisecond, 5, 40); + * + *
+ * + * @alt + * number of milliseconds since program has started displayed + * + */ +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); + * + *
+ * + * @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. + * + * @method second + * @return {Number} the current second + * @example + *
+ * + * var s = second(); + * text("Current second: \n" + s, 5, 50); + * + *
+ * + * @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). + * + * @method year + * @return {Number} the current year + * @example + *
+ * + * var y = year(); + * text("Current year: \n" + y, 5, 50); + * + *
+ * + * @alt + * Current year is displayed + * + */ +p5.prototype.year = function() { + return new Date().getFullYear(); +}; + +module.exports = p5; + +},{"../core/core":42}],82:[function(_dereq_,module,exports){ +/** + * @module Lights, Camera + * @submodule Camera + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +/** + * Sets camera position + * @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 + * @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); + * plane(120, 120); + * } + * + *
+ * + * @alt + * blue square shrinks in size grows to fill canvas. disappears then loops. + * + */ +p5.prototype.camera = function(x, y, z){ + //what it manipulates is the model view matrix + this._renderer.translate(-x, -y, -z); +}; + +/** + * Sets perspective camera + * @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 + * @example + *
+ * + * //drag mouse to toggle the world! + * //you will see there's a vanish point + * 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(); + * } + * } + * } + * + *
+ * + * @alt + * colored 3d boxes toggleable with mouse position + * + */ +p5.prototype.perspective = function(fovy,aspect,near,far) { + fovy = fovy || (60 / 180 * this.PI); + aspect = aspect || (this.width/this.height); + near = near || ((this.height/2.0) / this.tan(fovy/2.0) * 0.1); + far = far || ((this.height/2.0) / this.tan(fovy/2.0) * 10); + this._renderer.uPMatrix = p5.Matrix.identity(); + this._renderer.uPMatrix.perspective(fovy,aspect,near,far); + this._renderer._curCamera = 'custom'; +}; + +/** + * 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 + * + */ +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); + this._renderer._curCamera = 'custom'; +}; + +module.exports = p5; + +},{"../core/core":42}],83:[function(_dereq_,module,exports){ +'use strict'; + +var p5 = _dereq_('../core/core'); + +//@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; +}; + +module.exports = p5; +},{"../core/core":42}],84:[function(_dereq_,module,exports){ +/** + * @module Lights, Camera + * @submodule Lights + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); + +/** + * Creates an ambient light with a color + * @method ambientLight + * @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] optional: green or saturation value + * @param {Number} [v3] optional: blue or brightness value + * @param {Number} [a] optional: opacity + * @return {p5} the p5 object + * @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){ + var gl = this._renderer.GL; + var shaderProgram = this._renderer._getShader( + 'lightVert', 'lightTextureFrag'); + + gl.useProgram(shaderProgram); + shaderProgram.uAmbientColor = gl.getUniformLocation( + shaderProgram, + 'uAmbientColor[' + this._renderer.ambientLightCount + ']'); + + var color = this._renderer._pInst.color.apply( + this._renderer._pInst, arguments); + var colors = color._array; + + gl.uniform3f( shaderProgram.uAmbientColor, + colors[0], colors[1], colors[2]); + + //in case there's no material color for the geometry + shaderProgram.uMaterialColor = gl.getUniformLocation( + shaderProgram, 'uMaterialColor' ); + gl.uniform4f( shaderProgram.uMaterialColor, 1, 1, 1, 1); + + this._renderer.ambientLightCount ++; + shaderProgram.uAmbientLightCount = + gl.getUniformLocation(shaderProgram, 'uAmbientLightCount'); + gl.uniform1i(shaderProgram.uAmbientLightCount, + this._renderer.ambientLightCount); + + 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] optional: green or saturation value + * @param {Number} [v3] optional: blue or brightness value + * @param {Number} [a] optional: opacity + * @param {Number|p5.Vector} x x axis direction or a p5.Vector + * @param {Number} [y] optional: y axis direction + * @param {Number} [z] optional: z axis direction + * @return {p5} the p5 object + * @example + *
+ * + * function setup(){ + * createCanvas(100, 100, WEBGL); + * } + * 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); + * ambientMaterial(250); + * sphere(50); + * } + * + *
+ * + * @alt + * light source on canvas changeable with mouse position + * + */ +p5.prototype.directionalLight = function(v1, v2, v3, a, x, y, z) { + var gl = this._renderer.GL; + var shaderProgram = this._renderer._getShader( + 'lightVert', 'lightTextureFrag'); + + gl.useProgram(shaderProgram); + shaderProgram.uDirectionalColor = gl.getUniformLocation( + shaderProgram, + 'uDirectionalColor[' + this._renderer.directionalLightCount + ']'); + + //@TODO: check parameters number + var color = this._renderer._pInst.color.apply( + this._renderer._pInst, [v1, v2, v3]); + var colors = color._array; + + gl.uniform3f( shaderProgram.uDirectionalColor, + colors[0], colors[1], colors[2]); + + var _x, _y, _z; + + var args = new Array(arguments.length); + for (var i = 0; i < args.length; ++i) { + args[i] = arguments[i]; + } + 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; + } + } + + shaderProgram.uLightingDirection = gl.getUniformLocation( + shaderProgram, + 'uLightingDirection[' + this._renderer.directionalLightCount + ']'); + gl.uniform3f( shaderProgram.uLightingDirection, _x, _y, _z); + + //in case there's no material color for the geometry + shaderProgram.uMaterialColor = gl.getUniformLocation( + shaderProgram, 'uMaterialColor' ); + gl.uniform4f( shaderProgram.uMaterialColor, 1, 1, 1, 1); + + this._renderer.directionalLightCount ++; + shaderProgram.uDirectionalLightCount = + gl.getUniformLocation(shaderProgram, 'uDirectionalLightCount'); + gl.uniform1i(shaderProgram.uDirectionalLightCount, + this._renderer.directionalLightCount); + + 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] optional: green or saturation value + * @param {Number} [v3] optional: blue or brightness value + * @param {Number} [a] optional: opacity + * @param {Number|p5.Vector} x x axis position or a p5.Vector + * @param {Number} [y] optional: y axis position + * @param {Number} [z] optional: z axis position + * @return {p5} the p5 object + * @example + *
+ * + * function setup(){ + * createCanvas(100, 100, WEBGL); + * } + * 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); + * ambientMaterial(250); + * sphere(50); + * } + * + *
+ * + * @alt + * spot light on canvas changes position with mouse + * + */ +p5.prototype.pointLight = function(v1, v2, v3, a, x, y, z) { + var gl = this._renderer.GL; + var shaderProgram = this._renderer._getShader( + 'lightVert', 'lightTextureFrag'); + + gl.useProgram(shaderProgram); + shaderProgram.uPointLightColor = gl.getUniformLocation( + shaderProgram, + 'uPointLightColor[' + this._renderer.pointLightCount + ']'); + + //@TODO: check parameters number + var color = this._renderer._pInst.color.apply( + this._renderer._pInst, [v1, v2, v3]); + var colors = color._array; + + gl.uniform3f( shaderProgram.uPointLightColor, + colors[0], colors[1], colors[2]); + + var _x, _y, _z; + + var args = new Array(arguments.length); + for (var i = 0; i < args.length; ++i) { + args[i] = arguments[i]; + } + 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; + } + } + + shaderProgram.uPointLightLocation = gl.getUniformLocation( + shaderProgram, + 'uPointLightLocation[' + this._renderer.pointLightCount + ']'); + gl.uniform3f( shaderProgram.uPointLightLocation, _x, _y, _z); + + //in case there's no material color for the geometry + shaderProgram.uMaterialColor = gl.getUniformLocation( + shaderProgram, 'uMaterialColor' ); + gl.uniform4f( shaderProgram.uMaterialColor, 1, 1, 1, 1); + + this._renderer.pointLightCount ++; + shaderProgram.uPointLightCount = + gl.getUniformLocation(shaderProgram, 'uPointLightCount'); + gl.uniform1i(shaderProgram.uPointLightCount, + this._renderer.pointLightCount); + + return this; +}; + +module.exports = p5; + +},{"../core/core":42}],85:[function(_dereq_,module,exports){ +/** + * @module Shape + * @submodule 3D Models + * @for p5 + * @requires core + * @requires p5.Geometry3D + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); +_dereq_('./p5.Geometry'); + +/** + * Load a 3d model from an OBJ file. + *

+ * 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 + * model to a scale appropriate for p5. You can also make additional changes to + * the final size of your model with the scale() function. + * + * @method loadModel + * @param {String} path Path of the model to be loaded + * @param {Boolean} [normalize] If true, scale the model to a + * standardized size when loading + * @param {Function(p5.Geometry3D)} [successCallback] Function to be called + * once the model is loaded. Will be passed + * the 3D model object. + * @param {Function(Event)} [failureCallback] called with event error if + * the image fails to load. + * @return {p5.Geometry} the p5.Geometry3D object + * @example + *
+ * + * //draw a spinning teapot + * var teapot; + * + * function setup(){ + * createCanvas(100, 100, WEBGL); + * + * teapot = loadModel('assets/teapot.obj'); + * } + * + * function draw(){ + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * model(teapot); + * } + * + *
+ * + * @alt + * Vertically rotating 3-d teapot with red, green and blue gradient. + * + */ +p5.prototype.loadModel = function () { + var path = arguments[0]; + var normalize; + var successCallback; + var failureCallback; + if(typeof arguments[1] === 'boolean') { + normalize = arguments[1]; + successCallback = arguments[2]; + failureCallback = arguments[3]; + } else { + normalize = false; + successCallback = arguments[1]; + failureCallback = arguments[2]; + } + + var model = new p5.Geometry(); + model.gid = path + '|' + normalize; + this.loadStrings(path, function(strings) { + parseObj(model, strings); + + if (normalize) { + model.normalize(); + } + + if (typeof successCallback === 'function') { + successCallback(model); + } + }.bind(this), failureCallback); + + return model; +}; + +/** + * Parse OBJ lines into model. For reference, this is what a simple model of a + * square might look like: + * + * v -0.5 -0.5 0.5 + * v -0.5 -0.5 -0.5 + * v -0.5 0.5 -0.5 + * v -0.5 0.5 0.5 + * + * f 4 3 2 1 + */ +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 + // UV coordinate 4 and vertex normal 3". In WebGL, every vertex with different + // parameters must be a different vertex, so loadedVerts is used to + // temporarily store the parsed vertices, normals, etc., and indexedVerts is + // 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 indexedVerts = {}; + + for (var line = 0; line < lines.length; ++line) { + // Each line is a separate object (vertex, face, vertex normal, etc) + // For each line, split it into tokens on whitespace. The first token + // describes the type. + var tokens = lines[line].trim().split(/\b\s+/); + + if (tokens.length > 0) { + 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])); + loadedVerts[tokens[0]].push(vertex); + } else if (tokens[0] === 'vt') { + // Check if this line describes a texture coordinate. + // It will have two numeric parameters. + var texVertex = [parseFloat(tokens[1]), parseFloat(tokens[2])]; + loadedVerts[tokens[0]].push(texVertex); + } else if (tokens[0] === 'f') { + // Check if this line describes a face. + // OBJ faces can have more than three points. Triangulate points. + for (var tri = 3; tri < tokens.length; ++tri) { + var face = []; + + var vertexTokens = [1, tri - 1, tri]; + + for (var tokenInd = 0; tokenInd < vertexTokens.length; ++tokenInd) { + // Now, convert the given token into an index + var vertString = tokens[vertexTokens[tokenInd]]; + var vertIndex = 0; + + // TODO: Faces can technically use negative numbers to refer to the + // previous nth vertex. I haven't seen this used in practice, but + // it might be good to implement this in the future. + + if (indexedVerts[vertString] !== undefined) { + vertIndex = indexedVerts[vertString]; + } else { + var vertParts = vertString.split('/'); + for (var i = 0; i < vertParts.length; i++) { + 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]); + } + + if (loadedVerts.vn[vertParts[2]]) { + model.vertexNormals.push(loadedVerts.vn[vertParts[2]].copy()); + } + } + + face.push(vertIndex); + } + + 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 teapot + * var teapot; + * + * function setup(){ + * createCanvas(100, 100, WEBGL); + * + * teapot = loadModel('assets/teapot.obj'); + * } + * + * function draw(){ + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * model(teapot); + * } + * + *
+ * + * @alt + * Vertically rotating 3-d teapot with red, green and blue gradient. + * + */ +p5.prototype.model = function ( model ) { + if (model.vertices.length > 0) { + if (!this._renderer.geometryInHash(model.gid)) { + this._renderer.createBuffers(model.gid, model); + } + + this._renderer.drawBuffers(model.gid); + } +}; + +module.exports = p5; + +},{"../core/core":42,"./p5.Geometry":87}],86:[function(_dereq_,module,exports){ +/** + * @module Lights, Camera + * @submodule Material + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/core'); +//require('./p5.Texture'); + +/** + * Normal material for geometry. You can view all + * possible materials in this + * example. + * @method normalMaterial + * @return {p5} the p5 object + * @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._renderer._getShader('normalVert', 'normalFrag'); + 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 + * @return {p5} the p5 object + * @example + *
+ * + * var img; + * function setup(){ + * createCanvas(100, 100, WEBGL); + * img = loadImage("assets/laDefense.jpg"); + * } + * + * 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(){ + var args = new Array(arguments.length); + for (var i = 0; i < args.length; ++i) { + args[i] = arguments[i]; + } + var gl = this._renderer.GL; + var shaderProgram = this._renderer._getShader('lightVert', + 'lightTextureFrag'); + gl.useProgram(shaderProgram); + var textureData; + //if argument is not already a texture + //create a new one + if(!args[0].isTexture){ + if (args[0] instanceof p5.Image) { + textureData = args[0].canvas; + } + //if param is a video + else if (typeof p5.MediaElement !== 'undefined' && + args[0] instanceof p5.MediaElement){ + if(!args[0].loadedmetadata) {return;} + textureData = args[0].elt; + } + //used with offscreen 2d graphics renderer + else if(args[0] instanceof p5.Graphics){ + textureData = args[0].elt; + } + var tex = gl.createTexture(); + args[0]._setProperty('tex', tex); + args[0]._setProperty('isTexture', true); + this._renderer._bind.call(this, tex, textureData); + } + else { + if(args[0] instanceof p5.Graphics || + (typeof p5.MediaElement !== 'undefined' && + args[0] instanceof p5.MediaElement)){ + textureData = args[0].elt; + } + else if(args[0] instanceof p5.Image){ + textureData = args[0].canvas; + } + this._renderer._bind.call(this, args[0].tex, textureData); + } + //this is where we'd activate multi textures + //eg. gl.activeTexture(gl.TEXTURE0 + (unit || 0)); + //but for now we just have a single texture. + //@TODO need to extend this functionality + gl.activeTexture(gl.TEXTURE0); + gl.bindTexture(gl.TEXTURE_2D, args[0].tex); + gl.uniform1i(gl.getUniformLocation(shaderProgram, 'isTexture'), true); + gl.uniform1i(gl.getUniformLocation(shaderProgram, 'uSampler'), 0); + return this; +}; + +/** + * Texture Util functions + */ +p5.RendererGL.prototype._bind = function(tex, data){ + var gl = this._renderer.GL; + gl.bindTexture(gl.TEXTURE_2D, tex); + gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true); + gl.texImage2D(gl.TEXTURE_2D, 0, + gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, data); + gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true); + gl.texParameteri(gl.TEXTURE_2D, + gl.TEXTURE_MAG_FILTER, gl.LINEAR); + gl.texParameteri(gl.TEXTURE_2D, + gl.TEXTURE_MIN_FILTER, gl.LINEAR); + gl.texParameteri(gl.TEXTURE_2D, + gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE); + gl.texParameteri(gl.TEXTURE_2D, + gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE); + gl.bindTexture(gl.TEXTURE_2D, null); +}; + +/** + * Checks whether val is a pot + * more info on power of 2 here: + * https://www.opengl.org/wiki/NPOT_Texture + * @param {Number} value + * @return {Boolean} + */ +// function _isPowerOf2 (value){ +// return (value & (value - 1)) === 0; +// } + +/** + * returns the next highest power of 2 value + * @param {Number} value [description] + * @return {Number} [description] + */ +// function _nextHighestPOT (value){ +// --value; +// for (var i = 1; i < 32; i <<= 1) { +// value = value | value >> i; +// } +// return value + 1; + +/** + * 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] optional: green or saturation value + * @param {Number} [v3] optional: blue or brightness value + * @param {Number} [a] optional: opacity +* @return {p5} the p5 object + * @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 + * + */ +p5.prototype.ambientMaterial = function(v1, v2, v3, a) { + var gl = this._renderer.GL; + var shaderProgram = + this._renderer._getShader('lightVert', 'lightTextureFrag'); + + gl.useProgram(shaderProgram); + shaderProgram.uMaterialColor = gl.getUniformLocation( + shaderProgram, 'uMaterialColor' ); + var colors = this._renderer._applyColorBlend.apply(this._renderer, arguments); + + gl.uniform4f(shaderProgram.uMaterialColor, + colors[0], colors[1], colors[2], colors[3]); + + shaderProgram.uSpecular = gl.getUniformLocation( + shaderProgram, 'uSpecular' ); + gl.uniform1i(shaderProgram.uSpecular, false); + + gl.uniform1i(gl.getUniformLocation(shaderProgram, '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|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] optional: green or saturation value + * @param {Number} [v3] optional: blue or brightness value + * @param {Number} [a] optional: opacity + * @return {p5} the p5 object + * @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 + * + */ +p5.prototype.specularMaterial = function(v1, v2, v3, a) { + var gl = this._renderer.GL; + var shaderProgram = + this._renderer._getShader('lightVert', 'lightTextureFrag'); + gl.useProgram(shaderProgram); + gl.uniform1i(gl.getUniformLocation(shaderProgram, 'isTexture'), false); + shaderProgram.uMaterialColor = gl.getUniformLocation( + shaderProgram, 'uMaterialColor' ); + var colors = this._renderer._applyColorBlend.apply(this._renderer, arguments); + gl.uniform4f(shaderProgram.uMaterialColor, + colors[0], colors[1], colors[2], colors[3]); + shaderProgram.uSpecular = gl.getUniformLocation( + shaderProgram, 'uSpecular' ); + gl.uniform1i(shaderProgram.uSpecular, true); + + 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} v1 [description] + * @param {Number} v2 [description] + * @param {Number} v3 [description] + * @param {Number} a [description] + * @return {[Number]} Normalized numbers array + */ +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); + } + return colors; +}; + +module.exports = p5; + +},{"../core/core":42}],87:[function(_dereq_,module,exports){ +//some of the functions are adjusted from Three.js(http://threejs.org) + +'use strict'; + +var p5 = _dereq_('../core/core'); + +/** + * p5 Geometry class + * @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 {Function} [callback] function to call upon object instantiation. + * + */ +p5.Geometry = function +(detailX, detailY, callback){ + //an array containing every vertex + //@type [p5.Vector] + this.vertices = []; + //an array containing 1 normal per vertex + //@type [p5.Vector] + //[p5.Vector, p5.Vector, p5.Vector,p5.Vector, p5.Vector, p5.Vector,...] + this.vertexNormals = []; + //an array containing each three vertex indices that form a face + //[[0, 1, 2], [2, 1, 3], ...] + this.faces = []; + //a 2D array containing uvs for every vertex + //[[0.0,0.0],[1.0,0.0], ...] + this.uvs = []; + this.detailX = (detailX !== undefined) ? detailX: 1; + this.detailY = (detailY !== undefined) ? detailY: 1; + if(callback instanceof Function){ + callback.call(this); + } + return this; +}; + +p5.Geometry.prototype.computeFaces = function(){ + 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; + this.faces.push([a, b, d]); + this.faces.push([d, b, c]); + } + } + return this; +}; + +p5.Geometry.prototype._getFaceNormal = function(faceId,vertId){ + //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)); +}; +/** + * computes smooth normals per vertex as an average of each + * face. + */ +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)); + } + } + normal = normal.normalize(); + this.vertexNormals.push(normal); + } + return this; +}; + +/** + * Averages the vertex normals. Used in curved + * surfaces + * @return {p5.Geometry} + */ +p5.Geometry.prototype.averageNormals = function() { + + 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]); + temp = p5.Vector.div(temp, 2); + this.vertexNormals[i*offset] = temp; + this.vertexNormals[i*offset + this.detailX] = temp; + } + return this; +}; + +/** + * Averages pole normals. Used in spherical primitives + * @return {p5.Geometry} + */ +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++){ + sum.add(this.vertexNormals[i]); + } + sum = p5.Vector.div(sum, this.detailX); + + 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--){ + 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--){ + this.vertexNormals[i] = sum; + } + return this; +}; + +/** + * Modifies all vertices to be centered within the range -100 to 100. + * @return {p5.Geometry} + */ +p5.Geometry.prototype.normalize = function() { + 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++) { + 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); + minPosition.y = Math.min(minPosition.y, this.vertices[i].y); + maxPosition.z = Math.max(maxPosition.z, this.vertices[i].z); + minPosition.z = Math.min(minPosition.z, this.vertices[i].z); + } + + var center = p5.Vector.lerp(maxPosition, minPosition, 0.5); + var dist = p5.Vector.sub(maxPosition, minPosition); + var longestDist = Math.max(Math.max(dist.x, dist.y), dist.z); + var scale = 200 / longestDist; + + for(i = 0; i < this.vertices.length; i++) { + this.vertices[i].sub(center); + this.vertices[i].mult(scale); + } + } + return this; +}; + +module.exports = p5.Geometry; + +},{"../core/core":42}],88:[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 +*/ + +'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; + +/** + * A class to describe a 4x4 matrix + * for model and view matrix manipulation in the p5js webgl renderer. + * class p5.Matrix + * @constructor + * @param {Array} [mat4] array literal of our 4x4 matrix + */ +p5.Matrix = function() { + var args = new Array(arguments.length); + 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() + } 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 + ]); + } + } + return this; +}; + +/** + * 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|Array} [inMatrix] the input p5.Matrix or + * an Array of length 16 + */ +p5.Matrix.prototype.set = function (inMatrix) { + if (inMatrix instanceof p5.Matrix) { + this.mat4 = inMatrix.mat4; + return this; + } + else if (inMatrix instanceof GLMAT_ARRAY_TYPE) { + this.mat4 = inMatrix; + return this; + } + return this; +}; + +/** + * Gets a copy of the vector, returns a p5.Matrix object. + * + * @return {p5.Matrix} the copy of the p5.Matrix object + */ +p5.Matrix.prototype.get = function () { + return new p5.Matrix(this.mat4); +}; + +/** + * return a copy of a matrix + * @return {p5.Matrix} the result matrix + */ +p5.Matrix.prototype.copy = function(){ + var copied = new p5.Matrix(); + copied.mat4[0] = this.mat4[0]; + copied.mat4[1] = this.mat4[1]; + copied.mat4[2] = this.mat4[2]; + copied.mat4[3] = this.mat4[3]; + copied.mat4[4] = this.mat4[4]; + copied.mat4[5] = this.mat4[5]; + copied.mat4[6] = this.mat4[6]; + copied.mat4[7] = this.mat4[7]; + copied.mat4[8] = this.mat4[8]; + copied.mat4[9] = this.mat4[9]; + copied.mat4[10] = this.mat4[10]; + copied.mat4[11] = this.mat4[11]; + copied.mat4[12] = this.mat4[12]; + copied.mat4[13] = this.mat4[13]; + copied.mat4[14] = this.mat4[14]; + copied.mat4[15] = this.mat4[15]; + return copied; +}; + +/** + * return an identity matrix + * @return {p5.Matrix} the result matrix + */ +p5.Matrix.identity = function(){ + return new p5.Matrix(); +}; + +/** + * transpose according to a given matrix + * @param {p5.Matrix | Typed Array} a the matrix to be based on to transpose + * @return {p5.Matrix} this + */ +p5.Matrix.prototype.transpose = function(a){ + var a01, a02, a03, a12, a13, a23; + if(a instanceof p5.Matrix){ + a01 = a.mat4[1]; + a02 = a.mat4[2]; + a03 = a.mat4[3]; + a12 = a.mat4[6]; + a13 = a.mat4[7]; + a23 = a.mat4[11]; + + this.mat4[0] = a.mat4[0]; + this.mat4[1] = a.mat4[4]; + this.mat4[2] = a.mat4[8]; + this.mat4[3] = a.mat4[12]; + this.mat4[4] = a01; + this.mat4[5] = a.mat4[5]; + this.mat4[6] = a.mat4[9]; + this.mat4[7] = a.mat4[13]; + this.mat4[8] = a02; + this.mat4[9] = a12; + this.mat4[10] = a.mat4[10]; + this.mat4[11] = a.mat4[14]; + this.mat4[12] = a03; + this.mat4[13] = a13; + this.mat4[14] = a23; + this.mat4[15] = a.mat4[15]; + + }else if(a instanceof GLMAT_ARRAY_TYPE){ + a01 = a[1]; + a02 = a[2]; + a03 = a[3]; + a12 = a[6]; + a13 = a[7]; + a23 = a[11]; + + this.mat4[0] = a[0]; + this.mat4[1] = a[4]; + this.mat4[2] = a[8]; + this.mat4[3] = a[12]; + this.mat4[4] = a01; + this.mat4[5] = a[5]; + this.mat4[6] = a[9]; + this.mat4[7] = a[13]; + this.mat4[8] = a02; + this.mat4[9] = a12; + this.mat4[10] = a[10]; + this.mat4[11] = a[14]; + this.mat4[12] = a03; + this.mat4[13] = a13; + this.mat4[14] = a23; + this.mat4[15] = a[15]; + } + return this; +}; + +/** + * invert matrix according to a give matrix + * @param {p5.Matrix or Typed Array} a the matrix to be based on to invert + * @return {p5.Matrix} this + */ +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){ + a00 = a.mat4[0]; + a01 = a.mat4[1]; + a02 = a.mat4[2]; + a03 = a.mat4[3]; + a10 = a.mat4[4]; + a11 = a.mat4[5]; + a12 = a.mat4[6]; + a13 = a.mat4[7]; + a20 = a.mat4[8]; + a21 = a.mat4[9]; + a22 = a.mat4[10]; + a23 = a.mat4[11]; + a30 = a.mat4[12]; + a31 = a.mat4[13]; + a32 = a.mat4[14]; + a33 = a.mat4[15]; + }else if(a instanceof GLMAT_ARRAY_TYPE){ + a00 = a[0]; + a01 = a[1]; + a02 = a[2]; + a03 = a[3]; + a10 = a[4]; + a11 = a[5]; + a12 = a[6]; + a13 = a[7]; + a20 = a[8]; + a21 = a[9]; + a22 = a[10]; + a23 = a[11]; + a30 = a[12]; + a31 = a[13]; + 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, + + // Calculate the determinant + det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - + b04 * b07 + b05 * b06; + + if (!det) { + return null; + } + det = 1.0 / det; + + this.mat4[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det; + this.mat4[1] = (a02 * b10 - a01 * b11 - a03 * b09) * det; + this.mat4[2] = (a31 * b05 - a32 * b04 + a33 * b03) * det; + this.mat4[3] = (a22 * b04 - a21 * b05 - a23 * b03) * det; + this.mat4[4] = (a12 * b08 - a10 * b11 - a13 * b07) * det; + this.mat4[5] = (a00 * b11 - a02 * b08 + a03 * b07) * det; + this.mat4[6] = (a32 * b02 - a30 * b05 - a33 * b01) * det; + this.mat4[7] = (a20 * b05 - a22 * b02 + a23 * b01) * det; + this.mat4[8] = (a10 * b10 - a11 * b08 + a13 * b06) * det; + this.mat4[9] = (a01 * b08 - a00 * b10 - a03 * b06) * det; + this.mat4[10] = (a30 * b04 - a31 * b02 + a33 * b00) * det; + this.mat4[11] = (a21 * b02 - a20 * b04 - a23 * b00) * det; + this.mat4[12] = (a11 * b07 - a10 * b09 - a12 * b06) * det; + this.mat4[13] = (a00 * b09 - a01 * b07 + a02 * b06) * det; + this.mat4[14] = (a31 * b01 - a30 * b03 - a32 * b00) * det; + this.mat4[15] = (a20 * b03 - a21 * b01 + a22 * b00) * det; + + return this; +}; + +/** + * Inverts a 3x3 matrix + * @return {[type]} [description] + */ +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, + + // Calculate the determinant + det = a00 * b01 + a01 * b11 + a02 * b21; + if (!det) { + return null; + } + det = 1.0 / det; + this.mat3[0] = b01 * det; + this.mat3[1] = (-a22 * a01 + a02 * a21) * det; + this.mat3[2] = (a12 * a01 - a02 * a11) * det; + this.mat3[3] = b11 * det; + this.mat3[4] = (a22 * a00 - a02 * a20) * det; + this.mat3[5] = (-a12 * a00 + a02 * a10) * det; + this.mat3[6] = b21 * det; + this.mat3[7] = (-a21 * a00 + a01 * a20) * det; + this.mat3[8] = (a11 * a00 - a01 * a10) * det; + return this; +}; + +/** + * transposes a 3x3 p5.Matrix by a mat3 + * @param {[Number]} mat3 1-dimensional array + * @return {p5.Matrix} this + */ +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; + this.mat3[5] = mat3[7]; + this.mat3[6] = a02; + this.mat3[7] = a12; + return this; +}; + +/** + * converts a 4x4 matrix to its 3x3 inverse tranform + * commonly used in MVMatrix to NMatrix conversions. + * @param {p5.Matrix} mat4 the matrix to be based on to invert + * @return {p5.Matrix} this with mat3 + * @todo finish implementation + */ +p5.Matrix.prototype.inverseTranspose = function (matrix){ + if(this.mat3 === undefined){ + console.error('sorry, this function only works with mat3'); + } + else { + //convert mat4 -> mat3 + this.mat3[0] = matrix.mat4[0]; + this.mat3[1] = matrix.mat4[1]; + this.mat3[2] = matrix.mat4[2]; + this.mat3[3] = matrix.mat4[4]; + this.mat3[4] = matrix.mat4[5]; + this.mat3[5] = matrix.mat4[6]; + this.mat3[6] = matrix.mat4[8]; + this.mat3[7] = matrix.mat4[9]; + this.mat3[8] = matrix.mat4[10]; + } + + this.invert3x3().transpose3x3(this.mat3); + return this; +}; + +/** + * inspired by Toji's mat4 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]); + + // Calculate the determinant + return d00 * d11 - d01 * d10 + d02 * d09 + + d03 * d08 - d04 * d07 + d05 * d06; +}; + +/** + * multiply two mat4s + * @param {p5.Matrix|Array} multMatrix The matrix we want to multiply by + * @return {p5.Matrix} this + */ +p5.Matrix.prototype.mult = function(multMatrix){ + var _dest = new GLMAT_ARRAY_TYPE(16); + var _src = new GLMAT_ARRAY_TYPE(16); + + if(multMatrix instanceof p5.Matrix) { + _src = multMatrix.mat4; + } + else if(multMatrix instanceof GLMAT_ARRAY_TYPE){ + _src = multMatrix; + } + + // 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]; + + 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]; + + 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]; + + 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; + + return this; +}; + +/** + * scales a p5.Matrix by scalars or a vector + * @param {p5.Vector|Array} s vector to scale by + * @return {p5.Matrix} this + */ +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; + return this; +}; + +/** + * rotate our Matrix around an axis by the given angle. + * @param {Number} a The angle of rotation in radians + * @param {p5.Vector|Array} axis the axis(es) to rotate around + * @return {p5.Matrix} this + * inspired by Toji's gl-matrix lib, mat4 rotation + */ +p5.Matrix.prototype.rotate = function(a, axis){ + var x, y, z, _a, len; + + 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]; + } + + 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]; + var a02 = this.mat4[2]; + var a03 = this.mat4[3]; + var a10 = this.mat4[4]; + var a11 = this.mat4[5]; + var a12 = this.mat4[6]; + var a13 = this.mat4[7]; + var a20 = this.mat4[8]; + var a21 = this.mat4[9]; + var a22 = this.mat4[10]; + var a23 = this.mat4[11]; + + //sin,cos, and tan of respective angle + var sA = Math.sin(_a); + var cA = Math.cos(_a); + var tA = 1 - cA; + // Construct the elements of the rotation matrix + var b00 = x * x * tA + cA; + var b01 = y * x * tA + z * sA; + var b02 = z * x * tA - y * sA; + var b10 = x * y * tA - z * sA; + var b11 = y * y * tA + cA; + var b12 = z * y * tA + x * sA; + var b20 = x * z * tA + y * sA; + var b21 = y * z * tA - x * sA; + var b22 = z * z * tA + cA; + + // rotation-specific matrix multiplication + this.mat4[0] = a00 * b00 + a10 * b01 + a20 * b02; + this.mat4[1] = a01 * b00 + a11 * b01 + a21 * b02; + this.mat4[2] = a02 * b00 + a12 * b01 + a22 * b02; + this.mat4[3] = a03 * b00 + a13 * b01 + a23 * b02; + this.mat4[4] = a00 * b10 + a10 * b11 + a20 * b12; + this.mat4[5] = a01 * b10 + a11 * b11 + a21 * b12; + this.mat4[6] = a02 * b10 + a12 * b11 + a22 * b12; + this.mat4[7] = a03 * b10 + a13 * b11 + a23 * b12; + this.mat4[8] = a00 * b20 + a10 * b21 + a20 * b22; + this.mat4[9] = a01 * b20 + a11 * b21 + a21 * b22; + this.mat4[10] = a02 * b20 + a12 * b21 + a22 * b22; + this.mat4[11] = a03 * b20 + a13 * b21 + a23 * b22; + + return this; +}; + +/** + * @todo finish implementing this method! + * translates + * @param {Array} v vector to translate by + * @return {p5.Matrix} this + */ +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[12]; + this.mat4[13] = + this.mat4[1] * x +this.mat4[5] * y +this.mat4[9] * z +this.mat4[13]; + this.mat4[14] = + this.mat4[2] * x +this.mat4[6] * y +this.mat4[10] * z +this.mat4[14]; + this.mat4[15] = + this.mat4[3] * x +this.mat4[7] * y +this.mat4[11] * z +this.mat4[15]; +}; + +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.rotateZ = function(a){ + this.rotate(a, [0,0,1]); +}; + +/** + * sets the perspective matrix + * @param {Number} fovy [description] + * @param {Number} aspect [description] + * @param {Number} near near clipping plane + * @param {Number} far far clipping plane + * @return {void} + */ +p5.Matrix.prototype.perspective = function(fovy,aspect,near,far){ + + var f = 1.0 / Math.tan(fovy / 2), + nf = 1 / (near - far); + + this.mat4[0] = f / aspect; + this.mat4[1] = 0; + this.mat4[2] = 0; + this.mat4[3] = 0; + this.mat4[4] = 0; + this.mat4[5] = f; + this.mat4[6] = 0; + this.mat4[7] = 0; + this.mat4[8] = 0; + this.mat4[9] = 0; + this.mat4[10] = (far + near) * nf; + this.mat4[11] = -1; + this.mat4[12] = 0; + this.mat4[13] = 0; + this.mat4[14] = (2 * far * near) * nf; + this.mat4[15] = 0; + + return this; + +}; + +/** + * sets the ortho matrix + * @param {Number} left [description] + * @param {Number} right [description] + * @param {Number} bottom [description] + * @param {Number} top [description] + * @param {Number} near near clipping plane + * @param {Number} far far clipping plane + * @return {void} + */ +p5.Matrix.prototype.ortho = function(left,right,bottom,top,near,far){ + + var lr = 1 / (left - right), + bt = 1 / (bottom - top), + nf = 1 / (near - far); + this.mat4[0] = -2 * lr; + this.mat4[1] = 0; + this.mat4[2] = 0; + this.mat4[3] = 0; + this.mat4[4] = 0; + this.mat4[5] = -2 * bt; + this.mat4[6] = 0; + this.mat4[7] = 0; + this.mat4[8] = 0; + this.mat4[9] = 0; + this.mat4[10] = 2 * nf; + this.mat4[11] = 0; + this.mat4[12] = (left + right) * lr; + this.mat4[13] = (top + bottom) * bt; + this.mat4[14] = (far + near) * nf; + this.mat4[15] = 1; + + return this; +}; + +/** + * PRIVATE + */ +// matrix methods adapted from: +// https://developer.mozilla.org/en-US/docs/Web/WebGL/ +// gluPerspective +// +// function _makePerspective(fovy, aspect, znear, zfar){ +// var ymax = znear * Math.tan(fovy * Math.PI / 360.0); +// var ymin = -ymax; +// var xmin = ymin * aspect; +// var xmax = ymax * aspect; +// return _makeFrustum(xmin, xmax, ymin, ymax, znear, zfar); +// } + +//// +//// glFrustum +//// +//function _makeFrustum(left, right, bottom, top, znear, zfar){ +// var X = 2*znear/(right-left); +// var Y = 2*znear/(top-bottom); +// var A = (right+left)/(right-left); +// var B = (top+bottom)/(top-bottom); +// var C = -(zfar+znear)/(zfar-znear); +// var D = -2*zfar*znear/(zfar-znear); +// var frustrumMatrix =[ +// X, 0, A, 0, +// 0, Y, B, 0, +// 0, 0, C, D, +// 0, 0, -1, 0 +//]; +//return frustrumMatrix; +// } + +// function _setMVPMatrices(){ +////an identity matrix +////@TODO use the p5.Matrix class to abstract away our MV matrices and +///other math +//var _mvMatrix = +//[ +// 1.0,0.0,0.0,0.0, +// 0.0,1.0,0.0,0.0, +// 0.0,0.0,1.0,0.0, +// 0.0,0.0,0.0,1.0 +//]; + +module.exports = p5.Matrix; + +},{"../core/constants":41,"../core/core":42,"../math/polargeometry":72}],89:[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(). + * 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 + * geometries and buffers on the CPU to reduce the number of webgl + * draw calls. Retained mode is more efficient & performative, + * however, Immediate Mode is useful for sketching quick + * geometric ideas. + */ +'use strict'; + +var p5 = _dereq_('../core/core'); +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, + * please use p5.js geometry primitives. + * @param {Number} mode webgl primitives mode. beginShape supports the + * following modes: + * POINTS,LINES,LINE_STRIP,LINE_LOOP,TRIANGLES, + * TRIANGLE_STRIP,and TRIANGLE_FAN. + * @return {[type]} [description] + */ +p5.RendererGL.prototype.beginShape = function(mode){ + //default shape mode is 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.vertexPositions === undefined){ + this.immediateMode.vertexPositions = []; + this.immediateMode.vertexColors = []; + this.immediateMode.vertexBuffer = this.GL.createBuffer(); + this.immediateMode.colorBuffer = this.GL.createBuffer(); + } else { + this.immediateMode.vertexPositions.length = 0; + this.immediateMode.vertexColors.length = 0; + } + this.isImmediateDrawing = true; + return this; +}; +/** + * adds a vertex to be drawn in a custom Shape. + * @param {Number} x x-coordinate of vertex + * @param {Number} y y-coordinate of vertex + * @param {Number} z z-coordinate of vertex + * @return {p5.RendererGL} [description] + * @TODO implement handling of p5.Vector args + */ +p5.RendererGL.prototype.vertex = function(x, y, z){ + this.immediateMode.vertexPositions.push(x, y, z); + var vertexColor = this.curFillColor || [0.5, 0.5, 0.5, 1.0]; + this.immediateMode.vertexColors.push( + vertexColor[0], + vertexColor[1], + vertexColor[2], + vertexColor[3]); + return this; +}; + +/** + * End shape drawing and render vertices to screen. + * @return {p5.RendererGL} [description] + */ +p5.RendererGL.prototype.endShape = +function(mode, isCurve, isBezier,isQuadratic, isContour, shapeKind){ + var gl = this.GL; + this._bindImmediateBuffers( + this.immediateMode.vertexPositions, + this.immediateMode.vertexColors); + if(mode){ + if(this.drawMode === 'fill'){ + 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; + } + } + } + //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 { + gl.enable(gl.BLEND); + gl.drawArrays(this.immediateMode.shapeMode, 0, + this.immediateMode.vertexPositions.length / 3); + } + //clear out our vertexPositions & colors arrays + //after rendering + this.immediateMode.vertexPositions.length = 0; + this.immediateMode.vertexColors.length = 0; + this.isImmediateDrawing = false; + return this; +}; +/** + * Bind immediateMode buffers to data, + * then draw gl arrays + * @param {Array} vertices Numbers array representing + * vertex positions + * @return {p5.RendererGL} + */ +p5.RendererGL.prototype._bindImmediateBuffers = function(vertices, colors){ + this._setDefaultCamera(); + var gl = this.GL; + var shaderKey = this._getCurShaderId(); + var shaderProgram = this.mHash[shaderKey]; + //vertex position Attribute + shaderProgram.vertexPositionAttribute = + gl.getAttribLocation(shaderProgram, 'aPosition'); + gl.enableVertexAttribArray(shaderProgram.vertexPositionAttribute); + gl.bindBuffer(gl.ARRAY_BUFFER, this.immediateMode.vertexBuffer); + gl.bufferData( + gl.ARRAY_BUFFER, new Float32Array(vertices), gl.DYNAMIC_DRAW); + gl.vertexAttribPointer(shaderProgram.vertexPositionAttribute, + 3, gl.FLOAT, false, 0, 0); + + shaderProgram.vertexColorAttribute = + gl.getAttribLocation(shaderProgram, 'aVertexColor'); + gl.enableVertexAttribArray(shaderProgram.vertexColorAttribute); + gl.bindBuffer(gl.ARRAY_BUFFER, this.immediateMode.colorBuffer); + gl.bufferData(gl.ARRAY_BUFFER, + new Float32Array(colors),gl.DYNAMIC_DRAW); + gl.vertexAttribPointer(shaderProgram.vertexColorAttribute, + 4, gl.FLOAT, false, 0, 0); + //matrix + this._setMatrixUniforms(shaderKey); + //@todo implement in all shaders (not just immediateVert) + //set our default point size + // this._setUniform1f(shaderKey, + // 'uPointSize', + // this.pointSize); + return this; +}; + +////////////////////////////////////////////// +// COLOR +////////////////////////////////////////////// + +p5.RendererGL.prototype._getColorVertexShader = function(){ + var gl = this.GL; + var mId = 'immediateVert|vertexColorFrag'; + var shaderProgram; + + if(!this.materialInHash(mId)){ + shaderProgram = + this._initShaders('immediateVert', 'vertexColorFrag', true); + this.mHash[mId] = shaderProgram; + shaderProgram.vertexColorAttribute = + gl.getAttribLocation(shaderProgram, 'aVertexColor'); + gl.enableVertexAttribArray(shaderProgram.vertexColorAttribute); + }else{ + shaderProgram = this.mHash[mId]; + } + return shaderProgram; +}; + +module.exports = p5.RendererGL; +},{"../core/constants":41,"../core/core":42}],90:[function(_dereq_,module,exports){ +//Retained Mode. The default mode for rendering 3D primitives +//in WEBGL. +'use strict'; + +var p5 = _dereq_('../core/core'); +var hashCount = 0; +/** + * _initBufferDefaults + * @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) { + //@TODO remove this limit on hashes in gHash + hashCount ++; + if(hashCount > 1000){ + var key = Object.keys(this.gHash)[0]; + delete this.gHash[key]; + 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].uvBuffer = gl.createBuffer(); + this.gHash[gId].indexBuffer = gl.createBuffer(); +}; +/** + * createBuffers description + * @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); + //return the current shaderProgram from our material hash + var shaderProgram = this.mHash[this._getCurShaderId()]; + //@todo rename "numberOfItems" property to something more descriptive + //we mult the num geom faces by 3 + this.gHash[gId].numberOfItems = obj.faces.length * 3; + gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].vertexBuffer); + gl.bufferData( + gl.ARRAY_BUFFER, + new Float32Array( vToNArray(obj.vertices) ), + gl.STATIC_DRAW); + //vertex position + shaderProgram.vertexPositionAttribute = + gl.getAttribLocation(shaderProgram, 'aPosition'); + gl.enableVertexAttribArray(shaderProgram.vertexPositionAttribute); + + gl.vertexAttribPointer( + shaderProgram.vertexPositionAttribute, + 3, gl.FLOAT, false, 0, 0); + + gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].normalBuffer); + gl.bufferData( + gl.ARRAY_BUFFER, + new Float32Array( vToNArray(obj.vertexNormals) ), + gl.STATIC_DRAW); + //vertex normal + shaderProgram.vertexNormalAttribute = + gl.getAttribLocation(shaderProgram, 'aNormal'); + gl.enableVertexAttribArray(shaderProgram.vertexNormalAttribute); + + gl.vertexAttribPointer( + shaderProgram.vertexNormalAttribute, + 3, gl.FLOAT, false, 0, 0); + + gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].uvBuffer); + gl.bufferData( + gl.ARRAY_BUFFER, + new Float32Array( flatten(obj.uvs) ), + gl.STATIC_DRAW); + //texture coordinate Attribute + shaderProgram.textureCoordAttribute = + gl.getAttribLocation(shaderProgram, 'aTexCoord'); + gl.enableVertexAttribArray(shaderProgram.textureCoordAttribute); + gl.vertexAttribPointer( + shaderProgram.textureCoordAttribute, + 2, gl.FLOAT, false, 0, 0); + + gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, this.gHash[gId].indexBuffer); + gl.bufferData( + gl.ELEMENT_ARRAY_BUFFER, + new Uint16Array( flatten(obj.faces) ), + gl.STATIC_DRAW); +}; + +/** + * Draws buffers given a geometry key ID + * @param {String} gId ID in our geom hash + * @return {p5.RendererGL} this + */ +p5.RendererGL.prototype.drawBuffers = function(gId) { + this._setDefaultCamera(); + var gl = this.GL; + var shaderKey = this._getCurShaderId(); + var shaderProgram = this.mHash[shaderKey]; + //vertex position buffer + gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].vertexBuffer); + gl.vertexAttribPointer( + shaderProgram.vertexPositionAttribute, + 3, gl.FLOAT, false, 0, 0); + //normal buffer + gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].normalBuffer); + gl.vertexAttribPointer( + shaderProgram.vertexNormalAttribute, + 3, gl.FLOAT, false, 0, 0); + // uv buffer + gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].uvBuffer); + gl.vertexAttribPointer( + shaderProgram.textureCoordAttribute, + 2, gl.FLOAT, false, 0, 0); + //vertex index buffer + gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, this.gHash[gId].indexBuffer); + this._setMatrixUniforms(shaderKey); + gl.drawElements( + gl.TRIANGLES, this.gHash[gId].numberOfItems, + gl.UNSIGNED_SHORT, 0); + return this; +}; +/////////////////////////////// +//// UTILITY FUNCTIONS +////////////////////////////// +/** + * turn a two dimensional array into one dimensional array + * @param {Array} arr 2-dimensional array + * @return {Array} 1-dimensional array + * [[1, 2, 3],[4, 5, 6]] -> [1, 2, 3, 4, 5, 6] + */ +function flatten(arr){ + if (arr.length>0){ + return arr.reduce(function(a, b){ + return a.concat(b); + }); + } else { + return []; + } +} + +/** + * 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 + * [p5.Vector(1, 2, 3), p5.Vector(4, 5, 6)] -> + * [1, 2, 3, 4, 5, 6] + */ +function vToNArray(arr){ + return flatten(arr.map(function(item){ + return [item.x, item.y, item.z]; + })); +} +module.exports = p5.RendererGL; + +},{"../core/core":42}],91:[function(_dereq_,module,exports){ +'use strict'; + +var p5 = _dereq_('../core/core'); +var shader = _dereq_('./shader'); +_dereq_('../core/p5.Renderer'); +_dereq_('./p5.Matrix'); +var uMVMatrixStack = []; + +//@TODO should implement public method +//to override these attributes +var attributes = { + alpha: true, + depth: true, + stencil: true, + antialias: false, + premultipliedAlpha: false, + preserveDrawingBuffer: false +}; + +/** + * 3D graphics class + * @class p5.RendererGL + * @constructor + * @extends p5.Renderer + * @todo extend class to include public method for offscreen + * rendering (FBO). + * + */ +p5.RendererGL = function(elt, pInst, isMainCanvas) { + p5.Renderer.call(this, elt, pInst, isMainCanvas); + 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; + //camera + this._curCamera = null; + + /** + * model view, projection, & normal + * matrices + */ + this.uMVMatrix = new p5.Matrix(); + this.uPMatrix = new p5.Matrix(); + this.uNMatrix = new p5.Matrix('mat3'); + //Geometry & Material hashes + this.gHash = {}; + this.mHash = {}; + //Imediate Mode + //default drawing is done in Retained Mode + this.isImmediateDrawing = false; + this.immediateMode = {}; + this.curFillColor = [0.5,0.5,0.5,1.0]; + this.curStrokeColor = [0.5,0.5,0.5,1.0]; + this.pointSize = 5.0;//default point/stroke + return this; +}; + +p5.RendererGL.prototype = Object.create(p5.Renderer.prototype); + +////////////////////////////////////////////// +// Setting +////////////////////////////////////////////// + +p5.RendererGL.prototype._initContext = function() { + try { + this.drawingContext = this.canvas.getContext('webgl', attributes) || + this.canvas.getContext('experimental-webgl', attributes); + if (this.drawingContext === null) { + throw new Error('Error creating webgl context'); + } else { + console.log('p5.RendererGL: enabled webgl context'); + var gl = this.drawingContext; + gl.enable(gl.DEPTH_TEST); + gl.depthFunc(gl.LEQUAL); + gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight); + } + } catch (er) { + throw new Error(er); + } +}; +//detect if user didn't set the camera +//then call this function below +p5.RendererGL.prototype._setDefaultCamera = function(){ + if(this._curCamera === null){ + var _w = this.width; + var _h = this.height; + this.uPMatrix = p5.Matrix.identity(); + var cameraZ = (this.height / 2) / Math.tan(Math.PI * 30 / 180); + this.uPMatrix.perspective(60 / 180 * Math.PI, _w / _h, + cameraZ * 0.1, cameraZ * 10); + this._curCamera = 'default'; + } +}; + +p5.RendererGL.prototype._update = function() { + this.uMVMatrix = p5.Matrix.identity(); + this.translate(0, 0, -(this.height / 2) / Math.tan(Math.PI * 30 / 180)); + this.ambientLightCount = 0; + this.directionalLightCount = 0; + this.pointLightCount = 0; +}; + +/** + * [background description] + * @return {[type]} [description] + */ +p5.RendererGL.prototype.background = function() { + var gl = this.GL; + 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; + gl.clearColor(_r, _g, _b, _a); + gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT); +}; + +//@TODO implement this +// p5.RendererGL.prototype.clear = function() { +//@TODO +// }; + +////////////////////////////////////////////// +// SHADER +////////////////////////////////////////////// + +/** + * [_initShaders description] + * @param {string} vertId [description] + * @param {string} fragId [description] + * @return {[type]} [description] + */ +p5.RendererGL.prototype._initShaders = +function(vertId, fragId, isImmediateMode) { + var gl = this.GL; + //set up our default shaders by: + // 1. create the shader, + // 2. load the shader source, + // 3. compile the shader + var _vertShader = gl.createShader(gl.VERTEX_SHADER); + //load in our default vertex shader + gl.shaderSource(_vertShader, shader[vertId]); + gl.compileShader(_vertShader); + // if our vertex shader failed compilation? + if (!gl.getShaderParameter(_vertShader, gl.COMPILE_STATUS)) { + alert('Yikes! An error occurred compiling the shaders:' + + gl.getShaderInfoLog(_vertShader)); + return null; + } + + var _fragShader = gl.createShader(gl.FRAGMENT_SHADER); + //load in our material frag shader + gl.shaderSource(_fragShader, shader[fragId]); + gl.compileShader(_fragShader); + // if our frag shader failed compilation? + if (!gl.getShaderParameter(_fragShader, gl.COMPILE_STATUS)) { + alert('Darn! An error occurred compiling the shaders:' + + gl.getShaderInfoLog(_fragShader)); + return null; + } + + var shaderProgram = gl.createProgram(); + gl.attachShader(shaderProgram, _vertShader); + gl.attachShader(shaderProgram, _fragShader); + gl.linkProgram(shaderProgram); + if (!gl.getProgramParameter(shaderProgram, gl.LINK_STATUS)) { + alert('Snap! Error linking shader program'); + } + //END SHADERS SETUP + + this._getLocation(shaderProgram, isImmediateMode); + + return shaderProgram; +}; + +p5.RendererGL.prototype._getLocation = +function(shaderProgram, isImmediateMode) { + var gl = this.GL; + gl.useProgram(shaderProgram); + + //projection Matrix uniform + shaderProgram.uPMatrixUniform = + gl.getUniformLocation(shaderProgram, 'uProjectionMatrix'); + //model view Matrix uniform + shaderProgram.uMVMatrixUniform = + gl.getUniformLocation(shaderProgram, 'uModelViewMatrix'); + + //@TODO: figure out a better way instead of if statement + if(isImmediateMode === undefined){ + //normal Matrix uniform + shaderProgram.uNMatrixUniform = + gl.getUniformLocation(shaderProgram, 'uNormalMatrix'); + + shaderProgram.samplerUniform = + gl.getUniformLocation(shaderProgram, 'uSampler'); + } +}; + +/** + * Sets a shader uniform given a shaderProgram and uniform string + * @param {String} shaderKey key to material Hash. + * @param {String} uniform location in shader. + * @param { Number} data data to bind uniform. Float data type. + * @todo currently this function sets uniform1f data. + * Should generalize function to accept any uniform + * data type. + */ +p5.RendererGL.prototype._setUniform1f = function(shaderKey,uniform,data) +{ + var gl = this.GL; + var shaderProgram = this.mHash[shaderKey]; + gl.useProgram(shaderProgram); + shaderProgram[uniform] = gl.getUniformLocation(shaderProgram, uniform); + gl.uniform1f(shaderProgram[uniform], data); + return this; +}; + +p5.RendererGL.prototype._setMatrixUniforms = function(shaderKey) { + var gl = this.GL; + var shaderProgram = this.mHash[shaderKey]; + + gl.useProgram(shaderProgram); + + gl.uniformMatrix4fv( + shaderProgram.uPMatrixUniform, + false, this.uPMatrix.mat4); + + gl.uniformMatrix4fv( + shaderProgram.uMVMatrixUniform, + false, this.uMVMatrix.mat4); + + this.uNMatrix.inverseTranspose(this.uMVMatrix); + + gl.uniformMatrix3fv( + shaderProgram.uNMatrixUniform, + false, this.uNMatrix.mat3); +}; +////////////////////////////////////////////// +// GET CURRENT | for shader and color +////////////////////////////////////////////// +p5.RendererGL.prototype._getShader = function(vertId, fragId, isImmediateMode) { + var mId = vertId + '|' + fragId; + //create it and put it into hashTable + if(!this.materialInHash(mId)){ + var shaderProgram = this._initShaders(vertId, fragId, isImmediateMode); + this.mHash[mId] = shaderProgram; + } + this.curShaderId = mId; + + return this.mHash[this.curShaderId]; +}; + +p5.RendererGL.prototype._getCurShaderId = function(){ + //if the shader ID is not yet defined + var mId, shaderProgram; + if(this.drawMode !== 'fill' && this.curShaderId === undefined){ + //default shader: normalMaterial() + mId = 'normalVert|normalFrag'; + shaderProgram = this._initShaders('normalVert', 'normalFrag'); + this.mHash[mId] = shaderProgram; + this.curShaderId = mId; + } else if(this.isImmediateDrawing && this.drawMode === 'fill'){ + mId = 'immediateVert|vertexColorFrag'; + shaderProgram = this._initShaders('immediateVert', 'vertexColorFrag'); + this.mHash[mId] = shaderProgram; + this.curShaderId = mId; + } + return this.curShaderId; +}; + +////////////////////////////////////////////// +// COLOR +////////////////////////////////////////////// +/** + * Basic fill material for geometry with a given color + * @method fill + * @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] optional: green or saturation value + * @param {Number} [v3] optional: blue or brightness value + * @param {Number} [a] optional: opacity + * @return {p5} the p5 object + * @example + *
+ * + * function setup(){ + * createCanvas(100, 100, WEBGL); + * } + * + * function draw(){ + * background(0); + * fill(250, 0, 0); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * rotateZ(frameCount * 0.01); + * box(200, 200, 200); + * } + * + *
+ * + * @alt + * red canvas + * + */ +p5.RendererGL.prototype.fill = function(v1, v2, v3, a) { + var gl = this.GL; + var shaderProgram; + //see material.js for more info on color blending in webgl + var colors = this._applyColorBlend.apply(this, arguments); + this.curFillColor = colors; + this.drawMode = 'fill'; + if(this.isImmediateDrawing){ + shaderProgram = + this._getShader('immediateVert','vertexColorFrag'); + gl.useProgram(shaderProgram); + } else { + shaderProgram = + this._getShader('normalVert', 'basicFrag'); + gl.useProgram(shaderProgram); + //RetainedMode uses a webgl uniform to pass color vals + //in ImmediateMode, we want access to each vertex so therefore + //we cannot use a uniform. + shaderProgram.uMaterialColor = gl.getUniformLocation( + shaderProgram, 'uMaterialColor' ); + gl.uniform4f( shaderProgram.uMaterialColor, + colors[0], + colors[1], + colors[2], + colors[3]); + } + return this; +}; +p5.RendererGL.prototype.stroke = function(r, g, b, a) { + var color = this._pInst.color.apply(this._pInst, arguments); + var colorNormalized = color._array; + this.curStrokeColor = colorNormalized; + this.drawMode = 'stroke'; + return this; +}; + +//@TODO +p5.RendererGL.prototype._strokeCheck = function(){ + if(this.drawMode === 'stroke'){ + throw new Error( + 'stroke for shapes in 3D not yet implemented, use fill for now :(' + ); + } +}; + +/** + * [strokeWeight description] + * @param {Number} pointSize stroke point size + * @return {[type]} [description] + * @todo strokeWeight currently works on points only. + * implement on all wireframes and strokes. + */ +p5.RendererGL.prototype.strokeWeight = function(pointSize) { + this.pointSize = pointSize; + return this; +}; +////////////////////////////////////////////// +// HASH | for material and geometry +////////////////////////////////////////////// + +p5.RendererGL.prototype.geometryInHash = function(gId){ + return this.gHash[gId] !== undefined; +}; + +p5.RendererGL.prototype.materialInHash = function(mId){ + return this.mHash[mId] !== undefined; +}; + +/** + * [resize description] + * @param {[type]} w [description] + * @param {[tyoe]} h [description] + * @return {[type]} [description] + */ +p5.RendererGL.prototype.resize = function(w,h) { + var gl = this.GL; + p5.Renderer.prototype.resize.call(this, w, h); + gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight); + // If we're using the default camera, update the aspect ratio + if(this._curCamera === 'default') { + this._curCamera = null; + this._setDefaultCamera(); + } +}; + +/** + * clears color and depth buffers + * with r,g,b,a + * @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() { + var gl = this.GL; + gl.clearColor(arguments[0], + arguments[1], + arguments[2], + arguments[3]); + gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT); +}; + +/** + * [translate description] + * @param {[type]} x [description] + * @param {[type]} y [description] + * @param {[type]} z [description] + * @return {[type]} [description] + * @todo implement handle for components or vector as args + */ +p5.RendererGL.prototype.translate = function(x, y, z) { + this.uMVMatrix.translate([x,-y,z]); + return this; +}; + +/** + * Scales the Model View Matrix by a vector + * @param {Number | p5.Vector | Array} x [description] + * @param {Number} [y] y-axis scalar + * @param {Number} [z] z-axis scalar + * @return {this} [description] + */ +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); + return this; +}; + +p5.RendererGL.prototype.rotateX = function(rad) { + this.rotate(rad, [1,0,0]); + return this; +}; + +p5.RendererGL.prototype.rotateY = function(rad) { + this.rotate(rad, [0,1,0]); + return this; +}; + +p5.RendererGL.prototype.rotateZ = function(rad) { + 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()); +}; + +/** + * [pop description] + * @return {[type]} [description] + */ +p5.RendererGL.prototype.pop = function() { + if (uMVMatrixStack.length === 0) { + throw new Error('Invalid popMatrix!'); + } + this.uMVMatrix = uMVMatrixStack.pop(); +}; + +p5.RendererGL.prototype.resetMatrix = function() { + this.uMVMatrix = p5.Matrix.identity(); + this.translate(0, 0, -800); + return this; +}; + +// Text/Typography +// @TODO: +p5.RendererGL.prototype._applyTextProperties = function() { + //@TODO finish implementation + console.error('text commands not yet implemented in webgl'); +}; +module.exports = p5.RendererGL; + +},{"../core/core":42,"../core/p5.Renderer":48,"./p5.Matrix":88,"./shader":93}],92:[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(); + 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 + * @return {p5} the p5 object + * @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 + ]; + 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]); + } + }; + var boxGeom = new p5.Geometry(detailX,detailY, _box); + boxGeom.computeNormals(); + //initialize our geometry buffer with + //the key val pair: + //geometry Id, Geom object + this._renderer.createBuffers(gId, boxGeom); + } + this._renderer.drawBuffers(gId); + + return this; + +}; + +/** + * Draw a sphere with given radius + * @method sphere + * @param {Number} radius radius of circle + * @param {Number} [detailX] optional: number of segments, + * the more segments the smoother geometry + * default is 24 + * @param {Number} [detailY] optional: number of segments, + * the more segments the smoother geometry + * default is 16 + * @return {p5} the p5 object + * @example + *
+ * + * // draw a sphere with radius 200 + * function setup(){ + * createCanvas(100, 100, WEBGL); + * } + * + * function draw(){ + * background(200); + * sphere(50); + * } + * + *
+ */ +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(); + this._renderer.createBuffers(gId, sphereGeom); + } + this._renderer.drawBuffers(gId); + + 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]); + } + } +}; + +/** + * 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] optional: number of segments, + * the more segments the smoother geometry + * default is 24 + * @param {Number} [detailY] optional: number of segments in y-dimension, + * the more segments the smoother geometry + * default is 16 + * @return {p5} the p5 object + * @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); + * } + * + *
+ */ +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(); + this._renderer.createBuffers(gId, cylinderGeom); + } + + this._renderer.drawBuffers(gId); + + return this; +}; + + +/** + * 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] optional: number of segments, + * the more segments the smoother geometry + * default is 24 + * @param {Number} [detailY] optional: number of segments, + * the more segments the smoother geometry + * default is 16 + * @return {p5} the p5 object + * @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); + * } + * + *
+ */ +p5.prototype.cone = function(){ + var args = new Array(arguments.length); + for (var i = 0; i < args.length; ++i) { + args[i] = arguments[i]; + } + 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(); + this._renderer.createBuffers(gId, coneGeom); + } + + this._renderer.drawBuffers(gId); + + return this; +}; + +/** + * 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] optional: 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] optional: number of segments, + * the more segments the smoother geometry + * default is 16. Avoid detail number above + * 150, it may crash the browser. + * @return {p5} the p5 object + * @example + *
+ * + * // draw an ellipsoid with radius 20, 30 and 40. + * function setup(){ + * createCanvas(100, 100, WEBGL); + * } + * + * function draw(){ + * background(200); + * ellipsoid(20, 30, 40); + * } + * + *
+ */ +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; + + + 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]); + } + } + }; + var ellipsoidGeom = new p5.Geometry(detailX, detailY,_ellipsoid); + ellipsoidGeom + .computeFaces() + .computeNormals(); + this._renderer.createBuffers(gId, ellipsoidGeom); + } + + this._renderer.drawBuffers(gId); + + return this; +}; + +/** + * 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] optional: number of segments in x-dimension, + * the more segments the smoother geometry + * default is 24 + * @param {Number} [detailY] optional: number of segments in y-dimension, + * the more segments the smoother geometry + * default is 16 + * @return {p5} the p5 object + * @example + *
+ * + * //draw a spinning torus with radius 200 and tube radius 60 + * function setup(){ + * createCanvas(100, 100, WEBGL); + * } + * + * function draw(){ + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * torus(200, 60); + * } + * + *
+ */ +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 radius = args[0] || 50; + var tubeRadius = args[1] || 10; + + var gId = 'torus|'+radius+'|'+tubeRadius+'|'+detailX+'|'+detailY; + + 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 torusGeom = new p5.Geometry(detailX, detailY, _torus); + torusGeom + .computeFaces() + .computeNormals() + .averageNormals(); + this._renderer.createBuffers(gId, torusGeom); + } + + this._renderer.drawBuffers(gId); + + return this; +}; + +/////////////////////// +/// 2D primitives +///////////////////////// + +//@TODO +p5.RendererGL.prototype.point = function(x, y, z){ + console.log('point not yet implemented in webgl'); + 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|'+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.vertices = vertices; + this.faces = [[0,1,2]]; + this.uvs = [[0,0],[0,1],[1,1]]; + }; + var triGeom = new p5.Geometry(1,1,_triangle); + triGeom.computeNormals(); + this.createBuffers(gId, triGeom); + } + + this.drawBuffers(gId); + return this; +}; + +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); + } + 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); + } + this.vertices.push(p); + this.uvs.push([u,v]); + } + } + }; + var ellipseGeom = new p5.Geometry(detailX,detailY,_ellipse); + ellipseGeom + .computeFaces() + .computeNormals(); + this.createBuffers(gId, ellipseGeom); + } + this.drawBuffers(gId); + return this; +}; + +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]); + } + } + }; + var rectGeom = new p5.Geometry(detailX,detailY,_rect); + rectGeom + .computeFaces() + .computeNormals(); + this.createBuffers(gId, rectGeom); + } + this.drawBuffers(gId); + return this; +}; + +p5.RendererGL.prototype.quad = function(){ + var args = new Array(arguments.length); + for (var i = 0; i < args.length; ++i) { + args[i] = arguments[i]; + } + 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]); + }; + var quadGeom = new p5.Geometry(2,2,_quad); + quadGeom.computeNormals(); + 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 +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]); + } + 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]); + } + this.endShape(); + return this; +}; + +module.exports = p5; + +},{"../core/core":42,"./p5.Geometry":87}],93:[function(_dereq_,module,exports){ + + +module.exports = { + 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 * vec3(1.0, -1.0, 1.0), 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 * vec3(1.0, -1.0, 1.0), 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 * vec3(1.0, -1.0, 1.0), 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;\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(vLightWeighting == vec3(0., 0., 0.)){\n gl_FragColor = textureColor;\n }else{\n gl_FragColor = vec4(vec3(textureColor.rgb * vLightWeighting), textureColor.a);\n }\n }\n}" +}; +},{}]},{},[33])(33) +}); diff --git a/examples/neuroevolution-flappybird-1/libraries/p5.sound.js b/examples/neuroevolution-flappybird-1/libraries/p5.sound.js new file mode 100644 index 0000000..f3a9eb5 --- /dev/null +++ b/examples/neuroevolution-flappybird-1/libraries/p5.sound.js @@ -0,0 +1,9336 @@ +/*! p5.sound.js v0.3.2 2016-11-01 */ +(function (root, factory) { + if (typeof define === 'function' && define.amd) + define('p5.sound', ['p5'], function (p5) { (factory(p5));}); + else if (typeof exports === 'object') + factory(require('../p5')); + else + factory(root['p5']); +}(this, function (p5) { + /** + * p5.sound extends p5 with Web Audio functionality including audio input, + * playback, analysis and synthesis. + *

+ * p5.SoundFile: Load and play sound files.
+ * p5.Amplitude: Get the current volume of a sound.
+ * p5.AudioIn: Get sound from an input source, typically + * a computer microphone.
+ * p5.FFT: Analyze the frequency of sound. Returns + * results from the frequency spectrum or time domain (waveform).
+ * p5.Oscillator: Generate Sine, + * Triangle, Square and Sawtooth waveforms. Base class of + * p5.Noise and p5.Pulse. + *
+ * p5.Env: An Envelope is a series + * of fades over time. Often used to control an object's + * output gain level as an "ADSR Envelope" (Attack, Decay, + * Sustain, Release). Can also modulate other parameters.
+ * p5.Delay: A delay effect with + * parameters for feedback, delayTime, and lowpass filter.
+ * p5.Filter: Filter the frequency range of a + * sound. + *
+ * p5.Reverb: Add reverb to a sound by specifying + * duration and decay.
+ * p5.Convolver: Extends + * p5.Reverb to simulate the sound of real + * physical spaces through convolution.
+ * p5.SoundRecorder: Record sound for playback + * / save the .wav file. + * p5.Phrase, p5.Part and + * p5.Score: Compose musical sequences. + *

+ * p5.sound is on GitHub. + * Download the latest version + * here. + * + * @module p5.sound + * @submodule p5.sound + * @for p5.sound + * @main + */ +/** + * p5.sound developed by Jason Sigal for the Processing Foundation, Google Summer of Code 2014. The MIT License (MIT). + * + * http://github.com/therewasaguy/p5.sound + * + * Some of the many audio libraries & resources that inspire p5.sound: + * - TONE.js (c) Yotam Mann, 2014. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js + * - buzz.js (c) Jay Salvat, 2013. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/ + * - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0 + * - wavesurfer.js https://github.com/katspaugh/wavesurfer.js + * - Web Audio Components by Jordan Santell https://github.com/web-audio-components + * - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound + * + * Web Audio API: http://w3.org/TR/webaudio/ + */ +var sndcore; +sndcore = function () { + 'use strict'; + /* AudioContext Monkeypatch + Copyright 2013 Chris Wilson + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + http://www.apache.org/licenses/LICENSE-2.0 + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + */ + (function (global, exports, perf) { + exports = exports || {}; + 'use strict'; + function fixSetTarget(param) { + if (!param) + // if NYI, just return + return; + if (!param.setTargetAtTime) + param.setTargetAtTime = param.setTargetValueAtTime; + } + if (window.hasOwnProperty('webkitAudioContext') && !window.hasOwnProperty('AudioContext')) { + window.AudioContext = webkitAudioContext; + if (typeof AudioContext.prototype.createGain !== 'function') + AudioContext.prototype.createGain = AudioContext.prototype.createGainNode; + if (typeof AudioContext.prototype.createDelay !== 'function') + AudioContext.prototype.createDelay = AudioContext.prototype.createDelayNode; + if (typeof AudioContext.prototype.createScriptProcessor !== 'function') + AudioContext.prototype.createScriptProcessor = AudioContext.prototype.createScriptProcessor; + if (typeof AudioContext.prototype.createPeriodicWave !== 'function') + AudioContext.prototype.createPeriodicWave = AudioContext.prototype.createWaveTable; + AudioContext.prototype.internal_createGain = AudioContext.prototype.createGain; + AudioContext.prototype.createGain = function () { + var node = this.internal_createGain(); + fixSetTarget(node.gain); + return node; + }; + AudioContext.prototype.internal_createDelay = AudioContext.prototype.createDelay; + AudioContext.prototype.createDelay = function (maxDelayTime) { + var node = maxDelayTime ? this.internal_createDelay(maxDelayTime) : this.internal_createDelay(); + fixSetTarget(node.delayTime); + return node; + }; + AudioContext.prototype.internal_createBufferSource = AudioContext.prototype.createBufferSource; + AudioContext.prototype.createBufferSource = function () { + var node = this.internal_createBufferSource(); + if (!node.start) { + node.start = function (when, offset, duration) { + if (offset || duration) + this.noteGrainOn(when || 0, offset, duration); + else + this.noteOn(when || 0); + }; + } else { + node.internal_start = node.start; + node.start = function (when, offset, duration) { + if (typeof duration !== 'undefined') + node.internal_start(when || 0, offset, duration); + else + node.internal_start(when || 0, offset || 0); + }; + } + if (!node.stop) { + node.stop = function (when) { + this.noteOff(when || 0); + }; + } else { + node.internal_stop = node.stop; + node.stop = function (when) { + node.internal_stop(when || 0); + }; + } + fixSetTarget(node.playbackRate); + return node; + }; + AudioContext.prototype.internal_createDynamicsCompressor = AudioContext.prototype.createDynamicsCompressor; + AudioContext.prototype.createDynamicsCompressor = function () { + var node = this.internal_createDynamicsCompressor(); + fixSetTarget(node.threshold); + fixSetTarget(node.knee); + fixSetTarget(node.ratio); + fixSetTarget(node.reduction); + fixSetTarget(node.attack); + fixSetTarget(node.release); + return node; + }; + AudioContext.prototype.internal_createBiquadFilter = AudioContext.prototype.createBiquadFilter; + AudioContext.prototype.createBiquadFilter = function () { + var node = this.internal_createBiquadFilter(); + fixSetTarget(node.frequency); + fixSetTarget(node.detune); + fixSetTarget(node.Q); + fixSetTarget(node.gain); + return node; + }; + if (typeof AudioContext.prototype.createOscillator !== 'function') { + AudioContext.prototype.internal_createOscillator = AudioContext.prototype.createOscillator; + AudioContext.prototype.createOscillator = function () { + var node = this.internal_createOscillator(); + if (!node.start) { + node.start = function (when) { + this.noteOn(when || 0); + }; + } else { + node.internal_start = node.start; + node.start = function (when) { + node.internal_start(when || 0); + }; + } + if (!node.stop) { + node.stop = function (when) { + this.noteOff(when || 0); + }; + } else { + node.internal_stop = node.stop; + node.stop = function (when) { + node.internal_stop(when || 0); + }; + } + if (!node.setPeriodicWave) + node.setPeriodicWave = node.setWaveTable; + fixSetTarget(node.frequency); + fixSetTarget(node.detune); + return node; + }; + } + } + if (window.hasOwnProperty('webkitOfflineAudioContext') && !window.hasOwnProperty('OfflineAudioContext')) { + window.OfflineAudioContext = webkitOfflineAudioContext; + } + return exports; + }(window)); + // <-- end MonkeyPatch. + // Create the Audio Context + var audiocontext = new window.AudioContext(); + /** + *

Returns the Audio Context for this sketch. Useful for users + * who would like to dig deeper into the Web Audio API + * .

+ * + * @method getAudioContext + * @return {Object} AudioContext for this sketch + */ + p5.prototype.getAudioContext = function () { + return audiocontext; + }; + // Polyfill for AudioIn, also handled by p5.dom createCapture + navigator.getUserMedia = navigator.getUserMedia || navigator.webkitGetUserMedia || navigator.mozGetUserMedia || navigator.msGetUserMedia; + /** + * Determine which filetypes are supported (inspired by buzz.js) + * The audio element (el) will only be used to test browser support for various audio formats + */ + var el = document.createElement('audio'); + p5.prototype.isSupported = function () { + return !!el.canPlayType; + }; + var isOGGSupported = function () { + return !!el.canPlayType && el.canPlayType('audio/ogg; codecs="vorbis"'); + }; + var isMP3Supported = function () { + return !!el.canPlayType && el.canPlayType('audio/mpeg;'); + }; + var isWAVSupported = function () { + return !!el.canPlayType && el.canPlayType('audio/wav; codecs="1"'); + }; + var isAACSupported = function () { + return !!el.canPlayType && (el.canPlayType('audio/x-m4a;') || el.canPlayType('audio/aac;')); + }; + var isAIFSupported = function () { + return !!el.canPlayType && el.canPlayType('audio/x-aiff;'); + }; + p5.prototype.isFileSupported = function (extension) { + switch (extension.toLowerCase()) { + case 'mp3': + return isMP3Supported(); + case 'wav': + return isWAVSupported(); + case 'ogg': + return isOGGSupported(); + case 'aac', 'm4a', 'mp4': + return isAACSupported(); + case 'aif', 'aiff': + return isAIFSupported(); + default: + return false; + } + }; + // if it is iOS, we have to have a user interaction to start Web Audio + // http://paulbakaus.com/tutorials/html5/web-audio-on-ios/ + var iOS = navigator.userAgent.match(/(iPad|iPhone|iPod)/g) ? true : false; + if (iOS) { + var iosStarted = false; + var startIOS = function () { + if (iosStarted) + return; + // create empty buffer + var buffer = audiocontext.createBuffer(1, 1, 22050); + var source = audiocontext.createBufferSource(); + source.buffer = buffer; + // connect to output (your speakers) + source.connect(audiocontext.destination); + // play the file + source.start(0); + console.log('start ios!'); + if (audiocontext.state === 'running') { + iosStarted = true; + } + }; + document.addEventListener('touchend', startIOS, false); + document.addEventListener('touchstart', startIOS, false); + } +}(); +var master; +master = function () { + 'use strict'; + /** + * Master contains AudioContext and the master sound output. + */ + var Master = function () { + var audiocontext = p5.prototype.getAudioContext(); + this.input = audiocontext.createGain(); + this.output = audiocontext.createGain(); + //put a hard limiter on the output + this.limiter = audiocontext.createDynamicsCompressor(); + this.limiter.threshold.value = 0; + this.limiter.ratio.value = 20; + this.audiocontext = audiocontext; + this.output.disconnect(); + // an array of input sources + this.inputSources = []; + // connect input to limiter + this.input.connect(this.limiter); + // connect limiter to output + this.limiter.connect(this.output); + // meter is just for global Amplitude / FFT analysis + this.meter = audiocontext.createGain(); + this.fftMeter = audiocontext.createGain(); + this.output.connect(this.meter); + this.output.connect(this.fftMeter); + // connect output to destination + this.output.connect(this.audiocontext.destination); + // an array of all sounds in the sketch + this.soundArray = []; + // an array of all musical parts in the sketch + this.parts = []; + // file extensions to search for + this.extensions = []; + }; + // create a single instance of the p5Sound / master output for use within this sketch + var p5sound = new Master(); + /** + * Returns a number representing the master amplitude (volume) for sound + * in this sketch. + * + * @method getMasterVolume + * @return {Number} Master amplitude (volume) for sound in this sketch. + * Should be between 0.0 (silence) and 1.0. + */ + p5.prototype.getMasterVolume = function () { + return p5sound.output.gain.value; + }; + /** + *

Scale the output of all sound in this sketch

+ * Scaled between 0.0 (silence) and 1.0 (full volume). + * 1.0 is the maximum amplitude of a digital sound, so multiplying + * by greater than 1.0 may cause digital distortion. To + * fade, provide a rampTime parameter. For more + * complex fades, see the Env class. + * + * Alternately, you can pass in a signal source such as an + * oscillator to modulate the amplitude with an audio signal. + * + *

How This Works: When you load the p5.sound module, it + * creates a single instance of p5sound. All sound objects in this + * module output to p5sound before reaching your computer's output. + * So if you change the amplitude of p5sound, it impacts all of the + * sound in this module.

+ * + *

If no value is provided, returns a Web Audio API Gain Node

+ * + * @method masterVolume + * @param {Number|Object} volume Volume (amplitude) between 0.0 + * and 1.0 or modulating signal/oscillator + * @param {Number} [rampTime] Fade for t seconds + * @param {Number} [timeFromNow] Schedule this event to happen at + * t seconds in the future + */ + p5.prototype.masterVolume = function (vol, rampTime, tFromNow) { + if (typeof vol === 'number') { + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var now = p5sound.audiocontext.currentTime; + var currentVol = p5sound.output.gain.value; + p5sound.output.gain.cancelScheduledValues(now + tFromNow); + p5sound.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); + p5sound.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); + } else if (vol) { + vol.connect(p5sound.output.gain); + } else { + // return the Gain Node + return p5sound.output.gain; + } + }; + /** + * `p5.soundOut` is the p5.sound master output. It sends output to + * the destination of this window's web audio context. It contains + * Web Audio API nodes including a dyanmicsCompressor (.limiter), + * and Gain Nodes for .input and .output. + * + * @property soundOut + * @type {Object} + */ + p5.prototype.soundOut = p5.soundOut = p5sound; + /** + * a silent connection to the DesinationNode + * which will ensure that anything connected to it + * will not be garbage collected + * + * @private + */ + p5.soundOut._silentNode = p5sound.audiocontext.createGain(); + p5.soundOut._silentNode.gain.value = 0; + p5.soundOut._silentNode.connect(p5sound.audiocontext.destination); + return p5sound; +}(sndcore); +var helpers; +helpers = function () { + 'use strict'; + var p5sound = master; + /** + * Returns a number representing the sample rate, in samples per second, + * of all sound objects in this audio context. It is determined by the + * sampling rate of your operating system's sound card, and it is not + * currently possile to change. + * It is often 44100, or twice the range of human hearing. + * + * @method sampleRate + * @return {Number} samplerate samples per second + */ + p5.prototype.sampleRate = function () { + return p5sound.audiocontext.sampleRate; + }; + /** + * Returns the closest MIDI note value for + * a given frequency. + * + * @param {Number} frequency A freqeuncy, for example, the "A" + * above Middle C is 440Hz + * @return {Number} MIDI note value + */ + p5.prototype.freqToMidi = function (f) { + var mathlog2 = Math.log(f / 440) / Math.log(2); + var m = Math.round(12 * mathlog2) + 57; + return m; + }; + /** + * Returns the frequency value of a MIDI note value. + * General MIDI treats notes as integers where middle C + * is 60, C# is 61, D is 62 etc. Useful for generating + * musical frequencies with oscillators. + * + * @method midiToFreq + * @param {Number} midiNote The number of a MIDI note + * @return {Number} Frequency value of the given MIDI note + * @example + *
+ * var notes = [60, 64, 67, 72]; + * var i = 0; + * + * function setup() { + * osc = new p5.Oscillator('Triangle'); + * osc.start(); + * frameRate(1); + * } + * + * function draw() { + * var freq = midiToFreq(notes[i]); + * osc.freq(freq); + * i++; + * if (i >= notes.length){ + * i = 0; + * } + * } + *
+ */ + p5.prototype.midiToFreq = function (m) { + return 440 * Math.pow(2, (m - 69) / 12); + }; + /** + * List the SoundFile formats that you will include. LoadSound + * will search your directory for these extensions, and will pick + * a format that is compatable with the client's web browser. + * Here is a free online file + * converter. + * + * @method soundFormats + * @param {String} formats i.e. 'mp3', 'wav', 'ogg' + * @example + *
+ * function preload() { + * // set the global sound formats + * soundFormats('mp3', 'ogg'); + * + * // load either beatbox.mp3, or .ogg, depending on browser + * mySound = loadSound('../sounds/beatbox.mp3'); + * } + * + * function setup() { + * mySound.play(); + * } + *
+ */ + p5.prototype.soundFormats = function () { + // reset extensions array + p5sound.extensions = []; + // add extensions + for (var i = 0; i < arguments.length; i++) { + arguments[i] = arguments[i].toLowerCase(); + if ([ + 'mp3', + 'wav', + 'ogg', + 'm4a', + 'aac' + ].indexOf(arguments[i]) > -1) { + p5sound.extensions.push(arguments[i]); + } else { + throw arguments[i] + ' is not a valid sound format!'; + } + } + }; + p5.prototype.disposeSound = function () { + for (var i = 0; i < p5sound.soundArray.length; i++) { + p5sound.soundArray[i].dispose(); + } + }; + // register removeSound to dispose of p5sound SoundFiles, Convolvers, + // Oscillators etc when sketch ends + p5.prototype.registerMethod('remove', p5.prototype.disposeSound); + p5.prototype._checkFileFormats = function (paths) { + var path; + // if path is a single string, check to see if extension is provided + if (typeof paths === 'string') { + path = paths; + // see if extension is provided + var extTest = path.split('.').pop(); + // if an extension is provided... + if ([ + 'mp3', + 'wav', + 'ogg', + 'm4a', + 'aac' + ].indexOf(extTest) > -1) { + var supported = p5.prototype.isFileSupported(extTest); + if (supported) { + path = path; + } else { + var pathSplit = path.split('.'); + var pathCore = pathSplit[pathSplit.length - 1]; + for (var i = 0; i < p5sound.extensions.length; i++) { + var extension = p5sound.extensions[i]; + var supported = p5.prototype.isFileSupported(extension); + if (supported) { + pathCore = ''; + if (pathSplit.length === 2) { + pathCore += pathSplit[0]; + } + for (var i = 1; i <= pathSplit.length - 2; i++) { + var p = pathSplit[i]; + pathCore += '.' + p; + } + path = pathCore += '.'; + path = path += extension; + break; + } + } + } + } else { + for (var i = 0; i < p5sound.extensions.length; i++) { + var extension = p5sound.extensions[i]; + var supported = p5.prototype.isFileSupported(extension); + if (supported) { + path = path + '.' + extension; + break; + } + } + } + } else if (typeof paths === 'object') { + for (var i = 0; i < paths.length; i++) { + var extension = paths[i].split('.').pop(); + var supported = p5.prototype.isFileSupported(extension); + if (supported) { + // console.log('.'+extension + ' is ' + supported + + // ' supported by your browser.'); + path = paths[i]; + break; + } + } + } + return path; + }; + /** + * Used by Osc and Env to chain signal math + */ + p5.prototype._mathChain = function (o, math, thisChain, nextChain, type) { + // if this type of math already exists in the chain, replace it + for (var i in o.mathOps) { + if (o.mathOps[i] instanceof type) { + o.mathOps[i].dispose(); + thisChain = i; + if (thisChain < o.mathOps.length - 1) { + nextChain = o.mathOps[i + 1]; + } + } + } + o.mathOps[thisChain - 1].disconnect(); + o.mathOps[thisChain - 1].connect(math); + math.connect(nextChain); + o.mathOps[thisChain] = math; + return o; + }; +}(master); +var errorHandler; +errorHandler = function () { + 'use strict'; + /** + * Helper function to generate an error + * with a custom stack trace that points to the sketch + * and removes other parts of the stack trace. + * + * @private + * + * @param {String} name custom error name + * @param {String} errorTrace custom error trace + * @param {String} failedPath path to the file that failed to load + * @property {String} name custom error name + * @property {String} message custom error message + * @property {String} stack trace the error back to a line in the user's sketch. + * Note: this edits out stack trace within p5.js and p5.sound. + * @property {String} originalStack unedited, original stack trace + * @property {String} failedPath path to the file that failed to load + * @return {Error} returns a custom Error object + */ + var CustomError = function (name, errorTrace, failedPath) { + var err = new Error(); + var tempStack, splitStack; + err.name = name; + err.originalStack = err.stack + errorTrace; + tempStack = err.stack + errorTrace; + err.failedPath = failedPath; + // only print the part of the stack trace that refers to the user code: + var splitStack = tempStack.split('\n'); + splitStack = splitStack.filter(function (ln) { + return !ln.match(/(p5.|native code|globalInit)/g); + }); + err.stack = splitStack.join('\n'); + return err; + }; + return CustomError; +}(); +var panner; +panner = function () { + 'use strict'; + var p5sound = master; + var ac = p5sound.audiocontext; + // Stereo panner + // if there is a stereo panner node use it + if (typeof ac.createStereoPanner !== 'undefined') { + p5.Panner = function (input, output, numInputChannels) { + this.stereoPanner = this.input = ac.createStereoPanner(); + input.connect(this.stereoPanner); + this.stereoPanner.connect(output); + }; + p5.Panner.prototype.pan = function (val, tFromNow) { + var time = tFromNow || 0; + var t = ac.currentTime + time; + this.stereoPanner.pan.linearRampToValueAtTime(val, t); + }; + p5.Panner.prototype.inputChannels = function (numChannels) { + }; + p5.Panner.prototype.connect = function (obj) { + this.stereoPanner.connect(obj); + }; + p5.Panner.prototype.disconnect = function (obj) { + this.stereoPanner.disconnect(); + }; + } else { + // if there is no createStereoPanner object + // such as in safari 7.1.7 at the time of writing this + // use this method to create the effect + p5.Panner = function (input, output, numInputChannels) { + this.input = ac.createGain(); + input.connect(this.input); + this.left = ac.createGain(); + this.right = ac.createGain(); + this.left.channelInterpretation = 'discrete'; + this.right.channelInterpretation = 'discrete'; + // if input is stereo + if (numInputChannels > 1) { + this.splitter = ac.createChannelSplitter(2); + this.input.connect(this.splitter); + this.splitter.connect(this.left, 1); + this.splitter.connect(this.right, 0); + } else { + this.input.connect(this.left); + this.input.connect(this.right); + } + this.output = ac.createChannelMerger(2); + this.left.connect(this.output, 0, 1); + this.right.connect(this.output, 0, 0); + this.output.connect(output); + }; + // -1 is left, +1 is right + p5.Panner.prototype.pan = function (val, tFromNow) { + var time = tFromNow || 0; + var t = ac.currentTime + time; + var v = (val + 1) / 2; + var rightVal = Math.cos(v * Math.PI / 2); + var leftVal = Math.sin(v * Math.PI / 2); + this.left.gain.linearRampToValueAtTime(leftVal, t); + this.right.gain.linearRampToValueAtTime(rightVal, t); + }; + p5.Panner.prototype.inputChannels = function (numChannels) { + if (numChannels === 1) { + this.input.disconnect(); + this.input.connect(this.left); + this.input.connect(this.right); + } else if (numChannels === 2) { + if (typeof (this.splitter === 'undefined')) { + this.splitter = ac.createChannelSplitter(2); + } + this.input.disconnect(); + this.input.connect(this.splitter); + this.splitter.connect(this.left, 1); + this.splitter.connect(this.right, 0); + } + }; + p5.Panner.prototype.connect = function (obj) { + this.output.connect(obj); + }; + p5.Panner.prototype.disconnect = function (obj) { + this.output.disconnect(); + }; + } + // 3D panner + p5.Panner3D = function (input, output) { + var panner3D = ac.createPanner(); + panner3D.panningModel = 'HRTF'; + panner3D.distanceModel = 'linear'; + panner3D.setPosition(0, 0, 0); + input.connect(panner3D); + panner3D.connect(output); + panner3D.pan = function (xVal, yVal, zVal) { + panner3D.setPosition(xVal, yVal, zVal); + }; + return panner3D; + }; +}(master); +var soundfile; +soundfile = function () { + 'use strict'; + var CustomError = errorHandler; + var p5sound = master; + var ac = p5sound.audiocontext; + /** + *

SoundFile object with a path to a file.

+ * + *

The p5.SoundFile may not be available immediately because + * it loads the file information asynchronously.

+ * + *

To do something with the sound as soon as it loads + * pass the name of a function as the second parameter.

+ * + *

Only one file path is required. However, audio file formats + * (i.e. mp3, ogg, wav and m4a/aac) are not supported by all + * web browsers. If you want to ensure compatability, instead of a single + * file path, you may include an Array of filepaths, and the browser will + * choose a format that works.

+ * + * @class p5.SoundFile + * @constructor + * @param {String|Array} path path to a sound file (String). Optionally, + * you may include multiple file formats in + * an array. Alternately, accepts an object + * from the HTML5 File API, or a p5.File. + * @param {Function} [successCallback] Name of a function to call once file loads + * @param {Function} [errorCallback] Name of a function to call if file fails to + * load. This function will receive an error or + * XMLHttpRequest object with information + * about what went wrong. + * @param {Function} [whileLoadingCallback] Name of a function to call while file + * is loading. That function will + * receive progress of the request to + * load the sound file + * (between 0 and 1) as its first + * parameter. This progress + * does not account for the additional + * time needed to decode the audio data. + * + * @return {Object} p5.SoundFile Object + * @example + *
+ * + * function preload() { + * mySound = loadSound('assets/doorbell.mp3'); + * } + * + * function setup() { + * mySound.setVolume(0.1); + * mySound.play(); + * } + * + *
+ */ + p5.SoundFile = function (paths, onload, onerror, whileLoading) { + if (typeof paths !== 'undefined') { + if (typeof paths == 'string' || typeof paths[0] == 'string') { + var path = p5.prototype._checkFileFormats(paths); + this.url = path; + } else if (typeof paths == 'object') { + if (!(window.File && window.FileReader && window.FileList && window.Blob)) { + // The File API isn't supported in this browser + throw 'Unable to load file because the File API is not supported'; + } + } + // if type is a p5.File...get the actual file + if (paths.file) { + paths = paths.file; + } + this.file = paths; + } + // private _onended callback, set by the method: onended(callback) + this._onended = function () { + }; + this._looping = false; + this._playing = false; + this._paused = false; + this._pauseTime = 0; + // cues for scheduling events with addCue() removeCue() + this._cues = []; + // position of the most recently played sample + this._lastPos = 0; + this._counterNode; + this._scopeNode; + // array of sources so that they can all be stopped! + this.bufferSourceNodes = []; + // current source + this.bufferSourceNode = null; + this.buffer = null; + this.playbackRate = 1; + this.gain = 1; + this.input = p5sound.audiocontext.createGain(); + this.output = p5sound.audiocontext.createGain(); + this.reversed = false; + // start and end of playback / loop + this.startTime = 0; + this.endTime = null; + this.pauseTime = 0; + // "restart" would stop playback before retriggering + this.mode = 'sustain'; + // time that playback was started, in millis + this.startMillis = null; + // stereo panning + this.panPosition = 0; + this.panner = new p5.Panner(this.output, p5sound.input, 2); + // it is possible to instantiate a soundfile with no path + if (this.url || this.file) { + this.load(onload, onerror); + } + // add this p5.SoundFile to the soundArray + p5sound.soundArray.push(this); + if (typeof whileLoading === 'function') { + this._whileLoading = whileLoading; + } else { + this._whileLoading = function () { + }; + } + }; + // register preload handling of loadSound + p5.prototype.registerPreloadMethod('loadSound', p5.prototype); + /** + * loadSound() returns a new p5.SoundFile from a specified + * path. If called during preload(), the p5.SoundFile will be ready + * to play in time for setup() and draw(). If called outside of + * preload, the p5.SoundFile will not be ready immediately, so + * loadSound accepts a callback as the second parameter. Using a + * + * local server is recommended when loading external files. + * + * @method loadSound + * @param {String|Array} path Path to the sound file, or an array with + * paths to soundfiles in multiple formats + * i.e. ['sound.ogg', 'sound.mp3']. + * Alternately, accepts an object: either + * from the HTML5 File API, or a p5.File. + * @param {Function} [successCallback] Name of a function to call once file loads + * @param {Function} [errorCallback] Name of a function to call if there is + * an error loading the file. + * @param {Function} [whileLoading] Name of a function to call while file is loading. + * This function will receive the percentage loaded + * so far, from 0.0 to 1.0. + * @return {SoundFile} Returns a p5.SoundFile + * @example + *
+ * function preload() { + * mySound = loadSound('assets/doorbell.mp3'); + * } + * + * function setup() { + * mySound.setVolume(0.1); + * mySound.play(); + * } + *
+ */ + p5.prototype.loadSound = function (path, callback, onerror, whileLoading) { + // if loading locally without a server + if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { + alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); + } + var s = new p5.SoundFile(path, callback, onerror, whileLoading); + return s; + }; + /** + * This is a helper function that the p5.SoundFile calls to load + * itself. Accepts a callback (the name of another function) + * as an optional parameter. + * + * @private + * @param {Function} [successCallback] Name of a function to call once file loads + * @param {Function} [errorCallback] Name of a function to call if there is an error + */ + p5.SoundFile.prototype.load = function (callback, errorCallback) { + var loggedError = false; + var self = this; + var errorTrace = new Error().stack; + if (this.url != undefined && this.url != '') { + var request = new XMLHttpRequest(); + request.addEventListener('progress', function (evt) { + self._updateProgress(evt); + }, false); + request.open('GET', this.url, true); + request.responseType = 'arraybuffer'; + request.onload = function () { + if (request.status == 200) { + // on sucess loading file: + ac.decodeAudioData(request.response, // success decoding buffer: + function (buff) { + self.buffer = buff; + self.panner.inputChannels(buff.numberOfChannels); + if (callback) { + callback(self); + } + }, // error decoding buffer. "e" is undefined in Chrome 11/22/2015 + function (e) { + var err = new CustomError('decodeAudioData', errorTrace, self.url); + var msg = 'AudioContext error at decodeAudioData for ' + self.url; + if (errorCallback) { + err.msg = msg; + errorCallback(err); + } else { + console.error(msg + '\n The error stack trace includes: \n' + err.stack); + } + }); + } else { + var err = new CustomError('loadSound', errorTrace, self.url); + var msg = 'Unable to load ' + self.url + '. The request status was: ' + request.status + ' (' + request.statusText + ')'; + if (errorCallback) { + err.message = msg; + errorCallback(err); + } else { + console.error(msg + '\n The error stack trace includes: \n' + err.stack); + } + } + }; + // if there is another error, aside from 404... + request.onerror = function (e) { + var err = new CustomError('loadSound', errorTrace, self.url); + var msg = 'There was no response from the server at ' + self.url + '. Check the url and internet connectivity.'; + if (errorCallback) { + err.message = msg; + errorCallback(err); + } else { + console.error(msg + '\n The error stack trace includes: \n' + err.stack); + } + }; + request.send(); + } else if (this.file != undefined) { + var reader = new FileReader(); + var self = this; + reader.onload = function () { + ac.decodeAudioData(reader.result, function (buff) { + self.buffer = buff; + self.panner.inputChannels(buff.numberOfChannels); + if (callback) { + callback(self); + } + }); + }; + reader.onerror = function (e) { + if (onerror) + onerror(e); + }; + reader.readAsArrayBuffer(this.file); + } + }; + // TO DO: use this method to create a loading bar that shows progress during file upload/decode. + p5.SoundFile.prototype._updateProgress = function (evt) { + if (evt.lengthComputable) { + var percentComplete = evt.loaded / evt.total * 0.99; + this._whileLoading(percentComplete, evt); + } else { + // Unable to compute progress information since the total size is unknown + this._whileLoading('size unknown'); + } + }; + /** + * Returns true if the sound file finished loading successfully. + * + * @method isLoaded + * @return {Boolean} + */ + p5.SoundFile.prototype.isLoaded = function () { + if (this.buffer) { + return true; + } else { + return false; + } + }; + /** + * Play the p5.SoundFile + * + * @method play + * @param {Number} [startTime] (optional) schedule playback to start (in seconds from now). + * @param {Number} [rate] (optional) playback rate + * @param {Number} [amp] (optional) amplitude (volume) + * of playback + * @param {Number} [cueStart] (optional) cue start time in seconds + * @param {Number} [duration] (optional) duration of playback in seconds + */ + p5.SoundFile.prototype.play = function (time, rate, amp, _cueStart, duration) { + var self = this; + var now = p5sound.audiocontext.currentTime; + var cueStart, cueEnd; + var time = time || 0; + if (time < 0) { + time = 0; + } + time = time + now; + // TO DO: if already playing, create array of buffers for easy stop() + if (this.buffer) { + // reset the pause time (if it was paused) + this._pauseTime = 0; + // handle restart playmode + if (this.mode === 'restart' && this.buffer && this.bufferSourceNode) { + var now = p5sound.audiocontext.currentTime; + this.bufferSourceNode.stop(time); + this._counterNode.stop(time); + } + // set playback rate + if (rate) + this.playbackRate = rate; + // make a new source and counter. They are automatically assigned playbackRate and buffer + this.bufferSourceNode = this._initSourceNode(); + // garbage collect counterNode and create a new one + if (this._counterNode) + this._counterNode = undefined; + this._counterNode = this._initCounterNode(); + if (_cueStart) { + if (_cueStart >= 0 && _cueStart < this.buffer.duration) { + // this.startTime = cueStart; + cueStart = _cueStart; + } else { + throw 'start time out of range'; + } + } else { + cueStart = 0; + } + if (duration) { + // if duration is greater than buffer.duration, just play entire file anyway rather than throw an error + duration = duration <= this.buffer.duration - cueStart ? duration : this.buffer.duration; + } else { + duration = this.buffer.duration - cueStart; + } + // TO DO: Fix this. It broke in Safari + // + // method of controlling gain for individual bufferSourceNodes, without resetting overall soundfile volume + // if (typeof(this.bufferSourceNode.gain === 'undefined' ) ) { + // this.bufferSourceNode.gain = p5sound.audiocontext.createGain(); + // } + // this.bufferSourceNode.connect(this.bufferSourceNode.gain); + // set local amp if provided, otherwise 1 + var a = amp || 1; + // this.bufferSourceNode.gain.gain.setValueAtTime(a, p5sound.audiocontext.currentTime); + // this.bufferSourceNode.gain.connect(this.output); + this.bufferSourceNode.connect(this.output); + this.output.gain.value = a; + // if it was paused, play at the pause position + if (this._paused) { + this.bufferSourceNode.start(time, this.pauseTime, duration); + this._counterNode.start(time, this.pauseTime, duration); + } else { + this.bufferSourceNode.start(time, cueStart, duration); + this._counterNode.start(time, cueStart, duration); + } + this._playing = true; + this._paused = false; + // add source to sources array, which is used in stopAll() + this.bufferSourceNodes.push(this.bufferSourceNode); + this.bufferSourceNode._arrayIndex = this.bufferSourceNodes.length - 1; + // delete this.bufferSourceNode from the sources array when it is done playing: + var clearOnEnd = function (e) { + this._playing = false; + this.removeEventListener('ended', clearOnEnd, false); + // call the onended callback + self._onended(self); + self.bufferSourceNodes.forEach(function (n, i) { + if (n._playing === false) { + self.bufferSourceNodes.splice(i); + } + }); + if (self.bufferSourceNodes.length === 0) { + self._playing = false; + } + }; + this.bufferSourceNode.onended = clearOnEnd; + } else { + throw 'not ready to play file, buffer has yet to load. Try preload()'; + } + // if looping, will restart at original time + this.bufferSourceNode.loop = this._looping; + this._counterNode.loop = this._looping; + if (this._looping === true) { + var cueEnd = cueStart + duration; + this.bufferSourceNode.loopStart = cueStart; + this.bufferSourceNode.loopEnd = cueEnd; + this._counterNode.loopStart = cueStart; + this._counterNode.loopEnd = cueEnd; + } + }; + /** + * p5.SoundFile has two play modes: restart and + * sustain. Play Mode determines what happens to a + * p5.SoundFile if it is triggered while in the middle of playback. + * In sustain mode, playback will continue simultaneous to the + * new playback. In restart mode, play() will stop playback + * and start over. Sustain is the default mode. + * + * @method playMode + * @param {String} str 'restart' or 'sustain' + * @example + *
+ * function setup(){ + * mySound = loadSound('assets/Damscray_DancingTiger.mp3'); + * } + * function mouseClicked() { + * mySound.playMode('sustain'); + * mySound.play(); + * } + * function keyPressed() { + * mySound.playMode('restart'); + * mySound.play(); + * } + * + *
+ */ + p5.SoundFile.prototype.playMode = function (str) { + var s = str.toLowerCase(); + // if restart, stop all other sounds from playing + if (s === 'restart' && this.buffer && this.bufferSourceNode) { + for (var i = 0; i < this.bufferSourceNodes.length - 1; i++) { + var now = p5sound.audiocontext.currentTime; + this.bufferSourceNodes[i].stop(now); + } + } + // set play mode to effect future playback + if (s === 'restart' || s === 'sustain') { + this.mode = s; + } else { + throw 'Invalid play mode. Must be either "restart" or "sustain"'; + } + }; + /** + * Pauses a file that is currently playing. If the file is not + * playing, then nothing will happen. + * + * After pausing, .play() will resume from the paused + * position. + * If p5.SoundFile had been set to loop before it was paused, + * it will continue to loop after it is unpaused with .play(). + * + * @method pause + * @param {Number} [startTime] (optional) schedule event to occur + * seconds from now + * @example + *
+ * var soundFile; + * + * function preload() { + * soundFormats('ogg', 'mp3'); + * soundFile = loadSound('assets/Damscray_-_Dancing_Tiger_02.mp3'); + * } + * function setup() { + * background(0, 255, 0); + * soundFile.setVolume(0.1); + * soundFile.loop(); + * } + * function keyTyped() { + * if (key == 'p') { + * soundFile.pause(); + * background(255, 0, 0); + * } + * } + * + * function keyReleased() { + * if (key == 'p') { + * soundFile.play(); + * background(0, 255, 0); + * } + * } + * + *
+ */ + p5.SoundFile.prototype.pause = function (time) { + var now = p5sound.audiocontext.currentTime; + var time = time || 0; + var pTime = time + now; + if (this.isPlaying() && this.buffer && this.bufferSourceNode) { + this.pauseTime = this.currentTime(); + this.bufferSourceNode.stop(pTime); + this._counterNode.stop(pTime); + this._paused = true; + this._playing = false; + this._pauseTime = this.currentTime(); + } else { + this._pauseTime = 0; + } + }; + /** + * Loop the p5.SoundFile. Accepts optional parameters to set the + * playback rate, playback volume, loopStart, loopEnd. + * + * @method loop + * @param {Number} [startTime] (optional) schedule event to occur + * seconds from now + * @param {Number} [rate] (optional) playback rate + * @param {Number} [amp] (optional) playback volume + * @param {Number} [cueLoopStart](optional) startTime in seconds + * @param {Number} [duration] (optional) loop duration in seconds + */ + p5.SoundFile.prototype.loop = function (startTime, rate, amp, loopStart, duration) { + this._looping = true; + this.play(startTime, rate, amp, loopStart, duration); + }; + /** + * Set a p5.SoundFile's looping flag to true or false. If the sound + * is currently playing, this change will take effect when it + * reaches the end of the current playback. + * + * @param {Boolean} Boolean set looping to true or false + */ + p5.SoundFile.prototype.setLoop = function (bool) { + if (bool === true) { + this._looping = true; + } else if (bool === false) { + this._looping = false; + } else { + throw 'Error: setLoop accepts either true or false'; + } + if (this.bufferSourceNode) { + this.bufferSourceNode.loop = this._looping; + this._counterNode.loop = this._looping; + } + }; + /** + * Returns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not. + * + * @return {Boolean} + */ + p5.SoundFile.prototype.isLooping = function () { + if (!this.bufferSourceNode) { + return false; + } + if (this._looping === true && this.isPlaying() === true) { + return true; + } + return false; + }; + /** + * Returns true if a p5.SoundFile is playing, false if not (i.e. + * paused or stopped). + * + * @method isPlaying + * @return {Boolean} + */ + p5.SoundFile.prototype.isPlaying = function () { + return this._playing; + }; + /** + * Returns true if a p5.SoundFile is paused, false if not (i.e. + * playing or stopped). + * + * @method isPaused + * @return {Boolean} + */ + p5.SoundFile.prototype.isPaused = function () { + return this._paused; + }; + /** + * Stop soundfile playback. + * + * @method stop + * @param {Number} [startTime] (optional) schedule event to occur + * in seconds from now + */ + p5.SoundFile.prototype.stop = function (timeFromNow) { + var time = timeFromNow || 0; + if (this.mode == 'sustain') { + this.stopAll(time); + this._playing = false; + this.pauseTime = 0; + this._paused = false; + } else if (this.buffer && this.bufferSourceNode) { + var now = p5sound.audiocontext.currentTime; + var t = time || 0; + this.pauseTime = 0; + this.bufferSourceNode.stop(now + t); + this._counterNode.stop(now + t); + this._playing = false; + this._paused = false; + } + }; + /** + * Stop playback on all of this soundfile's sources. + * @private + */ + p5.SoundFile.prototype.stopAll = function (_time) { + var now = p5sound.audiocontext.currentTime; + var time = _time || 0; + if (this.buffer && this.bufferSourceNode) { + for (var i = 0; i < this.bufferSourceNodes.length; i++) { + if (typeof this.bufferSourceNodes[i] != undefined) { + try { + this.bufferSourceNodes[i].onended = function () { + }; + this.bufferSourceNodes[i].stop(now + time); + } catch (e) { + } + } + } + this._counterNode.stop(now + time); + this._onended(this); + } + }; + /** + * Multiply the output volume (amplitude) of a sound file + * between 0.0 (silence) and 1.0 (full volume). + * 1.0 is the maximum amplitude of a digital sound, so multiplying + * by greater than 1.0 may cause digital distortion. To + * fade, provide a rampTime parameter. For more + * complex fades, see the Env class. + * + * Alternately, you can pass in a signal source such as an + * oscillator to modulate the amplitude with an audio signal. + * + * @method setVolume + * @param {Number|Object} volume Volume (amplitude) between 0.0 + * and 1.0 or modulating signal/oscillator + * @param {Number} [rampTime] Fade for t seconds + * @param {Number} [timeFromNow] Schedule this event to happen at + * t seconds in the future + */ + p5.SoundFile.prototype.setVolume = function (vol, rampTime, tFromNow) { + if (typeof vol === 'number') { + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var now = p5sound.audiocontext.currentTime; + var currentVol = this.output.gain.value; + this.output.gain.cancelScheduledValues(now + tFromNow); + this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); + this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); + } else if (vol) { + vol.connect(this.output.gain); + } else { + // return the Gain Node + return this.output.gain; + } + }; + // same as setVolume, to match Processing Sound + p5.SoundFile.prototype.amp = p5.SoundFile.prototype.setVolume; + // these are the same thing + p5.SoundFile.prototype.fade = p5.SoundFile.prototype.setVolume; + p5.SoundFile.prototype.getVolume = function () { + return this.output.gain.value; + }; + /** + * Set the stereo panning of a p5.sound object to + * a floating point number between -1.0 (left) and 1.0 (right). + * Default is 0.0 (center). + * + * @method pan + * @param {Number} [panValue] Set the stereo panner + * @param {Number} timeFromNow schedule this event to happen + * seconds from now + * @example + *
+ * + * var ball = {}; + * var soundFile; + * + * function setup() { + * soundFormats('ogg', 'mp3'); + * soundFile = loadSound('assets/beatbox.mp3'); + * } + * + * function draw() { + * background(0); + * ball.x = constrain(mouseX, 0, width); + * ellipse(ball.x, height/2, 20, 20) + * } + * + * function mousePressed(){ + * // map the ball's x location to a panning degree + * // between -1.0 (left) and 1.0 (right) + * var panning = map(ball.x, 0., width,-1.0, 1.0); + * soundFile.pan(panning); + * soundFile.play(); + * } + *
+ */ + p5.SoundFile.prototype.pan = function (pval, tFromNow) { + this.panPosition = pval; + this.panner.pan(pval, tFromNow); + }; + /** + * Returns the current stereo pan position (-1.0 to 1.0) + * + * @return {Number} Returns the stereo pan setting of the Oscillator + * as a number between -1.0 (left) and 1.0 (right). + * 0.0 is center and default. + */ + p5.SoundFile.prototype.getPan = function () { + return this.panPosition; + }; + /** + * Set the playback rate of a sound file. Will change the speed and the pitch. + * Values less than zero will reverse the audio buffer. + * + * @method rate + * @param {Number} [playbackRate] Set the playback rate. 1.0 is normal, + * .5 is half-speed, 2.0 is twice as fast. + * Values less than zero play backwards. + * @example + *
+ * var song; + * + * function preload() { + * song = loadSound('assets/Damscray_DancingTiger.mp3'); + * } + * + * function setup() { + * song.loop(); + * } + * + * function draw() { + * background(200); + * + * // Set the rate to a range between 0.1 and 4 + * // Changing the rate also alters the pitch + * var speed = map(mouseY, 0.1, height, 0, 2); + * speed = constrain(speed, 0.01, 4); + * song.rate(speed); + * + * // Draw a circle to show what is going on + * stroke(0); + * fill(51, 100); + * ellipse(mouseX, 100, 48, 48); + * } + * + * + *
+ * + */ + p5.SoundFile.prototype.rate = function (playbackRate) { + if (this.playbackRate === playbackRate && this.bufferSourceNode) { + if (this.bufferSourceNode.playbackRate.value === playbackRate) { + return; + } + } + this.playbackRate = playbackRate; + var rate = playbackRate; + if (this.playbackRate === 0 && this._playing) { + this.pause(); + } + if (this.playbackRate < 0 && !this.reversed) { + var cPos = this.currentTime(); + var cRate = this.bufferSourceNode.playbackRate.value; + // this.pause(); + this.reverseBuffer(); + rate = Math.abs(playbackRate); + var newPos = (cPos - this.duration()) / rate; + this.pauseTime = newPos; + } else if (this.playbackRate > 0 && this.reversed) { + this.reverseBuffer(); + } + if (this.bufferSourceNode) { + var now = p5sound.audiocontext.currentTime; + this.bufferSourceNode.playbackRate.cancelScheduledValues(now); + this.bufferSourceNode.playbackRate.linearRampToValueAtTime(Math.abs(rate), now); + this._counterNode.playbackRate.cancelScheduledValues(now); + this._counterNode.playbackRate.linearRampToValueAtTime(Math.abs(rate), now); + } + }; + // TO DO: document this + p5.SoundFile.prototype.setPitch = function (num) { + var newPlaybackRate = midiToFreq(num) / midiToFreq(60); + this.rate(newPlaybackRate); + }; + p5.SoundFile.prototype.getPlaybackRate = function () { + return this.playbackRate; + }; + /** + * Returns the duration of a sound file in seconds. + * + * @method duration + * @return {Number} The duration of the soundFile in seconds. + */ + p5.SoundFile.prototype.duration = function () { + // Return Duration + if (this.buffer) { + return this.buffer.duration; + } else { + return 0; + } + }; + /** + * Return the current position of the p5.SoundFile playhead, in seconds. + * Note that if you change the playbackRate while the p5.SoundFile is + * playing, the results may not be accurate. + * + * @method currentTime + * @return {Number} currentTime of the soundFile in seconds. + */ + p5.SoundFile.prototype.currentTime = function () { + // TO DO --> make reverse() flip these values appropriately + if (this._pauseTime > 0) { + return this._pauseTime; + } else { + return this._lastPos / ac.sampleRate; + } + }; + /** + * Move the playhead of the song to a position, in seconds. Start + * and Stop time. If none are given, will reset the file to play + * entire duration from start to finish. + * + * @method jump + * @param {Number} cueTime cueTime of the soundFile in seconds. + * @param {Number} duration duration in seconds. + */ + p5.SoundFile.prototype.jump = function (cueTime, duration) { + if (cueTime < 0 || cueTime > this.buffer.duration) { + throw 'jump time out of range'; + } + if (duration > this.buffer.duration - cueTime) { + throw 'end time out of range'; + } + var cTime = cueTime || 0; + var eTime = duration || this.buffer.duration - cueTime; + if (this.isPlaying()) { + this.stop(); + } + this.play(0, this.playbackRate, this.output.gain.value, cTime, eTime); + }; + /** + * Return the number of channels in a sound file. + * For example, Mono = 1, Stereo = 2. + * + * @method channels + * @return {Number} [channels] + */ + p5.SoundFile.prototype.channels = function () { + return this.buffer.numberOfChannels; + }; + /** + * Return the sample rate of the sound file. + * + * @method sampleRate + * @return {Number} [sampleRate] + */ + p5.SoundFile.prototype.sampleRate = function () { + return this.buffer.sampleRate; + }; + /** + * Return the number of samples in a sound file. + * Equal to sampleRate * duration. + * + * @method frames + * @return {Number} [sampleCount] + */ + p5.SoundFile.prototype.frames = function () { + return this.buffer.length; + }; + /** + * Returns an array of amplitude peaks in a p5.SoundFile that can be + * used to draw a static waveform. Scans through the p5.SoundFile's + * audio buffer to find the greatest amplitudes. Accepts one + * parameter, 'length', which determines size of the array. + * Larger arrays result in more precise waveform visualizations. + * + * Inspired by Wavesurfer.js. + * + * @method getPeaks + * @params {Number} [length] length is the size of the returned array. + * Larger length results in more precision. + * Defaults to 5*width of the browser window. + * @returns {Float32Array} Array of peaks. + */ + p5.SoundFile.prototype.getPeaks = function (length) { + if (this.buffer) { + // set length to window's width if no length is provided + if (!length) { + length = window.width * 5; + } + if (this.buffer) { + var buffer = this.buffer; + var sampleSize = buffer.length / length; + var sampleStep = ~~(sampleSize / 10) || 1; + var channels = buffer.numberOfChannels; + var peaks = new Float32Array(Math.round(length)); + for (var c = 0; c < channels; c++) { + var chan = buffer.getChannelData(c); + for (var i = 0; i < length; i++) { + var start = ~~(i * sampleSize); + var end = ~~(start + sampleSize); + var max = 0; + for (var j = start; j < end; j += sampleStep) { + var value = chan[j]; + if (value > max) { + max = value; + } else if (-value > max) { + max = value; + } + } + if (c === 0 || Math.abs(max) > peaks[i]) { + peaks[i] = max; + } + } + } + return peaks; + } + } else { + throw 'Cannot load peaks yet, buffer is not loaded'; + } + }; + /** + * Reverses the p5.SoundFile's buffer source. + * Playback must be handled separately (see example). + * + * @method reverseBuffer + * @example + *
+ * var drum; + * + * function preload() { + * drum = loadSound('assets/drum.mp3'); + * } + * + * function setup() { + * drum.reverseBuffer(); + * drum.play(); + * } + * + * + *
+ */ + p5.SoundFile.prototype.reverseBuffer = function () { + var curVol = this.getVolume(); + this.setVolume(0, 0.01, 0); + this.pause(); + if (this.buffer) { + for (var i = 0; i < this.buffer.numberOfChannels; i++) { + Array.prototype.reverse.call(this.buffer.getChannelData(i)); + } + // set reversed flag + this.reversed = !this.reversed; + } else { + throw 'SoundFile is not done loading'; + } + this.setVolume(curVol, 0.01, 0.0101); + this.play(); + }; + /** + * Schedule an event to be called when the soundfile + * reaches the end of a buffer. If the soundfile is + * playing through once, this will be called when it + * ends. If it is looping, it will be called when + * stop is called. + * + * @method onended + * @param {Function} callback function to call when the + * soundfile has ended. + */ + p5.SoundFile.prototype.onended = function (callback) { + this._onended = callback; + return this; + }; + p5.SoundFile.prototype.add = function () { + }; + p5.SoundFile.prototype.dispose = function () { + var now = p5sound.audiocontext.currentTime; + // remove reference to soundfile + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.stop(now); + if (this.buffer && this.bufferSourceNode) { + for (var i = 0; i < this.bufferSourceNodes.length - 1; i++) { + if (this.bufferSourceNodes[i] !== null) { + this.bufferSourceNodes[i].disconnect(); + try { + this.bufferSourceNodes[i].stop(now); + } catch (e) { + } + this.bufferSourceNodes[i] = null; + } + } + if (this.isPlaying()) { + try { + this._counterNode.stop(now); + } catch (e) { + console.log(e); + } + this._counterNode = null; + } + } + if (this.output) { + this.output.disconnect(); + this.output = null; + } + if (this.panner) { + this.panner.disconnect(); + this.panner = null; + } + }; + /** + * Connects the output of a p5sound object to input of another + * p5.sound object. For example, you may connect a p5.SoundFile to an + * FFT or an Effect. If no parameter is given, it will connect to + * the master output. Most p5sound objects connect to the master + * output when they are created. + * + * @method connect + * @param {Object} [object] Audio object that accepts an input + */ + p5.SoundFile.prototype.connect = function (unit) { + if (!unit) { + this.panner.connect(p5sound.input); + } else { + if (unit.hasOwnProperty('input')) { + this.panner.connect(unit.input); + } else { + this.panner.connect(unit); + } + } + }; + /** + * Disconnects the output of this p5sound object. + * + * @method disconnect + */ + p5.SoundFile.prototype.disconnect = function () { + this.panner.disconnect(); + }; + /** + */ + p5.SoundFile.prototype.getLevel = function (smoothing) { + console.warn('p5.SoundFile.getLevel has been removed from the library. Use p5.Amplitude instead'); + }; + /** + * Reset the source for this SoundFile to a + * new path (URL). + * + * @method setPath + * @param {String} path path to audio file + * @param {Function} callback Callback + */ + p5.SoundFile.prototype.setPath = function (p, callback) { + var path = p5.prototype._checkFileFormats(p); + this.url = path; + this.load(callback); + }; + /** + * Replace the current Audio Buffer with a new Buffer. + * + * @param {Array} buf Array of Float32 Array(s). 2 Float32 Arrays + * will create a stereo source. 1 will create + * a mono source. + */ + p5.SoundFile.prototype.setBuffer = function (buf) { + var numChannels = buf.length; + var size = buf[0].length; + var newBuffer = ac.createBuffer(numChannels, size, ac.sampleRate); + if (!buf[0] instanceof Float32Array) { + buf[0] = new Float32Array(buf[0]); + } + for (var channelNum = 0; channelNum < numChannels; channelNum++) { + var channel = newBuffer.getChannelData(channelNum); + channel.set(buf[channelNum]); + } + this.buffer = newBuffer; + // set numbers of channels on input to the panner + this.panner.inputChannels(numChannels); + }; + ////////////////////////////////////////////////// + // script processor node with an empty buffer to help + // keep a sample-accurate position in playback buffer. + // Inspired by Chinmay Pendharkar's technique for Sonoport --> http://bit.ly/1HwdCsV + // Copyright [2015] [Sonoport (Asia) Pte. Ltd.], + // Licensed under the Apache License http://apache.org/licenses/LICENSE-2.0 + //////////////////////////////////////////////////////////////////////////////////// + // initialize counterNode, set its initial buffer and playbackRate + p5.SoundFile.prototype._initCounterNode = function () { + var self = this; + var now = ac.currentTime; + var cNode = ac.createBufferSource(); + // dispose of scope node if it already exists + if (self._scopeNode) { + self._scopeNode.disconnect(); + self._scopeNode.onaudioprocess = undefined; + self._scopeNode = null; + } + self._scopeNode = ac.createScriptProcessor(256, 1, 1); + // create counter buffer of the same length as self.buffer + cNode.buffer = _createCounterBuffer(self.buffer); + cNode.playbackRate.setValueAtTime(self.playbackRate, now); + cNode.connect(self._scopeNode); + self._scopeNode.connect(p5.soundOut._silentNode); + self._scopeNode.onaudioprocess = function (processEvent) { + var inputBuffer = processEvent.inputBuffer.getChannelData(0); + // update the lastPos + self._lastPos = inputBuffer[inputBuffer.length - 1] || 0; + // do any callbacks that have been scheduled + self._onTimeUpdate(self._lastPos); + }; + return cNode; + }; + // initialize sourceNode, set its initial buffer and playbackRate + p5.SoundFile.prototype._initSourceNode = function () { + var self = this; + var now = ac.currentTime; + var bufferSourceNode = ac.createBufferSource(); + bufferSourceNode.buffer = self.buffer; + bufferSourceNode.playbackRate.value = self.playbackRate; + return bufferSourceNode; + }; + var _createCounterBuffer = function (buffer) { + var array = new Float32Array(buffer.length); + var audioBuf = ac.createBuffer(1, buffer.length, 44100); + for (var index = 0; index < buffer.length; index++) { + array[index] = index; + } + audioBuf.getChannelData(0).set(array); + return audioBuf; + }; + /** + * processPeaks returns an array of timestamps where it thinks there is a beat. + * + * This is an asynchronous function that processes the soundfile in an offline audio context, + * and sends the results to your callback function. + * + * The process involves running the soundfile through a lowpass filter, and finding all of the + * peaks above the initial threshold. If the total number of peaks are below the minimum number of peaks, + * it decreases the threshold and re-runs the analysis until either minPeaks or minThreshold are reached. + * + * @method processPeaks + * @param {Function} callback a function to call once this data is returned + * @param {Number} [initThreshold] initial threshold defaults to 0.9 + * @param {Number} [minThreshold] minimum threshold defaults to 0.22 + * @param {Number} [minPeaks] minimum number of peaks defaults to 200 + * @return {Array} Array of timestamped peaks + */ + p5.SoundFile.prototype.processPeaks = function (callback, _initThreshold, _minThreshold, _minPeaks) { + var bufLen = this.buffer.length; + var sampleRate = this.buffer.sampleRate; + var buffer = this.buffer; + var initialThreshold = _initThreshold || 0.9, threshold = initialThreshold, minThreshold = _minThreshold || 0.22, minPeaks = _minPeaks || 200; + // Create offline context + var offlineContext = new OfflineAudioContext(1, bufLen, sampleRate); + // create buffer source + var source = offlineContext.createBufferSource(); + source.buffer = buffer; + // Create filter. TO DO: allow custom setting of filter + var filter = offlineContext.createBiquadFilter(); + filter.type = 'lowpass'; + source.connect(filter); + filter.connect(offlineContext.destination); + // start playing at time:0 + source.start(0); + offlineContext.startRendering(); + // Render the song + // act on the result + offlineContext.oncomplete = function (e) { + var data = {}; + var filteredBuffer = e.renderedBuffer; + var bufferData = filteredBuffer.getChannelData(0); + // step 1: + // create Peak instances, add them to array, with strength and sampleIndex + do { + allPeaks = getPeaksAtThreshold(bufferData, threshold); + threshold -= 0.005; + } while (Object.keys(allPeaks).length < minPeaks && threshold >= minThreshold); + // step 2: + // find intervals for each peak in the sampleIndex, add tempos array + var intervalCounts = countIntervalsBetweenNearbyPeaks(allPeaks); + // step 3: find top tempos + var groups = groupNeighborsByTempo(intervalCounts, filteredBuffer.sampleRate); + // sort top intervals + var topTempos = groups.sort(function (intA, intB) { + return intB.count - intA.count; + }).splice(0, 5); + // set this SoundFile's tempo to the top tempo ?? + this.tempo = topTempos[0].tempo; + // step 4: + // new array of peaks at top tempo within a bpmVariance + var bpmVariance = 5; + var tempoPeaks = getPeaksAtTopTempo(allPeaks, topTempos[0].tempo, filteredBuffer.sampleRate, bpmVariance); + callback(tempoPeaks); + }; + }; + // process peaks + var Peak = function (amp, i) { + this.sampleIndex = i; + this.amplitude = amp; + this.tempos = []; + this.intervals = []; + }; + var allPeaks = []; + // 1. for processPeaks() Function to identify peaks above a threshold + // returns an array of peak indexes as frames (samples) of the original soundfile + function getPeaksAtThreshold(data, threshold) { + var peaksObj = {}; + var length = data.length; + for (var i = 0; i < length; i++) { + if (data[i] > threshold) { + var amp = data[i]; + var peak = new Peak(amp, i); + peaksObj[i] = peak; + // Skip forward ~ 1/8s to get past this peak. + i += 6000; + } + i++; + } + return peaksObj; + } + // 2. for processPeaks() + function countIntervalsBetweenNearbyPeaks(peaksObj) { + var intervalCounts = []; + var peaksArray = Object.keys(peaksObj).sort(); + for (var index = 0; index < peaksArray.length; index++) { + // find intervals in comparison to nearby peaks + for (var i = 0; i < 10; i++) { + var startPeak = peaksObj[peaksArray[index]]; + var endPeak = peaksObj[peaksArray[index + i]]; + if (startPeak && endPeak) { + var startPos = startPeak.sampleIndex; + var endPos = endPeak.sampleIndex; + var interval = endPos - startPos; + // add a sample interval to the startPeek in the allPeaks array + if (interval > 0) { + startPeak.intervals.push(interval); + } + // tally the intervals and return interval counts + var foundInterval = intervalCounts.some(function (intervalCount, p) { + if (intervalCount.interval === interval) { + intervalCount.count++; + return intervalCount; + } + }); + // store with JSON like formatting + if (!foundInterval) { + intervalCounts.push({ + interval: interval, + count: 1 + }); + } + } + } + } + return intervalCounts; + } + // 3. for processPeaks --> find tempo + function groupNeighborsByTempo(intervalCounts, sampleRate) { + var tempoCounts = []; + intervalCounts.forEach(function (intervalCount, i) { + try { + // Convert an interval to tempo + var theoreticalTempo = Math.abs(60 / (intervalCount.interval / sampleRate)); + theoreticalTempo = mapTempo(theoreticalTempo); + var foundTempo = tempoCounts.some(function (tempoCount) { + if (tempoCount.tempo === theoreticalTempo) + return tempoCount.count += intervalCount.count; + }); + if (!foundTempo) { + if (isNaN(theoreticalTempo)) { + return; + } + tempoCounts.push({ + tempo: Math.round(theoreticalTempo), + count: intervalCount.count + }); + } + } catch (e) { + throw e; + } + }); + return tempoCounts; + } + // 4. for processPeaks - get peaks at top tempo + function getPeaksAtTopTempo(peaksObj, tempo, sampleRate, bpmVariance) { + var peaksAtTopTempo = []; + var peaksArray = Object.keys(peaksObj).sort(); + // TO DO: filter out peaks that have the tempo and return + for (var i = 0; i < peaksArray.length; i++) { + var key = peaksArray[i]; + var peak = peaksObj[key]; + for (var j = 0; j < peak.intervals.length; j++) { + var intervalBPM = Math.round(Math.abs(60 / (peak.intervals[j] / sampleRate))); + intervalBPM = mapTempo(intervalBPM); + var dif = intervalBPM - tempo; + if (Math.abs(intervalBPM - tempo) < bpmVariance) { + // convert sampleIndex to seconds + peaksAtTopTempo.push(peak.sampleIndex / 44100); + } + } + } + // filter out peaks that are very close to each other + peaksAtTopTempo = peaksAtTopTempo.filter(function (peakTime, index, arr) { + var dif = arr[index + 1] - peakTime; + if (dif > 0.01) { + return true; + } + }); + return peaksAtTopTempo; + } + // helper function for processPeaks + function mapTempo(theoreticalTempo) { + // these scenarios create infinite while loop + if (!isFinite(theoreticalTempo) || theoreticalTempo == 0) { + return; + } + // Adjust the tempo to fit within the 90-180 BPM range + while (theoreticalTempo < 90) + theoreticalTempo *= 2; + while (theoreticalTempo > 180 && theoreticalTempo > 90) + theoreticalTempo /= 2; + return theoreticalTempo; + } + /*** SCHEDULE EVENTS ***/ + /** + * 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. + * + * 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 + * 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 + * 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 + * second parameter to the + * callback function. + * @return {Number} id ID of this cue, + * useful for removeCue(id) + * @example + *
+ * function setup() { + * background(0); + * noStroke(); + * fill(255); + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * mySound = loadSound('assets/beat.mp3'); + * + * // schedule calls to changeText + * mySound.addCue(0.50, changeText, "hello" ); + * mySound.addCue(1.00, changeText, "p5" ); + * mySound.addCue(1.50, changeText, "what" ); + * mySound.addCue(2.00, changeText, "do" ); + * mySound.addCue(2.50, changeText, "you" ); + * mySound.addCue(3.00, changeText, "want" ); + * mySound.addCue(4.00, changeText, "to" ); + * mySound.addCue(5.00, changeText, "make" ); + * mySound.addCue(6.00, changeText, "?" ); + * } + * + * function changeText(val) { + * background(0); + * text(val, width/2, height/2); + * } + * + * function mouseClicked() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * if (mySound.isPlaying() ) { + * mySound.stop(); + * } else { + * mySound.play(); + * } + * } + * } + *
+ */ + p5.SoundFile.prototype.addCue = function (time, callback, val) { + var id = this._cueIDCounter++; + var cue = new Cue(callback, time, id, val); + this._cues.push(cue); + // if (!this.elt.ontimeupdate) { + // this.elt.ontimeupdate = this._onTimeUpdate.bind(this); + // } + return id; + }; + /** + * 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 + */ + p5.SoundFile.prototype.removeCue = function (id) { + var cueLength = this._cues.length; + for (var i = 0; i < cueLength; i++) { + var cue = this._cues[i]; + if (cue.id === id) { + this.cues.splice(i, 1); + } + } + if (this._cues.length === 0) { + } + }; + /** + * Remove all of the callbacks that had originally been scheduled + * via the addCue method. + * + * @method clearCues + */ + p5.SoundFile.prototype.clearCues = function () { + this._cues = []; + }; + // private method that checks for cues to be fired if events + // have been scheduled using addCue(callback, time). + p5.SoundFile.prototype._onTimeUpdate = function (position) { + var playbackTime = position / this.buffer.sampleRate; + var cueLength = this._cues.length; + for (var i = 0; i < cueLength; i++) { + var cue = this._cues[i]; + var callbackTime = cue.time; + var val = cue.val; + if (this._prevTime < callbackTime && callbackTime <= playbackTime) { + // pass the scheduled callbackTime as parameter to the callback + cue.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; + }; +}(sndcore, errorHandler, master); +var amplitude; +amplitude = function () { + 'use strict'; + var p5sound = master; + /** + * Amplitude measures volume between 0.0 and 1.0. + * Listens to all p5sound by default, or use setInput() + * to listen to a specific sound source. Accepts an optional + * smoothing value, which defaults to 0. + * + * @class p5.Amplitude + * @constructor + * @param {Number} [smoothing] between 0.0 and .999 to smooth + * amplitude readings (defaults to 0) + * @return {Object} Amplitude Object + * @example + *
+ * var sound, amplitude, cnv; + * + * function preload(){ + * sound = loadSound('assets/beat.mp3'); + * } + * function setup() { + * cnv = createCanvas(100,100); + * amplitude = new p5.Amplitude(); + * + * // start / stop the sound when canvas is clicked + * cnv.mouseClicked(function() { + * if (sound.isPlaying() ){ + * sound.stop(); + * } else { + * sound.play(); + * } + * }); + * } + * function draw() { + * background(0); + * fill(255); + * var level = amplitude.getLevel(); + * var size = map(level, 0, 1, 0, 200); + * ellipse(width/2, height/2, size, size); + * } + * + *
+ */ + p5.Amplitude = function (smoothing) { + // Set to 2048 for now. In future iterations, this should be inherited or parsed from p5sound's default + this.bufferSize = 2048; + // set audio context + this.audiocontext = p5sound.audiocontext; + this.processor = this.audiocontext.createScriptProcessor(this.bufferSize, 2, 1); + // for connections + this.input = this.processor; + this.output = this.audiocontext.createGain(); + // smoothing defaults to 0 + this.smoothing = smoothing || 0; + // the variables to return + this.volume = 0; + this.average = 0; + this.stereoVol = [ + 0, + 0 + ]; + this.stereoAvg = [ + 0, + 0 + ]; + this.stereoVolNorm = [ + 0, + 0 + ]; + this.volMax = 0.001; + this.normalize = false; + this.processor.onaudioprocess = this._audioProcess.bind(this); + this.processor.connect(this.output); + this.output.gain.value = 0; + // this may only be necessary because of a Chrome bug + this.output.connect(this.audiocontext.destination); + // connect to p5sound master output by default, unless set by input() + p5sound.meter.connect(this.processor); + // add this p5.SoundFile to the soundArray + p5sound.soundArray.push(this); + }; + /** + * Connects to the p5sound instance (master output) by default. + * Optionally, you can pass in a specific source (i.e. a soundfile). + * + * @method setInput + * @param {soundObject|undefined} [snd] set the sound source + * (optional, defaults to + * master output) + * @param {Number|undefined} [smoothing] a range between 0.0 and 1.0 + * to smooth amplitude readings + * @example + *
+ * function preload(){ + * sound1 = loadSound('assets/beat.mp3'); + * sound2 = loadSound('assets/drum.mp3'); + * } + * function setup(){ + * amplitude = new p5.Amplitude(); + * sound1.play(); + * sound2.play(); + * amplitude.setInput(sound2); + * } + * function draw() { + * background(0); + * fill(255); + * var level = amplitude.getLevel(); + * var size = map(level, 0, 1, 0, 200); + * ellipse(width/2, height/2, size, size); + * } + * function mouseClicked(){ + * sound1.stop(); + * sound2.stop(); + * } + *
+ */ + p5.Amplitude.prototype.setInput = function (source, smoothing) { + p5sound.meter.disconnect(); + if (smoothing) { + this.smoothing = smoothing; + } + // connect to the master out of p5s instance if no snd is provided + if (source == null) { + console.log('Amplitude input source is not ready! Connecting to master output instead'); + p5sound.meter.connect(this.processor); + } else if (source instanceof p5.Signal) { + source.output.connect(this.processor); + } else if (source) { + source.connect(this.processor); + this.processor.disconnect(); + this.processor.connect(this.output); + } else { + p5sound.meter.connect(this.processor); + } + }; + p5.Amplitude.prototype.connect = function (unit) { + if (unit) { + if (unit.hasOwnProperty('input')) { + this.output.connect(unit.input); + } else { + this.output.connect(unit); + } + } else { + this.output.connect(this.panner.connect(p5sound.input)); + } + }; + p5.Amplitude.prototype.disconnect = function (unit) { + this.output.disconnect(); + }; + // TO DO make this stereo / dependent on # of audio channels + p5.Amplitude.prototype._audioProcess = function (event) { + for (var channel = 0; channel < event.inputBuffer.numberOfChannels; channel++) { + var inputBuffer = event.inputBuffer.getChannelData(channel); + var bufLength = inputBuffer.length; + var total = 0; + var sum = 0; + var x; + for (var i = 0; i < bufLength; i++) { + x = inputBuffer[i]; + if (this.normalize) { + total += Math.max(Math.min(x / this.volMax, 1), -1); + sum += Math.max(Math.min(x / this.volMax, 1), -1) * Math.max(Math.min(x / this.volMax, 1), -1); + } else { + total += x; + sum += x * x; + } + } + var average = total / bufLength; + // ... then take the square root of the sum. + var rms = Math.sqrt(sum / bufLength); + this.stereoVol[channel] = Math.max(rms, this.stereoVol[channel] * this.smoothing); + this.stereoAvg[channel] = Math.max(average, this.stereoVol[channel] * this.smoothing); + this.volMax = Math.max(this.stereoVol[channel], this.volMax); + } + // add volume from all channels together + var self = this; + var volSum = this.stereoVol.reduce(function (previousValue, currentValue, index) { + self.stereoVolNorm[index - 1] = Math.max(Math.min(self.stereoVol[index - 1] / self.volMax, 1), 0); + self.stereoVolNorm[index] = Math.max(Math.min(self.stereoVol[index] / self.volMax, 1), 0); + return previousValue + currentValue; + }); + // volume is average of channels + this.volume = volSum / this.stereoVol.length; + // normalized value + this.volNorm = Math.max(Math.min(this.volume / this.volMax, 1), 0); + }; + /** + * Returns a single Amplitude reading at the moment it is called. + * For continuous readings, run in the draw loop. + * + * @method getLevel + * @param {Number} [channel] Optionally return only channel 0 (left) or 1 (right) + * @return {Number} Amplitude as a number between 0.0 and 1.0 + * @example + *
+ * function preload(){ + * sound = loadSound('assets/beat.mp3'); + * } + * function setup() { + * amplitude = new p5.Amplitude(); + * sound.play(); + * } + * function draw() { + * background(0); + * fill(255); + * var level = amplitude.getLevel(); + * var size = map(level, 0, 1, 0, 200); + * ellipse(width/2, height/2, size, size); + * } + * function mouseClicked(){ + * sound.stop(); + * } + *
+ */ + p5.Amplitude.prototype.getLevel = function (channel) { + if (typeof channel !== 'undefined') { + if (this.normalize) { + return this.stereoVolNorm[channel]; + } else { + return this.stereoVol[channel]; + } + } else if (this.normalize) { + return this.volNorm; + } else { + return this.volume; + } + }; + /** + * Determines whether the results of Amplitude.process() will be + * Normalized. To normalize, Amplitude finds the difference the + * loudest reading it has processed and the maximum amplitude of + * 1.0. Amplitude adds this difference to all values to produce + * results that will reliably map between 0.0 and 1.0. However, + * if a louder moment occurs, the amount that Normalize adds to + * all the values will change. Accepts an optional boolean parameter + * (true or false). Normalizing is off by default. + * + * @method toggleNormalize + * @param {boolean} [boolean] set normalize to true (1) or false (0) + */ + p5.Amplitude.prototype.toggleNormalize = function (bool) { + if (typeof bool === 'boolean') { + this.normalize = bool; + } else { + this.normalize = !this.normalize; + } + }; + /** + * Smooth Amplitude analysis by averaging with the last analysis + * frame. Off by default. + * + * @method smooth + * @param {Number} set smoothing from 0.0 <= 1 + */ + p5.Amplitude.prototype.smooth = function (s) { + if (s >= 0 && s < 1) { + this.smoothing = s; + } else { + console.log('Error: smoothing must be between 0 and 1'); + } + }; + p5.Amplitude.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.input.disconnect(); + this.output.disconnect(); + this.input = this.processor = undefined; + this.output = undefined; + }; +}(master); +var fft; +fft = function () { + 'use strict'; + var p5sound = master; + /** + *

FFT (Fast Fourier Transform) is an analysis algorithm that + * isolates individual + * + * audio frequencies within a waveform.

+ * + *

Once instantiated, a p5.FFT object can return an array based on + * two types of analyses:
• FFT.waveform() computes + * amplitude values along the time domain. The array indices correspond + * to samples across a brief moment in time. Each value represents + * amplitude of the waveform at that sample of time.
+ * • FFT.analyze() computes amplitude values along the + * frequency domain. The array indices correspond to frequencies (i.e. + * pitches), from the lowest to the highest that humans can hear. Each + * value represents amplitude at that slice of the frequency spectrum. + * Use with getEnergy() to measure amplitude at specific + * frequencies, or within a range of frequencies.

+ * + *

FFT analyzes a very short snapshot of sound called a sample + * buffer. It returns an array of amplitude measurements, referred + * to as bins. The array is 1024 bins long by default. + * You can change the bin array length, but it must be a power of 2 + * between 16 and 1024 in order for the FFT algorithm to function + * correctly. The actual size of the FFT buffer is twice the + * number of bins, so given a standard sample rate, the buffer is + * 2048/44100 seconds long.

+ * + * + * @class p5.FFT + * @constructor + * @param {Number} [smoothing] Smooth results of Freq Spectrum. + * 0.0 < smoothing < 1.0. + * Defaults to 0.8. + * @param {Number} [bins] Length of resulting array. + * Must be a power of two between + * 16 and 1024. Defaults to 1024. + * @return {Object} FFT Object + * @example + *
+ * function preload(){ + * sound = loadSound('assets/Damscray_DancingTiger.mp3'); + * } + * + * function setup(){ + * var cnv = createCanvas(100,100); + * cnv.mouseClicked(togglePlay); + * fft = new p5.FFT(); + * sound.amp(0.2); + * } + * + * function draw(){ + * background(0); + * + * var spectrum = fft.analyze(); + * noStroke(); + * fill(0,255,0); // spectrum is green + * for (var i = 0; i< spectrum.length; i++){ + * var x = map(i, 0, spectrum.length, 0, width); + * var h = -height + map(spectrum[i], 0, 255, height, 0); + * rect(x, height, width / spectrum.length, h ) + * } + * + * var waveform = fft.waveform(); + * noFill(); + * beginShape(); + * stroke(255,0,0); // waveform is red + * strokeWeight(1); + * for (var i = 0; i< waveform.length; i++){ + * var x = map(i, 0, waveform.length, 0, width); + * var y = map( waveform[i], -1, 1, 0, height); + * vertex(x,y); + * } + * endShape(); + * + * text('click to play/pause', 4, 10); + * } + * + * // fade sound if mouse is over canvas + * function togglePlay() { + * if (sound.isPlaying()) { + * sound.pause(); + * } else { + * sound.loop(); + * } + * } + *
+ */ + p5.FFT = function (smoothing, bins) { + this.smoothing = smoothing || 0.8; + this.bins = bins || 1024; + var FFT_SIZE = bins * 2 || 2048; + this.input = this.analyser = p5sound.audiocontext.createAnalyser(); + // default connections to p5sound fftMeter + p5sound.fftMeter.connect(this.analyser); + this.analyser.smoothingTimeConstant = this.smoothing; + this.analyser.fftSize = FFT_SIZE; + this.freqDomain = new Uint8Array(this.analyser.frequencyBinCount); + this.timeDomain = new Uint8Array(this.analyser.frequencyBinCount); + // predefined frequency ranages, these will be tweakable + this.bass = [ + 20, + 140 + ]; + this.lowMid = [ + 140, + 400 + ]; + this.mid = [ + 400, + 2600 + ]; + this.highMid = [ + 2600, + 5200 + ]; + this.treble = [ + 5200, + 14000 + ]; + // add this p5.SoundFile to the soundArray + p5sound.soundArray.push(this); + }; + /** + * Set the input source for the FFT analysis. If no source is + * provided, FFT will analyze all sound in the sketch. + * + * @method setInput + * @param {Object} [source] p5.sound object (or web audio API source node) + */ + p5.FFT.prototype.setInput = function (source) { + if (!source) { + p5sound.fftMeter.connect(this.analyser); + } else { + if (source.output) { + source.output.connect(this.analyser); + } else if (source.connect) { + source.connect(this.analyser); + } + p5sound.fftMeter.disconnect(); + } + }; + /** + * Returns an array of amplitude values (between -1.0 and +1.0) that represent + * a snapshot of amplitude readings in a single buffer. Length will be + * equal to bins (defaults to 1024). Can be used to draw the waveform + * of a sound. + * + * @method waveform + * @param {Number} [bins] Must be a power of two between + * 16 and 1024. Defaults to 1024. + * @param {String} [precision] If any value is provided, will return results + * in a Float32 Array which is more precise + * than a regular array. + * @return {Array} Array Array of amplitude values (-1 to 1) + * over time. Array length = bins. + * + */ + p5.FFT.prototype.waveform = function () { + var bins, mode, normalArray; + for (var i = 0; i < arguments.length; i++) { + if (typeof arguments[i] === 'number') { + bins = arguments[i]; + this.analyser.fftSize = bins * 2; + } + if (typeof arguments[i] === 'string') { + mode = arguments[i]; + } + } + // getFloatFrequencyData doesnt work in Safari as of 5/2015 + if (mode && !p5.prototype._isSafari()) { + timeToFloat(this, this.timeDomain); + this.analyser.getFloatTimeDomainData(this.timeDomain); + return this.timeDomain; + } else { + timeToInt(this, this.timeDomain); + this.analyser.getByteTimeDomainData(this.timeDomain); + var normalArray = new Array(); + for (var i = 0; i < this.timeDomain.length; i++) { + var scaled = p5.prototype.map(this.timeDomain[i], 0, 255, -1, 1); + normalArray.push(scaled); + } + return normalArray; + } + }; + /** + * Returns an array of amplitude values (between 0 and 255) + * across the frequency spectrum. Length is equal to FFT bins + * (1024 by default). The array indices correspond to frequencies + * (i.e. pitches), from the lowest to the highest that humans can + * hear. Each value represents amplitude at that slice of the + * frequency spectrum. Must be called prior to using + * getEnergy(). + * + * @method analyze + * @param {Number} [bins] Must be a power of two between + * 16 and 1024. Defaults to 1024. + * @param {Number} [scale] If "dB," returns decibel + * float measurements between + * -140 and 0 (max). + * Otherwise returns integers from 0-255. + * @return {Array} spectrum Array of energy (amplitude/volume) + * values across the frequency spectrum. + * Lowest energy (silence) = 0, highest + * possible is 255. + * @example + *
+ * var osc; + * var fft; + * + * function setup(){ + * createCanvas(100,100); + * osc = new p5.Oscillator(); + * osc.amp(0); + * osc.start(); + * fft = new p5.FFT(); + * } + * + * function draw(){ + * background(0); + * + * var freq = map(mouseX, 0, 800, 20, 15000); + * freq = constrain(freq, 1, 20000); + * osc.freq(freq); + * + * var spectrum = fft.analyze(); + * noStroke(); + * fill(0,255,0); // spectrum is green + * for (var i = 0; i< spectrum.length; i++){ + * var x = map(i, 0, spectrum.length, 0, width); + * var h = -height + map(spectrum[i], 0, 255, height, 0); + * rect(x, height, width / spectrum.length, h ); + * } + * + * stroke(255); + * text('Freq: ' + round(freq)+'Hz', 10, 10); + * + * isMouseOverCanvas(); + * } + * + * // only play sound when mouse is over canvas + * function isMouseOverCanvas() { + * var mX = mouseX, mY = mouseY; + * if (mX > 0 && mX < width && mY < height && mY > 0) { + * osc.amp(0.5, 0.2); + * } else { + * osc.amp(0, 0.2); + * } + * } + *
+ * + * + */ + p5.FFT.prototype.analyze = function () { + var bins, mode; + for (var i = 0; i < arguments.length; i++) { + if (typeof arguments[i] === 'number') { + bins = this.bins = arguments[i]; + this.analyser.fftSize = this.bins * 2; + } + if (typeof arguments[i] === 'string') { + mode = arguments[i]; + } + } + if (mode && mode.toLowerCase() === 'db') { + freqToFloat(this); + this.analyser.getFloatFrequencyData(this.freqDomain); + return this.freqDomain; + } else { + freqToInt(this, this.freqDomain); + this.analyser.getByteFrequencyData(this.freqDomain); + var normalArray = Array.apply([], this.freqDomain); + normalArray.length === this.analyser.fftSize; + normalArray.constructor === Array; + return normalArray; + } + }; + /** + * Returns the amount of energy (volume) at a specific + * + * frequency, or the average amount of energy between two + * frequencies. Accepts Number(s) corresponding + * to frequency (in Hz), or a String corresponding to predefined + * frequency ranges ("bass", "lowMid", "mid", "highMid", "treble"). + * Returns a range between 0 (no energy/volume at that frequency) and + * 255 (maximum energy). + * NOTE: analyze() must be called prior to getEnergy(). Analyze() + * tells the FFT to analyze frequency data, and getEnergy() uses + * the results determine the value at a specific frequency or + * range of frequencies.

+ * + * @method getEnergy + * @param {Number|String} frequency1 Will return a value representing + * energy at this frequency. Alternately, + * the strings "bass", "lowMid" "mid", + * "highMid", and "treble" will return + * predefined frequency ranges. + * @param {Number} [frequency2] If a second frequency is given, + * will return average amount of + * energy that exists between the + * two frequencies. + * @return {Number} Energy Energy (volume/amplitude) from + * 0 and 255. + * + */ + p5.FFT.prototype.getEnergy = function (frequency1, frequency2) { + var nyquist = p5sound.audiocontext.sampleRate / 2; + if (frequency1 === 'bass') { + frequency1 = this.bass[0]; + frequency2 = this.bass[1]; + } else if (frequency1 === 'lowMid') { + frequency1 = this.lowMid[0]; + frequency2 = this.lowMid[1]; + } else if (frequency1 === 'mid') { + frequency1 = this.mid[0]; + frequency2 = this.mid[1]; + } else if (frequency1 === 'highMid') { + frequency1 = this.highMid[0]; + frequency2 = this.highMid[1]; + } else if (frequency1 === 'treble') { + frequency1 = this.treble[0]; + frequency2 = this.treble[1]; + } + if (typeof frequency1 !== 'number') { + throw 'invalid input for getEnergy()'; + } else if (!frequency2) { + var index = Math.round(frequency1 / nyquist * this.freqDomain.length); + return this.freqDomain[index]; + } else if (frequency1 && frequency2) { + // if second is higher than first + if (frequency1 > frequency2) { + var swap = frequency2; + frequency2 = frequency1; + frequency1 = swap; + } + var lowIndex = Math.round(frequency1 / nyquist * this.freqDomain.length); + var highIndex = Math.round(frequency2 / nyquist * this.freqDomain.length); + var total = 0; + var numFrequencies = 0; + // add up all of the values for the frequencies + for (var i = lowIndex; i <= highIndex; i++) { + total += this.freqDomain[i]; + numFrequencies += 1; + } + // divide by total number of frequencies + var toReturn = total / numFrequencies; + return toReturn; + } else { + throw 'invalid input for getEnergy()'; + } + }; + // compatability with v.012, changed to getEnergy in v.0121. Will be deprecated... + p5.FFT.prototype.getFreq = function (freq1, freq2) { + console.log('getFreq() is deprecated. Please use getEnergy() instead.'); + var x = this.getEnergy(freq1, freq2); + return x; + }; + /** + * Returns the + * + * spectral centroid of the input signal. + * NOTE: analyze() must be called prior to getCentroid(). Analyze() + * tells the FFT to analyze frequency data, and getCentroid() uses + * the results determine the spectral centroid.

+ * + * @method getCentroid + * @return {Number} Spectral Centroid Frequency Frequency of the spectral centroid in Hz. + * + * + * @example + *
+ * + * + *function setup(){ + * cnv = createCanvas(800,400); + * sound = new p5.AudioIn(); + * sound.start(); + * fft = new p5.FFT(); + * sound.connect(fft); + *} + * + * + *function draw(){ + * + * var centroidplot = 0.0; + * var spectralCentroid = 0; + * + * + * background(0); + * stroke(0,255,0); + * var spectrum = fft.analyze(); + * fill(0,255,0); // spectrum is green + * + * //draw the spectrum + * + * for (var i = 0; i< spectrum.length; i++){ + * var x = map(log(i), 0, log(spectrum.length), 0, width); + * var h = map(spectrum[i], 0, 255, 0, height); + * var rectangle_width = (log(i+1)-log(i))*(width/log(spectrum.length)); + * rect(x, height, rectangle_width, -h ) + * } + + * var nyquist = 22050; + * + * // get the centroid + * spectralCentroid = fft.getCentroid(); + * + * // the mean_freq_index calculation is for the display. + * var mean_freq_index = spectralCentroid/(nyquist/spectrum.length); + * + * centroidplot = map(log(mean_freq_index), 0, log(spectrum.length), 0, width); + * + * + * stroke(255,0,0); // the line showing where the centroid is will be red + * + * rect(centroidplot, 0, width / spectrum.length, height) + * noStroke(); + * fill(255,255,255); // text is white + * textSize(40); + * text("centroid: "+round(spectralCentroid)+" Hz", 10, 40); + *} + *
+ */ + p5.FFT.prototype.getCentroid = function () { + var nyquist = p5sound.audiocontext.sampleRate / 2; + var cumulative_sum = 0; + var centroid_normalization = 0; + for (var i = 0; i < this.freqDomain.length; i++) { + cumulative_sum += i * this.freqDomain[i]; + centroid_normalization += this.freqDomain[i]; + } + var mean_freq_index = 0; + if (centroid_normalization != 0) { + mean_freq_index = cumulative_sum / centroid_normalization; + } + var spec_centroid_freq = mean_freq_index * (nyquist / this.freqDomain.length); + return spec_centroid_freq; + }; + /** + * Smooth FFT analysis by averaging with the last analysis frame. + * + * @method smooth + * @param {Number} smoothing 0.0 < smoothing < 1.0. + * Defaults to 0.8. + */ + p5.FFT.prototype.smooth = function (s) { + if (s) { + this.smoothing = s; + } + this.analyser.smoothingTimeConstant = s; + }; + p5.FFT.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.analyser.disconnect(); + this.analyser = undefined; + }; + /** + * Returns an array of average amplitude values for a given number + * of frequency bands split equally. N defaults to 16. + * NOTE: analyze() must be called prior to linAverages(). Analyze() + * tells the FFT to analyze frequency data, and linAverages() uses + * the results to group them into a smaller set of averages.

+ * + * @method linAverages + * @param {Number} N Number of returned frequency groups + * @return {Array} linearAverages Array of average amplitude values for each group + */ + p5.FFT.prototype.linAverages = function (N) { + var N = N || 16; + // This prevents undefined, null or 0 values of N + var spectrum = this.freqDomain; + var spectrumLength = spectrum.length; + var spectrumStep = Math.floor(spectrumLength / N); + var linearAverages = new Array(N); + // Keep a second index for the current average group and place the values accordingly + // with only one loop in the spectrum data + var groupIndex = 0; + for (var specIndex = 0; specIndex < spectrumLength; specIndex++) { + linearAverages[groupIndex] = linearAverages[groupIndex] !== undefined ? (linearAverages[groupIndex] + spectrum[specIndex]) / 2 : spectrum[specIndex]; + // Increase the group index when the last element of the group is processed + if (specIndex % spectrumStep == spectrumStep - 1) { + groupIndex++; + } + } + return linearAverages; + }; + /** + * Returns an array of average amplitude values of the spectrum, for a given + * set of + * Octave Bands + * NOTE: analyze() must be called prior to logAverages(). Analyze() + * tells the FFT to analyze frequency data, and logAverages() uses + * the results to group them into a smaller set of averages.

+ * + * @method logAverages + * @param {Array} octaveBands Array of Octave Bands objects for grouping + * @return {Array} logAverages Array of average amplitude values for each group + */ + p5.FFT.prototype.logAverages = function (octaveBands) { + var nyquist = p5sound.audiocontext.sampleRate / 2; + var spectrum = this.freqDomain; + var spectrumLength = spectrum.length; + var logAverages = new Array(octaveBands.length); + // Keep a second index for the current average group and place the values accordingly + // With only one loop in the spectrum data + var octaveIndex = 0; + for (var specIndex = 0; specIndex < spectrumLength; specIndex++) { + var specIndexFrequency = Math.round(specIndex * nyquist / this.freqDomain.length); + // Increase the group index if the current frequency exceeds the limits of the band + if (specIndexFrequency > octaveBands[octaveIndex].hi) { + octaveIndex++; + } + logAverages[octaveIndex] = logAverages[octaveIndex] !== undefined ? (logAverages[octaveIndex] + spectrum[specIndex]) / 2 : spectrum[specIndex]; + } + return logAverages; + }; + /** + * Calculates and Returns the 1/N + * Octave Bands + * N defaults to 3 and minimum central frequency to 15.625Hz. + * (1/3 Octave Bands ~= 31 Frequency Bands) + * Setting fCtr0 to a central value of a higher octave will ignore the lower bands + * and produce less frequency groups. + * + * @method getOctaveBands + * @param {Number} N Specifies the 1/N type of generated octave bands + * @param {Number} fCtr0 Minimum central frequency for the lowest band + * @return {Array} octaveBands Array of octave band objects with their bounds + */ + p5.FFT.prototype.getOctaveBands = function (N, fCtr0) { + var N = N || 3; + // Default to 1/3 Octave Bands + var fCtr0 = fCtr0 || 15.625; + // Minimum central frequency, defaults to 15.625Hz + var octaveBands = []; + var lastFrequencyBand = { + lo: fCtr0 / Math.pow(2, 1 / (2 * N)), + ctr: fCtr0, + hi: fCtr0 * Math.pow(2, 1 / (2 * N)) + }; + octaveBands.push(lastFrequencyBand); + var nyquist = p5sound.audiocontext.sampleRate / 2; + while (lastFrequencyBand.hi < nyquist) { + var newFrequencyBand = {}; + newFrequencyBand.lo = lastFrequencyBand.hi, newFrequencyBand.ctr = lastFrequencyBand.ctr * Math.pow(2, 1 / N), newFrequencyBand.hi = newFrequencyBand.ctr * Math.pow(2, 1 / (2 * N)), octaveBands.push(newFrequencyBand); + lastFrequencyBand = newFrequencyBand; + } + return octaveBands; + }; + // helper methods to convert type from float (dB) to int (0-255) + var freqToFloat = function (fft) { + if (fft.freqDomain instanceof Float32Array === false) { + fft.freqDomain = new Float32Array(fft.analyser.frequencyBinCount); + } + }; + var freqToInt = function (fft) { + if (fft.freqDomain instanceof Uint8Array === false) { + fft.freqDomain = new Uint8Array(fft.analyser.frequencyBinCount); + } + }; + var timeToFloat = function (fft) { + if (fft.timeDomain instanceof Float32Array === false) { + fft.timeDomain = new Float32Array(fft.analyser.frequencyBinCount); + } + }; + var timeToInt = function (fft) { + if (fft.timeDomain instanceof Uint8Array === false) { + fft.timeDomain = new Uint8Array(fft.analyser.frequencyBinCount); + } + }; +}(master); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Tone; +Tone_core_Tone = function () { + 'use strict'; + function isUndef(val) { + return val === void 0; + } + function isFunction(val) { + return typeof val === 'function'; + } + var audioContext; + if (isUndef(window.AudioContext)) { + window.AudioContext = window.webkitAudioContext; + } + if (isUndef(window.OfflineAudioContext)) { + window.OfflineAudioContext = window.webkitOfflineAudioContext; + } + if (!isUndef(AudioContext)) { + audioContext = new AudioContext(); + } else { + throw new Error('Web Audio is not supported in this browser'); + } + if (!isFunction(AudioContext.prototype.createGain)) { + AudioContext.prototype.createGain = AudioContext.prototype.createGainNode; + } + if (!isFunction(AudioContext.prototype.createDelay)) { + AudioContext.prototype.createDelay = AudioContext.prototype.createDelayNode; + } + if (!isFunction(AudioContext.prototype.createPeriodicWave)) { + AudioContext.prototype.createPeriodicWave = AudioContext.prototype.createWaveTable; + } + if (!isFunction(AudioBufferSourceNode.prototype.start)) { + AudioBufferSourceNode.prototype.start = AudioBufferSourceNode.prototype.noteGrainOn; + } + if (!isFunction(AudioBufferSourceNode.prototype.stop)) { + AudioBufferSourceNode.prototype.stop = AudioBufferSourceNode.prototype.noteOff; + } + if (!isFunction(OscillatorNode.prototype.start)) { + OscillatorNode.prototype.start = OscillatorNode.prototype.noteOn; + } + if (!isFunction(OscillatorNode.prototype.stop)) { + OscillatorNode.prototype.stop = OscillatorNode.prototype.noteOff; + } + if (!isFunction(OscillatorNode.prototype.setPeriodicWave)) { + OscillatorNode.prototype.setPeriodicWave = OscillatorNode.prototype.setWaveTable; + } + AudioNode.prototype._nativeConnect = AudioNode.prototype.connect; + AudioNode.prototype.connect = function (B, outNum, inNum) { + if (B.input) { + if (Array.isArray(B.input)) { + if (isUndef(inNum)) { + inNum = 0; + } + this.connect(B.input[inNum]); + } else { + this.connect(B.input, outNum, inNum); + } + } else { + try { + if (B instanceof AudioNode) { + this._nativeConnect(B, outNum, inNum); + } else { + this._nativeConnect(B, outNum); + } + } catch (e) { + throw new Error('error connecting to node: ' + B); + } + } + }; + var Tone = function (inputs, outputs) { + if (isUndef(inputs) || inputs === 1) { + this.input = this.context.createGain(); + } else if (inputs > 1) { + this.input = new Array(inputs); + } + if (isUndef(outputs) || outputs === 1) { + this.output = this.context.createGain(); + } else if (outputs > 1) { + this.output = new Array(inputs); + } + }; + Tone.prototype.set = function (params, value, rampTime) { + if (this.isObject(params)) { + rampTime = value; + } else if (this.isString(params)) { + var tmpObj = {}; + tmpObj[params] = value; + params = tmpObj; + } + for (var attr in params) { + value = params[attr]; + var parent = this; + if (attr.indexOf('.') !== -1) { + var attrSplit = attr.split('.'); + for (var i = 0; i < attrSplit.length - 1; i++) { + parent = parent[attrSplit[i]]; + } + attr = attrSplit[attrSplit.length - 1]; + } + var param = parent[attr]; + if (isUndef(param)) { + continue; + } + if (Tone.Signal && param instanceof Tone.Signal || Tone.Param && param instanceof Tone.Param) { + if (param.value !== value) { + if (isUndef(rampTime)) { + param.value = value; + } else { + param.rampTo(value, rampTime); + } + } + } else if (param instanceof AudioParam) { + if (param.value !== value) { + param.value = value; + } + } else if (param instanceof Tone) { + param.set(value); + } else if (param !== value) { + parent[attr] = value; + } + } + return this; + }; + Tone.prototype.get = function (params) { + if (isUndef(params)) { + params = this._collectDefaults(this.constructor); + } else if (this.isString(params)) { + params = [params]; + } + var ret = {}; + for (var i = 0; i < params.length; i++) { + var attr = params[i]; + var parent = this; + var subRet = ret; + if (attr.indexOf('.') !== -1) { + var attrSplit = attr.split('.'); + for (var j = 0; j < attrSplit.length - 1; j++) { + var subAttr = attrSplit[j]; + subRet[subAttr] = subRet[subAttr] || {}; + subRet = subRet[subAttr]; + parent = parent[subAttr]; + } + attr = attrSplit[attrSplit.length - 1]; + } + var param = parent[attr]; + if (this.isObject(params[attr])) { + subRet[attr] = param.get(); + } else if (Tone.Signal && param instanceof Tone.Signal) { + subRet[attr] = param.value; + } else if (Tone.Param && param instanceof Tone.Param) { + subRet[attr] = param.value; + } else if (param instanceof AudioParam) { + subRet[attr] = param.value; + } else if (param instanceof Tone) { + subRet[attr] = param.get(); + } else if (!isFunction(param) && !isUndef(param)) { + subRet[attr] = param; + } + } + return ret; + }; + Tone.prototype._collectDefaults = function (constr) { + var ret = []; + if (!isUndef(constr.defaults)) { + ret = Object.keys(constr.defaults); + } + if (!isUndef(constr._super)) { + var superDefs = this._collectDefaults(constr._super); + for (var i = 0; i < superDefs.length; i++) { + if (ret.indexOf(superDefs[i]) === -1) { + ret.push(superDefs[i]); + } + } + } + return ret; + }; + Tone.prototype.toString = function () { + for (var className in Tone) { + var isLetter = className[0].match(/^[A-Z]$/); + var sameConstructor = Tone[className] === this.constructor; + if (isFunction(Tone[className]) && isLetter && sameConstructor) { + return className; + } + } + return 'Tone'; + }; + Tone.context = audioContext; + Tone.prototype.context = Tone.context; + Tone.prototype.bufferSize = 2048; + Tone.prototype.blockTime = 128 / Tone.context.sampleRate; + Tone.prototype.dispose = function () { + if (!this.isUndef(this.input)) { + if (this.input instanceof AudioNode) { + this.input.disconnect(); + } + this.input = null; + } + if (!this.isUndef(this.output)) { + if (this.output instanceof AudioNode) { + this.output.disconnect(); + } + this.output = null; + } + return this; + }; + var _silentNode = null; + Tone.prototype.noGC = function () { + this.output.connect(_silentNode); + return this; + }; + AudioNode.prototype.noGC = function () { + this.connect(_silentNode); + return this; + }; + Tone.prototype.connect = function (unit, outputNum, inputNum) { + if (Array.isArray(this.output)) { + outputNum = this.defaultArg(outputNum, 0); + this.output[outputNum].connect(unit, 0, inputNum); + } else { + this.output.connect(unit, outputNum, inputNum); + } + return this; + }; + Tone.prototype.disconnect = function (outputNum) { + if (Array.isArray(this.output)) { + outputNum = this.defaultArg(outputNum, 0); + this.output[outputNum].disconnect(); + } else { + this.output.disconnect(); + } + return this; + }; + Tone.prototype.connectSeries = function () { + if (arguments.length > 1) { + var currentUnit = arguments[0]; + for (var i = 1; i < arguments.length; i++) { + var toUnit = arguments[i]; + currentUnit.connect(toUnit); + currentUnit = toUnit; + } + } + return this; + }; + Tone.prototype.connectParallel = function () { + var connectFrom = arguments[0]; + if (arguments.length > 1) { + for (var i = 1; i < arguments.length; i++) { + var connectTo = arguments[i]; + connectFrom.connect(connectTo); + } + } + return this; + }; + Tone.prototype.chain = function () { + if (arguments.length > 0) { + var currentUnit = this; + for (var i = 0; i < arguments.length; i++) { + var toUnit = arguments[i]; + currentUnit.connect(toUnit); + currentUnit = toUnit; + } + } + return this; + }; + Tone.prototype.fan = function () { + if (arguments.length > 0) { + for (var i = 0; i < arguments.length; i++) { + this.connect(arguments[i]); + } + } + return this; + }; + AudioNode.prototype.chain = Tone.prototype.chain; + AudioNode.prototype.fan = Tone.prototype.fan; + Tone.prototype.defaultArg = function (given, fallback) { + if (this.isObject(given) && this.isObject(fallback)) { + var ret = {}; + for (var givenProp in given) { + ret[givenProp] = this.defaultArg(fallback[givenProp], given[givenProp]); + } + for (var fallbackProp in fallback) { + ret[fallbackProp] = this.defaultArg(given[fallbackProp], fallback[fallbackProp]); + } + return ret; + } else { + return isUndef(given) ? fallback : given; + } + }; + Tone.prototype.optionsObject = function (values, keys, defaults) { + var options = {}; + if (values.length === 1 && this.isObject(values[0])) { + options = values[0]; + } else { + for (var i = 0; i < keys.length; i++) { + options[keys[i]] = values[i]; + } + } + if (!this.isUndef(defaults)) { + return this.defaultArg(options, defaults); + } else { + return options; + } + }; + Tone.prototype.isUndef = isUndef; + Tone.prototype.isFunction = isFunction; + Tone.prototype.isNumber = function (arg) { + return typeof arg === 'number'; + }; + Tone.prototype.isObject = function (arg) { + return Object.prototype.toString.call(arg) === '[object Object]' && arg.constructor === Object; + }; + Tone.prototype.isBoolean = function (arg) { + return typeof arg === 'boolean'; + }; + Tone.prototype.isArray = function (arg) { + return Array.isArray(arg); + }; + Tone.prototype.isString = function (arg) { + return typeof arg === 'string'; + }; + Tone.noOp = function () { + }; + Tone.prototype._readOnly = function (property) { + if (Array.isArray(property)) { + for (var i = 0; i < property.length; i++) { + this._readOnly(property[i]); + } + } else { + Object.defineProperty(this, property, { + writable: false, + enumerable: true + }); + } + }; + Tone.prototype._writable = function (property) { + if (Array.isArray(property)) { + for (var i = 0; i < property.length; i++) { + this._writable(property[i]); + } + } else { + Object.defineProperty(this, property, { writable: true }); + } + }; + Tone.State = { + Started: 'started', + Stopped: 'stopped', + Paused: 'paused' + }; + Tone.prototype.equalPowerScale = function (percent) { + var piFactor = 0.5 * Math.PI; + return Math.sin(percent * piFactor); + }; + Tone.prototype.dbToGain = function (db) { + return Math.pow(2, db / 6); + }; + Tone.prototype.gainToDb = function (gain) { + return 20 * (Math.log(gain) / Math.LN10); + }; + Tone.prototype.now = function () { + return this.context.currentTime; + }; + Tone.extend = function (child, parent) { + if (isUndef(parent)) { + parent = Tone; + } + function TempConstructor() { + } + TempConstructor.prototype = parent.prototype; + child.prototype = new TempConstructor(); + child.prototype.constructor = child; + child._super = parent; + }; + var newContextCallbacks = []; + Tone._initAudioContext = function (callback) { + callback(Tone.context); + newContextCallbacks.push(callback); + }; + Tone.setContext = function (ctx) { + Tone.prototype.context = ctx; + Tone.context = ctx; + for (var i = 0; i < newContextCallbacks.length; i++) { + newContextCallbacks[i](ctx); + } + }; + Tone.startMobile = function () { + var osc = Tone.context.createOscillator(); + var silent = Tone.context.createGain(); + silent.gain.value = 0; + osc.connect(silent); + silent.connect(Tone.context.destination); + var now = Tone.context.currentTime; + osc.start(now); + osc.stop(now + 1); + }; + Tone._initAudioContext(function (audioContext) { + Tone.prototype.blockTime = 128 / audioContext.sampleRate; + _silentNode = audioContext.createGain(); + _silentNode.gain.value = 0; + _silentNode.connect(audioContext.destination); + }); + Tone.version = 'r7-dev'; + return Tone; +}(); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_SignalBase; +Tone_signal_SignalBase = function (Tone) { + 'use strict'; + Tone.SignalBase = function () { + }; + Tone.extend(Tone.SignalBase); + Tone.SignalBase.prototype.connect = function (node, outputNumber, inputNumber) { + if (Tone.Signal && Tone.Signal === node.constructor || Tone.Param && Tone.Param === node.constructor || Tone.TimelineSignal && Tone.TimelineSignal === node.constructor) { + node._param.cancelScheduledValues(0); + node._param.value = 0; + node.overridden = true; + } else if (node instanceof AudioParam) { + node.cancelScheduledValues(0); + node.value = 0; + } + Tone.prototype.connect.call(this, node, outputNumber, inputNumber); + return this; + }; + return Tone.SignalBase; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_WaveShaper; +Tone_signal_WaveShaper = function (Tone) { + 'use strict'; + Tone.WaveShaper = function (mapping, bufferLen) { + this._shaper = this.input = this.output = this.context.createWaveShaper(); + this._curve = null; + if (Array.isArray(mapping)) { + this.curve = mapping; + } else if (isFinite(mapping) || this.isUndef(mapping)) { + this._curve = new Float32Array(this.defaultArg(mapping, 1024)); + } else if (this.isFunction(mapping)) { + this._curve = new Float32Array(this.defaultArg(bufferLen, 1024)); + this.setMap(mapping); + } + }; + Tone.extend(Tone.WaveShaper, Tone.SignalBase); + Tone.WaveShaper.prototype.setMap = function (mapping) { + for (var i = 0, len = this._curve.length; i < len; i++) { + var normalized = i / len * 2 - 1; + this._curve[i] = mapping(normalized, i); + } + this._shaper.curve = this._curve; + return this; + }; + Object.defineProperty(Tone.WaveShaper.prototype, 'curve', { + get: function () { + return this._shaper.curve; + }, + set: function (mapping) { + this._curve = new Float32Array(mapping); + this._shaper.curve = this._curve; + } + }); + Object.defineProperty(Tone.WaveShaper.prototype, 'oversample', { + get: function () { + return this._shaper.oversample; + }, + set: function (oversampling) { + if ([ + 'none', + '2x', + '4x' + ].indexOf(oversampling) !== -1) { + this._shaper.oversample = oversampling; + } else { + throw new Error('invalid oversampling: ' + oversampling); + } + } + }); + Tone.WaveShaper.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._shaper.disconnect(); + this._shaper = null; + this._curve = null; + return this; + }; + return Tone.WaveShaper; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Type; +Tone_core_Type = function (Tone) { + 'use strict'; + Tone.Type = { + Default: 'number', + Time: 'time', + Frequency: 'frequency', + NormalRange: 'normalRange', + AudioRange: 'audioRange', + Decibels: 'db', + Interval: 'interval', + BPM: 'bpm', + Positive: 'positive', + Cents: 'cents', + Degrees: 'degrees', + MIDI: 'midi', + TransportTime: 'transportTime', + Ticks: 'tick', + Note: 'note', + Milliseconds: 'milliseconds', + Notation: 'notation' + }; + Tone.prototype.isNowRelative = function () { + var nowRelative = new RegExp(/^\s*\+(.)+/i); + return function (note) { + return nowRelative.test(note); + }; + }(); + Tone.prototype.isTicks = function () { + var tickFormat = new RegExp(/^\d+i$/i); + return function (note) { + return tickFormat.test(note); + }; + }(); + Tone.prototype.isNotation = function () { + var notationFormat = new RegExp(/^[0-9]+[mnt]$/i); + return function (note) { + return notationFormat.test(note); + }; + }(); + Tone.prototype.isTransportTime = function () { + var transportTimeFormat = new RegExp(/^(\d+(\.\d+)?\:){1,2}(\d+(\.\d+)?)?$/i); + return function (transportTime) { + return transportTimeFormat.test(transportTime); + }; + }(); + Tone.prototype.isNote = function () { + var noteFormat = new RegExp(/^[a-g]{1}(b|#|x|bb)?-?[0-9]+$/i); + return function (note) { + return noteFormat.test(note); + }; + }(); + Tone.prototype.isFrequency = function () { + var freqFormat = new RegExp(/^\d*\.?\d+hz$/i); + return function (freq) { + return freqFormat.test(freq); + }; + }(); + function getTransportBpm() { + if (Tone.Transport && Tone.Transport.bpm) { + return Tone.Transport.bpm.value; + } else { + return 120; + } + } + function getTransportTimeSignature() { + if (Tone.Transport && Tone.Transport.timeSignature) { + return Tone.Transport.timeSignature; + } else { + return 4; + } + } + Tone.prototype.notationToSeconds = function (notation, bpm, timeSignature) { + bpm = this.defaultArg(bpm, getTransportBpm()); + timeSignature = this.defaultArg(timeSignature, getTransportTimeSignature()); + var beatTime = 60 / bpm; + if (notation === '1n') { + notation = '1m'; + } + var subdivision = parseInt(notation, 10); + var beats = 0; + if (subdivision === 0) { + beats = 0; + } + var lastLetter = notation.slice(-1); + if (lastLetter === 't') { + beats = 4 / subdivision * 2 / 3; + } else if (lastLetter === 'n') { + beats = 4 / subdivision; + } else if (lastLetter === 'm') { + beats = subdivision * timeSignature; + } else { + beats = 0; + } + return beatTime * beats; + }; + Tone.prototype.transportTimeToSeconds = function (transportTime, bpm, timeSignature) { + bpm = this.defaultArg(bpm, getTransportBpm()); + timeSignature = this.defaultArg(timeSignature, getTransportTimeSignature()); + var measures = 0; + var quarters = 0; + var sixteenths = 0; + var split = transportTime.split(':'); + if (split.length === 2) { + measures = parseFloat(split[0]); + quarters = parseFloat(split[1]); + } else if (split.length === 1) { + quarters = parseFloat(split[0]); + } else if (split.length === 3) { + measures = parseFloat(split[0]); + quarters = parseFloat(split[1]); + sixteenths = parseFloat(split[2]); + } + var beats = measures * timeSignature + quarters + sixteenths / 4; + return beats * (60 / bpm); + }; + Tone.prototype.ticksToSeconds = function (ticks, bpm) { + if (this.isUndef(Tone.Transport)) { + return 0; + } + ticks = parseFloat(ticks); + bpm = this.defaultArg(bpm, getTransportBpm()); + var tickTime = 60 / bpm / Tone.Transport.PPQ; + return tickTime * ticks; + }; + Tone.prototype.frequencyToSeconds = function (freq) { + return 1 / parseFloat(freq); + }; + Tone.prototype.samplesToSeconds = function (samples) { + return samples / this.context.sampleRate; + }; + Tone.prototype.secondsToSamples = function (seconds) { + return seconds * this.context.sampleRate; + }; + Tone.prototype.secondsToTransportTime = function (seconds, bpm, timeSignature) { + bpm = this.defaultArg(bpm, getTransportBpm()); + timeSignature = this.defaultArg(timeSignature, getTransportTimeSignature()); + var quarterTime = 60 / bpm; + var quarters = seconds / quarterTime; + var measures = Math.floor(quarters / timeSignature); + var sixteenths = quarters % 1 * 4; + quarters = Math.floor(quarters) % timeSignature; + var progress = [ + measures, + quarters, + sixteenths + ]; + return progress.join(':'); + }; + Tone.prototype.secondsToFrequency = function (seconds) { + return 1 / seconds; + }; + Tone.prototype.toTransportTime = function (time, bpm, timeSignature) { + var seconds = this.toSeconds(time); + return this.secondsToTransportTime(seconds, bpm, timeSignature); + }; + Tone.prototype.toFrequency = function (freq, now) { + if (this.isFrequency(freq)) { + return parseFloat(freq); + } else if (this.isNotation(freq) || this.isTransportTime(freq)) { + return this.secondsToFrequency(this.toSeconds(freq, now)); + } else if (this.isNote(freq)) { + return this.noteToFrequency(freq); + } else { + return freq; + } + }; + Tone.prototype.toTicks = function (time) { + if (this.isUndef(Tone.Transport)) { + return 0; + } + var bpm = Tone.Transport.bpm.value; + var plusNow = 0; + if (this.isNowRelative(time)) { + time = time.replace('+', ''); + plusNow = Tone.Transport.ticks; + } else if (this.isUndef(time)) { + return Tone.Transport.ticks; + } + var seconds = this.toSeconds(time); + var quarter = 60 / bpm; + var quarters = seconds / quarter; + var tickNum = quarters * Tone.Transport.PPQ; + return Math.round(tickNum + plusNow); + }; + Tone.prototype.toSamples = function (time) { + var seconds = this.toSeconds(time); + return Math.round(seconds * this.context.sampleRate); + }; + Tone.prototype.toSeconds = function (time, now) { + now = this.defaultArg(now, this.now()); + if (this.isNumber(time)) { + return time; + } else if (this.isString(time)) { + var plusTime = 0; + if (this.isNowRelative(time)) { + time = time.replace('+', ''); + plusTime = now; + } + var betweenParens = time.match(/\(([^)(]+)\)/g); + if (betweenParens) { + for (var j = 0; j < betweenParens.length; j++) { + var symbol = betweenParens[j].replace(/[\(\)]/g, ''); + var symbolVal = this.toSeconds(symbol); + time = time.replace(betweenParens[j], symbolVal); + } + } + if (time.indexOf('@') !== -1) { + var quantizationSplit = time.split('@'); + if (!this.isUndef(Tone.Transport)) { + var toQuantize = quantizationSplit[0].trim(); + if (toQuantize === '') { + toQuantize = undefined; + } + if (plusTime > 0) { + toQuantize = '+' + toQuantize; + plusTime = 0; + } + var subdivision = quantizationSplit[1].trim(); + time = Tone.Transport.quantize(toQuantize, subdivision); + } else { + throw new Error('quantization requires Tone.Transport'); + } + } else { + var components = time.split(/[\(\)\-\+\/\*]/); + if (components.length > 1) { + var originalTime = time; + for (var i = 0; i < components.length; i++) { + var symb = components[i].trim(); + if (symb !== '') { + var val = this.toSeconds(symb); + time = time.replace(symb, val); + } + } + try { + time = eval(time); + } catch (e) { + throw new EvalError('cannot evaluate Time: ' + originalTime); + } + } else if (this.isNotation(time)) { + time = this.notationToSeconds(time); + } else if (this.isTransportTime(time)) { + time = this.transportTimeToSeconds(time); + } else if (this.isFrequency(time)) { + time = this.frequencyToSeconds(time); + } else if (this.isTicks(time)) { + time = this.ticksToSeconds(time); + } else { + time = parseFloat(time); + } + } + return time + plusTime; + } else { + return now; + } + }; + Tone.prototype.toNotation = function (time, bpm, timeSignature) { + var testNotations = [ + '1m', + '2n', + '4n', + '8n', + '16n', + '32n', + '64n', + '128n' + ]; + var retNotation = toNotationHelper.call(this, time, bpm, timeSignature, testNotations); + var testTripletNotations = [ + '1m', + '2n', + '2t', + '4n', + '4t', + '8n', + '8t', + '16n', + '16t', + '32n', + '32t', + '64n', + '64t', + '128n' + ]; + var retTripletNotation = toNotationHelper.call(this, time, bpm, timeSignature, testTripletNotations); + if (retTripletNotation.split('+').length < retNotation.split('+').length) { + return retTripletNotation; + } else { + return retNotation; + } + }; + function toNotationHelper(time, bpm, timeSignature, testNotations) { + var seconds = this.toSeconds(time); + var threshold = this.notationToSeconds(testNotations[testNotations.length - 1], bpm, timeSignature); + var retNotation = ''; + for (var i = 0; i < testNotations.length; i++) { + var notationTime = this.notationToSeconds(testNotations[i], bpm, timeSignature); + var multiple = seconds / notationTime; + var floatingPointError = 0.000001; + if (1 - multiple % 1 < floatingPointError) { + multiple += floatingPointError; + } + multiple = Math.floor(multiple); + if (multiple > 0) { + if (multiple === 1) { + retNotation += testNotations[i]; + } else { + retNotation += multiple.toString() + '*' + testNotations[i]; + } + seconds -= multiple * notationTime; + if (seconds < threshold) { + break; + } else { + retNotation += ' + '; + } + } + } + if (retNotation === '') { + retNotation = '0'; + } + return retNotation; + } + Tone.prototype.fromUnits = function (val, units) { + if (this.convert || this.isUndef(this.convert)) { + switch (units) { + case Tone.Type.Time: + return this.toSeconds(val); + case Tone.Type.Frequency: + return this.toFrequency(val); + case Tone.Type.Decibels: + return this.dbToGain(val); + case Tone.Type.NormalRange: + return Math.min(Math.max(val, 0), 1); + case Tone.Type.AudioRange: + return Math.min(Math.max(val, -1), 1); + case Tone.Type.Positive: + return Math.max(val, 0); + default: + return val; + } + } else { + return val; + } + }; + Tone.prototype.toUnits = function (val, units) { + if (this.convert || this.isUndef(this.convert)) { + switch (units) { + case Tone.Type.Decibels: + return this.gainToDb(val); + default: + return val; + } + } else { + return val; + } + }; + var noteToScaleIndex = { + 'cbb': -2, + 'cb': -1, + 'c': 0, + 'c#': 1, + 'cx': 2, + 'dbb': 0, + 'db': 1, + 'd': 2, + 'd#': 3, + 'dx': 4, + 'ebb': 2, + 'eb': 3, + 'e': 4, + 'e#': 5, + 'ex': 6, + 'fbb': 3, + 'fb': 4, + 'f': 5, + 'f#': 6, + 'fx': 7, + 'gbb': 5, + 'gb': 6, + 'g': 7, + 'g#': 8, + 'gx': 9, + 'abb': 7, + 'ab': 8, + 'a': 9, + 'a#': 10, + 'ax': 11, + 'bbb': 9, + 'bb': 10, + 'b': 11, + 'b#': 12, + 'bx': 13 + }; + var scaleIndexToNote = [ + 'C', + 'C#', + 'D', + 'D#', + 'E', + 'F', + 'F#', + 'G', + 'G#', + 'A', + 'A#', + 'B' + ]; + Tone.A4 = 440; + Tone.prototype.noteToFrequency = function (note) { + var parts = note.split(/(-?\d+)/); + if (parts.length === 3) { + var index = noteToScaleIndex[parts[0].toLowerCase()]; + var octave = parts[1]; + var noteNumber = index + (parseInt(octave, 10) + 1) * 12; + return this.midiToFrequency(noteNumber); + } else { + return 0; + } + }; + Tone.prototype.frequencyToNote = function (freq) { + var log = Math.log(freq / Tone.A4) / Math.LN2; + var noteNumber = Math.round(12 * log) + 57; + var octave = Math.floor(noteNumber / 12); + if (octave < 0) { + noteNumber += -12 * octave; + } + var noteName = scaleIndexToNote[noteNumber % 12]; + return noteName + octave.toString(); + }; + Tone.prototype.intervalToFrequencyRatio = function (interval) { + return Math.pow(2, interval / 12); + }; + Tone.prototype.midiToNote = function (midiNumber) { + var octave = Math.floor(midiNumber / 12) - 1; + var note = midiNumber % 12; + return scaleIndexToNote[note] + octave; + }; + Tone.prototype.noteToMidi = function (note) { + var parts = note.split(/(\d+)/); + if (parts.length === 3) { + var index = noteToScaleIndex[parts[0].toLowerCase()]; + var octave = parts[1]; + return index + (parseInt(octave, 10) + 1) * 12; + } else { + return 0; + } + }; + Tone.prototype.midiToFrequency = function (midi) { + return Tone.A4 * Math.pow(2, (midi - 69) / 12); + }; + return Tone; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Param; +Tone_core_Param = function (Tone) { + 'use strict'; + Tone.Param = function () { + var options = this.optionsObject(arguments, [ + 'param', + 'units', + 'convert' + ], Tone.Param.defaults); + this._param = this.input = options.param; + this.units = options.units; + this.convert = options.convert; + this.overridden = false; + if (!this.isUndef(options.value)) { + this.value = options.value; + } + }; + Tone.extend(Tone.Param); + Tone.Param.defaults = { + 'units': Tone.Type.Default, + 'convert': true, + 'param': undefined + }; + Object.defineProperty(Tone.Param.prototype, 'value', { + get: function () { + return this._toUnits(this._param.value); + }, + set: function (value) { + var convertedVal = this._fromUnits(value); + this._param.value = convertedVal; + } + }); + Tone.Param.prototype._fromUnits = function (val) { + if (this.convert || this.isUndef(this.convert)) { + switch (this.units) { + case Tone.Type.Time: + return this.toSeconds(val); + case Tone.Type.Frequency: + return this.toFrequency(val); + case Tone.Type.Decibels: + return this.dbToGain(val); + case Tone.Type.NormalRange: + return Math.min(Math.max(val, 0), 1); + case Tone.Type.AudioRange: + return Math.min(Math.max(val, -1), 1); + case Tone.Type.Positive: + return Math.max(val, 0); + default: + return val; + } + } else { + return val; + } + }; + Tone.Param.prototype._toUnits = function (val) { + if (this.convert || this.isUndef(this.convert)) { + switch (this.units) { + case Tone.Type.Decibels: + return this.gainToDb(val); + default: + return val; + } + } else { + return val; + } + }; + Tone.Param.prototype._minOutput = 0.00001; + Tone.Param.prototype.setValueAtTime = function (value, time) { + value = this._fromUnits(value); + this._param.setValueAtTime(value, this.toSeconds(time)); + return this; + }; + Tone.Param.prototype.setRampPoint = function (now) { + now = this.defaultArg(now, this.now()); + var currentVal = this._param.value; + this._param.setValueAtTime(currentVal, now); + return this; + }; + Tone.Param.prototype.linearRampToValueAtTime = function (value, endTime) { + value = this._fromUnits(value); + this._param.linearRampToValueAtTime(value, this.toSeconds(endTime)); + return this; + }; + Tone.Param.prototype.exponentialRampToValueAtTime = function (value, endTime) { + value = this._fromUnits(value); + value = Math.max(this._minOutput, value); + this._param.exponentialRampToValueAtTime(value, this.toSeconds(endTime)); + return this; + }; + Tone.Param.prototype.exponentialRampToValue = function (value, rampTime) { + var now = this.now(); + var currentVal = this.value; + this.setValueAtTime(Math.max(currentVal, this._minOutput), now); + this.exponentialRampToValueAtTime(value, now + this.toSeconds(rampTime)); + return this; + }; + Tone.Param.prototype.linearRampToValue = function (value, rampTime) { + var now = this.now(); + this.setRampPoint(now); + this.linearRampToValueAtTime(value, now + this.toSeconds(rampTime)); + return this; + }; + Tone.Param.prototype.setTargetAtTime = function (value, startTime, timeConstant) { + value = this._fromUnits(value); + value = Math.max(this._minOutput, value); + timeConstant = Math.max(this._minOutput, timeConstant); + this._param.setTargetAtTime(value, this.toSeconds(startTime), timeConstant); + return this; + }; + Tone.Param.prototype.setValueCurveAtTime = function (values, startTime, duration) { + for (var i = 0; i < values.length; i++) { + values[i] = this._fromUnits(values[i]); + } + this._param.setValueCurveAtTime(values, this.toSeconds(startTime), this.toSeconds(duration)); + return this; + }; + Tone.Param.prototype.cancelScheduledValues = function (startTime) { + this._param.cancelScheduledValues(this.toSeconds(startTime)); + return this; + }; + Tone.Param.prototype.rampTo = function (value, rampTime) { + rampTime = this.defaultArg(rampTime, 0); + if (this.units === Tone.Type.Frequency || this.units === Tone.Type.BPM) { + this.exponentialRampToValue(value, rampTime); + } else { + this.linearRampToValue(value, rampTime); + } + return this; + }; + Tone.Param.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._param = null; + return this; + }; + return Tone.Param; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Gain; +Tone_core_Gain = function (Tone) { + 'use strict'; + Tone.Gain = function () { + var options = this.optionsObject(arguments, [ + 'gain', + 'units' + ], Tone.Gain.defaults); + this.input = this.output = this._gainNode = this.context.createGain(); + this.gain = new Tone.Param({ + 'param': this._gainNode.gain, + 'units': options.units, + 'value': options.gain, + 'convert': options.convert + }); + this._readOnly('gain'); + }; + Tone.extend(Tone.Gain); + Tone.Gain.defaults = { + 'gain': 1, + 'convert': true + }; + Tone.Gain.prototype.dispose = function () { + Tone.Param.prototype.dispose.call(this); + this._gainNode.disconnect(); + this._gainNode = null; + this._writable('gain'); + this.gain.dispose(); + this.gain = null; + }; + return Tone.Gain; +}(Tone_core_Tone, Tone_core_Param); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Signal; +Tone_signal_Signal = function (Tone) { + 'use strict'; + Tone.Signal = function () { + var options = this.optionsObject(arguments, [ + 'value', + 'units' + ], Tone.Signal.defaults); + this.output = this._gain = this.context.createGain(); + options.param = this._gain.gain; + Tone.Param.call(this, options); + this.input = this._param = this._gain.gain; + Tone.Signal._constant.chain(this._gain); + }; + Tone.extend(Tone.Signal, Tone.Param); + Tone.Signal.defaults = { + 'value': 0, + 'units': Tone.Type.Default, + 'convert': true + }; + Tone.Signal.prototype.connect = Tone.SignalBase.prototype.connect; + Tone.Signal.prototype.dispose = function () { + Tone.Param.prototype.dispose.call(this); + this._param = null; + this._gain.disconnect(); + this._gain = null; + return this; + }; + Tone.Signal._constant = null; + Tone._initAudioContext(function (audioContext) { + var buffer = audioContext.createBuffer(1, 128, audioContext.sampleRate); + var arr = buffer.getChannelData(0); + for (var i = 0; i < arr.length; i++) { + arr[i] = 1; + } + Tone.Signal._constant = audioContext.createBufferSource(); + Tone.Signal._constant.channelCount = 1; + Tone.Signal._constant.channelCountMode = 'explicit'; + Tone.Signal._constant.buffer = buffer; + Tone.Signal._constant.loop = true; + Tone.Signal._constant.start(0); + Tone.Signal._constant.noGC(); + }); + return Tone.Signal; +}(Tone_core_Tone, Tone_signal_WaveShaper, Tone_core_Type, Tone_core_Param); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Add; +Tone_signal_Add = function (Tone) { + 'use strict'; + Tone.Add = function (value) { + Tone.call(this, 2, 0); + this._sum = this.input[0] = this.input[1] = this.output = this.context.createGain(); + this._param = this.input[1] = new Tone.Signal(value); + this._param.connect(this._sum); + }; + Tone.extend(Tone.Add, Tone.Signal); + Tone.Add.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._sum.disconnect(); + this._sum = null; + this._param.dispose(); + this._param = null; + return this; + }; + return Tone.Add; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Multiply; +Tone_signal_Multiply = function (Tone) { + 'use strict'; + Tone.Multiply = function (value) { + Tone.call(this, 2, 0); + this._mult = this.input[0] = this.output = this.context.createGain(); + this._param = this.input[1] = this.output.gain; + this._param.value = this.defaultArg(value, 0); + }; + Tone.extend(Tone.Multiply, Tone.Signal); + Tone.Multiply.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._mult.disconnect(); + this._mult = null; + this._param = null; + return this; + }; + return Tone.Multiply; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Scale; +Tone_signal_Scale = function (Tone) { + 'use strict'; + Tone.Scale = function (outputMin, outputMax) { + this._outputMin = this.defaultArg(outputMin, 0); + this._outputMax = this.defaultArg(outputMax, 1); + this._scale = this.input = new Tone.Multiply(1); + this._add = this.output = new Tone.Add(0); + this._scale.connect(this._add); + this._setRange(); + }; + Tone.extend(Tone.Scale, Tone.SignalBase); + Object.defineProperty(Tone.Scale.prototype, 'min', { + get: function () { + return this._outputMin; + }, + set: function (min) { + this._outputMin = min; + this._setRange(); + } + }); + Object.defineProperty(Tone.Scale.prototype, 'max', { + get: function () { + return this._outputMax; + }, + set: function (max) { + this._outputMax = max; + this._setRange(); + } + }); + Tone.Scale.prototype._setRange = function () { + this._add.value = this._outputMin; + this._scale.value = this._outputMax - this._outputMin; + }; + Tone.Scale.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._add.dispose(); + this._add = null; + this._scale.dispose(); + this._scale = null; + return this; + }; + return Tone.Scale; +}(Tone_core_Tone, Tone_signal_Add, Tone_signal_Multiply); +var signal; +signal = function () { + 'use strict'; + // Signal is built with the Tone.js signal by Yotam Mann + // https://github.com/TONEnoTONE/Tone.js/ + var Signal = Tone_signal_Signal; + var Add = Tone_signal_Add; + var Mult = Tone_signal_Multiply; + var Scale = Tone_signal_Scale; + var Tone = Tone_core_Tone; + var p5sound = master; + Tone.setContext(p5sound.audiocontext); + /** + *

p5.Signal is a constant audio-rate signal used by p5.Oscillator + * and p5.Envelope for modulation math.

+ * + *

This is necessary because Web Audio is processed on a seprate clock. + * For example, the p5 draw loop runs about 60 times per second. But + * the audio clock must process samples 44100 times per second. If we + * want to add a value to each of those samples, we can't do it in the + * draw 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 + * a Tone.Signal from the Tone.js library by Yotam Mann. + * If you want to work directly with audio signals for modular + * synthesis, check out + * tone.js.

+ * + * @class p5.Signal + * @constructor + * @return {Tone.Signal} A Signal object from the Tone.js library + * @example + *
+ * function setup() { + * carrier = new p5.Oscillator('sine'); + * carrier.amp(1); // set amplitude + * carrier.freq(220); // set frequency + * carrier.start(); // start oscillating + * + * modulator = new p5.Oscillator('sawtooth'); + * modulator.disconnect(); + * modulator.amp(1); + * modulator.freq(4); + * modulator.start(); + * + * // Modulator's default amplitude range is -1 to 1. + * // Multiply it by -200, so the range is -200 to 200 + * // then add 220 so the range is 20 to 420 + * carrier.freq( modulator.mult(-200).add(220) ); + * } + *
+ */ + p5.Signal = function (value) { + var s = new Signal(value); + // p5sound.soundArray.push(s); + return s; + }; + /** + * Fade to value, for smooth transitions + * + * @method fade + * @param {Number} value Value to set this signal + * @param {Number} [secondsFromNow] Length of fade, in seconds from now + */ + Signal.prototype.fade = Signal.prototype.linearRampToValueAtTime; + Mult.prototype.fade = Signal.prototype.fade; + Add.prototype.fade = Signal.prototype.fade; + Scale.prototype.fade = Signal.prototype.fade; + /** + * Connect a p5.sound object or Web Audio node to this + * p5.Signal so that its amplitude values can be scaled. + * + * @param {Object} input + */ + Signal.prototype.setInput = function (_input) { + _input.connect(this); + }; + Mult.prototype.setInput = Signal.prototype.setInput; + Add.prototype.setInput = Signal.prototype.setInput; + Scale.prototype.setInput = Signal.prototype.setInput; + // signals can add / mult / scale themselves + /** + * Add a constant value to this audio signal, + * and return the resulting audio signal. Does + * not change the value of the original signal, + * instead it returns a new p5.SignalAdd. + * + * @method add + * @param {Number} number + * @return {p5.SignalAdd} object + */ + Signal.prototype.add = function (num) { + var add = new Add(num); + // add.setInput(this); + this.connect(add); + return add; + }; + Mult.prototype.add = Signal.prototype.add; + Add.prototype.add = Signal.prototype.add; + Scale.prototype.add = Signal.prototype.add; + /** + * Multiply this signal by a constant value, + * and return the resulting audio signal. Does + * not change the value of the original signal, + * instead it returns a new p5.SignalMult. + * + * @method mult + * @param {Number} number to multiply + * @return {Tone.Multiply} object + */ + Signal.prototype.mult = function (num) { + var mult = new Mult(num); + // mult.setInput(this); + this.connect(mult); + return mult; + }; + Mult.prototype.mult = Signal.prototype.mult; + Add.prototype.mult = Signal.prototype.mult; + Scale.prototype.mult = Signal.prototype.mult; + /** + * Scale this signal value to a given range, + * and return the result as an audio signal. Does + * not change the value of the original signal, + * instead it returns a new p5.SignalScale. + * + * @method scale + * @param {Number} number to multiply + * @param {Number} inMin input range minumum + * @param {Number} inMax input range maximum + * @param {Number} outMin input range minumum + * @param {Number} outMax input range maximum + * @return {p5.SignalScale} object + */ + Signal.prototype.scale = function (inMin, inMax, outMin, outMax) { + var mapOutMin, mapOutMax; + if (arguments.length === 4) { + mapOutMin = p5.prototype.map(outMin, inMin, inMax, 0, 1) - 0.5; + mapOutMax = p5.prototype.map(outMax, inMin, inMax, 0, 1) - 0.5; + } else { + mapOutMin = arguments[0]; + mapOutMax = arguments[1]; + } + var scale = new Scale(mapOutMin, mapOutMax); + this.connect(scale); + return scale; + }; + Mult.prototype.scale = Signal.prototype.scale; + Add.prototype.scale = Signal.prototype.scale; + Scale.prototype.scale = Signal.prototype.scale; +}(Tone_signal_Signal, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale, Tone_core_Tone, master); +var oscillator; +oscillator = function () { + 'use strict'; + var p5sound = master; + var Signal = Tone_signal_Signal; + var Add = Tone_signal_Add; + var Mult = Tone_signal_Multiply; + var Scale = Tone_signal_Scale; + /** + *

Creates a signal that oscillates between -1.0 and 1.0. + * By default, the oscillation takes the form of a sinusoidal + * shape ('sine'). Additional types include 'triangle', + * 'sawtooth' and 'square'. The frequency defaults to + * 440 oscillations per second (440Hz, equal to the pitch of an + * 'A' note).

+ * + *

Set the type of oscillation with setType(), or by creating a + * specific oscillator.

For example: + * new p5.SinOsc(freq) + * new p5.TriOsc(freq) + * new p5.SqrOsc(freq) + * new p5.SawOsc(freq). + *

+ * + * @class p5.Oscillator + * @constructor + * @param {Number} [freq] frequency defaults to 440Hz + * @param {String} [type] type of oscillator. Options: + * 'sine' (default), 'triangle', + * 'sawtooth', 'square' + * @return {Object} Oscillator object + * @example + *
+ * var osc; + * var playing = false; + * + * function setup() { + * backgroundColor = color(255,0,255); + * textAlign(CENTER); + * + * osc = new p5.Oscillator(); + * osc.setType('sine'); + * osc.freq(240); + * osc.amp(0); + * osc.start(); + * } + * + * function draw() { + * background(backgroundColor) + * text('click to play', width/2, height/2); + * } + * + * function mouseClicked() { + * if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) { + * if (!playing) { + * // ramp amplitude to 0.5 over 0.1 seconds + * osc.amp(0.5, 0.05); + * playing = true; + * backgroundColor = color(0,255,255); + * } else { + * // ramp amplitude to 0 over 0.5 seconds + * osc.amp(0, 0.5); + * playing = false; + * backgroundColor = color(255,0,255); + * } + * } + * } + *
+ */ + p5.Oscillator = function (freq, type) { + if (typeof freq === 'string') { + var f = type; + type = freq; + freq = f; + } + if (typeof type === 'number') { + var f = type; + type = freq; + freq = f; + } + this.started = false; + // components + this.phaseAmount = undefined; + this.oscillator = p5sound.audiocontext.createOscillator(); + this.f = freq || 440; + // frequency + this.oscillator.type = type || 'sine'; + this.oscillator.frequency.setValueAtTime(this.f, p5sound.audiocontext.currentTime); + var o = this.oscillator; + // connections + this.output = p5sound.audiocontext.createGain(); + this._freqMods = []; + // modulators connected to this oscillator's frequency + // set default output gain to 0.5 + this.output.gain.value = 0.5; + this.output.gain.setValueAtTime(0.5, p5sound.audiocontext.currentTime); + this.oscillator.connect(this.output); + // stereo panning + this.panPosition = 0; + this.connection = p5sound.input; + // connect to p5sound by default + this.panner = new p5.Panner(this.output, this.connection, 1); + //array of math operation signal chaining + this.mathOps = [this.output]; + // add to the soundArray so we can dispose of the osc later + p5sound.soundArray.push(this); + }; + /** + * Start an oscillator. Accepts an optional parameter to + * determine how long (in seconds from now) until the + * oscillator starts. + * + * @method start + * @param {Number} [time] startTime in seconds from now. + * @param {Number} [frequency] frequency in Hz. + */ + p5.Oscillator.prototype.start = function (time, f) { + if (this.started) { + var now = p5sound.audiocontext.currentTime; + this.stop(now); + } + if (!this.started) { + var freq = f || this.f; + var type = this.oscillator.type; + // set old osc free to be garbage collected (memory) + if (this.oscillator) { + this.oscillator.disconnect(); + this.oscillator = undefined; + } + // var detune = this.oscillator.frequency.value; + this.oscillator = p5sound.audiocontext.createOscillator(); + this.oscillator.frequency.exponentialRampToValueAtTime(Math.abs(freq), p5sound.audiocontext.currentTime); + this.oscillator.type = type; + // this.oscillator.detune.value = detune; + this.oscillator.connect(this.output); + time = time || 0; + this.oscillator.start(time + p5sound.audiocontext.currentTime); + this.freqNode = this.oscillator.frequency; + // if other oscillators are already connected to this osc's freq + for (var i in this._freqMods) { + if (typeof this._freqMods[i].connect !== 'undefined') { + this._freqMods[i].connect(this.oscillator.frequency); + } + } + this.started = true; + } + }; + /** + * Stop an oscillator. Accepts an optional parameter + * to determine how long (in seconds from now) until the + * oscillator stops. + * + * @method stop + * @param {Number} secondsFromNow Time, in seconds from now. + */ + p5.Oscillator.prototype.stop = function (time) { + if (this.started) { + var t = time || 0; + var now = p5sound.audiocontext.currentTime; + this.oscillator.stop(t + now); + this.started = false; + } + }; + /** + * Set the amplitude between 0 and 1.0. Or, pass in an object + * such as an oscillator to modulate amplitude with an audio signal. + * + * @method amp + * @param {Number|Object} vol between 0 and 1.0 + * or a modulating signal/oscillator + * @param {Number} [rampTime] create a fade that lasts rampTime + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + * @return {AudioParam} gain If no value is provided, + * returns the Web Audio API + * AudioParam that controls + * this oscillator's + * gain/amplitude/volume) + */ + p5.Oscillator.prototype.amp = function (vol, rampTime, tFromNow) { + var self = this; + if (typeof vol === 'number') { + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var now = p5sound.audiocontext.currentTime; + var currentVol = this.output.gain.value; + this.output.gain.cancelScheduledValues(now); + this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); + this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); + } else if (vol) { + vol.connect(self.output.gain); + } else { + // return the Gain Node + return this.output.gain; + } + }; + // these are now the same thing + p5.Oscillator.prototype.fade = p5.Oscillator.prototype.amp; + p5.Oscillator.prototype.getAmp = function () { + return this.output.gain.value; + }; + /** + * Set frequency of an oscillator to a value. Or, pass in an object + * such as an oscillator to modulate the frequency with an audio signal. + * + * @method freq + * @param {Number|Object} Frequency Frequency in Hz + * or modulating signal/oscillator + * @param {Number} [rampTime] Ramp time (in seconds) + * @param {Number} [timeFromNow] Schedule this event to happen + * at x seconds from now + * @return {AudioParam} Frequency If no value is provided, + * returns the Web Audio API + * AudioParam that controls + * this oscillator's frequency + * @example + *
+ * var osc = new p5.Oscillator(300); + * osc.start(); + * osc.freq(40, 10); + *
+ */ + p5.Oscillator.prototype.freq = function (val, rampTime, tFromNow) { + if (typeof val === 'number' && !isNaN(val)) { + this.f = val; + var now = p5sound.audiocontext.currentTime; + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + // var currentFreq = this.oscillator.frequency.value; + // this.oscillator.frequency.cancelScheduledValues(now); + if (rampTime == 0) { + this.oscillator.frequency.cancelScheduledValues(now); + this.oscillator.frequency.setValueAtTime(val, tFromNow + now); + } else { + if (val > 0) { + this.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now); + } else { + this.oscillator.frequency.linearRampToValueAtTime(val, tFromNow + rampTime + now); + } + } + // reset phase if oscillator has a phase + if (this.phaseAmount) { + this.phase(this.phaseAmount); + } + } else if (val) { + if (val.output) { + val = val.output; + } + val.connect(this.oscillator.frequency); + // keep track of what is modulating this param + // so it can be re-connected if + this._freqMods.push(val); + } else { + // return the Frequency Node + return this.oscillator.frequency; + } + }; + p5.Oscillator.prototype.getFreq = function () { + return this.oscillator.frequency.value; + }; + /** + * Set type to 'sine', 'triangle', 'sawtooth' or 'square'. + * + * @method setType + * @param {String} type 'sine', 'triangle', 'sawtooth' or 'square'. + */ + p5.Oscillator.prototype.setType = function (type) { + this.oscillator.type = type; + }; + p5.Oscillator.prototype.getType = function () { + return this.oscillator.type; + }; + /** + * Connect to a p5.sound / Web Audio object. + * + * @method connect + * @param {Object} unit A p5.sound or Web Audio object + */ + p5.Oscillator.prototype.connect = function (unit) { + if (!unit) { + this.panner.connect(p5sound.input); + } else if (unit.hasOwnProperty('input')) { + this.panner.connect(unit.input); + this.connection = unit.input; + } else { + this.panner.connect(unit); + this.connection = unit; + } + }; + /** + * Disconnect all outputs + * + * @method disconnect + */ + p5.Oscillator.prototype.disconnect = function (unit) { + this.output.disconnect(); + this.panner.disconnect(); + this.output.connect(this.panner); + this.oscMods = []; + }; + /** + * Pan between Left (-1) and Right (1) + * + * @method pan + * @param {Number} panning Number between -1 and 1 + * @param {Number} timeFromNow schedule this event to happen + * seconds from now + */ + p5.Oscillator.prototype.pan = function (pval, tFromNow) { + this.panPosition = pval; + this.panner.pan(pval, tFromNow); + }; + p5.Oscillator.prototype.getPan = function () { + return this.panPosition; + }; + // get rid of the oscillator + p5.Oscillator.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + if (this.oscillator) { + var now = p5sound.audiocontext.currentTime; + this.stop(now); + this.disconnect(); + this.panner = null; + this.oscillator = null; + } + // if it is a Pulse + if (this.osc2) { + this.osc2.dispose(); + } + }; + /** + * Set the phase of an oscillator between 0.0 and 1.0. + * In this implementation, phase is a delay time + * based on the oscillator's current frequency. + * + * @method phase + * @param {Number} phase float between 0.0 and 1.0 + */ + p5.Oscillator.prototype.phase = function (p) { + var delayAmt = p5.prototype.map(p, 0, 1, 0, 1 / this.f); + var now = p5sound.audiocontext.currentTime; + this.phaseAmount = p; + if (!this.dNode) { + // create a delay node + this.dNode = p5sound.audiocontext.createDelay(); + // put the delay node in between output and panner + this.oscillator.disconnect(); + this.oscillator.connect(this.dNode); + this.dNode.connect(this.output); + } + // set delay time to match phase: + this.dNode.delayTime.setValueAtTime(delayAmt, now); + }; + // ========================== // + // SIGNAL MATH FOR MODULATION // + // ========================== // + // return sigChain(this, scale, thisChain, nextChain, Scale); + var sigChain = function (o, mathObj, thisChain, nextChain, type) { + var chainSource = o.oscillator; + // if this type of math already exists in the chain, replace it + for (var i in o.mathOps) { + if (o.mathOps[i] instanceof type) { + chainSource.disconnect(); + o.mathOps[i].dispose(); + thisChain = i; + // assume nextChain is output gain node unless... + if (thisChain < o.mathOps.length - 2) { + nextChain = o.mathOps[i + 1]; + } + } + } + if (thisChain == o.mathOps.length - 1) { + o.mathOps.push(nextChain); + } + // assume source is the oscillator unless i > 0 + if (i > 0) { + chainSource = o.mathOps[i - 1]; + } + chainSource.disconnect(); + chainSource.connect(mathObj); + mathObj.connect(nextChain); + o.mathOps[thisChain] = mathObj; + return o; + }; + /** + * Add a value to the p5.Oscillator's output amplitude, + * and return the oscillator. Calling this method again + * will override the initial add() with a new value. + * + * @method add + * @param {Number} number Constant number to add + * @return {p5.Oscillator} Oscillator Returns this oscillator + * with scaled output + * + */ + p5.Oscillator.prototype.add = function (num) { + var add = new Add(num); + var thisChain = this.mathOps.length - 1; + var nextChain = this.output; + return sigChain(this, add, thisChain, nextChain, Add); + }; + /** + * Multiply the p5.Oscillator's output amplitude + * by a fixed value (i.e. turn it up!). Calling this method + * again will override the initial mult() with a new value. + * + * @method mult + * @param {Number} number Constant number to multiply + * @return {p5.Oscillator} Oscillator Returns this oscillator + * with multiplied output + */ + p5.Oscillator.prototype.mult = function (num) { + var mult = new Mult(num); + var thisChain = this.mathOps.length - 1; + var nextChain = this.output; + return sigChain(this, mult, thisChain, nextChain, Mult); + }; + /** + * Scale this oscillator's amplitude values to a given + * range, and return the oscillator. Calling this method + * again will override the initial scale() with new values. + * + * @method scale + * @param {Number} inMin input range minumum + * @param {Number} inMax input range maximum + * @param {Number} outMin input range minumum + * @param {Number} outMax input range maximum + * @return {p5.Oscillator} Oscillator Returns this oscillator + * with scaled output + */ + p5.Oscillator.prototype.scale = function (inMin, inMax, outMin, outMax) { + var mapOutMin, mapOutMax; + if (arguments.length === 4) { + mapOutMin = p5.prototype.map(outMin, inMin, inMax, 0, 1) - 0.5; + mapOutMax = p5.prototype.map(outMax, inMin, inMax, 0, 1) - 0.5; + } else { + mapOutMin = arguments[0]; + mapOutMax = arguments[1]; + } + var scale = new Scale(mapOutMin, mapOutMax); + var thisChain = this.mathOps.length - 1; + var nextChain = this.output; + return sigChain(this, scale, thisChain, nextChain, Scale); + }; + // ============================== // + // SinOsc, TriOsc, SqrOsc, SawOsc // + // ============================== // + /** + * Constructor: new p5.SinOsc(). + * This creates a Sine Wave Oscillator and is + * equivalent to new p5.Oscillator('sine') + * or creating a p5.Oscillator and then calling + * its method setType('sine'). + * See p5.Oscillator for methods. + * + * @method p5.SinOsc + * @param {Number} [freq] Set the frequency + */ + p5.SinOsc = function (freq) { + p5.Oscillator.call(this, freq, 'sine'); + }; + p5.SinOsc.prototype = Object.create(p5.Oscillator.prototype); + /** + * Constructor: new p5.TriOsc(). + * This creates a Triangle Wave Oscillator and is + * equivalent to new p5.Oscillator('triangle') + * or creating a p5.Oscillator and then calling + * its method setType('triangle'). + * See p5.Oscillator for methods. + * + * @method p5.TriOsc + * @param {Number} [freq] Set the frequency + */ + p5.TriOsc = function (freq) { + p5.Oscillator.call(this, freq, 'triangle'); + }; + p5.TriOsc.prototype = Object.create(p5.Oscillator.prototype); + /** + * Constructor: new p5.SawOsc(). + * This creates a SawTooth Wave Oscillator and is + * equivalent to new p5.Oscillator('sawtooth') + * or creating a p5.Oscillator and then calling + * its method setType('sawtooth'). + * See p5.Oscillator for methods. + * + * @method p5.SawOsc + * @param {Number} [freq] Set the frequency + */ + p5.SawOsc = function (freq) { + p5.Oscillator.call(this, freq, 'sawtooth'); + }; + p5.SawOsc.prototype = Object.create(p5.Oscillator.prototype); + /** + * Constructor: new p5.SqrOsc(). + * This creates a Square Wave Oscillator and is + * equivalent to new p5.Oscillator('square') + * or creating a p5.Oscillator and then calling + * its method setType('square'). + * See p5.Oscillator for methods. + * + * @method p5.SqrOsc + * @param {Number} [freq] Set the frequency + */ + p5.SqrOsc = function (freq) { + p5.Oscillator.call(this, freq, 'square'); + }; + p5.SqrOsc.prototype = Object.create(p5.Oscillator.prototype); +}(master, Tone_signal_Signal, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Timeline; +Tone_core_Timeline = function (Tone) { + 'use strict'; + Tone.Timeline = function () { + var options = this.optionsObject(arguments, ['memory'], Tone.Timeline.defaults); + this._timeline = []; + this._toRemove = []; + this._iterating = false; + this.memory = options.memory; + }; + Tone.extend(Tone.Timeline); + Tone.Timeline.defaults = { 'memory': Infinity }; + Object.defineProperty(Tone.Timeline.prototype, 'length', { + get: function () { + return this._timeline.length; + } + }); + Tone.Timeline.prototype.addEvent = function (event) { + if (this.isUndef(event.time)) { + throw new Error('events must have a time attribute'); + } + event.time = this.toSeconds(event.time); + if (this._timeline.length) { + var index = this._search(event.time); + this._timeline.splice(index + 1, 0, event); + } else { + this._timeline.push(event); + } + if (this.length > this.memory) { + var diff = this.length - this.memory; + this._timeline.splice(0, diff); + } + return this; + }; + Tone.Timeline.prototype.removeEvent = function (event) { + if (this._iterating) { + this._toRemove.push(event); + } else { + var index = this._timeline.indexOf(event); + if (index !== -1) { + this._timeline.splice(index, 1); + } + } + return this; + }; + Tone.Timeline.prototype.getEvent = function (time) { + time = this.toSeconds(time); + var index = this._search(time); + if (index !== -1) { + return this._timeline[index]; + } else { + return null; + } + }; + Tone.Timeline.prototype.getEventAfter = function (time) { + time = this.toSeconds(time); + var index = this._search(time); + if (index + 1 < this._timeline.length) { + return this._timeline[index + 1]; + } else { + return null; + } + }; + Tone.Timeline.prototype.getEventBefore = function (time) { + time = this.toSeconds(time); + var index = this._search(time); + if (index - 1 >= 0) { + return this._timeline[index - 1]; + } else { + return null; + } + }; + Tone.Timeline.prototype.cancel = function (after) { + if (this._timeline.length > 1) { + after = this.toSeconds(after); + var index = this._search(after); + if (index >= 0) { + this._timeline = this._timeline.slice(0, index); + } else { + this._timeline = []; + } + } else if (this._timeline.length === 1) { + if (this._timeline[0].time >= after) { + this._timeline = []; + } + } + return this; + }; + Tone.Timeline.prototype.cancelBefore = function (time) { + if (this._timeline.length) { + time = this.toSeconds(time); + var index = this._search(time); + if (index >= 0) { + this._timeline = this._timeline.slice(index + 1); + } + } + return this; + }; + Tone.Timeline.prototype._search = function (time) { + var beginning = 0; + var len = this._timeline.length; + var end = len; + while (beginning <= end && beginning < len) { + var midPoint = Math.floor(beginning + (end - beginning) / 2); + var event = this._timeline[midPoint]; + if (event.time === time) { + for (var i = midPoint; i < this._timeline.length; i++) { + var testEvent = this._timeline[i]; + if (testEvent.time === time) { + midPoint = i; + } + } + return midPoint; + } else if (event.time > time) { + end = midPoint - 1; + } else if (event.time < time) { + beginning = midPoint + 1; + } + } + return beginning - 1; + }; + Tone.Timeline.prototype._iterate = function (callback, lowerBound, upperBound) { + this._iterating = true; + lowerBound = this.defaultArg(lowerBound, 0); + upperBound = this.defaultArg(upperBound, this._timeline.length - 1); + for (var i = lowerBound; i <= upperBound; i++) { + callback(this._timeline[i]); + } + this._iterating = false; + if (this._toRemove.length > 0) { + for (var j = 0; j < this._toRemove.length; j++) { + var index = this._timeline.indexOf(this._toRemove[j]); + if (index !== -1) { + this._timeline.splice(index, 1); + } + } + this._toRemove = []; + } + }; + Tone.Timeline.prototype.forEach = function (callback) { + this._iterate(callback); + return this; + }; + Tone.Timeline.prototype.forEachBefore = function (time, callback) { + time = this.toSeconds(time); + var upperBound = this._search(time); + if (upperBound !== -1) { + this._iterate(callback, 0, upperBound); + } + return this; + }; + Tone.Timeline.prototype.forEachAfter = function (time, callback) { + time = this.toSeconds(time); + var lowerBound = this._search(time); + this._iterate(callback, lowerBound + 1); + return this; + }; + Tone.Timeline.prototype.forEachFrom = function (time, callback) { + time = this.toSeconds(time); + var lowerBound = this._search(time); + while (lowerBound >= 0 && this._timeline[lowerBound].time >= time) { + lowerBound--; + } + this._iterate(callback, lowerBound + 1); + return this; + }; + Tone.Timeline.prototype.forEachAtTime = function (time, callback) { + time = this.toSeconds(time); + var upperBound = this._search(time); + if (upperBound !== -1) { + this._iterate(function (event) { + if (event.time === time) { + callback(event); + } + }, 0, upperBound); + } + return this; + }; + Tone.Timeline.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._timeline = null; + this._toRemove = null; + }; + return Tone.Timeline; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_TimelineSignal; +Tone_signal_TimelineSignal = function (Tone) { + 'use strict'; + Tone.TimelineSignal = function () { + var options = this.optionsObject(arguments, [ + 'value', + 'units' + ], Tone.Signal.defaults); + Tone.Signal.apply(this, options); + options.param = this._param; + Tone.Param.call(this, options); + this._events = new Tone.Timeline(10); + this._initial = this._fromUnits(this._param.value); + }; + Tone.extend(Tone.TimelineSignal, Tone.Param); + Tone.TimelineSignal.Type = { + Linear: 'linear', + Exponential: 'exponential', + Target: 'target', + Set: 'set' + }; + Object.defineProperty(Tone.TimelineSignal.prototype, 'value', { + get: function () { + return this._toUnits(this._param.value); + }, + set: function (value) { + var convertedVal = this._fromUnits(value); + this._initial = convertedVal; + this._param.value = convertedVal; + } + }); + Tone.TimelineSignal.prototype.setValueAtTime = function (value, startTime) { + value = this._fromUnits(value); + startTime = this.toSeconds(startTime); + this._events.addEvent({ + 'type': Tone.TimelineSignal.Type.Set, + 'value': value, + 'time': startTime + }); + this._param.setValueAtTime(value, startTime); + return this; + }; + Tone.TimelineSignal.prototype.linearRampToValueAtTime = function (value, endTime) { + value = this._fromUnits(value); + endTime = this.toSeconds(endTime); + this._events.addEvent({ + 'type': Tone.TimelineSignal.Type.Linear, + 'value': value, + 'time': endTime + }); + this._param.linearRampToValueAtTime(value, endTime); + return this; + }; + Tone.TimelineSignal.prototype.exponentialRampToValueAtTime = function (value, endTime) { + value = this._fromUnits(value); + value = Math.max(this._minOutput, value); + endTime = this.toSeconds(endTime); + this._events.addEvent({ + 'type': Tone.TimelineSignal.Type.Exponential, + 'value': value, + 'time': endTime + }); + this._param.exponentialRampToValueAtTime(value, endTime); + return this; + }; + Tone.TimelineSignal.prototype.setTargetAtTime = function (value, startTime, timeConstant) { + value = this._fromUnits(value); + value = Math.max(this._minOutput, value); + timeConstant = Math.max(this._minOutput, timeConstant); + startTime = this.toSeconds(startTime); + this._events.addEvent({ + 'type': Tone.TimelineSignal.Type.Target, + 'value': value, + 'time': startTime, + 'constant': timeConstant + }); + this._param.setTargetAtTime(value, startTime, timeConstant); + return this; + }; + Tone.TimelineSignal.prototype.cancelScheduledValues = function (after) { + this._events.cancel(after); + this._param.cancelScheduledValues(this.toSeconds(after)); + return this; + }; + Tone.TimelineSignal.prototype.setRampPoint = function (time) { + time = this.toSeconds(time); + var val = this.getValueAtTime(time); + var after = this._searchAfter(time); + if (after) { + this.cancelScheduledValues(time); + if (after.type === Tone.TimelineSignal.Type.Linear) { + this.linearRampToValueAtTime(val, time); + } else if (after.type === Tone.TimelineSignal.Type.Exponential) { + this.exponentialRampToValueAtTime(val, time); + } + } + this.setValueAtTime(val, time); + return this; + }; + Tone.TimelineSignal.prototype.linearRampToValueBetween = function (value, start, finish) { + this.setRampPoint(start); + this.linearRampToValueAtTime(value, finish); + return this; + }; + Tone.TimelineSignal.prototype.exponentialRampToValueBetween = function (value, start, finish) { + this.setRampPoint(start); + this.exponentialRampToValueAtTime(value, finish); + return this; + }; + Tone.TimelineSignal.prototype._searchBefore = function (time) { + return this._events.getEvent(time); + }; + Tone.TimelineSignal.prototype._searchAfter = function (time) { + return this._events.getEventAfter(time); + }; + Tone.TimelineSignal.prototype.getValueAtTime = function (time) { + var after = this._searchAfter(time); + var before = this._searchBefore(time); + var value = this._initial; + if (before === null) { + value = this._initial; + } else if (before.type === Tone.TimelineSignal.Type.Target) { + var previous = this._events.getEventBefore(before.time); + var previouVal; + if (previous === null) { + previouVal = this._initial; + } else { + previouVal = previous.value; + } + value = this._exponentialApproach(before.time, previouVal, before.value, before.constant, time); + } else if (after === null) { + value = before.value; + } else if (after.type === Tone.TimelineSignal.Type.Linear) { + value = this._linearInterpolate(before.time, before.value, after.time, after.value, time); + } else if (after.type === Tone.TimelineSignal.Type.Exponential) { + value = this._exponentialInterpolate(before.time, before.value, after.time, after.value, time); + } else { + value = before.value; + } + return value; + }; + Tone.TimelineSignal.prototype.connect = Tone.SignalBase.prototype.connect; + Tone.TimelineSignal.prototype._exponentialApproach = function (t0, v0, v1, timeConstant, t) { + return v1 + (v0 - v1) * Math.exp(-(t - t0) / timeConstant); + }; + Tone.TimelineSignal.prototype._linearInterpolate = function (t0, v0, t1, v1, t) { + return v0 + (v1 - v0) * ((t - t0) / (t1 - t0)); + }; + Tone.TimelineSignal.prototype._exponentialInterpolate = function (t0, v0, t1, v1, t) { + v0 = Math.max(this._minOutput, v0); + return v0 * Math.pow(v1 / v0, (t - t0) / (t1 - t0)); + }; + Tone.TimelineSignal.prototype.dispose = function () { + Tone.Signal.prototype.dispose.call(this); + Tone.Param.prototype.dispose.call(this); + this._events.dispose(); + this._events = null; + }; + return Tone.TimelineSignal; +}(Tone_core_Tone, Tone_signal_Signal); +var env; +env = function () { + 'use strict'; + var p5sound = master; + var Add = Tone_signal_Add; + var Mult = Tone_signal_Multiply; + var Scale = Tone_signal_Scale; + var TimelineSignal = Tone_signal_TimelineSignal; + var Tone = Tone_core_Tone; + Tone.setContext(p5sound.audiocontext); + /** + *

Envelopes are pre-defined amplitude distribution over time. + * Typically, envelopes are used to control the output volume + * of an object, a series of fades referred to as Attack, Decay, + * Sustain and Release ( + * ADSR + * ). Envelopes can also control other Web Audio Parameters—for example, a p5.Env can + * control an Oscillator's frequency like this: osc.freq(env).

+ *

Use setRange to change the attack/release level. + * Use setADSR to change attackTime, decayTime, sustainPercent and releaseTime.

+ *

Use the play method to play the entire envelope, + * the ramp method for a pingable trigger, + * or triggerAttack/ + * triggerRelease to trigger noteOn/noteOff.

+ * + * @class p5.Env + * @constructor + * @example + *
+ * var attackLevel = 1.0; + * var releaseLevel = 0; + * + * var attackTime = 0.001 + * var decayTime = 0.2; + * var susPercent = 0.2; + * var releaseTime = 0.5; + * + * var env, triOsc; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * env = new p5.Env(); + * env.setADSR(attackTime, decayTime, susPercent, releaseTime); + * env.setRange(attackLevel, releaseLevel); + * + * triOsc = new p5.Oscillator('triangle'); + * triOsc.amp(env); + * triOsc.start(); + * triOsc.freq(220); + * + * cnv.mousePressed(playEnv); + * } + * + * function playEnv(){ + * env.play(); + * } + *
+ */ + p5.Env = function (t1, l1, t2, l2, t3, l3) { + var now = p5sound.audiocontext.currentTime; + /** + * Time until envelope reaches attackLevel + * @property attackTime + */ + this.aTime = t1 || 0.1; + /** + * Level once attack is complete. + * @property attackLevel + */ + this.aLevel = l1 || 1; + /** + * Time until envelope reaches decayLevel. + * @property decayTime + */ + this.dTime = t2 || 0.5; + /** + * Level after decay. The envelope will sustain here until it is released. + * @property decayLevel + */ + this.dLevel = l2 || 0; + /** + * Duration of the release portion of the envelope. + * @property releaseTime + */ + this.rTime = t3 || 0; + /** + * Level at the end of the release. + * @property releaseLevel + */ + this.rLevel = l3 || 0; + this._rampHighPercentage = 0.98; + this._rampLowPercentage = 0.02; + this.output = p5sound.audiocontext.createGain(); + this.control = new TimelineSignal(); + this._init(); + // this makes sure the envelope starts at zero + this.control.connect(this.output); + // connect to the output + this.connection = null; + // store connection + //array of math operation signal chaining + this.mathOps = [this.control]; + //whether envelope should be linear or exponential curve + this.isExponential = false; + // oscillator or buffer source to clear on env complete + // to save resources if/when it is retriggered + this.sourceToClear = null; + // set to true if attack is set, then false on release + this.wasTriggered = false; + // add to the soundArray so we can dispose of the env later + p5sound.soundArray.push(this); + }; + // this init function just smooths the starting value to zero and gives a start point for the timeline + // - it was necessary to remove glitches at the beginning. + p5.Env.prototype._init = function () { + var now = p5sound.audiocontext.currentTime; + var t = now; + this.control.setTargetAtTime(0.00001, t, 0.001); + //also, compute the correct time constants + this._setRampAD(this.aTime, this.dTime); + }; + /** + * Reset the envelope with a series of time/value pairs. + * + * @method set + * @param {Number} attackTime Time (in seconds) before level + * reaches attackLevel + * @param {Number} attackLevel Typically an amplitude between + * 0.0 and 1.0 + * @param {Number} decayTime Time + * @param {Number} decayLevel Amplitude (In a standard ADSR envelope, + * decayLevel = sustainLevel) + * @param {Number} releaseTime Release Time (in seconds) + * @param {Number} releaseLevel Amplitude + * @example + *
+ * var t1 = 0.1; // attack time in seconds + * var l1 = 0.7; // attack level 0.0 to 1.0 + * var t2 = 0.3; // decay time in seconds + * var l2 = 0.1; // decay level 0.0 to 1.0 + * var t3 = 0.2; // sustain time in seconds + * var l3 = dL; // sustain level 0.0 to 1.0 + * // release level defaults to zero + * + * var env; + * var triOsc; + * + * function setup() { + * background(0); + * noStroke(); + * fill(255); + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * env = new p5.Env(t1, l1, t2, l2, t3, l3); + * triOsc = new p5.Oscillator('triangle'); + * triOsc.amp(env); // give the env control of the triOsc's amp + * triOsc.start(); + * } + * + * // mouseClick triggers envelope if over canvas + * function mouseClicked() { + * // is mouse over canvas? + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * env.play(triOsc); + * } + * } + *
+ * + */ + p5.Env.prototype.set = function (t1, l1, t2, l2, t3, l3) { + this.aTime = t1; + this.aLevel = l1; + this.dTime = t2 || 0; + this.dLevel = l2 || 0; + this.rTime = t3 || 0; + this.rLevel = l3 || 0; + // set time constants for ramp + this._setRampAD(t1, t2); + }; + /** + * Set values like a traditional + * + * ADSR envelope + * . + * + * @method setADSR + * @param {Number} attackTime Time (in seconds before envelope + * reaches Attack Level + * @param {Number} [decayTime] Time (in seconds) before envelope + * reaches Decay/Sustain Level + * @param {Number} [susRatio] Ratio between attackLevel and releaseLevel, on a scale from 0 to 1, + * where 1.0 = attackLevel, 0.0 = releaseLevel. + * The susRatio determines the decayLevel and the level at which the + * sustain portion of the envelope will sustain. + * For example, if attackLevel is 0.4, releaseLevel is 0, + * and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is + * increased to 1.0 (using setRange), + * then decayLevel would increase proportionally, to become 0.5. + * @param {Number} [releaseTime] Time in seconds from now (defaults to 0) + * @example + *
+ * var attackLevel = 1.0; + * var releaseLevel = 0; + * + * var attackTime = 0.001 + * var decayTime = 0.2; + * var susPercent = 0.2; + * var releaseTime = 0.5; + * + * var env, triOsc; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * env = new p5.Env(); + * env.setADSR(attackTime, decayTime, susPercent, releaseTime); + * env.setRange(attackLevel, releaseLevel); + * + * triOsc = new p5.Oscillator('triangle'); + * triOsc.amp(env); + * triOsc.start(); + * triOsc.freq(220); + * + * cnv.mousePressed(playEnv); + * } + * + * function playEnv(){ + * env.play(); + * } + *
+ */ + p5.Env.prototype.setADSR = function (aTime, dTime, sPercent, rTime) { + this.aTime = aTime; + this.dTime = dTime || 0; + // lerp + this.sPercent = sPercent || 0; + this.dLevel = typeof sPercent !== 'undefined' ? sPercent * (this.aLevel - this.rLevel) + this.rLevel : 0; + this.rTime = rTime || 0; + // also set time constants for ramp + this._setRampAD(aTime, dTime); + }; + /** + * Set max (attackLevel) and min (releaseLevel) of envelope. + * + * @method setRange + * @param {Number} aLevel attack level (defaults to 1) + * @param {Number} rLevel release level (defaults to 0) + * @example + *
+ * var attackLevel = 1.0; + * var releaseLevel = 0; + * + * var attackTime = 0.001 + * var decayTime = 0.2; + * var susPercent = 0.2; + * var releaseTime = 0.5; + * + * var env, triOsc; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * env = new p5.Env(); + * env.setADSR(attackTime, decayTime, susPercent, releaseTime); + * env.setRange(attackLevel, releaseLevel); + * + * triOsc = new p5.Oscillator('triangle'); + * triOsc.amp(env); + * triOsc.start(); + * triOsc.freq(220); + * + * cnv.mousePressed(playEnv); + * } + * + * function playEnv(){ + * env.play(); + * } + *
+ */ + p5.Env.prototype.setRange = function (aLevel, rLevel) { + this.aLevel = aLevel || 1; + this.rLevel = rLevel || 0; + }; + // private (undocumented) method called when ADSR is set to set time constants for ramp + // + // Set the + // time constants for simple exponential ramps. + // The larger the time constant value, the slower the + // transition will be. + // + // method _setRampAD + // param {Number} attackTimeConstant attack time constant + // param {Number} decayTimeConstant decay time constant + // + p5.Env.prototype._setRampAD = function (t1, t2) { + this._rampAttackTime = this.checkExpInput(t1); + this._rampDecayTime = this.checkExpInput(t2); + var TCDenominator = 1; + /// Aatish Bhatia's calculation for time constant for rise(to adjust 1/1-e calculation to any percentage) + TCDenominator = Math.log(1 / this.checkExpInput(1 - this._rampHighPercentage)); + this._rampAttackTC = t1 / this.checkExpInput(TCDenominator); + TCDenominator = Math.log(1 / this._rampLowPercentage); + this._rampDecayTC = t2 / this.checkExpInput(TCDenominator); + }; + // private method + p5.Env.prototype.setRampPercentages = function (p1, p2) { + //set the percentages that the simple exponential ramps go to + this._rampHighPercentage = this.checkExpInput(p1); + this._rampLowPercentage = this.checkExpInput(p2); + var TCDenominator = 1; + //now re-compute the time constants based on those percentages + /// Aatish Bhatia's calculation for time constant for rise(to adjust 1/1-e calculation to any percentage) + TCDenominator = Math.log(1 / this.checkExpInput(1 - this._rampHighPercentage)); + this._rampAttackTC = this._rampAttackTime / this.checkExpInput(TCDenominator); + TCDenominator = Math.log(1 / this._rampLowPercentage); + this._rampDecayTC = this._rampDecayTime / this.checkExpInput(TCDenominator); + }; + /** + * Assign a parameter to be controlled by this envelope. + * If a p5.Sound object is given, then the p5.Env will control its + * output gain. If multiple inputs are provided, the env will + * control all of them. + * + * @method setInput + * @param {Object} unit A p5.sound object or + * Web Audio Param. + */ + p5.Env.prototype.setInput = function (unit) { + for (var i = 0; i < arguments.length; i++) { + this.connect(arguments[i]); + } + }; + /** + * Set whether the envelope ramp is linear (default) or exponential. + * Exponential ramps can be useful because we perceive amplitude + * and frequency logarithmically. + * + * @method setExp + * @param {Boolean} isExp true is exponential, false is linear + */ + p5.Env.prototype.setExp = function (isExp) { + this.isExponential = isExp; + }; + //helper method to protect against zero values being sent to exponential functions + p5.Env.prototype.checkExpInput = function (value) { + if (value <= 0) { + value = 1e-8; + } + return value; + }; + /** + * Play tells the envelope to start acting on a given input. + * If the input is a p5.sound object (i.e. AudioIn, Oscillator, + * SoundFile), then Env will control its output volume. + * Envelopes can also be used to control any + * Web Audio Audio Param. + * + * @method play + * @param {Object} unit A p5.sound object or + * Web Audio Param. + * @param {Number} [startTime] time from now (in seconds) at which to play + * @param {Number} [sustainTime] time to sustain before releasing the envelope + * @example + *
+ * var attackLevel = 1.0; + * var releaseLevel = 0; + * + * var attackTime = 0.001 + * var decayTime = 0.2; + * var susPercent = 0.2; + * var releaseTime = 0.5; + * + * var env, triOsc; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * env = new p5.Env(); + * env.setADSR(attackTime, decayTime, susPercent, releaseTime); + * env.setRange(attackLevel, releaseLevel); + * + * triOsc = new p5.Oscillator('triangle'); + * triOsc.amp(env); + * triOsc.start(); + * triOsc.freq(220); + * + * cnv.mousePressed(playEnv); + * } + * + * function playEnv(){ + * // trigger env on triOsc, 0 seconds from now + * // After decay, sustain for 0.2 seconds before release + * env.play(triOsc, 0, 0.2); + * } + *
+ */ + p5.Env.prototype.play = function (unit, secondsFromNow, susTime) { + var now = p5sound.audiocontext.currentTime; + var tFromNow = secondsFromNow || 0; + var susTime = susTime || 0; + if (unit) { + if (this.connection !== unit) { + this.connect(unit); + } + } + this.triggerAttack(unit, tFromNow); + this.triggerRelease(unit, tFromNow + this.aTime + this.dTime + susTime); + }; + /** + * Trigger the Attack, and Decay portion of the Envelope. + * Similar to holding down a key on a piano, but it will + * hold the sustain level until you let go. Input can be + * any p5.sound object, or a + * Web Audio Param. + * + * @method triggerAttack + * @param {Object} unit p5.sound Object or Web Audio Param + * @param {Number} secondsFromNow time from now (in seconds) + * @example + *
+ * + * var attackLevel = 1.0; + * var releaseLevel = 0; + * + * var attackTime = 0.001 + * var decayTime = 0.3; + * var susPercent = 0.4; + * var releaseTime = 0.5; + * + * var env, triOsc; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * background(200); + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * env = new p5.Env(); + * env.setADSR(attackTime, decayTime, susPercent, releaseTime); + * env.setRange(attackLevel, releaseLevel); + * + * triOsc = new p5.Oscillator('triangle'); + * triOsc.amp(env); + * triOsc.start(); + * triOsc.freq(220); + * + * cnv.mousePressed(envAttack); + * } + * + * function envAttack(){ + * console.log('trigger attack'); + * env.triggerAttack(); + * + * background(0,255,0); + * text('attack!', width/2, height/2); + * } + * + * function mouseReleased() { + * env.triggerRelease(); + * + * background(200); + * text('click to play', width/2, height/2); + * } + *
+ */ + p5.Env.prototype.triggerAttack = function (unit, secondsFromNow) { + var now = p5sound.audiocontext.currentTime; + var tFromNow = secondsFromNow || 0; + var t = now + tFromNow; + this.lastAttack = t; + this.wasTriggered = true; + if (unit) { + if (this.connection !== unit) { + this.connect(unit); + } + } + // get and set value (with linear ramp) to anchor automation + var valToSet = this.control.getValueAtTime(t); + this.control.cancelScheduledValues(t); + // not sure if this is necessary + if (this.isExponential == true) { + this.control.exponentialRampToValueAtTime(this.checkExpInput(valToSet), t); + } else { + this.control.linearRampToValueAtTime(valToSet, t); + } + // after each ramp completes, cancel scheduled values + // (so they can be overridden in case env has been re-triggered) + // then, set current value (with linearRamp to avoid click) + // then, schedule the next automation... + // attack + t += this.aTime; + if (this.isExponential == true) { + this.control.exponentialRampToValueAtTime(this.checkExpInput(this.aLevel), t); + valToSet = this.checkExpInput(this.control.getValueAtTime(t)); + this.control.cancelScheduledValues(t); + this.control.exponentialRampToValueAtTime(valToSet, t); + } else { + this.control.linearRampToValueAtTime(this.aLevel, t); + valToSet = this.control.getValueAtTime(t); + this.control.cancelScheduledValues(t); + this.control.linearRampToValueAtTime(valToSet, t); + } + // decay to decay level (if using ADSR, then decay level == sustain level) + t += this.dTime; + if (this.isExponential == true) { + this.control.exponentialRampToValueAtTime(this.checkExpInput(this.dLevel), t); + valToSet = this.checkExpInput(this.control.getValueAtTime(t)); + this.control.cancelScheduledValues(t); + this.control.exponentialRampToValueAtTime(valToSet, t); + } else { + this.control.linearRampToValueAtTime(this.dLevel, t); + valToSet = this.control.getValueAtTime(t); + this.control.cancelScheduledValues(t); + this.control.linearRampToValueAtTime(valToSet, t); + } + }; + /** + * Trigger the Release of the Envelope. This is similar to releasing + * the key on a piano and letting the sound fade according to the + * release level and release time. + * + * @method triggerRelease + * @param {Object} unit p5.sound Object or Web Audio Param + * @param {Number} secondsFromNow time to trigger the release + * @example + *
+ * + * var attackLevel = 1.0; + * var releaseLevel = 0; + * + * var attackTime = 0.001 + * var decayTime = 0.3; + * var susPercent = 0.4; + * var releaseTime = 0.5; + * + * var env, triOsc; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * background(200); + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * env = new p5.Env(); + * env.setADSR(attackTime, decayTime, susPercent, releaseTime); + * env.setRange(attackLevel, releaseLevel); + * + * triOsc = new p5.Oscillator('triangle'); + * triOsc.amp(env); + * triOsc.start(); + * triOsc.freq(220); + * + * cnv.mousePressed(envAttack); + * } + * + * function envAttack(){ + * console.log('trigger attack'); + * env.triggerAttack(); + * + * background(0,255,0); + * text('attack!', width/2, height/2); + * } + * + * function mouseReleased() { + * env.triggerRelease(); + * + * background(200); + * text('click to play', width/2, height/2); + * } + *
+ */ + p5.Env.prototype.triggerRelease = function (unit, secondsFromNow) { + // only trigger a release if an attack was triggered + if (!this.wasTriggered) { + // this currently causes a bit of trouble: + // if a later release has been scheduled (via the play function) + // a new earlier release won't interrupt it, because + // this.wasTriggered has already been set to false. + // If we want new earlier releases to override, then we need to + // keep track of the last release time, and if the new release time is + // earlier, then use it. + return; + } + var now = p5sound.audiocontext.currentTime; + var tFromNow = secondsFromNow || 0; + var t = now + tFromNow; + if (unit) { + if (this.connection !== unit) { + this.connect(unit); + } + } + // get and set value (with linear or exponential ramp) to anchor automation + var valToSet = this.control.getValueAtTime(t); + this.control.cancelScheduledValues(t); + // not sure if this is necessary + if (this.isExponential == true) { + this.control.exponentialRampToValueAtTime(this.checkExpInput(valToSet), t); + } else { + this.control.linearRampToValueAtTime(valToSet, t); + } + // release + t += this.rTime; + if (this.isExponential == true) { + this.control.exponentialRampToValueAtTime(this.checkExpInput(this.rLevel), t); + valToSet = this.checkExpInput(this.control.getValueAtTime(t)); + this.control.cancelScheduledValues(t); + this.control.exponentialRampToValueAtTime(valToSet, t); + } else { + this.control.linearRampToValueAtTime(this.rLevel, t); + valToSet = this.control.getValueAtTime(t); + this.control.cancelScheduledValues(t); + this.control.linearRampToValueAtTime(valToSet, t); + } + this.wasTriggered = false; + }; + /** + * Exponentially ramp to a value using the first two + * values from setADSR(attackTime, decayTime) + * as + * time constants for simple exponential ramps. + * If the value is higher than current value, it uses attackTime, + * while a decrease uses decayTime. + * + * @method ramp + * @param {Object} unit p5.sound Object or Web Audio Param + * @param {Number} secondsFromNow When to trigger the ramp + * @param {Number} v Target value + * @param {Number} [v2] Second target value (optional) + * @example + *
+ * var env, osc, amp, cnv; + * + * var attackTime = 0.001; + * var decayTime = 0.2; + * var attackLevel = 1; + * var decayLevel = 0; + * + * function setup() { + * cnv = createCanvas(100, 100); + * fill(0,255,0); + * noStroke(); + * + * env = new p5.Env(); + * env.setADSR(attackTime, decayTime); + * + * osc = new p5.Oscillator(); + * osc.amp(env); + * osc.start(); + * + * amp = new p5.Amplitude(); + * + * cnv.mousePressed(triggerRamp); + * } + * + * function triggerRamp() { + * env.ramp(osc, 0, attackLevel, decayLevel); + * } + * + * function draw() { + * background(20,20,20); + * text('click me', 10, 20); + * var h = map(amp.getLevel(), 0, 0.4, 0, height);; + * + * rect(0, height, width, -h); + * } + *
+ */ + p5.Env.prototype.ramp = function (unit, secondsFromNow, v1, v2) { + var now = p5sound.audiocontext.currentTime; + var tFromNow = secondsFromNow || 0; + var t = now + tFromNow; + var destination1 = this.checkExpInput(v1); + var destination2 = typeof v2 !== 'undefined' ? this.checkExpInput(v2) : undefined; + // connect env to unit if not already connected + if (unit) { + if (this.connection !== unit) { + this.connect(unit); + } + } + //get current value + var currentVal = this.checkExpInput(this.control.getValueAtTime(t)); + this.control.cancelScheduledValues(t); + //if it's going up + if (destination1 > currentVal) { + this.control.setTargetAtTime(destination1, t, this._rampAttackTC); + t += this._rampAttackTime; + } else if (destination1 < currentVal) { + this.control.setTargetAtTime(destination1, t, this._rampDecayTC); + t += this._rampDecayTime; + } + // Now the second part of envelope begins + if (destination2 === undefined) + return; + //if it's going up + if (destination2 > destination1) { + this.control.setTargetAtTime(destination2, t, this._rampAttackTC); + } else if (destination2 < destination1) { + this.control.setTargetAtTime(destination2, t, this._rampDecayTC); + } + }; + p5.Env.prototype.connect = function (unit) { + this.connection = unit; + // assume we're talking about output gain + // unless given a different audio param + if (unit instanceof p5.Oscillator || unit instanceof p5.SoundFile || unit instanceof p5.AudioIn || unit instanceof p5.Reverb || unit instanceof p5.Noise || unit instanceof p5.Filter || unit instanceof p5.Delay) { + unit = unit.output.gain; + } + if (unit instanceof AudioParam) { + //set the initial value + unit.setValueAtTime(0, p5sound.audiocontext.currentTime); + } + if (unit instanceof p5.Signal) { + unit.setValue(0); + } + this.output.connect(unit); + }; + p5.Env.prototype.disconnect = function (unit) { + this.output.disconnect(); + }; + // Signal Math + /** + * Add a value to the p5.Oscillator's output amplitude, + * and return the oscillator. Calling this method + * again will override the initial add() with new values. + * + * @method add + * @param {Number} number Constant number to add + * @return {p5.Env} Envelope Returns this envelope + * with scaled output + */ + p5.Env.prototype.add = function (num) { + var add = new Add(num); + var thisChain = this.mathOps.length; + var nextChain = this.output; + return p5.prototype._mathChain(this, add, thisChain, nextChain, Add); + }; + /** + * Multiply the p5.Env's output amplitude + * by a fixed value. Calling this method + * again will override the initial mult() with new values. + * + * @method mult + * @param {Number} number Constant number to multiply + * @return {p5.Env} Envelope Returns this envelope + * with scaled output + */ + p5.Env.prototype.mult = function (num) { + var mult = new Mult(num); + var thisChain = this.mathOps.length; + var nextChain = this.output; + return p5.prototype._mathChain(this, mult, thisChain, nextChain, Mult); + }; + /** + * Scale this envelope's amplitude values to a given + * range, and return the envelope. Calling this method + * again will override the initial scale() with new values. + * + * @method scale + * @param {Number} inMin input range minumum + * @param {Number} inMax input range maximum + * @param {Number} outMin input range minumum + * @param {Number} outMax input range maximum + * @return {p5.Env} Envelope Returns this envelope + * with scaled output + */ + p5.Env.prototype.scale = function (inMin, inMax, outMin, outMax) { + var scale = new Scale(inMin, inMax, outMin, outMax); + var thisChain = this.mathOps.length; + var nextChain = this.output; + return p5.prototype._mathChain(this, scale, thisChain, nextChain, Scale); + }; + // get rid of the oscillator + p5.Env.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + var now = p5sound.audiocontext.currentTime; + this.disconnect(); + try { + this.control.dispose(); + this.control = null; + } catch (e) { + } + for (var i = 1; i < this.mathOps.length; i++) { + mathOps[i].dispose(); + } + }; +}(master, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale, Tone_signal_TimelineSignal, Tone_core_Tone); +var pulse; +pulse = function () { + 'use strict'; + var p5sound = master; + /** + * Creates a Pulse object, an oscillator that implements + * Pulse Width Modulation. + * The pulse is created with two oscillators. + * Accepts a parameter for frequency, and to set the + * width between the pulses. See + * p5.Oscillator for a full list of methods. + * + * @class p5.Pulse + * @constructor + * @param {Number} [freq] Frequency in oscillations per second (Hz) + * @param {Number} [w] Width between the pulses (0 to 1.0, + * defaults to 0) + * @example + *
+ * var pulse; + * function setup() { + * background(0); + * + * // Create and start the pulse wave oscillator + * pulse = new p5.Pulse(); + * pulse.amp(0.5); + * pulse.freq(220); + * pulse.start(); + * } + * + * function draw() { + * var w = map(mouseX, 0, width, 0, 1); + * w = constrain(w, 0, 1); + * pulse.width(w) + * } + *
+ */ + p5.Pulse = function (freq, w) { + p5.Oscillator.call(this, freq, 'sawtooth'); + // width of PWM, should be betw 0 to 1.0 + this.w = w || 0; + // create a second oscillator with inverse frequency + this.osc2 = new p5.SawOsc(freq); + // create a delay node + this.dNode = p5sound.audiocontext.createDelay(); + // dc offset + this.dcOffset = createDCOffset(); + this.dcGain = p5sound.audiocontext.createGain(); + this.dcOffset.connect(this.dcGain); + this.dcGain.connect(this.output); + // set delay time based on PWM width + this.f = freq || 440; + var mW = this.w / this.oscillator.frequency.value; + this.dNode.delayTime.value = mW; + this.dcGain.gain.value = 1.7 * (0.5 - this.w); + // disconnect osc2 and connect it to delay, which is connected to output + this.osc2.disconnect(); + this.osc2.panner.disconnect(); + this.osc2.amp(-1); + // inverted amplitude + this.osc2.output.connect(this.dNode); + this.dNode.connect(this.output); + this.output.gain.value = 1; + this.output.connect(this.panner); + }; + p5.Pulse.prototype = Object.create(p5.Oscillator.prototype); + /** + * Set the width of a Pulse object (an oscillator that implements + * Pulse Width Modulation). + * + * @method width + * @param {Number} [width] Width between the pulses (0 to 1.0, + * defaults to 0) + */ + p5.Pulse.prototype.width = function (w) { + if (typeof w === 'number') { + if (w <= 1 && w >= 0) { + this.w = w; + // set delay time based on PWM width + // var mW = map(this.w, 0, 1.0, 0, 1/this.f); + var mW = this.w / this.oscillator.frequency.value; + this.dNode.delayTime.value = mW; + } + this.dcGain.gain.value = 1.7 * (0.5 - this.w); + } else { + w.connect(this.dNode.delayTime); + var sig = new p5.SignalAdd(-0.5); + sig.setInput(w); + sig = sig.mult(-1); + sig = sig.mult(1.7); + sig.connect(this.dcGain.gain); + } + }; + p5.Pulse.prototype.start = function (f, time) { + var now = p5sound.audiocontext.currentTime; + var t = time || 0; + if (!this.started) { + var freq = f || this.f; + var type = this.oscillator.type; + this.oscillator = p5sound.audiocontext.createOscillator(); + this.oscillator.frequency.setValueAtTime(freq, now); + this.oscillator.type = type; + this.oscillator.connect(this.output); + this.oscillator.start(t + now); + // set up osc2 + this.osc2.oscillator = p5sound.audiocontext.createOscillator(); + this.osc2.oscillator.frequency.setValueAtTime(freq, t + now); + this.osc2.oscillator.type = type; + this.osc2.oscillator.connect(this.osc2.output); + this.osc2.start(t + now); + this.freqNode = [ + this.oscillator.frequency, + this.osc2.oscillator.frequency + ]; + // start dcOffset, too + this.dcOffset = createDCOffset(); + this.dcOffset.connect(this.dcGain); + this.dcOffset.start(t + now); + // if LFO connections depend on these oscillators + if (this.mods !== undefined && this.mods.frequency !== undefined) { + this.mods.frequency.connect(this.freqNode[0]); + this.mods.frequency.connect(this.freqNode[1]); + } + this.started = true; + this.osc2.started = true; + } + }; + p5.Pulse.prototype.stop = function (time) { + if (this.started) { + var t = time || 0; + var now = p5sound.audiocontext.currentTime; + this.oscillator.stop(t + now); + this.osc2.oscillator.stop(t + now); + this.dcOffset.stop(t + now); + this.started = false; + this.osc2.started = false; + } + }; + p5.Pulse.prototype.freq = function (val, rampTime, tFromNow) { + if (typeof val === 'number') { + this.f = val; + var now = p5sound.audiocontext.currentTime; + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var currentFreq = this.oscillator.frequency.value; + this.oscillator.frequency.cancelScheduledValues(now); + this.oscillator.frequency.setValueAtTime(currentFreq, now + tFromNow); + this.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now); + this.osc2.oscillator.frequency.cancelScheduledValues(now); + this.osc2.oscillator.frequency.setValueAtTime(currentFreq, now + tFromNow); + this.osc2.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now); + if (this.freqMod) { + this.freqMod.output.disconnect(); + this.freqMod = null; + } + } else if (val.output) { + val.output.disconnect(); + val.output.connect(this.oscillator.frequency); + val.output.connect(this.osc2.oscillator.frequency); + this.freqMod = val; + } + }; + // inspiration: http://webaudiodemos.appspot.com/oscilloscope/ + function createDCOffset() { + var ac = p5sound.audiocontext; + var buffer = ac.createBuffer(1, 2048, ac.sampleRate); + var data = buffer.getChannelData(0); + for (var i = 0; i < 2048; i++) + data[i] = 1; + var bufferSource = ac.createBufferSource(); + bufferSource.buffer = buffer; + bufferSource.loop = true; + return bufferSource; + } +}(master, oscillator); +var noise; +noise = function () { + 'use strict'; + var p5sound = master; + /** + * Noise is a type of oscillator that generates a buffer with random values. + * + * @class p5.Noise + * @constructor + * @param {String} type Type of noise can be 'white' (default), + * 'brown' or 'pink'. + * @return {Object} Noise Object + */ + p5.Noise = function (type) { + var assignType; + p5.Oscillator.call(this); + delete this.f; + delete this.freq; + delete this.oscillator; + if (type === 'brown') { + assignType = _brownNoise; + } else if (type === 'pink') { + assignType = _pinkNoise; + } else { + assignType = _whiteNoise; + } + this.buffer = assignType; + }; + p5.Noise.prototype = Object.create(p5.Oscillator.prototype); + // generate noise buffers + var _whiteNoise = function () { + var bufferSize = 2 * p5sound.audiocontext.sampleRate; + var whiteBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate); + var noiseData = whiteBuffer.getChannelData(0); + for (var i = 0; i < bufferSize; i++) { + noiseData[i] = Math.random() * 2 - 1; + } + whiteBuffer.type = 'white'; + return whiteBuffer; + }(); + var _pinkNoise = function () { + var bufferSize = 2 * p5sound.audiocontext.sampleRate; + var pinkBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate); + var noiseData = pinkBuffer.getChannelData(0); + var b0, b1, b2, b3, b4, b5, b6; + b0 = b1 = b2 = b3 = b4 = b5 = b6 = 0; + for (var i = 0; i < bufferSize; i++) { + var white = Math.random() * 2 - 1; + b0 = 0.99886 * b0 + white * 0.0555179; + b1 = 0.99332 * b1 + white * 0.0750759; + b2 = 0.969 * b2 + white * 0.153852; + b3 = 0.8665 * b3 + white * 0.3104856; + b4 = 0.55 * b4 + white * 0.5329522; + b5 = -0.7616 * b5 - white * 0.016898; + noiseData[i] = b0 + b1 + b2 + b3 + b4 + b5 + b6 + white * 0.5362; + noiseData[i] *= 0.11; + // (roughly) compensate for gain + b6 = white * 0.115926; + } + pinkBuffer.type = 'pink'; + return pinkBuffer; + }(); + var _brownNoise = function () { + var bufferSize = 2 * p5sound.audiocontext.sampleRate; + var brownBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate); + var noiseData = brownBuffer.getChannelData(0); + var lastOut = 0; + for (var i = 0; i < bufferSize; i++) { + var white = Math.random() * 2 - 1; + noiseData[i] = (lastOut + 0.02 * white) / 1.02; + lastOut = noiseData[i]; + noiseData[i] *= 3.5; + } + brownBuffer.type = 'brown'; + return brownBuffer; + }(); + /** + * Set type of noise to 'white', 'pink' or 'brown'. + * White is the default. + * + * @method setType + * @param {String} [type] 'white', 'pink' or 'brown' + */ + p5.Noise.prototype.setType = function (type) { + switch (type) { + case 'white': + this.buffer = _whiteNoise; + break; + case 'pink': + this.buffer = _pinkNoise; + break; + case 'brown': + this.buffer = _brownNoise; + break; + default: + this.buffer = _whiteNoise; + } + if (this.started) { + var now = p5sound.audiocontext.currentTime; + this.stop(now); + this.start(now + 0.01); + } + }; + p5.Noise.prototype.getType = function () { + return this.buffer.type; + }; + /** + * Start the noise + * + * @method start + */ + p5.Noise.prototype.start = function () { + if (this.started) { + this.stop(); + } + this.noise = p5sound.audiocontext.createBufferSource(); + this.noise.buffer = this.buffer; + this.noise.loop = true; + this.noise.connect(this.output); + var now = p5sound.audiocontext.currentTime; + this.noise.start(now); + this.started = true; + }; + /** + * Stop the noise. + * + * @method stop + */ + p5.Noise.prototype.stop = function () { + var now = p5sound.audiocontext.currentTime; + if (this.noise) { + this.noise.stop(now); + this.started = false; + } + }; + /** + * Pan the noise. + * + * @method pan + * @param {Number} panning Number between -1 (left) + * and 1 (right) + * @param {Number} timeFromNow schedule this event to happen + * seconds from now + */ + /** + * Set the amplitude of the noise between 0 and 1.0. Or, + * modulate amplitude with an audio signal such as an oscillator. + * + * @param {Number|Object} volume amplitude between 0 and 1.0 + * or modulating signal/oscillator + * @param {Number} [rampTime] create a fade that lasts rampTime + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + */ + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Noise.prototype.dispose = function () { + var now = p5sound.audiocontext.currentTime; + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + if (this.noise) { + this.noise.disconnect(); + this.stop(now); + } + if (this.output) { + this.output.disconnect(); + } + if (this.panner) { + this.panner.disconnect(); + } + this.output = null; + this.panner = null; + this.buffer = null; + this.noise = null; + }; +}(master); +var audioin; +audioin = function () { + 'use strict'; + var p5sound = master; + var CustomError = errorHandler; + /** + *

Get audio from an input, i.e. your computer's microphone.

+ * + *

Turn the mic on/off with the start() and stop() methods. When the mic + * is on, its volume can be measured with getLevel or by connecting an + * FFT object.

+ * + *

If you want to hear the AudioIn, use the .connect() method. + * AudioIn does not connect to p5.sound output by default to prevent + * feedback.

+ * + *

Note: This uses the getUserMedia/ + * Stream API, which is not supported by certain browsers. Access in Chrome browser + * is limited to localhost and https, but access over http may be limited.

+ * + * @class p5.AudioIn + * @constructor + * @param {Function} [errorCallback] A function to call if there is an error + * accessing the AudioIn. For example, + * Safari and iOS devices do not + * currently allow microphone access. + * @return {Object} AudioIn + * @example + *
+ * var mic; + * function setup(){ + * mic = new p5.AudioIn() + * mic.start(); + * } + * function draw(){ + * background(0); + * micLevel = mic.getLevel(); + * ellipse(width/2, constrain(height-micLevel*height*5, 0, height), 10, 10); + * } + *
+ */ + p5.AudioIn = function (errorCallback) { + // set up audio input + this.input = p5sound.audiocontext.createGain(); + this.output = p5sound.audiocontext.createGain(); + this.stream = null; + this.mediaStream = null; + this.currentSource = 0; + /** + * Client must allow browser to access their microphone / audioin source. + * Default: false. Will become true when the client enables acces. + * + * @property {Boolean} enabled + */ + this.enabled = false; + // create an amplitude, connect to it by default but not to master out + this.amplitude = new p5.Amplitude(); + this.output.connect(this.amplitude.input); + // Some browsers let developer determine their input sources + if (typeof window.MediaStreamTrack === 'undefined') { + if (errorCallback) { + errorCallback(); + } else { + window.alert('This browser does not support AudioIn'); + } + } else if (typeof window.MediaDevices.enumerateDevices === 'function') { + // Chrome supports getSources to list inputs. Dev picks default + window.MediaDevices.enumerateDevices(this._gotSources); + } else { + } + // add to soundArray so we can dispose on close + p5sound.soundArray.push(this); + }; + /** + * Start processing audio input. This enables the use of other + * AudioIn methods like getLevel(). Note that by default, AudioIn + * is not connected to p5.sound's output. So you won't hear + * anything unless you use the connect() method.
+ * + * Certain browsers limit access to the user's microphone. For example, + * Chrome only allows access from localhost and over https. For this reason, + * you may want to include an errorCallback—a function that is called in case + * the browser won't provide mic access. + * + * @method start + * @param {Function} successCallback Name of a function to call on + * success. + * @param {Function} errorCallback Name of a function to call if + * there was an error. For example, + * some browsers do not support + * getUserMedia. + */ + p5.AudioIn.prototype.start = function (successCallback, errorCallback) { + var self = this; + // if stream was already started... + // if _gotSources() i.e. developers determine which source to use + if (p5sound.inputSources[self.currentSource]) { + // set the audio source + var audioSource = p5sound.inputSources[self.currentSource].id; + var constraints = { audio: { optional: [{ sourceId: audioSource }] } }; + window.navigator.getUserMedia(constraints, this._onStream = function (stream) { + self.stream = stream; + self.enabled = true; + // Wrap a MediaStreamSourceNode around the live input + self.mediaStream = p5sound.audiocontext.createMediaStreamSource(stream); + self.mediaStream.connect(self.output); + if (successCallback) + successCallback(); + // only send to the Amplitude reader, so we can see it but not hear it. + self.amplitude.setInput(self.output); + }, this._onStreamError = function (e) { + if (errorCallback) + errorCallback(e); + else + console.error(e); + }); + } else { + // if Firefox where users select their source via browser + // if (typeof MediaStreamTrack.getSources === 'undefined') { + // Only get the audio stream. + window.navigator.getUserMedia({ 'audio': true }, this._onStream = function (stream) { + self.stream = stream; + self.enabled = true; + // Wrap a MediaStreamSourceNode around the live input + self.mediaStream = p5sound.audiocontext.createMediaStreamSource(stream); + self.mediaStream.connect(self.output); + // only send to the Amplitude reader, so we can see it but not hear it. + self.amplitude.setInput(self.output); + if (successCallback) + successCallback(); + }, this._onStreamError = function (e) { + if (errorCallback) + errorCallback(e); + else + console.error(e); + }); + } + }; + /** + * Turn the AudioIn off. If the AudioIn is stopped, it cannot getLevel(). + * If re-starting, the user may be prompted for permission access. + * + * @method stop + */ + p5.AudioIn.prototype.stop = function () { + if (this.stream) { + // assume only one track + this.stream.getTracks()[0].stop(); + } + }; + /** + * Connect to an audio unit. If no parameter is provided, will + * connect to the master output (i.e. your speakers).
+ * + * @method connect + * @param {Object} [unit] An object that accepts audio input, + * such as an FFT + */ + p5.AudioIn.prototype.connect = function (unit) { + if (unit) { + if (unit.hasOwnProperty('input')) { + this.output.connect(unit.input); + } else if (unit.hasOwnProperty('analyser')) { + this.output.connect(unit.analyser); + } else { + this.output.connect(unit); + } + } else { + this.output.connect(p5sound.input); + } + }; + /** + * Disconnect the AudioIn from all audio units. For example, if + * connect() had been called, disconnect() will stop sending + * signal to your speakers.
+ * + * @method disconnect + */ + p5.AudioIn.prototype.disconnect = function () { + this.output.disconnect(); + // stay connected to amplitude even if not outputting to p5 + this.output.connect(this.amplitude.input); + }; + /** + * Read the Amplitude (volume level) of an AudioIn. The AudioIn + * class contains its own instance of the Amplitude class to help + * make it easy to get a microphone's volume level. Accepts an + * optional smoothing value (0.0 < 1.0). NOTE: AudioIn must + * .start() before using .getLevel().
+ * + * @method getLevel + * @param {Number} [smoothing] Smoothing is 0.0 by default. + * Smooths values based on previous values. + * @return {Number} Volume level (between 0.0 and 1.0) + */ + p5.AudioIn.prototype.getLevel = function (smoothing) { + if (smoothing) { + this.amplitude.smoothing = smoothing; + } + return this.amplitude.getLevel(); + }; + /** + * Add input sources to the list of available sources. + * + * @private + */ + p5.AudioIn.prototype._gotSources = function (sourceInfos) { + for (var i = 0; i < sourceInfos.length; i++) { + var sourceInfo = sourceInfos[i]; + if (sourceInfo.kind === 'audio') { + // add the inputs to inputSources + //p5sound.inputSources.push(sourceInfo); + return sourceInfo; + } + } + }; + /** + * Set amplitude (volume) of a mic input between 0 and 1.0.
+ * + * @method amp + * @param {Number} vol between 0 and 1.0 + * @param {Number} [time] ramp time (optional) + */ + p5.AudioIn.prototype.amp = function (vol, t) { + if (t) { + var rampTime = t || 0; + var currentVol = this.output.gain.value; + this.output.gain.cancelScheduledValues(p5sound.audiocontext.currentTime); + this.output.gain.setValueAtTime(currentVol, p5sound.audiocontext.currentTime); + this.output.gain.linearRampToValueAtTime(vol, rampTime + p5sound.audiocontext.currentTime); + } else { + this.output.gain.cancelScheduledValues(p5sound.audiocontext.currentTime); + this.output.gain.setValueAtTime(vol, p5sound.audiocontext.currentTime); + } + }; + p5.AudioIn.prototype.listSources = function () { + console.log('listSources is deprecated - please use AudioIn.getSources'); + console.log('input sources: '); + if (p5sound.inputSources.length > 0) { + return p5sound.inputSources; + } else { + return 'This browser does not support MediaStreamTrack.getSources()'; + } + }; + /** + * Chrome only. Returns a list of available input sources + * and allows the user to set the media source. Firefox allows + * the user to choose from input sources in the permissions dialogue + * instead of enumerating available sources and selecting one. + * Note: in order to have descriptive media names your page must be + * served over a secure (HTTPS) connection and the page should + * request user media before enumerating devices. Otherwise device + * ID will be a long device ID number and does not specify device + * type. For example see + * https://simpl.info/getusermedia/sources/index.html vs. + * http://simpl.info/getusermedia/sources/index.html + * + * @method getSources + * @param {Function} callback a callback to handle the sources + * when they have been enumerated + * @example + *
+ * var audiograb; + * + * function setup(){ + * //new audioIn + * audioGrab = new p5.AudioIn(); + * + * audioGrab.getSources(function(sourceList) { + * //print out the array of available sources + * console.log(sourceList); + * //set the source to the first item in the inputSources array + * audioGrab.setSource(0); + * }); + * } + *
+ */ + p5.AudioIn.prototype.getSources = function (callback) { + if (typeof window.MediaStreamTrack.getSources === 'function') { + window.MediaStreamTrack.getSources(function (data) { + for (var i = 0, max = data.length; i < max; i++) { + var sourceInfo = data[i]; + if (sourceInfo.kind === 'audio') { + // add the inputs to inputSources + p5sound.inputSources.push(sourceInfo); + } + } + callback(p5sound.inputSources); + }); + } else { + console.log('This browser does not support MediaStreamTrack.getSources()'); + } + }; + /** + * Set the input source. Accepts a number representing a + * position in the array returned by listSources(). + * This is only available in browsers that support + * MediaStreamTrack.getSources(). Instead, some browsers + * give users the option to set their own media source.
+ * + * @method setSource + * @param {number} num position of input source in the array + */ + p5.AudioIn.prototype.setSource = function (num) { + // TO DO - set input by string or # (array position) + var self = this; + if (p5sound.inputSources.length > 0 && num < p5sound.inputSources.length) { + // set the current source + self.currentSource = num; + console.log('set source to ' + p5sound.inputSources[self.currentSource].id); + } else { + console.log('unable to set input source'); + } + }; + // private method + p5.AudioIn.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.stop(); + if (this.output) { + this.output.disconnect(); + } + if (this.amplitude) { + this.amplitude.disconnect(); + } + this.amplitude = null; + this.output = null; + }; +}(master, errorHandler); +var filter; +filter = function () { + 'use strict'; + var p5sound = master; + /** + * A p5.Filter uses a Web Audio Biquad Filter to filter + * the frequency response of an input source. Inheriting + * classes include:
+ * * p5.LowPass - allows frequencies below + * the cutoff frequency to pass through, and attenuates + * frequencies above the cutoff.
+ * * p5.HighPass - the opposite of a lowpass + * filter.
+ * * p5.BandPass - allows a range of + * frequencies to pass through and attenuates the frequencies + * below and above this frequency range.
+ * + * The .res() method controls either width of the + * bandpass, or resonance of the low/highpass cutoff frequency. + * + * @class p5.Filter + * @constructor + * @param {String} [type] 'lowpass' (default), 'highpass', 'bandpass' + * @return {Object} p5.Filter + * @example + *
+ * var fft, noise, filter; + * + * function setup() { + * fill(255, 40, 255); + * + * filter = new p5.BandPass(); + * + * noise = new p5.Noise(); + * // disconnect unfiltered noise, + * // and connect to filter + * noise.disconnect(); + * noise.connect(filter); + * noise.start(); + * + * fft = new p5.FFT(); + * } + * + * function draw() { + * background(30); + * + * // set the BandPass frequency based on mouseX + * var freq = map(mouseX, 0, width, 20, 10000); + * filter.freq(freq); + * // give the filter a narrow band (lower res = wider bandpass) + * filter.res(50); + * + * // draw filtered spectrum + * var spectrum = fft.analyze(); + * noStroke(); + * for (var i = 0; i < spectrum.length; i++) { + * var x = map(i, 0, spectrum.length, 0, width); + * var h = -height + map(spectrum[i], 0, 255, height, 0); + * rect(x, height, width/spectrum.length, h); + * } + * + * isMouseOverCanvas(); + * } + * + * function isMouseOverCanvas() { + * var mX = mouseX, mY = mouseY; + * if (mX > 0 && mX < width && mY < height && mY > 0) { + * noise.amp(0.5, 0.2); + * } else { + * noise.amp(0, 0.2); + * } + * } + *
+ */ + p5.Filter = function (type) { + this.ac = p5sound.audiocontext; + this.input = this.ac.createGain(); + this.output = this.ac.createGain(); + /** + * The p5.Filter is built with a + * + * Web Audio BiquadFilter Node. + * + * @property biquadFilter + * @type {Object} Web Audio Delay Node + */ + this.biquad = this.ac.createBiquadFilter(); + this.input.connect(this.biquad); + this.biquad.connect(this.output); + this.connect(); + if (type) { + this.setType(type); + } + // add to the soundArray + p5sound.soundArray.push(this); + }; + /** + * Filter an audio signal according to a set + * of filter parameters. + * + * @method process + * @param {Object} Signal An object that outputs audio + * @param {Number} [freq] Frequency in Hz, from 10 to 22050 + * @param {Number} [res] Resonance/Width of the filter frequency + * from 0.001 to 1000 + */ + p5.Filter.prototype.process = function (src, freq, res) { + src.connect(this.input); + this.set(freq, res); + }; + /** + * Set the frequency and the resonance of the filter. + * + * @method set + * @param {Number} freq Frequency in Hz, from 10 to 22050 + * @param {Number} res Resonance (Q) from 0.001 to 1000 + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + */ + p5.Filter.prototype.set = function (freq, res, time) { + if (freq) { + this.freq(freq, time); + } + if (res) { + this.res(res, time); + } + }; + /** + * Set the filter frequency, in Hz, from 10 to 22050 (the range of + * human hearing, although in reality most people hear in a narrower + * range). + * + * @method freq + * @param {Number} freq Filter Frequency + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + * @return {Number} value Returns the current frequency value + */ + p5.Filter.prototype.freq = function (freq, time) { + var self = this; + var t = time || 0; + if (freq <= 0) { + freq = 1; + } + if (typeof freq === 'number') { + self.biquad.frequency.value = freq; + self.biquad.frequency.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + self.biquad.frequency.exponentialRampToValueAtTime(freq, this.ac.currentTime + 0.02 + t); + } else if (freq) { + freq.connect(this.biquad.frequency); + } + return self.biquad.frequency.value; + }; + /** + * Controls either width of a bandpass frequency, + * or the resonance of a low/highpass cutoff frequency. + * + * @method res + * @param {Number} res Resonance/Width of filter freq + * from 0.001 to 1000 + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + * @return {Number} value Returns the current res value + */ + p5.Filter.prototype.res = function (res, time) { + var self = this; + var t = time || 0; + if (typeof res == 'number') { + self.biquad.Q.value = res; + self.biquad.Q.cancelScheduledValues(self.ac.currentTime + 0.01 + t); + self.biquad.Q.linearRampToValueAtTime(res, self.ac.currentTime + 0.02 + t); + } else if (res) { + freq.connect(this.biquad.Q); + } + return self.biquad.Q.value; + }; + /** + * Set the type of a p5.Filter. Possible types include: + * "lowpass" (default), "highpass", "bandpass", + * "lowshelf", "highshelf", "peaking", "notch", + * "allpass". + * + * @method setType + * @param {String} t type of filter + */ + p5.Filter.prototype.setType = function (t) { + this.biquad.type = t; + }; + /** + * Set the output level of the filter. + * + * @method amp + * @param {Number} volume amplitude between 0 and 1.0 + * @param {Number} [rampTime] create a fade that lasts rampTime + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + */ + p5.Filter.prototype.amp = function (vol, rampTime, tFromNow) { + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var now = p5sound.audiocontext.currentTime; + var currentVol = this.output.gain.value; + this.output.gain.cancelScheduledValues(now); + this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow + 0.001); + this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime + 0.001); + }; + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + p5.Filter.prototype.connect = function (unit) { + var u = unit || p5.soundOut.input; + this.output.connect(u); + }; + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Filter.prototype.disconnect = function () { + this.output.disconnect(); + }; + p5.Filter.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.input.disconnect(); + this.input = undefined; + this.output.disconnect(); + this.output = undefined; + this.biquad.disconnect(); + this.biquad = undefined; + }; + /** + * Constructor: new p5.LowPass() Filter. + * This is the same as creating a p5.Filter and then calling + * its method setType('lowpass'). + * See p5.Filter for methods. + * + * @method p5.LowPass + */ + p5.LowPass = function () { + p5.Filter.call(this, 'lowpass'); + }; + p5.LowPass.prototype = Object.create(p5.Filter.prototype); + /** + * Constructor: new p5.HighPass() Filter. + * This is the same as creating a p5.Filter and then calling + * its method setType('highpass'). + * See p5.Filter for methods. + * + * @method p5.HighPass + */ + p5.HighPass = function () { + p5.Filter.call(this, 'highpass'); + }; + p5.HighPass.prototype = Object.create(p5.Filter.prototype); + /** + * Constructor: new p5.BandPass() Filter. + * This is the same as creating a p5.Filter and then calling + * its method setType('bandpass'). + * See p5.Filter for methods. + * + * @method p5.BandPass + */ + p5.BandPass = function () { + p5.Filter.call(this, 'bandpass'); + }; + p5.BandPass.prototype = Object.create(p5.Filter.prototype); +}(master); +var delay; +delay = function () { + 'use strict'; + var p5sound = master; + var Filter = filter; + /** + * Delay is an echo effect. It processes an existing sound source, + * and outputs a delayed version of that sound. The p5.Delay can + * produce different effects depending on the delayTime, feedback, + * filter, and type. In the example below, a feedback of 0.5 will + * produce a looping delay that decreases in volume by + * 50% each repeat. A filter will cut out the high frequencies so + * that the delay does not sound as piercing as the original source. + * + * @class p5.Delay + * @constructor + * @return {Object} Returns a p5.Delay object + * @example + *
+ * var noise, env, delay; + * + * function setup() { + * background(0); + * noStroke(); + * fill(255); + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * noise = new p5.Noise('brown'); + * noise.amp(0); + * noise.start(); + * + * delay = new p5.Delay(); + * + * // delay.process() accepts 4 parameters: + * // source, delayTime, feedback, filter frequency + * // play with these numbers!! + * delay.process(noise, .12, .7, 2300); + * + * // play the noise with an envelope, + * // a series of fades ( time / value pairs ) + * env = new p5.Env(.01, 0.2, .2, .1); + * } + * + * // mouseClick triggers envelope + * function mouseClicked() { + * // is mouse over canvas? + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * env.play(noise); + * } + * } + *
+ */ + p5.Delay = function () { + this.ac = p5sound.audiocontext; + this.input = this.ac.createGain(); + this.output = this.ac.createGain(); + this._split = this.ac.createChannelSplitter(2); + this._merge = this.ac.createChannelMerger(2); + this._leftGain = this.ac.createGain(); + this._rightGain = this.ac.createGain(); + /** + * The p5.Delay is built with two + * + * Web Audio Delay Nodes, one for each stereo channel. + * + * @property leftDelay + * @type {Object} Web Audio Delay Node + */ + this.leftDelay = this.ac.createDelay(); + /** + * The p5.Delay is built with two + * + * Web Audio Delay Nodes, one for each stereo channel. + * + * @property rightDelay + * @type {Object} Web Audio Delay Node + */ + this.rightDelay = this.ac.createDelay(); + this._leftFilter = new p5.Filter(); + this._rightFilter = new p5.Filter(); + this._leftFilter.disconnect(); + this._rightFilter.disconnect(); + this._leftFilter.biquad.frequency.setValueAtTime(1200, this.ac.currentTime); + this._rightFilter.biquad.frequency.setValueAtTime(1200, this.ac.currentTime); + this._leftFilter.biquad.Q.setValueAtTime(0.3, this.ac.currentTime); + this._rightFilter.biquad.Q.setValueAtTime(0.3, this.ac.currentTime); + // graph routing + this.input.connect(this._split); + this.leftDelay.connect(this._leftGain); + this.rightDelay.connect(this._rightGain); + this._leftGain.connect(this._leftFilter.input); + this._rightGain.connect(this._rightFilter.input); + this._merge.connect(this.output); + this.output.connect(p5.soundOut.input); + this._leftFilter.biquad.gain.setValueAtTime(1, this.ac.currentTime); + this._rightFilter.biquad.gain.setValueAtTime(1, this.ac.currentTime); + // default routing + this.setType(0); + this._maxDelay = this.leftDelay.delayTime.maxValue; + // add this p5.SoundFile to the soundArray + p5sound.soundArray.push(this); + }; + /** + * Add delay to an audio signal according to a set + * of delay parameters. + * + * @method process + * @param {Object} Signal An object that outputs audio + * @param {Number} [delayTime] Time (in seconds) of the delay/echo. + * Some browsers limit delayTime to + * 1 second. + * @param {Number} [feedback] sends the delay back through itself + * in a loop that decreases in volume + * each time. + * @param {Number} [lowPass] Cutoff frequency. Only frequencies + * below the lowPass will be part of the + * delay. + */ + p5.Delay.prototype.process = function (src, _delayTime, _feedback, _filter) { + var feedback = _feedback || 0; + var delayTime = _delayTime || 0; + if (feedback >= 1) { + throw new Error('Feedback value will force a positive feedback loop.'); + } + if (delayTime >= this._maxDelay) { + throw new Error('Delay Time exceeds maximum delay time of ' + this._maxDelay + ' second.'); + } + src.connect(this.input); + this.leftDelay.delayTime.setValueAtTime(delayTime, this.ac.currentTime); + this.rightDelay.delayTime.setValueAtTime(delayTime, this.ac.currentTime); + this._leftGain.gain.setValueAtTime(feedback, this.ac.currentTime); + this._rightGain.gain.setValueAtTime(feedback, this.ac.currentTime); + if (_filter) { + this._leftFilter.freq(_filter); + this._rightFilter.freq(_filter); + } + }; + /** + * Set the delay (echo) time, in seconds. Usually this value will be + * a floating point number between 0.0 and 1.0. + * + * @method delayTime + * @param {Number} delayTime Time (in seconds) of the delay + */ + p5.Delay.prototype.delayTime = function (t) { + // if t is an audio node... + if (typeof t !== 'number') { + t.connect(this.leftDelay.delayTime); + t.connect(this.rightDelay.delayTime); + } else { + this.leftDelay.delayTime.cancelScheduledValues(this.ac.currentTime); + this.rightDelay.delayTime.cancelScheduledValues(this.ac.currentTime); + this.leftDelay.delayTime.linearRampToValueAtTime(t, this.ac.currentTime); + this.rightDelay.delayTime.linearRampToValueAtTime(t, this.ac.currentTime); + } + }; + /** + * Feedback occurs when Delay sends its signal back through its input + * in a loop. The feedback amount determines how much signal to send each + * time through the loop. A feedback greater than 1.0 is not desirable because + * it will increase the overall output each time through the loop, + * creating an infinite feedback loop. + * + * @method feedback + * @param {Number|Object} feedback 0.0 to 1.0, or an object such as an + * Oscillator that can be used to + * modulate this param + */ + p5.Delay.prototype.feedback = function (f) { + // if f is an audio node... + if (typeof f !== 'number') { + f.connect(this._leftGain.gain); + f.connect(this._rightGain.gain); + } else if (f >= 1) { + throw new Error('Feedback value will force a positive feedback loop.'); + } else { + this._leftGain.gain.exponentialRampToValueAtTime(f, this.ac.currentTime); + this._rightGain.gain.exponentialRampToValueAtTime(f, this.ac.currentTime); + } + }; + /** + * Set a lowpass filter frequency for the delay. A lowpass filter + * will cut off any frequencies higher than the filter frequency. + * + * @method filter + * @param {Number|Object} cutoffFreq A lowpass filter will cut off any + * frequencies higher than the filter frequency. + * @param {Number|Object} res Resonance of the filter frequency + * cutoff, or an object (i.e. a p5.Oscillator) + * that can be used to modulate this parameter. + * High numbers (i.e. 15) will produce a resonance, + * low numbers (i.e. .2) will produce a slope. + */ + p5.Delay.prototype.filter = function (freq, q) { + this._leftFilter.set(freq, q); + this._rightFilter.set(freq, q); + }; + /** + * Choose a preset type of delay. 'pingPong' bounces the signal + * from the left to the right channel to produce a stereo effect. + * Any other parameter will revert to the default delay setting. + * + * @method setType + * @param {String|Number} type 'pingPong' (1) or 'default' (0) + */ + p5.Delay.prototype.setType = function (t) { + if (t === 1) { + t = 'pingPong'; + } + this._split.disconnect(); + this._leftFilter.disconnect(); + this._rightFilter.disconnect(); + this._split.connect(this.leftDelay, 0); + this._split.connect(this.rightDelay, 1); + switch (t) { + case 'pingPong': + this._rightFilter.setType(this._leftFilter.biquad.type); + this._leftFilter.output.connect(this._merge, 0, 0); + this._rightFilter.output.connect(this._merge, 0, 1); + this._leftFilter.output.connect(this.rightDelay); + this._rightFilter.output.connect(this.leftDelay); + break; + default: + this._leftFilter.output.connect(this._merge, 0, 0); + this._leftFilter.output.connect(this._merge, 0, 1); + this._leftFilter.output.connect(this.leftDelay); + this._leftFilter.output.connect(this.rightDelay); + } + }; + /** + * Set the output level of the delay effect. + * + * @method amp + * @param {Number} volume amplitude between 0 and 1.0 + * @param {Number} [rampTime] create a fade that lasts rampTime + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + */ + p5.Delay.prototype.amp = function (vol, rampTime, tFromNow) { + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var now = p5sound.audiocontext.currentTime; + var currentVol = this.output.gain.value; + this.output.gain.cancelScheduledValues(now); + this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow + 0.001); + this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime + 0.001); + }; + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + p5.Delay.prototype.connect = function (unit) { + var u = unit || p5.soundOut.input; + this.output.connect(u); + }; + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Delay.prototype.disconnect = function () { + this.output.disconnect(); + }; + p5.Delay.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.input.disconnect(); + this.output.disconnect(); + this._split.disconnect(); + this._leftFilter.disconnect(); + this._rightFilter.disconnect(); + this._merge.disconnect(); + this._leftGain.disconnect(); + this._rightGain.disconnect(); + this.leftDelay.disconnect(); + this.rightDelay.disconnect(); + this.input = undefined; + this.output = undefined; + this._split = undefined; + this._leftFilter = undefined; + this._rightFilter = undefined; + this._merge = undefined; + this._leftGain = undefined; + this._rightGain = undefined; + this.leftDelay = undefined; + this.rightDelay = undefined; + }; +}(master, filter); +var reverb; +reverb = function () { + 'use strict'; + var p5sound = master; + var CustomError = errorHandler; + /** + * Reverb adds depth to a sound through a large number of decaying + * echoes. It creates the perception that sound is occurring in a + * physical space. The p5.Reverb has paramters for Time (how long does the + * reverb last) and decayRate (how much the sound decays with each echo) + * that can be set with the .set() or .process() methods. The p5.Convolver + * extends p5.Reverb allowing you to recreate the sound of actual physical + * spaces through convolution. + * + * @class p5.Reverb + * @constructor + * @example + *
+ * var soundFile, reverb; + * function preload() { + * soundFile = loadSound('assets/Damscray_DancingTiger.mp3'); + * } + * + * function setup() { + * reverb = new p5.Reverb(); + * soundFile.disconnect(); // so we'll only hear reverb... + * + * // connect soundFile to reverb, process w/ + * // 3 second reverbTime, decayRate of 2% + * reverb.process(soundFile, 3, 2); + * soundFile.play(); + * } + *
+ */ + p5.Reverb = function () { + this.ac = p5sound.audiocontext; + this.convolverNode = this.ac.createConvolver(); + this.input = this.ac.createGain(); + this.output = this.ac.createGain(); + // otherwise, Safari distorts + this.input.gain.value = 0.5; + this.input.connect(this.convolverNode); + this.convolverNode.connect(this.output); + // default params + this._seconds = 3; + this._decay = 2; + this._reverse = false; + this._buildImpulse(); + this.connect(); + p5sound.soundArray.push(this); + }; + /** + * Connect a source to the reverb, and assign reverb parameters. + * + * @method process + * @param {Object} src p5.sound / Web Audio object with a sound + * output. + * @param {Number} [seconds] Duration of the reverb, in seconds. + * Min: 0, Max: 10. Defaults to 3. + * @param {Number} [decayRate] Percentage of decay with each echo. + * Min: 0, Max: 100. Defaults to 2. + * @param {Boolean} [reverse] Play the reverb backwards or forwards. + */ + p5.Reverb.prototype.process = function (src, seconds, decayRate, reverse) { + src.connect(this.input); + var rebuild = false; + if (seconds) { + this._seconds = seconds; + rebuild = true; + } + if (decayRate) { + this._decay = decayRate; + } + if (reverse) { + this._reverse = reverse; + } + if (rebuild) { + this._buildImpulse(); + } + }; + /** + * Set the reverb settings. Similar to .process(), but without + * assigning a new input. + * + * @method set + * @param {Number} [seconds] Duration of the reverb, in seconds. + * Min: 0, Max: 10. Defaults to 3. + * @param {Number} [decayRate] Percentage of decay with each echo. + * Min: 0, Max: 100. Defaults to 2. + * @param {Boolean} [reverse] Play the reverb backwards or forwards. + */ + p5.Reverb.prototype.set = function (seconds, decayRate, reverse) { + var rebuild = false; + if (seconds) { + this._seconds = seconds; + rebuild = true; + } + if (decayRate) { + this._decay = decayRate; + } + if (reverse) { + this._reverse = reverse; + } + if (rebuild) { + this._buildImpulse(); + } + }; + /** + * Set the output level of the delay effect. + * + * @method amp + * @param {Number} volume amplitude between 0 and 1.0 + * @param {Number} [rampTime] create a fade that lasts rampTime + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + */ + p5.Reverb.prototype.amp = function (vol, rampTime, tFromNow) { + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var now = p5sound.audiocontext.currentTime; + var currentVol = this.output.gain.value; + this.output.gain.cancelScheduledValues(now); + this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow + 0.001); + this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime + 0.001); + }; + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + p5.Reverb.prototype.connect = function (unit) { + var u = unit || p5.soundOut.input; + this.output.connect(u.input ? u.input : u); + }; + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Reverb.prototype.disconnect = function () { + this.output.disconnect(); + }; + /** + * Inspired by Simple Reverb by Jordan Santell + * https://github.com/web-audio-components/simple-reverb/blob/master/index.js + * + * Utility function for building an impulse response + * based on the module parameters. + * + * @private + */ + p5.Reverb.prototype._buildImpulse = function () { + var rate = this.ac.sampleRate; + var length = rate * this._seconds; + var decay = this._decay; + var impulse = this.ac.createBuffer(2, length, rate); + var impulseL = impulse.getChannelData(0); + var impulseR = impulse.getChannelData(1); + var n, i; + for (i = 0; i < length; i++) { + n = this.reverse ? length - i : i; + impulseL[i] = (Math.random() * 2 - 1) * Math.pow(1 - n / length, decay); + impulseR[i] = (Math.random() * 2 - 1) * Math.pow(1 - n / length, decay); + } + this.convolverNode.buffer = impulse; + }; + p5.Reverb.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + if (this.convolverNode) { + this.convolverNode.buffer = null; + this.convolverNode = null; + } + if (typeof this.output !== 'undefined') { + this.output.disconnect(); + this.output = null; + } + if (typeof this.panner !== 'undefined') { + this.panner.disconnect(); + this.panner = null; + } + }; + // ======================================================================= + // *** p5.Convolver *** + // ======================================================================= + /** + *

p5.Convolver extends p5.Reverb. It can emulate the sound of real + * physical spaces through a process called + * convolution.

+ * + *

Convolution multiplies any audio input by an "impulse response" + * to simulate the dispersion of sound over time. The impulse response is + * generated from an audio file that you provide. One way to + * generate an impulse response is to pop a balloon in a reverberant space + * and record the echo. Convolution can also be used to experiment with + * sound.

+ * + *

Use the method createConvolution(path) to instantiate a + * p5.Convolver with a path to your impulse response audio file.

+ * + * @class p5.Convolver + * @constructor + * @param {String} path path to a sound file + * @param {Function} [callback] function to call when loading succeeds + * @param {Function} [errorCallback] function to call if loading fails. + * This function will receive an error or + * XMLHttpRequest object with information + * about what went wrong. + * @example + *
+ * var cVerb, sound; + * function preload() { + * // We have both MP3 and OGG versions of all sound assets + * soundFormats('ogg', 'mp3'); + * + * // Try replacing 'bx-spring' with other soundfiles like + * // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox' + * cVerb = createConvolver('assets/bx-spring.mp3'); + * + * // Try replacing 'Damscray_DancingTiger' with + * // 'beat', 'doorbell', lucky_dragons_-_power_melody' + * sound = loadSound('assets/Damscray_DancingTiger.mp3'); + * } + * + * function setup() { + * // disconnect from master output... + * sound.disconnect(); + * + * // ...and process with cVerb + * // so that we only hear the convolution + * cVerb.process(sound); + * + * sound.play(); + * } + *
+ */ + p5.Convolver = function (path, callback, errorCallback) { + this.ac = p5sound.audiocontext; + /** + * Internally, the p5.Convolver uses the a + * + * Web Audio Convolver Node. + * + * @property convolverNode + * @type {Object} Web Audio Convolver Node + */ + this.convolverNode = this.ac.createConvolver(); + this.input = this.ac.createGain(); + this.output = this.ac.createGain(); + // otherwise, Safari distorts + this.input.gain.value = 0.5; + this.input.connect(this.convolverNode); + this.convolverNode.connect(this.output); + if (path) { + this.impulses = []; + this._loadBuffer(path, callback, errorCallback); + } else { + // parameters + this._seconds = 3; + this._decay = 2; + this._reverse = false; + this._buildImpulse(); + } + this.connect(); + p5sound.soundArray.push(this); + }; + p5.Convolver.prototype = Object.create(p5.Reverb.prototype); + p5.prototype.registerPreloadMethod('createConvolver', p5.prototype); + /** + * Create a p5.Convolver. Accepts a path to a soundfile + * that will be used to generate an impulse response. + * + * @method createConvolver + * @param {String} path path to a sound file + * @param {Function} [callback] function to call if loading is successful. + * The object will be passed in as the argument + * to the callback function. + * @param {Function} [errorCallback] function to call if loading is not successful. + * A custom error will be passed in as the argument + * to the callback function. + * @return {p5.Convolver} + * @example + *
+ * var cVerb, sound; + * function preload() { + * // We have both MP3 and OGG versions of all sound assets + * soundFormats('ogg', 'mp3'); + * + * // Try replacing 'bx-spring' with other soundfiles like + * // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox' + * cVerb = createConvolver('assets/bx-spring.mp3'); + * + * // Try replacing 'Damscray_DancingTiger' with + * // 'beat', 'doorbell', lucky_dragons_-_power_melody' + * sound = loadSound('assets/Damscray_DancingTiger.mp3'); + * } + * + * function setup() { + * // disconnect from master output... + * sound.disconnect(); + * + * // ...and process with cVerb + * // so that we only hear the convolution + * cVerb.process(sound); + * + * sound.play(); + * } + *
+ */ + p5.prototype.createConvolver = function (path, callback, errorCallback) { + // if loading locally without a server + if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { + alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); + } + var cReverb = new p5.Convolver(path, callback, errorCallback); + cReverb.impulses = []; + return cReverb; + }; + /** + * Private method to load a buffer as an Impulse Response, + * assign it to the convolverNode, and add to the Array of .impulses. + * + * @param {String} path + * @param {Function} callback + * @param {Function} errorCallback + * @private + */ + p5.Convolver.prototype._loadBuffer = function (path, callback, errorCallback) { + var path = p5.prototype._checkFileFormats(path); + var self = this; + var errorTrace = new Error().stack; + var ac = p5.prototype.getAudioContext(); + var request = new XMLHttpRequest(); + request.open('GET', path, true); + request.responseType = 'arraybuffer'; + request.onload = function () { + if (request.status == 200) { + // on success loading file: + ac.decodeAudioData(request.response, function (buff) { + var buffer = {}; + var chunks = path.split('/'); + buffer.name = chunks[chunks.length - 1]; + buffer.audioBuffer = buff; + self.impulses.push(buffer); + self.convolverNode.buffer = buffer.audioBuffer; + if (callback) { + callback(buffer); + } + }, // error decoding buffer. "e" is undefined in Chrome 11/22/2015 + function (e) { + var err = new CustomError('decodeAudioData', errorTrace, self.url); + var msg = 'AudioContext error at decodeAudioData for ' + self.url; + if (errorCallback) { + err.msg = msg; + errorCallback(err); + } else { + console.error(msg + '\n The error stack trace includes: \n' + err.stack); + } + }); + } else { + var err = new CustomError('loadConvolver', errorTrace, self.url); + var msg = 'Unable to load ' + self.url + '. The request status was: ' + request.status + ' (' + request.statusText + ')'; + if (errorCallback) { + err.message = msg; + errorCallback(err); + } else { + console.error(msg + '\n The error stack trace includes: \n' + err.stack); + } + } + }; + // if there is another error, aside from 404... + request.onerror = function (e) { + var err = new CustomError('loadConvolver', errorTrace, self.url); + var msg = 'There was no response from the server at ' + self.url + '. Check the url and internet connectivity.'; + if (errorCallback) { + err.message = msg; + errorCallback(err); + } else { + console.error(msg + '\n The error stack trace includes: \n' + err.stack); + } + }; + request.send(); + }; + p5.Convolver.prototype.set = null; + /** + * Connect a source to the reverb, and assign reverb parameters. + * + * @method process + * @param {Object} src p5.sound / Web Audio object with a sound + * output. + * @example + *
+ * var cVerb, sound; + * function preload() { + * soundFormats('ogg', 'mp3'); + * + * cVerb = createConvolver('assets/concrete-tunnel.mp3'); + * + * sound = loadSound('assets/beat.mp3'); + * } + * + * function setup() { + * // disconnect from master output... + * sound.disconnect(); + * + * // ...and process with (i.e. connect to) cVerb + * // so that we only hear the convolution + * cVerb.process(sound); + * + * sound.play(); + * } + *
+ */ + p5.Convolver.prototype.process = function (src) { + src.connect(this.input); + }; + /** + * If you load multiple impulse files using the .addImpulse method, + * they will be stored as Objects in this Array. Toggle between them + * with the toggleImpulse(id) method. + * + * @property impulses + * @type {Array} Array of Web Audio Buffers + */ + p5.Convolver.prototype.impulses = []; + /** + * Load and assign a new Impulse Response to the p5.Convolver. + * The impulse is added to the .impulses array. Previous + * impulses can be accessed with the .toggleImpulse(id) + * method. + * + * @method addImpulse + * @param {String} path path to a sound file + * @param {Function} callback function (optional) + * @param {Function} errorCallback function (optional) + */ + p5.Convolver.prototype.addImpulse = function (path, callback, errorCallback) { + // if loading locally without a server + if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { + alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); + } + this._loadBuffer(path, callback, errorCallback); + }; + /** + * Similar to .addImpulse, except that the .impulses + * Array is reset to save memory. A new .impulses + * array is created with this impulse as the only item. + * + * @method resetImpulse + * @param {String} path path to a sound file + * @param {Function} callback function (optional) + * @param {Function} errorCallback function (optional) + */ + p5.Convolver.prototype.resetImpulse = function (path, callback, errorCallback) { + // if loading locally without a server + if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { + alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); + } + this.impulses = []; + this._loadBuffer(path, callback, errorCallback); + }; + /** + * If you have used .addImpulse() to add multiple impulses + * to a p5.Convolver, then you can use this method to toggle between + * the items in the .impulses Array. Accepts a parameter + * to identify which impulse you wish to use, identified either by its + * original filename (String) or by its position in the .impulses + * Array (Number).
+ * You can access the objects in the .impulses Array directly. Each + * Object has two attributes: an .audioBuffer (type: + * Web Audio + * AudioBuffer) and a .name, a String that corresponds + * with the original filename. + * + * @method toggleImpulse + * @param {String|Number} id Identify the impulse by its original filename + * (String), or by its position in the + * .impulses Array (Number). + */ + p5.Convolver.prototype.toggleImpulse = function (id) { + if (typeof id === 'number' && id < this.impulses.length) { + this.convolverNode.buffer = this.impulses[id].audioBuffer; + } + if (typeof id === 'string') { + for (var i = 0; i < this.impulses.length; i++) { + if (this.impulses[i].name === id) { + this.convolverNode.buffer = this.impulses[i].audioBuffer; + break; + } + } + } + }; + p5.Convolver.prototype.dispose = function () { + // remove all the Impulse Response buffers + for (var i in this.impulses) { + this.impulses[i] = null; + } + this.convolverNode.disconnect(); + this.concolverNode = null; + if (typeof this.output !== 'undefined') { + this.output.disconnect(); + this.output = null; + } + if (typeof this.panner !== 'undefined') { + this.panner.disconnect(); + this.panner = null; + } + }; +}(master, errorHandler, sndcore); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_TimelineState; +Tone_core_TimelineState = function (Tone) { + 'use strict'; + Tone.TimelineState = function (initial) { + Tone.Timeline.call(this); + this._initial = initial; + }; + Tone.extend(Tone.TimelineState, Tone.Timeline); + Tone.TimelineState.prototype.getStateAtTime = function (time) { + var event = this.getEvent(time); + if (event !== null) { + return event.state; + } else { + return this._initial; + } + }; + Tone.TimelineState.prototype.setStateAtTime = function (state, time) { + this.addEvent({ + 'state': state, + 'time': this.toSeconds(time) + }); + }; + return Tone.TimelineState; +}(Tone_core_Tone, Tone_core_Timeline); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Clock; +Tone_core_Clock = function (Tone) { + 'use strict'; + Tone.Clock = function () { + var options = this.optionsObject(arguments, [ + 'callback', + 'frequency' + ], Tone.Clock.defaults); + this.callback = options.callback; + this._lookAhead = 'auto'; + this._computedLookAhead = 1 / 60; + this._threshold = 0.5; + this._nextTick = -1; + this._lastUpdate = 0; + this._loopID = -1; + this.frequency = new Tone.TimelineSignal(options.frequency, Tone.Type.Frequency); + this.ticks = 0; + this._state = new Tone.TimelineState(Tone.State.Stopped); + this._boundLoop = this._loop.bind(this); + this._readOnly('frequency'); + this._loop(); + }; + Tone.extend(Tone.Clock); + Tone.Clock.defaults = { + 'callback': Tone.noOp, + 'frequency': 1, + 'lookAhead': 'auto' + }; + Object.defineProperty(Tone.Clock.prototype, 'state', { + get: function () { + return this._state.getStateAtTime(this.now()); + } + }); + Object.defineProperty(Tone.Clock.prototype, 'lookAhead', { + get: function () { + return this._lookAhead; + }, + set: function (val) { + if (val === 'auto') { + this._lookAhead = 'auto'; + } else { + this._lookAhead = this.toSeconds(val); + } + } + }); + Tone.Clock.prototype.start = function (time, offset) { + time = this.toSeconds(time); + if (this._state.getStateAtTime(time) !== Tone.State.Started) { + this._state.addEvent({ + 'state': Tone.State.Started, + 'time': time, + 'offset': offset + }); + } + return this; + }; + Tone.Clock.prototype.stop = function (time) { + time = this.toSeconds(time); + if (this._state.getStateAtTime(time) !== Tone.State.Stopped) { + this._state.setStateAtTime(Tone.State.Stopped, time); + } + return this; + }; + Tone.Clock.prototype.pause = function (time) { + time = this.toSeconds(time); + if (this._state.getStateAtTime(time) === Tone.State.Started) { + this._state.setStateAtTime(Tone.State.Paused, time); + } + return this; + }; + Tone.Clock.prototype._loop = function (time) { + this._loopID = requestAnimationFrame(this._boundLoop); + if (this._lookAhead === 'auto') { + if (!this.isUndef(time)) { + var diff = (time - this._lastUpdate) / 1000; + this._lastUpdate = time; + if (diff < this._threshold) { + this._computedLookAhead = (9 * this._computedLookAhead + diff) / 10; + } + } + } else { + this._computedLookAhead = this._lookAhead; + } + var now = this.now(); + var lookAhead = this._computedLookAhead * 2; + var event = this._state.getEvent(now + lookAhead); + var state = Tone.State.Stopped; + if (event) { + state = event.state; + if (this._nextTick === -1 && state === Tone.State.Started) { + this._nextTick = event.time; + if (!this.isUndef(event.offset)) { + this.ticks = event.offset; + } + } + } + if (state === Tone.State.Started) { + while (now + lookAhead > this._nextTick) { + if (now > this._nextTick + this._threshold) { + this._nextTick = now; + } + var tickTime = this._nextTick; + this._nextTick += 1 / this.frequency.getValueAtTime(this._nextTick); + this.callback(tickTime); + this.ticks++; + } + } else if (state === Tone.State.Stopped) { + this._nextTick = -1; + this.ticks = 0; + } + }; + Tone.Clock.prototype.getStateAtTime = function (time) { + return this._state.getStateAtTime(time); + }; + Tone.Clock.prototype.dispose = function () { + cancelAnimationFrame(this._loopID); + Tone.TimelineState.prototype.dispose.call(this); + this._writable('frequency'); + this.frequency.dispose(); + this.frequency = null; + this._boundLoop = Tone.noOp; + this._nextTick = Infinity; + this.callback = null; + this._state.dispose(); + this._state = null; + }; + return Tone.Clock; +}(Tone_core_Tone, Tone_signal_TimelineSignal); +var metro; +metro = function () { + 'use strict'; + var p5sound = master; + // requires the Tone.js library's Clock (MIT license, Yotam Mann) + // https://github.com/TONEnoTONE/Tone.js/ + var Clock = Tone_core_Clock; + var ac = p5sound.audiocontext; + // var upTick = false; + p5.Metro = function () { + this.clock = new Clock({ 'callback': this.ontick.bind(this) }); + this.syncedParts = []; + this.bpm = 120; + // gets overridden by p5.Part + this._init(); + this.tickCallback = function () { + }; + }; + var prevTick = 0; + var tatumTime = 0; + p5.Metro.prototype.ontick = function (tickTime) { + var elapsedTime = tickTime - prevTick; + var secondsFromNow = tickTime - p5sound.audiocontext.currentTime; + if (elapsedTime - tatumTime <= -0.02) { + return; + } else { + prevTick = tickTime; + // for all of the active things on the metro: + for (var i in this.syncedParts) { + var thisPart = this.syncedParts[i]; + if (!thisPart.isPlaying) + return; + thisPart.incrementStep(secondsFromNow); + // each synced source keeps track of its own beat number + for (var j in thisPart.phrases) { + var thisPhrase = thisPart.phrases[j]; + var phraseArray = thisPhrase.sequence; + var bNum = this.metroTicks % phraseArray.length; + if (phraseArray[bNum] !== 0 && (this.metroTicks < phraseArray.length || !thisPhrase.looping)) { + thisPhrase.callback(secondsFromNow, phraseArray[bNum]); + } + } + } + this.metroTicks += 1; + this.tickCallback(secondsFromNow); + } + }; + p5.Metro.prototype.setBPM = function (bpm, rampTime) { + var beatTime = 60 / (bpm * this.tatums); + var now = p5sound.audiocontext.currentTime; + tatumTime = beatTime; + var rampTime = rampTime || 0; + this.clock.frequency.setValueAtTime(this.clock.frequency.value, now); + this.clock.frequency.linearRampToValueAtTime(bpm, now + rampTime); + this.bpm = bpm; + }; + p5.Metro.prototype.getBPM = function (tempo) { + return this.clock.getRate() / this.tatums * 60; + }; + p5.Metro.prototype._init = function () { + this.metroTicks = 0; + }; + // clear existing synced parts, add only this one + p5.Metro.prototype.resetSync = function (part) { + this.syncedParts = [part]; + }; + // push a new synced part to the array + p5.Metro.prototype.pushSync = function (part) { + this.syncedParts.push(part); + }; + p5.Metro.prototype.start = function (timeFromNow) { + var t = timeFromNow || 0; + var now = p5sound.audiocontext.currentTime; + this.clock.start(now + t); + this.setBPM(this.bpm); + }; + p5.Metro.prototype.stop = function (timeFromNow) { + var t = timeFromNow || 0; + var now = p5sound.audiocontext.currentTime; + if (this.clock._oscillator) { + this.clock.stop(now + t); + } + }; + p5.Metro.prototype.beatLength = function (tatums) { + this.tatums = 1 / tatums / 4; + }; +}(master, Tone_core_Clock); +var looper; +looper = function () { + 'use strict'; + var p5sound = master; + var bpm = 120; + /** + * Set the global tempo, in beats per minute, for all + * p5.Parts. This method will impact all active p5.Parts. + * + * @param {Number} BPM Beats Per Minute + * @param {Number} rampTime Seconds from now + */ + p5.prototype.setBPM = function (BPM, rampTime) { + bpm = BPM; + for (var i in p5sound.parts) { + p5sound.parts[i].setBPM(bpm, rampTime); + } + }; + /** + *

A phrase is a pattern of musical events over time, i.e. + * a series of notes and rests.

+ * + *

Phrases must be added to a p5.Part for playback, and + * each part can play multiple phrases at the same time. + * For example, one Phrase might be a kick drum, another + * could be a snare, and another could be the bassline.

+ * + *

The first parameter is a name so that the phrase can be + * modified or deleted later. The callback is a a function that + * this phrase will call at every step—for example it might be + * called playNote(value){}. The array determines + * which value is passed into the callback at each step of the + * phrase. It can be numbers, an object with multiple numbers, + * or a zero (0) indicates a rest so the callback won't be called).

+ * + * @class p5.Phrase + * @constructor + * @param {String} name Name so that you can access the Phrase. + * @param {Function} callback The name of a function that this phrase + * will call. Typically it will play a sound, + * and accept two parameters: a time at which + * to play the sound (in seconds from now), + * and a value from the sequence array. The + * time should be passed into the play() or + * start() method to ensure precision. + * @param {Array} sequence Array of values to pass into the callback + * at each step of the phrase. + * @example + *
+ * var mySound, myPhrase, myPart; + * var pattern = [1,0,0,2,0,2,0,0]; + * var msg = 'click to play'; + * + * function preload() { + * mySound = loadSound('assets/beatbox.mp3'); + * } + * + * function setup() { + * noStroke(); + * fill(255); + * textAlign(CENTER); + * masterVolume(0.1); + * + * myPhrase = new p5.Phrase('bbox', makeSound, pattern); + * myPart = new p5.Part(); + * myPart.addPhrase(myPhrase); + * myPart.setBPM(60); + * } + * + * function draw() { + * background(0); + * text(msg, width/2, height/2); + * } + * + * function makeSound(time, playbackRate) { + * mySound.rate(playbackRate); + * mySound.play(time); + * } + * + * function mouseClicked() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * myPart.start(); + * msg = 'playing pattern'; + * } + * } + * + *
+ */ + p5.Phrase = function (name, callback, sequence) { + this.phraseStep = 0; + this.name = name; + this.callback = callback; + /** + * Array of values to pass into the callback + * at each step of the phrase. Depending on the callback + * function's requirements, these values may be numbers, + * strings, or an object with multiple parameters. + * Zero (0) indicates a rest. + * + * @property sequence + * @type {Array} + */ + this.sequence = sequence; + }; + /** + *

A p5.Part plays back one or more p5.Phrases. Instantiate a part + * with steps and tatums. By default, each step represents 1/16th note.

+ * + *

See p5.Phrase for more about musical timing.

+ * + * @class p5.Part + * @constructor + * @param {Number} [steps] Steps in the part + * @param {Number} [tatums] Divisions of a beat (default is 1/16, a quarter note) + * @example + *
+ * var box, drum, myPart; + * var boxPat = [1,0,0,2,0,2,0,0]; + * var drumPat = [0,1,1,0,2,0,1,0]; + * var msg = 'click to play'; + * + * function preload() { + * box = loadSound('assets/beatbox.mp3'); + * drum = loadSound('assets/drum.mp3'); + * } + * + * function setup() { + * noStroke(); + * fill(255); + * textAlign(CENTER); + * masterVolume(0.1); + * + * var boxPhrase = new p5.Phrase('box', playBox, boxPat); + * var drumPhrase = new p5.Phrase('drum', playDrum, drumPat); + * myPart = new p5.Part(); + * myPart.addPhrase(boxPhrase); + * myPart.addPhrase(drumPhrase); + * myPart.setBPM(60); + * masterVolume(0.1); + * } + * + * function draw() { + * background(0); + * text(msg, width/2, height/2); + * } + * + * function playBox(time, playbackRate) { + * box.rate(playbackRate); + * box.play(time); + * } + * + * function playDrum(time, playbackRate) { + * drum.rate(playbackRate); + * drum.play(time); + * } + * + * function mouseClicked() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * myPart.start(); + * msg = 'playing part'; + * } + * } + *
+ */ + p5.Part = function (steps, bLength) { + this.length = steps || 0; + // how many beats + this.partStep = 0; + this.phrases = []; + this.isPlaying = false; + this.noLoop(); + this.tatums = bLength || 0.0625; + // defaults to quarter note + this.metro = new p5.Metro(); + this.metro._init(); + this.metro.beatLength(this.tatums); + this.metro.setBPM(bpm); + p5sound.parts.push(this); + this.callback = function () { + }; + }; + /** + * Set the tempo of this part, in Beats Per Minute. + * + * @method setBPM + * @param {Number} BPM Beats Per Minute + * @param {Number} [rampTime] Seconds from now + */ + p5.Part.prototype.setBPM = function (tempo, rampTime) { + this.metro.setBPM(tempo, rampTime); + }; + /** + * Returns the Beats Per Minute of this currently part. + * + * @method getBPM + * @return {Number} + */ + p5.Part.prototype.getBPM = function () { + return this.metro.getBPM(); + }; + /** + * Start playback of this part. It will play + * through all of its phrases at a speed + * determined by setBPM. + * + * @method start + * @param {Number} [time] seconds from now + */ + p5.Part.prototype.start = function (time) { + if (!this.isPlaying) { + this.isPlaying = true; + this.metro.resetSync(this); + var t = time || 0; + this.metro.start(t); + } + }; + /** + * Loop playback of this part. It will begin + * looping through all of its phrases at a speed + * determined by setBPM. + * + * @method loop + * @param {Number} [time] seconds from now + */ + p5.Part.prototype.loop = function (time) { + this.looping = true; + // rest onended function + this.onended = function () { + this.partStep = 0; + }; + var t = time || 0; + this.start(t); + }; + /** + * Tell the part to stop looping. + * + * @method noLoop + */ + p5.Part.prototype.noLoop = function () { + this.looping = false; + // rest onended function + this.onended = function () { + this.stop(); + }; + }; + /** + * Stop the part and cue it to step 0. + * + * @method stop + * @param {Number} [time] seconds from now + */ + p5.Part.prototype.stop = function (time) { + this.partStep = 0; + this.pause(time); + }; + /** + * Pause the part. Playback will resume + * from the current step. + * + * @method pause + * @param {Number} time seconds from now + */ + p5.Part.prototype.pause = function (time) { + this.isPlaying = false; + var t = time || 0; + this.metro.stop(t); + }; + /** + * Add a p5.Phrase to this Part. + * + * @method addPhrase + * @param {p5.Phrase} phrase reference to a p5.Phrase + */ + p5.Part.prototype.addPhrase = function (name, callback, array) { + var p; + if (arguments.length === 3) { + p = new p5.Phrase(name, callback, array); + } else if (arguments[0] instanceof p5.Phrase) { + p = arguments[0]; + } else { + throw 'invalid input. addPhrase accepts name, callback, array or a p5.Phrase'; + } + this.phrases.push(p); + // reset the length if phrase is longer than part's existing length + if (p.sequence.length > this.length) { + this.length = p.sequence.length; + } + }; + /** + * Remove a phrase from this part, based on the name it was + * given when it was created. + * + * @method removePhrase + * @param {String} phraseName + */ + p5.Part.prototype.removePhrase = function (name) { + for (var i in this.phrases) { + if (this.phrases[i].name === name) { + this.phrases.splice(i, 1); + } + } + }; + /** + * Get a phrase from this part, based on the name it was + * given when it was created. Now you can modify its array. + * + * @method getPhrase + * @param {String} phraseName + */ + p5.Part.prototype.getPhrase = function (name) { + for (var i in this.phrases) { + if (this.phrases[i].name === name) { + return this.phrases[i]; + } + } + }; + /** + * Get a phrase from this part, based on the name it was + * given when it was created. Now you can modify its array. + * + * @method replaceSequence + * @param {String} phraseName + * @param {Array} sequence Array of values to pass into the callback + * at each step of the phrase. + */ + p5.Part.prototype.replaceSequence = function (name, array) { + for (var i in this.phrases) { + if (this.phrases[i].name === name) { + this.phrases[i].sequence = array; + } + } + }; + p5.Part.prototype.incrementStep = function (time) { + if (this.partStep < this.length - 1) { + this.callback(time); + this.partStep += 1; + } else { + if (!this.looping && this.partStep == this.length - 1) { + console.log('done'); + // this.callback(time); + this.onended(); + } + } + }; + /** + * Fire a callback function at every step. + * + * @method onStep + * @param {Function} callback The name of the callback + * you want to fire + * on every beat/tatum. + */ + p5.Part.prototype.onStep = function (callback) { + this.callback = callback; + }; + // =============== + // p5.Score + // =============== + /** + * A Score consists of a series of Parts. The parts will + * be played back in order. For example, you could have an + * A part, a B part, and a C part, and play them back in this order + * new p5.Score(a, a, b, a, c) + * + * @class p5.Score + * @constructor + * @param {p5.Part} part(s) One or multiple parts, to be played in sequence. + * @return {p5.Score} + */ + p5.Score = function () { + // for all of the arguments + this.parts = []; + this.currentPart = 0; + var thisScore = this; + for (var i in arguments) { + this.parts[i] = arguments[i]; + this.parts[i].nextPart = this.parts[i + 1]; + this.parts[i].onended = function () { + thisScore.resetPart(i); + playNextPart(thisScore); + }; + } + this.looping = false; + }; + p5.Score.prototype.onended = function () { + if (this.looping) { + // this.resetParts(); + this.parts[0].start(); + } else { + this.parts[this.parts.length - 1].onended = function () { + this.stop(); + this.resetParts(); + }; + } + this.currentPart = 0; + }; + /** + * Start playback of the score. + * + * @method start + */ + p5.Score.prototype.start = function () { + this.parts[this.currentPart].start(); + this.scoreStep = 0; + }; + /** + * Stop playback of the score. + * + * @method stop + */ + p5.Score.prototype.stop = function () { + this.parts[this.currentPart].stop(); + this.currentPart = 0; + this.scoreStep = 0; + }; + /** + * Pause playback of the score. + * + * @method pause + */ + p5.Score.prototype.pause = function () { + this.parts[this.currentPart].stop(); + }; + /** + * Loop playback of the score. + * + * @method loop + */ + p5.Score.prototype.loop = function () { + this.looping = true; + this.start(); + }; + /** + * Stop looping playback of the score. If it + * is currently playing, this will go into effect + * after the current round of playback completes. + * + * @method noLoop + */ + p5.Score.prototype.noLoop = function () { + this.looping = false; + }; + p5.Score.prototype.resetParts = function () { + for (var i in this.parts) { + this.resetPart(i); + } + }; + p5.Score.prototype.resetPart = function (i) { + this.parts[i].stop(); + this.parts[i].partStep = 0; + for (var p in this.parts[i].phrases) { + this.parts[i].phrases[p].phraseStep = 0; + } + }; + /** + * Set the tempo for all parts in the score + * + * @param {Number} BPM Beats Per Minute + * @param {Number} rampTime Seconds from now + */ + p5.Score.prototype.setBPM = function (bpm, rampTime) { + for (var i in this.parts) { + this.parts[i].setBPM(bpm, rampTime); + } + }; + function playNextPart(aScore) { + aScore.currentPart++; + if (aScore.currentPart >= aScore.parts.length) { + aScore.scoreStep = 0; + aScore.onended(); + } else { + aScore.scoreStep = 0; + aScore.parts[aScore.currentPart - 1].stop(); + aScore.parts[aScore.currentPart].start(); + } + } +}(master); +var soundRecorder; +soundRecorder = function () { + 'use strict'; + var p5sound = master; + var ac = p5sound.audiocontext; + /** + *

Record sounds for playback and/or to save as a .wav file. + * The p5.SoundRecorder records all sound output from your sketch, + * or can be assigned a specific source with setInput().

+ *

The record() method accepts a p5.SoundFile as a parameter. + * When playback is stopped (either after the given amount of time, + * or with the stop() method), the p5.SoundRecorder will send its + * recording to that p5.SoundFile for playback.

+ * + * @class p5.SoundRecorder + * @constructor + * @example + *
+ * var mic, recorder, soundFile; + * var state = 0; + * + * function setup() { + * background(200); + * // create an audio in + * mic = new p5.AudioIn(); + * + * // prompts user to enable their browser mic + * mic.start(); + * + * // create a sound recorder + * recorder = new p5.SoundRecorder(); + * + * // connect the mic to the recorder + * recorder.setInput(mic); + * + * // this sound file will be used to + * // playback & save the recording + * soundFile = new p5.SoundFile(); + * + * text('keyPress to record', 20, 20); + * } + * + * function keyPressed() { + * // make sure user enabled the mic + * if (state === 0 && mic.enabled) { + * + * // record to our p5.SoundFile + * recorder.record(soundFile); + * + * background(255,0,0); + * text('Recording!', 20, 20); + * state++; + * } + * else if (state === 1) { + * background(0,255,0); + * + * // stop recorder and + * // send result to soundFile + * recorder.stop(); + * + * text('Stopped', 20, 20); + * state++; + * } + * + * else if (state === 2) { + * soundFile.play(); // play the result! + * save(soundFile, 'mySound.wav'); + * state++; + * } + * } + *
+ */ + p5.SoundRecorder = function () { + this.input = ac.createGain(); + this.output = ac.createGain(); + this.recording = false; + this.bufferSize = 1024; + this._channels = 2; + // stereo (default) + this._clear(); + // initialize variables + this._jsNode = ac.createScriptProcessor(this.bufferSize, this._channels, 2); + this._jsNode.onaudioprocess = this._audioprocess.bind(this); + /** + * callback invoked when the recording is over + * @private + * @type {function(Float32Array)} + */ + this._callback = function () { + }; + // connections + this._jsNode.connect(p5.soundOut._silentNode); + this.setInput(); + // add this p5.SoundFile to the soundArray + p5sound.soundArray.push(this); + }; + /** + * Connect a specific device to the p5.SoundRecorder. + * If no parameter is given, p5.SoundRecorer will record + * all audible p5.sound from your sketch. + * + * @method setInput + * @param {Object} [unit] p5.sound object or a web audio unit + * that outputs sound + */ + p5.SoundRecorder.prototype.setInput = function (unit) { + this.input.disconnect(); + this.input = null; + this.input = ac.createGain(); + this.input.connect(this._jsNode); + this.input.connect(this.output); + if (unit) { + unit.connect(this.input); + } else { + p5.soundOut.output.connect(this.input); + } + }; + /** + * Start recording. To access the recording, provide + * a p5.SoundFile as the first parameter. The p5.SoundRecorder + * will send its recording to that p5.SoundFile for playback once + * recording is complete. Optional parameters include duration + * (in seconds) of the recording, and a callback function that + * will be called once the complete recording has been + * transfered to the p5.SoundFile. + * + * @method record + * @param {p5.SoundFile} soundFile p5.SoundFile + * @param {Number} [duration] Time (in seconds) + * @param {Function} [callback] The name of a function that will be + * called once the recording completes + */ + p5.SoundRecorder.prototype.record = function (sFile, duration, callback) { + this.recording = true; + if (duration) { + this.sampleLimit = Math.round(duration * ac.sampleRate); + } + if (sFile && callback) { + this._callback = function () { + this.buffer = this._getBuffer(); + sFile.setBuffer(this.buffer); + callback(); + }; + } else if (sFile) { + this._callback = function () { + this.buffer = this._getBuffer(); + sFile.setBuffer(this.buffer); + }; + } + }; + /** + * Stop the recording. Once the recording is stopped, + * the results will be sent to the p5.SoundFile that + * was given on .record(), and if a callback function + * was provided on record, that function will be called. + * + * @method stop + */ + p5.SoundRecorder.prototype.stop = function () { + this.recording = false; + this._callback(); + this._clear(); + }; + p5.SoundRecorder.prototype._clear = function () { + this._leftBuffers = []; + this._rightBuffers = []; + this.recordedSamples = 0; + this.sampleLimit = null; + }; + /** + * internal method called on audio process + * + * @private + * @param {AudioProcessorEvent} event + */ + p5.SoundRecorder.prototype._audioprocess = function (event) { + if (this.recording === false) { + return; + } else if (this.recording === true) { + // if we are past the duration, then stop... else: + if (this.sampleLimit && this.recordedSamples >= this.sampleLimit) { + this.stop(); + } else { + // get channel data + var left = event.inputBuffer.getChannelData(0); + var right = event.inputBuffer.getChannelData(1); + // clone the samples + this._leftBuffers.push(new Float32Array(left)); + this._rightBuffers.push(new Float32Array(right)); + this.recordedSamples += this.bufferSize; + } + } + }; + p5.SoundRecorder.prototype._getBuffer = function () { + var buffers = []; + buffers.push(this._mergeBuffers(this._leftBuffers)); + buffers.push(this._mergeBuffers(this._rightBuffers)); + return buffers; + }; + p5.SoundRecorder.prototype._mergeBuffers = function (channelBuffer) { + var result = new Float32Array(this.recordedSamples); + var offset = 0; + var lng = channelBuffer.length; + for (var i = 0; i < lng; i++) { + var buffer = channelBuffer[i]; + result.set(buffer, offset); + offset += buffer.length; + } + return result; + }; + p5.SoundRecorder.prototype.dispose = function () { + this._clear(); + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this._callback = function () { + }; + if (this.input) { + this.input.disconnect(); + } + this.input = null; + this._jsNode = null; + }; + /** + * Save a p5.SoundFile as a .wav audio file. + * + * @method saveSound + * @param {p5.SoundFile} soundFile p5.SoundFile that you wish to save + * @param {String} name name of the resulting .wav file. + */ + p5.prototype.saveSound = function (soundFile, name) { + var leftChannel, rightChannel; + leftChannel = soundFile.buffer.getChannelData(0); + // handle mono files + if (soundFile.buffer.numberOfChannels > 1) { + rightChannel = soundFile.buffer.getChannelData(1); + } else { + rightChannel = leftChannel; + } + var interleaved = interleave(leftChannel, rightChannel); + // create the buffer and view to create the .WAV file + var buffer = new ArrayBuffer(44 + interleaved.length * 2); + var view = new DataView(buffer); + // write the WAV container, + // check spec at: https://ccrma.stanford.edu/courses/422/projects/WaveFormat/ + // RIFF chunk descriptor + writeUTFBytes(view, 0, 'RIFF'); + view.setUint32(4, 36 + interleaved.length * 2, true); + writeUTFBytes(view, 8, 'WAVE'); + // FMT sub-chunk + writeUTFBytes(view, 12, 'fmt '); + view.setUint32(16, 16, true); + view.setUint16(20, 1, true); + // stereo (2 channels) + view.setUint16(22, 2, true); + view.setUint32(24, 44100, true); + view.setUint32(28, 44100 * 4, true); + view.setUint16(32, 4, true); + view.setUint16(34, 16, true); + // data sub-chunk + writeUTFBytes(view, 36, 'data'); + view.setUint32(40, interleaved.length * 2, true); + // write the PCM samples + var lng = interleaved.length; + var index = 44; + var volume = 1; + for (var i = 0; i < lng; i++) { + view.setInt16(index, interleaved[i] * (32767 * volume), true); + index += 2; + } + p5.prototype.writeFile([view], name, 'wav'); + }; + // helper methods to save waves + function interleave(leftChannel, rightChannel) { + var length = leftChannel.length + rightChannel.length; + var result = new Float32Array(length); + var inputIndex = 0; + for (var index = 0; index < length;) { + result[index++] = leftChannel[inputIndex]; + result[index++] = rightChannel[inputIndex]; + inputIndex++; + } + return result; + } + function writeUTFBytes(view, offset, string) { + var lng = string.length; + for (var i = 0; i < lng; i++) { + view.setUint8(offset + i, string.charCodeAt(i)); + } + } +}(sndcore, master); +var peakdetect; +peakdetect = function () { + 'use strict'; + var p5sound = master; + /** + *

PeakDetect works in conjunction with p5.FFT to + * look for onsets in some or all of the frequency spectrum. + *

+ *

+ * To use p5.PeakDetect, call update in the draw loop + * and pass in a p5.FFT object. + *

+ *

+ * You can listen for a specific part of the frequency spectrum by + * setting the range between freq1 and freq2. + *

+ * + *

threshold is the threshold for detecting a peak, + * scaled between 0 and 1. It is logarithmic, so 0.1 is half as loud + * as 1.0.

+ * + *

+ * The update method is meant to be run in the draw loop, and + * frames determines how many loops must pass before + * another peak can be detected. + * For example, if the frameRate() = 60, you could detect the beat of a + * 120 beat-per-minute song with this equation: + * framesPerPeak = 60 / (estimatedBPM / 60 ); + *

+ * + *

+ * Based on example contribtued by @b2renger, and a simple beat detection + * explanation by Felix Turner. + *

+ * + * @class p5.PeakDetect + * @constructor + * @param {Number} [freq1] lowFrequency - defaults to 20Hz + * @param {Number} [freq2] highFrequency - defaults to 20000 Hz + * @param {Number} [threshold] Threshold for detecting a beat between 0 and 1 + * scaled logarithmically where 0.1 is 1/2 the loudness + * of 1.0. Defaults to 0.35. + * @param {Number} [framesPerPeak] Defaults to 20. + * @example + *
+ * + * var cnv, soundFile, fft, peakDetect; + * var ellipseWidth = 10; + * + * function setup() { + * background(0); + * noStroke(); + * fill(255); + * textAlign(CENTER); + * + * soundFile = loadSound('assets/beat.mp3'); + * + * // p5.PeakDetect requires a p5.FFT + * fft = new p5.FFT(); + * peakDetect = new p5.PeakDetect(); + * + * } + * + * function draw() { + * background(0); + * text('click to play/pause', width/2, height/2); + * + * // peakDetect accepts an fft post-analysis + * fft.analyze(); + * peakDetect.update(fft); + * + * if ( peakDetect.isDetected ) { + * ellipseWidth = 50; + * } else { + * ellipseWidth *= 0.95; + * } + * + * ellipse(width/2, height/2, ellipseWidth, ellipseWidth); + * } + * + * // toggle play/stop when canvas is clicked + * function mouseClicked() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * if (soundFile.isPlaying() ) { + * soundFile.stop(); + * } else { + * soundFile.play(); + * } + * } + * } + *
+ */ + p5.PeakDetect = function (freq1, freq2, threshold, _framesPerPeak) { + var framesPerPeak; + // framesPerPeak determines how often to look for a beat. + // If a beat is provided, try to look for a beat based on bpm + this.framesPerPeak = _framesPerPeak || 20; + this.framesSinceLastPeak = 0; + this.decayRate = 0.95; + this.threshold = threshold || 0.35; + this.cutoff = 0; + // how much to increase the cutoff + // TO DO: document this / figure out how to make it accessible + this.cutoffMult = 1.5; + this.energy = 0; + this.penergy = 0; + // TO DO: document this property / figure out how to make it accessible + this.currentValue = 0; + /** + * isDetected is set to true when a peak is detected. + * + * @attribute isDetected + * @type {Boolean} + * @default false + */ + this.isDetected = false; + this.f1 = freq1 || 40; + this.f2 = freq2 || 20000; + // function to call when a peak is detected + this._onPeak = function () { + }; + }; + /** + * The update method is run in the draw loop. + * + * Accepts an FFT object. You must call .analyze() + * on the FFT object prior to updating the peakDetect + * because it relies on a completed FFT analysis. + * + * @method update + * @param {p5.FFT} fftObject A p5.FFT object + */ + p5.PeakDetect.prototype.update = function (fftObject) { + var nrg = this.energy = fftObject.getEnergy(this.f1, this.f2) / 255; + if (nrg > this.cutoff && nrg > this.threshold && nrg - this.penergy > 0) { + // trigger callback + this._onPeak(); + this.isDetected = true; + // debounce + this.cutoff = nrg * this.cutoffMult; + this.framesSinceLastPeak = 0; + } else { + this.isDetected = false; + if (this.framesSinceLastPeak <= this.framesPerPeak) { + this.framesSinceLastPeak++; + } else { + this.cutoff *= this.decayRate; + this.cutoff = Math.max(this.cutoff, this.threshold); + } + } + this.currentValue = nrg; + this.penergy = nrg; + }; + /** + * onPeak accepts two arguments: a function to call when + * a peak is detected. The value of the peak, + * between 0.0 and 1.0, is passed to the callback. + * + * @method onPeak + * @param {Function} callback Name of a function that will + * be called when a peak is + * detected. + * @param {Object} [val] Optional value to pass + * into the function when + * a peak is detected. + * @example + *
+ * var cnv, soundFile, fft, peakDetect; + * var ellipseWidth = 0; + * + * function setup() { + * cnv = createCanvas(100,100); + * textAlign(CENTER); + * + * soundFile = loadSound('assets/beat.mp3'); + * fft = new p5.FFT(); + * peakDetect = new p5.PeakDetect(); + * + * setupSound(); + * + * // when a beat is detected, call triggerBeat() + * peakDetect.onPeak(triggerBeat); + * } + * + * function draw() { + * background(0); + * fill(255); + * text('click to play', width/2, height/2); + * + * fft.analyze(); + * peakDetect.update(fft); + * + * ellipseWidth *= 0.95; + * ellipse(width/2, height/2, ellipseWidth, ellipseWidth); + * } + * + * // this function is called by peakDetect.onPeak + * function triggerBeat() { + * ellipseWidth = 50; + * } + * + * // mouseclick starts/stops sound + * function setupSound() { + * cnv.mouseClicked( function() { + * if (soundFile.isPlaying() ) { + * soundFile.stop(); + * } else { + * soundFile.play(); + * } + * }); + * } + *
+ */ + p5.PeakDetect.prototype.onPeak = function (callback, val) { + var self = this; + self._onPeak = function () { + callback(self.energy, val); + }; + }; +}(master); +var gain; +gain = function () { + 'use strict'; + var p5sound = master; + /** + * A gain node is usefull to set the relative volume of sound. + * It's typically used to build mixers. + * + * @class p5.Gain + * @constructor + * @example + *
+ * + * // load two soundfile and crossfade beetween them + * var sound1,sound2; + * var gain1, gain2, gain3; + * + * function preload(){ + * soundFormats('ogg', 'mp3'); + * sound1 = loadSound('../_files/Damscray_-_Dancing_Tiger_01'); + * sound2 = loadSound('../_files/beat.mp3'); + * } + * + * function setup() { + * createCanvas(400,200); + * + * // create a 'master' gain to which we will connect both soundfiles + * gain3 = new p5.Gain(); + * gain3.connect(); + * + * // setup first sound for playing + * sound1.rate(1); + * sound1.loop(); + * sound1.disconnect(); // diconnect from p5 output + * + * gain1 = new p5.Gain(); // setup a gain node + * gain1.setInput(sound1); // connect the first sound to its input + * gain1.connect(gain3); // connect its output to the 'master' + * + * sound2.rate(1); + * sound2.disconnect(); + * sound2.loop(); + * + * gain2 = new p5.Gain(); + * gain2.setInput(sound2); + * gain2.connect(gain3); + * + * } + * + * function draw(){ + * background(180); + * + * // calculate the horizontal distance beetween the mouse and the right of the screen + * var d = dist(mouseX,0,width,0); + * + * // map the horizontal position of the mouse to values useable for volume control of sound1 + * var vol1 = map(mouseX,0,width,0,1); + * var vol2 = 1-vol1; // when sound1 is loud, sound2 is quiet and vice versa + * + * gain1.amp(vol1,0.5,0); + * gain2.amp(vol2,0.5,0); + * + * // map the vertical position of the mouse to values useable for 'master volume control' + * var vol3 = map(mouseY,0,height,0,1); + * gain3.amp(vol3,0.5,0); + * } + *
+ * + */ + p5.Gain = function () { + this.ac = p5sound.audiocontext; + this.input = this.ac.createGain(); + this.output = this.ac.createGain(); + // otherwise, Safari distorts + this.input.gain.value = 0.5; + this.input.connect(this.output); + // add to the soundArray + p5sound.soundArray.push(this); + }; + /** + * Connect a source to the gain node. + * + * @method setInput + * @param {Object} src p5.sound / Web Audio object with a sound + * output. + */ + p5.Gain.prototype.setInput = function (src) { + src.connect(this.input); + }; + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + p5.Gain.prototype.connect = function (unit) { + var u = unit || p5.soundOut.input; + this.output.connect(u.input ? u.input : u); + }; + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Gain.prototype.disconnect = function () { + this.output.disconnect(); + }; + /** + * Set the output level of the gain node. + * + * @method amp + * @param {Number} volume amplitude between 0 and 1.0 + * @param {Number} [rampTime] create a fade that lasts rampTime + * @param {Number} [timeFromNow] schedule this event to happen + * seconds from now + */ + p5.Gain.prototype.amp = function (vol, rampTime, tFromNow) { + var rampTime = rampTime || 0; + var tFromNow = tFromNow || 0; + var now = p5sound.audiocontext.currentTime; + var currentVol = this.output.gain.value; + this.output.gain.cancelScheduledValues(now); + this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); + this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); + }; + p5.Gain.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.output.disconnect(); + this.input.disconnect(); + this.output = undefined; + this.input = undefined; + }; +}(master, sndcore); +var distortion; +distortion = function () { + 'use strict'; + var p5sound = master; + /* + * Adapted from [Kevin Ennis on StackOverflow](http://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion) + */ + function makeDistortionCurve(amount) { + var k = typeof amount === 'number' ? amount : 50; + var n_samples = 44100; + var curve = new Float32Array(n_samples); + var deg = Math.PI / 180; + var i = 0; + var x; + for (; i < n_samples; ++i) { + x = i * 2 / n_samples - 1; + curve[i] = (3 + k) * x * 20 * deg / (Math.PI + k * Math.abs(x)); + } + return curve; + } + /** + * A Distortion effect created with a Waveshaper Node, + * with an approach adapted from + * [Kevin Ennis](http://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion) + * + * @class p5.Distortion + * @constructor + * @param {Number} [amount=0.25] Unbounded distortion amount. + * Normal values range from 0-1. + * @param {String} [oversample='none'] 'none', '2x', or '4x'. + * + * @return {Object} Distortion object + */ + p5.Distortion = function (amount, oversample) { + if (typeof amount === 'undefined') { + amount = 0.25; + } + if (typeof amount !== 'number') { + throw new Error('amount must be a number'); + } + if (typeof oversample === 'undefined') { + oversample = '2x'; + } + if (typeof oversample !== 'string') { + throw new Error('oversample must be a String'); + } + var curveAmount = p5.prototype.map(amount, 0, 1, 0, 2000); + this.ac = p5sound.audiocontext; + this.input = this.ac.createGain(); + this.output = this.ac.createGain(); + /** + * The p5.Distortion is built with a + * + * Web Audio WaveShaper Node. + * + * @property WaveShaperNode + * @type {Object} AudioNode + */ + this.waveShaperNode = this.ac.createWaveShaper(); + this.amount = curveAmount; + this.waveShaperNode.curve = makeDistortionCurve(curveAmount); + this.waveShaperNode.oversample = oversample; + this.input.connect(this.waveShaperNode); + this.waveShaperNode.connect(this.output); + this.connect(); + // add to the soundArray + p5sound.soundArray.push(this); + }; + p5.Distortion.prototype.process = function (src, amount, oversample) { + src.connect(this.input); + this.set(amount, oversample); + }; + /** + * Set the amount and oversample of the waveshaper distortion. + * + * @method setType + * @param {Number} [amount=0.25] Unbounded distortion amount. + * Normal values range from 0-1. + * @param {String} [oversample='none'] 'none', '2x', or '4x'. + */ + p5.Distortion.prototype.set = function (amount, oversample) { + if (amount) { + var curveAmount = p5.prototype.map(amount, 0, 1, 0, 2000); + this.amount = curveAmount; + this.waveShaperNode.curve = makeDistortionCurve(curveAmount); + } + if (oversample) { + this.waveShaperNode.oversample = oversample; + } + }; + /** + * Return the distortion amount, typically between 0-1. + * + * @method getAmount + * @return {Number} Unbounded distortion amount. + * Normal values range from 0-1. + */ + p5.Distortion.prototype.getAmount = function () { + return this.amount; + }; + /** + * Return the oversampling. + * + * @return {String} Oversample can either be 'none', '2x', or '4x'. + */ + p5.Distortion.prototype.getOversample = function () { + return this.waveShaperNode.oversample; + }; + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + p5.Distortion.prototype.connect = function (unit) { + var u = unit || p5.soundOut.input; + this.output.connect(u); + }; + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Distortion.prototype.disconnect = function () { + this.output.disconnect(); + }; + p5.Distortion.prototype.dispose = function () { + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.input.disconnect(); + this.waveShaperNode.disconnect(); + this.input = null; + this.waveShaperNode = null; + if (typeof this.output !== 'undefined') { + this.output.disconnect(); + this.output = null; + } + }; +}(master); +var src_app; +src_app = function () { + 'use strict'; + var p5SOUND = sndcore; + return p5SOUND; +}(sndcore, master, helpers, errorHandler, panner, soundfile, amplitude, fft, signal, oscillator, env, pulse, noise, audioin, filter, delay, reverb, metro, looper, soundRecorder, peakdetect, gain, distortion); +})); diff --git a/examples/neuroevolution-flappybird-1/pipe.js b/examples/neuroevolution-flappybird-1/pipe.js new file mode 100644 index 0000000..1907eb1 --- /dev/null +++ b/examples/neuroevolution-flappybird-1/pipe.js @@ -0,0 +1,56 @@ +// Daniel Shiffman +// Nature of Code: Intelligence and Learning +// https://github.com/shiffman/NOC-S17-2-Intelligence-Learning + +// This flappy bird implementation is adapted from: +// https://youtu.be/cXgA1d_E-jY& + +function Pipe() { + + // How big is the empty space + var spacing = random(80, height / 2); + // Where is th center of the empty space + var centery = random(spacing, height - spacing); + + // Top and bottom of pipe + this.top = centery - spacing / 2; + this.bottom = height - (centery + spacing / 2); + // Starts at the edge + this.x = width; + // Width of pipe + this.w = 50; + // How fast + this.speed = 4; + + // Did this pipe hit a bird? + this.hits = function(bird) { + if ((bird.y - bird.r) < this.top || (bird.y + bird.r) > (height - this.bottom)) { + if (bird.x > this.x && bird.x < this.x + this.w) { + return true; + } + } + return false; + } + + // Draw the pipe + this.show = function() { + stroke(255); + fill(200); + rect(this.x, 0, this.w, this.top); + rect(this.x, height - this.bottom, this.w, this.bottom); + } + + // Update the pipe + this.update = function() { + this.x -= this.speed; + } + + // Has it moved offscreen? + this.offscreen = function() { + if (this.x < -this.w) { + return true; + } else { + return false; + } + } +} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-1/sketch.js b/examples/neuroevolution-flappybird-1/sketch.js new file mode 100644 index 0000000..bff3fc0 --- /dev/null +++ b/examples/neuroevolution-flappybird-1/sketch.js @@ -0,0 +1,170 @@ +// Daniel Shiffman +// Nature of Code: Intelligence and Learning +// https://github.com/shiffman/NOC-S17-2-Intelligence-Learning + +// This flappy bird implementation is adapted from: +// https://youtu.be/cXgA1d_E-jY& + +// How big is the population +var totalPopulation = 250; +// All active birds (not yet collided with pipe) +var activeBirds = []; +// All birds for any given population +var allBirds = []; +// Pipes +var pipes = []; +// A frame counter to determine when to add a pipe +var counter = 0; + +// Interface elements +var speedSlider; +var speedSpan; +var highScoreSpan; +var allTimeHighScoreSpan; + +// All time high score +var highScore = 0; + +// Training or just showing the current best +var runBest = false; +var runBestButton; + +function setup() { + var canvas = createCanvas(600, 400); + canvas.parent('canvascontainer'); + + // Access the interface elements + speedSlider = select('#speedSlider'); + speedSpan = select('#speed'); + highScoreSpan = select('#hs'); + allTimeHighScoreSpan = select('#ahs'); + runBestButton = select('#best'); + runBestButton.mousePressed(toggleState); + + // Create a population + for (var i = 0; i < totalPopulation; i++) { + var bird = new Bird(); + activeBirds[i] = bird; + allBirds[i] = bird; + } +} + +// Toggle the state of the simulation +function toggleState() { + runBest = !runBest; + // Show the best bird + if (runBest) { + resetGame(); + bestBird.score = 0; + runBestButton.html('continue training'); + // Go train some more + } else { + nextGeneration(); + runBestButton.html('run best'); + } +} + + + +function draw() { + background(0); + + // Should we speed up cycles per frame + var cycles = speedSlider.value(); + speedSpan.html(cycles); + + + // How many times to advance the game + for (var n = 0; n < cycles; n++) { + // Show all the pipes + for (var i = pipes.length - 1; i >= 0; i--) { + pipes[i].update(); + if (pipes[i].offscreen()) { + pipes.splice(i, 1); + } + } + // Are we just running the best bird + if (runBest) { + bestBird.think(pipes); + bestBird.update(); + for (var j = 0; j < pipes.length; j++) { + // Start over, bird hit pipe + if (pipes[j].hits(bestBird)) { + resetGame(); + break; + } + } + // Or are we running all the active birds + } else { + for (var i = activeBirds.length - 1; i >= 0; i--) { + var bird = activeBirds[i]; + // Bird uses its brain! + bird.think(pipes); + bird.update(); + // Check all the pipes + for (var j = 0; j < pipes.length; j++) { + // It's hit a pipe + if (pipes[j].hits(activeBirds[i])) { + // Remove this bird + activeBirds.splice(i, 1); + break; + } + } + } + } + + // Add a new pipe every so often + if (counter % 75 == 0) { + pipes.push(new Pipe()); + } + counter++; + } + + // What is highest score of the current population + var tempHighScore = 0; + // If we're training + if (!runBest) { + // Which is the best bird? + var tempBestBird = null; + for (var i = 0; i < activeBirds.length; i++) { + var s = activeBirds[i].score; + if (s > tempHighScore) { + tempHighScore = s; + tempBestBird = activeBirds[i]; + } + } + + // Is it the all time high scorer? + if (tempHighScore > highScore) { + highScore = tempHighScore; + bestBird = tempBestBird; + } + } else { + // Just one bird, the best one so far + tempHighScore = bestBird.score; + if (tempHighScore > highScore) { + highScore = tempHighScore; + } + } + + // Update DOM Elements + highScoreSpan.html(tempHighScore); + allTimeHighScoreSpan.html(highScore); + + // Draw everything! + for (var i = 0; i < pipes.length; i++) { + pipes[i].show(); + } + + if (runBest) { + bestBird.show(); + } else { + for (var i = 0; i < activeBirds.length; i++) { + activeBirds[i].show(); + } + // If we're out of birds go to the next generation + if (activeBirds.length == 0) { + nextGeneration(); + } + } +} diff --git a/examples/neuroevolution-flappybird/bird.js b/examples/neuroevolution-flappybird-2/bird.js similarity index 100% rename from examples/neuroevolution-flappybird/bird.js rename to examples/neuroevolution-flappybird-2/bird.js diff --git a/examples/neuroevolution-flappybird/ga.js b/examples/neuroevolution-flappybird-2/ga.js similarity index 100% rename from examples/neuroevolution-flappybird/ga.js rename to examples/neuroevolution-flappybird-2/ga.js diff --git a/examples/neuroevolution-flappybird/graphics/background.png b/examples/neuroevolution-flappybird-2/graphics/background.png similarity index 100% rename from examples/neuroevolution-flappybird/graphics/background.png rename to examples/neuroevolution-flappybird-2/graphics/background.png diff --git a/examples/neuroevolution-flappybird/graphics/horn_body_filled.png b/examples/neuroevolution-flappybird-2/graphics/horn_body_filled.png similarity index 100% rename from examples/neuroevolution-flappybird/graphics/horn_body_filled.png rename to examples/neuroevolution-flappybird-2/graphics/horn_body_filled.png diff --git a/examples/neuroevolution-flappybird/graphics/horn_tip_filled.png b/examples/neuroevolution-flappybird-2/graphics/horn_tip_filled.png similarity index 100% rename from examples/neuroevolution-flappybird/graphics/horn_tip_filled.png rename to examples/neuroevolution-flappybird-2/graphics/horn_tip_filled.png diff --git a/examples/neuroevolution-flappybird/graphics/pipe_body.png b/examples/neuroevolution-flappybird-2/graphics/pipe_body.png similarity index 100% rename from examples/neuroevolution-flappybird/graphics/pipe_body.png rename to examples/neuroevolution-flappybird-2/graphics/pipe_body.png diff --git a/examples/neuroevolution-flappybird/graphics/pipe_marshmallow.png b/examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow.png similarity index 100% rename from examples/neuroevolution-flappybird/graphics/pipe_marshmallow.png rename to examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow.png diff --git a/examples/neuroevolution-flappybird/graphics/pipe_marshmallow_fix.png b/examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow_fix.png similarity index 100% rename from examples/neuroevolution-flappybird/graphics/pipe_marshmallow_fix.png rename to examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow_fix.png diff --git a/examples/neuroevolution-flappybird/graphics/train.png b/examples/neuroevolution-flappybird-2/graphics/train.png similarity index 100% rename from examples/neuroevolution-flappybird/graphics/train.png rename to examples/neuroevolution-flappybird-2/graphics/train.png diff --git a/examples/neuroevolution-flappybird/index.html b/examples/neuroevolution-flappybird-2/index.html similarity index 99% rename from examples/neuroevolution-flappybird/index.html rename to examples/neuroevolution-flappybird-2/index.html index 1e5db9b..7481ad5 100644 --- a/examples/neuroevolution-flappybird/index.html +++ b/examples/neuroevolution-flappybird-2/index.html @@ -25,4 +25,4 @@

- \ No newline at end of file + diff --git a/examples/neuroevolution-flappybird/pipe.js b/examples/neuroevolution-flappybird-2/pipe.js similarity index 100% rename from examples/neuroevolution-flappybird/pipe.js rename to examples/neuroevolution-flappybird-2/pipe.js diff --git a/examples/neuroevolution-flappybird/sketch.js b/examples/neuroevolution-flappybird-2/sketch.js similarity index 99% rename from examples/neuroevolution-flappybird/sketch.js rename to examples/neuroevolution-flappybird-2/sketch.js index 642eb61..2ccb33a 100644 --- a/examples/neuroevolution-flappybird/sketch.js +++ b/examples/neuroevolution-flappybird-2/sketch.js @@ -58,7 +58,7 @@ function preload() { function setup() { - let canvas = createCanvas(600, 600); + let canvas = createCanvas(600, 400); canvas.parent('canvascontainer'); // Access the interface elements From 00dcb4b0f8bb071f260e3b4d68eeea4444fd9347 Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Sun, 15 Apr 2018 16:39:31 -0400 Subject: [PATCH 12/29] neuroevolution flappy example --- examples/neuro-evolution/index.html | 12 - .../neuro-evolution/libraries/p5.dom.min.js | 1 - examples/neuro-evolution/libraries/p5.min.js | 13 - examples/neuro-evolution/sketch.js | 12 - examples/neuroevolution-flappybird-1/bird.js | 103 - .../neuroevolution-flappybird-1/index.html | 30 - .../libraries/p5.dom.js | 2190 - .../libraries/p5.js | 35126 ---------------- .../libraries/p5.sound.js | 9336 ---- examples/neuroevolution-flappybird-2/bird.js | 103 - examples/neuroevolution-flappybird-2/ga.js | 81 - .../graphics/background.png | Bin 235935 -> 0 bytes .../graphics/horn_body_filled.png | Bin 31514 -> 0 bytes .../graphics/horn_tip_filled.png | Bin 25760 -> 0 bytes .../graphics/pipe_body.png | Bin 7481 -> 0 bytes .../graphics/pipe_marshmallow.png | Bin 23812 -> 0 bytes .../graphics/pipe_marshmallow_fix.png | Bin 20787 -> 0 bytes .../graphics/train.png | Bin 29665 -> 0 bytes examples/neuroevolution-flappybird-2/pipe.js | 76 - .../neuroevolution-flappybird-2/sketch.js | 238 - examples/neuroevolution-flappybird/bird.js | 114 + .../ga.js | 24 +- .../index.html | 4 +- .../pipe.js | 42 +- .../sketch.js | 73 +- lib/nn.js | 22 +- 26 files changed, 200 insertions(+), 47400 deletions(-) delete mode 100755 examples/neuro-evolution/index.html delete mode 100644 examples/neuro-evolution/libraries/p5.dom.min.js delete mode 100644 examples/neuro-evolution/libraries/p5.min.js delete mode 100644 examples/neuro-evolution/sketch.js delete mode 100644 examples/neuroevolution-flappybird-1/bird.js delete mode 100755 examples/neuroevolution-flappybird-1/index.html delete mode 100644 examples/neuroevolution-flappybird-1/libraries/p5.dom.js delete mode 100644 examples/neuroevolution-flappybird-1/libraries/p5.js delete mode 100644 examples/neuroevolution-flappybird-1/libraries/p5.sound.js delete mode 100644 examples/neuroevolution-flappybird-2/bird.js delete mode 100644 examples/neuroevolution-flappybird-2/ga.js delete mode 100644 examples/neuroevolution-flappybird-2/graphics/background.png delete mode 100644 examples/neuroevolution-flappybird-2/graphics/horn_body_filled.png delete mode 100644 examples/neuroevolution-flappybird-2/graphics/horn_tip_filled.png delete mode 100644 examples/neuroevolution-flappybird-2/graphics/pipe_body.png delete mode 100644 examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow.png delete mode 100644 examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow_fix.png delete mode 100644 examples/neuroevolution-flappybird-2/graphics/train.png delete mode 100644 examples/neuroevolution-flappybird-2/pipe.js delete mode 100644 examples/neuroevolution-flappybird-2/sketch.js create mode 100644 examples/neuroevolution-flappybird/bird.js rename examples/{neuroevolution-flappybird-1 => neuroevolution-flappybird}/ga.js (81%) rename examples/{neuroevolution-flappybird-2 => neuroevolution-flappybird}/index.html (98%) mode change 100644 => 100755 rename examples/{neuroevolution-flappybird-1 => neuroevolution-flappybird}/pipe.js (59%) rename examples/{neuroevolution-flappybird-1 => neuroevolution-flappybird}/sketch.js (72%) diff --git a/examples/neuro-evolution/index.html b/examples/neuro-evolution/index.html deleted file mode 100755 index 8caf295..0000000 --- a/examples/neuro-evolution/index.html +++ /dev/null @@ -1,12 +0,0 @@ - - - - - - - - - - - - diff --git a/examples/neuro-evolution/libraries/p5.dom.min.js b/examples/neuro-evolution/libraries/p5.dom.min.js deleted file mode 100644 index ece75c0..0000000 --- a/examples/neuro-evolution/libraries/p5.dom.min.js +++ /dev/null @@ -1 +0,0 @@ -/*! p5.js v0.6.0 January 19, 2018 */ !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,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 d(a,b,d,e){var f=document.createElement(b);"string"==typeof(d=d||"")&&(d=[d]);for(var g=0;g0&&c.every(function(a){return"INPUT"===a.tagName||"LABEL"===a.tagName})?this.createRadio(new a.Element(b)):new a.Element(b)},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.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,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};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;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)},{}],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(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=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)we[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 ne;for(a.sourceIndex+=4,d=b;d;--d)a.dest[a.destLen++]=a.source[a.sourceIndex++];return a.bitcount=0,me}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,oe,pe);break;case 2:l(f,f.ltree,f.dtree),e=m(f,f.ltree,f.dtree);break;default:e=ne}if(e!==me)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 Ne.Parser(c,d+e+14),h=new Ne.Parser(c,d+e+16+2*f),i=new Ne.Parser(c,d+e+16+4*f),j=new Ne.Parser(c,d+e+16+6*f),k=d+e+16+8*f,l=0;l=0;e-=1){var f=Ne.getUShort(a,b+4+8*e),g=Ne.getUShort(a,b+4+8*e+2);if(3===f&&(0===g||1===g||10===g)){d=Ne.getULong(a,b+4+8*e+4);break}}if(-1===d)throw new Error("No valid cmap sub-tables found.");var h=new Ne.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})}function V(a){a.segments.push({end:65535,start:65535,delta:1,offset:0})}function W(a){var b=new Ke.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}]);b.segments=[];for(var c=0;c0?(f=a.parseByte(),0==(b&e)&&(f=-f),f=c+f):f=(b&e)>0?c:c+a.parseShort(),f}function ca(a,b,c){var d=new Ne.Parser(b,c);a.numberOfContours=d.parseShort(),a._xMin=d.parseShort(),a._yMin=d.parseShort(),a._xMax=d.parseShort(),a._yMax=d.parseShort();var e,f;if(a.numberOfContours>0){for(var g=a.endPointIndices=[],h=0;h0)for(var l=d.parseByte(),m=0;m0){var n,o=[];if(j>0){for(var p=0;p=0,o.push(n);for(var q=0,r=0;r0?(2&e)>0?(v.dx=d.parseShort(),v.dy=d.parseShort()):v.matchedPoints=[d.parseUShort(),d.parseUShort()]:(2&e)>0?(v.dx=d.parseChar(),v.dy=d.parseChar()):v.matchedPoints=[d.parseByte(),d.parseByte()],(8&e)>0?v.xScale=v.yScale=d.parseF2Dot14():(64&e)>0?(v.xScale=d.parseF2Dot14(),v.yScale=d.parseF2Dot14()):(128&e)>0&&(v.xScale=d.parseF2Dot14(),v.scale01=d.parseF2Dot14(),v.scale10=d.parseF2Dot14(),v.yScale=d.parseF2Dot14()),a.components.push(v),u=!!(32&e)}if(256&e){a.instructionLength=d.parseUShort(),a.instructions=[];for(var w=0;wb.points.length-1||d.matchedPoints[1]>e.points.length-1)throw Error("Matched points out of range in "+b.name);var g=b.points[d.matchedPoints[0]],h=e.points[d.matchedPoints[1]],i={xScale:d.xScale,scale01:d.scale01,scale10:d.scale10,yScale:d.yScale,dx:0,dy:0};h=da([h],i)[0],i.dx=g.x-h.x,i.dy=g.y-h.y,f=da(e.points,i)}b.points=b.points.concat(f)}}return fa(b.points)}function ha(a,b,c,d){for(var e=new Ve.GlyphSet(d),f=0;f>4,g=15&e;if(f===c)break;if(b+=d[f],g===c)break;b+=d[g]}return parseFloat(b)}function ta(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 sa(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 ua(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 Fa(a,b,c,d){var e,f=[],g=new Ne.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+Pe.length:(c=Pe.length+b.length,b.push(a)),c}function Ia(){return new Ke.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 Ja(a){var b=new Ke.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 mb(a){return new Ke.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 nb(a,b){var c={},d=new Ne.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=Se.slice();break;case 2:c.numberOfGlyphs=d.parseUShort(),c.glyphNameIndex=new Array(c.numberOfGlyphs);for(var e=0;e=Se.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;hb.value.tag?1:-1}),b.fields=b.fields.concat(d),b.fields=b.fields.concat(e),b}function xb(a,b,c){for(var d=0;d0){return a.glyphs.get(e).getMetrics()}}return c}function yb(a){for(var b=0,c=0;cq||void 0===b)&&q>0&&(b=q),j 123 are reserved for internal usage");n|=1<0?af.make(G):void 0,J=nf.make(),K=Ye.make(a.glyphs,{version:a.getEnglishName("version"),fullName:C,familyName:A,weightName:B,postScriptName:D,unitsPerEm:a.unitsPerEm,fontBBox:[0,t.yMin,t.ascender,t.advanceWidthMax]}),L=a.metas&&Object.keys(a.metas).length>0?sf.make(a.metas):void 0,M=[u,v,w,x,H,z,J,K,y];I&&M.push(I),a.tables.gsub&&M.push(rf.make(a.tables.gsub)),L&&M.push(L);for(var N=wb(M),O=N.encode(),P=ub(O),Q=N.fields,R=!1,S=0;S>>1,f=a[e].tag;if(f===b)return e;f>>1,f=a[e];if(f===b)return e;f=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 Xb(b,c){a.DEBUG&&console.log(c.step,"SVTCA["+b.axis+"]"),c.fv=c.pv=c.dpv=b}function Yb(b,c){a.DEBUG&&console.log(c.step,"SPVTCA["+b.axis+"]"),c.pv=c.dpv=b}function Zb(b,c){a.DEBUG&&console.log(c.step,"SFVTCA["+b.axis+"]"),c.fv=b}function $b(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SPVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.pv=c.dpv=Sb(i,j)}function _b(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SFVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.fv=Sb(i,j)}function ac(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SPVFS[]",d,e),b.pv=b.dpv=Sb(e,d)}function bc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SPVFS[]",d,e),b.fv=Sb(e,d)}function cc(b){var c=b.stack,d=b.pv;a.DEBUG&&console.log(b.step,"GPV[]"),c.push(16384*d.x),c.push(16384*d.y)}function dc(b){var c=b.stack,d=b.fv;a.DEBUG&&console.log(b.step,"GFV[]"),c.push(16384*d.x),c.push(16384*d.y)}function ec(b){b.fv=b.pv,a.DEBUG&&console.log(b.step,"SFVTPV[]")}function fc(b){var c=b.stack,d=c.pop(),e=c.pop(),f=c.pop(),g=c.pop(),h=c.pop(),i=b.z0,j=b.z1,k=i[d],l=i[e],m=j[f],n=j[g],o=b.z2[h];a.DEBUG&&console.log("ISECT[], ",d,e,f,g,h);var p=k.x,q=k.y,r=l.x,s=l.y,t=m.x,u=m.y,v=n.x,w=n.y,x=(p-r)*(u-w)-(q-s)*(t-v),y=p*s-q*r,z=t*w-u*v;o.x=(y*(t-v)-z*(p-r))/x,o.y=(y*(u-w)-z*(q-s))/x}function gc(b){b.rp0=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP0[]",b.rp0)}function hc(b){b.rp1=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP1[]",b.rp1)}function ic(b){b.rp2=b.stack.pop(),a.DEBUG&&console.log(b.step,"SRP2[]",b.rp2)}function jc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP0[]",c),b.zp0=c,c){case 0:b.tZone||Vb(b),b.z0=b.tZone;break;case 1:b.z0=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function kc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP1[]",c),b.zp1=c,c){case 0:b.tZone||Vb(b),b.z1=b.tZone;break;case 1:b.z1=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function lc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZP2[]",c),b.zp2=c,c){case 0:b.tZone||Vb(b),b.z2=b.tZone;break;case 1:b.z2=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function mc(b){var c=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"SZPS[]",c),b.zp0=b.zp1=b.zp2=c,c){case 0:b.tZone||Vb(b),b.z0=b.z1=b.z2=b.tZone;break;case 1:b.z0=b.z1=b.z2=b.gZone;break;default:throw new Error("Invalid zone pointer")}}function nc(b){b.loop=b.stack.pop(),a.DEBUG&&console.log(b.step,"SLOOP[]",b.loop)}function oc(b){a.DEBUG&&console.log(b.step,"RTG[]"),b.round=Mb}function pc(b){a.DEBUG&&console.log(b.step,"RTHG[]"),b.round=Ob}function qc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SMD[]",c),b.minDis=c/64}function rc(b){a.DEBUG&&console.log(b.step,"ELSE[]"),Wb(b,!1)}function sc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"JMPR[]",c),b.ip+=c-1}function tc(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCVTCI[]",c),b.cvCutIn=c/64}function uc(b){var c=b.stack;a.DEBUG&&console.log(b.step,"DUP[]"),c.push(c[c.length-1])}function vc(b){a.DEBUG&&console.log(b.step,"POP[]"),b.stack.pop()}function wc(b){a.DEBUG&&console.log(b.step,"CLEAR[]"),b.stack.length=0}function xc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SWAP[]"),c.push(d),c.push(e)}function yc(b){var c=b.stack;a.DEBUG&&console.log(b.step,"DEPTH[]"),c.push(c.length)}function zc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"LOOPCALL[]",d,e);var f=b.ip,g=b.prog;b.prog=b.funcs[d];for(var h=0;h1?"loop "+(c.loop-i)+": ":"")+"SHP["+(b?"rp1":"rp2")+"]",k)}c.loop=1}function Hc(b,c){var d=c.stack,e=b?c.rp1:c.rp2,f=(b?c.z0:c.z1)[e],g=c.fv,h=c.pv,i=d.pop(),j=c.z2[c.contours[i]],k=j;a.DEBUG&&console.log(c.step,"SHC["+b+"]",i);var l=h.distance(f,f,!1,!0);do{k!==f&&g.setRelative(k,k,l,h),k=k.nextPointOnContour}while(k!==j)}function Ic(b,c){var d=c.stack,e=b?c.rp1:c.rp2,f=(b?c.z0:c.z1)[e],g=c.fv,h=c.pv,i=d.pop();a.DEBUG&&console.log(c.step,"SHZ["+b+"]",i);var j;switch(i){case 0:j=c.tZone;break;case 1:j=c.gZone;break;default:throw new Error("Invalid zone")}for(var k,l=h.distance(f,f,!1,!0),m=j.length-2,n=0;n1?"loop "+(b.loop-d)+": ":"")+"SHPIX[]",h,f),e.setRelative(i,i,f),e.touch(i)}b.loop=1}function Kc(b){for(var c=b.stack,d=b.rp1,e=b.rp2,f=b.loop,g=b.z0[d],h=b.z1[e],i=b.fv,j=b.dpv,k=b.z2;f--;){var l=c.pop(),m=k[l];a.DEBUG&&console.log(b.step,(b.loop>1?"loop "+(b.loop-f)+": ":"")+"IP[]",l,d,"<->",e),i.interpolate(m,g,h,j),i.touch(m)}b.loop=1}function Lc(b,c){var d=c.stack,e=d.pop()/64,f=d.pop(),g=c.z1[f],h=c.z0[c.rp0],i=c.fv,j=c.pv;i.setRelative(g,h,e,j),i.touch(g),a.DEBUG&&console.log(c.step,"MSIRP["+b+"]",e,f),c.rp1=c.rp0,c.rp2=f,b&&(c.rp0=f)}function Mc(b){for(var c=b.stack,d=b.rp0,e=b.z0[d],f=b.loop,g=b.fv,h=b.pv,i=b.z1;f--;){var j=c.pop(),k=i[j];a.DEBUG&&console.log(b.step,(b.loop>1?"loop "+(b.loop-f)+": ":"")+"ALIGNRP[]",j),g.setRelative(k,e,0,h),g.touch(k)}b.loop=1}function Nc(b){a.DEBUG&&console.log(b.step,"RTDG[]"),b.round=Nb}function Oc(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z0[f],h=c.fv,i=c.pv,j=c.cvt[e];b&&(j=c.round(j)),a.DEBUG&&console.log(c.step,"MIAP["+b+"]",e,"(",j,")",f),h.setRelative(g,Bf,j,i),0===c.zp0&&(g.xo=g.x,g.yo=g.y),h.touch(g),c.rp0=c.rp1=f}function Pc(b){var c=b.prog,d=b.ip,e=b.stack,f=c[++d];a.DEBUG&&console.log(b.step,"NPUSHB[]",f);for(var g=0;g",i),c.stack.push(Math.round(64*i))}function Xc(b){a.DEBUG&&console.log(b.step,"MPPEM[]"),b.stack.push(b.ppem)}function Yc(b){a.DEBUG&&console.log(b.step,"FLIPON[]"),b.autoFlip=!0}function Zc(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"LT[]",d,e),c.push(ed?1:0)}function ad(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"GTEQ[]",d,e),c.push(e>=d?1:0)}function bd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"EQ[]",d,e),c.push(d===e?1:0)}function cd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"NEQ[]",d,e),c.push(d!==e?1:0)}function dd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"ODD[]",d),c.push(Math.trunc(d)%2?1:0)}function ed(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"EVEN[]",d),c.push(Math.trunc(d)%2?0:1)}function fd(b){var c,d=b.stack.pop();a.DEBUG&&console.log(b.step,"IF[]",d),d||(Wb(b,!0),a.DEBUG&&console.log(b.step,27===c?"ELSE[]":"EIF[]"))}function gd(b){a.DEBUG&&console.log(b.step,"EIF[]")}function hd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"AND[]",d,e),c.push(d&&e?1:0)}function id(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"OR[]",d,e),c.push(d||e?1:0)}function jd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"NOT[]",d),c.push(d?0:1)}function kd(b,c){var d=c.stack,e=d.pop(),f=c.fv,g=c.pv,h=c.ppem,i=c.deltaBase+16*(b-1),j=c.deltaShift,k=c.z0;a.DEBUG&&console.log(c.step,"DELTAP["+b+"]",e,d);for(var l=0;l>4)===h){var o=(15&n)-8;o>=0&&o++,a.DEBUG&&console.log(c.step,"DELTAPFIX",m,"by",o*j);var p=k[m];f.setRelative(p,p,o*j,g)}}}function ld(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"SDB[]",d),b.deltaBase=d}function md(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"SDS[]",d),b.deltaShift=Math.pow(.5,d)}function nd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"ADD[]",d,e),c.push(e+d)}function od(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"SUB[]",d,e),c.push(e-d)}function pd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"DIV[]",d,e),c.push(64*e/d)}function qd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MUL[]",d,e),c.push(e*d/64)}function rd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"ABS[]",d),c.push(Math.abs(d))}function sd(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"NEG[]",d),c.push(-d)}function td(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"FLOOR[]",d),c.push(64*Math.floor(d/64))}function ud(b){var c=b.stack,d=c.pop();a.DEBUG&&console.log(b.step,"CEILING[]",d),c.push(64*Math.ceil(d/64))}function vd(b,c){var d=c.stack,e=d.pop();a.DEBUG&&console.log(c.step,"ROUND[]"),d.push(64*c.round(e/64))}function wd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"WCVTF[]",d,e),b.cvt[e]=d*b.ppem/b.font.unitsPerEm}function xd(b,c){var d=c.stack,e=d.pop(),f=c.ppem,g=c.deltaBase+16*(b-1),h=c.deltaShift;a.DEBUG&&console.log(c.step,"DELTAC["+b+"]",e,d);for(var i=0;i>4)===f){var l=(15&k)-8;l>=0&&l++;var m=l*h;a.DEBUG&&console.log(c.step,"DELTACFIX",j,"by",m),c.cvt[j]+=m}}}function yd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SROUND[]",c),b.round=yf;var d;switch(192&c){case 0:d=.5;break;case 64:d=1;break;case 128:d=2;break;default:throw new Error("invalid SROUND value")}switch(b.srPeriod=d,48&c){case 0:b.srPhase=0;break;case 16:b.srPhase=.25*d;break;case 32:b.srPhase=.5*d;break;case 48:b.srPhase=.75*d;break;default:throw new Error("invalid SROUND value")}c&=15,b.srThreshold=0===c?0:(c/8-.5)*d}function zd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"S45ROUND[]",c),b.round=yf;var d;switch(192&c){case 0:d=Math.sqrt(2)/2;break;case 64:d=Math.sqrt(2);break;case 128:d=2*Math.sqrt(2);break;default:throw new Error("invalid S45ROUND value")}switch(b.srPeriod=d,48&c){case 0:b.srPhase=0;break;case 16:b.srPhase=.25*d;break;case 32:b.srPhase=.5*d;break;case 48:b.srPhase=.75*d;break;default:throw new Error("invalid S45ROUND value")}c&=15,b.srThreshold=0===c?0:(c/8-.5)*d}function Ad(b){a.DEBUG&&console.log(b.step,"ROFF[]"),b.round=Lb}function Bd(b){a.DEBUG&&console.log(b.step,"RUTG[]"),b.round=Pb}function Cd(b){a.DEBUG&&console.log(b.step,"RDTG[]"),b.round=Qb}function Dd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCANCTRL[]",c)}function Ed(b,c){var d=c.stack,e=d.pop(),f=d.pop(),g=c.z2[e],h=c.z1[f];a.DEBUG&&console.log("SDPVTL["+b+"]",e,f);var i,j;b?(i=g.y-h.y,j=h.x-g.x):(i=h.x-g.x,j=h.y-g.y),c.dpv=Sb(i,j)}function Fd(b){var c=b.stack,d=c.pop(),e=0;a.DEBUG&&console.log(b.step,"GETINFO[]",d),1&d&&(e=35),32&d&&(e|=4096),c.push(e)}function Gd(b){var c=b.stack,d=c.pop(),e=c.pop(),f=c.pop();a.DEBUG&&console.log(b.step,"ROLL[]"),c.push(e),c.push(d),c.push(f)}function Hd(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MAX[]",d,e),c.push(Math.max(e,d))}function Id(b){var c=b.stack,d=c.pop(),e=c.pop();a.DEBUG&&console.log(b.step,"MIN[]",d,e),c.push(Math.min(e,d))}function Jd(b){var c=b.stack.pop();a.DEBUG&&console.log(b.step,"SCANTYPE[]",c)}function Kd(b){var c=b.stack.pop(),d=b.stack.pop();switch(a.DEBUG&&console.log(b.step,"INSTCTRL[]",c,d),c){case 1:return void(b.inhibitGridFit=!!d);case 2:return void(b.ignoreCvt=!!d);default:throw new Error("invalid INSTCTRL[] selector")}}function Ld(b,c){var d=c.stack,e=c.prog,f=c.ip;a.DEBUG&&console.log(c.step,"PUSHB["+b+"]");for(var g=0;g=0?1:-1,i=Math.abs(i),b&&(k=g.cvt[m],e&&Math.abs(i-k)":"_")+(e?"R":"_")+(0===f?"Gr":1===f?"Bl":2===f?"Wh":"")+"]",b?m+"("+g.cvt[m]+","+k+")":"",n,"(d =",h,"->",j*i,")"),g.rp1=g.rp0,g.rp2=n,c&&(g.rp0=n)}function Od(a){a=a||{},a.empty||(Jb(a.familyName,"When creating a new Font object, familyName is required."),Jb(a.styleName,"When creating a new Font object, styleName is required."),Jb(a.unitsPerEm,"When creating a new Font object, unitsPerEm is required."),Jb(a.ascender,"When creating a new Font object, ascender is required."), -Jb(a.descender,"When creating a new Font object, descender is required."),Jb(a.descender<0,"Descender should be negative (e.g. -512)."),this.names={fontFamily:{en:a.familyName||" "},fontSubfamily:{en:a.styleName||" "},fullName:{en:a.fullName||a.familyName+" "+a.styleName},postScriptName:{en:a.postScriptName||a.familyName+a.styleName},designer:{en:a.designer||" "},designerURL:{en:a.designerURL||" "},manufacturer:{en:a.manufacturer||" "},manufacturerURL:{en:a.manufacturerURL||" "},license:{en:a.license||" "},licenseURL:{en:a.licenseURL||" "},version:{en:a.version||"Version 0.1"},description:{en:a.description||" "},copyright:{en:a.copyright||" "},trademark:{en:a.trademark||" "}},this.unitsPerEm=a.unitsPerEm||1e3,this.ascender=a.ascender,this.descender=a.descender,this.createdTimestamp=a.createdTimestamp,this.tables={os2:{usWeightClass:a.weightClass||this.usWeightClasses.MEDIUM,usWidthClass:a.widthClass||this.usWidthClasses.MEDIUM,fsSelection:a.fsSelection||this.fsSelectionValues.REGULAR}}),this.supported=!0,this.glyphs=new Ve.GlyphSet(this,a.glyphs||[]),this.encoding=new X(this),this.substitution=new Db(this),this.tables=this.tables||{},Object.defineProperty(this,"hinting",{get:function(){return this._hinting?this._hinting:"truetype"===this.outlinesFormat?this._hinting=new Kb(this):void 0}})}function Pd(a,b){var c=JSON.stringify(a),d=256;for(var e in b){var f=parseInt(e);if(f&&!(f<256)){if(JSON.stringify(b[e])===c)return f;d<=f&&(d=f+1)}}return b[d]=a,d}function Qd(a,b,c){var d=Pd(b.name,c);return[{name:"tag_"+a,type:"TAG",value:b.tag},{name:"minValue_"+a,type:"FIXED",value:b.minValue<<16},{name:"defaultValue_"+a,type:"FIXED",value:b.defaultValue<<16},{name:"maxValue_"+a,type:"FIXED",value:b.maxValue<<16},{name:"flags_"+a,type:"USHORT",value:0},{name:"nameID_"+a,type:"USHORT",value:d}]}function Rd(a,b,c){var d={},e=new Ne.Parser(a,b);return d.tag=e.parseTag(),d.minValue=e.parseFixed(),d.defaultValue=e.parseFixed(),d.maxValue=e.parseFixed(),e.skip("uShort",1),d.name=c[e.parseUShort()]||{},d}function Sd(a,b,c,d){for(var e=Pd(b.name,d),f=[{name:"nameID_"+a,type:"USHORT",value:e},{name:"flags_"+a,type:"USHORT",value:0}],g=0;g>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;fthis.x2&&(this.x2=a)),"number"==typeof b&&((isNaN(this.y1)||isNaN(this.y2))&&(this.y1=b,this.y2=b),bthis.y2&&(this.y2=b))},q.prototype.addX=function(a){this.addPoint(a,null)},q.prototype.addY=function(a){this.addPoint(null,a)},q.prototype.addBezier=function(a,b,c,d,e,f,g,h){var i=this,j=[a,b],k=[c,d],l=[e,f],m=[g,h];this.addPoint(a,b),this.addPoint(g,h);for(var n=0;n<=1;n++){var o=6*j[n]-12*k[n]+6*l[n],q=-3*j[n]+9*k[n]-9*l[n]+3*m[n],r=3*k[n]-3*j[n];if(0!==q){var s=Math.pow(o,2)-4*r*q;if(!(s<0)){var t=(-o+Math.sqrt(s))/(2*q);0=0&&d>0&&(c+=" "),c+=b(e)}return c}var d=this;a=void 0!==a?a:2;for(var e="",f=0;f=0&&a<=255,"Byte value should be between 0 and 255."),[a]},Ee.BYTE=u(1),De.CHAR=function(a){return[a.charCodeAt(0)]},Ee.CHAR=u(1),De.CHARARRAY=function(a){for(var b=[],c=0;c>8&255,255&a]},Ee.USHORT=u(2),De.SHORT=function(a){return a>=Ae&&(a=-(2*Ae-a)),[a>>8&255,255&a]},Ee.SHORT=u(2),De.UINT24=function(a){return[a>>16&255,a>>8&255,255&a]},Ee.UINT24=u(3),De.ULONG=function(a){return[a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.ULONG=u(4),De.LONG=function(a){return a>=Be&&(a=-(2*Be-a)),[a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.LONG=u(4),De.FIXED=De.ULONG,Ee.FIXED=Ee.ULONG,De.FWORD=De.SHORT,Ee.FWORD=Ee.SHORT,De.UFWORD=De.USHORT,Ee.UFWORD=Ee.USHORT,De.LONGDATETIME=function(a){return[0,0,0,0,a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.LONGDATETIME=u(8),De.TAG=function(a){return ze.argument(4===a.length,"Tag should be exactly 4 ASCII characters."),[a.charCodeAt(0),a.charCodeAt(1),a.charCodeAt(2),a.charCodeAt(3)]},Ee.TAG=u(4),De.Card8=De.BYTE,Ee.Card8=Ee.BYTE,De.Card16=De.USHORT,Ee.Card16=Ee.USHORT,De.OffSize=De.BYTE,Ee.OffSize=Ee.BYTE,De.SID=De.USHORT,Ee.SID=Ee.USHORT,De.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?De.NUMBER16(a):De.NUMBER32(a)},Ee.NUMBER=function(a){return De.NUMBER(a).length},De.NUMBER16=function(a){return[28,a>>8&255,255&a]},Ee.NUMBER16=u(3),De.NUMBER32=function(a){return[29,a>>24&255,a>>16&255,a>>8&255,255&a]},Ee.NUMBER32=u(5),De.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()}for(var e="",f=0,g=b.length;f>8&255,b[b.length]=255&d}return b},Ee.UTF16=function(a){return 2*a.length};var Fe={"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":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ"};Ce.MACSTRING=function(a,b,c,d){var e=Fe[d];if(void 0!==e){for(var f="",g=0;g=128&&void 0===(f=c[f]))return;d[e]=f}return d}},Ee.MACSTRING=function(a,b){var c=De.MACSTRING(a,b);return void 0!==c?c.length:0},De.VARDELTAS=function(a){for(var b=0,c=[];b=-128&&d<=127?x(a,b,c):y(a,b,c)}return c},De.INDEX=function(a){for(var b=1,c=[b],d=[],e=0;e>8,b[l+1]=255&m,b=b.concat(d[k])}return b},Ee.TABLE=function(a){for(var b=0,c=a.fields.length,d=0;d0)return new Q(this.data,this.offset+b).parseStruct(a)},Q.prototype.parseListOfLists=function(a){for(var b=this,c=this.parseOffset16List(),d=c.length,e=this.relativeOffset,f=new Array(d),g=0;g=0)return d[e].script;if(b){var f={tag:a,script:{defaultLangSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]},langSysRecords:[]}};return d.splice(-1-e,0,f),f.script}}},getLangSysTable:function(a,b,c){var d=this.getScriptTable(a,c);if(d){if(!b||"dflt"===b||"DFLT"===b)return d.defaultLangSys;var e=Ab(d.langSysRecords,b);if(e>=0)return d.langSysRecords[e].langSys;if(c){var f={tag:b,langSys:{reserved:0,reqFeatureIndex:65535,featureIndexes:[]}};return d.langSysRecords.splice(-1-e,0,f),f.langSys}}},getFeatureTable:function(a,b,c,d){var e=this.getLangSysTable(a,b,d);if(e){for(var f,g=e.featureIndexes,h=this.font.tables[this.tableName].features,i=0;i=h[j-1].tag,"Features must be added in alphabetical order."),f={tag:c,feature:{params:0,lookupListIndexes:[]}},h.push(f),g.push(j),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;k=0){for(var k=f.ligatureSets[j],l=0;l0&&a<0?c:e<0&&a>0?-c:a*e},zf={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 zf.setRelative(a,a,(i+j)/2,d,!0):void zf.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}},Af={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 Af.setRelative(a,a,(i+j)/2,d,!0):void Af.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(zf),Object.freeze(Af),Rb.prototype.distance=function(a,b,c,d){return this.x*zf.distance(a,b,c,d)+this.y*Af.distance(a,b,c,d)},Rb.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)},Rb.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},Rb.prototype.touch=function(a){a.xTouched=!0,a.yTouched=!0},Tb.prototype.nextTouched=function(a){for(var b=this.nextPointOnContour;!a.touched(b)&&b!==this;)b=b.nextPointOnContour;return b},Tb.prototype.prevTouched=function(a){for(var b=this.prevPointOnContour;!a.touched(b)&&b!==this;)b=b.prevPointOnContour;return b};var Bf=Object.freeze(new Tb(0,0)),Cf={cvCutIn:17/16,deltaBase:9,deltaShift:.125,loop:1,minDis:1,autoFlip:!0};Kb.prototype.exec=function(b,c){if("number"!=typeof c)throw new Error("Point size is not a number!");if(!(this._errorState>2)){var d=this.font,e=this._prepState;if(!e||e.ppem!==c){var f=this._fpgmState;if(!f){Ub.prototype=Cf,f=this._fpgmState=new Ub("fpgm",d.tables.fpgm),f.funcs=[],f.font=d,a.DEBUG&&(console.log("---EXEC FPGM---"),f.step=-1);try{vf(f)}catch(a){return console.log("Hinting error in FPGM:"+a),void(this._errorState=3)}}Ub.prototype=f,e=this._prepState=new Ub("prep",d.tables.prep),e.ppem=c;var g=d.tables.cvt;if(g)for(var h=e.cvt=new Array(g.length),i=c/d.unitsPerEm,j=0;j1))try{return wf(b,e)}catch(a){return this._errorState<1&&(console.log("Hinting error:"+a),console.log("Note: further hinting errors are silenced")),void(this._errorState=1)}}},wf=function(b,c){var d,e,f,g=c.ppem/c.font.unitsPerEm,h=g,i=b.components;if(Ub.prototype=c,i){var j=c.font;e=[],d=[];for(var k=0;k0,"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.")},Od.prototype.toTables=function(){return tf.fontToTable(this)},Od.prototype.toBuffer=function(){return console.warn("Font.toBuffer is deprecated. Use Font.toArrayBuffer instead."),this.toArrayBuffer()},Od.prototype.toArrayBuffer=function(){for(var a=this.toTables(),b=a.encode(),c=new ArrayBuffer(b.length),d=new Uint8Array(c),e=0;e1)for(var c=1;c-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(-1===w.indexOf(b))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");var b="response"in f?f.response:f.responseText;c(new q(b,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)},{}],12:[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":14,"./color/p5.Color":15,"./color/setting":16,"./core/2d_primitives":17,"./core/attributes":18,"./core/constants":20,"./core/core":21,"./core/curves":22,"./core/environment":23,"./core/init.js":25,"./core/p5.Element":26,"./core/p5.Graphics":27,"./core/p5.Renderer2D":29,"./core/rendering":30,"./core/structure":32,"./core/transform":33,"./core/vertex":34,"./data/p5.TypedDict":35,"./events/acceleration":36,"./events/keyboard":37,"./events/mouse":38,"./events/touch":39,"./image/image":41,"./image/loading_displaying":42,"./image/p5.Image":43,"./image/pixels":44,"./io/files":45,"./io/p5.Table":46,"./io/p5.TableRow":47,"./io/p5.XML":48,"./math/calculation":49,"./math/math":50,"./math/noise":51,"./math/p5.Vector":52,"./math/random":54,"./math/trigonometry":55,"./typography/attributes":56,"./typography/loading_displaying":57,"./typography/p5.Font":58,"./utilities/array_functions":59,"./utilities/conversion":60,"./utilities/string_functions":61,"./utilities/time_date":62,"./webgl/camera":63,"./webgl/interaction":64,"./webgl/light":65,"./webgl/loading":66,"./webgl/material":67,"./webgl/p5.Geometry":68,"./webgl/p5.Matrix":69,"./webgl/p5.RendererGL":72,"./webgl/p5.RendererGL.Immediate":70,"./webgl/p5.RendererGL.Retained":71,"./webgl/p5.Shader":73,"./webgl/primitives":75}],13:[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":21}],14:[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(){if(d._validateParameters("color",arguments),arguments[0]instanceof d.Color)return arguments[0];var a=arguments[0]instanceof Array?arguments[0]:arguments;return new d.Color(this,a)},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._colorMode,m=this._colorMaxes;if(l===e.RGB)j=a.levels.map(function(a){return a/255}),k=b.levels.map(function(a){return a/255});else if(l===e.HSB)a._getBrightness(),b._getBrightness(),j=a.hsba,k=b.hsba;else{if(l!==e.HSL)throw new Error(l+"cannot be used for interpolation.");a._getLightness(),b._getLightness(),j=a.hsla,k=b.hsla}return c=Math.max(Math.min(c,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":20,"../core/core":21,"../core/error_helpers":24,"./p5.Color":15}],15:[function(a,b,c){"use strict";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(a,b,c,h){var i=arguments.length,j=this.mode,k=this.maxes,m=[];if(i>=3)return m[0]=a/k[j][0],m[1]=b/k[j][1],m[2]=c/k[j][2],m[3]="number"==typeof h?h/k[j][3]:1,m=m.map(function(a){return Math.max(Math.min(a,1),0)}),j===e.HSL?f._hslaToRGBA(m):j===e.HSB?f._hsbaToRGBA(m):m;if(1===i&&"string"==typeof a){var n=a.trim().toLowerCase();if(g[n])return d.Color._parseInputs.call(this,g[n]);if(l.HEX3.test(n))return m=l.HEX3.exec(n).slice(1).map(function(a){return parseInt(a+a,16)/255}),m[3]=1,m;if(l.HEX6.test(n))return m=l.HEX6.exec(n).slice(1).map(function(a){return parseInt(a,16)/255}),m[3]=1,m;if(l.HEX4.test(n))return m=l.HEX4.exec(n).slice(1).map(function(a){return parseInt(a+a,16)/255});if(l.HEX8.test(n))return m=l.HEX8.exec(n).slice(1).map(function(a){return parseInt(a,16)/255});if(l.RGB.test(n))return m=l.RGB.exec(n).slice(1).map(function(a){return a/255}),m[3]=1,m;if(l.RGB_PERCENT.test(n))return m=l.RGB_PERCENT.exec(n).slice(1).map(function(a){return parseFloat(a)/100}),m[3]=1,m;if(l.RGBA.test(n))return m=l.RGBA.exec(n).slice(1).map(function(a,b){return 3===b?parseFloat(a):a/255});if(l.RGBA_PERCENT.test(n))return m=l.RGBA_PERCENT.exec(n).slice(1).map(function(a,b){return 3===b?parseFloat(a):parseFloat(a)/100});if(l.HSL.test(n)?(m=l.HSL.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),m[3]=1):l.HSLA.test(n)&&(m=l.HSLA.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),m=m.map(function(a){return Math.max(Math.min(a,1),0)}),m.length)return f._hslaToRGBA(m);if(l.HSB.test(n)?(m=l.HSB.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:parseInt(a,10)/100}),m[3]=1):l.HSBA.test(n)&&(m=l.HSBA.exec(n).slice(1).map(function(a,b){return 0===b?parseInt(a,10)/360:3===b?parseFloat(a):parseInt(a,10)/100})),m=m.map(function(a){return Math.max(Math.min(a,1),0)}),m.length)return f._hsbaToRGBA(m);m=[1,1,1,1]}else{if(1!==i&&2!==i||"number"!=typeof a)throw new Error(arguments+"is not a valid color representation.");m[0]=a/k[j][2],m[1]=a/k[j][2],m[2]=a/k[j][2],m[3]="number"==typeof b?b/k[j][3]:1,m=m.map(function(a){return Math.max(Math.min(a,1),0)})}return m},b.exports=d.Color},{"../core/constants":20,"../core/core":21,"./color_conversion":13}],16:[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(a,b,c,f,g){if(d._validateParameters("colorMode",arguments),a===e.RGB||a===e.HSB||a===e.HSL){this._colorMode=a;var h=this._colorMaxes[a];2===arguments.length?(h[0]=b,h[1]=b,h[2]=b,h[3]=b):4===arguments.length?(h[0]=b,h[1]=c,h[2]=f):5===arguments.length&&(h[0]=b,h[1]=c,h[2]=f,h[3]=g)}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._setProperty("_doFill",!1),this},d.prototype.noStroke=function(){return 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":20,"../core/core":21,"./p5.Color":15}],17:[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){if(d._validateParameters("arc",arguments),!this._renderer._doStroke&&!this._renderer._doFill)return this;for(this._angleMode===e.DEGREES&&(g=this.radians(g),h=this.radians(h));g<0;)g+=e.TWO_PI;for(;h<0;)h+=e.TWO_PI;return g%=e.TWO_PI,h%=e.TWO_PI,h===g&&(h+=e.TWO_PI),g=g<=e.HALF_PI?Math.atan(c/f*Math.tan(g)):g>e.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(a,b,c,e,g,h){if(d._validateParameters("ellipse",arguments),c<0&&(c=Math.abs(c)),void 0===e?e=c:e<0&&(e=Math.abs(e)),this._renderer._doStroke||this._renderer._doFill){var i=f.modeAdjust(a,b,c,e,this._renderer._ellipseMode);this._renderer.ellipse([i.x,i.y,i.w,i.h,g,h])}return this},d.prototype.line=function(){return d._validateParameters("line",arguments),this._renderer._doStroke&&this._renderer.line.apply(this._renderer,arguments),this},d.prototype.point=function(){return d._validateParameters("point",arguments),this._renderer._doStroke&&this._renderer.point.apply(this._renderer,arguments),this},d.prototype.quad=function(){return d._validateParameters("quad",arguments),(this._renderer._doStroke||this._renderer._doFill)&&this._renderer.quad.apply(this._renderer,arguments),this},d.prototype.rect=function(a,b,c,e,g,h){if(d._validateParameters("rect",arguments),this._renderer._doStroke||this._renderer._doFill){var i=f.modeAdjust(a,b,c,e,this._renderer._rectMode);this._renderer.rect([i.x,i.y,i.w,i.h,g,h])}return this},d.prototype.triangle=function(){return d._validateParameters("triangle",arguments),(this._renderer._doStroke||this._renderer._doFill)&&this._renderer.triangle(arguments),this},b.exports=d},{"./canvas":19,"./constants":20,"./core":21,"./error_helpers":24}],18:[function(a,b,c){"use strict";var d=a("./core"),e=a("./constants");d.prototype.ellipseMode=function(a){return d._validateParameters("ellipseMode",arguments),a!==e.CORNER&&a!==e.CORNERS&&a!==e.RADIUS&&a!==e.CENTER||(this._renderer._ellipseMode=a),this},d.prototype.noSmooth=function(){return this._renderer.noSmooth(),this},d.prototype.rectMode=function(a){return d._validateParameters("rectMode",arguments),a!==e.CORNER&&a!==e.CORNERS&&a!==e.RADIUS&&a!==e.CENTER||(this._renderer._rectMode=a),this},d.prototype.smooth=function(){return this._renderer.smooth(),this},d.prototype.strokeCap=function(a){return d._validateParameters("strokeCap",arguments),a!==e.ROUND&&a!==e.SQUARE&&a!==e.PROJECT||this._renderer.strokeCap(a),this},d.prototype.strokeJoin=function(a){return d._validateParameters("strokeJoin",arguments),a!==e.ROUND&&a!==e.BEVEL&&a!==e.MITER||this._renderer.strokeJoin(a),this},d.prototype.strokeWeight=function(a){return d._validateParameters("strokeWeight",arguments),this._renderer.strokeWeight(a),this},b.exports=d},{"./constants":20,"./core":21}],19:[function(a,b,c){"use strict";var d=a("./constants");b.exports={modeAdjust:function(a,b,c,e,f){return f===d.CORNER?{x:a,y:b,w:c,h:e}:f===d.CORNERS?{x:a,y:b,w:c-a,h:e-b}:f===d.RADIUS?{x:a-c,y:b-e,w:2*c,h:2*e}:f===d.CENTER?{x:a-.5*c,y:b-.5*e,w:c,h:e}:void 0},arcModeAdjust:function(a,b,c,e,f){return f===d.CORNER?{x:a+.5*c,y:b+.5*e,w:c,h:e}:f===d.CORNERS?{x:a,y:b,w:c+a,h:e+b}:f===d.RADIUS?{x:a,y:b,w:2*c,h:2*e}:f===d.CENTER?{x:a,y:b,w:c,h:e}:void 0}}},{"./constants":20}],20:[function(a,b,c){"use strict";var d=Math.PI;b.exports={P2D:"p2d",WEBGL:"webgl",ARROW:"default",CROSS:"crosshair",HAND:"pointer",MOVE:"move",TEXT:"text",WAIT:"wait",HALF_PI:d/2,PI:d,QUARTER_PI:d/4,TAU:2*d,TWO_PI:2*d,DEGREES:"degrees",RADIANS:"radians",DEG_TO_RAD:d/180,RAD_TO_DEG:180/d,CORNER:"corner",CORNERS:"corners",RADIUS:"radius",RIGHT:"right",LEFT:"left",CENTER:"center",TOP:"top",BOTTOM:"bottom",BASELINE:"alphabetic",POINTS:0,LINES:1,LINE_STRIP:3,LINE_LOOP:2,TRIANGLES:4,TRIANGLE_FAN:6,TRIANGLE_STRIP:5,QUADS:"quads",QUAD_STRIP:"quad_strip",CLOSE:"close",OPEN:"open",CHORD:"chord",PIE:"pie",PROJECT:"square",SQUARE:"butt",ROUND:"round",BEVEL:"bevel",MITER:"miter",RGB:"rgb",HSB:"hsb",HSL:"hsl",AUTO:"auto",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,BLEND:"source-over",ADD:"lighter",DARKEST:"darken",LIGHTEST:"lighten",DIFFERENCE:"difference",EXCLUSION:"exclusion",MULTIPLY:"multiply",SCREEN:"screen",REPLACE:"copy",OVERLAY:"overlay",HARD_LIGHT:"hard-light",SOFT_LIGHT:"soft-light",DODGE:"color-dodge",BURN:"color-burn",THRESHOLD:"threshold",GRAY:"gray",OPAQUE:"opaque",INVERT:"invert",POSTERIZE:"posterize",DILATE:"dilate",ERODE:"erode",BLUR:"blur",NORMAL:"normal",ITALIC:"italic",BOLD:"bold",_DEFAULT_TEXT_FILL:"#000000",_DEFAULT_LEADMULT:1.25,_CTX_MIDDLE:"middle",LINEAR:"linear",QUADRATIC:"quadratic",BEZIER:"bezier",CURVE:"curve",STROKE:"stroke",FILL:"fill",TEXTURE:"texture",IMMEDIATE:"immediate",LANDSCAPE:"landscape",PORTRAIT:"portrait",_DEFAULT_STROKE:"#000000",_DEFAULT_FILL:"#FFFFFF"}},{}],21:[function(a,b,c){"use strict";a("./shim");var d=a("./constants"),e=function(a,b,c){"boolean"==typeof b&&void 0===c&&(c=b,b=void 0),this._setupDone=!1,this._pixelDensity=Math.ceil(window.devicePixelRatio)||1,this._userNode=b,this._curElement=null,this._elements=[],this._requestAnimId=0,this._preloadCount=0,this._isGlobal=!1,this._loop=!0,this._initializeInstanceVariables(),this._defaultCanvasSize={width:100,height:100},this._events={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",this._registeredMethods={};for(var d=Object.getOwnPropertyNames(e.prototype._registeredMethods),f=0;f=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 h._validateParameters("frameRate",arguments),"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(h._validateParameters("fullscreen",arguments),void 0===a)return document.fullscreenElement||document.webkitFullscreenElement||document.mozFullScreenElement||document.msFullscreenElement;a?f(document.documentElement):g()},h.prototype.pixelDensity=function(a){if(h._validateParameters("pixelDensity",arguments),"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":20,"./core":21}],24:[function(a,b,c){"use strict";var d=a("./core");a("./constants");d._validateParameters=d._friendlyFileLoadError=function(){};var e=null,f="https://github.com/processing/p5.js/wiki/Frequently-Asked-Questions#why-cant-i-assign-variables-using-p5-functions-and-variables-before-setup",g=function(){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}})};e=[].concat(c(d.prototype),c(a("./constants"))),e.sort(function(a,b){return b.name.length-a.name.length})},h=function(a,b){b||(b=console.log.bind(console)),e||g(),e.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: "+f),!0})};d.prototype._helpForMisusedAtTopLevelCode=h,"complete"!==document.readyState&&(window.addEventListener("error",h,!1),window.addEventListener("load",function(){window.removeEventListener("error",h,!1)})),b.exports=d},{"../../docs/reference/data.json":void 0,"./constants":20,"./core":21}],25:[function(a,b,c){"use strict";var d=a("../core/core"),e=function(){window.PHANTOMJS||window.mocha||(window.setup&&"function"==typeof window.setup||window.draw&&"function"==typeof window.draw)&&!d.instance&&new d};"complete"===document.readyState?e():window.addEventListener("load",e,!1)},{"../core/core":21}],26:[function(a,b,c){"use strict";function d(a,b,c){return!1===b?f(a,c):e(a,b,c),this}function e(a,b,c){c._events[a]&&f(a,c);var d=b.bind(c);c.elt.addEventListener(a,d,!1),c._events[a]=d}function f(a,b){var c=b._events[a];b.elt.removeEventListener(a,c,!1),b._events[a]=null}var g=a("./core");g.Element=function(a,b){this.elt=a,this._pInst=b,this._events={},this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this.name="p5.Element"},g.Element.prototype.parent=function(a){return void 0===a?this.elt.parentNode:("string"==typeof a?("#"===a[0]&&(a=a.substring(1)),a=document.getElementById(a)):a instanceof g.Element&&(a=a.elt),a.appendChild(this.elt),this)},g.Element.prototype.id=function(a){return void 0===a?this.elt.id:(this.elt.id=a,this.width=this.elt.offsetWidth,this.height=this.elt.offsetHeight,this)},g.Element.prototype.class=function(a){return void 0===a?this.elt.className:(this.elt.className=a,this)},g.Element.prototype.mousePressed=function(a){return d("mousedown",a,this),d("touchstart",a,this),this},g.Element.prototype.doubleClicked=function(a){return d("dblclick",a,this),this},g.Element.prototype.mouseWheel=function(a){return d("wheel",a,this),this},g.Element.prototype.mouseReleased=function(a){return d("mouseup",a,this),d("touchend",a,this),this},g.Element.prototype.mouseClicked=function(a){return d("click",a,this),this},g.Element.prototype.mouseMoved=function(a){return d("mousemove",a,this),d("touchmove",a,this),this},g.Element.prototype.mouseOver=function(a){return d("mouseover",a,this),this},g.Element.prototype.changed=function(a){return d("change",a,this),this},g.Element.prototype.input=function(a){return d("input",a,this),this},g.Element.prototype.mouseOut=function(a){return d("mouseout",a,this),this},g.Element.prototype.touchStarted=function(a){return d("touchstart",a,this),d("mousedown",a,this),this},g.Element.prototype.touchMoved=function(a){return d("touchmove",a,this),d("mousemove",a,this),this},g.Element.prototype.touchEnded=function(a){return d("touchend",a,this),d("mouseup",a,this),this},g.Element.prototype.dragOver=function(a){return d("dragover",a,this),this},g.Element.prototype.dragLeave=function(a){return d("dragleave",a,this),this},g.Element.prototype.drop=function(a,b){function c(b){var c=new g.File(b);return function(b){c.data=b.target.result,a(c)}}return window.File&&window.FileReader&&window.FileList&&window.Blob?(e("dragover",function(a){a.stopPropagation(),a.preventDefault()},this),e("dragleave",function(a){a.stopPropagation(),a.preventDefault()},this),void 0!==b&&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":21}],27:[function(a,b,c){"use strict";var d=a("./core"),e=a("./constants");d.Graphics=function(a,b,c,f){var g=c||e.P2D;this.canvas=document.createElement("canvas"),(f._userNode||document.body).appendChild(this.canvas),d.Element.call(this,this.canvas,f,!1);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 d.prototype._initializeInstanceVariables.apply(this),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),f._elements.push(this),this._renderer.resize(a,b),this._renderer._applyDefaults(),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":20,"./core":21}],28:[function(a,b,c){"use strict";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},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"number"==typeof a?(this._setProperty("_textLeading",a),this):this._textLeading},e.Renderer.prototype.textSize=function(a){return"number"==typeof a?(this._setProperty("_textSize",a),this._setProperty("_textLeading",a*f._DEFAULT_LEADMULT),this._applyTextProperties()):this._textSize},e.Renderer.prototype.textStyle=function(a){return a?(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":20,"./core":21}],29:[function(a,b,c){"use strict";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._pInst,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._pInst,arguments);this._setFill(a.toString())},d.Renderer2D.prototype.stroke=function(){var a=this._pInst.color.apply(this._pInst,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(void 0!==a)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":40,"./canvas":19,"./constants":20,"./core":21,"./p5.Renderer":28}],30:[function(a,b,c){"use strict";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){d._validateParameters("createCanvas",arguments);var g,h=c||e.P2D;if(h===e.WEBGL){if(g=document.getElementById(f)){g.parentNode.removeChild(g);var i=this._renderer;this._elements=this._elements.filter(function(a){return a!==i})}g=document.createElement("canvas"),g.id=f}else if(this._defaultGraphicsCreated)g=this.canvas;else{g=document.createElement("canvas");for(var j=0;document.getElementById("defaultCanvas"+j);)j++;f="defaultCanvas"+j,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(d._validateParameters("resizeCanvas",arguments),this._renderer){var e={};for(var f in this.drawingContext){var g=this.drawingContext[f];"object"!=typeof g&&"function"!=typeof g&&(e[f]=g)}this._renderer.resize(a,b);for(var h in e)try{this.drawingContext[h]=e[h]}catch(a){}c||this.redraw()}},d.prototype.noCanvas=function(){this.canvas&&this.canvas.parentNode.removeChild(this.canvas)},d.prototype.createGraphics=function(a,b,c){return d._validateParameters("createGraphics",arguments),new d.Graphics(a,b,c,this)},d.prototype.blendMode=function(a){if(d._validateParameters("blendMode",arguments),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":72,"./constants":20,"./core":21,"./p5.Graphics":27,"./p5.Renderer2D":29}],31:[function(a,b,c){"use strict";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(){"undefined"==typeof Uint8ClampedArray||Uint8ClampedArray.prototype.slice||Object.defineProperty(Uint8ClampedArray.prototype,"slice",{value:Array.prototype.slice,writable:!0,configurable:!0,enumerable:!1})}()},{}],32:[function(a,b,c){"use strict";function d(a,b){for(var c=1;c0))throw"vertex() must be used once before calling quadraticVertex()";k=!0;for(var j=[],m=0;mn||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":21}],37:[function(a,b,c){"use strict";function d(){for(var a in f)if(f.hasOwnProperty(a)&&!0===f[a])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){!1===c(a)&&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){!1===b(a)&&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){!1===b(a)&&a.preventDefault()}}},e.prototype._onblur=function(a){f={}},e.prototype.keyIsDown=function(a){return e._validateParameters("keyIsDown",arguments),f[a]},b.exports=e},{"../core/core":21}],38:[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?!1===b.mouseDragged(a)&&a.preventDefault():"function"==typeof b.touchMoved&&!1===b.touchMoved(a)&&a.preventDefault():"function"==typeof b.mouseMoved&&!1===b.mouseMoved(a)&&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?!1===b.mousePressed(a)&&a.preventDefault():"function"==typeof b.touchStarted&&!1===b.touchStarted(a)&&a.preventDefault()},e.prototype._onmouseup=function(a){var b=this._isGlobal?window:this;this._setProperty("mouseIsPressed",!1),"function"==typeof b.mouseReleased?!1===b.mouseReleased(a)&&a.preventDefault():"function"==typeof b.touchEnded&&!1===b.touchEnded(a)&&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){!1===b.mouseClicked(a)&&a.preventDefault()}},e.prototype._ondblclick=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.doubleClicked){!1===b.doubleClicked(a)&&a.preventDefault()}},e.prototype._onwheel=function(a){var b=this._isGlobal?window:this;if("function"==typeof b.mouseWheel){a.delta=a.deltaY;!1===b.mouseWheel(a)&&a.preventDefault()}},b.exports=e},{"../core/constants":20,"../core/core":21}],39:[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[(-16777216&H)>>>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(){var a,b,c,e,f,g,h,i,j;if(9===arguments.length)a=arguments[0],b=arguments[1],c=arguments[2],e=arguments[3],f=arguments[4],g=arguments[5],h=arguments[6],i=arguments[7],j=arguments[8];else{if(8!==arguments.length)throw new Error("Signature not supported");a=this,b=arguments[0],c=arguments[1],e=arguments[2],f=arguments[3],g=arguments[4],h=arguments[5],i=arguments[6],j=arguments[7]}d.Renderer2D._copyHelper(this,a,b,c,e,f,g,h,i,j)},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){d.prototype.saveCanvas(this.canvas,a,b)},b.exports=d.Image},{"../core/core":21,"./filters":40}],44:[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._validateParameters("copy",arguments),d.Renderer2D.prototype.copy.apply(this._renderer,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":15,"../core/core":21,"./filters":40}],45:[function(a,b,c){"use strict";function d(a,b){var c={};if(void 0===(b=b||[]))for(var d=0;d/g,">").replace(/"/g,""").replace(/'/g,"'")}function f(a,b){b&&!0!==b&&"true"!==b||(b=""),a||(a="untitled");var c="";return a&&a.indexOf(".")>-1&&(c=a.split(".").pop()),b&&c!==b&&(c=b,a=a+"."+c),[a,c]}function g(a){document.body.removeChild(a.target)}var h=a("../core/core");a("whatwg-fetch"),a("es6-promise").polyfill();var i=a("fetch-jsonp");a("../core/error_helpers"),h.prototype.loadJSON=function(){for(var a,b,c,d=arguments[0],e={},f="json",g=1;g0&&"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=-1!==c.url.indexOf("json")?"json":-1!==c.url.indexOf("xml")?"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});h.prototype.downloadFile(e,b,c)},h.prototype.downloadFile=function(b,c,d){var e=f(c,d),i=e[0];if(b instanceof Blob){return void a("file-saver").saveAs(b,i)}var j=document.createElement("a");if(j.href=b,j.download=i,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 --\x3e Save As.\n",k+='2. Choose "Page Source" as the Format.\n',k+='3. Name it with this extension: ."'+e[1]+'"',alert(k)}j.click()},h.prototype._checkFileExtension=f,h.prototype._isSafari=function(){return Object.prototype.toString.call(window.HTMLElement).indexOf("Constructor")>0},b.exports=h},{"../core/core":21,"../core/error_helpers":24,"es6-promise":4,"fetch-jsonp":5,"file-saver":6,"whatwg-fetch":11}],46:[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)).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,b){return this.p5&&this.p5._angleMode===f.DEGREES&&(a=e.degreesToRadians(a)),void 0===b&&(b=1),this.p5?new d.Vector(this.p5,[b*Math.cos(a),b*Math.sin(a),0]):new d.Vector(b*Math.cos(a),b*Math.sin(a),0)},d.Vector.fromAngles=function(a,b,c){this.p5&&this.p5._angleMode===f.DEGREES&&(a=e.degreesToRadians(a),b=e.degreesToRadians(b)),void 0===c&&(c=1);var g=Math.cos(b),h=Math.sin(b),i=Math.cos(a),j=Math.sin(a);return this.p5?new new d.Vector(this.p5,c*j*h,-c*i,c*j*g):new d.Vector(c*j*h,-c*i,c*j*g)},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()*f.TWO_PI,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()*f.TWO_PI,b=2*Math.random()-1);var c=Math.sqrt(1-b*b),e=c*Math.cos(a),g=c*Math.sin(a);return this.p5?new d.Vector(this.p5,[e,g,b]):new d.Vector(e,g,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":20,"../core/core":21,"./polargeometry":53}],53:[function(a,b,c){"use strict";b.exports={degreesToRadians:function(a){return 2*Math.PI*a/360},radiansToDegrees:function(a){return 360*a/(2*Math.PI)}}},{}],54:[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":21}],55:[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":20,"../core/core":21,"./polargeometry":53}],56:[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":21}],57:[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":20,"../core/core":21,"../core/error_helpers":24,"opentype.js":9}],58:[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 f=a[b];f.length;)h[b]="A",e&&(i[b]="A"),a.splice(b++,0,["C"].concat(f.splice(0,6)));a.splice(b,1),c=Math.max(d.length,e&&e.length||0)}},l=function(a,b,f,g,h){a&&b&&"M"===a[h][0]&&"M"!==b[h][0]&&(b.splice(h,0,["M",g.x,g.y]),f.bx=0,f.by=0,f.x=a[h][1],f.y=a[h][2],c=Math.max(d.length,e&&e.length||0))},m="",n="";c=Math.max(d.length,e&&e.length||0);for(var p=0;p1&&(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+=(j=0;--b){var c=arguments[b];a+=c===Object(c)?JSON.stringify(c):c}return a}var y=a("../core/core"),z=a("../core/constants");y.Font=function(a){this.parent=a,this.cache={},this.font=void 0,this.name="p5.Font"},y.Font.prototype.list=function(){throw"not yet implemented"},y.Font.prototype.textBounds=function(a,b,c,d,e){b=void 0!==b?b:0,c=void 0!==c?c:0,d=d||this.parent._renderer._textSize;var f=e&&e.renderer&&e.renderer._pInst||this.parent,g=f._renderer.drawingContext,h=g.textAlign||z.LEFT,i=g.textBaseline||z.BASELINE,j=x("textBounds",a,b,c,d,h,i),k=this.cache[j];if(!k){var l,m,n,o,p,q=[],r=[],s=this._scale(d);this.font.forEachGlyph(a,b,c,d,e,function(a,b,c,d){var e=a.getMetrics();q.push(b+e.xMin*s),q.push(b+e.xMax*s),r.push(c+-e.yMin*s),r.push(c+-e.yMax*s)}),l=Math.min.apply(null,q),m=Math.min.apply(null,r),n=Math.max.apply(null,q),o=Math.max.apply(null,r),k={x:l,y:m,h:o-m,w:n-l,advance:l-b},p=this._handleAlignment(f,g,a,k.x,k.y,k.w+k.advance),k.x=p.x,k.y=p.y,this.cache[x("textBounds",a,b,c,d,h,i)]=k}return k},y.Font.prototype.textToPoints=function(a,b,c,e,g){function h(b){return k[b].name&&"space"===k[b].name||a.length===k.length&&" "===a[b]||k[b].index&&3===k[b].index}var i=0,j=[],k=this._getGlyphs(a);e=e||this.parent._renderer._textSize;for(var l=0;l2?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":21}],60:[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":21}],61:[function(a,b,c){"use strict";function d(a,b,c){var d=a<0,e=d?a.toString().substring(1):a.toString(),f=e.indexOf("."),g=-1!==f?e.substring(0,f):e,h=-1!==f?e.substring(f+1):"",i=d?"-":"";if(void 0!==c){var j="";(-1!==f||c-h.length>0)&&(j="."),h.length>c&&(h=h.substring(0,c));for(var k=0;kd.length){d+=-1===c?".":"";for(var f=b-d.length+1,g=0;g0?"+"+a.toString():a.toString()}function g(a){return parseFloat(a)>0?" "+a.toString():a.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(a,b,c){return h._validateParameters("nf",arguments),a instanceof Array?a.map(function(a){return d(a,b,c)}):"[object Arguments]"===Object.prototype.toString.call(a)?3===a.length?this.nf(a[0],a[1],a[2]):2===a.length?this.nf(a[0],a[1]):this.nf(a[0]):d(a,b,c)},h.prototype.nfc=function(a,b){return h._validateParameters("nfc",arguments),a instanceof Array?a.map(function(a){return e(a,b)}):e(a,b)},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(a,b){h._validateParameters("splitTokens",arguments);var c;if(void 0!==b){var d=b,e=/\]/g.exec(d),f=/\[/g.exec(d);f&&e?(d=d.slice(0,e.index)+d.slice(e.index+1),f=/\[/g.exec(d),d=d.slice(0,f.index)+d.slice(f.index+1),c=new RegExp("[\\["+d+"\\]]","g")):e?(d=d.slice(0,e.index)+d.slice(e.index+1),c=new RegExp("["+d+"\\]]","g")):f?(d=d.slice(0,f.index)+d.slice(f.index+1),c=new RegExp("["+d+"\\[]","g")):c=new RegExp("["+d+"]","g")}else c=/\s/g;return a.split(c).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":21,"../core/error_helpers":24}],62:[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":21}],63:[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(a,b,c,d,e,f,g,h,i){void 0===a&&(a=this.defaultCameraX,b=this.defaultCameraY,c=this.defaultCameraZ,d=a,e=b,f=0,g=0,h=1,i=0),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(a,b,c,e){void 0===a&&(a=this.defaultCameraFOV),void 0===b&&(b=this.defaultCameraAspect),void 0===c&&(c=this.defaultCameraNear),void 0===e&&(e=this.defaultCameraFar),this.cameraFOV=a,this.cameraAspect=b,this.cameraNear=c,this.cameraFar=e,this.uPMatrix=d.Matrix.identity(this.pInst);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(){return this._renderer.ortho.apply(this._renderer,arguments),this},d.RendererGL.prototype.ortho=function(a,b,c,e,f,g){void 0===a&&(a=-this.width/2),void 0===b&&(b=+this.width/2),void 0===c&&(c=-this.height/2),void 0===e&&(e=+this.height/2),void 0===f&&(f=0),void 0===g&&(g=Math.max(this.width,this.height)),this.uPMatrix=d.Matrix.identity(this._pInst);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.uPMatrix=d.Matrix.identity(),this.uPMatrix.set(k,0,0,0,0,-l,0,0,0,0,m,0,n,o,p,1),this._curCamera="custom"},b.exports=d},{"../core/core":21}],64:[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":21}],65:[function(a,b,c){"use strict";var d=a("../core/core");d.prototype.ambientLight=function(a,b,c,d){var e=this.color.apply(this,arguments),f=this._renderer._useLightShader();return f.setUniform("uUseLighting",!0),f.setUniform("uMaterialColor",this._renderer.curFillColor),this._renderer.ambientLightColors.push(e._array[0],e._array[1],e._array[2]),f.setUniform("uAmbientColor",this._renderer.ambientLightColors),f.setUniform("uAmbientLightCount",this._renderer.ambientLightColors.length/3),this},d.prototype.directionalLight=function(a,b,c,d,e,f){var g,h,i,j=this._renderer._useLightShader(),k=this.color.apply(this,[a,b,c]),l=arguments[arguments.length-1];"number"==typeof l?(g=arguments[arguments.length-3],h=arguments[arguments.length-2],i=arguments[arguments.length-1]):(g=l.x,h=l.y,i=l.z),j.setUniform("uUseLighting",!0),j.setUniform("uMaterialColor",this._renderer.curFillColor);var m=Math.sqrt(g*g+h*h+i*i);return this._renderer.directionalLightDirections.push(g/m,h/m,i/m),j.setUniform("uLightingDirection",this._renderer.directionalLightDirections),this._renderer.directionalLightColors.push(k._array[0],k._array[1],k._array[2]),j.setUniform("uDirectionalColor",this._renderer.directionalLightColors),j.setUniform("uDirectionalLightCount",this._renderer.directionalLightColors.length/3),this},d.prototype.pointLight=function(a,b,c,d,e,f){var g,h,i,j=this._renderer._pInst.color.apply(this,[a,b,c]),k=arguments[arguments.length-1];"number"==typeof k?(g=arguments[arguments.length-3],h=arguments[arguments.length-2],i=arguments[arguments.length-1]):(g=k.x,h=k.y,i=k.z);var l=this._renderer._useLightShader();return l.setUniform("uUseLighting",!0),l.setUniform("uMaterialColor",this._renderer.curFillColor),this._renderer.pointLightPositions.push(g,h,i),l.setUniform("uPointLightLocation",this._renderer.pointLightPositions),this._renderer.pointLightColors.push(j._array[0],j._array[1],j._array[2]),l.setUniform("uPointLightColor",this._renderer.pointLightColors),l.setUniform("uPointLightCount",this._renderer.pointLightColors.length/3),this},b.exports=d},{"../core/core":21}],66:[function(a,b,c){"use strict";function d(a,b){for(var c={v:[],vt:[],vn:[]},d={},f=0;f0)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":21,"./p5.Geometry":68}],67:[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.createShader=function(a,b){return new d.Shader(this._renderer,a,b)},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.curFillColor=[1,1,1,1],this.noStroke(),this},d.prototype.texture=function(a){this._renderer.GL.depthMask(!0),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=e.TEXTURE;var b=this._renderer._useLightShader();return b.setUniform("uSpecular",!1),b.setUniform("isTexture",!0),b.setUniform("uSampler",a),this.noStroke(),this},d.prototype.ambientMaterial=function(a,b,c,e){var f=d.prototype.color.apply(this,arguments);this._renderer.curFillColor=f._array;var g=this._renderer._useLightShader();return g.setUniform("uMaterialColor",this._renderer.curFillColor),g.setUniform("uSpecular",!1),g.setUniform("isTexture",!1),this},d.prototype.specularMaterial=function(a,b,c,e){var f=d.prototype.color.apply(this,arguments);this._renderer.curFillColor=f._array;var g=this._renderer._useLightShader();return g.setUniform("uMaterialColor",this._renderer.curFillColor),g.setUniform("uSpecular",!0),g.setUniform("isTexture",!1),this},d.RendererGL.prototype._applyColorBlend=function(a){var b=this.GL;return a[a.length-1]<1?(b.depthMask(!1),b.enable(b.BLEND),b.blendEquation(b.FUNC_ADD),b.blendFunc(b.SRC_ALPHA,b.ONE_MINUS_SRC_ALPHA)):(b.depthMask(!0),b.disable(b.BLEND)),a},b.exports=d},{"../core/constants":20,"../core/core":21,"./p5.Texture":74}],68:[function(a,b,c){"use strict";var d=a("../core/core");d.Geometry=function(a,b,c){return this.vertices=[],this.lineVertices=[],this.lineNormals=[],this.vertexNormals=[],this.faces=[],this.uvs=[],this.edges=[],this.detailX=void 0!==a?a:1,this.detailY=void 0!==b?b:1,c instanceof Function&&c.call(this),this.name="p5.Geometry",this},d.Geometry.prototype.computeFaces=function(){for(var a,b,c,d,e=this.detailX+1,f=0;fthis.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--}this.gHash[a]={}},d.RendererGL.prototype._freeBuffers=function(a){var b=this.gHash[a];if(b){delete this.gHash[a],e--;var c=this.GL;b.vertexBuffer&&c.deleteBuffer(b.vertexBuffer),b.normalBuffer&&c.deleteBuffer(b.normalBuffer),b.lineNormalBuffer&&c.deleteBuffer(b.lineNormalBuffer),b.uvBuffer&&c.deleteBuffer(b.uvBuffer),b.indexBuffer&&c.deleteBuffer(b.indexBuffer), -b.lineVertexBuffer&&c.deleteBuffer(b.lineVertexBuffer)}},d.RendererGL.prototype.createBuffers=function(a,b){var c=this.GL;this._setDefaultCamera(),this._initBufferDefaults(a);var d=this.gHash[a];d.numberOfItems=3*b.faces.length,d.lineVertexCount=b.lineVertices.length,this._useColorShader(),this.curStrokeShader.attributes.aPosition&&(d.lineVertexBuffer=c.createBuffer(),this._bindBuffer(d.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.curStrokeShader.attributes.aDirection&&(d.lineNormalBuffer=c.createBuffer(),this._bindBuffer(d.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.curFillShader.attributes.aPosition&&(d.vertexBuffer=c.createBuffer(),this._bindBuffer(d.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)),d.indexBuffer=c.createBuffer(),this._bindBuffer(d.indexBuffer,c.ELEMENT_ARRAY_BUFFER,this._flatten(b.faces),Uint16Array,c.STATIC_DRAW),this.curFillShader.attributes.aNormal&&(d.normalBuffer=c.createBuffer(),this._bindBuffer(d.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.curFillShader.attributes.aTexCoord&&(d.uvBuffer=c.createBuffer(),this._bindBuffer(d.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;this._useColorShader();var c=this.gHash[a];return this._doStroke&&c.lineVertexCount>0&&(this.curStrokeShader.bindShader(),c.lineVertexBuffer&&(this._bindBuffer(c.lineVertexBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0)),c.lineNormalBuffer&&(this._bindBuffer(c.lineNormalBuffer,b.ARRAY_BUFFER),this.curStrokeShader.enableAttrib(this.curStrokeShader.attributes.aDirection.location,4,b.FLOAT,!1,0,0)),this._applyColorBlend(this.curStrokeColor),this._drawArrays(b.TRIANGLES,a),this.curStrokeShader.unbindShader()),!1!==this._doFill&&(this.curFillShader.bindShader(),c.vertexBuffer&&(this._bindBuffer(c.vertexBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aPosition.location,3,b.FLOAT,!1,0,0)),c.indexBuffer&&this._bindBuffer(c.indexBuffer,b.ELEMENT_ARRAY_BUFFER),c.normalBuffer&&(this._bindBuffer(c.normalBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aNormal.location,3,b.FLOAT,!1,0,0)),c.uvBuffer&&(this._bindBuffer(c.uvBuffer,b.ARRAY_BUFFER),this.curFillShader.enableAttrib(this.curFillShader.attributes.aTexCoord.location,2,b.FLOAT,!1,0,0)),this._applyColorBlend(this.curFillColor),this._drawElements(b.TRIANGLES,a),this.curFillShader.unbindShader()),this},d.RendererGL.prototype.drawBuffersScaled=function(a,b,c,d){var e=this.uMVMatrix.copy();try{this.uMVMatrix.scale(b,c,d),this.drawBuffers(a)}finally{this.uMVMatrix=e}},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":21}],72:[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 = 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}",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;\nvec3 scale = vec3(1.0);\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}"};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.attributes.perPixelLighting=void 0!==e.perPixelLighting&&e.perPixelLighting,this._initContext(),this.isP3D=!0,this.GL=this.drawingContext,this.ambientLightColors=[],this.directionalLightDirections=[],this.directionalLightColors=[],this.pointLightPositions=[],this.pointLightColors=[],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(b),this.camera(),this.gHash={},this._defaultLightShader=void 0,this._defaultImmediateModeShader=void 0,this._defaultNormalShader=void 0,this._defaultColorShader=void 0,this.curFillShader=void 0,this.curStrokeShader=void 0,this._useColorShader(),this.setStrokeShader(this._getLineShader()),this.isImmediateDrawing=!1,this.immediateMode={},this.fill(255,255,255,255),this.pointSize=5,this.strokeWeight(2),this.stroke(0,0,0),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),this._viewport=this.drawingContext.getParameter(this.drawingContext.VIEWPORT)}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;var i=new d.RendererGL(this._pInst.canvas,this._pInst,!0,a);this._pInst._setProperty("_renderer",i),i.resize(e,f),i._applyDefaults(),this._pInst._elements.push(i),"function"==typeof c&&setTimeout(function(){c.apply(window._renderer,b)},0)},d.prototype.setAttributes=function(a,b){var c;void 0!==b?(c={},c[a]=b):a instanceof Object&&(c=a),this._renderer._resetContext(c)},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.ambientLightColors.length=0,this.directionalLightDirections.length=0,this.directionalLightColors.length=0,this.pointLightPositions.length=0,this.pointLightColors.length=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.depthMask(!0),this.GL.clear(this.GL.COLOR_BUFFER_BIT|this.GL.DEPTH_BUFFER_BIT)},d.RendererGL.prototype.fill=function(a,b,c,f){var g=d.prototype.color.apply(this._pInst,arguments);this.curFillColor=g._array,this.isImmediateDrawing?this.setFillShader(this._getImmediateModeShader()):this.setFillShader(this._getColorShader()),this.drawMode=e.FILL,this.curFillShader.setUniform("uMaterialColor",this.curFillColor)},d.RendererGL.prototype.stroke=function(a,b,c,e){arguments[3]=255;var f=d.prototype.color.apply(this._pInst,arguments);this.curStrokeColor=f._array,this.curStrokeShader.setUniform("uMaterialColor",this.curStrokeColor)},d.RendererGL.prototype.strokeWeight=function(a){this.curStrokeWeight!==a&&(this.pointSize=a,this.curStrokeWeight=a,this.curStrokeShader.setUniform("uStrokeWeight",a))},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(!0!==this.attributes.preserveDrawingBuffer)return void console.log("loadPixels only works in WebGL when preserveDrawingBuffer is true.");var a=this._pInst._pixelDensity,b=this.width,c=this.height;b*=a,c*=a,void 0===this.pixels&&(this.pixels=new Uint8Array(this.GL.drawingBufferWidth*this.GL.drawingBufferHeight*4)),this.GL.readPixels(0,0,b,c,this.GL.RGBA,this.GL.UNSIGNED_BYTE,this.pixels),this._pInst._setProperty("pixels",this.pixels)},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),this._viewport=this.GL.getParameter(this.GL.VIEWPORT),null!==this._curCamera&&"default"!==this._curCamera||(this._curCamera=null,this._setDefaultCamera()),void 0!==this.pixels&&(this.pixels=new Uint8Array(this.GL.drawingBufferWidth*this.GL.drawingBufferHeight*4))},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 void 0===b?this.rotateZ(a):(d.Matrix.prototype.rotate.apply(this.uMVMatrix,arguments),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._pInst),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},d.RendererGL.prototype.setStrokeShader=function(a){return this.curStrokeShader!==a&&(this.curStrokeShader=a,this.curStrokeShader.init()),this.curStrokeShader},d.RendererGL.prototype._useLightShader=function(){return this.curFillShader&&this.curFillShader.isLightShader()||this.setFillShader(this._getLightShader()),this.curFillShader},d.RendererGL.prototype._useColorShader=function(){return this.curFillShader&&this.curFillShader!==this._defaultImmediateModeShader||this.setFillShader(this._getColorShader()),this.curFillShader},d.RendererGL.prototype._useImmediateModeShader=function(){return this.curFillShader&&this.curFillShader!==this._defaultColorShader||this.setFillShader(this._getImmediateModeShader()),this.curFillShader},d.RendererGL.prototype._getLightShader=function(){return this._defaultLightShader||(this.attributes.perPixelLighting?this._defaultLightShader=new d.Shader(this,h.phongVert,h.phongFrag):this._defaultLightShader=new d.Shader(this,h.lightVert,h.lightTextureFrag)),this._defaultLightShader},d.RendererGL.prototype._getImmediateModeShader=function(){return this._defaultImmediateModeShader||(this._defaultImmediateModeShader=new d.Shader(this,h.immediateVert,h.vertexColorFrag)),this._defaultImmediateModeShader},d.RendererGL.prototype._getNormalShader=function(){return this._defaultNormalShader||(this._defaultNormalShader=new d.Shader(this,h.normalVert,h.normalFrag)),this._defaultNormalShader},d.RendererGL.prototype._getColorShader=function(){return this._defaultColorShader||(this._defaultColorShader=new d.Shader(this,h.normalVert,h.basicFrag)),this._defaultColorShader},d.RendererGL.prototype._getLineShader=function(){return this._defaultLineShader||(this._defaultLineShader=new d.Shader(this,h.lineVert,h.lineFrag)),this._defaultLineShader},d.RendererGL.prototype._getEmptyTexture=function(){if(!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 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){if(0===a.length)return[];if(a.length>2e4){var b,c=Object.prototype.toString,d="[object Array]",e=[],f=a.slice();b=f.pop();do{c.call(b)===d?f.push.apply(f,b):e.push(b)}while(f.length&&void 0!==(b=f.pop()));return e.reverse(),e}return[].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":20,"../core/core":21,"../core/p5.Renderer":28,"./p5.Matrix":69,"./p5.Shader":73}],73:[function(a,b,c){"use strict";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?e.uniform1iv(d,b):e.uniform1i(d,b);break;case e.FLOAT:c.size>1?e.uniform1fv(d,b):e.uniform1f(d,b);break;case e.FLOAT_MAT3:e.uniformMatrix3fv(d,!1,b);break;case e.FLOAT_MAT4:e.uniformMatrix4fv(d,!1,b);break;case e.FLOAT_VEC2:c.size>1?e.uniform2fv(d,b):e.uniform2f(d,b[0],b[1]);break;case e.FLOAT_VEC3:c.size>1?e.uniform3fv(d,b):e.uniform3f(d,b[0],b[1],b[2]);break;case e.FLOAT_VEC4:c.size>1?e.uniform4fv(d,b):e.uniform4f(d,b[0],b[1],b[2],b[3]);break;case e.SAMPLER_2D:e.activeTexture(e.TEXTURE0+c.samplerIndex),c.texture=this._renderer.getTexture(b),e.uniform1i(c.location,c.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-1!==a&&(g.enableVertexAttribArray(a),g.vertexAttribPointer(a,b,c,d,e,f)),this},b.exports=d.Shader},{"../core/core":21}],74:[function(a,b,c){"use strict";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&&!(b instanceof d.Graphics),this.isSrcP5Image=b instanceof d.Image,this.isSrcP5Graphics=b instanceof d.Graphics;var e=this._getTextureDataFromSource();return this.width=e.width,this.height=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":21}],75:[function(a,b,c){"use strict";var d=a("../core/core");a("./p5.Geometry"),d.prototype.plane=function(a,b,c,e){void 0===a&&(a=50),void 0===b&&(b=a),void 0===c&&(c=1),void 0===e&&(e=1);var f="plane|"+c+"|"+e;if(!this._renderer.geometryInHash(f)){var g=function(){for(var a,b,c,e=0;e<=this.detailY;e++){b=e/this.detailY;for(var f=0;f<=this.detailX;f++)a=f/this.detailX,c=new d.Vector(a-.5,b-.5,0),this.vertices.push(c),this.uvs.push([a,b])}},h=new d.Geometry(c,e,g);h.computeFaces().computeNormals(),c<=1&&e<=1?(h._makeTriangleEdges(),this._renderer._edgesToVertices(h)):console.log("Cannot draw stroke on plane objects with more than 1 detailX or 1 detailY"),this._renderer.createBuffers(f,h)}this._renderer.drawBuffersScaled(f,a,b,0)},d.prototype.box=function(a,b,c,e,f){void 0===a&&(a=50),void 0===b&&(b=a),void 0===c&&(c=b),void 0===e&&(e=4),void 0===f&&(f=4);var g="box|"+e+"|"+f;if(!this._renderer.geometryInHash(g)){var h=function(){var a=[[0,4,2,6],[1,3,5,7],[0,1,4,5],[2,6,3,7],[0,2,1,3],[4,5,6,7]];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 b=0;bf?(r=c,q=1,p=b):p=a+i/f*(b-a),-2!==i&&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;i 0 && diff < record) { - record = diff; - closest = pipes[i]; - } - } - - if (closest != null) { - // Now create the inputs to the neural network - var inputs = []; - // x position of closest pipe - inputs[0] = map(closest.x, this.x, width, -1, 1); - // top of closest pipe opening - inputs[1] = map(closest.top, 0, height, -1, 1); - // bottom of closest pipe opening - inputs[2] = map(closest.bottom, 0, height, -1, 1); - // bird's y position - inputs[3] = map(this.y, 0, height, -1, 1); - // Get the outputs from the network - var action = this.brain.predict(inputs); - // Decide to jump or not! - if (action[1] > action[0]) { - this.up(); - } - } - } - - // Jump up - this.up = function() { - this.velocity += this.lift; - } - - // Update bird's position based on velocity, gravity, etc. - this.update = function() { - this.velocity += this.gravity; - this.velocity *= 0.9; - this.y += this.velocity; - - // Keep it stuck to top or bottom - if (this.y > height) { - this.y = height; - this.velocity = 0; - } - if (this.y < 0) { - this.y = 0; - this.velocity = 0; - } - - // Every frame it is alive increases the score - this.score++; - } -} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-1/index.html b/examples/neuroevolution-flappybird-1/index.html deleted file mode 100755 index 8e7acc3..0000000 --- a/examples/neuroevolution-flappybird-1/index.html +++ /dev/null @@ -1,30 +0,0 @@ - - - - - - - - - - - - - - - - -
-

- speed: 1 -
high score: 0 -
all time high score: 0 -

-

- -

- - - - - diff --git a/examples/neuroevolution-flappybird-1/libraries/p5.dom.js b/examples/neuroevolution-flappybird-1/libraries/p5.dom.js deleted file mode 100644 index 561d300..0000000 --- a/examples/neuroevolution-flappybird-1/libraries/p5.dom.js +++ /dev/null @@ -1,2190 +0,0 @@ -/*! p5.dom.js v0.3.2 March 25, 2017 */ -/** - *

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 - * - * 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 - * section for information on how to include this library. p5.dom comes with - * p5 complete or you can download the single file - * - * here.

- *

See tutorial: beyond the canvas - * for more info on how to use this libary. - * - * @module p5.dom - * @submodule p5.dom - * @for p5.dom - * @main - */ - -(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 -// ============================================================================= - - /** - * 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, - * 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 - * @example - *

- * function setup() { - * 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 d = document.getElementById('beep'); - * var e = select('p', d); - *
- * - */ - p5.prototype.select = function (e, p) { - var res = null; - var container = getContainer(p); - if (e[0] === '.'){ - e = e.slice(1); - res = container.getElementsByClassName(e); - if (res.length) { - res = res[0]; - } else { - res = null; - } - }else if (e[0] === '#'){ - e = e.slice(1); - res = container.getElementById(e); - }else { - res = container.getElementsByTagName(e); - if (res.length) { - res = res[0]; - } else { - res = null; - } - } - if (res) { - return wrapElement(res); - } else { - return null; - } - }; - - /** - * 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 - * in an array. - * The DOM node itself can be accessed with .elt. - * Returns an empty array if none found. - * You can also specify a container to search within. - * - * @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 - * @example - *
- * function setup() { - * createButton('btn'); - * createButton('2nd btn'); - * createButton('3rd btn'); - * var buttons = selectAll('button'); - * - * 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'); - * var d = select('#container'); - * var e = selectAll('p', d); - * var f = document.getElementById('beep'); - * var g = select('.blah', f); - *
- * - */ - p5.prototype.selectAll = function (e, p) { - var arr = []; - var res; - var container = getContainer(p); - if (e[0] === '.'){ - e = e.slice(1); - res = container.getElementsByClassName(e); - } else { - res = container.getElementsByTagName(e); - } - if (res) { - for (var j = 0; j < res.length; j++) { - var obj = wrapElement(res[j]); - arr.push(obj); - } - } - return arr; - }; - - /** - * Helper function for select and selectAll - */ - function getContainer(p) { - var container = document; - if (typeof p === 'string' && p[0] === '#'){ - p = p.slice(1); - container = document.getElementById(p) || document; - } else if (p instanceof p5.Element){ - container = p.elt; - } else if (p instanceof HTMLElement){ - container = p; - } - return container; - } - - /** - * 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; - }; - return converted; - } else if (elt.tagName === "VIDEO" || elt.tagName === "AUDIO") { - return new p5.MediaElement(elt); - } else { - return new p5.Element(elt); - } - } - - /** - * Removes all elements created by p5, except any canvas / graphics - * elements created by createCanvas or createGraphics. - * Event handlers are removed, and element is removed from the DOM. - * @method removeElements - * @example - *
- * function setup() { - * createCanvas(100, 100); - * createDiv('this is some text'); - * createP('this is a paragraph'); - * } - * function mousePressed() { - * removeElements(); // this will remove the div and p, not canvas - * } - *
- * - */ - p5.prototype.removeElements = function (e) { - for (var i=0; i - * var myDiv; - * function setup() { - * myDiv = createDiv('this is some text'); - * } - *
- */ - - /** - * Creates a <p></p> element in the DOM with given inner HTML. Used - * for paragraph length text. - * Appends to the container node if one is specified, otherwise - * appends to body. - * - * @method createP - * @param {String} html inner HTML for element created - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var myP; - * function setup() { - * myP = createP('this is some text'); - * } - *
- */ - - /** - * Creates a <span></span> element in the DOM with given inner HTML. - * Appends to the container node if one is specified, otherwise - * appends to body. - * - * @method createSpan - * @param {String} html inner HTML for element created - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var mySpan; - * function setup() { - * mySpan = createSpan('this is some text'); - * } - *
- */ - var tags = ['div', 'p', 'span']; - tags.forEach(function(tag) { - var method = 'create' + tag.charAt(0).toUpperCase() + tag.slice(1); - p5.prototype[method] = function(html) { - var elt = document.createElement(tag); - elt.innerHTML = typeof html === undefined ? "" : html; - return addElement(elt, this); - } - }); - - /** - * Creates an <img> element in the DOM with given src and - * alternate text. - * Appends to the container node if one is specified, otherwise - * appends to body. - * - * @method createImg - * @param {String} src src path or url for image - * @param {String} [alt] alternate text to be used if image does not load - * @param {Function} [successCallback] callback to be called once image data is loaded - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var img; - * function setup() { - * img = createImg('http://p5js.org/img/asterisk-01.png'); - * } - *
- */ - p5.prototype.createImg = function() { - var elt = document.createElement('img'); - var args = arguments; - var self; - var setAttrs = function(){ - self.width = elt.offsetWidth || elt.width; - self.height = elt.offsetHeight || elt.height; - if (args.length > 1 && typeof args[1] === 'function'){ - self.fn = args[1]; - self.fn(); - }else if (args.length > 1 && typeof args[2] === 'function'){ - self.fn = args[2]; - self.fn(); - } - }; - elt.src = args[0]; - if (args.length > 1 && typeof args[1] === 'string'){ - elt.alt = args[1]; - } - elt.onload = function(){ - setAttrs(); - } - self = addElement(elt, this); - return self; - }; - - /** - * Creates an <a></a> element in the DOM for including a hyperlink. - * Appends to the container node if one is specified, otherwise - * appends to body. - * - * @method createA - * @param {String} href url of page to link to - * @param {String} html inner html of link element to display - * @param {String} [target] target where new link should open, - * could be _blank, _self, _parent, _top. - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var myLink; - * function setup() { - * myLink = createA('http://p5js.org/', 'this is a link'); - * } - *
- */ - p5.prototype.createA = function(href, html, target) { - var elt = document.createElement('a'); - elt.href = href; - elt.innerHTML = html; - if (target) elt.target = target; - return addElement(elt, this); - }; - - /** INPUT **/ - - - /** - * Creates a slider <input></input> element in the DOM. - * Use .size() to set the display length of the slider. - * Appends to the container node if one is specified, otherwise - * appends to body. - * - * @method createSlider - * @param {Number} min minimum value of the slider - * @param {Number} max maximum value of the slider - * @param {Number} [value] default value of the slider - * @param {Number} [step] 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) - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var slider; - * function setup() { - * slider = createSlider(0, 255, 100); - * slider.position(10, 10); - * slider.style('width', '80px'); - * } - * - * function draw() { - * var val = slider.value(); - * background(val); - * } - *
- * - *
- * var slider; - * function setup() { - * colorMode(HSB); - * slider = createSlider(0, 360, 60, 40); - * slider.position(10, 10); - * slider.style('width', '80px'); - * } - * - * function draw() { - * var val = slider.value(); - * background(val, 100, 100, 1); - * } - *
- */ - p5.prototype.createSlider = function(min, max, value, step) { - var elt = document.createElement('input'); - elt.type = 'range'; - elt.min = min; - elt.max = max; - if (step === 0) { - elt.step = .000000000000000001; // smallest valid step - } else if (step) { - elt.step = step; - } - if (typeof(value) === "number") elt.value = value; - return addElement(elt, this); - }; - - /** - * Creates a <button></button> element in the DOM. - * Use .size() to set the display size of the button. - * Use .mousePressed() to specify behavior on press. - * Appends to the container node if one is specified, otherwise - * appends to body. - * - * @method createButton - * @param {String} label label displayed on the button - * @param {String} [value] value of the button - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var button; - * function setup() { - * createCanvas(100, 100); - * background(0); - * button = createButton('click me'); - * button.position(19, 19); - * button.mousePressed(changeBG); - * } - * - * function changeBG() { - * var val = random(255); - * background(val); - * } - *
- */ - p5.prototype.createButton = function(label, value) { - var elt = document.createElement('button'); - elt.innerHTML = label; - elt.value = value; - if (value) elt.value = value; - return addElement(elt, this); - }; - - /** - * Creates a checkbox <input></input> element in the DOM. - * Calling .checked() on a checkbox returns if it is checked or not - * - * @method createCheckbox - * @param {String} [label] label displayed after checkbox - * @param {boolean} [value] value of the checkbox; checked is true, unchecked is false.Unchecked if no value given - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var checkbox; - * - * function setup() { - * checkbox = createCheckbox('label', false); - * checkbox.changed(myCheckedEvent); - * } - * - * function myCheckedEvent() { - * if (this.checked()) { - * console.log("Checking!"); - * } else { - * console.log("Unchecking!"); - * } - * } - *
- */ - p5.prototype.createCheckbox = function() { - var elt = document.createElement('div'); - var checkbox = document.createElement('input'); - checkbox.type = 'checkbox'; - elt.appendChild(checkbox); - //checkbox must be wrapped in p5.Element before label so that label appears after - var self = addElement(elt, this); - self.checked = function(){ - var cb = self.elt.getElementsByTagName('input')[0]; - if (cb) { - if (arguments.length === 0){ - return cb.checked; - }else if(arguments[0]){ - cb.checked = true; - }else{ - cb.checked = false; - } - } - return self; - }; - this.value = function(val){ - self.value = val; - return this; - }; - if (arguments[0]){ - var ran = Math.random().toString(36).slice(2); - var label = document.createElement('label'); - checkbox.setAttribute('id', ran); - label.htmlFor = ran; - self.value(arguments[0]); - label.appendChild(document.createTextNode(arguments[0])); - elt.appendChild(label); - } - if (arguments[1]){ - checkbox.checked = true; - } - return self; - }; - - /** - * Creates a dropdown menu <select></select> element in the DOM. - * @method createSelect - * @param {boolean} [multiple] true if dropdown should support multiple selections - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var sel; - * - * function setup() { - * textAlign(CENTER); - * background(200); - * sel = createSelect(); - * sel.position(10, 10); - * sel.option('pear'); - * sel.option('kiwi'); - * sel.option('grape'); - * sel.changed(mySelectEvent); - * } - * - * function mySelectEvent() { - * var item = sel.value(); - * background(200); - * text("it's a "+item+"!", 50, 50); - * } - *
- */ - p5.prototype.createSelect = function(mult) { - var elt = document.createElement('select'); - if (mult){ - elt.setAttribute('multiple', 'true'); - } - var self = addElement(elt, this); - self.option = function(name, value){ - var opt = document.createElement('option'); - opt.innerHTML = name; - if (arguments.length > 1) - opt.value = value; - else - opt.value = name; - elt.appendChild(opt); - }; - self.selected = function(value){ - var arr = []; - if (arguments.length > 0){ - for (var i = 0; i < this.elt.length; i++){ - if (value.toString() === this.elt[i].value){ - this.elt.selectedIndex = i; - } - } - return this; - }else{ - if (mult){ - for (var i = 0; i < this.elt.selectedOptions.length; i++){ - arr.push(this.elt.selectedOptions[i].value); - } - return arr; - }else{ - return this.elt.value; - } - } - }; - return self; - }; - - /** - * Creates a radio button <input></input> element in the DOM. - * The .option() method can be used to set options for the radio after it is - * created. The .value() method will return the currently selected option. - * - * @method createRadio - * @param {String} [divId] the id and name of the created div and input field respectively - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * var radio; - * - * function setup() { - * radio = createRadio(); - * radio.option("black"); - * radio.option("white"); - * radio.option("gray"); - * radio.style('width', '60px'); - * textAlign(CENTER); - * fill(255, 0, 0); - * } - * - * function draw() { - * var val = radio.value(); - * background(val); - * text(val, width/2, height/2); - * } - *
- *
- * var radio; - * - * function setup() { - * radio = createRadio(); - * radio.option('apple', 1); - * radio.option('bread', 2); - * radio.option('juice', 3); - * radio.style('width', '60px'); - * textAlign(CENTER); - * } - * - * function draw() { - * background(200); - * var val = radio.value(); - * if (val) { - * text('item cost is $'+val, width/2, height/2); - * } - * } - *
- */ - p5.prototype.createRadio = function() { - var radios = document.querySelectorAll("input[type=radio]"); - var count = 0; - if(radios.length > 1){ - var length = radios.length; - var prev=radios[0].name; - var current = radios[1].name; - count = 1; - for(var i = 1; i < length; i++) { - current = radios[i].name; - if(prev != current){ - count++; - } - prev = current; - } - } - else if (radios.length == 1){ - count = 1; - } - var elt = document.createElement('div'); - var self = addElement(elt, this); - var times = -1; - self.option = function(name, value){ - var opt = document.createElement('input'); - opt.type = 'radio'; - opt.innerHTML = name; - if (arguments.length > 1) - opt.value = value; - else - opt.value = name; - opt.setAttribute('name',"defaultradio"+count); - elt.appendChild(opt); - if (name){ - times++; - var ran = Math.random().toString(36).slice(2); - var label = document.createElement('label'); - opt.setAttribute('id', "defaultradio"+count+"-"+times); - label.htmlFor = "defaultradio"+count+"-"+times; - label.appendChild(document.createTextNode(name)); - elt.appendChild(label); - } - return opt; - }; - self.selected = function(){ - var length = this.elt.childNodes.length; - if(arguments.length == 1) { - for (var i = 0; i < length; i+=2){ - if(this.elt.childNodes[i].value == arguments[0]) - this.elt.childNodes[i].checked = true; - } - return this; - } else { - for (var i = 0; i < length; i+=2){ - if(this.elt.childNodes[i].checked == true) - return this.elt.childNodes[i].value; - } - } - }; - self.value = function(){ - var length = this.elt.childNodes.length; - if(arguments.length == 1) { - for (var i = 0; i < length; i+=2){ - if(this.elt.childNodes[i].value == arguments[0]) - this.elt.childNodes[i].checked = true; - } - return this; - } else { - for (var i = 0; i < length; i+=2){ - if(this.elt.childNodes[i].checked == true) - return this.elt.childNodes[i].value; - } - return ""; - } - }; - return self - }; - - /** - * Creates an <input></input> element in the DOM for text input. - * 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} [type] type of text, ie text, password etc. Defaults to text - * @return {Object|p5.Element} pointer to p5.Element holding created node - * @example - *
- * function setup(){ - * var inp = createInput(''); - * inp.input(myInputEvent); - * } - * - * function myInputEvent(){ - * console.log('you are typing: ', this.value()); - * } - * - *
- */ - p5.prototype.createInput = function(value, type) { - var elt = document.createElement('input'); - elt.type = type ? type : 'text'; - if (value) elt.value = value; - return addElement(elt, this); - }; - - /** - * Creates an <input></input> element in the DOM of type 'file'. - * This allows users to select local files for use in a sketch. - * - * @method createFileInput - * @param {Function} [callback] callback function for when a file loaded - * @param {String} [multiple] optional to allow multiple files selected - * @return {Object|p5.Element} pointer to p5.Element holding created DOM element - * @example - * var input; - * var img; - * - * function setup() { - * input = createFileInput(handleFile); - * input.position(0, 0); - * } - * - * function draw() { - * if (img) { - * image(img, 0, 0, width, height); - * } - * } - * - * function handleFile(file) { - * print(file); - * if (file.type === 'image') { - * img = createImg(file.data); - * img.hide(); - * } - * } - */ - p5.prototype.createFileInput = function(callback, multiple) { - - // Is the file stuff supported? - if (window.File && window.FileReader && window.FileList && window.Blob) { - // Yup, we're ok and make an input file selector - var elt = document.createElement('input'); - elt.type = 'file'; - - // If we get a second argument that evaluates to true - // then we are looking for multiple files - if (multiple) { - // Anything gets the job done - elt.multiple = 'multiple'; - } - - // Function to handle when a file is selected - // We're simplifying life and assuming that we always - // want to load every selected file - function handleFileSelect(evt) { - // These are the files - var files = evt.target.files; - // Load each one and trigger a callback - for (var i = 0; i < files.length; i++) { - var f = files[i]; - var reader = new FileReader(); - function makeLoader(theFile) { - // Making a p5.File object - var p5file = new p5.File(theFile); - return function(e) { - p5file.data = e.target.result; - callback(p5file); - }; - }; - 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); - } - } - } - - // Now let's handle when a file was selected - elt.addEventListener('change', handleFileSelect, false); - return addElement(elt, this); - } else { - console.log('The File APIs are not fully supported in this browser. Cannot create element.'); - } - }; - - - /** VIDEO STUFF **/ - - function createMedia(pInst, type, src, callback) { - var elt = document.createElement(type); - - // allow src to be empty - var src = src || ''; - if (typeof src === 'string') { - src = [src]; - } - for (var i=0; i - * - * - * @alt - * no display. - * - */ -p5.Element.prototype.mouseClicked = function (fxn) { - attachListener('click', fxn, this); - return this; -}; - -/** - * 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. - * - * @method mouseMoved - * @param {Function} fxn function to be fired when mouse is - * moved over the element. - * @return {p5.Element} - * @example - *
- * var cnv; - * var d = 30; - * var g; - * function setup() { - * cnv = createCanvas(100, 100); - * cnv.mouseMoved(changeSize); // attach listener for - * // activity on canvas only - * d = 10; - * g = 100; - * } - * - * function draw() { - * background(g); - * fill(200); - * ellipse(width/2, height/2, d, d); - * } - * - * // this function fires when mouse moves anywhere on - * // page - * function mouseMoved() { - * g = g + 5; - * if (g > 255) { - * g = 0; - * } - * } - * - * // this function fires when mouse moves over canvas - * function changeSize() { - * d = d + 2; - * if (d > 100) { - * d = 0; - * } - * } - *
- * - * - * @alt - * no display. - * - */ -p5.Element.prototype.mouseMoved = function (fxn) { - attachListener('mousemove', fxn, this); - attachListener('touchmove', fxn, this); - return this; -}; - -/** - * 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. - * - * @method mouseOver - * @param {Function} fxn function to be fired when mouse is - * moved over the element. - * @return {p5.Element} - * @example - *
- * var cnv; - * var d; - * var g; - * function setup() { - * cnv = createCanvas(100, 100); - * cnv.mouseOver(changeGray); - * d = 10; - * } - * - * function draw() { - * ellipse(width/2, height/2, d, d); - * } - * - * function changeGray() { - * d = d + 10; - * if (d > 100) { - * d = 0; - * } - * } - *
- * - * - * @alt - * no display. - * - */ -p5.Element.prototype.mouseOver = function (fxn) { - attachListener('mouseover', fxn, this); - return this; -}; - - -/** - * The .changed() function is called when the value of an - * element is changed. - * This can be used to attach an element specific event listener. - * - * @method changed - * @param {Function} fxn function to be fired when the value of an - * element changes. - * @return {p5.Element} - * @example - *
- * var sel; - * - * function setup() { - * textAlign(CENTER); - * background(200); - * sel = createSelect(); - * sel.position(10, 10); - * sel.option('pear'); - * sel.option('kiwi'); - * sel.option('grape'); - * sel.changed(mySelectEvent); - * } - * - * function mySelectEvent() { - * var item = sel.value(); - * background(200); - * text("it's a "+item+"!", 50, 50); - * } - *
- *
- * var checkbox; - * var cnv; - * - * function setup() { - * checkbox = createCheckbox(" fill"); - * checkbox.changed(changeFill); - * cnv = createCanvas(100, 100); - * cnv.position(0, 30); - * noFill(); - * } - * - * function draw() { - * background(200); - * ellipse(50, 50, 50, 50); - * } - * - * function changeFill() { - * if (checkbox.checked()) { - * fill(0); - * } else { - * noFill(); - * } - * } - *
- * - * @alt - * dropdown: pear, kiwi, grape. When selected text "its a" + selection shown. - * - */ -p5.Element.prototype.changed = function (fxn) { - attachListener('change', fxn, this); - return this; -}; - -/** - * 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 - * event listener. - * - * @method input - * @param {Function} fxn function to be fired on user input. - * @return {p5.Element} - * @example - *
- * // Open your console to see the output - * function setup() { - * var inp = createInput(''); - * inp.input(myInputEvent); - * } - * - * function myInputEvent() { - * console.log('you are typing: ', this.value()); - * } - *
- * - * @alt - * no display. - * - */ -p5.Element.prototype.input = function (fxn) { - attachListener('input', fxn, this); - return this; -}; - -/** - * 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. - * - * @method mouseOut - * @param {Function} fxn function to be fired when mouse is - * moved off the element. - * @return {p5.Element} - * @example - *
- * var cnv; - * var d; - * var g; - * function setup() { - * cnv = createCanvas(100, 100); - * cnv.mouseOut(changeGray); - * d = 10; - * } - * - * function draw() { - * ellipse(width/2, height/2, d, d); - * } - * - * function changeGray() { - * d = d + 10; - * if (d > 100) { - * d = 0; - * } - * } - *
- * - * @alt - * no display. - * - */ -p5.Element.prototype.mouseOut = function (fxn) { - attachListener('mouseout', fxn, this); - return this; -}; - -/** - * 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 - * @param {Function} fxn function to be fired when touch is - * started over the element. - * @return {p5.Element} - * @example - *
- * var cnv; - * var d; - * var g; - * function setup() { - * cnv = createCanvas(100, 100); - * cnv.touchStarted(changeGray); // attach listener for - * // canvas click only - * d = 10; - * g = 100; - * } - * - * function draw() { - * background(g); - * ellipse(width/2, height/2, d, d); - * } - * - * // this function fires with any touch anywhere - * function touchStarted() { - * d = d + 10; - * } - * - * // this function fires only when cnv is clicked - * function changeGray() { - * g = random(0, 255); - * } - *
- * - * @alt - * no display. - * - */ -p5.Element.prototype.touchStarted = function (fxn) { - attachListener('touchstart', fxn, this); - attachListener('mousedown', fxn, this); - return this; -}; - -/** - * 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 - * @param {Function} fxn function to be fired when touch is moved - * over the element. - * @return {p5.Element} - * @example - *
- * var cnv; - * var g; - * function setup() { - * cnv = createCanvas(100, 100); - * cnv.touchMoved(changeGray); // attach listener for - * // canvas click only - * g = 100; - * } - * - * function draw() { - * background(g); - * } - * - * // this function fires only when cnv is clicked - * function changeGray() { - * g = random(0, 255); - * } - *
- * - * @alt - * no display. - * - */ -p5.Element.prototype.touchMoved = function (fxn) { - attachListener('touchmove', fxn, this); - attachListener('mousemove', fxn, this); - return this; -}; - -/** - * 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 - * @param {Function} fxn function to be fired when touch is - * ended over the element. - * @return {p5.Element} - * @example - *
- * var cnv; - * var d; - * var g; - * function setup() { - * cnv = createCanvas(100, 100); - * cnv.touchEnded(changeGray); // attach listener for - * // canvas click only - * d = 10; - * g = 100; - * } - * - * function draw() { - * background(g); - * ellipse(width/2, height/2, d, d); - * } - * - * // this function fires with any touch anywhere - * function touchEnded() { - * d = d + 10; - * } - * - * // this function fires only when cnv is clicked - * function changeGray() { - * g = random(0, 255); - * } - *
- * - * - * @alt - * no display. - * - */ -p5.Element.prototype.touchEnded = function (fxn) { - attachListener('touchend', fxn, this); - attachListener('mouseup', fxn, this); - return this; -}; - - - -/** - * 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. - * - * @method dragOver - * @param {Function} fxn function to be fired when mouse is - * dragged over the element. - * @return {p5.Element} - */ -p5.Element.prototype.dragOver = function (fxn) { - attachListener('dragover', fxn, this); - return this; -}; - -/** - * The .dragLeave() function is called once after every time a - * dragged file leaves the element area. This can be used to attach an - * element specific event listener. - * - * @method dragLeave - * @param {Function} fxn function to be fired when mouse is - * dragged over the element. - * @return {p5.Element} - */ -p5.Element.prototype.dragLeave = function (fxn) { - attachListener('dragleave', fxn, this); - return this; -}; - -/** - * 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} callback callback triggered when files are dropped. - * @param {Function} fxn callback to receive loaded file. - * @return {p5.Element} - * @example - *
- * function setup() { - * var c = createCanvas(100, 100); - * background(200); - * textAlign(CENTER); - * text('drop image', 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); - * } - *
- * - * @alt - * Canvas turns into whatever image is dragged/dropped onto it. - * - */ -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 - var p5file = new p5.File(theFile); - return function(e) { - p5file.data = e.target.result; - callback(p5file); - }; - } - - // 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); - - // If this is a drag area we need to turn off the default behavior - attachListener('dragleave',function(evt) { - evt.stopPropagation(); - evt.preventDefault(); - },this); - - // If just one argument it's the callback for the files - if (arguments.length > 1) { - 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); - } - } - }, this); - } else { - console.log('The File APIs are not fully supported in this browser.'); - } - - return this; -}; - - - - -function attachListener(ev, fxn, ctx) { - // LM removing, not sure why we had this? - // var _this = ctx; - // var f = function (e) { fxn(e, _this); }; - var f = fxn.bind(ctx); - ctx.elt.addEventListener(ev, f, false); - ctx._events[ev] = f; -} - -/** - * Helper fxn for sharing pixel methods - * - */ -p5.Element.prototype._setProperty = function (prop, value) { - this[prop] = value; -}; - - -module.exports = p5.Element; - -},{"./core":42}],47:[function(_dereq_,module,exports){ -/** - * @module Rendering - * @submodule Rendering - * @for p5 - */ - -var p5 = _dereq_('./core'); -var constants = _dereq_('./constants'); - -/** - * Thin wrapper around a renderer, to be used for creating a - * graphics buffer 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. The fields and methods for this class are - * extensive, but mirror the normal drawing API for p5. - * - * @class p5.Graphics - * @constructor - * @extends p5.Element - * @param {String} elt DOM node that is wrapped - * @param {Object} [pInst] pointer to p5 instance - * @param {Boolean} whether we're using it as main canvas - */ -p5.Graphics = function(w, h, renderer, pInst) { - - var r = renderer || constants.P2D; - - var c = document.createElement('canvas'); - var node = this._userNode || document.body; - node.appendChild(c); - - p5.Element.call(this, c, pInst, false); - this._styles = []; - this.width = w; - this.height = h; - this._pixelDensity = pInst._pixelDensity; - - if (r === constants.WEBGL) { - this._renderer = new p5.RendererGL(c, this, false); - } else { - this._renderer = new p5.Renderer2D(c, this, false); - } - - 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]; - } - } - } - - return this; -}; - -p5.Graphics.prototype = Object.create(p5.Element.prototype); - -p5.Graphics.prototype.remove = function() { - if (this.elt.parentNode) { - this.elt.parentNode.removeChild(this.elt); - } - for (var elt_ev in this._events) { - this.elt.removeEventListener(elt_ev, this._events[elt_ev]); - } -}; - -module.exports = p5.Graphics; - -},{"./constants":41,"./core":42}],48:[function(_dereq_,module,exports){ -/** - * @module Rendering - * @submodule Rendering - * @for p5 - */ - -var p5 = _dereq_('./core'); -var constants = _dereq_('../core/constants'); - -/** - * Main graphics and rendering context, as well as the base API - * implementation for p5.js "core". To be used as the superclass for - * Renderer2D and Renderer3D classes, respecitvely. - * - * @class p5.Renderer - * @constructor - * @extends p5.Element - * @param {String} elt DOM node that is wrapped - * @param {Object} [pInst] pointer to p5 instance - * @param {Boolean} whether we're using it as main canvas - */ -p5.Renderer = function(elt, pInst, isMainCanvas) { - p5.Element.call(this, elt, pInst); - this.canvas = elt; - this._pInst = pInst; - if (isMainCanvas) { - this._isMainCanvas = true; - // for pixel method sharing with pimage - this._pInst._setProperty('_curElement', this); - 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 - 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._rectMode = constants.CORNER; - this._ellipseMode = constants.CENTER; - this._curveTightness = 0; - this._imageMode = constants.CORNER; - - this._tint = null; - this._doStroke = true; - 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); - - - - -/** - * Resize our canvas element. - */ -p5.Renderer.prototype.resize = function(w, h) { - this.width = w; - 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.height = h + 'px'; - if (this._isMainCanvas) { - this._pInst._setProperty('width', this.width); - this._pInst._setProperty('height', this.height); - } -}; - -p5.Renderer.prototype.textLeading = function(l) { - - if (arguments.length && arguments[0]) { - - this._setProperty('_textLeading', l); - return this; - } - - return this._textLeading; -}; - -p5.Renderer.prototype.textSize = function(s) { - - if (arguments.length && arguments[0]) { - - this._setProperty('_textSize', s); - this._setProperty('_textLeading', s * constants._DEFAULT_LEADMULT); - return this._applyTextProperties(); - } - - return this._textSize; -}; - -p5.Renderer.prototype.textStyle = function(s) { - - if (arguments.length && arguments[0]) { - - if (s === constants.NORMAL || - s === constants.ITALIC || - s === constants.BOLD) { - this._setProperty('_textStyle', s); - } - - return this._applyTextProperties(); - } - - return this._textStyle; -}; - -p5.Renderer.prototype.textAscent = function() { - if (this._textAscent === null) { - this._updateTextMetrics(); - } - return this._textAscent; -}; - -p5.Renderer.prototype.textDescent = function() { - - if (this._textDescent === null) { - this._updateTextMetrics(); - } - return this._textDescent; -}; - -p5.Renderer.prototype._applyDefaults = function(){ - return this; -}; - -/** - * 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); -}; - -p5.Renderer.prototype._updateTextMetrics = function() { - - if (this._isOpenType()) { - - this._setProperty('_textAscent', this._textFont._textAscent()); - this._setProperty('_textDescent', this._textFont._textDescent()); - return this; - } - - // Adapted from http://stackoverflow.com/a/25355178 - var text = document.createElement('span'); - text.style.fontFamily = this._textFont; - text.style.fontSize = this._textSize + 'px'; - text.innerHTML = 'ABCjgq|'; - - var block = document.createElement('div'); - block.style.display = 'inline-block'; - block.style.width = '1px'; - block.style.height = '0px'; - - var container = document.createElement('div'); - container.appendChild(text); - container.appendChild(block); - - container.style.height = '0px'; - container.style.overflow = 'hidden'; - document.body.appendChild(container); - - block.style.verticalAlign = 'baseline'; - var blockOffset = calculateOffset(block); - var textOffset = calculateOffset(text); - var ascent = blockOffset[1] - textOffset[1]; - - block.style.verticalAlign = 'bottom'; - blockOffset = calculateOffset(block); - textOffset = calculateOffset(text); - var height = blockOffset[1] - textOffset[1]; - var descent = height - ascent; - - document.body.removeChild(container); - - this._setProperty('_textAscent', ascent); - this._setProperty('_textDescent', descent); - - return this; -}; - -/** - * Helper fxn to measure ascent and descent. - * Adapted from http://stackoverflow.com/a/25355178 - */ -function calculateOffset(object) { - var currentLeft = 0, - currentTop = 0; - if (object.offsetParent) { - do { - currentLeft += object.offsetLeft; - currentTop += object.offsetTop; - } while (object = object.offsetParent); - } else { - currentLeft += object.offsetLeft; - currentTop += object.offsetTop; - } - return [currentLeft, currentTop]; -} - -module.exports = p5.Renderer; - -},{"../core/constants":41,"./core":42}],49:[function(_dereq_,module,exports){ - -var p5 = _dereq_('./core'); -var canvas = _dereq_('./canvas'); -var constants = _dereq_('./constants'); -var filters = _dereq_('../image/filters'); - -_dereq_('./p5.Renderer'); - -/** - * p5.Renderer2D - * The 2D graphics canvas renderer class. - * extends p5.Renderer - */ -var styleEmpty = 'rgba(0,0,0,0)'; -// var alphaThreshold = 0.00125; // minimum visible - -p5.Renderer2D = function(elt, pInst, isMainCanvas){ - p5.Renderer.call(this, elt, pInst, isMainCanvas); - this.drawingContext = this.canvas.getContext('2d'); - this._pInst._setProperty('drawingContext', this.drawingContext); - return this; -}; - -p5.Renderer2D.prototype = Object.create(p5.Renderer.prototype); - -p5.Renderer2D.prototype._applyDefaults = function() { - this.drawingContext.fillStyle = constants._DEFAULT_FILL; - this.drawingContext.strokeStyle = constants._DEFAULT_STROKE; - this.drawingContext.lineCap = constants.ROUND; - 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); -}; - -////////////////////////////////////////////// -// COLOR | Setting -////////////////////////////////////////////// - -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); - - if (arguments[0] instanceof p5.Image) { - this._pInst.image(arguments[0], 0, 0, this.width, this.height); - } else { - var curFill = this.drawingContext.fillStyle; - // create background rect - var color = this._pInst.color.apply(this, arguments); - var newFill = color.toString(); - this.drawingContext.fillStyle = newFill; - this.drawingContext.fillRect(0, 0, this.width, this.height); - // reset fill - this.drawingContext.fillStyle = curFill; - } - this.drawingContext.restore(); -}; - -p5.Renderer2D.prototype.clear = function() { - this.drawingContext.clearRect(0, 0, this.width, this.height); -}; - -p5.Renderer2D.prototype.fill = function() { - - var ctx = this.drawingContext; - var color = this._pInst.color.apply(this, arguments); - ctx.fillStyle = color.toString(); -}; - -p5.Renderer2D.prototype.stroke = function() { - var ctx = this.drawingContext; - var color = this._pInst.color.apply(this, arguments); - ctx.strokeStyle = color.toString(); -}; - -////////////////////////////////////////////// -// IMAGE | Loading & Displaying -////////////////////////////////////////////// - -p5.Renderer2D.prototype.image = - function (img, sx, sy, sWidth, sHeight, dx, dy, dWidth, dHeight) { - var cnv; - try { - if (this._tint) { - if (p5.MediaElement && img instanceof p5.MediaElement) { - img.loadPixels(); - } - if (img.canvas) { - cnv = this._getTintedImageCanvas(img); - } - } - if (!cnv) { - cnv = img.canvas || img.elt; - } - this.drawingContext.drawImage(cnv, sx, sy, sWidth, sHeight, dx, dy, - dWidth, dHeight); - } catch (e) { - if (e.name !== 'NS_ERROR_NOT_AVAILABLE') { - throw e; - } - } -}; - -p5.Renderer2D.prototype._getTintedImageCanvas = function (img) { - if (!img.canvas) { - return img; - } - var pixels = filters._toPixels(img.canvas); - var tmpCanvas = document.createElement('canvas'); - tmpCanvas.width = img.canvas.width; - tmpCanvas.height = img.canvas.height; - var tmpCtx = tmpCanvas.getContext('2d'); - var id = tmpCtx.createImageData(img.canvas.width, img.canvas.height); - var newPixels = id.data; - 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]; - newPixels[i] = r * this._tint[0] / 255; - newPixels[i + 1] = g * this._tint[1] / 255; - newPixels[i + 2] = b * this._tint[2] / 255; - newPixels[i + 3] = a * this._tint[3] / 255; - } - tmpCtx.putImageData(id, 0, 0); - return tmpCanvas; -}; - - -////////////////////////////////////////////// -// IMAGE | Pixels -////////////////////////////////////////////// - -p5.Renderer2D.prototype.blendMode = function(mode) { - this.drawingContext.globalCompositeOperation = mode; -}; -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 - ); - - this.drawingContext.globalCompositeOperation = blendMode; - if (this._pInst) { - this._pInst.copy.apply(this._pInst, copyArgs); - } else { - this.copy.apply(this, copyArgs); - } - this.drawingContext.globalCompositeOperation = currBlend; -}; - -p5.Renderer2D.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._pInst; - 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(srcImage, sx, sy, sw, sh, dx, dy, dw, dh); -}; - -p5.Renderer2D._copyHelper = -function (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); -}; - -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 the section does not overlap the canvas - if(x + w < 0 || y + h < 0 || x > this.width || y > this.height){ - return [0, 0, 0, 255]; - } - - var ctx = this._pInst || this; - ctx.loadPixels(); - - var pd = ctx._pixelDensity; - - // round down to get integer numbers - x = Math.floor(x); - y = Math.floor(y); - w = Math.floor(w); - h = Math.floor(h); - - var sx = x * pd; - var sy = y * pd; - if (w === 1 && h === 1){ - var imageData = this.drawingContext.getImageData(sx, sy, 1, 1).data; - //imageData = [0,0,0,0]; - return [ - imageData[0], - imageData[1], - imageData[2], - imageData[3] - ]; - } else { - //auto constrain the width and height to - //dimensions of the source image - var dw = Math.min(w, ctx.width); - var dh = Math.min(h, ctx.height); - var sw = dw * pd; - 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); - - return region; - } -}; - -p5.Renderer2D.prototype.loadPixels = function () { - var pd = this._pixelDensity || this._pInst._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); - } -}; - -p5.Renderer2D.prototype.set = function (x, y, imgOrCol) { - // round down to get integer numbers - x = Math.floor(x); - y = Math.floor(y); - 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.drawImage(imgOrCol.canvas, x, y); - this.loadPixels.call(this._pInst); - this.drawingContext.restore(); - } 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) { - ctx.loadPixels.call(ctx); - } - if (typeof imgOrCol === 'number') { - if (idx < ctx.pixels.length) { - r = imgOrCol; - g = imgOrCol; - b = imgOrCol; - a = 255; - //this.updatePixels.call(this); - } - } - else if (imgOrCol instanceof Array) { - if (imgOrCol.length < 4) { - throw new Error('pixel array must be of the form [R, G, B, A]'); - } - if (idx < ctx.pixels.length) { - r = imgOrCol[0]; - g = imgOrCol[1]; - b = imgOrCol[2]; - a = imgOrCol[3]; - //this.updatePixels.call(this); - } - } else if (imgOrCol instanceof p5.Color) { - if (idx < ctx.pixels.length) { - r = imgOrCol.levels[0]; - g = imgOrCol.levels[1]; - b = imgOrCol.levels[2]; - a = imgOrCol.levels[3]; - //this.updatePixels.call(this); - } - } - // loop over pixelDensity * pixelDensity - 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)); - ctx.pixels[idx] = r; - 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) { - x = 0; - y = 0; - w = this.width; - h = this.height; - } - 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); - } -}; - -////////////////////////////////////////////// -// SHAPE | 2D Primitives -////////////////////////////////////////////// - -/** - * Generate a cubic Bezier representing an arc on the unit circle of total - * angle `size` radians, beginning `start` radians above the x-axis. Up to - * four of these curves are combined to make a full arc. - * - * See www.joecridge.me/bezier.pdf for an explanation of the method. - */ -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. - cos_phi = Math.cos(phi), - sin_phi = Math.sin(phi), - lambda = (4.0 - cos_alpha) / 3.0, - mu = sin_alpha + (cos_alpha - lambda) * cot_alpha; - - // Return rotated waypoints. - return { - ax: Math.cos(start), - ay: Math.sin(start), - bx: lambda * cos_phi + mu * sin_phi, - by: lambda * sin_phi - mu * cos_phi, - cx: lambda * cos_phi - mu * sin_phi, - cy: lambda * sin_phi + mu * cos_phi, - dx: Math.cos(start + size), - dy: Math.sin(start + size) - }; -}; - -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 arcToDraw = 0; - var curves = []; - - // Create curves - while(stop - start > epsilon) { - arcToDraw = Math.min(stop - start, constants.HALF_PI); - curves.push(this._acuteArcToBezier(start, arcToDraw)); - start += arcToDraw; - } - - // Fill curves - if (this._doFill) { - ctx.beginPath(); - curves.forEach(function (curve, index) { - if (index === 0) { - ctx.moveTo(vals.x + curve.ax * rx, vals.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); - }); - if (mode === constants.PIE || mode == null) { - ctx.lineTo(vals.x, vals.y); - } - ctx.closePath(); - ctx.fill(); - } - - // Stroke curves - if (this._doStroke) { - ctx.beginPath(); - curves.forEach(function (curve, index) { - if (index === 0) { - ctx.moveTo(vals.x + curve.ax * rx, vals.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); - }); - if (mode === constants.PIE) { - ctx.lineTo(vals.x, vals.y); - ctx.closePath(); - } else if (mode === constants.CHORD) { - ctx.closePath(); - } - ctx.stroke(); - } - return this; -}; - -p5.Renderer2D.prototype.ellipse = function(args) { - var ctx = this.drawingContext; - var doFill = this._doFill, doStroke = this._doStroke; - var x = args[0], - y = args[1], - w = args[2], - h = args[3]; - if (doFill && !doStroke) { - if(ctx.fillStyle === styleEmpty) { - return this; - } - } else if (!doFill && doStroke) { - if(ctx.strokeStyle === 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 - ctx.beginPath(); - ctx.moveTo(x, ym); - ctx.bezierCurveTo(x, ym - oy, xm - ox, y, xm, y); - ctx.bezierCurveTo(xm + ox, y, xe, ym - oy, xe, ym); - ctx.bezierCurveTo(xe, ym + oy, xm + ox, ye, xm, ye); - ctx.bezierCurveTo(xm - ox, ye, x, ym + oy, x, ym); - ctx.closePath(); - if (doFill) { - ctx.fill(); - } - if (doStroke) { - ctx.stroke(); - } -}; - -p5.Renderer2D.prototype.line = function(x1, y1, x2, y2) { - var ctx = this.drawingContext; - if (!this._doStroke) { - return this; - } else if(ctx.strokeStyle === styleEmpty){ - return this; - } - // Translate the line by (0.5, 0.5) to draw it crisp - if (ctx.lineWidth % 2 === 1) { - ctx.translate(0.5, 0.5); - } - ctx.beginPath(); - ctx.moveTo(x1, y1); - ctx.lineTo(x2, y2); - ctx.stroke(); - if (ctx.lineWidth % 2 === 1) { - ctx.translate(-0.5, -0.5); - } - return this; -}; - -p5.Renderer2D.prototype.point = function(x, y) { - var ctx = this.drawingContext; - var s = ctx.strokeStyle; - var f = ctx.fillStyle; - if (!this._doStroke) { - return this; - } else if(ctx.strokeStyle === styleEmpty){ - return this; - } - x = Math.round(x); - y = Math.round(y); - ctx.fillStyle = s; - if (ctx.lineWidth > 1) { - ctx.beginPath(); - ctx.arc( - x, - y, - ctx.lineWidth / 2, - 0, - constants.TWO_PI, - false - ); - ctx.fill(); - } else { - ctx.fillRect(x, y, 1, 1); - } - ctx.fillStyle = f; -}; - -p5.Renderer2D.prototype.quad = - function(x1, y1, x2, y2, x3, y3, x4, y4) { - var ctx = this.drawingContext; - var doFill = this._doFill, doStroke = this._doStroke; - if (doFill && !doStroke) { - if(ctx.fillStyle === styleEmpty) { - return this; - } - } else if (!doFill && doStroke) { - if(ctx.strokeStyle === styleEmpty) { - return this; - } - } - ctx.beginPath(); - ctx.moveTo(x1, y1); - ctx.lineTo(x2, y2); - ctx.lineTo(x3, y3); - ctx.lineTo(x4, y4); - ctx.closePath(); - if (doFill) { - ctx.fill(); - } - if (doStroke) { - ctx.stroke(); - } - return this; -}; - -p5.Renderer2D.prototype.rect = function(args) { - var x = args[0], - y = args[1], - w = args[2], - h = args[3], - tl = args[4], - tr = args[5], - br = args[6], - bl = args[7]; - var ctx = this.drawingContext; - var doFill = this._doFill, doStroke = this._doStroke; - if (doFill && !doStroke) { - if(ctx.fillStyle === styleEmpty) { - return this; - } - } else if (!doFill && doStroke) { - if(ctx.strokeStyle === styleEmpty) { - return this; - } - } - // Translate the line by (0.5, 0.5) to draw a crisp rectangle border - if (this._doStroke && ctx.lineWidth % 2 === 1) { - ctx.translate(0.5, 0.5); - } - ctx.beginPath(); - - if (typeof tl === 'undefined') { - // No rounded corners - ctx.rect(x, y, w, h); - } 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; } - - 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; } - - // Draw shape - ctx.beginPath(); - ctx.moveTo(x + tl, y); - ctx.arcTo(x + w, y, x + w, y + h, tr); - ctx.arcTo(x + w, y + h, x, y + h, br); - ctx.arcTo(x, y + h, x, y, bl); - ctx.arcTo(x, y, x + w, y, tl); - ctx.closePath(); - } - if (this._doFill) { - ctx.fill(); - } - if (this._doStroke) { - ctx.stroke(); - } - if (this._doStroke && ctx.lineWidth % 2 === 1) { - ctx.translate(-0.5, -0.5); - } - return this; -}; - -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]; - if (doFill && !doStroke) { - if(ctx.fillStyle === styleEmpty) { - return this; - } - } else if (!doFill && doStroke) { - if(ctx.strokeStyle === styleEmpty) { - return this; - } - } - ctx.beginPath(); - ctx.moveTo(x1, y1); - ctx.lineTo(x2, y2); - ctx.lineTo(x3, y3); - ctx.closePath(); - if (doFill) { - ctx.fill(); - } - if (doStroke) { - ctx.stroke(); - } -}; - -p5.Renderer2D.prototype.endShape = -function (mode, vertices, isCurve, isBezier, - isQuadratic, isContour, shapeKind) { - if (vertices.length === 0) { - return this; - } - if (!this._doStroke && !this._doFill) { - return this; - } - var closeShape = mode === constants.CLOSE; - var v; - if (closeShape && !isContour) { - vertices.push(vertices[0]); - } - var i, j; - var numVerts = vertices.length; - if (isCurve && (shapeKind === constants.POLYGON || shapeKind === null)) { - if (numVerts > 3) { - 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[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 - ]; - 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)) { - this.drawingContext.beginPath(); - for (i = 0; i < numVerts; i++) { - if (vertices[i].isVert) { - if (vertices[i].moveTo) { - this.drawingContext.moveTo(vertices[i][0], vertices[i][1]); - } else { - 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._doFillStrokeClose(); - } else if (isQuadratic && - (shapeKind === constants.POLYGON || shapeKind === null)) { - this.drawingContext.beginPath(); - for (i = 0; i < numVerts; i++) { - if (vertices[i].isVert) { - if (vertices[i].moveTo) { - this.drawingContext.moveTo([0], vertices[i][1]); - } else { - 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._doFillStrokeClose(); - } else { - if (shapeKind === constants.POINTS) { - for (i = 0; i < numVerts; i++) { - v = vertices[i]; - if (this._doStroke) { - this._pInst.stroke(v[6]); - } - this._pInst.point(v[0], v[1]); - } - } else if (shapeKind === constants.LINES) { - for (i = 0; i + 1 < numVerts; i += 2) { - v = vertices[i]; - if (this._doStroke) { - this._pInst.stroke(vertices[i + 1][6]); - } - this._pInst.line(v[0], v[1], vertices[i + 1][0], vertices[i + 1][1]); - } - } else if (shapeKind === constants.TRIANGLES) { - for (i = 0; i + 2 < numVerts; i += 3) { - v = vertices[i]; - this.drawingContext.beginPath(); - 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]); - if (this._doFill) { - this._pInst.fill(vertices[i + 2][5]); - this.drawingContext.fill(); - } - if (this._doStroke) { - 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++) { - v = vertices[i]; - this.drawingContext.beginPath(); - this.drawingContext.moveTo(vertices[i + 1][0], vertices[i + 1][1]); - this.drawingContext.lineTo(v[0], v[1]); - if (this._doStroke) { - this._pInst.stroke(vertices[i + 1][6]); - } - if (this._doFill) { - this._pInst.fill(vertices[i + 1][5]); - } - if (i + 2 < numVerts) { - this.drawingContext.lineTo(vertices[i + 2][0], vertices[i + 2][1]); - if (this._doStroke) { - this._pInst.stroke(vertices[i + 2][6]); - } - if (this._doFill) { - this._pInst.fill(vertices[i + 2][5]); - } - } - this._doFillStrokeClose(); - } - } else if (shapeKind === constants.TRIANGLE_FAN) { - if (numVerts > 2) { - this.drawingContext.beginPath(); - this.drawingContext.moveTo(vertices[0][0], vertices[0][1]); - this.drawingContext.lineTo(vertices[1][0], vertices[1][1]); - this.drawingContext.lineTo(vertices[2][0], vertices[2][1]); - if (this._doFill) { - this._pInst.fill(vertices[2][5]); - } - if (this._doStroke) { - this._pInst.stroke(vertices[2][6]); - } - this._doFillStrokeClose(); - for (i = 3; i < numVerts; i++) { - v = vertices[i]; - this.drawingContext.beginPath(); - this.drawingContext.moveTo(vertices[0][0], vertices[0][1]); - this.drawingContext.lineTo(vertices[i - 1][0], vertices[i - 1][1]); - this.drawingContext.lineTo(v[0], v[1]); - if (this._doFill) { - this._pInst.fill(v[5]); - } - if (this._doStroke) { - this._pInst.stroke(v[6]); - } - this._doFillStrokeClose(); - } - } - } else if (shapeKind === constants.QUADS) { - for (i = 0; i + 3 < numVerts; i += 4) { - v = vertices[i]; - this.drawingContext.beginPath(); - this.drawingContext.moveTo(v[0], v[1]); - for (j = 1; j < 4; j++) { - this.drawingContext.lineTo(vertices[i + j][0], vertices[i + j][1]); - } - this.drawingContext.lineTo(v[0], v[1]); - if (this._doFill) { - this._pInst.fill(vertices[i + 3][5]); - } - if (this._doStroke) { - this._pInst.stroke(vertices[i + 3][6]); - } - this._doFillStrokeClose(); - } - } else if (shapeKind === constants.QUAD_STRIP) { - if (numVerts > 3) { - for (i = 0; i + 1 < numVerts; i += 2) { - v = vertices[i]; - this.drawingContext.beginPath(); - if (i + 3 < numVerts) { - 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]); - if (this._doFill) { - this._pInst.fill(vertices[i + 3][5]); - } - if (this._doStroke) { - this._pInst.stroke(vertices[i + 3][6]); - } - } else { - this.drawingContext.moveTo(v[0], v[1]); - this.drawingContext.lineTo(vertices[i + 1][0], vertices[i+1][1]); - } - this._doFillStrokeClose(); - } - } - } else { - this.drawingContext.beginPath(); - this.drawingContext.moveTo(vertices[0][0], vertices[0][1]); - for (i = 1; i < numVerts; i++) { - v = vertices[i]; - if (v.isVert) { - if (v.moveTo) { - this.drawingContext.moveTo(v[0], v[1]); - } else { - this.drawingContext.lineTo(v[0], v[1]); - } - } - } - this._doFillStrokeClose(); - } - } - isCurve = false; - isBezier = false; - isQuadratic = false; - isContour = false; - if (closeShape) { - vertices.pop(); - } - return this; -}; -////////////////////////////////////////////// -// SHAPE | Attributes -////////////////////////////////////////////// - -p5.Renderer2D.prototype.noSmooth = function() { - if ('imageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.imageSmoothingEnabled = false; - } - else if ('mozImageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.mozImageSmoothingEnabled = false; - } - else if ('webkitImageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.webkitImageSmoothingEnabled = false; - } - else if ('msImageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.msImageSmoothingEnabled = false; - } - return this; -}; - -p5.Renderer2D.prototype.smooth = function() { - if ('imageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.imageSmoothingEnabled = true; - } - else if ('mozImageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.mozImageSmoothingEnabled = true; - } - else if ('webkitImageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.webkitImageSmoothingEnabled = true; - } - else if ('msImageSmoothingEnabled' in this.drawingContext) { - this.drawingContext.msImageSmoothingEnabled = 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(){ - return this.drawingContext.fillStyle; -}; - -p5.Renderer2D.prototype._getStroke = function(){ - return this.drawingContext.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(); -}; - -////////////////////////////////////////////// -// TRANSFORM -////////////////////////////////////////////// - -p5.Renderer2D.prototype.applyMatrix = -function(n00, n01, n02, n10, n11, n12) { - this.drawingContext.transform(n00, n01, n02, n10, n11, n12); -}; - -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); - 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); - } - 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); - } - 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); - 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(); - } - - 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(); - } - } - 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(); - } - } - - 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 - this.drawingContext.fillStyle = this._fillSet ? - this.drawingContext.fillStyle : 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(); - - 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.textAlign = function(h, v) { - - if (arguments.length) { - - if (h === constants.LEFT || - h === constants.RIGHT || - h === constants.CENTER) { - - this.drawingContext.textAlign = h; - } - - if (v === constants.TOP || - v === constants.BOTTOM || - v === constants.CENTER || - v === constants.BASELINE) { - - if (v === constants.CENTER) { - this.drawingContext.textBaseline = constants._CTX_MIDDLE; - } else { - this.drawingContext.textBaseline = v; - } - } - - return this._pInst; - - } else { - - var valign = this.drawingContext.textBaseline; - - if (valign === constants._CTX_MIDDLE) { - - valign = constants.CENTER; - } - - return { - - horizontal: this.drawingContext.textAlign, - vertical: valign - }; - } -}; - -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 + ' ' + - this._textSize + 'px ' + font; - - return p; -}; - - -////////////////////////////////////////////// -// STRUCTURE -////////////////////////////////////////////// - -p5.Renderer2D.prototype.push = function() { - this.drawingContext.save(); -}; - -p5.Renderer2D.prototype.pop = function() { - this.drawingContext.restore(); -}; - -module.exports = p5.Renderer2D; - -},{"../image/filters":59,"./canvas":40,"./constants":41,"./core":42,"./p5.Renderer":48}],50:[function(_dereq_,module,exports){ -/** - * @module Rendering - * @submodule Rendering - * @for p5 - */ - -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] P2D or WEBGL - * @return {Object} canvas generated - * @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) { - //optional: renderer, otherwise defaults to p2d - var r = renderer || constants.P2D; - var isDefault, c; - - //4th arg (isDefault) used when called onLoad, - //otherwise hidden to the public api - if(arguments[3]){ - isDefault = - (typeof arguments[3] === 'boolean') ? arguments[3] : false; - } - - if(r === constants.WEBGL){ - c = document.getElementById(defaultId); - if(c){ //if defaultCanvas already exists - c.parentNode.removeChild(c); //replace the existing defaultCanvas - } - c = document.createElement('canvas'); - c.id = defaultId; - } - else { - if (isDefault) { - 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); - } 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._isdefaultGraphics = true; - } - //P2D mode - else { - if (!this._isdefaultGraphics) { - this._setProperty('_renderer', new p5.Renderer2D(c, this, true)); - this._isdefaultGraphics = true; - } - } - this._renderer.resize(w, h); - this._renderer._applyDefaults(); - if (isDefault) { // only push once - this._elements.push(this._renderer); - } - 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 - * @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) { - 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); - // reset canvas properties - for (var savedKey in props) { - this.drawingContext[savedKey] = props[savedKey]; - } - 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] P2D or WEBGL - * undefined defaults to p2d - * @return {Object} 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){ - 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 B
    • - *
  • DARKEST - 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 - * @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) { - 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":91,"./constants":41,"./core":42,"./p5.Graphics":47,"./p5.Renderer2D":49}],51:[function(_dereq_,module,exports){ - -// 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); - }; - } -}()); -*/ - -/** - * shim for Uint8ClampedArray.slice - * (allows arrayCopy to work with pixels[]) - * with thanks to http://halfpapstudios.com/blog/tag/html5-canvas/ - * Enumerable set to false to protect for...in from - * Uint8ClampedArray.prototype pollution. - */ -(function () { - 'use strict'; - if (typeof Uint8ClampedArray !== 'undefined' && - !Uint8ClampedArray.prototype.slice) { - Object.defineProperty(Uint8ClampedArray.prototype, 'slice', { - value: Array.prototype.slice, - writable: true, configurable: true, enumerable: false - }); - } -}()); - -},{}],52:[function(_dereq_,module,exports){ -/** - * @module Structure - * @submodule Structure - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('./core'); - -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. - *

- * 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. - * - * @method noLoop - * @example - *
- * function setup() { - * createCanvas(100, 100); - * background(200); - * noLoop(); - * } - - * function draw() { - * line(10, 10, 90, 90); - * } - *
- * - *
- * var x = 0; - * function setup() { - * createCanvas(100, 100); - * } - * - * function draw() { - * background(204); - * x = x + 0.1; - * if (x > width) { - * x = 0; - * } - * line(x, 0, x, height); - * } - * - * function mousePressed() { - * noLoop(); - * } - * - * function mouseReleased() { - * loop(); - * } - *
- * - * @alt - * 113 pixel long line extending from top-left to bottom right of canvas. - * horizontal line moves slowly from left. Loops but stops on mouse press. - * - */ -p5.prototype.noLoop = function() { - this._loop = false; -}; -/** - * 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(). - * - * @method loop - * @example - *
- * var x = 0; - * function setup() { - * createCanvas(100, 100); - * noLoop(); - * } - * - * function draw() { - * background(204); - * x = x + 0.1; - * if (x > width) { - * x = 0; - * } - * line(x, 0, x, height); - * } - * - * function mousePressed() { - * loop(); - * } - * - * function mouseReleased() { - * noLoop(); - * } - *
- * - * @alt - * horizontal line moves slowly from left. Loops but stops on mouse press. - * - */ - -p5.prototype.loop = function() { - this._loop = true; - this._draw(); -}; - -/** - * 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 - * 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(). - * - * @method push - * @example - *
- * - * ellipse(0, 50, 33, 33); // Left circle - * - * 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(100, 50, 33, 33); // Right circle - * - *
- *
- * - * ellipse(0, 50, 33, 33); // Left circle - * - * push(); // Start a new drawing state - * strokeWeight(10); - * fill(204, 153, 0); - * ellipse(33, 50, 33, 33); // Left-middle circle - * - * push(); // Start another new drawing state - * stroke(0, 102, 153); - * ellipse(66, 50, 33, 33); // Right-middle circle - * pop(); // Restore previous state - * - * pop(); // Restore original state - * - * ellipse(100, 50, 33, 33); // Right circle - * - *
- * - * @alt - * Gold ellipse + thick black outline @center 2 white ellipses on left and right. - * 2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right. - * - */ -p5.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 - }); -}; - -/** - * 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 - * 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(). - * - * @method pop - * @example - *
- * - * ellipse(0, 50, 33, 33); // Left circle - * - * 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(100, 50, 33, 33); // Right circle - * - *
- *
- * - * ellipse(0, 50, 33, 33); // Left circle - * - * push(); // Start a new drawing state - * strokeWeight(10); - * fill(204, 153, 0); - * ellipse(33, 50, 33, 33); // Left-middle circle - * - * push(); // Start another new drawing state - * stroke(0, 102, 153); - * ellipse(66, 50, 33, 33); // Right-middle circle - * pop(); // Restore previous state - * - * pop(); // Restore original state - * - * ellipse(100, 50, 33, 33); // Right circle - * - *
- * - * @alt - * Gold ellipse + thick black outline @center 2 white ellipses on left and right. - * 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.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 - * program to update the display window only when necessary, for example - * 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 - * needed). - *

- * 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. - * - * @method redraw - * @param {Integer} [n] Redraw for n-times. The default value is 1. - * @example - *
- * var x = 0; - * - * function setup() { - * createCanvas(100, 100); - * noLoop(); - * } - * - * function draw() { - * background(204); - * line(x, 0, x, height); - * } - * - * function mousePressed() { - * x += 1; - * redraw(); - * } - *
- * - *
- * var x = 0; - * - * function setup() { - * createCanvas(100, 100); - * noLoop(); - * } - * - * function draw() { - * background(204); - * x += 1; - * line(x, 0, x, height); - * } - * - * function mousePressed() { - * redraw(5); - * } - *
- * - * @alt - * black line on far left of canvas - * black line on far left of canvas - * - */ -p5.prototype.redraw = function () { - this.resetMatrix(); - if(this._renderer.isP3D){ - this._renderer._update(); - } - - 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; - if (typeof userDraw === 'function') { - if (typeof userSetup === 'undefined') { - this.scale(this._pixelDensity, this._pixelDensity); - } - var self = this; - var callMethod = function (f) { - f.call(self); - }; - for (var idxRedraw = 0; idxRedraw < numberOfRedraws; idxRedraw++) { - this._registeredMethods.pre.forEach(callMethod); - userDraw(); - this._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":42}],53:[function(_dereq_,module,exports){ -/** - * @module Transform - * @submodule Transform - * @for p5 - * @requires core - * @requires constants - */ - - -'use strict'; - -var p5 = _dereq_('./core'); -var constants = _dereq_('./constants'); - -/** - * Multiplies the current matrix by the one specified through the parameters. - * This is very slow because it will try to calculate the inverse of the - * transform, so avoid it whenever possible. - * - * @method applyMatrix - * @param {Number} n00 numbers which define the 3x2 matrix to be multiplied - * @param {Number} n01 numbers which define the 3x2 matrix to be multiplied - * @param {Number} n02 numbers which define the 3x2 matrix to be multiplied - * @param {Number} n10 numbers which define the 3x2 matrix to be multiplied - * @param {Number} n11 numbers which define the 3x2 matrix to be multiplied - * @param {Number} n12 numbers which define the 3x2 matrix to be multiplied - * @return {p5} the p5 object - * @example - *
- * - * // Example in the works. - * - *
- * - * @alt - * no image diplayed - * - */ -p5.prototype.applyMatrix = function(n00, n01, n02, n10, n11, n12) { - this._renderer.applyMatrix(n00, n01, n02, n10, n11, n12); - return this; -}; - -p5.prototype.popMatrix = function() { - throw new Error('popMatrix() not used, see pop()'); -}; - -p5.prototype.printMatrix = function() { - throw new Error('printMatrix() not implemented'); -}; - -p5.prototype.pushMatrix = function() { - throw new Error('pushMatrix() not used, see push()'); -}; - -/** - * Replaces the current matrix with the identity matrix. - * - * @method resetMatrix - * @return {p5} the p5 object - * @example - *
- * - * // Example in the works. - * - *
- * - * @alt - * no image diplayed - * - */ -p5.prototype.resetMatrix = function() { - this._renderer.resetMatrix(); - return this; -}; - -/** - * Rotates a shape the amount specified by the angle parameter. This - * function accounts for angleMode, so angles can be entered in either - * RADIANS or DEGREES. - *

- * Objects are always rotated around their relative position to the - * origin and positive numbers rotate objects in a clockwise direction. - * 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. - *

- * Technically, rotate() multiplies the current transformation matrix - * by a rotation matrix. This function can be further controlled by - * the push() and pop(). - * - * @method rotate - * @param {Number} angle the angle of rotation, specified in radians - * or degrees, depending on current angleMode - * @return {p5} the p5 object - * @example - *
- * - * translate(width/2, height/2); - * rotate(PI/3.0); - * rect(-26, -26, 52, 52); - * - *
- * - * @alt - * white 52x52 rect with black outline at center rotated counter 45 degrees - * - */ -/** - * @method rotate - * @param {Number} rad angle in radians - * @param {p5.Vector|Array} axis axis to rotate around - * @return {p5} the p5 object - */ -p5.prototype.rotate = function() { - 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); - } - return this; -}; - -/** - * Rotates around X axis. - * @method rotateX - * @param {Number} rad angles in radians - * @return {p5} the p5 object - */ -p5.prototype.rotateX = function(rad) { - if (this._renderer.isP3D) { - this._renderer.rotateX(rad); - } else { - throw 'not supported in p2d. Please use webgl mode'; - } - return this; -}; - -/** - * Rotates around Y axis. - * @method rotateY - * @param {Number} rad angles in radians - * @return {p5} the p5 object - */ -p5.prototype.rotateY = function(rad) { - if (this._renderer.isP3D) { - this._renderer.rotateY(rad); - } else { - throw 'not supported in p2d. Please use webgl mode'; - } - return this; -}; - -/** - * Rotates around Z axis. Webgl mode only. - * @method rotateZ - * @param {Number} rad angles in radians - * @return {p5} the p5 object - */ -p5.prototype.rotateZ = function(rad) { - if (this._renderer.isP3D) { - this._renderer.rotateZ(rad); - } else { - throw 'not supported in p2d. Please use webgl mode'; - } - return this; -}; - -/** - * Increases or decreases the size of a shape by expanding and contracting - * vertices. Objects always scale from their relative origin to the - * coordinate system. Scale values are specified as decimal percentages. - * For example, the function call scale(2.0) increases the dimension of a - * shape by 200%. - *

- * 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. - *

- * Using this function with the z parameter is only available in WEBGL mode. - * This function can be further controlled with push() and pop(). - * - * @method scale - * @param {Number|p5.Vector|Array} s - * percent to scale the object, or percentage to - * scale the object in the x-axis if multiple arguments - * are given - * @param {Number} [y] percent to scale the object in the y-axis - * @param {Number} [z] percent to scale the object in the z-axis (webgl only) - * @return {p5} the p5 object - * @example - *
- * - * translate(width/2, height/2); - * rotate(PI/3.0); - * rect(-26, -26, 52, 52); - * - *
- * - *
- * - * rect(30, 20, 50, 50); - * scale(0.5, 1.3); - * rect(30, 20, 50, 50); - * - *
- * - * @alt - * white 52x52 rect with black outline at center rotated counter 45 degrees - * 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]; - } - if(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 - * @return {p5} the p5 object - * @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 - * @return {p5} the p5 object - * @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) - * @return {p5} the p5 object - * @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":41,"./core":42}],54:[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 - * @return {Object} the p5 object - * @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 - * @return {Object} the p5 object - * @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 - * @return {Object} the p5 object - * @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 - * @return {Object} the p5 object - * @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); - 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 - * @return {Object} the p5 object - * @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); - - // 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]); - } - 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). - * - * @method endShape - * @param {Constant} mode use CLOSE to close the shape - * @return {Object} the p5 object - * @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(); - * - *
- * - * @alt - * Triangle line shape with smallest interior angle on bottom and upside-down L. - * - */ -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(); - } - } - 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(). - * - * @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 - * @return {Object} the p5 object - * @example - *
- * - * noFill(); - * strokeWeight(4); - * beginShape(); - * vertex(20, 20); - * quadraticVertex(80, 20, 50, 50); - * endShape(); - * - *
- * - *
- * - * noFill(); - * strokeWeight(4); - * 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.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 - * @return {Object} the p5 object - * @example - *
- * - * 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. - * - */ -p5.prototype.vertex = function(x, y, moveTo) { - if(this._renderer.isP3D){ - this._renderer.vertex(x, y, moveTo); - }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); - } - } - return this; -}; - -module.exports = p5; - -},{"./constants":41,"./core":42}],55:[function(_dereq_,module,exports){ -/** - * @module Events - * @submodule Acceleration - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * The system variable deviceOrientation always contains the orientation of - * the device. The value of this variable will either be set 'landscape' - * or 'portrait'. If no data is available it will be set to 'undefined'. - * - * @property deviceOrientation - */ -p5.prototype.deviceOrientation = undefined; - -/** - * The system variable accelerationX always contains the acceleration of the - * device along the x axis. Value is represented as meters per second squared. - * - * @property accelerationX - */ -p5.prototype.accelerationX = 0; - -/** - * The system variable accelerationY always contains the acceleration of the - * device along the y axis. Value is represented as meters per second squared. - * - * @property accelerationY - */ -p5.prototype.accelerationY = 0; - -/** - * The system variable accelerationZ always contains the acceleration of the - * device along the z axis. Value is represented as meters per second squared. - * - * @property accelerationZ - */ -p5.prototype.accelerationZ = 0; - -/** - * The system variable pAccelerationX always contains the acceleration of the - * device along the x axis in the frame previous to the current frame. Value - * is represented as meters per second squared. - * - * @property pAccelerationX - */ -p5.prototype.pAccelerationX = 0; - -/** - * The system variable pAccelerationY always contains the acceleration of the - * device along the y axis in the frame previous to the current frame. Value - * is represented as meters per second squared. - * - * @property pAccelerationY - */ -p5.prototype.pAccelerationY = 0; - -/** - * The system variable pAccelerationZ always contains the acceleration of the - * device along the z axis in the frame previous to the current frame. Value - * is represented as meters per second squared. - * - * @property pAccelerationZ - */ -p5.prototype.pAccelerationZ = 0; - -/** - * _updatePAccelerations updates the pAcceleration values - * - * @private - */ -p5.prototype._updatePAccelerations = function(){ - this._setProperty('pAccelerationX', this.accelerationX); - this._setProperty('pAccelerationY', this.accelerationY); - this._setProperty('pAccelerationZ', this.accelerationZ); -}; - -/** - * The system variable rotationX always contains the rotation of the - * device along the x axis. Value is represented as 0 to +/-180 degrees. - *

- * Note: The order the rotations are called is important, ie. if used - * together, it must be called in the order Z-X-Y or there might be - * unexpected behaviour. - * - * @example - *
- * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * - * function draw(){ - * background(200); - * //rotateZ(radians(rotationZ)); - * rotateX(radians(rotationX)); - * //rotateY(radians(rotationY)); - * box(200, 200, 200); - * } - * - *
- * - * @property rotationX - * - * @alt - * red horizontal line right, green vertical line bottom. black background. - * - */ -p5.prototype.rotationX = 0; - -/** - * The system variable rotationY always contains the rotation of the - * device along the y axis. Value is represented as 0 to +/-90 degrees. - *

- * Note: The order the rotations are called is important, ie. if used - * together, it must be called in the order Z-X-Y or there might be - * unexpected behaviour. - * - * @example - *
- * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * - * function draw(){ - * background(200); - * //rotateZ(radians(rotationZ)); - * //rotateX(radians(rotationX)); - * rotateY(radians(rotationY)); - * box(200, 200, 200); - * } - * - *
- * - * @property rotationY - * - * @alt - * red horizontal line right, green vertical line bottom. black background. - */ -p5.prototype.rotationY = 0; - -/** - * The system variable rotationZ always contains the rotation of the - * device along the z axis. Value is represented as 0 to 359 degrees. - *

- * Unlike rotationX and rotationY, this variable is available for devices - * with a built-in compass only. - *

- * Note: The order the rotations are called is important, ie. if used - * together, it must be called in the order Z-X-Y or there might be - * unexpected behaviour. - * - * @example - *
- * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * - * function draw(){ - * background(200); - * rotateZ(radians(rotationZ)); - * //rotateX(radians(rotationX)); - * //rotateY(radians(rotationY)); - * box(200, 200, 200); - * } - * - *
- * - * @property rotationZ - * - * @alt - * red horizontal line right, green vertical line bottom. black background. - */ -p5.prototype.rotationZ = 0; - -/** - * The system variable pRotationX always contains the rotation of the - * device along the x axis in the frame previous to the current frame. Value - * is represented as 0 to +/-180 degrees. - *

- * pRotationX can also be used with rotationX to determine the rotate - * direction of the device along the X-axis. - * @example - *
- * - * // A simple if statement looking at whether - * // rotationX - pRotationX < 0 is true or not will be - * // sufficient for determining the rotate direction - * // in most cases. - * - * // Some extra logic is needed to account for cases where - * // the angles wrap around. - * var rotateDirection = 'clockwise'; - * - * // Simple range conversion to make things simpler. - * // This is not absolutely neccessary 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){ - * rotateDirection = 'clockwise'; - * } else if (rX - pRX < 0 || rX - pRX > 270){ - * rotateDirection = 'counter-clockwise'; - * } - * - *
- * - * @alt - * no image to display. - * - * - * @property pRotationX - */ -p5.prototype.pRotationX = 0; - -/** - * The system variable pRotationY always contains the rotation of the - * device along the y axis in the frame previous to the current frame. Value - * is represented as 0 to +/-90 degrees. - *

- * pRotationY can also be used with rotationY to determine the rotate - * direction of the device along the Y-axis. - * @example - *
- * - * // A simple if statement looking at whether - * // rotationY - pRotationY < 0 is true or not will be - * // sufficient for determining the rotate direction - * // in most cases. - * - * // Some extra logic is needed to account for cases where - * // the angles wrap around. - * var rotateDirection = 'clockwise'; - * - * // Simple range conversion to make things simpler. - * // This is not absolutely neccessary 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){ - * rotateDirection = 'clockwise'; - * } else if (rY - pRY < 0 || rY - pRY > 270){ - * rotateDirection = 'counter-clockwise'; - * } - * - *
- * - * @alt - * no image to display. - * - * - * @property pRotationY - */ -p5.prototype.pRotationY = 0; - -/** - * The system variable pRotationZ always contains the rotation of the - * device along the z axis in the frame previous to the current frame. Value - * is represented as 0 to 359 degrees. - *

- * pRotationZ can also be used with rotationZ to determine the rotate - * direction of the device along the Z-axis. - * @example - *
- * - * // A simple if statement looking at whether - * // rotationZ - pRotationZ < 0 is true or not will be - * // sufficient for determining the rotate direction - * // in most cases. - * - * // Some extra logic is needed to account for cases where - * // the angles wrap around. - * var rotateDirection = 'clockwise'; - * - * if ((rotationZ - pRotationZ > 0 && - * rotationZ - pRotationZ < 270)|| - * rotationZ - pRotationZ < -270){ - * - * rotateDirection = 'clockwise'; - * - * } else if (rotationZ - pRotationZ < 0 || - * rotationZ - pRotationZ > 270){ - * - * rotateDirection = 'counter-clockwise'; - * - * } - * - *
- * - * @alt - * no image to display. - * - * - * @property pRotationZ - */ -p5.prototype.pRotationZ = 0; - -var startAngleX = 0; -var startAngleY = 0; -var startAngleZ = 0; - -var rotateDirectionX = 'clockwise'; -var rotateDirectionY = 'clockwise'; -var rotateDirectionZ = 'clockwise'; - -var pRotateDirectionX; -var pRotateDirectionY; -var pRotateDirectionZ; - -p5.prototype._updatePRotations = function(){ - this._setProperty('pRotationX', this.rotationX); - this._setProperty('pRotationY', this.rotationY); - this._setProperty('pRotationZ', this.rotationZ); -}; - -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. - * - * @method setMoveThreshold - * @param {number} value The threshold value - */ -p5.prototype.setMoveThreshold = function(val){ - if(typeof val === 'number'){ - move_threshold = val; - } -}; - -/** - * 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 - */ -p5.prototype.setShakeThreshold = function(val){ - if(typeof val === 'number'){ - shake_threshold = val; - } -}; - -/** - * 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 - * @example - *
- * - * // Run this example on a mobile device - * // Move the device around - * // to change the value. - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function deviceMoved() { - * value = value + 5; - * if (value > 255) { - * value = 0; - * } - * } - * - *
- * - * @alt - * 50x50 black rect in center of canvas. turns white on mobile when device moves - * - */ - -/** - * 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: - * X, Y or Z by comparing the turnAxis variable to 'X', 'Y' or 'Z'. - * - * @method deviceTurned - * @example - *
- * - * // Run this example on a mobile device - * // Rotate the device by 90 degrees - * // to change the value. - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function deviceTurned() { - * if (value == 0){ - * value = 255 - * } else if (value == 255) { - * value = 0; - * } - * } - * - *
- *
- * - * // Run this example on a mobile device - * // Rotate the device by 90 degrees in the - * // X-axis to change the value. - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function deviceTurned() { - * if (turnAxis == 'X'){ - * if (value == 0){ - * value = 255 - * } else if (value == 255) { - * value = 0; - * } - * } - * } - * - *
- * - * @alt - * 50x50 black rect in center of canvas. turns white on mobile when device turns - * 50x50 black rect in center of canvas. turns white on mobile when x-axis turns - * - */ - -/** - * 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 - * @example - *
- * - * // Run this example on a mobile device - * // Shake the device to change the value. - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function deviceShaken() { - * value = value + 5; - * if (value > 255) { - * value = 0; - * } - * } - * - *
- * - * @alt - * 50x50 black rect in center of canvas. turns white on mobile when device shakes - * - */ - -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) { - this._updatePAccelerations(); - this._setProperty('accelerationX', e.acceleration.x * 2); - this._setProperty('accelerationY', e.acceleration.y * 2); - this._setProperty('accelerationZ', e.acceleration.z * 2); - this._handleMotion(); -}; -p5.prototype._handleMotion = function() { - if (window.orientation === 90 || window.orientation === -90) { - this._setProperty('deviceOrientation', 'landscape'); - } else if (window.orientation === 0) { - this._setProperty('deviceOrientation', 'portrait'); - } else if (window.orientation === undefined) { - this._setProperty('deviceOrientation', 'undefined'); - } - var deviceMoved = this.deviceMoved || window.deviceMoved; - if (typeof deviceMoved === 'function') { - 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) { - deviceMoved(); - } - } - var deviceTurned = this.deviceTurned || window.deviceTurned; - if (typeof deviceTurned === 'function') { - // The angles given by rotationX etc is from range -180 to 180. - // The following will convert them to 0 to 360 for ease of calculation - // of cases when the angles wrapped around. - // _startAngleX will be converted back at the end and updated. - var wRX = this.rotationX + 180; - var wPRX = this.pRotationX + 180; - var wSAX = startAngleX + 180; - if ((wRX - wPRX > 0 && wRX - wPRX < 270)|| wRX - wPRX < -270){ - rotateDirectionX = 'clockwise'; - } else if (wRX - wPRX < 0 || wRX - wPRX > 270){ - rotateDirectionX = 'counter-clockwise'; - } - if (rotateDirectionX !== pRotateDirectionX){ - wSAX = wRX; - } - if (Math.abs(wRX - wSAX) > 90 && Math.abs(wRX - wSAX) < 270){ - wSAX = wRX; - this._setProperty('turnAxis', 'X'); - deviceTurned(); - } - pRotateDirectionX = rotateDirectionX; - startAngleX = wSAX - 180; - - // Y-axis is identical to X-axis except for changing some names. - var wRY = this.rotationY + 180; - var wPRY = this.pRotationY + 180; - var wSAY = startAngleY + 180; - if ((wRY - wPRY > 0 && wRY - wPRY < 270)|| wRY - wPRY < -270){ - rotateDirectionY = 'clockwise'; - } else if (wRY - wPRY < 0 || wRY - this.pRotationY > 270){ - rotateDirectionY = 'counter-clockwise'; - } - if (rotateDirectionY !== pRotateDirectionY){ - wSAY = wRY; - } - if (Math.abs(wRY - wSAY) > 90 && Math.abs(wRY - wSAY) < 270){ - wSAY = wRY; - this._setProperty('turnAxis', 'Y'); - deviceTurned(); - } - pRotateDirectionY = rotateDirectionY; - startAngleY = wSAY - 180; - - // 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){ - rotateDirectionZ = 'clockwise'; - } else if (this.rotationZ - this.pRotationZ < 0 || - this.rotationZ - this.pRotationZ > 270){ - rotateDirectionZ = 'counter-clockwise'; - } - if (rotateDirectionZ !== pRotateDirectionZ){ - startAngleZ = this.rotationZ; - } - if (Math.abs(this.rotationZ - startAngleZ) > 90 && - Math.abs(this.rotationZ - startAngleZ) < 270){ - startAngleZ = this.rotationZ; - this._setProperty('turnAxis', 'Z'); - deviceTurned(); - } - pRotateDirectionZ = rotateDirectionZ; - this._setProperty('turnAxis', undefined); - } - var deviceShaken = this.deviceShaken || window.deviceShaken; - if (typeof deviceShaken === 'function') { - var accelerationChangeX; - var accelerationChangeY; - // Add accelerationChangeZ if acceleration change on Z is needed - if (this.pAccelerationX !== null) { - accelerationChangeX = Math.abs(this.accelerationX - this.pAccelerationX); - accelerationChangeY = Math.abs(this.accelerationY - this.pAccelerationY); - } - if (accelerationChangeX + accelerationChangeY > shake_threshold) { - deviceShaken(); - } - } -}; - - -module.exports = p5; - -},{"../core/core":42}],56:[function(_dereq_,module,exports){ -/** - * @module Events - * @submodule Keyboard - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * Holds the key codes of currently pressed keys. - * @private - */ -var downKeys = {}; - -/** - * The boolean system variable keyIsPressed is true if any key is pressed - * and false if no keys are pressed. - * - * @property keyIsPressed - * @example - *
- * - * var value = 0; - * function draw() { - * if (keyIsPressed === true) { - * fill(0); - * } else { - * fill(255); - * } - * rect(25, 25, 50, 50); - * } - * - *
- * - * @alt - * 50x50 white rect that turns black on keypress. - * - */ -p5.prototype.isKeyPressed = false; -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 - * variable. - * - * @property key - * @example - *
- * // Click any key to display it! - * // (Not Guaranteed to be Case Sensitive) - * function setup() { - * fill(245, 123, 158); - * textSize(50); - * } - * - * function draw() { - * background(200); - * text(key, 33,65); // Display last key pressed. - * } - *
- * - * @alt - * canvas displays any key value that is pressed in pink font. - * - */ -p5.prototype.key = ''; - -/** - * The variable keyCode is used to detect special keys such as BACKSPACE, - * DELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL, OPTION, ALT, UP_ARROW, - * DOWN_ARROW, LEFT_ARROW, RIGHT_ARROW. - * You can also check for custom keys by looking up the keyCode of any key - * on a site like this: keycode.info. - * - * @property keyCode - * @example - *
- * var fillVal = 126; - * function draw() { - * fill(fillVal); - * rect(25, 25, 50, 50); - * } - * - * function keyPressed() { - * if (keyCode == UP_ARROW) { - * fillVal = 255; - * } else if (keyCode == DOWN_ARROW) { - * fillVal = 0; - * } - * return false; // prevent default - * } - *
- * - * @alt - * Grey rect center. turns white when up arrow pressed and black when down - * - */ -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. - *

- * For non-ASCII keys, use the keyCode variable. You can check if the keyCode - * equals BACKSPACE, DELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL, - * OPTION, ALT, UP_ARROW, DOWN_ARROW, LEFT_ARROW, RIGHT_ARROW. - *

- * 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 - * 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 - * 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 events. To prevent any default - * behavior for this event, add "return false" to the end of the method. - * - * @method keyPressed - * @example - *
- * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function keyPressed() { - * if (value === 0) { - * value = 255; - * } else { - * value = 0; - * } - * } - * - *
- *
- * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function keyPressed() { - * if (keyCode === LEFT_ARROW) { - * value = 255; - * } else if (keyCode === RIGHT_ARROW) { - * value = 0; - * } - * } - * - *
- *
- * - * function keyPressed(){ - * // Do something - * return false; // prevent any default behaviour - * } - * - * - * @alt - * black rect center. turns white when key pressed and black when released - * 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 - 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); - var keyPressed = this.keyPressed || window.keyPressed; - if (typeof keyPressed === 'function' && !e.charCode) { - var executeDefault = keyPressed(e); - if(executeDefault === false) { - e.preventDefault(); - } - } -}; -/** - * 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. - * - * @method keyReleased - * @example - *
- * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function keyReleased() { - * if (value === 0) { - * value = 255; - * } else { - * value = 0; - * } - * return false; // prevent any default behavior - * } - * - *
- * - * @alt - * black rect center. turns white when key pressed and black when pressed again - * - */ -p5.prototype._onkeyup = function (e) { - var keyReleased = this.keyReleased || window.keyReleased; - downKeys[e.which] = false; - - 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('keyCode', e.which); - if (typeof keyReleased === 'function') { - var executeDefault = keyReleased(e); - if(executeDefault === false) { - e.preventDefault(); - } - } -}; - -/** - * 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 - * 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 - * events. To prevent any default behavior for this event, add "return false" - * to the end of the method. - * - * @method keyTyped - * @example - *
- * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function keyTyped() { - * if (key === 'a') { - * value = 255; - * } else if (key === 'b') { - * value = 0; - * } - * // uncomment to prevent any default behavior - * // return false; - * } - * - *
- * - * @alt - * 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 - return; - } - this._setProperty('keyCode', e.which); - this._setProperty('_lastKeyCodeTyped', e.which); // track last keyCode - this._setProperty('key', String.fromCharCode(e.which)); - var keyTyped = this.keyTyped || window.keyTyped; - if (typeof keyTyped === 'function') { - var executeDefault = keyTyped(e); - if(executeDefault === false) { - e.preventDefault(); - } - } -}; -/** - * The onblur function is called when the user is no longer focused - * on the p5 element. Because the keyup events will not fire if the user is - * not focused on the element we must assume all keys currently down have - * been released. - */ -p5.prototype._onblur = function (e) { - downKeys = {}; -}; - -/** - * 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 - * here. - * - * @method keyIsDown - * @param {Number} code The key to check for. - * @return {Boolean} whether key is down or not - * @example - *
- * var x = 100; - * var y = 100; - * - * function setup() { - * createCanvas(512, 512); - * } - * - * function draw() { - * if (keyIsDown(LEFT_ARROW)) - * x-=5; - * - * if (keyIsDown(RIGHT_ARROW)) - * x+=5; - * - * if (keyIsDown(UP_ARROW)) - * y-=5; - * - * if (keyIsDown(DOWN_ARROW)) - * y+=5; - * - * clear(); - * fill(255, 0, 0); - * ellipse(x, y, 50, 50); - * } - *
- * - * @alt - * 50x50 red ellipse moves left, right, up and down with arrow presses. - * - */ -p5.prototype.keyIsDown = function(code) { - return downKeys[code]; -}; - -/** - * The checkDownKeys function returns a boolean true if any keys pressed - * and a false if no keys are currently pressed. - - * Helps avoid instances where a multiple keys are pressed simultaneously and - * releasing a single key will then switch the - * keyIsPressed property to true. - * @private -**/ -function areDownKeys() { - for (var key in downKeys) { - if (downKeys.hasOwnProperty(key) && downKeys[key] === true) { - return true; - } - } - return false; -} - -module.exports = p5; - -},{"../core/core":42}],57:[function(_dereq_,module,exports){ -/** - * @module Events - * @submodule Mouse - * @for p5 - * @requires core - * @requires constants - */ - - -'use strict'; - -var p5 = _dereq_('../core/core'); -var constants = _dereq_('../core/constants'); - -/* - * This is a flag which is false until the first time - * we receive a mouse event. The pmouseX and pmouseY - * values will match the mouseX and mouseY values until - * this interaction takes place. - */ -p5.prototype._hasMouseInteracted = false; - -/** - * The system variable mouseX always contains the current horizontal - * position of the mouse, relative to (0, 0) of the canvas. If touch is - * used instead of mouse input, mouseX will hold the x value of the most - * recent touch point. - * - * @property mouseX - * - * @example - *
- * - * // Move the mouse across the canvas - * function draw() { - * background(244, 248, 252); - * line(mouseX, 0, mouseX, 100); - * } - * - *
- * - * @alt - * horizontal black line moves left and right with mouse x-position - * - */ -p5.prototype.mouseX = 0; - -/** - * The system variable mouseY always contains the current vertical position - * of the mouse, relative to (0, 0) of the canvas. If touch is - * used instead of mouse input, mouseY will hold the y value of the most - * recent touch point. - * - * @property mouseY - * - * @example - *
- * - * // Move the mouse across the canvas - * function draw() { - * background(244, 248, 252); - * line(0, mouseY, 100, mouseY); - *} - * - *
- * - * @alt - * vertical black line moves up and down with mouse y-position - * - */ -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. - * - * @property pmouseX - * - * @example - *
- * - * // Move the mouse across the canvas to leave a trail - * function setup() { - * //slow down the frameRate to make it more visible - * frameRate(10); - * } - * - * function draw() { - * background(244, 248, 252); - * line(mouseX, mouseY, pmouseX, pmouseY); - * print(pmouseX + " -> " + mouseX); - * } - * - * - *
- * - * @alt - * line trail is created from cursor movements. faster movement make longer line. - * - */ -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. - * - * @property pmouseY - * - * @example - *
- * - * function draw() { - * 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); - * - * print(pmouseY + " -> " + mouseY); - * } - * - * - *
- * - * @alt - * 60x60 black rect center, fuschia background. rect flickers on mouse movement - * - */ -p5.prototype.pmouseY = 0; - -/** - * The system variable winMouseX always contains the current horizontal - * position of the mouse, relative to (0, 0) of the window. - * - * @property winMouseX - * - * @example - *
- * - * var myCanvas; - * - * function setup() { - * //use a variable to store a pointer to the canvas - * myCanvas = createCanvas(100, 100); - * } - * - * function draw() { - * background(237, 34, 93); - * fill(0); - * - * //move the canvas to the horizontal mouse position - * //relative to the window - * myCanvas.position(winMouseX+1, windowHeight/2); - * - * //the y of the square is relative to the canvas - * rect(20,mouseY,60,60); - * } - * - * - *
- * - * @alt - * 60x60 black rect y moves with mouse y and fuschia canvas moves with mouse x - * - */ -p5.prototype.winMouseX = 0; - -/** - * The system variable winMouseY always contains the current vertical - * position of the mouse, relative to (0, 0) of the window. - * - * @property winMouseY - * - * @example - *
- * - *var myCanvas; - * - * function setup() { - * //use a variable to store a pointer to the canvas - * myCanvas = createCanvas(100, 100); - * } - * - * function draw() { - * background(237, 34, 93); - * fill(0); - * - * //move the canvas to the vertical mouse position - * //relative to the window - * myCanvas.position(windowWidth/2, winMouseY+1); - * - * //the x of the square is relative to the canvas - * rect(mouseX,20,60,60); - * } - * - * - *
- * - * @alt - * 60x60 black rect x moves with mouse x and fuschia canvas y moves with mouse y - * - */ -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. - * - * @property pwinMouseX - * - * @example - *
- * - * - * var myCanvas; - * - * function setup() { - * //use a variable to store a pointer to the canvas - * 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); - * //change the size of the circle - * //according to the horizontal speed - * ellipse(50, 50, 10+speed*5, 10+speed*5); - * //move the canvas to the mouse position - * myCanvas.position( winMouseX+1, winMouseY+1); - * } - * - * - *
- * - * @alt - * fuschia ellipse moves with mouse x and y. Grows and shrinks with mouse speed - * - */ -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. - * - * @property pwinMouseY - * - * - * @example - *
- * - * - * var myCanvas; - * - * function setup() { - * //use a variable to store a pointer to the canvas - * 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); - * //change the size of the circle - * //according to the vertical speed - * ellipse(50, 50, 10+speed*5, 10+speed*5); - * //move the canvas to the mouse position - * myCanvas.position( winMouseX+1, winMouseY+1); - * } - * - * - *
- * - * @alt - * fuschia ellipse moves with mouse x and y. Grows and shrinks with mouse speed - * - */ -p5.prototype.pwinMouseY = 0; - -/** - * Processing automatically tracks if the mouse button is pressed and which - * button is pressed. The value of the system variable mouseButton is either - * LEFT, RIGHT, or CENTER depending on which button was pressed last. - * Warning: different browsers may track mouseButton differently. - * - * @property mouseButton - * - * @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); - * } - * - *
- * - * @alt - * 50x50 black ellipse appears on center of fuschia canvas on mouse click/press. - * - */ -p5.prototype.mouseButton = 0; - -/** - * The boolean system variable mouseIsPressed is true if the mouse is pressed - * and false if not. - * - * @property mouseIsPressed - * - * @example - *
- * - * 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. - * - */ -p5.prototype.mouseIsPressed = false; -p5.prototype.isMousePressed = false; // both are supported - -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); - this._setProperty('mouseX', mousePos.x); - this._setProperty('mouseY', mousePos.y); - this._setProperty('winMouseX', mousePos.winX); - this._setProperty('winMouseY', mousePos.winY); - } - if (!this._hasMouseInteracted) { - // For first draw, make previous and next equal - this._updateMouseCoords(); - this._setProperty('_hasMouseInteracted', true); - } -}; - -p5.prototype._updateMouseCoords = function() { - this._setProperty('pmouseX', this.mouseX); - this._setProperty('pmouseY', this.mouseY); - this._setProperty('pwinMouseX', this.winMouseX); - this._setProperty('pwinMouseY', this.winMouseY); -}; - -function getMousePos(canvas, w, h, evt) { - if (evt && !evt.clientX) { // use touches if touch and not mouse - if (evt.touches) { - evt = evt.touches[0]; - } else if (evt.changedTouches) { - evt = evt.changedTouches[0]; - } - } - var rect = canvas.getBoundingClientRect(); - var sx = canvas.scrollWidth / w; - var sy = canvas.scrollHeight / h; - return { - x: (evt.clientX - rect.left) / sx, - y: (evt.clientY - rect.top) / sy, - winX: evt.clientX, - winY: evt.clientY, - id: evt.identifier - }; -} - -p5.prototype._setMouseButton = function(e) { - if (e.button === 1) { - this._setProperty('mouseButton', constants.CENTER); - } else if (e.button === 2) { - this._setProperty('mouseButton', constants.RIGHT); - } else { - this._setProperty('mouseButton', constants.LEFT); - } -}; - -/** - * 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 - * behavior for this event, add "return false" to the end of the method. - * - * @method mouseMoved - * @example - *
- * - * // Move the mouse across the page - * // to change its value - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function mouseMoved() { - * value = value + 5; - * if (value > 255) { - * value = 0; - * } - * } - * - *
- * - *
- * - * function mouseMoved() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * black 50x50 rect becomes lighter with mouse movements until white then resets - * no image displayed - * - */ - -/** - * 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. - * - * @method mouseDragged - * @example - *
- * - * // Drag the mouse across the page - * // to change its value - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function mouseDragged() { - * value = value + 5; - * if (value > 255) { - * value = 0; - * } - * } - * - *
- * - *
- * - * function mouseDragged() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * black 50x50 rect turns lighter with mouse click and drag until white, resets - * no image displayed - * - */ -p5.prototype._onmousemove = function(e){ - var context = this._isGlobal ? window : this; - var executeDefault; - this._updateNextMouseCoords(e); - if (!this.isMousePressed) { - if (typeof context.mouseMoved === 'function') { - executeDefault = context.mouseMoved(e); - if(executeDefault === false) { - e.preventDefault(); - } - } - } - else { - if (typeof context.mouseDragged === 'function') { - executeDefault = context.mouseDragged(e); - if(executeDefault === false) { - e.preventDefault(); - } - } else if (typeof context.touchMoved === 'function') { - executeDefault = context.touchMoved(e); - if(executeDefault === false) { - e.preventDefault(); - } - } - } -}; - -/** - * 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 - * 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. - * - * @method mousePressed - * @example - *
- * - * // Click within the image to change - * // the value of the rectangle - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function mousePressed() { - * if (value == 0) { - * value = 255; - * } else { - * value = 0; - * } - * } - * - *
- * - *
- * - * function mousePressed() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * black 50x50 rect turns white with mouse click/press. - * no image displayed - * - */ -p5.prototype._onmousedown = function(e) { - var context = this._isGlobal ? window : this; - var executeDefault; - this._setProperty('isMousePressed', true); - this._setProperty('mouseIsPressed', true); - this._setMouseButton(e); - this._updateNextMouseCoords(e); - if (typeof context.mousePressed === 'function') { - executeDefault = context.mousePressed(e); - if(executeDefault === false) { - e.preventDefault(); - } - } else if (typeof context.touchStarted === 'function') { - executeDefault = context.touchStarted(e); - 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() - * 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. - * - * - * @method mouseReleased - * @example - *
- * - * // Click within the image to change - * // the value of the rectangle - * // after the mouse has been clicked - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function mouseReleased() { - * if (value == 0) { - * value = 255; - * } else { - * value = 0; - * } - * } - * - *
- * - *
- * - * function mouseReleased() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * black 50x50 rect turns white with mouse click/press. - * no image displayed - * - */ -p5.prototype._onmouseup = function(e) { - var context = this._isGlobal ? window : this; - var executeDefault; - this._setProperty('isMousePressed', false); - this._setProperty('mouseIsPressed', false); - if (typeof context.mouseReleased === 'function') { - executeDefault = context.mouseReleased(e); - if(executeDefault === false) { - e.preventDefault(); - } - } else if (typeof context.touchEnded === 'function') { - executeDefault = context.touchEnded(e); - if(executeDefault === false) { - e.preventDefault(); - } - } -}; - -p5.prototype._ondragend = p5.prototype._onmouseup; -p5.prototype._ondragover = p5.prototype._onmousemove; - -/** - * The mouseClicked() function is called once after a mouse button has been - * pressed and then released.

- * 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. - * - * @method mouseClicked - * @example - *
- * - * // Click within the image to change - * // the value of the rectangle - * // after the mouse has been clicked - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function mouseClicked() { - * if (value == 0) { - * value = 255; - * } else { - * value = 0; - * } - * } - * - *
- * - *
- * - * function mouseClicked() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * black 50x50 rect turns white with mouse click/press. - * no image displayed - * - */ -p5.prototype._onclick = function(e) { - var context = this._isGlobal ? window : this; - if (typeof context.mouseClicked === 'function') { - var executeDefault = context.mouseClicked(e); - if(executeDefault === false) { - e.preventDefault(); - } - } -}; - -/** - * 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 - * have scrolled. The values can be positive or negative depending on the - * scroll direction (on OS X with "natural" scrolling enabled, the signs - * are inverted).

- * 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.

- * Due to the current support of the "wheel" event on Safari, the function - * may only work as expected if "return false" is included while using Safari. - * - * @method mouseWheel - * - * @example - *
- * - * var pos = 25; - * - * function draw() { - * background(237, 34, 93); - * fill(0); - * rect(25, pos, 50, 50); - * } - * - * function mouseWheel(event) { - * print(event.delta); - * //move the square according to the vertical scroll amount - * pos += event.delta; - * //uncomment to block page scrolling - * //return false; - * } - * - *
- * - * @alt - * black 50x50 rect moves up and down with vertical scroll. fuschia background - * - */ -p5.prototype._onwheel = function(e) { - var context = this._isGlobal ? window : this; - if (typeof context.mouseWheel === 'function') { - e.delta = e.deltaY; - var executeDefault = context.mouseWheel(e); - if(executeDefault === false) { - e.preventDefault(); - } - } -}; - -module.exports = p5; - -},{"../core/constants":41,"../core/core":42}],58:[function(_dereq_,module,exports){ -/** - * @module Events - * @submodule Touch - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * The system variable touches[] contains an array of the positions of all - * current touch points, relative to (0, 0) of the canvas, and IDs identifying a - * unique touch as it moves. Each element in the array is an object with x, y, - * and id properties. - * - * @property {Object[]} touches - */ -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); - } - this._setProperty('touches', touches); - } -}; - - -function getTouchInfo(canvas, w, h, e, i) { - i = i || 0; - var rect = canvas.getBoundingClientRect(); - var sx = canvas.scrollWidth / w; - var sy = canvas.scrollHeight / h; - var touch = e.touches[i] || e.changedTouches[i]; - return { - x: (touch.clientX - rect.left) / sx, - y: (touch.clientY - rect.top) / sy, - winX: touch.clientX, - winY: touch.clientY, - id: touch.identifier - }; -} - -/** - * The touchStarted() function is called once after every time a touch is - * 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" - * to the end of the method. - * - * @method touchStarted - * @example - *
- * - * // Touch within the image to change - * // the value of the rectangle - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function touchStarted() { - * if (value == 0) { - * value = 255; - * } else { - * value = 0; - * } - * } - * - *
- * - *
- * - * function touchStarted() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * 50x50 black rect turns white with touch event. - * no image displayed - */ -p5.prototype._ontouchstart = function(e) { - var context = this._isGlobal ? window : this; - var executeDefault; - this._updateTouchCoords(e); - this._updateNextMouseCoords(e); - if(typeof context.touchStarted === 'function') { - executeDefault = context.touchStarted(e); - if(executeDefault === false) { - e.preventDefault(); - } - } else if (typeof context.mousePressed === 'function') { - executeDefault = context.mousePressed(e); - if(executeDefault === false) { - e.preventDefault(); - } - //this._setMouseButton(e); - } -}; - -/** - * 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" - * to the end of the method. - * - * @method touchMoved - * @example - *
- * - * // Move your finger across the page - * // to change its value - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function touchMoved() { - * value = value + 5; - * if (value > 255) { - * value = 0; - * } - * } - * - *
- * - *
- * - * function touchMoved() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * 50x50 black rect turns lighter with touch until white. resets - * no image displayed - * - */ -p5.prototype._ontouchmove = function(e) { - var context = this._isGlobal ? window : this; - var executeDefault; - this._updateTouchCoords(e); - this._updateNextMouseCoords(e); - if (typeof context.touchMoved === 'function') { - executeDefault = context.touchMoved(e); - if(executeDefault === false) { - e.preventDefault(); - } - } else if (typeof context.mouseDragged === 'function') { - executeDefault = context.mouseDragged(e); - 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 - * 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" - * to the end of the method. - * - * @method touchEnded - * @example - *
- * - * // Release touch within the image to - * // change the value of the rectangle - * - * var value = 0; - * function draw() { - * fill(value); - * rect(25, 25, 50, 50); - * } - * function touchEnded() { - * if (value == 0) { - * value = 255; - * } else { - * value = 0; - * } - * } - * - *
- * - *
- * - * function touchEnded() { - * ellipse(mouseX, mouseY, 5, 5); - * // prevent default - * return false; - * } - * - *
- * - * @alt - * 50x50 black rect turns white with touch. - * no image displayed - * - */ -p5.prototype._ontouchend = function(e) { - this._updateTouchCoords(e); - this._updateNextMouseCoords(e); - if (this.touches.length === 0) { - this._setProperty('touchIsDown', false); - } - var context = this._isGlobal ? window : this; - var executeDefault; - if (typeof context.touchEnded === 'function') { - executeDefault = context.touchEnded(e); - if(executeDefault === false) { - e.preventDefault(); - } - } else if (typeof context.mouseReleased === 'function') { - executeDefault = context.mouseReleased(e); - if(executeDefault === false) { - e.preventDefault(); - } - } else { - e.preventDefault(); - return false; - } -}; - -module.exports = p5; - -},{"../core/core":42}],59:[function(_dereq_,module,exports){ -/*global ImageData:false */ - -/** - * This module defines the filters for use with image buffers. - * - * This module is basically a collection of functions stored in an object - * as opposed to modules. The functions are destructive, modifying - * the passed in canvas rather than creating a copy. - * - * Generally speaking users of this module will use the Filters.apply method - * on a canvas to create an effect. - * - * A number of functions are borrowed/adapted from - * http://www.html5rocks.com/en/tutorials/canvas/imagefilters/ - * or the java processing implementation. - */ - -'use strict'; - -var Filters = {}; - - -/* - * Helper functions - */ - - -/** - * Returns the pixel buffer for a canvas - * - * @private - * - * @param {Canvas|ImageData} canvas the canvas to get pixels from - * @return {Uint8ClampedArray} a one-dimensional array containing - * the data in thc RGBA order, with integer - * values between 0 and 255 - */ -Filters._toPixels = function (canvas) { - if (canvas instanceof ImageData) { - return canvas.data; - } else { - return canvas.getContext('2d').getImageData( - 0, - 0, - canvas.width, - canvas.height - ).data; - } -}; - -/** - * Returns a 32 bit number containing ARGB data at ith pixel in the - * 1D array containing pixels data. - * - * @private - * - * @param {Uint8ClampedArray} data array returned by _toPixels() - * @param {Integer} i index of a 1D Image Array - * @return {Integer} 32 bit integer value representing - * ARGB value. - */ -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; -}; - -/** - * Modifies pixels RGBA values to values contained in the data object. - * - * @private - * - * @param {Uint8ClampedArray} pixels array returned by _toPixels() - * @param {Int32Array} data source 1D array where each value - * represents ARGB values - */ -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; - } -}; - -/** - * Returns the ImageData object for a canvas - * https://developer.mozilla.org/en-US/docs/Web/API/ImageData - * - * @private - * - * @param {Canvas|ImageData} canvas canvas to get image data from - * @return {ImageData} Holder of pixel data (and width and - * height) for a canvas - */ -Filters._toImageData = function (canvas) { - if (canvas instanceof ImageData) { - return canvas; - } else { - return canvas.getContext('2d').getImageData( - 0, - 0, - canvas.width, - canvas.height - ); - } -}; - -/** - * Returns a blank ImageData object. - * - * @private - * - * @param {Integer} width - * @param {Integer} height - * @return {ImageData} - */ -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. - * - * The difference between this and the actual filter functions defined below - * is that the filter functions generally modify the pixel buffer but do - * not actually put that data back to the canvas (where it would actually - * update what is visible). By contrast this method does make the changes - * actually visible in the canvas. - * - * The apply method is the method that callers of this module would generally - * use. It has been separated from the actual filters to support an advanced - * use case of creating a filter chain that executes without actually updating - * the canvas in between everystep. - * - * @param {[type]} func [description] - * @param {[type]} canvas [description] - * @param {[type]} level [description] - * @return {[type]} [description] - */ -Filters.apply = function (canvas, func, filterParam) { - var ctx = canvas.getContext('2d'); - var imageData = ctx.getImageData(0, 0, canvas.width, canvas.height); - - //Filters can either return a new ImageData object, or just modify - //the one they received. - var newImageData = func(imageData, filterParam); - if (newImageData instanceof ImageData) { - ctx.putImageData(newImageData, 0, 0, 0, 0, canvas.width, canvas.height); - } else { - ctx.putImageData(imageData, 0, 0, 0, 0, canvas.width, canvas.height); - } -}; - - -/* - * 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 - * between 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used. - * - * Borrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/ - * - * @param {Canvas} canvas - * @param {Float} level - */ -Filters.threshold = function (canvas, level) { - var pixels = Filters._toPixels(canvas); - - if (level === undefined) { - level = 0.5; - } - var thresh = Math.floor(level * 255); - - for (var i = 0; i < pixels.length; i += 4) { - 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 val; - if (gray >= thresh) { - val = 255; - } else { - val = 0; - } - 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/ - * - * @param {Canvas} canvas - */ -Filters.gray = function (canvas) { - var pixels = Filters._toPixels(canvas); - - for (var i = 0; i < pixels.length; i += 4) { - var r = pixels[i]; - var g = pixels[i + 1]; - var b = pixels[i + 2]; - - // CIE luminance for RGB - var gray = (0.2126 * r + 0.7152 * g + 0.0722 * b); - pixels[i] = pixels[i + 1] = pixels[i + 2] = gray; - } -}; - -/** - * Sets the alpha channel to entirely opaque. No parameter is used. - * - * @param {Canvas} canvas - */ -Filters.opaque = function (canvas) { - var pixels = Filters._toPixels(canvas); - - for (var i = 0; i < pixels.length; i += 4) { - pixels[i + 3] = 255; - } - - return pixels; -}; - -/** - * Sets each pixel to its inverse value. No parameter is used. - * @param {Canvas} canvas - */ -Filters.invert = function (canvas) { - var pixels = Filters._toPixels(canvas); - - for (var i = 0; i < pixels.length; i += 4) { - pixels[i] = 255 - pixels[i]; - 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 - * results are most noticeable in the lower ranges. - * - * Adapted from java based processing implementation - * - * @param {Canvas} canvas - * @param {Integer} level - */ -Filters.posterize = function (canvas, level) { - var pixels = Filters._toPixels(canvas); - - 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) { - 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; - } -}; - -/** - * reduces the bright areas in an image - * @param {Canvas} canvas - * - */ -Filters.dilate = function (canvas) { - var pixels = Filters._toPixels(canvas); - var currIdx = 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) { - currRowIdx = currIdx; - maxRowIdx = currIdx + canvas.width; - while (currIdx < maxRowIdx) { - colOrig = colOut = Filters._getARGB(pixels, currIdx); - idxLeft = currIdx - 1; - idxRight = currIdx + 1; - idxUp = currIdx - canvas.width; - idxDown = currIdx + canvas.width; - - if (idxLeft < currRowIdx) { - idxLeft = currIdx; - } - if (idxRight >= maxRowIdx) { - idxRight = currIdx; - } - if (idxUp < 0){ - idxUp = 0; - } - if (idxDown >= maxIdx) { - idxDown = currIdx; - } - colUp = Filters._getARGB(pixels, idxUp); - colLeft = Filters._getARGB(pixels, idxLeft); - colDown = Filters._getARGB(pixels, idxDown); - 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); - - if (lumLeft > currLum) { - colOut = colLeft; - currLum = lumLeft; - } - if (lumRight > currLum) { - colOut = colRight; - currLum = lumRight; - } - if (lumUp > currLum) { - colOut = colUp; - currLum = lumUp; - } - if (lumDown > currLum) { - colOut = colDown; - currLum = lumDown; - } - out[currIdx++]=colOut; - } - } - Filters._setPixels(pixels, out); -}; - -/** - * increases the bright areas in an image - * @param {Canvas} canvas - * - */ -Filters.erode = function(canvas) { - var pixels = Filters._toPixels(canvas); - var currIdx = 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) { - currRowIdx = currIdx; - maxRowIdx = currIdx + canvas.width; - while (currIdx < maxRowIdx) { - colOrig = colOut = Filters._getARGB(pixels, currIdx); - idxLeft = currIdx - 1; - idxRight = currIdx + 1; - idxUp = currIdx - canvas.width; - idxDown = currIdx + canvas.width; - - if (idxLeft < currRowIdx) { - idxLeft = currIdx; - } - if (idxRight >= maxRowIdx) { - idxRight = currIdx; - } - if (idxUp < 0) { - idxUp = 0; - } - if (idxDown >= maxIdx) { - idxDown = currIdx; - } - colUp = Filters._getARGB(pixels, idxUp); - colLeft = Filters._getARGB(pixels, idxLeft); - colDown = Filters._getARGB(pixels, idxDown); - 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); - - if (lumLeft < currLum) { - colOut = colLeft; - currLum = lumLeft; - } - if (lumRight < currLum) { - colOut = colRight; - currLum = lumRight; - } - if (lumUp < currLum) { - colOut = colUp; - currLum = lumUp; - } - if (lumDown < currLum) { - colOut = colDown; - currLum = lumDown; - } - - out[currIdx++]=colOut; - } - } - Filters._setPixels(pixels, out); -}; - -// BLUR - -// internal kernel stuff for the gaussian blur filter -var blurRadius; -var blurKernelSize; -var blurKernel; -var blurMult; - -/* - * Port of https://github.com/processing/processing/blob/ - * master/core/src/processing/core/PImage.java#L1250 - * - * Optimized code for building the blur kernel. - * further optimized blur code (approx. 15% for radius=20) - * bigger speed gains for larger radii (~30%) - * added support for various image types (ALPHA, RGB, ARGB) - * [toxi 050728] - */ -function buildBlurKernel(r) { - var radius = (r * 3.5)|0; - radius = (radius < 1) ? 1 : ((radius < 248) ? radius : 248); - - if (blurRadius !== radius) { - blurRadius = radius; - blurKernelSize = 1 + blurRadius<<1; - blurKernel = new Int32Array(blurKernelSize); - blurMult = new Array(blurKernelSize); - for(var l = 0; l < blurKernelSize; l++){ - blurMult[l] = new Int32Array(256); - } - - 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]; - bmi = blurMult[radiusi--]; - 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++){ - bm[k] = bk * k; - } - } - -} - -// Port of https://github.com/processing/processing/blob/ -// master/core/src/processing/core/PImage.java#L1433 -function blurARGB(canvas, radius) { - var pixels = Filters._toPixels(canvas); - var width = canvas.width; - var height = canvas.height; - var numPackedPixels = width * height; - var argb = new Int32Array(numPackedPixels); - for (var j = 0; j < numPackedPixels; j++) { - argb[j] = Filters._getARGB(pixels, j); - } - var sum, cr, cg, cb, ca; - var read, ri, ym, ymi, bk0; - var a2 = new Int32Array(numPackedPixels); - var r2 = new Int32Array(numPackedPixels); - var g2 = new Int32Array(numPackedPixels); - var b2 = new Int32Array(numPackedPixels); - var yi = 0; - buildBlurKernel(radius); - var x, y, i; - var bm; - for (y = 0; y < height; y++) { - for (x = 0; x < width; x++) { - cb = cg = cr = ca = sum = 0; - read = x - blurRadius; - if (read < 0) { - bk0 = -read; - read = 0; - } else { - if (read >= width) { - break; - } - bk0 = 0; - } - for (i = bk0; i < blurKernelSize; i++) { - if (read >= width) { - break; - } - var c = argb[read + yi]; - bm = blurMult[i]; - ca += bm[(c & -16777216) >>> 24]; - cr += bm[(c & 16711680) >> 16]; - cg += bm[(c & 65280) >> 8]; - cb += bm[c & 255]; - sum += blurKernel[i]; - read++; - } - ri = yi + x; - a2[ri] = ca / sum; - r2[ri] = cr / sum; - g2[ri] = cg / sum; - b2[ri] = cb / sum; - } - yi += width; - } - yi = 0; - ym = -blurRadius; - ymi = ym * width; - for (y = 0; y < height; y++) { - for (x = 0; x < width; x++) { - cb = cg = cr = ca = sum = 0; - if (ym < 0) { - bk0 = ri = -ym; - read = x; - } else { - if (ym >= height) { - break; - } - bk0 = 0; - ri = ym; - read = x + ymi; - } - for (i = bk0; i < blurKernelSize; i++) { - if (ri >= height) { - break; - } - bm = blurMult[i]; - ca += bm[a2[read]]; - cr += bm[r2[read]]; - cg += bm[g2[read]]; - cb += bm[b2[read]]; - sum += blurKernel[i]; - ri++; - read += width; - } - argb[x + yi] = (ca/sum)<<24 | (cr/sum)<<16 | (cg/sum)<<8 | (cb/sum); - } - yi += width; - ymi += width; - ym++; - } - Filters._setPixels(pixels, argb); -} - -Filters.blur = function(canvas, radius){ - blurARGB(canvas, radius); -}; - - -module.exports = Filters; - -},{}],60:[function(_dereq_,module,exports){ -/** - * @module Image - * @submodule Image - * @for p5 - * @requires core - */ - -/** - * 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 -// 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 = []; - - -/** - * 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 - * 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, - * 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(). - *

- * 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. - * - * @method createImage - * @param {Integer} width width in pixels - * @param {Integer} height height in pixels - * @return {p5.Image} the p5.Image object - * @example - *
- * - * 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)); - * } - * } - * img.updatePixels(); - * image(img, 17, 17); - * - *
- * - *
- * - * 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)); - * } - * } - * img.updatePixels(); - * image(img, 17, 17); - * image(img, 34, 34); - * - *
- * - *
- * - * var pink = color(255, 102, 204); - * 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) { - * img.pixels[i] = red(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); - * - *
- * - * @alt - * 66x66 dark turquoise rect in center of canvas. - * 2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas - * no image displayed - * - */ -p5.prototype.createImage = function(width, height) { - 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 - * file immediately, or prompt the user with a dialogue window. - * - * @method saveCanvas - * @param {Canvas} [selectedCanvas] a variable representing a - * specific html5 canvas (optional) - * @param {String} [filename] - * @param {String} [extension] 'jpg' or 'png' - * @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(); - *
- * - * @alt - * no image displayed - * no image displayed - * no image displayed - * - */ -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]; - } - } - - if (cnv instanceof p5.Element) { - cnv = cnv.elt; - } - if (!(cnv instanceof HTMLCanvasElement)) { - cnv = null; - } - - if (!extension) { - extension = p5.prototype._checkFileExtension(filename, extension)[1]; - if (extension === '') { - extension = 'png'; - } - } - - if (!cnv) { - if (this._curElement && this._curElement.elt) { - cnv = this._curElement.elt; - } - } - - 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'; - 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); - } -}; - -/** - * Capture a sequence of frames that can be used to create a movie. - * Accepts a callback. For example, you may wish to send the frames - * to a server where they can be stored or converted into a movie. - * If no callback is provided, the browser will pop up save dialogues in an - * attempt to download all of the images that have just been created. With the - * callback provided the image data isn't saved by default but instead passed - * as an argument to the callback function as an array of objects, with the - * size of array equal to the total number of frames. - * - * @method saveFrames - * @param {String} filename - * @param {String} extension 'jpg' or 'png' - * @param {Number} duration Duration in seconds to save the frames for. - * @param {Number} framerate Framerate to save the frames in. - * @param {Function} [callback] A callback function that will be executed - to handle the image data. This function - should accept an array as argument. The - array will contain the specified number of - frames of objects. Each object has three - properties: imageData - an - image/octet-stream, filename and extension. - * @example - *
- * function draw() { - * background(mouseX); - * } - * - * 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) { - var duration = _duration || 3; - duration = p5.prototype.constrain(duration, 0, 15); - duration = duration * 1000; - var fps = _fps || 15; - fps = p5.prototype.constrain(fps, 0, 22); - var count = 0; - - var makeFrame = p5.prototype._makeFrame; - var cnv = this._curElement.elt; - var frameFactory = setInterval(function(){ - makeFrame(fName + count, ext, cnv); - count++; - },1000/fps); - - setTimeout(function(){ - clearInterval(frameFactory); - if (callback) { - callback(frames); - } - else { - for (var i = 0; i < frames.length; i++) { - var f = frames[i]; - p5.prototype.downloadFile(f.imageData, f.filename, f.ext); - } - } - frames = []; // clear frames - }, duration + 0.01); -}; - -p5.prototype._makeFrame = function(filename, extension, _cnv) { - var cnv; - if (this) { - cnv = this._curElement.elt; - } else { - cnv = _cnv; - } - var mimeType; - if (!extension) { - extension = 'png'; - mimeType = 'image/png'; - } - else { - 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 = cnv.toDataURL(mimeType); - imageData = imageData.replace(mimeType, downloadMime); - - var thisFrame = {}; - thisFrame.imageData = imageData; - thisFrame.filename = filename; - thisFrame.ext = extension; - frames.push(thisFrame); -}; - -module.exports = p5; - -},{"../core/core":42}],61:[function(_dereq_,module,exports){ -/** - * @module Image - * @submodule Loading & Displaying - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -var Filters = _dereq_('./filters'); -var canvas = _dereq_('../core/canvas'); -var constants = _dereq_('../core/constants'); - -_dereq_('../core/error_helpers'); - -/** - * 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(). - * 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 - * that links in your sketch. Loading an from a URL or other - * remote location may be blocked due to your browser's built-in - * security. - * - * @method loadImage - * @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. - * @param {Function(Event)} [failureCallback] called with event error if - * the image fails to load. - * @return {p5.Image} the p5.Image object - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/laDefense.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * } - * - *
- *
- * - * function setup() { - * // here we use a callback to display the image after loading - * loadImage("assets/laDefense.jpg", function(img) { - * image(img, 0, 0); - * }); - * } - * - *
- * - * @alt - * image of the underside of a white umbrella and grided ceililng above - * image of the underside of a white umbrella and grided ceililng above - * - */ -p5.prototype.loadImage = function(path, successCallback, failureCallback) { - var img = new Image(); - var pImg = new p5.Image(1, 1, this); - var decrementPreload = p5._getDecrementPreload.apply(this, arguments); - - img.onload = function() { - pImg.width = pImg.canvas.width = img.width; - pImg.height = pImg.canvas.height = img.height; - - // Draw the image into the backing canvas of the p5.Image - pImg.drawingContext.drawImage(img, 0, 0); - - if (typeof successCallback === 'function') { - successCallback(pImg); - } - if (decrementPreload && (successCallback !== decrementPreload)) { - decrementPreload(); - } - }; - img.onerror = function(e) { - p5._friendlyFileLoadError(0,img.src); - // don't get failure callback mixed up with decrementPreload - if ((typeof failureCallback === 'function') && - (failureCallback !== decrementPreload)) { - 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 - // 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) { - img.crossOrigin = 'Anonymous'; - } - - //start loading the image - img.src = path; - - return pImg; -}; - -/** - * Validates clipping params. Per drawImage spec sWidth and sHight cannot be - * negative or greater than image intrinsic width and height - * @private - * @param {Number} sVal - * @param {Number} iVal - * @returns {Number} - * @private - */ -function _sAssign(sVal, iVal) { - if (sVal > 0 && sVal < iVal) { - return sVal; - } - else { - return iVal; - } -} - -/** - * Draw an image to the main canvas of the p5js sketch - * - * @method image - * @param {p5.Image} img the image to display - * @param {Number} x the x-coordinate at which to place the top-left - * corner of the source image - * @param {Number} y the y-coordinate at which to place the top-left - * corner of the source image - * @param {Number} width the width to draw the image - * @param {Number} height the height to draw the image - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/laDefense.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * image(img, 0, 0, 100, 100); - * image(img, 0, 0, 100, 100, 0, 0, 100, 100); - * } - * - *
- *
- * - * function setup() { - * // here we use a callback to display the image after loading - * loadImage("assets/laDefense.jpg", function(img) { - * image(img, 0, 0); - * }); - * } - * - *
- * - * @alt - * image of the underside of a white umbrella and grided ceiling above - * image of the underside of a white umbrella and grided ceiling above - * - */ -/** - * @method image - * @param {p5.Image} img - * @param {Number} dx the x-coordinate in the destination canvas at - * which to place the top-left corner of the - * source image - * @param {Number} dy the y-coordinate in the destination canvas at - * which to place the top-left corner of the - * source image - * @param {Number} dWidth the width to draw the image in the destination - * canvas - * @param {Number} dHeight the height to draw the image in the destination - * canvas - * @param {Number} sx the x-coordinate of the top left corner of the - * sub-rectangle of the source image to draw into - * the destination canvas - * @param {Number} sy the y-coordinate of the top left corner of the - * sub-rectangle of the source image to draw into - * the destination canvas - * @param {Number} [sWidth] the width of the sub-rectangle of the - * source image to draw into the destination - * canvas - * @param {Number} [sHeight] the height of the sub-rectangle of the - * source image to draw into the destination context - */ -p5.prototype.image = - function(img, dx, dy, dWidth, dHeight, sx, sy, sWidth, sHeight) { - // set defaults per spec: https://goo.gl/3ykfOq - - var defW = img.width; - var defH = img.height; - - if (img.elt && img.elt.videoWidth && !img.canvas) { // video no canvas - var actualW = img.elt.videoWidth; - var actualH = img.elt.videoHeight; - defW = img.elt.videoWidth; - defH = img.elt.width*actualH/actualW; - } - - var _dx = dx; - var _dy = dy; - var _dw = dWidth || defW; - var _dh = dHeight || defH; - var _sx = sx || 0; - var _sy = sy || 0; - var _sw = sWidth || defW; - var _sh = sHeight || defH; - - _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 - var pd = 1; - - if (img.elt && img.elt.videoWidth && img.elt.style.width && !img.canvas) { - pd = img.elt.videoWidth / parseInt(img.elt.style.width, 10); - } - else if (img.elt && img.elt.width && img.elt.style.width) { - pd = img.elt.width / parseInt(img.elt.style.width, 10); - } - - _sx *= pd; - _sy *= pd; - _sh *= pd; - _sw *= pd; - - 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); -}; - - -/** - * Sets the fill value for displaying images. Images can be tinted to - * specified colors or made transparent by including an alpha value. - *

- * 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()). - *

- * 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 - * 255. - * - * @method tint - * @param {Number|Array} v1 gray value, red or hue value (depending on the - * current color mode), or color Array - * @param {Number|Array} [v2] green or saturation value (depending on the - * current color mode) - * @param {Number|Array} [v3] blue or brightness value (depending on the - * current color mode) - * @param {Number|Array} [a] opacity of the background - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/laDefense.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * tint(0, 153, 204); // Tint blue - * image(img, 50, 0); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/laDefense.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * tint(0, 153, 204, 126); // Tint blue and set transparency - * image(img, 50, 0); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/laDefense.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * tint(255, 126); // Apply transparency without changing color - * image(img, 50, 0); - * } - * - *
- * - * @alt - * 2 side by side images of umbrella and ceiling, one image with blue tint - * Images of umbrella and ceiling, one half of image with blue tint - * 2 side by side images of umbrella and ceiling, one image translucent - * - */ -p5.prototype.tint = function () { - var c = this.color.apply(this, arguments); - this._renderer._tint = c.levels; -}; - -/** - * Removes the current fill value for displaying images and reverts to - * displaying images with their original hues. - * - * @method noTint - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * tint(0, 153, 204); // Tint blue - * image(img, 0, 0); - * noTint(); // Disable tint - * image(img, 50, 0); - * } - * - *
- * - * @alt - * 2 side by side images of bricks, left image with blue tint - * - */ -p5.prototype.noTint = function() { - this._renderer._tint = null; -}; - -/** - * Apply the current tint color to the input image, return the resulting - * canvas. - * - * @param {p5.Image} The image to be tinted - * @return {canvas} The resulting tinted canvas - * - */ -p5.prototype._getTintedImageCanvas = function(img) { - if (!img.canvas) { - return img; - } - var pixels = Filters._toPixels(img.canvas); - var tmpCanvas = document.createElement('canvas'); - tmpCanvas.width = img.canvas.width; - tmpCanvas.height = img.canvas.height; - var tmpCtx = tmpCanvas.getContext('2d'); - var id = tmpCtx.createImageData(img.canvas.width, img.canvas.height); - var newPixels = id.data; - - 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]; - - 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); - return tmpCanvas; -}; - -/** - * Set image mode. Modifies the location from which images are drawn by - * 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 - * 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() - * 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() - * as the image's center point. If two additional parameters are specified, - * they are used to set the image's width and height. - * - * @method imageMode - * @param {Constant} mode either CORNER, CORNERS, or CENTER - * @example - * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * imageMode(CORNER); - * image(img, 10, 10, 50, 50); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * imageMode(CORNERS); - * image(img, 10, 10, 90, 40); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * imageMode(CENTER); - * image(img, 50, 50, 80, 80); - * } - * - *
- * - * @alt - * small square image of bricks - * horizontal rectangle image of bricks - * large square image of bricks - * - */ -p5.prototype.imageMode = function(m) { - if (m === constants.CORNER || - m === constants.CORNERS || - m === constants.CENTER) { - this._renderer._imageMode = m; - } -}; - - -module.exports = p5; - -},{"../core/canvas":40,"../core/constants":41,"../core/core":42,"../core/error_helpers":45,"./filters":59}],62:[function(_dereq_,module,exports){ -/** - * @module Image - * @submodule Image - * @requires core - * @requires constants - * @requires filters - */ - -/** - * 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 Filters = _dereq_('./filters'); - -/* - * Class methods - */ - -/** - * 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 - * 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 - * the image to make sure that the pixel data is properly loaded. - * - * @class p5.Image - * @constructor - * @param {Number} width - * @param {Number} height - * @param {Object} pInst An instance of a p5 sketch. - */ -p5.Image = function(width, height){ - /** - * Image width. - * @property width - * @example - *
- * var img; - * function preload() { - * 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); - * stroke(c); - * line(i, height/2, i, height); - * } - * } - *
- * - * @alt - * rocky mountains in top and horizontal lines in corresponding colors in bottom. - * - */ - this.width = width; - /** - * Image height. - * @property height - * @example - *
- * var img; - * function preload() { - * 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); - * stroke(c); - * line(0, i, width/2, i); - * } - * } - *
- * - * @alt - * rocky mountains on right and vertical lines in corresponding colors on left. - * - */ - this.height = height; - this.canvas = document.createElement('canvas'); - this.canvas.width = this.width; - this.canvas.height = this.height; - this.drawingContext = this.canvas.getContext('2d'); - this._pixelDensity = 1; - //used for webgl texturing only - this.isTexture = false; - /** - * 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 - * 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 - * (indices 0-3) in the array will be the R, G, B, A values of the pixel at - * (0, 0). The second four values (indices 4-7) will contain the R, G, B, A - * values of the pixel at (1, 0). More generally, to set values for a pixel - * at (x, y): - * ```javascript - * var d = pixelDensity; - * for (var i = 0; i < d; i++) { - * for (var j = 0; j < d; j++) { - * // loop over - * idx = 4 * ((y * d + j) * width * d + (x * d + i)); - * pixels[idx] = r; - * pixels[idx+1] = g; - * pixels[idx+2] = b; - * pixels[idx+3] = a; - * } - * } - * ``` - *

- * 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); - * img.loadPixels(); - * for (i = 0; i < img.width; i++) { - * for (j = 0; j < img.height; j++) { - * img.set(i, j, color(0, 90, 102)); - * } - * } - * img.updatePixels(); - * image(img, 17, 17); - * - *
- *
- * - * var pink = color(255, 102, 204); - * img = createImage(66, 66); - * img.loadPixels(); - * 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.updatePixels(); - * image(img, 17, 17); - * - *
- * - * @alt - * 66x66 turquoise rect in center of canvas - * 66x66 pink rect in center of canvas - * - */ - this.pixels = []; -}; - -/** - * Helper fxn for sharing pixel methods - * - */ -p5.Image.prototype._setProperty = function (prop, value) { - this[prop] = value; -}; - -/** - * Loads the pixels data for this image into the [pixels] attribute. - * - * @method loadPixels - * @example - *
- * var myImage; - * var halfImage; - * - * function preload() { - * 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]; - * } - * myImage.updatePixels(); - * } - * - * function draw() { - * image(myImage, 0, 0); - * } - *
- * - * @alt - * 2 images of rocky mountains vertically stacked - * - */ -p5.Image.prototype.loadPixels = function(){ - p5.Renderer2D.prototype.loadPixels.call(this); -}; - -/** - * Updates the backing canvas for this image with the contents of - * the [pixels] array. - * - * @method updatePixels - * @param {Integer|undefined} x x-offset of the target update area for the - * underlying canvas - * @param {Integer|undefined} y y-offset of the target update area for the - * underlying canvas - * @param {Integer|undefined} w height of the target update area for the - * underlying canvas - * @param {Integer|undefined} h height of the target update area for the - * underlying canvas - * @example - *
- * var myImage; - * var halfImage; - * - * function preload() { - * 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]; - * } - * myImage.updatePixels(); - * } - * - * function draw() { - * image(myImage, 0, 0); - * } - *
- * - * @alt - * 2 images of rocky mountains vertically stacked - * - */ -p5.Image.prototype.updatePixels = function(x, y, w, h){ - p5.Renderer2D.prototype.updatePixels.call(this, x, y, w, h); -}; - -/** - * Get a region of pixels from an image. - * - * 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 - * is returned. - * - * Returns undefined if the region is outside the bounds of the image - * - * @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 - * @example - *
- * var myImage; - * var c; - * - * function preload() { - * myImage = loadImage("assets/rockies.jpg"); - * } - * - * function setup() { - * background(myImage); - * noStroke(); - * c = myImage.get(60, 90); - * fill(c); - * rect(25, 25, 50, 50); - * } - * - * //get() returns color here - *
- * - * @alt - * image of rocky mountains with 50x50 green rect in front - * - */ -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. - * - * Note that for a large number of pixels this will - * be slower than directly manipulating the pixels array - * 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 - * @example - *
- * - * 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)); - * } - * } - * img.updatePixels(); - * image(img, 17, 17); - * image(img, 34, 34); - * - *
- * - * @alt - * 2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas - * - */ -p5.Image.prototype.set = function(x, y, imgOrCol){ - p5.Renderer2D.prototype.set.call(this, x, y, imgOrCol); -}; - -/** - * Resize the image to a new width and height. To make the image scale - * proportionally, use 0 as the value for the wide or high parameter. - * For instance, to make the width of an image 150 pixels, and change - * the height using the same proportion, use resize(150, 0). - * - * @method resize - * @param {Number} width the resized image width - * @param {Number} height the resized image height - * @example - *
- * var img; - * - * function setup() { - * img = loadImage("assets/rockies.jpg"); - * } - - * function draw() { - * image(img, 0, 0); - * } - * - * function mousePressed() { - * img.resize(50, 100); - * } - *
- * - * @alt - * image of rocky mountains. zoomed in - * - */ -p5.Image.prototype.resize = function(width, height){ - - // Copy contents to a temporary canvas, resize the original - // and then copy back. - // - // There is a faster approach that involves just one copy and swapping the - // this.canvas reference. We could switch to that approach if (as i think - // is the case) there an expectation that the user would not hold a - // reference to the backing canvas of a p5.Image. But since we do not - // enforce that at the moment, I am leaving in the slower, but safer - // implementation. - - // auto-resize - if (width === 0 && height === 0) { - width = this.canvas.width; - height = this.canvas.height; - } else if (width === 0) { - width = this.canvas.width * height / this.canvas.height; - } else if (height === 0) { - height = this.canvas.height * width / this.canvas.width; - } - - width = Math.floor(width); - height = Math.floor(height); - - var tempCanvas = document.createElement('canvas'); - tempCanvas.width = width; - tempCanvas.height = height; - 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, - 0, 0, width, height, - 0, 0, width, height - ); - - if(this.pixels.length > 0){ - this.loadPixels(); - } -}; - -/** - * Copies a region of pixels from one image to another. If no - * srcImage is specified this is used as the source. If the source - * and destination regions aren't the same size, it will - * automatically resize source pixels to fit the specified - * target region. - * - * @method copy - * @param {p5.Image|undefined} 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 - * @param {Integer} sh source image height - * @param {Integer} dx X coordinate of the destination's upper left corner - * @param {Integer} dy Y coordinate of the destination's upper left corner - * @param {Integer} dw destination image width - * @param {Integer} dh destination image height - * @example - *
- * var photo; - * var bricks; - * var x; - * var y; - * - * function preload() { - * photo = loadImage("assets/rockies.jpg"); - * bricks = loadImage("assets/bricks.jpg"); - * } - * - * function setup() { - * x = bricks.width/2; - * y = bricks.height/2; - * photo.copy(bricks, 0, 0, x, y, 0, 0, x, y); - * image(photo, 0, 0); - * } - *
- * - * @alt - * 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); -}; - -/** - * Masks part of an image from displaying by loading another - * image and using it's alpha channel as an alpha channel for - * this image. - * - * @method mask - * @param {p5.Image} srcImage source image - * @example - *
- * var photo, maskImage; - * function preload() { - * photo = loadImage("assets/rockies.jpg"); - * maskImage = loadImage("assets/mask2.png"); - * } - * - * function setup() { - * createCanvas(100, 100); - * photo.mask(maskImage); - * image(photo, 0, 0); - * } - *
- * - * @alt - * image of rocky mountains with white at right - * - * - * http://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/ - * - */ -// TODO: - Accept an array of alpha values. -// - Use other channels of an image. p5 uses the -// blue channel (which feels kind of arbitrary). Note: at the -// moment this method does not match native processings original -// functionality exactly. -p5.Image.prototype.mask = function(p5Image) { - if(p5Image === undefined){ - p5Image = this; - } - var currBlend = this.drawingContext.globalCompositeOperation; - - var scaleFactor = 1; - if (p5Image instanceof p5.Renderer) { - scaleFactor = p5Image._pInst._pixelDensity; - } - - var copyArgs = [ - p5Image, - 0, - 0, - scaleFactor*p5Image.width, - scaleFactor*p5Image.height, - 0, - 0, - this.width, - this.height - ]; - - this.drawingContext.globalCompositeOperation = 'destination-in'; - p5.Image.prototype.copy.apply(this, copyArgs); - this.drawingContext.globalCompositeOperation = currBlend; -}; - -/** - * Applies an image filter to a p5.Image - * - * @method filter - * @param {String} operation one of threshold, gray, invert, posterize and - * opaque see Filters.js for docs on each available - * filter - * @param {Number|undefined} value - * @example - *
- * var photo1; - * var photo2; - * - * function preload() { - * photo1 = loadImage("assets/rockies.jpg"); - * photo2 = loadImage("assets/rockies.jpg"); - * } - * - * function setup() { - * photo2.filter("gray"); - * image(photo1, 0, 0); - * image(photo2, width/2, 0); - * } - *
- * - * @alt - * 2 images of rocky mountains left one in color, right in black and white - * - */ -p5.Image.prototype.filter = function(operation, value) { - Filters.apply(this.canvas, Filters[operation.toLowerCase()], value); -}; - -/** - * Copies a region of pixels from one image to another, using a specified - * blend mode to do the operation. - * - * @method blend - * @param {p5.Image|undefined} 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 - * @param {Integer} sh source image height - * @param {Integer} dx X coordinate of the destination's upper left corner - * @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 - * - * Available blend modes are: normal | multiply | screen | overlay | - * darken | lighten | color-dodge | color-burn | hard-light | - * soft-light | difference | exclusion | hue | saturation | - * color | luminosity - * - * - * http://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/ - * @example - *
- * var mountains; - * var bricks; - * - * function preload() { - * mountains = loadImage("assets/rockies.jpg"); - * bricks = loadImage("assets/bricks_third.jpg"); - * } - * - * function setup() { - * mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, ADD); - * image(mountains, 0, 0); - * image(bricks, 0, 0); - * } - *
- *
- * var mountains; - * var bricks; - * - * function preload() { - * mountains = loadImage("assets/rockies.jpg"); - * bricks = loadImage("assets/bricks_third.jpg"); - * } - * - * function setup() { - * mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST); - * image(mountains, 0, 0); - * image(bricks, 0, 0); - * } - *
- *
- * var mountains; - * var bricks; - * - * function preload() { - * mountains = loadImage("assets/rockies.jpg"); - * bricks = loadImage("assets/bricks_third.jpg"); - * } - * - * function setup() { - * mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST); - * image(mountains, 0, 0); - * image(bricks, 0, 0); - * } - *
- * - * @alt - * image of rocky mountains. Brick images on left and right. Right overexposed - * image of rockies. Brickwall images on left and right. Right mortar transparent - * image of rockies. Brickwall images on left and right. Right translucent - * - */ -p5.Image.prototype.blend = function() { - p5.prototype.blend.apply(this, arguments); -}; - -/** - * Saves the image to a file and force the browser to download it. - * Accepts two strings for filename and file extension - * Supports png (default) and jpg. - * - * @method save - * @param {String} filename give your file a name - * @param {String} extension 'png' or 'jpg' - * @example - *
- * var photo; - * - * function preload() { - * photo = loadImage("assets/rockies.jpg"); - * } - * - * function draw() { - * image(photo, 0, 0); - * } - * - * function keyTyped() { - * if (key == 's') { - * photo.save("photo", "png"); - * } - * } - *
- * - * @alt - * image of rocky mountains. - * - */ -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); -}; - -module.exports = p5.Image; -},{"../core/core":42,"./filters":59}],63:[function(_dereq_,module,exports){ -/** - * @module Image - * @submodule Pixels - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -var Filters = _dereq_('./filters'); -_dereq_('../color/p5.Color'); - -/** - * 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, - * 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 will have more pixels[] (by a factor of - * pixelDensity^2). - * For example, if the image is 100x100 pixels, there will be 40,000. On a - * retina display, there will be 160,000. - *

- * The first four values (indices 0-3) in the array will be the R, G, B, A - * values of the pixel at (0, 0). The second four values (indices 4-7) will - * contain the R, G, B, A values of the pixel at (1, 0). More generally, to - * set values for a pixel at (x, y): - * ```javascript - * var d = pixelDensity; - * for (var i = 0; i < d; i++) { - * for (var j = 0; j < d; j++) { - * // loop over - * idx = 4 * ((y * d + j) * width * d + (x * d + i)); - * pixels[idx] = r; - * pixels[idx+1] = g; - * pixels[idx+2] = b; - * pixels[idx+3] = a; - * } - * } - * ``` - *

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, 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() - * 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 - * work.

- * - * @property {Number[]} pixels - * @example - *
- * - * 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) { - * pixels[i] = red(pink); - * pixels[i+1] = green(pink); - * pixels[i+2] = blue(pink); - * pixels[i+3] = alpha(pink); - * } - * updatePixels(); - * - *
- * - * @alt - * top half of canvas pink, bottom grey - * - */ -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 - * - * - * @method blend - * @param {p5.Image|undefined} 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 - * @param {Integer} sh source image height - * @param {Integer} dx X coordinate of the destination's upper left corner - * @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 - * - * @example - *
- * var img0; - * var img1; - * - * function preload() { - * img0 = loadImage("assets/rockies.jpg"); - * img1 = loadImage("assets/bricks_third.jpg"); - * } - * - * function setup() { - * background(img0); - * image(img1, 0, 0); - * blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST); - * } - *
- *
- * var img0; - * var img1; - * - * function preload() { - * img0 = loadImage("assets/rockies.jpg"); - * img1 = loadImage("assets/bricks_third.jpg"); - * } - * - * function setup() { - * background(img0); - * image(img1, 0, 0); - * blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST); - * } - *
- *
- * var img0; - * var img1; - * - * function preload() { - * img0 = loadImage("assets/rockies.jpg"); - * img1 = loadImage("assets/bricks_third.jpg"); - * } - * - * function setup() { - * background(img0); - * image(img1, 0, 0); - * blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, ADD); - * } - *
- * - * @alt - * image of rocky mountains. Brick images on left and right. Right overexposed - * image of rockies. Brickwall images on left and right. Right mortar transparent - * image of rockies. Brickwall images on left and right. Right translucent - * - * - */ -p5.prototype.blend = function() { - if (this._renderer) { - this._renderer.blend.apply(this._renderer, arguments); - } else { - p5.Renderer2D.prototype.blend.apply(this, arguments); - } -}; - -/** - * Copies a region of the canvas to another region of the canvas - * and copies a region of pixels from an image used as the srcImg parameter - * into the canvas srcImage is specified this is used as the source. If - * the source and destination regions aren't the same size, it will - * automatically resize source pixels to fit the specified - * target region. - * - * @method copy - * @param {p5.Image|undefined} 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 - * @param {Integer} sh source image height - * @param {Integer} dx X coordinate of the destination's upper left corner - * @param {Integer} dy Y coordinate of the destination's upper left corner - * @param {Integer} dw destination image width - * @param {Integer} dh destination image height - * - * @example - *
- * var img; - * - * function preload() { - * img = loadImage("assets/rockies.jpg"); - * } - * - * function setup() { - * background(img); - * copy(img, 7, 22, 10, 10, 35, 25, 50, 50); - * stroke(255); - * noFill(); - * // Rectangle shows area being copied - * rect(7, 22, 10, 10); - * } - *
- * - * @alt - * image of rocky mountains. Brick images on left and right. Right overexposed - * image of rockies. Brickwall images on left and right. Right mortar transparent - * image of rockies. Brickwall images on left and right. Right translucent - * - */ -p5.prototype.copy = function () { - p5.Renderer2D._copyHelper.apply(this, arguments); -}; - -/** - * Applies a filter to the canvas. - *

- * - * The presets options are: - *

- * - * THRESHOLD - * 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 - * between 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used. - *

- * - * GRAY - * Converts any colors in the image to grayscale equivalents. No parameter - * is used. - *

- * - * OPAQUE - * Sets the alpha channel to entirely opaque. No parameter is used. - *

- * - * INVERT - * Sets each pixel to its inverse value. No parameter is used. - *

- * - * POSTERIZE - * 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 - * results are most noticeable in the lower ranges. - *

- * - * BLUR - * Executes a Guassian 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. - *

- * - * ERODE - * Reduces the light areas. No parameter is used. - *

- * - * DILATE - * Increases the light areas. No parameter is used. - * - * @method filter - * @param {Constant} filterType - * @param {Number} filterParam an optional parameter unique - * to each filter, see above - * - * - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(THRESHOLD); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(GRAY); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(OPAQUE); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(INVERT); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(POSTERIZE,3); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(DILATE); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(BLUR,3); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/bricks.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * filter(ERODE); - * } - * - *
- * - * @alt - * black and white image of a brick wall. - * greyscale image of a brickwall - * image of a brickwall - * jade colored image of a brickwall - * red and pink image of a brickwall - * image of a brickwall - * blurry image of a brickwall - * image of a brickwall - * image of a brickwall with less detail - * - */ -p5.prototype.filter = function(operation, value) { - if(this.canvas !== undefined) { - Filters.apply(this.canvas, Filters[operation.toLowerCase()], value); - } - else { - Filters.apply(this.elt, Filters[operation.toLowerCase()], value); - } -}; - -/** - * 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. - * 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(). - *

- * 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. - *

- * 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 - * - * var off = (y * width + x) * d * 4; - * [pixels[off], - * pixels[off+1], - * pixels[off+2], - * pixels[off+3]] - *

- * See the reference for pixels[] for more information. - * - * @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|p5.Image} values of pixel at x,y in array format - * [R, G, B, A] or p5.Image - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/rockies.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * var c = get(); - * image(c, width/2, 0); - * } - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/rockies.jpg"); - * } - * function setup() { - * image(img, 0, 0); - * var c = get(50, 90); - * fill(c); - * noStroke(); - * rect(25, 25, 50, 50); - * } - * - *
- * - * @alt - * 2 images of the rocky mountains, side-by-side - * Image of the rocky mountains with 50x50 green rect in center of canvas - * - */ -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[]. - * - * @method loadPixels - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/rockies.jpg"); - * } - * - * function setup() { - * image(img, 0, 0); - * var d = pixelDensity(); - * var halfImage = 4 * (img.width * d) * - (img.height/2 * d); - * loadPixels(); - * for (var i = 0; i < halfImage; i++) { - * pixels[i+halfImage] = pixels[i]; - * } - * updatePixels(); - * } - * - *
- * - * @alt - * two images of the rocky mountains. one on top, one on bottom of canvas. - * - */ -p5.prototype.loadPixels = function() { - this._renderer.loadPixels(); -}; - -/** - *

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] - * 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(). - *

- *

- * 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. - *

- *

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[] - * 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.

- * - * @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 - * @example - *
- * - * var black = color(0); - * set(30, 20, black); - * set(85, 20, black); - * set(85, 75, black); - * set(30, 75, black); - * updatePixels(); - * - *
- * - *
- * - * 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); - * } - * } - * updatePixels(); - * - *
- * - *
- * - * var img; - * function preload() { - * img = loadImage("assets/rockies.jpg"); - * } - * - * function setup() { - * set(0, 0, img); - * updatePixels(); - * line(0, 0, width, height); - * line(0, height, width, 0); - * } - * - *
- * - * @alt - * 4 black points in the shape of a square middle-right of canvas. - * 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) { - 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. - * - * @method updatePixels - * @param {Number} [x] x-coordinate of the upper-left corner of region - * to update - * @param {Number} [y] y-coordinate of the upper-left corner of region - * to update - * @param {Number} [w] width of region to update - * @param {Number} [h] height of region to update - * @example - *
- * - * var img; - * function preload() { - * img = loadImage("assets/rockies.jpg"); - * } - * - * function setup() { - * image(img, 0, 0); - * var halfImage = 4 * (img.width * pixelDensity()) * - * (img.height * pixelDensity()/2); - * loadPixels(); - * for (var i = 0; i < halfImage; i++) { - * pixels[i+halfImage] = pixels[i]; - * } - * updatePixels(); - * } - * - *
- * @alt - * two images of the rocky mountains. one on top, one on bottom of canvas. - */ -p5.prototype.updatePixels = function (x, y, w, h) { - // graceful fail - if loadPixels() or set() has not been called, pixel - // array will be empty, ignore call to updatePixels() - if (this.pixels.length === 0) { - return; - } - this._renderer.updatePixels(x, y, w, h); -}; - -module.exports = p5; - -},{"../color/p5.Color":36,"../core/core":42,"./filters":59}],64:[function(_dereq_,module,exports){ -/** - * @module IO - * @submodule Input - * @for p5 - * @requires core - */ - -/* globals Request: false */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -var opentype = _dereq_('opentype.js'); -_dereq_('whatwg-fetch'); -_dereq_('es6-promise').polyfill(); -var fetchJsonp = _dereq_('fetch-jsonp'); -_dereq_('../core/error_helpers'); - -/** - * Checks if we are in preload and returns the last arg which will be the - * _decrementPreload function if called from a loadX() function. Should - * only be used in loadX() functions. - * @private - */ -p5._getDecrementPreload = function () { - var decrementPreload = arguments[arguments.length - 1]; - - // when in preload decrementPreload will always be the last arg as it is set - // with args.push() before invocation in _wrapPreload - if ((window.preload || (this && this.preload)) && - typeof decrementPreload === 'function') { - return decrementPreload; - } else { - return null; - } -}; - -/** - * Loads an opentype font file (.otf, .ttf) from a file or a URL, - * and returns a PFont Object. This method is asynchronous, - * meaning it may not finish before the next line in your sketch - * is executed. - *

- * The path to the font should be relative to the HTML file - * that links in your sketch. Loading an from a URL or other - * remote location may be blocked due to your browser's built-in - * security. - * - * @method loadFont - * @param {String} path name of the file or url to load - * @param {Function} [callback] function to be executed after - * loadFont() - * completes - * @return {Object} p5.Font object - * @example - * - *

Calling loadFont() inside preload() guarantees that the load - * operation will have completed before setup() and draw() are called.

- * - *
- * var myFont; - * function preload() { - * myFont = loadFont('assets/AvenirNextLTPro-Demi.otf'); - * } - * - * function setup() { - * fill('#ED225D'); - * textFont(myFont); - * textSize(36); - * text('p5*js', 10, 50); - * } - *
- * - * Outside of preload(), you may supply a callback function to handle the - * object: - * - *
- * function setup() { - * loadFont('assets/AvenirNextLTPro-Demi.otf', drawText); - * } - * - * function drawText(font) { - * fill('#ED225D'); - * 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'); - * } - * - * function setup() { - * var myDiv = createDiv('hello there'); - * myDiv.style('font-family', 'Avenir'); - * } - *
- * - * @alt - * p5*js in p5's theme dark pink - * p5*js in p5's theme dark pink - * - */ -p5.prototype.loadFont = function (path, onSuccess, onError) { - - var p5Font = new p5.Font(this); - var decrementPreload = p5._getDecrementPreload.apply(this, arguments); - - opentype.load(path, function (err, font) { - - if (err) { - - if ((typeof onError !== 'undefined') && (onError !== decrementPreload)) { - return onError(err); - } - p5._friendlyFileLoadError(4, path); - console.error(err, path); - return; - } - - p5Font.font = font; - - if (typeof onSuccess !== 'undefined') { - onSuccess(p5Font); - } - - if (decrementPreload && (onSuccess !== decrementPreload)) { - 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, - 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')); - document.head.appendChild(newStyle); - } - - }); - - return p5Font; -}; - -//BufferedReader -p5.prototype.createInput = function () { - // TODO - throw 'not yet implemented'; -}; - -p5.prototype.createReader = function () { - // TODO - throw 'not yet implemented'; -}; - -p5.prototype.loadBytes = function () { - // TODO - throw 'not yet implemented'; -}; - -/** - * Loads a JSON file from a file or a URL, and returns an Object or Array. - * This method is asynchronous, meaning it may not finish before the next - * line in your sketch is executed. JSONP is supported via a polyfill and you - * can pass in as the second argument an object with definitions of the json - * callback following the syntax specified here. - * - * @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 - * in as first argument - * @param {Function} [errorCallback] function to be executed if - * there is an error, response is passed - * in as first argument - * @return {Object|Array} JSON data - * @example - * - *

Calling loadJSON() inside preload() guarantees to complete the - * operation before setup() and draw() are called.

- * - *
- * var weather; - * function preload() { - * var url = 'http://api.openweathermap.org/data/2.5/weather?q=London,UK'+ - * '&APPID=7bbbb47522848e8b9c26ba35c226c734'; - * weather = loadJSON(url); - * } - * - * function setup() { - * noLoop(); - * } - * - * function draw() { - * background(200); - * // get the humidity value out of the loaded JSON - * var humidity = weather.main.humidity; - * fill(0, humidity); // use the humidity value to set the alpha - * ellipse(width/2, height/2, 50, 50); - * } - *
- * - * - *

Outside of preload(), you may supply a callback function to handle the - * object:

- *
- * function setup() { - * noLoop(); - * var url = 'http://api.openweathermap.org/data/2.5/weather?q=NewYork'+ - * '&APPID=7bbbb47522848e8b9c26ba35c226c734'; - * loadJSON(url, drawWeather); - * } - * - * function draw() { - * background(200); - * } - * - * function drawWeather(weather) { - * // get the humidity value out of the loaded JSON - * var humidity = weather.main.humidity; - * fill(0, humidity); // use the humidity value to set the alpha - * ellipse(width/2, height/2, 50, 50); - * } - *
- * - * @alt - * 50x50 ellipse that changes from black to white depending on the current humidity - * 50x50 ellipse that changes from black to white depending on the current humidity - * - */ -p5.prototype.loadJSON = function () { - var path = arguments[0]; - var callback; - var errorCallback; - var options; - var decrementPreload = p5._getDecrementPreload.apply(this, arguments); - - var ret = {}; // object needed for preload - var t = 'json'; - - // check for explicit data type argument - for (var i = 1; i < arguments.length; i++) { - var arg = arguments[i]; - if (typeof arg === 'string') { - if (arg === 'jsonp' || arg === 'json') { - t = arg; - } - } else if (typeof arg === 'function') { - if(!callback){ - callback = arg; - }else{ - errorCallback = arg; - } - } else if (typeof arg === 'object' && arg.hasOwnProperty('jsonpCallback')){ - t = 'jsonp'; - options = arg; - } - } - - p5.prototype.httpDo(path, 'GET', options, t, function(resp){ - for (var k in resp) { - ret[k] = resp[k]; - } - if (typeof callback !== 'undefined') { - callback(resp); - } - if (decrementPreload && (callback !== decrementPreload)) { - decrementPreload(); - } - }, errorCallback); - - return ret; -}; - -/** - * Reads the contents of a file and creates a String array of its individual - * lines. If the name of the file is used as the parameter, as in the above - * example, the file must be located in the sketch directory/folder. - *

- * Alternatively, the file maybe be loaded from anywhere on the local - * computer using an absolute path (something that starts with / on Unix and - * Linux, or a drive letter on Windows), or the filename parameter can be a - * 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. - * - * @method loadStrings - * @param {String} filename name of the file or url to load - * @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 - * there is an error, response is passed - * in as first argument - * @return {Array} Array of Strings - * @example - * - *

Calling loadStrings() inside preload() guarantees to complete the - * operation before setup() and draw() are called.

- * - *
- * var result; - * function preload() { - * result = loadStrings('assets/test.txt'); - * } - - * function setup() { - * background(200); - * var ind = floor(random(result.length)); - * text(result[ind], 10, 10, 80, 80); - * } - *
- * - *

Outside of preload(), you may supply a callback function to handle the - * object:

- * - *
- * function setup() { - * loadStrings('assets/test.txt', pickString); - * } - * - * function pickString(result) { - * background(200); - * var ind = floor(random(result.length)); - * text(result[ind], 10, 10, 80, 80); - * } - *
- * - * @alt - * randomly generated text from a file, for example "i smell like butter" - * randomly generated text from a file, for example "i have three feet" - * - */ -p5.prototype.loadStrings = function (path, callback, errorCallback) { - var ret = []; - var decrementPreload = p5._getDecrementPreload.apply(this, arguments); - - p5.prototype.httpDo(path, 'GET', 'text', function(data){ - var arr = data.match(/[^\r\n]+/g); - for (var k in arr) { - ret[k] = arr[k]; - } - - if (typeof callback !== 'undefined') { - callback(ret); - } - if (decrementPreload && (callback !== decrementPreload)) { - decrementPreload(); - } - }, errorCallback); - - return ret; -}; - -/** - *

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 - * format). Table only looks for a header row if the 'header' option is - * included.

- * - *

Possible options include: - *

    - *
  • csv - parse the table as comma-separated values
    • - *
  • tsv - parse the table as tab-separated values
    • - *
  • header - this table has a header (title) row
    • - *
- *

- * - *

When passing in multiple options, pass them in as separate parameters, - * seperated by commas. For example: - *

- * - * 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 - * object:

- *

- * - * @method loadTable - * @param {String} filename name of the file or URL to load - * @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 - * 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 - * - * @example - *
- * - * // Given the following CSV file called "mammals.csv" - * // located 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"); - * //the file can be remote - * //table = loadTable("http://p5js.org/reference/assets/mammals.csv", - * // "csv", "header"); - * } - * - * function setup() { - * //count the columns - * print(table.getRowCount() + " total rows in table"); - * print(table.getColumnCount() + " total columns in table"); - * - * print(table.getColumn("name")); - * //["Goat", "Leopard", "Zebra"] - * - * //cycle through the table - * for (var r = 0; r < table.getRowCount(); r++) - * for (var c = 0; c < table.getColumnCount(); c++) { - * print(table.getString(r, c)); - * } - * } - * - *
- * - * @alt - * randomly generated text from a file, for example "i smell like butter" - * randomly generated text from a file, for example "i have three feet" - * - */ -p5.prototype.loadTable = function (path) { - var callback = null; - var errorCallback = null; - var options = []; - var header = false; - var sep = ','; - var separatorSet = false; - var decrementPreload = p5._getDecrementPreload.apply(this, arguments); - - for (var i = 1; i < arguments.length; i++) { - if ((typeof (arguments[i]) === 'function') && - (arguments[i] !== decrementPreload)) { - if(!callback){ - callback = arguments[i]; - }else{ - errorCallback = arguments[i]; - } - } else if (typeof (arguments[i]) === 'string') { - options.push(arguments[i]); - if (arguments[i] === 'header') { - header = true; - } - if (arguments[i] === 'csv') { - if (separatorSet) { - throw new Error('Cannot set multiple separator types.'); - } else { - sep = ','; - separatorSet = true; - } - } else if (arguments[i] === 'tsv') { - if (separatorSet) { - throw new Error('Cannot set multiple separator types.'); - } else { - sep = '\t'; - separatorSet = true; - } - } - } - } - - var t = new p5.Table(); - - p5.prototype.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 = ''; - }; - - var tokenEnd = function () { - currentRecord.push(state.token); - tokenBegin(); - }; - - var recordBegin = function () { - state.escaped = false; - currentRecord = []; - tokenBegin(); - }; - - var recordEnd = function () { - state.currentState = POST_RECORD; - records.push(currentRecord); - currentRecord = null; - }; - - while (true) { - currentChar = resp[offset++]; - - // EOF - if (currentChar == null) { - if (state.escaped) { - throw new Error('Unclosed quote in file.'); - } - if (currentRecord) { - tokenEnd(); - recordEnd(); - break; - } - } - if (currentRecord === null) { - recordBegin(); - } - - // Handle opening quote - if (state.currentState === PRE_TOKEN) { - if (currentChar === QUOTE) { - state.escaped = true; - 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++; - } else { - state.escaped = false; - state.currentState = POST_TOKEN; - } - } else { - state.token += currentChar; - } - continue; - } - - // 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; - } - } - - // 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 (i === records.length - 1 && records[i].length === 1) { - if (records[i][0] === 'undefined') { - break; - } - } - row = new p5.TableRow(); - row.arr = records[i]; - row.obj = makeObject(records[i], t.columns); - t.addRow(row); - } - if (callback !== null) { - callback(t); - } - if (decrementPreload && (callback !== decrementPreload)) { - decrementPreload(); - } - - }, function(err){ - // Error handling - p5._friendlyFileLoadError(2, path); - - if(errorCallback){ - errorCallback(err.status + ' ' + err.statusText); - }else{ - console.log(err.status + ' ' + err.statusText); - } - }); - - return t; -}; - -// helper function to turn a row into a JSON object -function makeObject(row, headers) { - var ret = {}; - headers = headers || []; - if (typeof (headers) === 'undefined') { - for (var j = 0; j < row.length; j++) { - headers[j.toString()] = j; - } - } - for (var i = 0; i < headers.length; i++) { - var key = headers[i]; - var val = row[i]; - ret[key] = val; - } - return ret; -} - -/*global parseXML */ -p5.prototype.parseXML = function (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]); - one.addChild(node); - } - one.setName(two.nodeName); - one._setCont(two.textContent); - one._setAttributes(two); - for (var j = 0; j < one.children.length; j++) { - one.children[j].parent = one; - } - return one; - } - 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. - * If the name of the file is used as the parameter, as in the above example, - * the file must be located in the sketch directory/folder. - * - * Alternatively, the file maybe be loaded from anywhere on the local - * computer using an absolute path (something that starts with / on Unix and - * Linux, or a drive letter on Windows), or the filename parameter can be a - * 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. - * - *

Outside of preload(), you may supply a callback function to handle the - * object:

- * - * @method loadXML - * @param {String} filename name of the file or URL to load - * @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 - * there is an error, response is passed - * in as first argument - * @return {Object} XML object containing data - */ -p5.prototype.loadXML = function (path, callback, errorCallback) { - var ret = {}; - var decrementPreload = p5._getDecrementPreload.apply(this, arguments); - - p5.prototype.httpDo(path, 'GET', 'xml', function(xml){ - for(var key in xml) { - ret[key] = xml[key]; - } - if (typeof callback !== 'undefined') { - callback(ret); - } - if (decrementPreload && (callback !== decrementPreload)) { - decrementPreload(); - } - }, errorCallback); - - return ret; -}; - -// name clash with window.open -// p5.prototype.open = function() { -// // TODO - -// }; - -p5.prototype.selectFolder = function () { - // TODO - throw 'not yet implemented'; - -}; - -p5.prototype.selectInput = function () { - // TODO - throw 'not yet implemented'; - -}; - -/** - * 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'). - * - * @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 {Function} [callback] function to be executed after - * 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 - */ -p5.prototype.httpGet = function () { - var args = new Array(arguments.length); - args[0] = arguments[0]; - args[1] = 'GET'; - for (var i = 2; i < args.length; ++i) { - args[i] = arguments[i]; - } - p5.prototype.httpDo.apply(this, args); -}; - -/** - * Method for executing an HTTP POST 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, 'POST'). - * - * @method httpPost - * @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 {Function} [callback] function to be executed after - * 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 - */ -p5.prototype.httpPost = function () { - var args = new Array(arguments.length); - args[0] = arguments[0]; - args[1] = 'POST'; - for (var i = 2; i < args.length; ++i) { - args[i] = arguments[i]; - } - p5.prototype.httpDo.apply(this, args); -}; - -/** - * Method for executing an HTTP request. If data type is not specified, - * p5 will try to guess based on the URL, defaulting to text.

- * 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. - * - * @method httpDo - * @param {String} path name of the file or url to load - * @param {String} [method] either "GET", "POST", or "PUT", - * defaults to "GET" - * @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 - * as first argument - * @param {Function} [errorCallback] function to be executed if - * there is an error, response is passed - * in as first argument - */ - -/** - * @method httpDo - * @param {String} path - * @param {Object} options Request object options as documented in the - * "fetch" API - * reference - * @param {Function} [callback] - * @param {Function} [errorCallback] - */ -p5.prototype.httpDo = function () { - var type = ''; - var callback; - var errorCallback; - var request; - var jsonpOptions = {}; - var cbCount = 0; - // 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'){ - cbCount++; - }else{ - break; - } - } - // The number of arguments minus callbacks - var argsCount = arguments.length - cbCount; - if(argsCount === 2 && - typeof arguments[0] === 'string' && - typeof arguments[1] === 'object'){ - // Intended for more advanced use, pass in Request parameters directly - request = new Request(arguments[0], 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; - - for (var j = 1; j < arguments.length; j++) { - var a = arguments[j]; - 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') { - type = a; - } else { - data = a; - } - } else if (typeof a === 'object') { - if(a.hasOwnProperty('jsonpCallback')){ - for (var attr in a) { - jsonpOptions[attr] = a[attr]; - } - }else{ - data = JSON.stringify(a); - } - } else if (typeof a === 'function') { - if (!callback) { - callback = a; - } else { - errorCallback = a; - } - } - } - // 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, - mode: 'cors', - body: data - }); - } - - 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 { - console.log(err.status + ' ' + err.statusText); - } - }); - }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 { - console.log(err.status + ' ' + err.statusText); - } - }); - } -}; - -/** - * @module IO - * @submodule Output - * @for p5 - */ - -window.URL = window.URL || window.webkitURL; - -// private array of p5.PrintWriter objects -p5.prototype._pWriters = []; - -p5.prototype.beginRaw = function () { - // TODO - throw 'not yet implemented'; - -}; - -p5.prototype.beginRecord = function () { - // TODO - throw 'not yet implemented'; - -}; - -p5.prototype.createOutput = function () { - // TODO - - throw 'not yet implemented'; -}; - -p5.prototype.createWriter = function (name, extension) { - var newPW; - // check that it doesn't already exist - for (var i in p5.prototype._pWriters) { - if (p5.prototype._pWriters[i].name === name) { - // 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); - p5.prototype._pWriters.push(newPW); - return newPW; - } - } - newPW = new p5.PrintWriter(name, extension); - p5.prototype._pWriters.push(newPW); - return newPW; -}; - -p5.prototype.endRaw = function () { - // TODO - - throw 'not yet implemented'; -}; - -p5.prototype.endRecord = function () { - // TODO - throw 'not yet implemented'; - -}; - -p5.PrintWriter = function (filename, extension) { - var self = this; - this.name = filename; - this.content = ''; - this.print = function (data) { - this.content += data; - }; - this.print = function (data) { - this.content += data + '\n'; - }; - this.flush = function () { - this.content = ''; - }; - this.close = function () { - // convert String to Array for the writeFile Blob - var arr = []; - arr.push(this.content); - p5.prototype.writeFile(arr, filename, extension); - // remove from _pWriters array and delete self - for (var i in p5.prototype._pWriters) { - if (p5.prototype._pWriters[i].name === this.name) { - // remove from _pWriters array - p5.prototype._pWriters.splice(i, 1); - } - } - self.flush(); - self = {}; - }; -}; - -p5.prototype.saveBytes = function () { - // TODO - throw 'not yet implemented'; - -}; - -// object, filename, options --> saveJSON, saveStrings, saveTable -// 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 - * 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
- *
- * - *

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.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:

- * - * 

- *
- *  save('myCanvas.jpg');           // Saves canvas as an image
- *
- *  var cnv = createCanvas(100, 100);
- *  save(cnv, 'myCanvas.jpg');      // Saves canvas as an image
- *
- *  var gb = createGraphics(100, 100);
- *  save(gb, 'myGraphics.jpg');      // Saves p5.Renderer object as an image
- *
- *  save(myTable, 'myTable.html');  // Saves table as html file
- *  save(myTable, 'myTable.csv',);  // Comma Separated Values
- *  save(myTable, 'myTable.tsv');   // Tab Separated Values
- *
- *  save(myJSON, 'my.json');        // Saves pretty JSON
- *  save(myJSON, 'my.json', true);  // Optimizes JSON filesize
- *
- *  save(img, 'my.png');            // Saves pImage as a png image
- *
- *  save(arrayOfStrings, 'my.txt'); // Saves strings to a text file with line
- *                                  // breaks after each item in the array
- *
- * - * @method save - * @param {Object|String} [objectOrFilename] If filename is provided, will - * save canvas as an image with - * either png or jpg extension - * depending on the filename. - * If object is provided, will - * save depending on the object - * and filename (see examples - * above). - * @param {String} [filename] If an object is provided as the first - * parameter, then the second parameter - * indicates the filename, - * and should include an appropriate - * file extension (see examples above). - * @param {Boolean|String} [options] Additional options depend on - * filetype. For example, when saving JSON, - * true indicates that the - * output will be optimized for filesize, - * rather than readability. - */ -p5.prototype.save = function (object, _filename, _options) { - // parse the arguments and figure out which things we are saving - var args = arguments; - // ================================================= - // OPTION 1: saveCanvas... - - // if no arguments are provided, save canvas - var cnv = this._curElement.elt; - if (args.length === 0) { - p5.prototype.saveCanvas(cnv); - return; - } - // otherwise, parse the arguments - - // if first param is a p5Graphics, then saveCanvas - else if (args[0] instanceof p5.Renderer || - args[0] instanceof p5.Graphics) { - 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') { - p5.prototype.saveCanvas(cnv, args[0]); - } - - // ================================================= - // OPTION 2: extension clarifies saveStrings vs. saveJSON - else { - var extension = _checkFileExtension(args[1], args[2])[1]; - switch (extension) { - case 'json': - p5.prototype.saveJSON(args[0], args[1], args[2]); - return; - case 'txt': - p5.prototype.saveStrings(args[0], args[1], args[2]); - return; - // ================================================= - // 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]); - } else if (args[0] instanceof p5.Image) { - p5.prototype.saveCanvas(args[0].canvas, args[1]); - } else if (args[0] instanceof p5.SoundFile) { - p5.prototype.saveSound(args[0], args[1], args[2], args[3]); - } - } - } -}; - -/** - * Writes the contents of an Array or a JSON object to a .json file. - * The file saving process and location of the saved file will - * vary between web browsers. - * - * @method saveJSON - * @param {Array|Object} json - * @param {String} filename - * @param {Boolean} [optimize] If true, removes line breaks - * and spaces from the output - * file to optimize filesize - * (but not readability). - * @example - *
- * var json; - * - * function setup() { - * - * json = {}; // new JSON Object - * - * json.id = 0; - * json.species = 'Panthera leo'; - * json.name = 'Lion'; - * - * // To save, un-comment the line below, then click 'run' - * // saveJSON(json, 'lion.json'); - * } - * - * // 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) { - var stringify; - if (opt) { - stringify = JSON.stringify(json); - } else { - stringify = JSON.stringify(json, undefined, 2); - } - // console.log(stringify); - this.saveStrings(stringify.split('\n'), filename, 'json'); -}; - -p5.prototype.saveJSONObject = p5.prototype.saveJSON; -p5.prototype.saveJSONArray = p5.prototype.saveJSON; - -p5.prototype.saveStream = function () { - // TODO - throw 'not yet implemented'; - -}; - -/** - * 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} filename filename for output - * @example - *
- * var words = 'apple bear cat dog'; - * - * // .split() outputs an Array - * var list = split(words, ' '); - * - * // To save the file, un-comment next line and click 'run' - * // saveStrings(list, 'nouns.txt'); - * - * // Saves the following to a file called 'nouns.txt': - * // - * // apple - * // bear - * // cat - * // dog - *
- * - * @alt - * no image displayed - * - */ -p5.prototype.saveStrings = function (list, filename, extension) { - var ext = extension || 'txt'; - var pWriter = this.createWriter(filename, ext); - for (var i = 0; i < list.length; i++) { - if (i < list.length - 1) { - pWriter.print(list[i]); - } else { - pWriter.print(list[i]); - } - } - pWriter.close(); - pWriter.flush(); -}; - -p5.prototype.saveXML = function () { - // TODO - throw 'not yet implemented'; - -}; - -p5.prototype.selectOutput = function () { - // TODO - throw 'not yet implemented'; - -}; - -// ======= -// HELPERS -// ======= - -function escapeHelper(content) { - return content - .replace(/&/g, '&') - .replace(//g, '>') - .replace(/"/g, '"') - .replace(/'/g, '''); -} - -/** - * 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 {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; - * - * function setup() { - * table = new p5.Table(); - * - * 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'); - * - * // 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 - *
- * - * @alt - * no image displayed - * - */ -p5.prototype.saveTable = function (table, filename, options) { - var pWriter = this.createWriter(filename, options); - - var header = table.columns; - - var sep = ','; // default to CSV - if (options === 'tsv') { - sep = '\t'; - } - if (options !== 'html') { - // make header if it has values - if (header[0] !== '0') { - for (var h = 0; h < header.length; h++) { - if (h < header.length - 1) { - pWriter.print(header[h] + sep); - } else { - pWriter.print(header[h]); - } - } - } - - // make rows - for (var i = 0; i < table.rows.length; i++) { - var j; - for (j = 0; j < table.rows[i].arr.length; j++) { - if (j < table.rows[i].arr.length - 1) { - pWriter.print(table.rows[i].arr[j] + sep); - } else if (i < table.rows.length - 1) { - pWriter.print(table.rows[i].arr[j]); - } else { - pWriter.print(table.rows[i].arr[j]); // no line break - } - } - } - } - - // otherwise, make HTML - else { - pWriter.print(''); - pWriter.print(''); - var str = ' '); - - pWriter.print(''); - pWriter.print(' '); - - // make header if it has values - if (header[0] !== '0') { - pWriter.print(' '); - for (var k = 0; k < header.length; k++) { - var e = escapeHelper(header[k]); - pWriter.print(' '); - } - pWriter.print(' '); - } - - // make rows - for (var row = 0; row < table.rows.length; row++) { - pWriter.print(' '); - for (var col = 0; col < table.columns.length; col++) { - var entry = table.rows[row].getString(col); - var htmlEntry = escapeHelper(entry); - pWriter.print(' '); - } - pWriter.print(' '); - } - pWriter.print('
' + e); - pWriter.print('
' + htmlEntry); - pWriter.print('
'); - pWriter.print(''); - pWriter.print(''); - } - // close and flush the pWriter - pWriter.close(); - pWriter.flush(); -}; // 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. - * - * @param {Array} dataToDownload - * @param {String} filename - * @param {[String]} extension - * @private - */ -p5.prototype.writeFile = function (dataToDownload, filename, extension) { - var type = 'application\/octet-stream'; - if (p5.prototype._isSafari()) { - type = 'text\/plain'; - } - var blob = new Blob(dataToDownload, { - 'type': type - }); - var href = window.URL.createObjectURL(blob); - p5.prototype.downloadFile(href, 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. - * - * @param {String} href i.e. an href generated by createObjectURL - * @param {[String]} filename - * @param {[String]} extension - */ -p5.prototype.downloadFile = function (href, fName, extension) { - var fx = _checkFileExtension(fName, extension); - var filename = fx[0]; - var ext = fx[1]; - - var a = document.createElement('a'); - a.href = href; - a.download = filename; - - // Firefox requires the link to be added to the DOM before click() - a.onclick = function(e) { - destroyClickedElement(e); - e.stopPropagation(); - }; - - a.style.display = 'none'; - document.body.appendChild(a); - - // Safari will open this file in the same page as a confusing Blob. - if (p5.prototype._isSafari()) { - 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 + '\"'; - alert(aText); - } - a.click(); - href = null; -}; - -/** - * Returns a file extension, or another string - * if the provided parameter has no extension. - * - * @param {String} filename - * @return {Array} [fileName, fileExtension] - * - * @private - */ -function _checkFileExtension(filename, extension) { - if (!extension || extension === true || extension === 'true') { - extension = ''; - } - if (!filename) { - filename = 'untitled'; - } - var ext = ''; - // make sure the file will have a name, see if filename needs extension - if (filename && filename.indexOf('.') > -1) { - ext = filename.split('.').pop(); - } - // append extension if it doesn't exist - if (extension) { - if (ext !== extension) { - ext = extension; - filename = filename + '.' + ext; - } - } - return [filename, ext]; -} -p5.prototype._checkFileExtension = _checkFileExtension; - -/** - * Returns true if the browser is Safari, false if not. - * Safari makes trouble for downloading files. - * - * @return {Boolean} [description] - * @private - */ -p5.prototype._isSafari = function () { - var x = Object.prototype.toString.call(window.HTMLElement); - return x.indexOf('Constructor') > 0; -}; - -/** - * Helper function, a callback for download that deletes - * an invisible anchor element from the DOM once the file - * has been automatically downloaded. - * - * @private - */ -function destroyClickedElement(event) { - document.body.removeChild(event.target); -} - -module.exports = p5; - -},{"../core/core":42,"../core/error_helpers":45,"es6-promise":2,"fetch-jsonp":3,"opentype.js":10,"whatwg-fetch":32}],65:[function(_dereq_,module,exports){ -/** - * @module IO - * @submodule Table - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - - -/** - * Table Options - *

Generic class for handling tabular data, typically from a - * CSV, TSV, or other sort of spreadsheet file.

- *

CSV files are - * - * comma separated values, often with the data in quotes. TSV - * files use tabs as separators, and usually don't bother with the - * quotes.

- *

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.

- * - * Possible options include: - *
    - *
  • csv - parse the table as comma-separated values - *
  • tsv - parse the table as tab-separated values - *
  • header - this table has a header (title) row - *
- */ - -/** - * 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. - * - * @class p5.Table - * @constructor - * @param {Array} [rows] An array of p5.TableRow objects - * @return {p5.Table} p5.Table generated - */ -p5.Table = function (rows) { - /** - * @property columns - * @type {Array} - */ - this.columns = []; - - /** - * @property rows - * @type {Array} - */ - this.rows = []; -}; - -/** - * 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(). - * - * 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 - * - * @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)); - * } - * - *
- * - * @alt - * no image displayed - * - */ -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') { - //r = new p5.prototype.TableRow(r); - throw 'invalid TableRow: ' + r; - } - r.table = this; - this.rows.push(r); - return r; -}; - -/** - * Removes a row from the table object. - * - * @method removeRow - * @param {Number} 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 - * - */ -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); - this.rows.pop(); - this.rows = this.rows.concat(chunk); -}; - - -/** - * 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 {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 - * - */ -p5.Table.prototype.getRow = function(r) { - return this.rows[r]; -}; - -/** - * Gets all rows from the table. Returns an array of p5.TableRows. - * - * @method getRows - * @return {Array} 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 - * - */ -p5.Table.prototype.getRows = function() { - return this.rows; -}; - -/** - * Finds the first row in the Table that contains the value - * 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 findRow - * @param {String} value The value to match - * @param {Number|String} column ID number or title of the - * column to search - * @return {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")); - * } - * - *
- * - * @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 (this.rows[i].obj[column] === value) { - return this.rows[i]; - } - } - } - // try the Array - else { - for (var j = 0; j < this.rows.length; j++){ - if (this.rows[j].arr[column] === value) { - return this.rows[j]; - } - } - } - // otherwise... - return null; -}; - -/** - * Finds the rows in the Table that contain the value - * 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 above. The column to search may be - * specified by either its ID or title. - * - * @method findRows - * @param {String} value The value to match - * @param {Number|String} column ID number or title of the - * column to search - * @return {Array} 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 - * - */ -p5.Table.prototype.findRows = function(value, column) { - var ret = []; - 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] ); - } - } - } - // try the Array - else { - for (var j = 0; j < this.rows.length; j++){ - if (this.rows[j].arr[column] === value) { - ret.push( this.rows[j] ); - } - } - } - return ret; -}; - -/** - * 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 The regular expression to match - * @param {String|Number} column The column ID (number) or - * title (string) - * @return {TableRow} TableRow object - */ -p5.Table.prototype.matchRow = function(regexp, column) { - if (typeof(column) === 'number') { - for (var j = 0; j < this.rows.length; j++) { - if ( this.rows[j].arr[column].match(regexp) ) { - return this.rows[j]; - } - } - } - - else { - for (var i = 0; i < this.rows.length; i++) { - if ( this.rows[i].obj[column].match(regexp) ) { - return this.rows[i]; - } - } - } - return null; -}; - -/** - * 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 {Array} An Array of TableRow objects - * @example - * var table; - * - * function setup() { - * - * 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'); - * - * newRow = table.addRow(); - * newRow.setString('name', 'Mosquito'); - * newRow.setString('type', 'Insect'); - * - * 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 - */ -p5.Table.prototype.matchRows = function(regexp, column) { - var ret = []; - 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] ); - } - } - } - - else { - for (var i = 0; i < this.rows.length; 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. - * - * @method getColumn - * @param {String|Number} column String or Number of the column to return - * @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 - * - */ -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]); - } - } else { - for (var j = 0; j < this.rows.length; j++){ - ret.push (this.rows[j].arr[value]); - } - } - return ret; -}; - -/** - * Removes all rows from a Table. While all rows are removed, - * columns and column titles are maintained. - * - * @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 - * - */ -p5.Table.prototype.clearRows = function() { - delete this.rows; - this.rows = []; -}; - -/** - * 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.) - * - * @method addColumn - * @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 - * - */ -p5.Table.prototype.addColumn = function(title) { - var t = title || null; - this.columns.push(t); -}; - -/** - * Returns the total number of columns in a Table. - * - * @return {Number} Number of columns in this table - */ -p5.Table.prototype.getColumnCount = function() { - return this.columns.length; -}; - -/** - * Returns the total number of rows in a Table. - * - * @method getRowCount - * @return {Number} Number of rows in this table - - */ -p5.Table.prototype.getRowCount = function() { - return this.rows.length; -}; - -/** - *

Removes any of the specified characters (or "tokens").

- * - *

If no column is specified, then the values in all columns and - * rows are processed. A specific column may be referenced by - * either its ID or title.

- * - * @method removeTokens - * @param {String} chars String listing characters to be removed - * @param {String|Number} [column] Column ID (number) - * or name (string) - */ -p5.Table.prototype.removeTokens = function(chars, column) { - var escape= function(s) { - return s.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&'); - }; - var charArray = []; - for (var i = 0; i < chars.length; i++) { - charArray.push( escape( chars.charAt(i) ) ); - } - var regex = new RegExp(charArray.join('|'), 'g'); - - 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]; - s = s.replace(regex, ''); - this.rows[d].arr[c] = s; - this.rows[d].obj[this.columns[c]] = s; - } - } - } - 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, ''); - this.rows[j].obj[column] = val; - var pos = this.columns.indexOf(column); - this.rows[j].arr[pos] = val; - } - } - else { - for (var k = 0; k < this.rows.length; k++) { - var str = this.rows[k].arr[column]; - str = str.replace(regex, ''); - this.rows[k].arr[column] = str; - this.rows[k].obj[this.columns[column]] = str; - } - } -}; - -/** - * Trims leading and trailing whitespace, such as spaces and tabs, - * from String table values. If no column is specified, then the - * values in all columns and rows are trimmed. A specific column - * may be referenced by either its ID or title. - * - * @method trim - * @param {String|Number} column Column ID (number) - * or name (string) - */ -p5.Table.prototype.trim = function(column) { - var regex = new RegExp( (' '), 'g'); - - 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]; - s = s.replace(regex, ''); - this.rows[d].arr[c] = s; - this.rows[d].obj[this.columns[c]] = s; - } - } - } - 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, ''); - this.rows[j].obj[column] = val; - var pos = this.columns.indexOf(column); - this.rows[j].arr[pos] = val; - } - } - else { - for (var k = 0; k < this.rows.length; k++) { - var str = this.rows[k].arr[column]; - str = str.replace(regex, ''); - this.rows[k].arr[column] = str; - this.rows[k].obj[this.columns[column]] = str; - } - } -}; - -/** - * 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) - * - * @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 - * - */ -p5.Table.prototype.removeColumn = function(c) { - var cString; - var cNumber; - if (typeof(c) === 'string') { - // find the position of c in the columns - cString = c; - cNumber = this.columns.indexOf(c); - console.log('string'); - } - else{ - cNumber = c; - cString = this.columns[c]; - } - - 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++){ - var tempR = this.rows[i].arr; - 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) - * 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 - * - */ -p5.Table.prototype.set = function(row, column, value) { - this.rows[row].set(column, value); -}; - -/** - * Stores a Float 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 setNum - * @param {Number} row row ID - * @param {String|Number} 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 - */ -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) - * or title (String) - * @param {String} value value to assign - */ -p5.Table.prototype.setString = function(row, column, value){ - this.rows[row].setString(column, value); -}; - -/** - * Retrieves a value from 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 get - * @param {Number} row row ID - * @param {String|Number} 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 - * - */ -p5.Table.prototype.get = function(row, column) { - return this.rows[row].get(column); -}; - -/** - * Retrieves a Float value from 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 getNum - * @param {Number} row row ID - * @param {String|Number} 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 - * - */ -p5.Table.prototype.getNum = function(row, column) { - return this.rows[row].getNum(column); -}; - -/** - * Retrieves a String value from 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 getString - * @param {Number} row row ID - * @param {String|Number} 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 - * - */ -p5.Table.prototype.getString = function(row, column) { - return this.rows[row].getString(column); -}; - -/** - * Retrieves all table data and returns as an object. If a column name is - * passed in, each row object will be stored with that attribute as its - * title. - * - * @method getObject - * @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 - * - */ -p5.Table.prototype.getObject = function (headerColumn) { - var tableObject = {}; - var obj, cPos, index; - - for(var i = 0; i < this.rows.length; i++) { - obj = this.rows[i].obj; - - 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 +'"'; - } - } else { - tableObject[i] = this.rows[i].obj; - } - } - return tableObject; -}; - -/** - * Retrieves all table data and returns it as a multidimensional array. - * - * @method getArray - * @return {Array} - */ -p5.Table.prototype.getArray = function () { - var tableArray = []; - for(var i = 0; i < this.rows.length; i++) { - tableArray.push(this.rows[i].arr); - } - return tableArray; -}; - -module.exports = p5.Table; - -},{"../core/core":42}],66:[function(_dereq_,module,exports){ -/** - * @module IO - * @submodule Table - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * A TableRow object represents a single row of data values, - * stored in columns, from a table. - * - * A Table Row contains both an ordered array, and an unordered - * JSON object. - * - * @class p5.TableRow - * @constructor - * @param {String} [str] optional: populate the row with a - * string of values, separated by the - * separator - * @param {String} [separator] comma separated values (csv) by default - */ -p5.TableRow = function (str, separator) { - var arr = []; - var obj = {}; - if (str){ - separator = separator || ','; - arr = str.split(separator); - } - for (var i = 0; i < arr.length; i++){ - var key = i; - var val = arr[i]; - obj[key] = val; - } - this.arr = arr; - this.obj = obj; - this.table = null; -}; - -/** - * Stores a value in the TableRow's specified column. - * The column may be specified by either its ID or title. - * - * @method set - * @param {String|Number} column Column ID (Number) - * or Title (String) - * @param {String|Number} value The value to be stored - */ -p5.TableRow.prototype.set = function(column, value) { - // if typeof column is string, use .obj - 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 'This table has no column named "' + column +'"'; - } - } - - // if typeof column is number, use .arr - else { - 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'; - } - } -}; - - -/** - * 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) - * or Title (String) - * @param {Number} value The value to be stored - * as a Float - */ -p5.TableRow.prototype.setNum = function(column, value){ - var floatVal = parseFloat(value, 10); - 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) - * or Title (String) - * @param {String} value The value to be stored - * as a String - */ -p5.TableRow.prototype.setString = function(column, value){ - var stringVal = value.toString(); - this.set(column, stringVal); -}; - -/** - * Retrieves a value from the TableRow's specified column. - * The column may be specified by either its ID or title. - * - * @method get - * @param {String|Number} column columnName (string) or - * ID (number) - * @return {String|Number} - */ -p5.TableRow.prototype.get = function(column) { - if (typeof(column) === 'string'){ - return this.obj[column]; - } else { - return this.arr[column]; - } -}; - -/** - * Retrieves a Float value from the TableRow's specified - * column. The column may be specified by either its ID or - * title. - * - * @method getNum - * @param {String|Number} column columnName (string) or - * ID (number) - * @return {Number} Float Floating point number - */ -p5.TableRow.prototype.getNum = function(column) { - var ret; - if (typeof(column) === 'string'){ - ret = parseFloat(this.obj[column], 10); - } else { - ret = parseFloat(this.arr[column], 10); - } - - if (ret.toString() === 'NaN') { - throw 'Error: ' + this.obj[column]+ ' is NaN (Not a Number)'; - } - return ret; -}; - -/** - * Retrieves an String value from the TableRow's specified - * column. The column may be specified by either its ID or - * title. - * - * @method getString - * @param {String|Number} column columnName (string) or - * ID (number) - * @return {String} String - */ -p5.TableRow.prototype.getString = function(column) { - if (typeof(column) === 'string'){ - return this.obj[column].toString(); - } else { - return this.arr[column].toString(); - } -}; - -module.exports = p5.TableRow; - -},{"../core/core":42}],67:[function(_dereq_,module,exports){ -/** - * @module IO - * @submodule XML - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * XML is a representation of an XML object, able to parse XML code. Use - * loadXML() to load external XML files and create XML objects. - * - * @class p5.XML - * @constructor - * @return {p5.XML} p5.XML object generated - * @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 children = xml.getChildren("animal"); - * - * for (var i = 0; i < children.length; i++) { - * var id = children[i].getNumber("id"); - * var coloring = children[i].getString("species"); - * var name = children[i].getContent(); - * print(id + ", " + coloring + ", " + name); - * } - * } - * - * // Sketch prints: - * // 0, Capra hircus, Goat - * // 1, Panthera pardus, Leopard - * // 2, Equus zebra, Zebra - *
- * - * @alt - * no image displayed - * - */ -p5.XML = function () { - this.name = null; //done - this.attributes = {}; //done - this.children = []; - this.parent = null; - this.content = null; //done -}; - - -/** - * Gets a copy of the element's parent. Returns the parent as another - * p5.XML object. - * - * @method getParent - * @return {Object} element parent - * @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 children = xml.getChildren("animal"); - * var parent = children[1].getParent(); - * print(parent.getName()); - * } - * - * // Sketch prints: - * // mammals - *
- */ -p5.XML.prototype.getParent = function() { - return this.parent; -}; - -/** - * Gets the element's full name, which is returned as a String. - * - * @method getName - * @return {String} the name of the node - * @example<animal - *
- * // 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() { - * print(xml.getName()); - * } - * - * // Sketch prints: - * // mammals - *
- */ -p5.XML.prototype.getName = function() { - return this.name; -}; - -/** - * Sets the element's name, which is specified as a String. - * - * @method setName - * @param {String} the new name of the node - * @example<animal - *
- * // 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() { - * print(xml.getName()); - * xml.setName("fish"); - * print(xml.getName()); - * } - * - * // Sketch prints: - * // mammals - * // fish - *
- */ -p5.XML.prototype.setName = function(name) { - this.name = name; -}; - -/** - * Checks whether or not the element has any children, and returns the result - * as a boolean. - * - * @method hasChildren - * @return {boolean} - * @example<animal - *
- * // 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() { - * print(xml.hasChildren()); - * } - * - * // Sketch prints: - * // true - *
- */ -p5.XML.prototype.hasChildren = function() { - return this.children.length > 0; -}; - -/** - * 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() - * on each child element individually. - * - * @method listChildren - * @return {Array} names of the children of the element - * @example<animal - *
- * // 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() { - * print(xml.listChildren()); - * } - * - * // Sketch prints: - * // ["animal", "animal", "animal"] - *
- */ -p5.XML.prototype.listChildren = function() { - return this.children.map(function(c) { return c.name; }); -}; - -/** - * 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. - * - * @method getChildren - * @param {String} [name] element name - * @return {Array} children of the element - * @example<animal - *
- * // 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 animals = xml.getChildren("animal"); - * - * for (var i = 0; i < animals.length; i++) { - * print(animals[i].getContent()); - * } - * } - * - * // Sketch prints: - * // "Goat" - * // "Leopard" - * // "Zebra" - *
- */ -p5.XML.prototype.getChildren = function(param) { - if (param) { - return this.children.filter(function(c) { return c.name === param; }); - } - else { - return this.children; - } -}; - -/** - * Returns the first of the element's children that matches the name parameter - * or the child of the given index.It returns undefined if no matching - * child is found. - * - * @method getChild - * @param {String|Number} name element name or index - * @return {p5.XML} - * @example<animal - *
- * // 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 firstChild = xml.getChild("animal"); - * print(firstChild.getContent()); - * } - * - * // Sketch prints: - * // "Goat" - *
- *
- * var xml; - * - * function preload() { - * xml = loadXML("assets/mammals.xml"); - * } - * - * function setup() { - * var secondChild = xml.getChild(1); - * print(secondChild.getContent()); - * } - * - * // Sketch prints: - * // "Leopard" - *
- */ -p5.XML.prototype.getChild = function(param) { - if(typeof param === 'string') { - return this.children.find(function(c) { - return c.name === param; - }); - } - else { - return this.children[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. - * - * @method addChild - * @param {Object} a p5.XML Object which will be the child to be added - */ -p5.XML.prototype.addChild = function(node) { - if (node instanceof p5.XML) { - this.children.push(node); - } else { - // PEND - } -}; - -/** - * Removes the element specified by name or index. - * - * @method removeChild - * @param {String|Number} name element name or index - * @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() { - * xml.removeChild("animal"); - * var children = xml.getChildren(); - * for (var i=0; i
- *
- * var xml; - * - * function preload() { - * xml = loadXML("assets/mammals.xml"); - * } - * - * function setup() { - * xml.removeChild(1); - * var children = xml.getChildren(); - * for (var i=0; i
- */ -p5.XML.prototype.removeChild = function(param) { - var ind = -1; - if(typeof param === 'string') { - for (var i=0; i - * // 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 firstChild = xml.getChild("animal"); - * print(firstChild.getAttributeCount()); - * } - * - * // Sketch prints: - * // 2 - * - */ -p5.XML.prototype.getAttributeCount = function() { - return Object.keys(this.attributes).length; -}; - -/** - * Gets all of the specified element's attributes, and returns them as an - * array of Strings. - * - * @method listAttributes - * @return {Array} an array of strings containing the names of attributes - * @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 firstChild = xml.getChild("animal"); - * print(firstChild.listAttributes()); - * } - * - * // Sketch prints: - * // ["id", "species"] - *
- */ -p5.XML.prototype.listAttributes = function() { - return Object.keys(this.attributes); -}; - -/** - * Checks whether or not an element has the specified attribute. - * - * @method hasAttribute - * @param {String} the attribute to be checked - * @return {boolean} true if attribute found else false - * @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 firstChild = xml.getChild("animal"); - * print(firstChild.hasAttribute("species")); - * print(firstChild.hasAttribute("color")); - * } - * - * // Sketch prints: - * // true - * // false - *
- */ -p5.XML.prototype.hasAttribute = function(name) { - return this.attributes[name] ? true : false; -}; - -/** - * Returns an attribute value of the element as an Number. If the defaultValue - * parameter is specified and the attribute doesn't exist, then defaultValue - * is returned. If no defaultValue is specified and the attribute doesn't - * exist, the value 0 is returned. - * - * @method getNumber - * @param {String} name the non-null full name of the attribute - * @param {Number} [defaultValue] the default value of the attribute - * @return {Number} - * @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 firstChild = xml.getChild("animal"); - * print(firstChild.getNumber("id")); - * } - * - * // Sketch prints: - * // 0 - *
- */ -p5.XML.prototype.getNumber = function(name, defaultValue) { - return Number(this.attributes[name]) || defaultValue || 0; -}; - -/** - * Returns an attribute value of the element as an String. If the defaultValue - * parameter is specified and the attribute doesn't exist, then defaultValue - * is returned. If no defaultValue is specified and the attribute doesn't - * exist, null is returned. - * - * @method getString - * @param {String} name the non-null full name of the attribute - * @param {Number} [defaultValue] the default value of the attribute - * @return {Number} - * @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 firstChild = xml.getChild("animal"); - * print(firstChild.getString("species")); - * } - * - * // Sketch prints: - * // "Capra hircus" - *
- */ -p5.XML.prototype.getString = function(name, defaultValue) { - return String(this.attributes[name]) || defaultValue || null; -}; - -/** - * Sets the content of an element's attribute. The first parameter specifies - * the attribute name, while the second specifies the new content. - * - * @method setAttribute - * @param {String} name the full name of the attribute - * @param {Number} value the value of the attribute - * @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 firstChild = xml.getChild("animal"); - * print(firstChild.getString("species")); - * firstChild.setAttribute("species", "Jamides zebra"); - * print(firstChild.getString("species")); - * } - * - * // Sketch prints: - * // "Capra hircus" - * // "Jamides zebra" - *
- */ -p5.XML.prototype.setAttribute = function(name, value) { - if (this.attributes[name]) { - this.attributes[name] = value; - } -}; - -/** - * Returns the content of an element. If there is no such content, - * defaultValue is returned if specified, otherwise null is returned. - * - * @method getContent - * @param {String} [defaultValue] value returned if no content is found - * @return {String} - * @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 firstChild = xml.getChild("animal"); - * print(firstChild.getContent()); - * } - * - * // Sketch prints: - * // "Goat" - *
- */ -p5.XML.prototype.getContent = function(defaultValue) { - return this.content || defaultValue || null; -}; - -/** - * Sets the element's content. - * - * @method setContent - * @param {String} text the new content - * @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 firstChild = xml.getChild("animal"); - * print(firstChild.getContent()); - * firstChild.setContent("Mountain Goat"); - * print(firstChild.getContent()); - * } - * - * // Sketch prints: - * // "Goat" - * // "Mountain Goat" - *
- */ -p5.XML.prototype.setContent = function( content ) { - if(!this.children.length) { - this.content = content; - } -}; - -/* HELPERS */ -/** - * This method is called while the parsing of XML (when loadXML() is - * called). The difference between this method and the setContent() - * method defined later is that this one is used to set the content - * when the node in question has more nodes under it and so on and - * not directly text content. While in the other one is used when - * the node in question directly has text inside it. - * - */ -p5.XML.prototype._setCont = function(content) { - var str; - str = content; - str = str.replace(/\s\s+/g, ','); - //str = str.split(','); - this.content = str; -}; - -/** - * 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.prototype._setAttributes = function(node) { - var i, att = {}; - for( i = 0; i < node.attributes.length; i++) { - att[node.attributes[i].nodeName] = node.attributes[i].nodeValue; - } - this.attributes = att; -}; - -module.exports = p5.XML; -},{"../core/core":42}],68:[function(_dereq_,module,exports){ -/** - * @module Math - * @submodule Calculation - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * Calculates the absolute value (magnitude) of a number. Maps to Math.abs(). - * The absolute value of a number is always positive. - * - * @method abs - * @param {Number} n number to compute - * @return {Number} absolute value of given number - * @example - *
- * function setup() { - * var x = -3; - * var y = abs(x); - * - * print(x); // -3 - * print(y); // 3 - * } - *
- * - * @alt - * no image displayed - * - */ -p5.prototype.abs = Math.abs; - -/** - * Calculates the closest int value that is greater than or equal to the - * value of the parameter. Maps to Math.ceil(). For example, ceil(9.03) - * returns the value 10. - * - * @method ceil - * @param {Number} n number to round up - * @return {Number} rounded up number - * @example - *
- * function draw() { - * background(200); - * // map, mouseX between 0 and 5. - * var ax = map(mouseX, 0, 100, 0, 5); - * var ay = 66; - * - * //Get the ceiling of the mapped number. - * var bx = ceil(map(mouseX, 0, 100, 0,5)); - * var by = 33; - * - * // Multiply the mapped numbers by 20 to more easily - * // see the changes. - * stroke(0); - * fill(0); - * line(0, ay, ax * 20, ay); - * line(0, by, bx * 20, by); - * - * // 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); - * } - *
- * - * @alt - * 2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals - * - */ -p5.prototype.ceil = Math.ceil; - -/** - * Constrains a value between a minimum and maximum value. - * - * @method constrain - * @param {Number} n number to constrain - * @param {Number} low minimum limit - * @param {Number} high maximum limit - * @return {Number} constrained number - * @example - *
- * function draw() { - * background(200); - * - * var leftWall = 25; - * var rightWall = 75; - * - * // xm is just the mouseX, while - * // xc is the mouseX, but constrained - * // between the leftWall and rightWall! - * var xm = mouseX; - * var xc = constrain(mouseX, leftWall, rightWall); - * - * // Draw the walls. - * stroke(150); - * line(leftWall, 0, leftWall, height); - * line(rightWall, 0, rightWall, height); - * - * // Draw xm and xc as circles. - * noStroke(); - * fill(150); - * ellipse(xm, 33, 9,9); // Not Constrained - * fill(0); - * ellipse(xc, 66, 9,9); // Constrained - * } - *
- * - * @alt - * 2 vertical lines. 2 ellipses move with mouse X 1 does not move passed lines - * - */ -p5.prototype.constrain = function(n, low, high) { - return Math.max(Math.min(n, high), low); -}; - -/** - * Calculates the distance between two points. - * - * @method dist - * @param {Number} x1 x-coordinate of the first point - * @param {Number} y1 y-coordinate of the first point - * @param {Number} [z1] z-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} [z2] z-coordinate of the second point - * @return {Number} distance between the two points - * @example - *
- * // Move your mouse inside the canvas to see the - * // change in distance between two points! - * function draw() { - * background(200); - * fill(0); - * - * var x1 = 10; - * var y1 = 90; - * var x2 = mouseX; - * var y2 = mouseY; - * - * line(x1, y1, x2, y2); - * ellipse(x1, y1, 7, 7); - * ellipse(x2, y2, 7, 7); - * - * // d is the length of the line - * // the distance from point 1 to point 2. - * var d = int(dist(x1, y1, x2, y2)); - * - * // 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); - * pop(); - * // Fancy! - * } - *
- * - * @alt - * 2 ellipses joined by line. 1 ellipse moves with mouse X&Y. Distance displayed. - * - */ -p5.prototype.dist = function(x1, y1, z1, x2, y2, z2) { - if (arguments.length === 4) { - // In the case of 2d: z1 means x2 and x2 means y2 - return hypot(z1-x1, x2-y1); - } else if (arguments.length === 6) { - return hypot(x2-x1, y2-y1, z2-z1); - } -}; - -/** - * Returns Euler's number e (2.71828...) raised to the power of the n - * parameter. Maps to Math.exp(). - * - * @method exp - * @param {Number} n exponent to raise - * @return {Number} e^n - * @example - *
- * function draw() { - * background(200); - * - * // Compute the exp() function with a value between 0 and 2 - * var xValue = map(mouseX, 0, width, 0, 2); - * var yValue = exp(xValue); - * - * var y = map(yValue, 0, 8, height, 0); - * - * 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); - * - * // Draw the exp(x) curve, - * // over the domain of x from 0 to 2 - * noFill(); - * stroke(0); - * beginShape(); - * for (var x = 0; x < width; x++) { - * xValue = map(x, 0, width, 0, 2); - * yValue = exp(xValue); - * y = map(yValue, 0, 8, height, 0); - * vertex(x, y); - * } - * - * endShape(); - * line(0, 0, 0, height); - * line(0, height-1, width, height-1); - * } - *
- * - * @alt - * ellipse moves along a curve with mouse x. e^n displayed. - * - */ -p5.prototype.exp = Math.exp; - -/** - * Calculates the closest int value that is less than or equal to the - * value of the parameter. Maps to Math.floor(). - * - * @method floor - * @param {Number} n number to round down - * @return {Number} rounded down number - * @example - *
- * function draw() { - * background(200); - * //map, mouseX between 0 and 5. - * var ax = map(mouseX, 0, 100, 0, 5); - * var ay = 66; - * - * //Get the floor of the mapped number. - * var bx = floor(map(mouseX, 0, 100, 0,5)); - * var by = 33; - * - * // Multiply the mapped numbers by 20 to more easily - * // see the changes. - * stroke(0); - * fill(0); - * line(0, ay, ax * 20, ay); - * line(0, by, bx * 20, by); - * - * // 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); - * } - *
- * - * @alt - * 2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals - * - */ -p5.prototype.floor = Math.floor; - -/** - * Calculates a number between two numbers at a specific increment. The amt - * parameter is the amount to interpolate between the two values where 0.0 - * equal to the first point, 0.1 is very near the first point, 0.5 is - * half-way in between, etc. The lerp function is convenient for creating - * motion along a straight path and for drawing dotted lines. - * - * @method lerp - * @param {Number} start first value - * @param {Number} stop second value - * @param {Number} amt number between 0.0 and 1.0 - * @return {Number} lerped value - * @example - *
- * function setup() { - * 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 y = 50 - * - * strokeWeight(5); - * stroke(0); // Draw the original points in black - * point(a, y); - * point(b, y); - * - * stroke(100); // Draw the lerp points in gray - * point(c, y); - * point(d, y); - * point(e, y); - * } - *
- * - * @alt - * 5 points horizontally staggered mid-canvas. mid 3 are grey, outer black - * - */ -p5.prototype.lerp = function(start, stop, amt) { - return amt*(stop-start)+start; -}; - -/** - * Calculates the natural logarithm (the base-e logarithm) of a number. This - * function expects the n parameter to be a value greater than 0.0. Maps to - * Math.log(). - * - * @method log - * @param {Number} n number greater than 0 - * @return {Number} natural logarithm of n - * @example - *
- * function draw() { - * background(200); - * var maxX = 2.8; - * var maxY = 1.5; - * - * // 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. - * 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); - * stroke(150); - * line(mouseX, y, mouseX, height); - * fill(0); - * text (legend, 5, 15); - * noStroke(); - * ellipse (mouseX, y, 7, 7); - * } - * - * // Draw the log(x) curve, - * // over the domain of x from 0 to maxX - * noFill(); - * stroke(0); - * beginShape(); - * 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); - * } - *
- * - * @alt - * ellipse moves along a curve with mouse x. natural logarithm of n displayed. - * - */ -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 - * a shortcut for writing dist(0, 0, x, y). - * - * @method mag - * @param {Number} a first value - * @param {Number} b second value - * @return {Number} magnitude of vector from (0,0) to (a,b) - * @example - *
- * function setup() { - * var x1 = 20; - * var x2 = 80; - * var y1 = 30; - * var y2 = 70; - * - * line(0, 0, x1, y1); - * print(mag(x1, y1)); // Prints "36.05551275463989" - * line(0, 0, x2, y1); - * print(mag(x2, y1)); // Prints "85.44003745317531" - * line(0, 0, x1, y2); - * print(mag(x1, y2)); // Prints "72.80109889280519" - * line(0, 0, x2, y2); - * print(mag(x2, y2)); // Prints "106.3014581273465" - * } - *
- * - * @alt - * 4 lines of different length radiate from top left of canvas. - * - */ -p5.prototype.mag = function(x, y) { - return hypot(x, y); -}; - -/** - * Re-maps a number from one range to another. - *

- * In the first example above, the number 25 is converted from a value in the - * range of 0 to 100 into a value that ranges from the left edge of the - * window (0) to the right edge (width). - * - * @method map - * @param {Number} value the incoming value to be converted - * @param {Number} start1 lower bound of the value's current range - * @param {Number} stop1 upper bound of the value's current range - * @param {Number} start2 lower bound of the value's target range - * @param {Number} stop2 upper bound of the value's target range - * @return {Number} remapped number - * @example - *
- * var value = 25; - * var m = map(value, 0, 100, 0, width); - * ellipse(m, 50, 10, 10); - *
- * - *
- * function setup() { - * noStroke(); - * } - * - * function draw() { - * background(204); - * var x1 = map(mouseX, 0, width, 25, 75); - * ellipse(x1, 25, 25, 25); - * var x2 = map(mouseX, 0, width, 0, 100); - * 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) { - return ((n-start1)/(stop1-start1))*(stop2-start2)+start2; -}; - -/** - * Determines the largest value in a sequence of numbers, and then returns - * 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 - * @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); - * fill(0); - * noStroke(); - * 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++) { - * text(numArray[i], i * spacing, elemsY); - * } - * maxX = 33; - * maxY = 80; - * // Draw the Maximum value in the array. - * textSize(32); - * text(max(numArray), maxX, maxY); - * } - *
- * - * @alt - * Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 9 - * - */ -p5.prototype.max = function() { - if (arguments[0] instanceof Array) { - return Math.max.apply(null,arguments[0]); - } else { - 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 - * of any length. - * - * @method min - * @param {Number|Array} n0 Numbers 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); - * fill(0); - * noStroke(); - * 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++) { - * text(numArray[i], i * spacing, elemsY); - * } - * maxX = 33; - * maxY = 80; - * // Draw the Minimum value in the array. - * textSize(32); - * text(min(numArray), maxX, maxY); - * } - *
- * - * @alt - * Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 1 - * - */ -p5.prototype.min = function() { - if (arguments[0] instanceof Array) { - return Math.min.apply(null,arguments[0]); - } else { - return Math.min.apply(null,arguments); - } -}; - -/** - * Normalizes a number from another range into a value between 0 and 1. - * Identical to map(value, low, high, 0, 1). - * Numbers outside of the range are not clamped to 0 and 1, because - * out-of-range values are often intentional and useful. (See the second - * example above.) - * - * @method norm - * @param {Number} value incoming value to be normalized - * @param {Number} start lower bound of the value's current range - * @param {Number} stop upper bound of the value's current range - * @return {Number} normalized number - * @example - *
- * function draw() { - * background(200); - * currentNum = mouseX; - * lowerBound = 0; - * upperBound = width; //100; - * normalized = norm(currentNum, lowerBound, upperBound); - * lineY = 70 - * line(0, lineY, width, lineY); - * //Draw an ellipse mapped to the non-normalized value. - * noStroke(); - * fill(50) - * var s = 7; // ellipse size - * ellipse(currentNum, lineY, s, s); - * - * // Draw the guide - * guideY = lineY + 15; - * text("0", 0, guideY); - * textAlign(RIGHT); - * text("100", width, guideY); - * - * // Draw the normalized value - * textAlign(LEFT); - * fill(0); - * textSize(32); - * normalY = 40; - * normalX = 20; - * text(normalized, normalX, normalY); - * } - *
- * - * @alt - * ellipse moves with mouse. 0 shown left & 100 right and updating values center - * - */ -p5.prototype.norm = function(n, start, stop) { - return this.map(n, start, stop, 0, 1); -}; - -/** - * 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 - * Math.pow(). - * - * @method pow - * @param {Number} n base of the exponential expression - * @param {Number} e power by which to raise the base - * @return {Number} n^e - * @example - *
- * function setup() { - * //Exponentially increase the size of an ellipse. - * eSize = 3; // Original Size - * eLoc = 10; // Original Location - * - * ellipse(eLoc, eLoc, eSize, eSize); - * - * ellipse(eLoc*2, eLoc*2, pow(eSize, 2), pow(eSize, 2)); - * - * ellipse(eLoc*4, eLoc*4, pow(eSize, 3), pow(eSize, 3)); - * - * ellipse(eLoc*8, eLoc*8, pow(eSize, 4), pow(eSize, 4)); - * } - *
- * - * @alt - * small to large ellipses radiating from top left of canvas - * - */ -p5.prototype.pow = Math.pow; - -/** - * Calculates the integer closest to the n parameter. For example, - * round(133.8) returns the value 134. Maps to Math.round(). - * - * @method round - * @param {Number} n number to round - * @return {Number} rounded number - * @example - *
- * function draw() { - * background(200); - * //map, mouseX between 0 and 5. - * var ax = map(mouseX, 0, 100, 0, 5); - * var ay = 66; - * - * // Round the mapped number. - * var bx = round(map(mouseX, 0, 100, 0,5)); - * var by = 33; - * - * // Multiply the mapped numbers by 20 to more easily - * // see the changes. - * stroke(0); - * fill(0); - * line(0, ay, ax * 20, ay); - * line(0, by, bx * 20, by); - * - * // 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); - * } - *
- * - * @alt - * horizontal center line squared values displayed on top and regular on bottom. - * - */ -p5.prototype.round = Math.round; - -/** - * Squares a number (multiplies a number by itself). The result is always a - * positive number, as multiplying two negative numbers always yields a - * positive result. For example, -1 * -1 = 1. - * - * @method sq - * @param {Number} n number to square - * @return {Number} squared number - * @example - *
- * function draw() { - * background(200); - * eSize = 7; - * x1 = map(mouseX, 0, width, 0, 10); - * y1 = 80; - * x2 = sq(x1); - * y2 = 20; - * - * // Draw the non-squared. - * line(0, y1, width, y1); - * ellipse(x1, y1, eSize, eSize); - * - * // Draw the squared. - * line(0, y2, width, y2); - * ellipse(x2, y2, eSize, eSize); - * - * // Draw dividing line. - * 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); - * } - *
- * - * @alt - * horizontal center line squared values displayed on top and regular on bottom. - * - */ -p5.prototype.sq = function(n) { return n*n; }; - -/** - * Calculates the square root of a number. The square root of a number is - * always positive, even though there may be a valid negative root. The - * square root s of number a is such that s*s = a. It is the opposite of - * squaring. Maps to Math.sqrt(). - * - * @method sqrt - * @param {Number} n non-negative number to square root - * @return {Number} square root of number - * @example - *
- * function draw() { - * background(200); - * eSize = 7; - * x1 = mouseX; - * y1 = 80; - * x2 = sqrt(x1); - * y2 = 20; - * - * // Draw the non-squared. - * line(0, y1, width, y1); - * ellipse(x1, y1, eSize, eSize); - * - * // Draw the squared. - * line(0, y2, width, y2); - * ellipse(x2, y2, eSize, eSize); - * - * // Draw dividing line. - * 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); - * } - *
- * - * @alt - * horizontal center line squareroot values displayed on top and regular on bottom. - * - */ -p5.prototype.sqrt = Math.sqrt; - -// Calculate the length of the hypotenuse of a right triangle -// This won't under- or overflow in intermediate steps -// https://en.wikipedia.org/wiki/Hypot -function hypot(x, y, z) { - // Use the native implementation if it's available - if (typeof Math.hypot === 'function') { - return Math.hypot.apply(null, arguments); - } - - // Otherwise use the V8 implementation - // https://github.com/v8/v8/blob/8cd3cf297287e581a49e487067f5cbd991b27123/src/js/math.js#L217 - var length = arguments.length; - var args = []; - var max = 0; - for (var i = 0; i < length; i++) { - var n = arguments[i]; - n = +n; - if (n === Infinity || n === -Infinity) { - return Infinity; - } - n = Math.abs(n); - if (n > max) { - max = n; - } - args[i] = n; - } - - if (max === 0) { - max = 1; - } - var sum = 0; - var compensation = 0; - for (var j = 0; j < length; j++) { - var m = args[j] / max; - var summand = m * m - compensation; - var preliminary = sum + summand; - compensation = (preliminary - sum) - summand; - sum = preliminary; - } - return Math.sqrt(sum) * max; -} - -module.exports = p5; - -},{"../core/core":42}],69:[function(_dereq_,module,exports){ -/** - * @module Math - * @submodule Math - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - - -/** - * 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. - * - * @method createVector - * @param {Number} [x] x component of the vector - * @param {Number} [y] y component of the vector - * @param {Number} [z] z component of the vector - */ -p5.prototype.createVector = function (x, y, z) { - if (this instanceof p5) { - return new p5.Vector(this, arguments); - } else { - return new p5.Vector(x, y, z); - } -}; - -module.exports = p5; - -},{"../core/core":42}],70:[function(_dereq_,module,exports){ -////////////////////////////////////////////////////////////// - -// http://mrl.nyu.edu/~perlin/noise/ -// Adapting from PApplet.java -// which was adapted from toxi -// which was adapted from the german demo group farbrausch -// as used in their demo "art": http://www.farb-rausch.de/fr010src.zip - -// someday we might consider using "improved noise" -// http://mrl.nyu.edu/~perlin/paper445.pdf -// See: https://github.com/shiffman/The-Nature-of-Code-Examples-p5.js/ -// blob/master/introduction/Noise1D/noise.js - -/** - * @module Math - * @submodule Noise - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -var PERLIN_YWRAPB = 4; -var PERLIN_YWRAP = 1<random() function. - * It was invented by Ken Perlin in the 1980s and been used since in - * graphical applications to produce procedural textures, natural motion, - * shapes, terrains etc.

The main difference to the - * random() function is that Perlin noise is defined in an infinite - * n-dimensional space where each pair of coordinates corresponds to a - * fixed semi-random value (fixed only for the lifespan of the program; see - * 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 - * and 3rd dimension can also be interpreted as time.

The actual - * noise is structured similar to an audio signal, in respect to the - * function's use of frequencies. Similar to the concept of harmonics in - * physics, perlin noise is computed over several octaves which are added - * together for the final result.

Another way to adjust the - * character of the resulting sequence is the scale of the input - * coordinates. As the function works within an infinite space the value of - * the coordinates doesn't matter as such, only the distance between - * successive coordinates does (eg. when using noise() within a - * loop). As a general rule the smaller the difference between coordinates, - * the smoother the resulting noise sequence will be. Steps of 0.005-0.03 - * work best for most applications, but this will differ depending on use. - * - * - * @method noise - * @param {Number} x x-coordinate in noise space - * @param {Number} y y-coordinate in noise space - * @param {Number} z z-coordinate in noise space - * @return {Number} Perlin noise value (between 0 and 1) at specified - * coordinates - * @example - *
- * var xoff = 0.0; - * - * function draw() { - * background(204); - * xoff = xoff + .01; - * var n = noise(xoff) * width; - * line(n, 0, n, height); - * } - * - *
- *
- * var noiseScale=0.02; - * - * function draw() { - * background(0); - * for (var x=0; x < width; x++) { - * var noiseVal = noise((mouseX+x)*noiseScale, mouseY*noiseScale); - * stroke(noiseVal*255); - * line(x, mouseY+noiseVal*80, x, height); - * } - * } - * - *
- * - * @alt - * vertical line moves left to right with updating noise values. - * horizontal wave pattern effected by mouse x-position & updating noise values. - * - */ - -p5.prototype.noise = function(x,y,z) { - y = y || 0; - z = z || 0; - - if (perlin == null) { - perlin = new Array(PERLIN_SIZE + 1); - for (var i = 0; i < PERLIN_SIZE + 1; i++) { - perlin[i] = Math.random(); - } - } - - 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 xf = x - xi; - var yf = y - yi; - var zf = z - zi; - var rxf, ryf; - - var r=0; - var ampl=0.5; - - 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--; } - } - return r; -}; - - -/** - * - * Adjusts the character and level of detail produced by the Perlin noise - * function. Similar to harmonics in physics, noise is computed over - * several octaves. Lower octaves contribute more to the output signal and - * as such define the overall intensity of the noise, whereas higher octaves - * create finer grained details in the noise sequence. - *

- * By default, noise is computed over 4 octaves with each octave contributing - * exactly half than its predecessor, starting at 50% strength for the 1st - * octave. This falloff amount can be changed by adding an additional function - * parameter. Eg. a falloff factor of 0.75 means each octave will now have - * 75% impact (25% less) of the previous lower octave. Any value between - * 0.0 and 1.0 is valid, however note that values greater than 0.5 might - * result in greater than 1.0 values returned by noise(). - *

- * By changing these parameters, the signal created by the noise() - * function can be adapted to fit very specific needs and characteristics. - * - * @method noiseDetail - * @param {Number} lod number of octaves to be used by the noise - * @param {Number} falloff falloff factor for each octave - * @example - *
- * - * - * var noiseVal; - * var noiseScale=0.02; - * - * function setup() { - * 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); - * } - * } - * } - * - *
- * - * @alt - * 2 vertical grey smokey patterns affected my mouse x-position and noise. - * - */ -p5.prototype.noiseDetail = function(lod, falloff) { - if (lod>0) { perlin_octaves=lod; } - if (falloff>0) { perlin_amp_falloff=falloff; } -}; - -/** - * Sets the seed value for noise(). By default, noise() - * produces different results each time the program is run. Set the - * value parameter to a constant to return the same pseudo-random - * numbers each time the software is run. - * - * @method noiseSeed - * @param {Number} seed the seed value - * @example - *
- * var xoff = 0.0; - * - * function setup() { - * noiseSeed(99); - * stroke(0, 10); - * } - * - * function draw() { - * xoff = xoff + .01; - * var n = noise(xoff) * width; - * line(n, 0, n, height); - * } - * - *
- * - * @alt - * vertical grey lines drawing in pattern affected by noise. - * - */ -p5.prototype.noiseSeed = function(seed) { - // Linear Congruential Generator - // Variant of a Lehman Generator - var lcg = (function() { - // 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, - // a - 1 should be divisible by m's prime factors - a = 1664525, - // c and m should be co-prime - c = 1013904223, - seed, z; - return { - 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() { - return seed; - }, - rand : function() { - // define the recurrence relationship - z = (a * z + c) % m; - // return a float in [0, 1) - // if z = m then z / m = 0 therefore (z % m) / m < 1 always - return z / m; - } - }; - }()); - - lcg.setSeed(seed); - perlin = new Array(PERLIN_SIZE + 1); - for (var i = 0; i < PERLIN_SIZE + 1; i++) { - perlin[i] = lcg.rand(); - } -}; - -module.exports = p5; - -},{"../core/core":42}],71:[function(_dereq_,module,exports){ -/** - * @module Math - * @submodule Math - * @requires constants - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -var polarGeometry = _dereq_('./polargeometry'); -var constants = _dereq_('../core/constants'); - -/** - * A class to describe 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. 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(). - *

- * 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 - * the object's position changes per time unit, expressed as a vector), and - * acceleration (the rate at which the object's velocity changes per time - * unit, expressed as a vector). - *

- * Since vectors represent groupings of values, we cannot simply use - * traditional addition/multiplication/etc. Instead, we'll need to do some - * "vector" math, which is made easy by the methods inside the 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 - * @example - *
- * - * var v1 = createVector(40, 50); - * var v2 = createVector(40, 50); - * - * ellipse(v1.x, v1.y, 50, 50); - * ellipse(v2.x, v2.y, 50, 50); - * v1.add(v2); - * ellipse(v1.x, v1.y, 50, 50); - * - *
- * - * @alt - * 2 white ellipses. One center-left the other bottom right and off canvas - * - */ -p5.Vector = function() { - var x,y,z; - // This is how it comes in with createVector() - 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() - } else { - x = arguments[0] || 0; - y = arguments[1] || 0; - z = arguments[2] || 0; - } - /** - * The x component of the vector - * @property x - * @type {Number} - */ - this.x = x; - /** - * The y component of the vector - * @property y - * @type {Number} - */ - this.y = y; - /** - * The z component of the vector - * @property z - * @type {Number} - */ - this.z = z; -}; - -/** - * Returns a string representation of a vector v by calling String(v) - * or v.toString(). This method is useful for logging vectors in the - * console. - * @method toString - * @example - *
- * function setup() { - * var v = createVector(20,30); - * print(String(v)); // prints "p5.Vector Object : [20, 30, 0]" - * } - *
- * - */ -p5.Vector.prototype.toString = function p5VectorToString() { - 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. - * @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 - * @example - *
- * - * function setup() { - * 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] - * } - * - *
- */ -p5.Vector.prototype.set = function (x, y, z) { - if (x instanceof p5.Vector) { - this.x = x.x || 0; - this.y = x.y || 0; - this.z = x.z || 0; - return this; - } - if (x instanceof Array) { - this.x = x[0] || 0; - this.y = x[1] || 0; - this.z = x[2] || 0; - return this; - } - this.x = x || 0; - this.y = y || 0; - this.z = z || 0; - return this; -}; - -/** - * Gets a copy of the vector, returns a p5.Vector object. - * - * @method copy - * @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); - * // Prints "true" - * - *
- */ -p5.Vector.prototype.copy = function () { - if (this.p5) { - return new p5.Vector(this.p5,[this.x, this.y, this.z]); - } else { - 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 - * acts directly on the vector. See the examples for more context. - * - * @method add - * @chainable - * @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 - * @return {p5.Vector} the p5.Vector object. - * @example - *
- * - * var v = createVector(1, 2, 3); - * v.add(4,5,6); - * // v's components are set to [5, 7, 9] - * - *
- *
- * - * // Static method - * var v1 = createVector(1, 2, 3); - * var v2 = createVector(2, 3, 4); - * - * var v3 = p5.Vector.add(v1, v2); - * // v3 has components [3, 5, 7] - * - *
- */ -p5.Vector.prototype.add = function (x, y, z) { - if (x instanceof p5.Vector) { - this.x += x.x || 0; - this.y += x.y || 0; - this.z += x.z || 0; - return this; - } - if (x instanceof Array) { - this.x += x[0] || 0; - this.y += x[1] || 0; - this.z += x[2] || 0; - return this; - } - this.x += x || 0; - this.y += y || 0; - this.z += z || 0; - return this; -}; - -/** - * 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 - * other acts directly on the vector. See the examples for more context. - * - * @method sub - * @chainable - * @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 - * @return {p5.Vector} p5.Vector object. - * @example - *
- * - * var v = createVector(4, 5, 6); - * v.sub(1, 1, 1); - * // v's components are set to [3, 4, 5] - * - *
- * - *
- * - * // Static method - * var v1 = createVector(2, 3, 4); - * var v2 = createVector(1, 2, 3); - * - * var v3 = p5.Vector.sub(v1, v2); - * // v3 has components [1, 1, 1] - * - *
- */ -p5.Vector.prototype.sub = function (x, y, z) { - if (x instanceof p5.Vector) { - this.x -= x.x || 0; - this.y -= x.y || 0; - this.z -= x.z || 0; - return this; - } - if (x instanceof Array) { - this.x -= x[0] || 0; - this.y -= x[1] || 0; - this.z -= x[2] || 0; - return this; - } - this.x -= x || 0; - this.y -= y || 0; - this.z -= z || 0; - return this; -}; - -/** - * 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 - * directly. See the examples for more context. - * - * @method mult - * @chainable - * @param {Number} n the number to multiply with the vector - * @return {p5.Vector} a reference to the p5.Vector object (allow chaining) - * @example - *
- * - * var v = createVector(1, 2, 3); - * v.mult(2); - * // v's components are set to [2, 4, 6] - * - *
- * - *
- * - * // Static method - * var v1 = createVector(1, 2, 3); - * var v2 = p5.Vector.mult(v1, 2); - * // v2 has components [2, 4, 6] - * - *
- */ -p5.Vector.prototype.mult = function (n) { - this.x *= n || 0; - this.y *= n || 0; - this.z *= n || 0; - 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. - * See the examples for more context. - * - * @method div - * @chainable - * @param {number} n the number to divide the vector by - * @return {p5.Vector} a reference to the p5.Vector object (allow chaining) - * @example - *
- * - * var v = createVector(6, 4, 2); - * v.div(2); //v's components are set to [3, 2, 1] - * - *
- * - *
- * - * // Static method - * var v1 = createVector(6, 4, 2); - * var v2 = p5.Vector.div(v, 2); - * // v2 has components [3, 2, 1] - * - *
- */ -p5.Vector.prototype.div = function (n) { - this.x /= n; - this.y /= n; - this.z /= n; - return this; -}; - -/** - * Calculates the magnitude (length) of the vector and returns the result as - * a float (this is simply the equation sqrt(x*x + y*y + z*z).) - * - * @method mag - * @return {Number} magnitude of the vector - * @example - *
- * - * var v = createVector(20.0, 30.0, 40.0); - * var m = v.mag(); - * print(m); // Prints "53.85164807134504" - * - *
- */ -p5.Vector.prototype.mag = function () { - return Math.sqrt(this.magSq()); -}; - -/** - * Calculates the squared magnitude of the vector and returns the result - * as a float (this is simply the equation (x*x + y*y + z*z).) - * Faster if the real length is not required in the - * case of comparing vectors, etc. - * - * @method magSq - * @return {number} squared magnitude of the vector - * @example - *
- * - * // Static method - * var v1 = createVector(6, 4, 2); - * print(v1.magSq()); // Prints "56" - * - *
- */ -p5.Vector.prototype.magSq = function () { - var x = this.x, y = this.y, z = this.z; - return (x * x + y * y + z * z); -}; - -/** - * Calculates the dot product of two vectors. The version of the method - * that computes the dot product of two independent vectors is a static - * method. See the examples for more context. - * - * - * @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 - * - * @example - *
- * - * var v1 = createVector(1, 2, 3); - * var v2 = createVector(2, 3, 4); - * - * print(v1.dot(v2)); // Prints "20" - * - *
- * - *
- * - * //Static method - * var v1 = createVector(1, 2, 3); - * var v2 = createVector(3, 2, 1); - * print (p5.Vector.dot(v1, v2)); // Prints "10" - * - *
- */ -p5.Vector.prototype.dot = function (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); -}; - -/** - * 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. - * 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 - * @example - *
- * - * var v1 = createVector(1, 2, 3); - * var v2 = createVector(1, 2, 3); - * - * v1.cross(v2); // v's components are [0, 0, 0] - * - *
- * - *
- * - * // Static method - * var v1 = createVector(1, 0, 0); - * var v2 = createVector(0, 1, 0); - * - * var crossProduct = p5.Vector.cross(v1, v2); - * // crossProduct has components [0, 0, 1] - * - *
- */ -p5.Vector.prototype.cross = function (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]); - } else { - return new p5.Vector(x,y,z); - } -}; - -/** - * Calculates the Euclidean distance between two points (considering a - * point as a vector object). - * - * @method dist - * @param {p5.Vector} v the x, y, and z coordinates of a p5.Vector - * @return {Number} the distance - * @example - *
- * - * var v1 = createVector(1, 0, 0); - * var v2 = createVector(0, 1, 0); - * - * var distance = v1.dist(v2); // distance is 1.4142... - * - *
- *
- * - * // Static method - * var v1 = createVector(1, 0, 0); - * var v2 = createVector(0, 1, 0); - * - * var distance = p5.Vector.dist(v1,v2); - * // distance is 1.4142... - * - *
- */ -p5.Vector.prototype.dist = function (v) { - var d = v.copy().sub(this); - return d.mag(); -}; - -/** - * Normalize the vector to length 1 (make it a unit vector). - * - * @method normalize - * @return {p5.Vector} normalized p5.Vector - * @example - *
- * - * var v = createVector(10, 20, 2); - * // v has components [10.0, 20.0, 2.0] - * v.normalize(); - * // v's components are set to - * // [0.4454354, 0.8908708, 0.089087084] - * - *
- * - */ -p5.Vector.prototype.normalize = function () { - return this.mag() === 0 ? this : this.div(this.mag()); -}; - -/** - * Limit the magnitude of this vector to the value used for the max - * parameter. - * - * @method limit - * @param {Number} max the maximum magnitude for the vector - * @return {p5.Vector} the modified p5.Vector - * @example - *
- * - * var v = createVector(10, 20, 2); - * // v has components [10.0, 20.0, 2.0] - * v.limit(5); - * // v's components are set to - * // [2.2271771, 4.4543543, 0.4454354] - * - *
- */ -p5.Vector.prototype.limit = function (max) { - var mSq = this.magSq(); - if(mSq > max*max) { - this.div(Math.sqrt(mSq)); //normalize it - this.mult(max); - } - return this; -}; - -/** - * Set the magnitude of this vector to the value used for the len - * parameter. - * - * @method setMag - * @param {number} len the new length for this vector - * @return {p5.Vector} the modified p5.Vector - * @example - *
- * - * var v = createVector(10, 20, 2); - * // v has components [10.0, 20.0, 2.0] - * v.setMag(10); - * // v's components are set to [6.0, 8.0, 0.0] - * - *
- */ -p5.Vector.prototype.setMag = function (n) { - return this.normalize().mult(n); -}; - -/** - * Calculate the angle of rotation for this vector (only 2D vectors) - * - * @method heading - * @return {Number} the angle of rotation - * @example - *
- * function setup() { - * var v1 = createVector(30,50); - * print(v1.heading()); // 1.0303768265243125 - * - * var v1 = createVector(40,50); - * print(v1.heading()); // 0.8960553845713439 - * - * var v1 = createVector(30,70); - * print(v1.heading()); // 1.1659045405098132 - * } - *
- */ -p5.Vector.prototype.heading = function () { - 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; - } -}; - -/** - * Rotate the vector by an angle (only 2D vectors), magnitude remains the - * same - * - * @method rotate - * @param {number} angle the angle of rotation - * @return {p5.Vector} the modified p5.Vector - * @example - *
- * - * var v = createVector(10.0, 20.0); - * // v has components [10.0, 20.0, 0.0] - * v.rotate(HALF_PI); - * // v's components are set to [-20.0, 9.999999, 0.0] - * - *
- */ -p5.Vector.prototype.rotate = function (a) { - var newHeading = this.heading() + a; - if (this.p5) { - if (this.p5._angleMode === constants.DEGREES) { - newHeading = polarGeometry.degreesToRadians(newHeading); - } - } - var mag = this.mag(); - this.x = Math.cos(newHeading) * mag; - this.y = Math.sin(newHeading) * mag; - return this; -}; - -/** - * Linear interpolate the vector to another vector - * - * @method lerp - * @param {p5.Vector} x the x component or the p5.Vector to lerp to - * @param {p5.Vector} [y] y the y component - * @param {p5.Vector} [z] z the z component - * @param {Number} amt the amount of interpolation; some value between 0.0 - * (old vector) and 1.0 (new vector). 0.1 is very near - * the new vector. 0.5 is halfway in between. - * @return {p5.Vector} the modified p5.Vector - * @example - *
- * - * var v = createVector(1, 1, 0); - * - * v.lerp(3, 3, 0, 0.5); // v now has components [2,2,0] - * - *
- * - *
- * - * var v1 = createVector(0, 0, 0); - * var v2 = createVector(100, 100, 0); - * - * var v3 = p5.Vector.lerp(v1, v2, 0.5); - * // v3 has components [50,50,0] - * - *
- */ -p5.Vector.prototype.lerp = function (x, y, z, amt) { - if (x instanceof p5.Vector) { - return this.lerp(x.x, x.y, x.z, y); - } - this.x += (x - this.x) * amt || 0; - this.y += (y - this.y) * amt || 0; - this.z += (z - this.z) * amt || 0; - return this; -}; - -/** - * 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 - * array. - * - * @method array - * @return {Array} an Array with the 3 values - * @example - *
- * function setup() { - * var v = createVector(20,30); - * print(v.array()); // Prints : Array [20, 30, 0] - * } - *
- *
- * - * var v = createVector(10.0, 20.0, 30.0); - * var f = v.array(); - * print(f[0]); // Prints "10.0" - * print(f[1]); // Prints "20.0" - * print(f[2]); // Prints "30.0" - * - *
- */ -p5.Vector.prototype.array = function () { - return [this.x || 0, this.y || 0, this.z || 0]; -}; - -/** - * 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 - * @return {Boolean} whether the vectors are equals - * @example - *
- * v1 = createVector(5,10,20); - * v2 = createVector(5,10,20); - * 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 - *
- *
- * - * 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 - * - *
- */ -p5.Vector.prototype.equals = function (x, y, z) { - var a, b, c; - if (x instanceof p5.Vector) { - a = x.x || 0; - b = x.y || 0; - c = x.z || 0; - } else if (x instanceof Array) { - a = x[0] || 0; - b = x[1] || 0; - c = x[2] || 0; - } else { - a = x || 0; - b = y || 0; - c = z || 0; - } - return this.x === a && this.y === b && this.z === c; -}; - - -// Static Methods - - -/** - * Make a new 2D unit vector from an angle - * - * @method fromAngle - * @static - * @param {Number} angle the desired angle - * @return {p5.Vector} the new p5.Vector object - * @example - *
- * - * function draw() { - * 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); - * - * // 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" - * noStroke(); - * 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 vx = v.x; - * var vy = v.y; - * - * push(); - * translate (width/2, height/2); - * noFill(); - * stroke (150); - * line (0,0, 30,0); - * stroke (0); - * line (0,0, 30*vx, 30*vy); - * pop() - * } - * - *
- */ -p5.Vector.fromAngle = function(angle) { - if (this.p5) { - if (this.p5._angleMode === constants.DEGREES) { - angle = polarGeometry.degreesToRadians(angle); - } - } - 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); - } -}; - -/** - * Make a new 2D unit vector from a random angle - * - * @method random2D - * @static - * @return {p5.Vector} the new p5.Vector object - * @example - *
- * - * var v = p5.Vector.random2D(); - * // May make v's attributes something like: - * // [0.61554617, -0.51195765, 0.0] or - * // [-0.4695841, -0.14366731, 0.0] or - * // [0.6091097, -0.22805278, 0.0] - * - *
- */ -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); -}; - -/** - * Make a new random 3D unit vector. - * - * @method random3D - * @static - * @return {p5.Vector} the new p5.Vector object - * @example - *
- * - * var v = p5.Vector.random3D(); - * // May make v's attributes something like: - * // [0.61554617, -0.51195765, 0.599168] or - * // [-0.4695841, -0.14366731, -0.8711202] or - * // [0.6091097, -0.22805278, -0.7595902] - * - *
- */ -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); - } -}; - - -/** - * Adds two vectors together and returns a new one. - * - * @static - * @param {p5.Vector} v1 a p5.Vector to add - * @param {p5.Vector} v2 a p5.Vector to add - * @param {p5.Vector} target if undefined a new vector will be created - * @return {p5.Vector} the resulting p5.Vector - * - */ - -p5.Vector.add = function (v1, v2, target) { - if (!target) { - target = v1.copy(); - } else { - target.set(v1); - } - target.add(v2); - return target; -}; - -/** - * 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. - * - * @static - * @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 - * @return {p5.Vector} the resulting p5.Vector - */ - -p5.Vector.sub = function (v1, v2, target) { - if (!target) { - target = v1.copy(); - } else { - target.set(v1); - } - target.sub(v2); - return target; -}; - - -/** - * Multiplies a vector by a scalar and returns a new vector. - * - * @static - * @param {p5.Vector} v the p5.Vector to multiply - * @param {Number} n the scalar - * @param {p5.Vector} target if undefined a new vector will be created - * @return {p5.Vector} the resulting new p5.Vector - */ -p5.Vector.mult = function (v, n, target) { - if (!target) { - target = v.copy(); - } else { - target.set(v); - } - target.mult(n); - return target; -}; - -/** - * Divides a vector by a scalar and returns a new vector. - * - * @static - * @param {p5.Vector} v the p5.Vector to divide - * @param {Number} n the scalar - * @param {p5.Vector} target if undefined a new vector will be created - * @return {p5.Vector} the resulting new p5.Vector - */ -p5.Vector.div = function (v, n, target) { - if (!target) { - target = v.copy(); - } else { - target.set(v); - } - target.div(n); - return target; -}; - - -/** - * Calculates the dot product of two vectors. - * - * @static - * @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) { - return v1.dot(v2); -}; - -/** - * Calculates the cross product of two vectors. - * - * @static - * @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) { - return v1.cross(v2); -}; - -/** - * Calculates the Euclidean distance between two points (considering a - * point as a vector object). - * - * @static - * @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) { - return v1.dist(v2); -}; - -/** - * Linear interpolate a vector to another vector and return the result as a - * new vector. - * - * @static - * @param {p5.Vector} v1 a starting p5.Vector - * @param {p5.Vector} v2 the p5.Vector to lerp to - * @param {Number} the amount of interpolation; some value between 0.0 - * (old vector) and 1.0 (new vector). 0.1 is very near - * the new vector. 0.5 is halfway in between. - */ -p5.Vector.lerp = function (v1, v2, amt, target) { - if (!target) { - target = v1.copy(); - } else { - target.set(v1); - } - target.lerp(v2, amt); - return target; -}; - -/** - * Calculates and returns the angle (in radians) between two vectors. - * @method angleBetween - * @static - * @param {p5.Vector} v1 the x, y, and z components of a p5.Vector - * @param {p5.Vector} v2 the x, y, and z components of a p5.Vector - * @return {Number} the angle between (in radians) - * @example - *
- * - * var v1 = createVector(1, 0, 0); - * var v2 = createVector(0, 1, 0); - * - * var angle = p5.Vector.angleBetween(v1, v2); - * // angle is PI/2 - * - *
- */ -p5.Vector.angleBetween = function (v1, v2) { - var angle = Math.acos(v1.dot(v2) / (v1.mag() * v2.mag())); - if (this.p5) { - if (this.p5._angleMode === constants.DEGREES) { - angle = polarGeometry.radiansToDegrees(angle); - } - } - return angle; -}; - -/** - * @static - */ -p5.Vector.mag = function (vecT){ - var x = vecT.x, - y = vecT.y, - z = vecT.z; - var magSq = x * x + y * y + z * z; - return Math.sqrt(magSq); -}; - -module.exports = p5.Vector; - -},{"../core/constants":41,"../core/core":42,"./polargeometry":72}],72:[function(_dereq_,module,exports){ - -module.exports = { - - degreesToRadians: function(x) { - return 2 * Math.PI * x / 360; - }, - - radiansToDegrees: function(x) { - return 360 * x / (2 * Math.PI); - } - -}; - -},{}],73:[function(_dereq_,module,exports){ -/** - * @module Math - * @submodule Random - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -var seeded = false; -var previous = false; -var y2 = 0; - -// Linear Congruential Generator -// Variant of a Lehman Generator -var lcg = (function() { - // 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, - // a - 1 should be divisible by m's prime factors - a = 1664525, - // c and m should be co-prime - c = 1013904223, - seed, z; - return { - 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() { - return seed; - }, - rand : function() { - // define the recurrence relationship - z = (a * z + c) % m; - // return a float in [0, 1) - // if z = m then z / m = 0 therefore (z % m) / m < 1 always - return z / m; - } - }; -}()); - -/** - * Sets the seed value for random(). - * - * 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. - * - * @method randomSeed - * @param {Number} seed the seed value - * @example - *
- * - * randomSeed(99); - * for (var i=0; i < 100; i++) { - * var r = random(0, 255); - * stroke(r); - * line(i, 0, i, 100); - * } - * - *
- * - * @alt - * many vertical lines drawn in white, black or grey. - * - */ -p5.prototype.randomSeed = function(seed) { - lcg.setSeed(seed); - seeded = true; - previous = false; -}; - -/** - * Return a random floating-point number. - * - * Takes either 0, 1 or 2 arguments. - * - * If no argument is given, returns a random number from 0 - * up to (but not including) 1. - * - * If one argument is given and it is a number, returns a random number from 0 - * up to (but not including) the number. - * - * If one argument is given and it is an array, returns a random element from - * that array. - * - * If two arguments are given, returns a random number from the - * first argument up to (but not including) the second argument. - * - * @method random - * @param {Number} [min] the lower bound (inclusive) - * @param {Number} [max] the upper bound (exclusive) - * @return {Number} the random number - * @example - *
- * - * for (var i = 0; i < 100; i++) { - * var r = random(50); - * stroke(r*5); - * line(50, i, 50+r, i); - * } - * - *
- *
- * - * for (var i = 0; i < 100; i++) { - * var r = random(-50, 50); - * 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 - * - *
- * - * @alt - * 100 horizontal lines from center canvas to right. size+fill change each time - * 100 horizontal lines from center of canvas. height & side change each render - * word displayed at random. Either apple, bear, cat, or dog - * - */ -/** - * @method random - * @param {Array} choices the array to choose from - * @return {*} the random element from the array - * @example - */ -p5.prototype.random = function (min, max) { - - var rand; - - if (seeded) { - rand = lcg.rand(); - } else { - rand = Math.random(); - } - if (typeof min === 'undefined') { - return rand; - } else - if (typeof max === 'undefined') { - if (min instanceof Array) { - return min[Math.floor(rand * min.length)]; - } else { - return rand * min; - } - } else { - if (min > max) { - var tmp = min; - min = max; - max = tmp; - } - - 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 - * 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. - *

- * Takes either 0, 1 or 2 arguments.
- * If no args, returns a mean of 0 and standard deviation of 1.
- * If one arg, that arg is the mean (standard deviation is 1).
- * If two args, first is mean, second is standard deviation. - * - * @method randomGaussian - * @param {Number} mean the mean - * @param {Number} sd the standard deviation - * @return {Number} the random number - * @example - *
- * 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); - * } - *} - * - *
- * @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; - if (previous) { - y1 = y2; - previous = false; - } else { - do { - x1 = this.random(2) - 1; - x2 = this.random(2) - 1; - w = x1 * x1 + x2 * x2; - } while (w >= 1); - w = Math.sqrt((-2 * Math.log(w))/w); - y1 = x1 * w; - y2 = x2 * w; - previous = true; - } - - var m = mean || 0; - var s = sd || 1; - return y1*s + m; -}; - -module.exports = p5; - -},{"../core/core":42}],74:[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 constants = _dereq_('../core/constants'); - -p5.prototype._angleMode = constants.RADIANS; - -/** - * 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). - * - * @method acos - * @param {Number} value the value whose arc cosine is to be returned - * @return {Number} the arc cosine of the given value - * - * @example - *
- * - * var a = PI; - * var c = cos(a); - * var ac = acos(c); - * // Prints: "3.1415927 : -1.0 : 3.1415927" - * print(a + " : " + c + " : " + ac); - * - *
- * - *
- * - * 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); - * - *
- */ -p5.prototype.acos = function(ratio) { - if (this._angleMode === constants.RADIANS) { - return Math.acos(ratio); - } else { - return polarGeometry.radiansToDegrees(Math.acos(ratio)); - } -}; - -/** - * 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. - * - * @method asin - * @param {Number} value the value whose arc sine is to be returned - * @return {Number} the arc sine of the given value - * - * @example - *
- * - * var a = PI + PI/3; - * var s = sin(a); - * var as = asin(s); - * // Prints: "1.0471976 : 0.86602545 : 1.0471976" - * print(a + " : " + s + " : " + as); - * - *
- * - *
- * - * 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); - * - *
- * - */ -p5.prototype.asin = function(ratio) { - if (this._angleMode === constants.RADIANS) { - return Math.asin(ratio); - } else { - return polarGeometry.radiansToDegrees(Math.asin(ratio)); - } -}; - -/** - * 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. - * - * @method atan - * @param {Number} value the value whose arc tangent is to be returned - * @return {Number} the arc tangent of the given value - * - * @example - *
- * - * var a = PI + PI/3; - * var t = tan(a); - * var at = atan(t); - * // Prints: "1.0471976 : 1.7320509 : 1.0471976" - * print(a + " : " + t + " : " + at); - * - *
- * - *
- * - * 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); - * - *
- * - */ -p5.prototype.atan = function(ratio) { - if (this._angleMode === constants.RADIANS) { - return Math.atan(ratio); - } else { - return polarGeometry.radiansToDegrees(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 - * for orienting geometry to the position of the cursor. - *

- * Note: The y-coordinate of the point is the first parameter, and the - * x-coordinate is the second parameter, due the the structure of calculating - * the tangent. - * - * @method atan2 - * @param {Number} y y-coordinate of the point - * @param {Number} x x-coordinate of the point - * @return {Number} the arc tangent of the given point - * - * @example - *
- * - * function draw() { - * background(204); - * translate(width/2, height/2); - * var a = atan2(mouseY-height/2, mouseX-width/2); - * rotate(a); - * rect(-30, -5, 60, 10); - * } - * - *
- * - * @alt - * 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)); - } -}; - -/** - * Calculates the cosine of an angle. This function takes into account the - * current angleMode. Values are returned in the range -1 to 1. - * - * @method cos - * @param {Number} angle the angle - * @return {Number} the cosine of the angle - * - * @example - *
- * - * var a = 0.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); - * a = a + inc; - * } - * - *
- * - * @alt - * vertical black lines form wave patterns, extend-down on left and right side - * - */ -p5.prototype.cos = function(angle) { - if (this._angleMode === constants.RADIANS) { - return Math.cos(angle); - } else { - return Math.cos(this.radians(angle)); - } -}; - -/** - * Calculates the sine of an angle. This function takes into account the - * current angleMode. Values are returned in the range -1 to 1. - * - * @method sin - * @param {Number} angle the angle - * @return {Number} the sine of the angle - * - * @example - *
- * - * var a = 0.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); - * a = a + inc; - * } - * - *
- * - * @alt - * vertical black lines extend down and up from center to form wave pattern - * - */ -p5.prototype.sin = function(angle) { - if (this._angleMode === constants.RADIANS) { - return Math.sin(angle); - } else { - return Math.sin(this.radians(angle)); - } -}; - -/** - * Calculates the tangent of an angle. This function takes into account - * the current angleMode. Values are returned in the range -1 to 1. - * - * @method tan - * @param {Number} angle the angle - * @return {Number} the tangent of the 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; - * } - * - * - * - * @alt - * vertical black lines end down and up from center to form spike pattern - * - */ -p5.prototype.tan = function(angle) { - if (this._angleMode === constants.RADIANS) { - return Math.tan(angle); - } else { - return Math.tan(this.radians(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. - * - * @method degrees - * @param {Number} radians the radians value to convert to degrees - * @return {Number} the converted angle - * - * - * @example - *
- * - * var rad = PI/4; - * var deg = degrees(rad); - * print(rad + " radians is " + deg + " degrees"); - * // Prints: 0.7853981633974483 radians is 45 degrees - * - *
- * - */ -p5.prototype.degrees = function(angle) { - return polarGeometry.radiansToDegrees(angle); -}; - -/** - * 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. - * - * @method radians - * @param {Number} degrees the degree value to convert to radians - * @return {Number} the converted angle - * - * @example - *
- * - * var deg = 45.0; - * var rad = radians(deg); - * print(deg + " degrees is " + rad + " radians"); - * // Prints: 45 degrees is 0.7853981633974483 radians - * - *
- */ -p5.prototype.radians = function(angle) { - return polarGeometry.degreesToRadians(angle); -}; - -/** - * Sets the current mode of p5 to given mode. Default mode is RADIANS. - * - * @method angleMode - * @param {Constant} mode either RADIANS or DEGREES - * - * @example - *
- * - * 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); - * push(); - * rotate(a); - * rect(-20, -5, 40, 10); // Larger rectangle is rotating in degrees - * pop(); - * angleMode(RADIANS); // Change the mode to RADIANS - * rotate(a); // var a stays the same - * rect(-40, -5, 20, 10); // Smaller rectangle is rotating in radians - * } - * - *
- * - * @alt - * 40 by 10 rect in center rotates with mouse moves. 20 by 10 rect moves faster. - * - * - */ -p5.prototype.angleMode = function(mode) { - if (mode === constants.DEGREES || mode === constants.RADIANS) { - this._angleMode = mode; - } -}; - -module.exports = p5; - -},{"../core/constants":41,"../core/core":42,"./polargeometry":72}],75:[function(_dereq_,module,exports){ -/** - * @module Typography - * @submodule Attributes - * @for p5 - * @requires core - * @requires constants - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * Sets the current alignment for drawing text. Accepts two - * arguments: horizAlign (LEFT, CENTER, or RIGHT) and - * 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 - * 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 - * 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. - * - * @method textAlign - * @param {Constant} horizAlign horizontal alignment, either LEFT, - * CENTER, or RIGHT - * @param {Constant} vertAlign vertical alignment, either TOP, - * BOTTOM, CENTER, or BASELINE - * @return {Number} - * @example - *
- * - * textSize(16); - * textAlign(RIGHT); - * text("ABCD", 50, 30); - * textAlign(CENTER); - * text("EFGH", 50, 50); - * textAlign(LEFT); - * text("IJKL", 50, 70); - * - *
- * - * @alt - *Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left. - * - */ -p5.prototype.textAlign = function(horizAlign, vertAlign) { - 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. - * - * @method textLeading - * @param {Number} leading the size in pixels for spacing between lines - * @return {Object|Number} - * @example - *
- * - * // Text to display. The "\n" is a "new line" character - * lines = "L1\nL2\nL3"; - * textSize(12); - * - * textLeading(10); // Set leading to 10 - * text(lines, 10, 25); - * - * textLeading(20); // Set leading to 20 - * text(lines, 40, 25); - * - * textLeading(30); // Set leading to 30 - * text(lines, 70, 25); - * - *
- * - * @alt - *set L1 L2 & L3 displayed vertically 3 times. spacing increases for each set - * - */ -p5.prototype.textLeading = function(theLeading) { - 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. - * - * @method textSize - * @param {Number} theSize the size of the letters in units of pixels - * @return {Object|Number} - * @example - *
- * - * textSize(12); - * text("Font Size 12", 10, 30); - * textSize(14); - * text("Font Size 14", 10, 60); - * textSize(16); - * text("Font Size 16", 10, 90); - * - *
- * - * @alt - *Font Size 12 displayed small, Font Size 14 medium & Font Size 16 large - * - */ -p5.prototype.textSize = function(theSize) { - return this._renderer.textSize.apply(this._renderer, arguments); -}; - -/** - * Sets/gets the style of the text for system fonts to NORMAL, ITALIC, or BOLD. - * Note: this may be is overridden by CSS styling. For non-system fonts - * (opentype, truetype, etc.) please load styled fonts instead. - * - * @method textStyle - * @param {Number|Constant} theStyle styling for text, either NORMAL, - * ITALIC, or BOLD - * @return {Object|String} - * @example - *
- * - * strokeWeight(0); - * textSize(12); - * textStyle(NORMAL); - * text("Font Style Normal", 10, 30); - * textStyle(ITALIC); - * text("Font Style Italic", 10, 60); - * textStyle(BOLD); - * text("Font Style Bold", 10, 90); - * - *
- * - * @alt - *words Font Style Normal displayed normally, Italic in italic and bold in bold - * - */ -p5.prototype.textStyle = function(theStyle) { - return this._renderer.textStyle.apply(this._renderer, arguments); -}; - -/** - * Calculates and returns the width of any character or text string. - * - * @method textWidth - * @param {String} theText the String of characters to measure - * @return {Number} - * @example - *
- * - * textSize(28); - * - * var aChar = 'P'; - * var cWidth = textWidth(aChar); - * text(aChar, 0, 40); - * line(cWidth, 0, cWidth, 50); - * - * var aString = "p5.js"; - * var sWidth = textWidth(aString); - * text(aString, 0, 85); - * line(sWidth, 50, sWidth, 100); - * - *
- * - * @alt - *Letter P and p5.js are displayed with vertical lines at end. P is wide - * - */ -p5.prototype.textWidth = function(theText) { - if (theText.length === 0) { - return 0; - } - return this._renderer.textWidth.apply(this._renderer, arguments); -}; - -/** - * Returns the ascent of the current font at its current size. The ascent - * represents the distance, in pixels, of the tallest character above - * the baseline. - * - * @return {Number} - * @example - *
- * - * 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 - * line(0, base - asc, width, base - asc); - * text("dp", 0, base); // Draw text on baseline - * - * 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 - * - *
- */ -p5.prototype.textAscent = function() { - return this._renderer.textAscent(); -}; - -/** - * Returns the descent of the current font at its current size. The descent - * represents the distance, in pixels, of the character with the longest - * descender below the baseline. - * - * @return {Number} - * @example - *
- * - * 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(64); // Increase text size - * desc = textDescent() * scalar; // Recalc ascent - * line(40, base + desc, width, base + desc); - * text("dp", 40, base); // Draw text on baseline - * - *
- */ -p5.prototype.textDescent = function() { - return this._renderer.textDescent(); -}; - -/** - * Helper function to measure ascent and descent. - */ -p5.prototype._updateTextMetrics = function() { - return this._renderer._updateTextMetrics(); -}; - -module.exports = p5; - -},{"../core/core":42}],76:[function(_dereq_,module,exports){ -/** - * @module Typography - * @submodule Loading & Displaying - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -var constants = _dereq_('../core/constants'); - -_dereq_('../core/error_helpers'); - - -/** - * 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() - * functions. - *

- * 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 - * does not fit completely within the rectangle specified will not be drawn - * to the screen. - * - * @method text - * @param {String} 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 - * @param {Number} y2 by default, the height of the text box, - * see rectMode() for more info - * @return {Object} this - * @example - *
- * - * textSize(32); - * text("word", 10, 30); - * fill(0, 102, 153); - * text("word", 10, 60); - * fill(0, 102, 153, 51); - * text("word", 10, 90); - * - *
- *
- * - * s = "The quick brown fox jumped over the lazy dog."; - * fill(50); - * text(s, 10, 10, 70, 80); // Text wraps within text box - * - *
- * - * @alt - *'word' displayed 3 times going from black, blue to translucent blue - * The quick brown fox jumped over the lazy dog. - * - */ -p5.prototype.text = function(str, x, y, maxWidth, maxHeight) { - 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. - * - * @method textFont - * @param {Object|String} f a font loaded via loadFont(), or a String - * representing a web safe font (a font - * that is generally available across all systems). - * @return {Object} this - * @example - *
- * - * fill(0); - * textSize(12); - * 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"); - * } - * 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); - * } - * - *
- * - * @alt - *words Font Style Normal displayed normally, Italic in italic and bold in bold - * - */ -p5.prototype.textFont = function(theFont, theSize) { - - if (arguments.length) { - - if (!theFont) { - - throw 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); - } - - return this._renderer._applyTextProperties(); - } - - return this; -}; - -module.exports = p5; - -},{"../core/constants":41,"../core/core":42,"../core/error_helpers":45}],77:[function(_dereq_,module,exports){ -/** - * This module defines the p5.Font class and functions for - * drawing text to the display canvas. - * @module Typography - * @submodule Font - * @requires core - * @requires constants - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -var constants = _dereq_('../core/constants'); - -/* - * TODO: - * - * API: - * -- textBounds() - * -- getPath() - * -- getPoints() - * - * =========================================== - * -- PFont functions: - * PFont.list() - * - * -- kerning - * -- alignment: justified? - * -- integrate p5.dom? (later) - */ - -/** - * Base class for font handling - * @class p5.Font - * @constructor - * @param {Object} [pInst] pointer to p5 instance - */ -p5.Font = function(p) { - - this.parent = p; - - this.cache = {}; - - /** - * Underlying opentype font implementation - * @property font - */ - this.font = undefined; -}; - -p5.Font.prototype.list = function() { - - // TODO - throw 'not yet implemented'; -}; - -/** - * Returns a tight bounding box for the given text string using this - * font (currently only supports single lines) - * - * @method textBounds - * @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) - * - * @return {Object} a rectangle object with properties: x, y, w, h - * - * @example - *
- * - * var font; - * var textString = 'Lorem ipsum dolor sit amet.'; - * function preload() { - * 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); - * }; - * - *
- * - * @alt - *words Lorem ipsum dol go off canvas and contained by white bounding box - * - */ -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; - - // 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 result = this.cache[cacheKey('textBounds', str, x, y, fontSize, alignment, - baseline)]; - - if (!result) { - - var xCoords = [], yCoords = [], self = this, - scale = this._scale(fontSize), minX, minY, maxX, maxY; - - this.font.forEachGlyph(str, x, y, fontSize, options, - function(glyph, gX, gY, gFontSize) { - - xCoords.push(gX); - yCoords.push(gY); - - var gm = glyph.getMetrics(); - - if (glyph.name !== 'space' && glyph.unicode !== 32) { - - xCoords.push(gX + (gm.xMax * scale)); - yCoords.push(gY + (-gm.yMin * scale)); - yCoords.push(gY + (-gm.yMax * scale)); - - } else { // NOTE: deals with broken metrics for spaces in opentype.js - - xCoords.push(gX + self.font.charToGlyph(' ').advanceWidth * - self._scale(fontSize)); - } - }); - - // fix to #1409 (not sure why these max() functions were here) - /*minX = Math.max(0, Math.min.apply(null, xCoords)); - minY = Math.max(0, Math.min.apply(null, yCoords)); - maxX = Math.max(0, Math.max.apply(null, xCoords)); - maxY = Math.max(0, Math.max.apply(null, yCoords));*/ - minX = Math.min.apply(null, xCoords); - minY = Math.min.apply(null, yCoords); - maxX = Math.max.apply(null, xCoords); - maxY = Math.max.apply(null, yCoords); - - result = { - x: minX, - y: minY, - h: maxY - minY, - w: maxX - minX, - advance: minX - x - }; - - // Bounds are now calculated, so shift the x & y to match alignment settings - var textWidth = result.w + result.advance; - var pos = this._handleAlignment(p, ctx, str, result.x, result.y, textWidth); - result.x = pos.x; - result.y = pos.y; - - this.cache[cacheKey('textBounds', str, x, y, fontSize, alignment, - baseline)] = result; - } - //else console.log('cache-hit'); - - return result; -}; - - -/** - * Computes an array of points following the path for specified text - * - * @param {String} txt 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 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 - * more precise - * - *
simplifyThreshold - if set to a non-zero value, collinear points will be - * be removed from the polygon; the value represents the threshold angle to use - * when determining whether two edges are collinear - * - * @return {Array} an array of points, each with x, y, alpha (the path angle) - */ -p5.Font.prototype.textToPoints = function(txt, x, y, fontSize, options) { - - var xoff = 0, result = [], glyphs = this._getGlyphs(txt); - - fontSize = fontSize || this.parent._renderer._textSize; - - for (var i = 0; i < glyphs.length; i++) { - - if (glyphs[i].name !== 'space') { // fix to #1817 - - 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++) { - pts[k].x += xoff; - result.push(pts[k]); - } - } - } - - xoff += glyphs[i].advanceWidth * this._scale(fontSize); - } - - return result; -}; - -// ----------------------------- End API ------------------------------ - -/** - * Returns the set of opentype glyphs for the supplied string. - * - * Note that there is not a 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} 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. - * - * @param {String} line a line of text - * @param {Number} x x-position - * @param {Number} y y-position - * @param {Object} options opentype options (optional) - * @return {Object} the opentype path - */ -p5.Font.prototype._getPath = function(line, x, y, options) { - - 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); -}; - -/* - * Creates an SVG-formatted path-data string - * (See http://www.w3.org/TR/SVG/paths.html#PathData) - * from the given opentype path or string/position - * - * @param {Object} path an opentype path, OR the following: - * - * @param {String} line a line of text - * @param {Number} x x-position - * @param {Number} y y-position - * @param {Object} options opentype options (optional), set options.decimals - * to set the decimal precision of the path-data - * - * @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') { - - options = x; - } - - // handle svg arguments - if (options && typeof options.decimals === 'number') { - - decimals = options.decimals; - } - - return line.toPathData(decimals); -}; - -/* - * Creates an SVG element, as a string, - * from the given opentype path or string/position - * - * @param {Object} path an opentype path, OR the following: - * - * @param {String} line a line of text - * @param {Number} x x-position - * @param {Number} y y-position - * @param {Object} options opentype options (optional), set options.decimals - * to set the decimal precision of the path-data in the element, - * options.fill to set the fill color for the element, - * options.stroke to set the stroke color for the element, - * options.strokeWidth to set the strokeWidth for the element. - * - * @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') { - - options = x; - } - - // handle svg arguments - if (options) { - if (typeof options.decimals === 'number') { - decimals = options.decimals; - } - if (typeof options.strokeWidth === 'number') { - line.strokeWidth = options.strokeWidth; - } - if (typeof options.fill !== 'undefined') { - line.fill = options.fill; - } - if (typeof options.stroke !== 'undefined') { - line.stroke = options.stroke; - } - } - - return line.toSVG(decimals); -}; - -/* - * Renders an opentype path or string/position - * to the current graphics context - * - * @param {Object} path an opentype path, OR the following: - * - * @param {String} line a line of text - * @param {Number} x x-position - * @param {Number} y y-position - * @param {Object} options opentype options (optional) - * - * @return {Object} this p5.Font object - */ -p5.Font.prototype._renderPath = function(line, x, y, options) { - - 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); - } 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(); - } - } - - // 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 - ctx.fillStyle = pg._fillSet ? ctx.fillStyle : constants._DEFAULT_TEXT_FILL; - ctx.fill(); - } - - return this; -}; - -p5.Font.prototype._textWidth = function(str, fontSize) { - - if (str === ' ') { // special case for now - - return this.font.charToGlyph(' ').advanceWidth * this._scale(fontSize); - } - - var bounds = this.textBounds(str, 0, 0, fontSize); - return bounds.w + bounds.advance; -}; - -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); -}; - -p5.Font.prototype._handleAlignment = function(p, ctx, line, x, y, textWidth) { - var fontSize = p._renderer._textSize, - textAscent = this._textAscent(fontSize), - textDescent = this._textDescent(fontSize); - - textWidth = textWidth !== undefined ? textWidth : - this._textWidth(line, fontSize); - - if (ctx.textAlign === constants.CENTER) { - x -= textWidth / 2; - } else if (ctx.textAlign === constants.RIGHT) { - x -= textWidth; - } - - 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; - } - - return { x: x, y: y }; -}; - -// path-utils - -function pathToPoints(cmds, options) { - - var opts = parseOpts(options, { - sampleFactor: 0.1, - simplifyThreshold: 0, - }); - - var len = pointAtLength(cmds,0,1), // total-length - t = len / (len * opts.sampleFactor), - pts = []; - - for (var i = 0; i < len; i += t) { - pts.push(pointAtLength(cmds, i)); - } - - if (opts.simplifyThreshold) { - /*var count = */simplify(pts, opts.simplifyThreshold); - //console.log('Simplify: removed ' + count + ' pts'); - } - - return pts; -} - -function simplify(pts, 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++; - } - } - return num; -} - -function splitPaths(cmds) { - - var paths = [], current; - for (var i = 0; i < cmds.length; i++) { - if (cmds[i].type === 'M') { - if (current) { - paths.push(current); - } - current = []; - } - current.push(cmdToArr(cmds[i])); - } - paths.push(current); - - return paths; -} - -function cmdToArr(cmd) { - - 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); - } else if (cmd.type === 'Q') { - arr.push(cmd.x1, cmd.y1, cmd.x, cmd.y); - } - // else if (cmd.type === 'Z') { /* no-op */ } - return arr; -} - -function parseOpts(options, defaults) { - - if (typeof options !== 'object') { - options = defaults; - } - else { - for (var key in defaults) { - if (typeof options[key] === 'undefined') { - options[key] = defaults[key]; - } - } - } - return options; -} - -//////////////////////// Helpers //////////////////////////// - -function at(v, i) { - var s = v.length; - return v[i < 0 ? i % s + s : i % s]; -} - -function collinear(a, b, c, thresholdAngle) { - - if (!thresholdAngle) { - return areaTriangle(a, b, c) === 0; - } - - if (typeof collinear.tmpPoint1 === 'undefined') { - collinear.tmpPoint1 = []; - 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; - bc.y = c.y - b.y; - - var dot = ab.x * bc.x + ab.y * bc.y, - magA = Math.sqrt(ab.x * ab.x + ab.y * ab.y), - magB = Math.sqrt(bc.x * bc.x + bc.y * bc.y), - angle = Math.acos(dot / (magA * magB)); - - return angle < thresholdAngle; -} - -function areaTriangle(a, b, c) { - 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), - 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); - - 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 - }; -} - -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; - for (var i = 0, ii = path.length; i < ii; i++) { - p = path[i]; - if (p[0] === 'M') { - x = +p[1]; - y = +p[2]; - } else { - 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); - return { x: point.x, y: point.y, alpha: point.alpha }; - } - } - len += l; - x = +p[5]; - y = +p[6]; - } - sp += p.shift() + p; - } - subpaths.end = sp; - - 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 }; - } - - return point; -} - -function pathToAbsolute(pathArray) { - - var res = [], x = 0, y = 0, mx = 0, my = 0, start = 0; - if (pathArray[0][0] === 'M') { - x = +pathArray[0][1]; - y = +pathArray[0][2]; - mx = x; - my = y; - start++; - 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'; - - for (var r, pa, i = start, ii = pathArray.length; i < ii; i++) { - res.push(r = []); - pa = pathArray[i]; - if (pa[0] !== String.prototype.toUpperCase.call(pa[0])) { - r[0] = String.prototype.toUpperCase.call(pa[0]); - switch (r[0]) { - case 'A': - r[1] = pa[1]; - r[2] = pa[2]; - r[3] = pa[3]; - r[4] = pa[4]; - r[5] = pa[5]; - r[6] = +(pa[6] + x); - r[7] = +(pa[7] + y); - break; - case 'V': - r[1] = +pa[1] + y; - break; - case 'H': - r[1] = +pa[1] + x; - break; - case 'R': - dots = [x, y].concat(pa.slice(1)); - for (var j = 2, jj = dots.length; j < jj; j++) { - dots[j] = +dots[j] + x; - dots[++j] = +dots[j] + y; - } - res.pop(); - res = res.concat(catmullRom2bezier(dots, crz)); - break; - case 'M': - mx = +pa[1] + x; - my = +pa[2] + y; - break; - default: - for (j = 1, jj = pa.length; j < jj; j++) { - r[j] = +pa[j] + ((j % 2) ? x : y); - } - } - } else if (pa[0] === 'R') { - dots = [x, y].concat(pa.slice(1)); - res.pop(); - res = res.concat(catmullRom2bezier(dots, crz)); - r = ['R'].concat(pa.slice(-2)); - } else { - for (var k = 0, kk = pa.length; k < kk; k++) { - r[k] = pa[k]; - } - } - switch (r[0]) { - case 'Z': - x = mx; - y = my; - break; - case 'H': - x = r[1]; - break; - case 'V': - y = r[1]; - break; - case 'M': - mx = r[r.length - 2]; - my = r[r.length - 1]; - break; - default: - x = r[r.length - 2]; - y = r[r.length - 1]; - } - } - return res; -} - -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; } - switch (path[0]) { - case 'M': - d.X = path[1]; - d.Y = path[2]; - break; - case 'A': - path = ['C'].concat(a2c.apply(0, [d.x, d.y].concat(path.slice(1)))); - break; - case 'S': - if (pcom === 'C' || pcom === 'S') { - nx = d.x * 2 - d.bx; - ny = d.y * 2 - d.by; - } else { - nx = d.x; - ny = d.y; - } - path = ['C', nx, ny].concat(path.slice(1)); - break; - case 'T': - if (pcom === 'Q' || pcom === 'T') { - d.qx = d.x * 2 - d.qx; - d.qy = d.y * 2 - d.qy; - } else { - d.qx = d.x; - d.qy = d.y; - } - path = ['C'].concat(q2c(d.x, d.y, d.qx, d.qy, path[1], path[2])); - break; - 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])); - break; - case 'L': - path = ['C'].concat(l2c(d.x, d.y, path[1], path[2])); - break; - case 'H': - path = ['C'].concat(l2c(d.x, d.y, path[1], d.y)); - break; - case 'V': - path = ['C'].concat(l2c(d.x, d.y, d.x, path[1])); - break; - case 'Z': - path = ['C'].concat(l2c(d.x, d.y, d.X, d.Y)); - break; - } - 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'; } - pp.splice(i++, 0, ['C'].concat(pi.splice(0, 6))); - } - pp.splice(i, 1); - 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]); - a1.bx = 0; - a1.by = 0; - a1.x = path1[i][1]; - a1.y = path1[i][2]; - 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 - - 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 - - if (pfirst !== 'C') { - pcoms1[i] = pfirst; // Save current path command - 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'; } - - 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 (pfirst !== 'C') { - pcoms2[i] = pfirst; - if (i) { pcom = pcoms2[i - 1]; } - } - p2[i] = processPath(p2[i], attrs2, pcom); - - 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, - seg2len = p2 && seg2.length; - attrs.x = seg[seglen - 2]; - attrs.y = seg[seglen - 1]; - attrs.bx = parseFloat(seg[seglen - 4]) || attrs.x; - attrs.by = parseFloat(seg[seglen - 3]) || attrs.y; - attrs2.bx = p2 && (parseFloat(seg2[seg2len - 4]) || attrs2.x); - attrs2.by = p2 && (parseFloat(seg2[seg2len - 3]) || attrs2.y); - attrs2.x = p2 && seg2[seg2len - 2]; - attrs2.y = p2 && seg2[seg2len - 1]; - } - - return p2 ? [p, p2] : p; -} - -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 X = x * Math.cos(rad) - y * Math.sin(rad), - Y = x * Math.sin(rad) + y * Math.cos(rad); - return { x: X, y: Y }; - }; - if (!recursive) { - xy = rotate(x1, y1, -rad); - x1 = xy.x; - y1 = xy.y; - 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); - 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))); - - cx = k * rx * y / ry + (x1 + x2) / 2; - cy = k * -ry * x / rx + (y1 + y2) / 2; - f1 = Math.asin(((y1 - cy) / ry).toFixed(9)); - f2 = Math.asin(((y2 - cy) / ry).toFixed(9)); - - 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 (sweep_flag && f1 > f2) { - f1 = f1 - PI * 2; - } - if (!sweep_flag && f2 > f1) { - f2 = f2 - PI * 2; - } - } else { - f1 = recursive[0]; - f2 = recursive[1]; - cx = recursive[2]; - cy = recursive[3]; - } - var df = f2 - f1; - if (Math.abs(df) > _120) { - 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]); - } - df = f2 - f1; - var c1 = Math.cos(f1), - s1 = Math.sin(f1), - c2 = Math.cos(f2), - s2 = Math.sin(f2), - t = Math.tan(df / 4), - hx = 4 / 3 * rx * t, - hy = 4 / 3 * ry * t, - m1 = [x1, y1], - m2 = [x1 + hx * s1, y1 - hy * c1], - m3 = [x2 + hx * s2, y2 - hy * c2], - m4 = [x2, y2]; - m2[0] = 2 * m1[0] - m2[0]; - m2[1] = 2 * m1[1] - m2[1]; - if (recursive) { - return [m2, m3, m4].concat(res); - } else { - 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; - } - return newres; - } -} - -// http://schepers.cc/getting-to-the-point -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] - }]; - if (z) { - if (!i) { - p[0] = { - x: +crp[iLen - 2], - y: +crp[iLen - 1] - }; - } else if (iLen - 4 === i) { - p[3] = { - x: +crp[0], - y: +crp[1] - }; - } else if (iLen - 2 === i) { - p[2] = { - x: +crp[0], - y: +crp[1] - }; - p[3] = { - x: +crp[2], - y: +crp[3] - }; - } - } else { - if (iLen - 4 === i) { - p[3] = p[2]; - } else if (!i) { - p[0] = { - x: +crp[i], - y: +crp[i + 1] - }; - } - } - 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 q2c(x1, y1, ax, ay, x2, y2) { - 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 - ]; -} - -function bezlen(x1, y1, x2, y2, x3, y3, x4, y4, z) { - 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 ]; - for (var i = 0; i < n; i++) { - var ct = z2 * Tvalues[i] + z2, - xbase = base3(ct, x1, x2, x3, x4), - ybase = base3(ct, y1, y2, y3, y4), - comb = xbase * xbase + ybase * ybase; - sum += Cvalues[i] * Math.sqrt(comb); - } - return z2 * sum; -} - -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; - l = bezlen(x1, y1, x2, y2, x3, y3, x4, y4, t2); - while (Math.abs(l - ll) > e) { - step /= 2; - t2 += (l < ll ? 1 : -1) * step; - l = bezlen(x1, y1, x2, y2, x3, y3, x4, y4, t2); - } - return t2; -} - -function base3(t, p1, p2, p3, p4) { - var t1 = -3 * p1 + 9 * p2 - 9 * p3 + 3 * p4, - t2 = t * t1 + 6 * p1 - 12 * p2 + 6 * p3; - return t * t2 - 3 * p1 + 3 * p2; -} - -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]; - } - return hash; -} - -module.exports = p5.Font; - -},{"../core/constants":41,"../core/core":42}],78:[function(_dereq_,module,exports){ -/** - * @module Data - * @submodule Array Functions - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * Adds a value to the end of an array. Extends the length of - * the array by one. Maps to Array.push(). - * - * @method append - * @param {Array} array Array to append - * @param {any} value to be added to the Array - * @example - *
- * function setup() { - * - * var myArray = new Array("Mango", "Apple", "Papaya") - * print(myArray) // ["Mango", "Apple", "Papaya"] - * - * append(myArray, "Peach") - * print(myArray) // ["Mango", "Apple", "Papaya", "Peach"] - * - * } - *
- */ -p5.prototype.append = function(array, value) { - array.push(value); - return array; -}; - -/** - * Copies an array (or part of an array) to another array. The src array is - * copied to the dst array, beginning at the position specified by - * 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(). - *

- * The simplified version with only two arguments, arrayCopy(src, dst), - * copies an entire array to another of the same size. It is equivalent to - * arrayCopy(src, 0, dst, 0, src.length). - *

- * Using this function is far more efficient for copying array data than - * iterating through a for() loop and copying each element individually. - * - * @method arrayCopy - * @param {Array} src the source Array - * @param {Number} [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 - * - * @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] - * - * } - *
- */ -p5.prototype.arrayCopy = function( - src, - srcPosition, - dst, - dstPosition, - length) { - - // the index to begin splicing from dst array - var start, - 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 - // rename so we don't get confused - end = dst; - end = Math.min(end, src.length); - } else { // src, dst - end = src.length; - } - - start = 0; - // rename so we don't get confused - dst = srcPosition; - src = src.slice(0, end); - } - - // Since we are not returning the array and JavaScript is pass by reference - // we must modify the actual values of the array - // instead of reassigning arrays - Array.prototype.splice.apply(dst, [start, end].concat(src)); - -}; - -/** - * Concatenates two arrays, maps to Array.concat(). Does not modify the - * input arrays. - * - * @method concat - * @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 ); - * - * 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] - * - * } - *
- */ -p5.prototype.concat = function(list0, list1) { - return list0.concat(list1); -}; - -/** - * Reverses the order of an array, maps to Array.reverse() - * - * @method reverse - * @param {Array} list Array to reverse - * @example - *
- * function setup() { - * var myArray = new Array("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 - * @param {Array} list Array to shorten - * @return {Array} shortened Array - * @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"] - * } - *
- */ -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 - * @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 - * @param {Array} list Array to sort - * @param {Number} [count] number of elements to sort, starting from 0 - * - * @example - *
- * function setup() { - * var words = new Array("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 = 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 - * - * 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 - * @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 - * - * @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"] - * - * 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 - * @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 - * - * @example - *
- * function setup() { - * var myArray = new Array(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/core":42}],79:[function(_dereq_,module,exports){ -/** - * @module Data - * @submodule Conversion - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * 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|Array} n value to parse - * @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] - *
- */ -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 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|Array} 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(true)); // 1 - * print(byte([0, 255, "100"])); // [0, -1, 100] - *
- */ -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|Array} 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" - *
- */ -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|Array} 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 ] - *
- */ -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|Array} n value to parse - * @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" ] - *
- */ -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|Array} 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 ] - *
- */ -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/core":42}],80:[function(_dereq_,module,exports){ -/** - * @module Data - * @submodule String Functions - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -//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.join = function(list, separator) { - return list.join(separator); -}; - -/** - * 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 {Array} Array of Strings found - * @example - *
- * - * var string = "Hello p5js*!" - * var regexp = "p5js\\*" - * var match = match(string, regexp); - * text(match, 5, 50); - * - *
- * - * @alt - * "p5js*" displayed middle left of canvas. - * - */ -p5.prototype.match = function(str, reg) { - return str.match(reg); -}; - -/** - * 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 {Array} 2d Array of Strings found - * @example - *
- * - * var string = "Hello p5js*! Hello world!" - * var regexp = "Hello" - * matchAll(string, regexp); - * - *
- - */ -p5.prototype.matchAll = function(str, reg) { - 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; -}; - -/** - * 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|Array} 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|Array} formatted String - * @example - *
- * - * 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); - * - * // 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.nf = function () { - if (arguments[0] instanceof Array) { - var a = arguments[1]; - var b = arguments[2]; - return arguments[0].map(function (x) { - return doNf(x, a, b); - }); - } - 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); - } - } -}; - -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; - } - else { - for (var k = 0; k < Math.max(arguments[1] - intPart.length, 0); k++) { - str += '0'; - } - str += n; - return str; - } -} - -/** - * 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|Array} num the Number to format - * @param {Number} [right] number of digits to the right of the - * decimal point - * @return {String|Array} formatted String - * @example - *
- * - * 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); - * - * // 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.nfc = function () { - 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); - } -}; -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 = ''; - } - 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); - } - } - return n + rem; -} - -/** - * 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|Array} 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|Array} formatted String - * @example - *
- * - * 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); - * - * // Draw dividing line - * stroke(120); - * line(0, 50, width, 50); - * } - * - *
- * - * @alt - * "+11253106.11" top middle and "-11253106.11" displayed bottom middle - * - */ -p5.prototype.nfp = function() { - var nfRes = this.nf.apply(this, arguments); - if (nfRes instanceof Array) { - return nfRes.map(addNfp); - } else { - return addNfp(nfRes); - } -}; - -function addNfp() { - return ( - parseFloat(arguments[0]) > 0) ? - '+'+arguments[0].toString() : - arguments[0].toString(); -} - -/** - * 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|Array} 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|Array} formatted String - * @example - *
- * - * 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); - * - * // Draw dividing line - * stroke(120); - * line(0, 50, width, 50); - * } - * - *
- * - * @alt - * "11253106.11" top middle and "-11253106.11" displayed bottom middle - * - */ -p5.prototype.nfs = function() { - var nfRes = this.nf.apply(this, arguments); - if (nfRes instanceof Array) { - return nfRes.map(addNfs); - } else { - return addNfs(nfRes); - } -}; - -function addNfs() { - return ( - parseFloat(arguments[0]) > 0) ? - ' '+arguments[0].toString() : - arguments[0].toString(); -} - -/** - * 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 {Array} Array of Strings - * @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); - * - *
- * - * @alt - * "pat" top left, "Xio" mid left and "Alex" displayed bottom left - * - */ -p5.prototype.split = function(str, delim) { - return str.split(delim); -}; - -/** - * 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 {Array} Array of Strings - * @example - *
- * - * function setup() { - * var myStr = "Mango, Banana, Lime"; - * var myStrArr = splitTokens(myStr, ","); - * - * print(myStrArr); // prints : ["Mango"," Banana"," Lime"] - * } - * - *
- */ -p5.prototype.splitTokens = function() { - 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'); - } - } else { - d = /\s/g; - } - 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|Array} str a String or Array of Strings to be trimmed - * @return {String|Array} a trimmed String or Array of 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) { - if (str instanceof Array) { - return str.map(this.trim); - } else { - return str.trim(); - } -}; - -module.exports = p5; - -},{"../core/core":42}],81:[function(_dereq_,module,exports){ -/** - * @module IO - * @submodule Time & Date - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * 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 - * @example - *
- * - * var d = day(); - * text("Current day: \n" + d, 5, 50); - * - *
- * - * @alt - * Current day is displayed - * - */ -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(); -}; - -/** - * p5.js communicates with the clock on your computer. The minute() function - * returns the current minute as a value from 0 - 59. - * - * @method minute - * @return {Number} the current minute - * @example - *
- * - * var m = minute(); - * text("Current minute: \n" + m, 5, 50); - * - *
- * - * @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. - * - * @method millis - * @return {Number} the number of milliseconds since starting the program - * @example - *
- * - * var millisecond = millis(); - * text("Milliseconds \nrunning: \n" + millisecond, 5, 40); - * - *
- * - * @alt - * number of milliseconds since program has started displayed - * - */ -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); - * - *
- * - * @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. - * - * @method second - * @return {Number} the current second - * @example - *
- * - * var s = second(); - * text("Current second: \n" + s, 5, 50); - * - *
- * - * @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). - * - * @method year - * @return {Number} the current year - * @example - *
- * - * var y = year(); - * text("Current year: \n" + y, 5, 50); - * - *
- * - * @alt - * Current year is displayed - * - */ -p5.prototype.year = function() { - return new Date().getFullYear(); -}; - -module.exports = p5; - -},{"../core/core":42}],82:[function(_dereq_,module,exports){ -/** - * @module Lights, Camera - * @submodule Camera - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * Sets camera position - * @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 - * @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); - * plane(120, 120); - * } - * - *
- * - * @alt - * blue square shrinks in size grows to fill canvas. disappears then loops. - * - */ -p5.prototype.camera = function(x, y, z){ - //what it manipulates is the model view matrix - this._renderer.translate(-x, -y, -z); -}; - -/** - * Sets perspective camera - * @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 - * @example - *
- * - * //drag mouse to toggle the world! - * //you will see there's a vanish point - * 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(); - * } - * } - * } - * - *
- * - * @alt - * colored 3d boxes toggleable with mouse position - * - */ -p5.prototype.perspective = function(fovy,aspect,near,far) { - fovy = fovy || (60 / 180 * this.PI); - aspect = aspect || (this.width/this.height); - near = near || ((this.height/2.0) / this.tan(fovy/2.0) * 0.1); - far = far || ((this.height/2.0) / this.tan(fovy/2.0) * 10); - this._renderer.uPMatrix = p5.Matrix.identity(); - this._renderer.uPMatrix.perspective(fovy,aspect,near,far); - this._renderer._curCamera = 'custom'; -}; - -/** - * 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 - * - */ -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); - this._renderer._curCamera = 'custom'; -}; - -module.exports = p5; - -},{"../core/core":42}],83:[function(_dereq_,module,exports){ -'use strict'; - -var p5 = _dereq_('../core/core'); - -//@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; -}; - -module.exports = p5; -},{"../core/core":42}],84:[function(_dereq_,module,exports){ -/** - * @module Lights, Camera - * @submodule Lights - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * Creates an ambient light with a color - * @method ambientLight - * @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] optional: green or saturation value - * @param {Number} [v3] optional: blue or brightness value - * @param {Number} [a] optional: opacity - * @return {p5} the p5 object - * @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){ - var gl = this._renderer.GL; - var shaderProgram = this._renderer._getShader( - 'lightVert', 'lightTextureFrag'); - - gl.useProgram(shaderProgram); - shaderProgram.uAmbientColor = gl.getUniformLocation( - shaderProgram, - 'uAmbientColor[' + this._renderer.ambientLightCount + ']'); - - var color = this._renderer._pInst.color.apply( - this._renderer._pInst, arguments); - var colors = color._array; - - gl.uniform3f( shaderProgram.uAmbientColor, - colors[0], colors[1], colors[2]); - - //in case there's no material color for the geometry - shaderProgram.uMaterialColor = gl.getUniformLocation( - shaderProgram, 'uMaterialColor' ); - gl.uniform4f( shaderProgram.uMaterialColor, 1, 1, 1, 1); - - this._renderer.ambientLightCount ++; - shaderProgram.uAmbientLightCount = - gl.getUniformLocation(shaderProgram, 'uAmbientLightCount'); - gl.uniform1i(shaderProgram.uAmbientLightCount, - this._renderer.ambientLightCount); - - 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] optional: green or saturation value - * @param {Number} [v3] optional: blue or brightness value - * @param {Number} [a] optional: opacity - * @param {Number|p5.Vector} x x axis direction or a p5.Vector - * @param {Number} [y] optional: y axis direction - * @param {Number} [z] optional: z axis direction - * @return {p5} the p5 object - * @example - *
- * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * 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); - * ambientMaterial(250); - * sphere(50); - * } - * - *
- * - * @alt - * light source on canvas changeable with mouse position - * - */ -p5.prototype.directionalLight = function(v1, v2, v3, a, x, y, z) { - var gl = this._renderer.GL; - var shaderProgram = this._renderer._getShader( - 'lightVert', 'lightTextureFrag'); - - gl.useProgram(shaderProgram); - shaderProgram.uDirectionalColor = gl.getUniformLocation( - shaderProgram, - 'uDirectionalColor[' + this._renderer.directionalLightCount + ']'); - - //@TODO: check parameters number - var color = this._renderer._pInst.color.apply( - this._renderer._pInst, [v1, v2, v3]); - var colors = color._array; - - gl.uniform3f( shaderProgram.uDirectionalColor, - colors[0], colors[1], colors[2]); - - var _x, _y, _z; - - var args = new Array(arguments.length); - for (var i = 0; i < args.length; ++i) { - args[i] = arguments[i]; - } - 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; - } - } - - shaderProgram.uLightingDirection = gl.getUniformLocation( - shaderProgram, - 'uLightingDirection[' + this._renderer.directionalLightCount + ']'); - gl.uniform3f( shaderProgram.uLightingDirection, _x, _y, _z); - - //in case there's no material color for the geometry - shaderProgram.uMaterialColor = gl.getUniformLocation( - shaderProgram, 'uMaterialColor' ); - gl.uniform4f( shaderProgram.uMaterialColor, 1, 1, 1, 1); - - this._renderer.directionalLightCount ++; - shaderProgram.uDirectionalLightCount = - gl.getUniformLocation(shaderProgram, 'uDirectionalLightCount'); - gl.uniform1i(shaderProgram.uDirectionalLightCount, - this._renderer.directionalLightCount); - - 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] optional: green or saturation value - * @param {Number} [v3] optional: blue or brightness value - * @param {Number} [a] optional: opacity - * @param {Number|p5.Vector} x x axis position or a p5.Vector - * @param {Number} [y] optional: y axis position - * @param {Number} [z] optional: z axis position - * @return {p5} the p5 object - * @example - *
- * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * 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); - * ambientMaterial(250); - * sphere(50); - * } - * - *
- * - * @alt - * spot light on canvas changes position with mouse - * - */ -p5.prototype.pointLight = function(v1, v2, v3, a, x, y, z) { - var gl = this._renderer.GL; - var shaderProgram = this._renderer._getShader( - 'lightVert', 'lightTextureFrag'); - - gl.useProgram(shaderProgram); - shaderProgram.uPointLightColor = gl.getUniformLocation( - shaderProgram, - 'uPointLightColor[' + this._renderer.pointLightCount + ']'); - - //@TODO: check parameters number - var color = this._renderer._pInst.color.apply( - this._renderer._pInst, [v1, v2, v3]); - var colors = color._array; - - gl.uniform3f( shaderProgram.uPointLightColor, - colors[0], colors[1], colors[2]); - - var _x, _y, _z; - - var args = new Array(arguments.length); - for (var i = 0; i < args.length; ++i) { - args[i] = arguments[i]; - } - 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; - } - } - - shaderProgram.uPointLightLocation = gl.getUniformLocation( - shaderProgram, - 'uPointLightLocation[' + this._renderer.pointLightCount + ']'); - gl.uniform3f( shaderProgram.uPointLightLocation, _x, _y, _z); - - //in case there's no material color for the geometry - shaderProgram.uMaterialColor = gl.getUniformLocation( - shaderProgram, 'uMaterialColor' ); - gl.uniform4f( shaderProgram.uMaterialColor, 1, 1, 1, 1); - - this._renderer.pointLightCount ++; - shaderProgram.uPointLightCount = - gl.getUniformLocation(shaderProgram, 'uPointLightCount'); - gl.uniform1i(shaderProgram.uPointLightCount, - this._renderer.pointLightCount); - - return this; -}; - -module.exports = p5; - -},{"../core/core":42}],85:[function(_dereq_,module,exports){ -/** - * @module Shape - * @submodule 3D Models - * @for p5 - * @requires core - * @requires p5.Geometry3D - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -_dereq_('./p5.Geometry'); - -/** - * Load a 3d model from an OBJ file. - *

- * 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 - * model to a scale appropriate for p5. You can also make additional changes to - * the final size of your model with the scale() function. - * - * @method loadModel - * @param {String} path Path of the model to be loaded - * @param {Boolean} [normalize] If true, scale the model to a - * standardized size when loading - * @param {Function(p5.Geometry3D)} [successCallback] Function to be called - * once the model is loaded. Will be passed - * the 3D model object. - * @param {Function(Event)} [failureCallback] called with event error if - * the image fails to load. - * @return {p5.Geometry} the p5.Geometry3D object - * @example - *
- * - * //draw a spinning teapot - * var teapot; - * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * - * teapot = loadModel('assets/teapot.obj'); - * } - * - * function draw(){ - * background(200); - * rotateX(frameCount * 0.01); - * rotateY(frameCount * 0.01); - * model(teapot); - * } - * - *
- * - * @alt - * Vertically rotating 3-d teapot with red, green and blue gradient. - * - */ -p5.prototype.loadModel = function () { - var path = arguments[0]; - var normalize; - var successCallback; - var failureCallback; - if(typeof arguments[1] === 'boolean') { - normalize = arguments[1]; - successCallback = arguments[2]; - failureCallback = arguments[3]; - } else { - normalize = false; - successCallback = arguments[1]; - failureCallback = arguments[2]; - } - - var model = new p5.Geometry(); - model.gid = path + '|' + normalize; - this.loadStrings(path, function(strings) { - parseObj(model, strings); - - if (normalize) { - model.normalize(); - } - - if (typeof successCallback === 'function') { - successCallback(model); - } - }.bind(this), failureCallback); - - return model; -}; - -/** - * Parse OBJ lines into model. For reference, this is what a simple model of a - * square might look like: - * - * v -0.5 -0.5 0.5 - * v -0.5 -0.5 -0.5 - * v -0.5 0.5 -0.5 - * v -0.5 0.5 0.5 - * - * f 4 3 2 1 - */ -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 - // UV coordinate 4 and vertex normal 3". In WebGL, every vertex with different - // parameters must be a different vertex, so loadedVerts is used to - // temporarily store the parsed vertices, normals, etc., and indexedVerts is - // 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 indexedVerts = {}; - - for (var line = 0; line < lines.length; ++line) { - // Each line is a separate object (vertex, face, vertex normal, etc) - // For each line, split it into tokens on whitespace. The first token - // describes the type. - var tokens = lines[line].trim().split(/\b\s+/); - - if (tokens.length > 0) { - 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])); - loadedVerts[tokens[0]].push(vertex); - } else if (tokens[0] === 'vt') { - // Check if this line describes a texture coordinate. - // It will have two numeric parameters. - var texVertex = [parseFloat(tokens[1]), parseFloat(tokens[2])]; - loadedVerts[tokens[0]].push(texVertex); - } else if (tokens[0] === 'f') { - // Check if this line describes a face. - // OBJ faces can have more than three points. Triangulate points. - for (var tri = 3; tri < tokens.length; ++tri) { - var face = []; - - var vertexTokens = [1, tri - 1, tri]; - - for (var tokenInd = 0; tokenInd < vertexTokens.length; ++tokenInd) { - // Now, convert the given token into an index - var vertString = tokens[vertexTokens[tokenInd]]; - var vertIndex = 0; - - // TODO: Faces can technically use negative numbers to refer to the - // previous nth vertex. I haven't seen this used in practice, but - // it might be good to implement this in the future. - - if (indexedVerts[vertString] !== undefined) { - vertIndex = indexedVerts[vertString]; - } else { - var vertParts = vertString.split('/'); - for (var i = 0; i < vertParts.length; i++) { - 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]); - } - - if (loadedVerts.vn[vertParts[2]]) { - model.vertexNormals.push(loadedVerts.vn[vertParts[2]].copy()); - } - } - - face.push(vertIndex); - } - - 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 teapot - * var teapot; - * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * - * teapot = loadModel('assets/teapot.obj'); - * } - * - * function draw(){ - * background(200); - * rotateX(frameCount * 0.01); - * rotateY(frameCount * 0.01); - * model(teapot); - * } - * - *
- * - * @alt - * Vertically rotating 3-d teapot with red, green and blue gradient. - * - */ -p5.prototype.model = function ( model ) { - if (model.vertices.length > 0) { - if (!this._renderer.geometryInHash(model.gid)) { - this._renderer.createBuffers(model.gid, model); - } - - this._renderer.drawBuffers(model.gid); - } -}; - -module.exports = p5; - -},{"../core/core":42,"./p5.Geometry":87}],86:[function(_dereq_,module,exports){ -/** - * @module Lights, Camera - * @submodule Material - * @for p5 - * @requires core - */ - -'use strict'; - -var p5 = _dereq_('../core/core'); -//require('./p5.Texture'); - -/** - * Normal material for geometry. You can view all - * possible materials in this - * example. - * @method normalMaterial - * @return {p5} the p5 object - * @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._renderer._getShader('normalVert', 'normalFrag'); - 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 - * @return {p5} the p5 object - * @example - *
- * - * var img; - * function setup(){ - * createCanvas(100, 100, WEBGL); - * img = loadImage("assets/laDefense.jpg"); - * } - * - * 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(){ - var args = new Array(arguments.length); - for (var i = 0; i < args.length; ++i) { - args[i] = arguments[i]; - } - var gl = this._renderer.GL; - var shaderProgram = this._renderer._getShader('lightVert', - 'lightTextureFrag'); - gl.useProgram(shaderProgram); - var textureData; - //if argument is not already a texture - //create a new one - if(!args[0].isTexture){ - if (args[0] instanceof p5.Image) { - textureData = args[0].canvas; - } - //if param is a video - else if (typeof p5.MediaElement !== 'undefined' && - args[0] instanceof p5.MediaElement){ - if(!args[0].loadedmetadata) {return;} - textureData = args[0].elt; - } - //used with offscreen 2d graphics renderer - else if(args[0] instanceof p5.Graphics){ - textureData = args[0].elt; - } - var tex = gl.createTexture(); - args[0]._setProperty('tex', tex); - args[0]._setProperty('isTexture', true); - this._renderer._bind.call(this, tex, textureData); - } - else { - if(args[0] instanceof p5.Graphics || - (typeof p5.MediaElement !== 'undefined' && - args[0] instanceof p5.MediaElement)){ - textureData = args[0].elt; - } - else if(args[0] instanceof p5.Image){ - textureData = args[0].canvas; - } - this._renderer._bind.call(this, args[0].tex, textureData); - } - //this is where we'd activate multi textures - //eg. gl.activeTexture(gl.TEXTURE0 + (unit || 0)); - //but for now we just have a single texture. - //@TODO need to extend this functionality - gl.activeTexture(gl.TEXTURE0); - gl.bindTexture(gl.TEXTURE_2D, args[0].tex); - gl.uniform1i(gl.getUniformLocation(shaderProgram, 'isTexture'), true); - gl.uniform1i(gl.getUniformLocation(shaderProgram, 'uSampler'), 0); - return this; -}; - -/** - * Texture Util functions - */ -p5.RendererGL.prototype._bind = function(tex, data){ - var gl = this._renderer.GL; - gl.bindTexture(gl.TEXTURE_2D, tex); - gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true); - gl.texImage2D(gl.TEXTURE_2D, 0, - gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, data); - gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true); - gl.texParameteri(gl.TEXTURE_2D, - gl.TEXTURE_MAG_FILTER, gl.LINEAR); - gl.texParameteri(gl.TEXTURE_2D, - gl.TEXTURE_MIN_FILTER, gl.LINEAR); - gl.texParameteri(gl.TEXTURE_2D, - gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE); - gl.texParameteri(gl.TEXTURE_2D, - gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE); - gl.bindTexture(gl.TEXTURE_2D, null); -}; - -/** - * Checks whether val is a pot - * more info on power of 2 here: - * https://www.opengl.org/wiki/NPOT_Texture - * @param {Number} value - * @return {Boolean} - */ -// function _isPowerOf2 (value){ -// return (value & (value - 1)) === 0; -// } - -/** - * returns the next highest power of 2 value - * @param {Number} value [description] - * @return {Number} [description] - */ -// function _nextHighestPOT (value){ -// --value; -// for (var i = 1; i < 32; i <<= 1) { -// value = value | value >> i; -// } -// return value + 1; - -/** - * 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] optional: green or saturation value - * @param {Number} [v3] optional: blue or brightness value - * @param {Number} [a] optional: opacity -* @return {p5} the p5 object - * @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 - * - */ -p5.prototype.ambientMaterial = function(v1, v2, v3, a) { - var gl = this._renderer.GL; - var shaderProgram = - this._renderer._getShader('lightVert', 'lightTextureFrag'); - - gl.useProgram(shaderProgram); - shaderProgram.uMaterialColor = gl.getUniformLocation( - shaderProgram, 'uMaterialColor' ); - var colors = this._renderer._applyColorBlend.apply(this._renderer, arguments); - - gl.uniform4f(shaderProgram.uMaterialColor, - colors[0], colors[1], colors[2], colors[3]); - - shaderProgram.uSpecular = gl.getUniformLocation( - shaderProgram, 'uSpecular' ); - gl.uniform1i(shaderProgram.uSpecular, false); - - gl.uniform1i(gl.getUniformLocation(shaderProgram, '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|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] optional: green or saturation value - * @param {Number} [v3] optional: blue or brightness value - * @param {Number} [a] optional: opacity - * @return {p5} the p5 object - * @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 - * - */ -p5.prototype.specularMaterial = function(v1, v2, v3, a) { - var gl = this._renderer.GL; - var shaderProgram = - this._renderer._getShader('lightVert', 'lightTextureFrag'); - gl.useProgram(shaderProgram); - gl.uniform1i(gl.getUniformLocation(shaderProgram, 'isTexture'), false); - shaderProgram.uMaterialColor = gl.getUniformLocation( - shaderProgram, 'uMaterialColor' ); - var colors = this._renderer._applyColorBlend.apply(this._renderer, arguments); - gl.uniform4f(shaderProgram.uMaterialColor, - colors[0], colors[1], colors[2], colors[3]); - shaderProgram.uSpecular = gl.getUniformLocation( - shaderProgram, 'uSpecular' ); - gl.uniform1i(shaderProgram.uSpecular, true); - - 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} v1 [description] - * @param {Number} v2 [description] - * @param {Number} v3 [description] - * @param {Number} a [description] - * @return {[Number]} Normalized numbers array - */ -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); - } - return colors; -}; - -module.exports = p5; - -},{"../core/core":42}],87:[function(_dereq_,module,exports){ -//some of the functions are adjusted from Three.js(http://threejs.org) - -'use strict'; - -var p5 = _dereq_('../core/core'); - -/** - * p5 Geometry class - * @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 {Function} [callback] function to call upon object instantiation. - * - */ -p5.Geometry = function -(detailX, detailY, callback){ - //an array containing every vertex - //@type [p5.Vector] - this.vertices = []; - //an array containing 1 normal per vertex - //@type [p5.Vector] - //[p5.Vector, p5.Vector, p5.Vector,p5.Vector, p5.Vector, p5.Vector,...] - this.vertexNormals = []; - //an array containing each three vertex indices that form a face - //[[0, 1, 2], [2, 1, 3], ...] - this.faces = []; - //a 2D array containing uvs for every vertex - //[[0.0,0.0],[1.0,0.0], ...] - this.uvs = []; - this.detailX = (detailX !== undefined) ? detailX: 1; - this.detailY = (detailY !== undefined) ? detailY: 1; - if(callback instanceof Function){ - callback.call(this); - } - return this; -}; - -p5.Geometry.prototype.computeFaces = function(){ - 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; - this.faces.push([a, b, d]); - this.faces.push([d, b, c]); - } - } - return this; -}; - -p5.Geometry.prototype._getFaceNormal = function(faceId,vertId){ - //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)); -}; -/** - * computes smooth normals per vertex as an average of each - * face. - */ -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)); - } - } - normal = normal.normalize(); - this.vertexNormals.push(normal); - } - return this; -}; - -/** - * Averages the vertex normals. Used in curved - * surfaces - * @return {p5.Geometry} - */ -p5.Geometry.prototype.averageNormals = function() { - - 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]); - temp = p5.Vector.div(temp, 2); - this.vertexNormals[i*offset] = temp; - this.vertexNormals[i*offset + this.detailX] = temp; - } - return this; -}; - -/** - * Averages pole normals. Used in spherical primitives - * @return {p5.Geometry} - */ -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++){ - sum.add(this.vertexNormals[i]); - } - sum = p5.Vector.div(sum, this.detailX); - - 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--){ - 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--){ - this.vertexNormals[i] = sum; - } - return this; -}; - -/** - * Modifies all vertices to be centered within the range -100 to 100. - * @return {p5.Geometry} - */ -p5.Geometry.prototype.normalize = function() { - 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++) { - 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); - minPosition.y = Math.min(minPosition.y, this.vertices[i].y); - maxPosition.z = Math.max(maxPosition.z, this.vertices[i].z); - minPosition.z = Math.min(minPosition.z, this.vertices[i].z); - } - - var center = p5.Vector.lerp(maxPosition, minPosition, 0.5); - var dist = p5.Vector.sub(maxPosition, minPosition); - var longestDist = Math.max(Math.max(dist.x, dist.y), dist.z); - var scale = 200 / longestDist; - - for(i = 0; i < this.vertices.length; i++) { - this.vertices[i].sub(center); - this.vertices[i].mult(scale); - } - } - return this; -}; - -module.exports = p5.Geometry; - -},{"../core/core":42}],88:[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 -*/ - -'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; - -/** - * A class to describe a 4x4 matrix - * for model and view matrix manipulation in the p5js webgl renderer. - * class p5.Matrix - * @constructor - * @param {Array} [mat4] array literal of our 4x4 matrix - */ -p5.Matrix = function() { - var args = new Array(arguments.length); - 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() - } 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 - ]); - } - } - return this; -}; - -/** - * 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|Array} [inMatrix] the input p5.Matrix or - * an Array of length 16 - */ -p5.Matrix.prototype.set = function (inMatrix) { - if (inMatrix instanceof p5.Matrix) { - this.mat4 = inMatrix.mat4; - return this; - } - else if (inMatrix instanceof GLMAT_ARRAY_TYPE) { - this.mat4 = inMatrix; - return this; - } - return this; -}; - -/** - * Gets a copy of the vector, returns a p5.Matrix object. - * - * @return {p5.Matrix} the copy of the p5.Matrix object - */ -p5.Matrix.prototype.get = function () { - return new p5.Matrix(this.mat4); -}; - -/** - * return a copy of a matrix - * @return {p5.Matrix} the result matrix - */ -p5.Matrix.prototype.copy = function(){ - var copied = new p5.Matrix(); - copied.mat4[0] = this.mat4[0]; - copied.mat4[1] = this.mat4[1]; - copied.mat4[2] = this.mat4[2]; - copied.mat4[3] = this.mat4[3]; - copied.mat4[4] = this.mat4[4]; - copied.mat4[5] = this.mat4[5]; - copied.mat4[6] = this.mat4[6]; - copied.mat4[7] = this.mat4[7]; - copied.mat4[8] = this.mat4[8]; - copied.mat4[9] = this.mat4[9]; - copied.mat4[10] = this.mat4[10]; - copied.mat4[11] = this.mat4[11]; - copied.mat4[12] = this.mat4[12]; - copied.mat4[13] = this.mat4[13]; - copied.mat4[14] = this.mat4[14]; - copied.mat4[15] = this.mat4[15]; - return copied; -}; - -/** - * return an identity matrix - * @return {p5.Matrix} the result matrix - */ -p5.Matrix.identity = function(){ - return new p5.Matrix(); -}; - -/** - * transpose according to a given matrix - * @param {p5.Matrix | Typed Array} a the matrix to be based on to transpose - * @return {p5.Matrix} this - */ -p5.Matrix.prototype.transpose = function(a){ - var a01, a02, a03, a12, a13, a23; - if(a instanceof p5.Matrix){ - a01 = a.mat4[1]; - a02 = a.mat4[2]; - a03 = a.mat4[3]; - a12 = a.mat4[6]; - a13 = a.mat4[7]; - a23 = a.mat4[11]; - - this.mat4[0] = a.mat4[0]; - this.mat4[1] = a.mat4[4]; - this.mat4[2] = a.mat4[8]; - this.mat4[3] = a.mat4[12]; - this.mat4[4] = a01; - this.mat4[5] = a.mat4[5]; - this.mat4[6] = a.mat4[9]; - this.mat4[7] = a.mat4[13]; - this.mat4[8] = a02; - this.mat4[9] = a12; - this.mat4[10] = a.mat4[10]; - this.mat4[11] = a.mat4[14]; - this.mat4[12] = a03; - this.mat4[13] = a13; - this.mat4[14] = a23; - this.mat4[15] = a.mat4[15]; - - }else if(a instanceof GLMAT_ARRAY_TYPE){ - a01 = a[1]; - a02 = a[2]; - a03 = a[3]; - a12 = a[6]; - a13 = a[7]; - a23 = a[11]; - - this.mat4[0] = a[0]; - this.mat4[1] = a[4]; - this.mat4[2] = a[8]; - this.mat4[3] = a[12]; - this.mat4[4] = a01; - this.mat4[5] = a[5]; - this.mat4[6] = a[9]; - this.mat4[7] = a[13]; - this.mat4[8] = a02; - this.mat4[9] = a12; - this.mat4[10] = a[10]; - this.mat4[11] = a[14]; - this.mat4[12] = a03; - this.mat4[13] = a13; - this.mat4[14] = a23; - this.mat4[15] = a[15]; - } - return this; -}; - -/** - * invert matrix according to a give matrix - * @param {p5.Matrix or Typed Array} a the matrix to be based on to invert - * @return {p5.Matrix} this - */ -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){ - a00 = a.mat4[0]; - a01 = a.mat4[1]; - a02 = a.mat4[2]; - a03 = a.mat4[3]; - a10 = a.mat4[4]; - a11 = a.mat4[5]; - a12 = a.mat4[6]; - a13 = a.mat4[7]; - a20 = a.mat4[8]; - a21 = a.mat4[9]; - a22 = a.mat4[10]; - a23 = a.mat4[11]; - a30 = a.mat4[12]; - a31 = a.mat4[13]; - a32 = a.mat4[14]; - a33 = a.mat4[15]; - }else if(a instanceof GLMAT_ARRAY_TYPE){ - a00 = a[0]; - a01 = a[1]; - a02 = a[2]; - a03 = a[3]; - a10 = a[4]; - a11 = a[5]; - a12 = a[6]; - a13 = a[7]; - a20 = a[8]; - a21 = a[9]; - a22 = a[10]; - a23 = a[11]; - a30 = a[12]; - a31 = a[13]; - 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, - - // Calculate the determinant - det = b00 * b11 - b01 * b10 + b02 * b09 + b03 * b08 - - b04 * b07 + b05 * b06; - - if (!det) { - return null; - } - det = 1.0 / det; - - this.mat4[0] = (a11 * b11 - a12 * b10 + a13 * b09) * det; - this.mat4[1] = (a02 * b10 - a01 * b11 - a03 * b09) * det; - this.mat4[2] = (a31 * b05 - a32 * b04 + a33 * b03) * det; - this.mat4[3] = (a22 * b04 - a21 * b05 - a23 * b03) * det; - this.mat4[4] = (a12 * b08 - a10 * b11 - a13 * b07) * det; - this.mat4[5] = (a00 * b11 - a02 * b08 + a03 * b07) * det; - this.mat4[6] = (a32 * b02 - a30 * b05 - a33 * b01) * det; - this.mat4[7] = (a20 * b05 - a22 * b02 + a23 * b01) * det; - this.mat4[8] = (a10 * b10 - a11 * b08 + a13 * b06) * det; - this.mat4[9] = (a01 * b08 - a00 * b10 - a03 * b06) * det; - this.mat4[10] = (a30 * b04 - a31 * b02 + a33 * b00) * det; - this.mat4[11] = (a21 * b02 - a20 * b04 - a23 * b00) * det; - this.mat4[12] = (a11 * b07 - a10 * b09 - a12 * b06) * det; - this.mat4[13] = (a00 * b09 - a01 * b07 + a02 * b06) * det; - this.mat4[14] = (a31 * b01 - a30 * b03 - a32 * b00) * det; - this.mat4[15] = (a20 * b03 - a21 * b01 + a22 * b00) * det; - - return this; -}; - -/** - * Inverts a 3x3 matrix - * @return {[type]} [description] - */ -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, - - // Calculate the determinant - det = a00 * b01 + a01 * b11 + a02 * b21; - if (!det) { - return null; - } - det = 1.0 / det; - this.mat3[0] = b01 * det; - this.mat3[1] = (-a22 * a01 + a02 * a21) * det; - this.mat3[2] = (a12 * a01 - a02 * a11) * det; - this.mat3[3] = b11 * det; - this.mat3[4] = (a22 * a00 - a02 * a20) * det; - this.mat3[5] = (-a12 * a00 + a02 * a10) * det; - this.mat3[6] = b21 * det; - this.mat3[7] = (-a21 * a00 + a01 * a20) * det; - this.mat3[8] = (a11 * a00 - a01 * a10) * det; - return this; -}; - -/** - * transposes a 3x3 p5.Matrix by a mat3 - * @param {[Number]} mat3 1-dimensional array - * @return {p5.Matrix} this - */ -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; - this.mat3[5] = mat3[7]; - this.mat3[6] = a02; - this.mat3[7] = a12; - return this; -}; - -/** - * converts a 4x4 matrix to its 3x3 inverse tranform - * commonly used in MVMatrix to NMatrix conversions. - * @param {p5.Matrix} mat4 the matrix to be based on to invert - * @return {p5.Matrix} this with mat3 - * @todo finish implementation - */ -p5.Matrix.prototype.inverseTranspose = function (matrix){ - if(this.mat3 === undefined){ - console.error('sorry, this function only works with mat3'); - } - else { - //convert mat4 -> mat3 - this.mat3[0] = matrix.mat4[0]; - this.mat3[1] = matrix.mat4[1]; - this.mat3[2] = matrix.mat4[2]; - this.mat3[3] = matrix.mat4[4]; - this.mat3[4] = matrix.mat4[5]; - this.mat3[5] = matrix.mat4[6]; - this.mat3[6] = matrix.mat4[8]; - this.mat3[7] = matrix.mat4[9]; - this.mat3[8] = matrix.mat4[10]; - } - - this.invert3x3().transpose3x3(this.mat3); - return this; -}; - -/** - * inspired by Toji's mat4 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]); - - // Calculate the determinant - return d00 * d11 - d01 * d10 + d02 * d09 + - d03 * d08 - d04 * d07 + d05 * d06; -}; - -/** - * multiply two mat4s - * @param {p5.Matrix|Array} multMatrix The matrix we want to multiply by - * @return {p5.Matrix} this - */ -p5.Matrix.prototype.mult = function(multMatrix){ - var _dest = new GLMAT_ARRAY_TYPE(16); - var _src = new GLMAT_ARRAY_TYPE(16); - - if(multMatrix instanceof p5.Matrix) { - _src = multMatrix.mat4; - } - else if(multMatrix instanceof GLMAT_ARRAY_TYPE){ - _src = multMatrix; - } - - // 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]; - - 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]; - - 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]; - - 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; - - return this; -}; - -/** - * scales a p5.Matrix by scalars or a vector - * @param {p5.Vector|Array} s vector to scale by - * @return {p5.Matrix} this - */ -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; - return this; -}; - -/** - * rotate our Matrix around an axis by the given angle. - * @param {Number} a The angle of rotation in radians - * @param {p5.Vector|Array} axis the axis(es) to rotate around - * @return {p5.Matrix} this - * inspired by Toji's gl-matrix lib, mat4 rotation - */ -p5.Matrix.prototype.rotate = function(a, axis){ - var x, y, z, _a, len; - - 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]; - } - - 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]; - var a02 = this.mat4[2]; - var a03 = this.mat4[3]; - var a10 = this.mat4[4]; - var a11 = this.mat4[5]; - var a12 = this.mat4[6]; - var a13 = this.mat4[7]; - var a20 = this.mat4[8]; - var a21 = this.mat4[9]; - var a22 = this.mat4[10]; - var a23 = this.mat4[11]; - - //sin,cos, and tan of respective angle - var sA = Math.sin(_a); - var cA = Math.cos(_a); - var tA = 1 - cA; - // Construct the elements of the rotation matrix - var b00 = x * x * tA + cA; - var b01 = y * x * tA + z * sA; - var b02 = z * x * tA - y * sA; - var b10 = x * y * tA - z * sA; - var b11 = y * y * tA + cA; - var b12 = z * y * tA + x * sA; - var b20 = x * z * tA + y * sA; - var b21 = y * z * tA - x * sA; - var b22 = z * z * tA + cA; - - // rotation-specific matrix multiplication - this.mat4[0] = a00 * b00 + a10 * b01 + a20 * b02; - this.mat4[1] = a01 * b00 + a11 * b01 + a21 * b02; - this.mat4[2] = a02 * b00 + a12 * b01 + a22 * b02; - this.mat4[3] = a03 * b00 + a13 * b01 + a23 * b02; - this.mat4[4] = a00 * b10 + a10 * b11 + a20 * b12; - this.mat4[5] = a01 * b10 + a11 * b11 + a21 * b12; - this.mat4[6] = a02 * b10 + a12 * b11 + a22 * b12; - this.mat4[7] = a03 * b10 + a13 * b11 + a23 * b12; - this.mat4[8] = a00 * b20 + a10 * b21 + a20 * b22; - this.mat4[9] = a01 * b20 + a11 * b21 + a21 * b22; - this.mat4[10] = a02 * b20 + a12 * b21 + a22 * b22; - this.mat4[11] = a03 * b20 + a13 * b21 + a23 * b22; - - return this; -}; - -/** - * @todo finish implementing this method! - * translates - * @param {Array} v vector to translate by - * @return {p5.Matrix} this - */ -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[12]; - this.mat4[13] = - this.mat4[1] * x +this.mat4[5] * y +this.mat4[9] * z +this.mat4[13]; - this.mat4[14] = - this.mat4[2] * x +this.mat4[6] * y +this.mat4[10] * z +this.mat4[14]; - this.mat4[15] = - this.mat4[3] * x +this.mat4[7] * y +this.mat4[11] * z +this.mat4[15]; -}; - -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.rotateZ = function(a){ - this.rotate(a, [0,0,1]); -}; - -/** - * sets the perspective matrix - * @param {Number} fovy [description] - * @param {Number} aspect [description] - * @param {Number} near near clipping plane - * @param {Number} far far clipping plane - * @return {void} - */ -p5.Matrix.prototype.perspective = function(fovy,aspect,near,far){ - - var f = 1.0 / Math.tan(fovy / 2), - nf = 1 / (near - far); - - this.mat4[0] = f / aspect; - this.mat4[1] = 0; - this.mat4[2] = 0; - this.mat4[3] = 0; - this.mat4[4] = 0; - this.mat4[5] = f; - this.mat4[6] = 0; - this.mat4[7] = 0; - this.mat4[8] = 0; - this.mat4[9] = 0; - this.mat4[10] = (far + near) * nf; - this.mat4[11] = -1; - this.mat4[12] = 0; - this.mat4[13] = 0; - this.mat4[14] = (2 * far * near) * nf; - this.mat4[15] = 0; - - return this; - -}; - -/** - * sets the ortho matrix - * @param {Number} left [description] - * @param {Number} right [description] - * @param {Number} bottom [description] - * @param {Number} top [description] - * @param {Number} near near clipping plane - * @param {Number} far far clipping plane - * @return {void} - */ -p5.Matrix.prototype.ortho = function(left,right,bottom,top,near,far){ - - var lr = 1 / (left - right), - bt = 1 / (bottom - top), - nf = 1 / (near - far); - this.mat4[0] = -2 * lr; - this.mat4[1] = 0; - this.mat4[2] = 0; - this.mat4[3] = 0; - this.mat4[4] = 0; - this.mat4[5] = -2 * bt; - this.mat4[6] = 0; - this.mat4[7] = 0; - this.mat4[8] = 0; - this.mat4[9] = 0; - this.mat4[10] = 2 * nf; - this.mat4[11] = 0; - this.mat4[12] = (left + right) * lr; - this.mat4[13] = (top + bottom) * bt; - this.mat4[14] = (far + near) * nf; - this.mat4[15] = 1; - - return this; -}; - -/** - * PRIVATE - */ -// matrix methods adapted from: -// https://developer.mozilla.org/en-US/docs/Web/WebGL/ -// gluPerspective -// -// function _makePerspective(fovy, aspect, znear, zfar){ -// var ymax = znear * Math.tan(fovy * Math.PI / 360.0); -// var ymin = -ymax; -// var xmin = ymin * aspect; -// var xmax = ymax * aspect; -// return _makeFrustum(xmin, xmax, ymin, ymax, znear, zfar); -// } - -//// -//// glFrustum -//// -//function _makeFrustum(left, right, bottom, top, znear, zfar){ -// var X = 2*znear/(right-left); -// var Y = 2*znear/(top-bottom); -// var A = (right+left)/(right-left); -// var B = (top+bottom)/(top-bottom); -// var C = -(zfar+znear)/(zfar-znear); -// var D = -2*zfar*znear/(zfar-znear); -// var frustrumMatrix =[ -// X, 0, A, 0, -// 0, Y, B, 0, -// 0, 0, C, D, -// 0, 0, -1, 0 -//]; -//return frustrumMatrix; -// } - -// function _setMVPMatrices(){ -////an identity matrix -////@TODO use the p5.Matrix class to abstract away our MV matrices and -///other math -//var _mvMatrix = -//[ -// 1.0,0.0,0.0,0.0, -// 0.0,1.0,0.0,0.0, -// 0.0,0.0,1.0,0.0, -// 0.0,0.0,0.0,1.0 -//]; - -module.exports = p5.Matrix; - -},{"../core/constants":41,"../core/core":42,"../math/polargeometry":72}],89:[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(). - * 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 - * geometries and buffers on the CPU to reduce the number of webgl - * draw calls. Retained mode is more efficient & performative, - * however, Immediate Mode is useful for sketching quick - * geometric ideas. - */ -'use strict'; - -var p5 = _dereq_('../core/core'); -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, - * please use p5.js geometry primitives. - * @param {Number} mode webgl primitives mode. beginShape supports the - * following modes: - * POINTS,LINES,LINE_STRIP,LINE_LOOP,TRIANGLES, - * TRIANGLE_STRIP,and TRIANGLE_FAN. - * @return {[type]} [description] - */ -p5.RendererGL.prototype.beginShape = function(mode){ - //default shape mode is 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.vertexPositions === undefined){ - this.immediateMode.vertexPositions = []; - this.immediateMode.vertexColors = []; - this.immediateMode.vertexBuffer = this.GL.createBuffer(); - this.immediateMode.colorBuffer = this.GL.createBuffer(); - } else { - this.immediateMode.vertexPositions.length = 0; - this.immediateMode.vertexColors.length = 0; - } - this.isImmediateDrawing = true; - return this; -}; -/** - * adds a vertex to be drawn in a custom Shape. - * @param {Number} x x-coordinate of vertex - * @param {Number} y y-coordinate of vertex - * @param {Number} z z-coordinate of vertex - * @return {p5.RendererGL} [description] - * @TODO implement handling of p5.Vector args - */ -p5.RendererGL.prototype.vertex = function(x, y, z){ - this.immediateMode.vertexPositions.push(x, y, z); - var vertexColor = this.curFillColor || [0.5, 0.5, 0.5, 1.0]; - this.immediateMode.vertexColors.push( - vertexColor[0], - vertexColor[1], - vertexColor[2], - vertexColor[3]); - return this; -}; - -/** - * End shape drawing and render vertices to screen. - * @return {p5.RendererGL} [description] - */ -p5.RendererGL.prototype.endShape = -function(mode, isCurve, isBezier,isQuadratic, isContour, shapeKind){ - var gl = this.GL; - this._bindImmediateBuffers( - this.immediateMode.vertexPositions, - this.immediateMode.vertexColors); - if(mode){ - if(this.drawMode === 'fill'){ - 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; - } - } - } - //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 { - gl.enable(gl.BLEND); - gl.drawArrays(this.immediateMode.shapeMode, 0, - this.immediateMode.vertexPositions.length / 3); - } - //clear out our vertexPositions & colors arrays - //after rendering - this.immediateMode.vertexPositions.length = 0; - this.immediateMode.vertexColors.length = 0; - this.isImmediateDrawing = false; - return this; -}; -/** - * Bind immediateMode buffers to data, - * then draw gl arrays - * @param {Array} vertices Numbers array representing - * vertex positions - * @return {p5.RendererGL} - */ -p5.RendererGL.prototype._bindImmediateBuffers = function(vertices, colors){ - this._setDefaultCamera(); - var gl = this.GL; - var shaderKey = this._getCurShaderId(); - var shaderProgram = this.mHash[shaderKey]; - //vertex position Attribute - shaderProgram.vertexPositionAttribute = - gl.getAttribLocation(shaderProgram, 'aPosition'); - gl.enableVertexAttribArray(shaderProgram.vertexPositionAttribute); - gl.bindBuffer(gl.ARRAY_BUFFER, this.immediateMode.vertexBuffer); - gl.bufferData( - gl.ARRAY_BUFFER, new Float32Array(vertices), gl.DYNAMIC_DRAW); - gl.vertexAttribPointer(shaderProgram.vertexPositionAttribute, - 3, gl.FLOAT, false, 0, 0); - - shaderProgram.vertexColorAttribute = - gl.getAttribLocation(shaderProgram, 'aVertexColor'); - gl.enableVertexAttribArray(shaderProgram.vertexColorAttribute); - gl.bindBuffer(gl.ARRAY_BUFFER, this.immediateMode.colorBuffer); - gl.bufferData(gl.ARRAY_BUFFER, - new Float32Array(colors),gl.DYNAMIC_DRAW); - gl.vertexAttribPointer(shaderProgram.vertexColorAttribute, - 4, gl.FLOAT, false, 0, 0); - //matrix - this._setMatrixUniforms(shaderKey); - //@todo implement in all shaders (not just immediateVert) - //set our default point size - // this._setUniform1f(shaderKey, - // 'uPointSize', - // this.pointSize); - return this; -}; - -////////////////////////////////////////////// -// COLOR -////////////////////////////////////////////// - -p5.RendererGL.prototype._getColorVertexShader = function(){ - var gl = this.GL; - var mId = 'immediateVert|vertexColorFrag'; - var shaderProgram; - - if(!this.materialInHash(mId)){ - shaderProgram = - this._initShaders('immediateVert', 'vertexColorFrag', true); - this.mHash[mId] = shaderProgram; - shaderProgram.vertexColorAttribute = - gl.getAttribLocation(shaderProgram, 'aVertexColor'); - gl.enableVertexAttribArray(shaderProgram.vertexColorAttribute); - }else{ - shaderProgram = this.mHash[mId]; - } - return shaderProgram; -}; - -module.exports = p5.RendererGL; -},{"../core/constants":41,"../core/core":42}],90:[function(_dereq_,module,exports){ -//Retained Mode. The default mode for rendering 3D primitives -//in WEBGL. -'use strict'; - -var p5 = _dereq_('../core/core'); -var hashCount = 0; -/** - * _initBufferDefaults - * @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) { - //@TODO remove this limit on hashes in gHash - hashCount ++; - if(hashCount > 1000){ - var key = Object.keys(this.gHash)[0]; - delete this.gHash[key]; - 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].uvBuffer = gl.createBuffer(); - this.gHash[gId].indexBuffer = gl.createBuffer(); -}; -/** - * createBuffers description - * @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); - //return the current shaderProgram from our material hash - var shaderProgram = this.mHash[this._getCurShaderId()]; - //@todo rename "numberOfItems" property to something more descriptive - //we mult the num geom faces by 3 - this.gHash[gId].numberOfItems = obj.faces.length * 3; - gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].vertexBuffer); - gl.bufferData( - gl.ARRAY_BUFFER, - new Float32Array( vToNArray(obj.vertices) ), - gl.STATIC_DRAW); - //vertex position - shaderProgram.vertexPositionAttribute = - gl.getAttribLocation(shaderProgram, 'aPosition'); - gl.enableVertexAttribArray(shaderProgram.vertexPositionAttribute); - - gl.vertexAttribPointer( - shaderProgram.vertexPositionAttribute, - 3, gl.FLOAT, false, 0, 0); - - gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].normalBuffer); - gl.bufferData( - gl.ARRAY_BUFFER, - new Float32Array( vToNArray(obj.vertexNormals) ), - gl.STATIC_DRAW); - //vertex normal - shaderProgram.vertexNormalAttribute = - gl.getAttribLocation(shaderProgram, 'aNormal'); - gl.enableVertexAttribArray(shaderProgram.vertexNormalAttribute); - - gl.vertexAttribPointer( - shaderProgram.vertexNormalAttribute, - 3, gl.FLOAT, false, 0, 0); - - gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].uvBuffer); - gl.bufferData( - gl.ARRAY_BUFFER, - new Float32Array( flatten(obj.uvs) ), - gl.STATIC_DRAW); - //texture coordinate Attribute - shaderProgram.textureCoordAttribute = - gl.getAttribLocation(shaderProgram, 'aTexCoord'); - gl.enableVertexAttribArray(shaderProgram.textureCoordAttribute); - gl.vertexAttribPointer( - shaderProgram.textureCoordAttribute, - 2, gl.FLOAT, false, 0, 0); - - gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, this.gHash[gId].indexBuffer); - gl.bufferData( - gl.ELEMENT_ARRAY_BUFFER, - new Uint16Array( flatten(obj.faces) ), - gl.STATIC_DRAW); -}; - -/** - * Draws buffers given a geometry key ID - * @param {String} gId ID in our geom hash - * @return {p5.RendererGL} this - */ -p5.RendererGL.prototype.drawBuffers = function(gId) { - this._setDefaultCamera(); - var gl = this.GL; - var shaderKey = this._getCurShaderId(); - var shaderProgram = this.mHash[shaderKey]; - //vertex position buffer - gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].vertexBuffer); - gl.vertexAttribPointer( - shaderProgram.vertexPositionAttribute, - 3, gl.FLOAT, false, 0, 0); - //normal buffer - gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].normalBuffer); - gl.vertexAttribPointer( - shaderProgram.vertexNormalAttribute, - 3, gl.FLOAT, false, 0, 0); - // uv buffer - gl.bindBuffer(gl.ARRAY_BUFFER, this.gHash[gId].uvBuffer); - gl.vertexAttribPointer( - shaderProgram.textureCoordAttribute, - 2, gl.FLOAT, false, 0, 0); - //vertex index buffer - gl.bindBuffer(gl.ELEMENT_ARRAY_BUFFER, this.gHash[gId].indexBuffer); - this._setMatrixUniforms(shaderKey); - gl.drawElements( - gl.TRIANGLES, this.gHash[gId].numberOfItems, - gl.UNSIGNED_SHORT, 0); - return this; -}; -/////////////////////////////// -//// UTILITY FUNCTIONS -////////////////////////////// -/** - * turn a two dimensional array into one dimensional array - * @param {Array} arr 2-dimensional array - * @return {Array} 1-dimensional array - * [[1, 2, 3],[4, 5, 6]] -> [1, 2, 3, 4, 5, 6] - */ -function flatten(arr){ - if (arr.length>0){ - return arr.reduce(function(a, b){ - return a.concat(b); - }); - } else { - return []; - } -} - -/** - * 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 - * [p5.Vector(1, 2, 3), p5.Vector(4, 5, 6)] -> - * [1, 2, 3, 4, 5, 6] - */ -function vToNArray(arr){ - return flatten(arr.map(function(item){ - return [item.x, item.y, item.z]; - })); -} -module.exports = p5.RendererGL; - -},{"../core/core":42}],91:[function(_dereq_,module,exports){ -'use strict'; - -var p5 = _dereq_('../core/core'); -var shader = _dereq_('./shader'); -_dereq_('../core/p5.Renderer'); -_dereq_('./p5.Matrix'); -var uMVMatrixStack = []; - -//@TODO should implement public method -//to override these attributes -var attributes = { - alpha: true, - depth: true, - stencil: true, - antialias: false, - premultipliedAlpha: false, - preserveDrawingBuffer: false -}; - -/** - * 3D graphics class - * @class p5.RendererGL - * @constructor - * @extends p5.Renderer - * @todo extend class to include public method for offscreen - * rendering (FBO). - * - */ -p5.RendererGL = function(elt, pInst, isMainCanvas) { - p5.Renderer.call(this, elt, pInst, isMainCanvas); - 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; - //camera - this._curCamera = null; - - /** - * model view, projection, & normal - * matrices - */ - this.uMVMatrix = new p5.Matrix(); - this.uPMatrix = new p5.Matrix(); - this.uNMatrix = new p5.Matrix('mat3'); - //Geometry & Material hashes - this.gHash = {}; - this.mHash = {}; - //Imediate Mode - //default drawing is done in Retained Mode - this.isImmediateDrawing = false; - this.immediateMode = {}; - this.curFillColor = [0.5,0.5,0.5,1.0]; - this.curStrokeColor = [0.5,0.5,0.5,1.0]; - this.pointSize = 5.0;//default point/stroke - return this; -}; - -p5.RendererGL.prototype = Object.create(p5.Renderer.prototype); - -////////////////////////////////////////////// -// Setting -////////////////////////////////////////////// - -p5.RendererGL.prototype._initContext = function() { - try { - this.drawingContext = this.canvas.getContext('webgl', attributes) || - this.canvas.getContext('experimental-webgl', attributes); - if (this.drawingContext === null) { - throw new Error('Error creating webgl context'); - } else { - console.log('p5.RendererGL: enabled webgl context'); - var gl = this.drawingContext; - gl.enable(gl.DEPTH_TEST); - gl.depthFunc(gl.LEQUAL); - gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight); - } - } catch (er) { - throw new Error(er); - } -}; -//detect if user didn't set the camera -//then call this function below -p5.RendererGL.prototype._setDefaultCamera = function(){ - if(this._curCamera === null){ - var _w = this.width; - var _h = this.height; - this.uPMatrix = p5.Matrix.identity(); - var cameraZ = (this.height / 2) / Math.tan(Math.PI * 30 / 180); - this.uPMatrix.perspective(60 / 180 * Math.PI, _w / _h, - cameraZ * 0.1, cameraZ * 10); - this._curCamera = 'default'; - } -}; - -p5.RendererGL.prototype._update = function() { - this.uMVMatrix = p5.Matrix.identity(); - this.translate(0, 0, -(this.height / 2) / Math.tan(Math.PI * 30 / 180)); - this.ambientLightCount = 0; - this.directionalLightCount = 0; - this.pointLightCount = 0; -}; - -/** - * [background description] - * @return {[type]} [description] - */ -p5.RendererGL.prototype.background = function() { - var gl = this.GL; - 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; - gl.clearColor(_r, _g, _b, _a); - gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT); -}; - -//@TODO implement this -// p5.RendererGL.prototype.clear = function() { -//@TODO -// }; - -////////////////////////////////////////////// -// SHADER -////////////////////////////////////////////// - -/** - * [_initShaders description] - * @param {string} vertId [description] - * @param {string} fragId [description] - * @return {[type]} [description] - */ -p5.RendererGL.prototype._initShaders = -function(vertId, fragId, isImmediateMode) { - var gl = this.GL; - //set up our default shaders by: - // 1. create the shader, - // 2. load the shader source, - // 3. compile the shader - var _vertShader = gl.createShader(gl.VERTEX_SHADER); - //load in our default vertex shader - gl.shaderSource(_vertShader, shader[vertId]); - gl.compileShader(_vertShader); - // if our vertex shader failed compilation? - if (!gl.getShaderParameter(_vertShader, gl.COMPILE_STATUS)) { - alert('Yikes! An error occurred compiling the shaders:' + - gl.getShaderInfoLog(_vertShader)); - return null; - } - - var _fragShader = gl.createShader(gl.FRAGMENT_SHADER); - //load in our material frag shader - gl.shaderSource(_fragShader, shader[fragId]); - gl.compileShader(_fragShader); - // if our frag shader failed compilation? - if (!gl.getShaderParameter(_fragShader, gl.COMPILE_STATUS)) { - alert('Darn! An error occurred compiling the shaders:' + - gl.getShaderInfoLog(_fragShader)); - return null; - } - - var shaderProgram = gl.createProgram(); - gl.attachShader(shaderProgram, _vertShader); - gl.attachShader(shaderProgram, _fragShader); - gl.linkProgram(shaderProgram); - if (!gl.getProgramParameter(shaderProgram, gl.LINK_STATUS)) { - alert('Snap! Error linking shader program'); - } - //END SHADERS SETUP - - this._getLocation(shaderProgram, isImmediateMode); - - return shaderProgram; -}; - -p5.RendererGL.prototype._getLocation = -function(shaderProgram, isImmediateMode) { - var gl = this.GL; - gl.useProgram(shaderProgram); - - //projection Matrix uniform - shaderProgram.uPMatrixUniform = - gl.getUniformLocation(shaderProgram, 'uProjectionMatrix'); - //model view Matrix uniform - shaderProgram.uMVMatrixUniform = - gl.getUniformLocation(shaderProgram, 'uModelViewMatrix'); - - //@TODO: figure out a better way instead of if statement - if(isImmediateMode === undefined){ - //normal Matrix uniform - shaderProgram.uNMatrixUniform = - gl.getUniformLocation(shaderProgram, 'uNormalMatrix'); - - shaderProgram.samplerUniform = - gl.getUniformLocation(shaderProgram, 'uSampler'); - } -}; - -/** - * Sets a shader uniform given a shaderProgram and uniform string - * @param {String} shaderKey key to material Hash. - * @param {String} uniform location in shader. - * @param { Number} data data to bind uniform. Float data type. - * @todo currently this function sets uniform1f data. - * Should generalize function to accept any uniform - * data type. - */ -p5.RendererGL.prototype._setUniform1f = function(shaderKey,uniform,data) -{ - var gl = this.GL; - var shaderProgram = this.mHash[shaderKey]; - gl.useProgram(shaderProgram); - shaderProgram[uniform] = gl.getUniformLocation(shaderProgram, uniform); - gl.uniform1f(shaderProgram[uniform], data); - return this; -}; - -p5.RendererGL.prototype._setMatrixUniforms = function(shaderKey) { - var gl = this.GL; - var shaderProgram = this.mHash[shaderKey]; - - gl.useProgram(shaderProgram); - - gl.uniformMatrix4fv( - shaderProgram.uPMatrixUniform, - false, this.uPMatrix.mat4); - - gl.uniformMatrix4fv( - shaderProgram.uMVMatrixUniform, - false, this.uMVMatrix.mat4); - - this.uNMatrix.inverseTranspose(this.uMVMatrix); - - gl.uniformMatrix3fv( - shaderProgram.uNMatrixUniform, - false, this.uNMatrix.mat3); -}; -////////////////////////////////////////////// -// GET CURRENT | for shader and color -////////////////////////////////////////////// -p5.RendererGL.prototype._getShader = function(vertId, fragId, isImmediateMode) { - var mId = vertId + '|' + fragId; - //create it and put it into hashTable - if(!this.materialInHash(mId)){ - var shaderProgram = this._initShaders(vertId, fragId, isImmediateMode); - this.mHash[mId] = shaderProgram; - } - this.curShaderId = mId; - - return this.mHash[this.curShaderId]; -}; - -p5.RendererGL.prototype._getCurShaderId = function(){ - //if the shader ID is not yet defined - var mId, shaderProgram; - if(this.drawMode !== 'fill' && this.curShaderId === undefined){ - //default shader: normalMaterial() - mId = 'normalVert|normalFrag'; - shaderProgram = this._initShaders('normalVert', 'normalFrag'); - this.mHash[mId] = shaderProgram; - this.curShaderId = mId; - } else if(this.isImmediateDrawing && this.drawMode === 'fill'){ - mId = 'immediateVert|vertexColorFrag'; - shaderProgram = this._initShaders('immediateVert', 'vertexColorFrag'); - this.mHash[mId] = shaderProgram; - this.curShaderId = mId; - } - return this.curShaderId; -}; - -////////////////////////////////////////////// -// COLOR -////////////////////////////////////////////// -/** - * Basic fill material for geometry with a given color - * @method fill - * @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] optional: green or saturation value - * @param {Number} [v3] optional: blue or brightness value - * @param {Number} [a] optional: opacity - * @return {p5} the p5 object - * @example - *
- * - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * - * function draw(){ - * background(0); - * fill(250, 0, 0); - * rotateX(frameCount * 0.01); - * rotateY(frameCount * 0.01); - * rotateZ(frameCount * 0.01); - * box(200, 200, 200); - * } - * - *
- * - * @alt - * red canvas - * - */ -p5.RendererGL.prototype.fill = function(v1, v2, v3, a) { - var gl = this.GL; - var shaderProgram; - //see material.js for more info on color blending in webgl - var colors = this._applyColorBlend.apply(this, arguments); - this.curFillColor = colors; - this.drawMode = 'fill'; - if(this.isImmediateDrawing){ - shaderProgram = - this._getShader('immediateVert','vertexColorFrag'); - gl.useProgram(shaderProgram); - } else { - shaderProgram = - this._getShader('normalVert', 'basicFrag'); - gl.useProgram(shaderProgram); - //RetainedMode uses a webgl uniform to pass color vals - //in ImmediateMode, we want access to each vertex so therefore - //we cannot use a uniform. - shaderProgram.uMaterialColor = gl.getUniformLocation( - shaderProgram, 'uMaterialColor' ); - gl.uniform4f( shaderProgram.uMaterialColor, - colors[0], - colors[1], - colors[2], - colors[3]); - } - return this; -}; -p5.RendererGL.prototype.stroke = function(r, g, b, a) { - var color = this._pInst.color.apply(this._pInst, arguments); - var colorNormalized = color._array; - this.curStrokeColor = colorNormalized; - this.drawMode = 'stroke'; - return this; -}; - -//@TODO -p5.RendererGL.prototype._strokeCheck = function(){ - if(this.drawMode === 'stroke'){ - throw new Error( - 'stroke for shapes in 3D not yet implemented, use fill for now :(' - ); - } -}; - -/** - * [strokeWeight description] - * @param {Number} pointSize stroke point size - * @return {[type]} [description] - * @todo strokeWeight currently works on points only. - * implement on all wireframes and strokes. - */ -p5.RendererGL.prototype.strokeWeight = function(pointSize) { - this.pointSize = pointSize; - return this; -}; -////////////////////////////////////////////// -// HASH | for material and geometry -////////////////////////////////////////////// - -p5.RendererGL.prototype.geometryInHash = function(gId){ - return this.gHash[gId] !== undefined; -}; - -p5.RendererGL.prototype.materialInHash = function(mId){ - return this.mHash[mId] !== undefined; -}; - -/** - * [resize description] - * @param {[type]} w [description] - * @param {[tyoe]} h [description] - * @return {[type]} [description] - */ -p5.RendererGL.prototype.resize = function(w,h) { - var gl = this.GL; - p5.Renderer.prototype.resize.call(this, w, h); - gl.viewport(0, 0, gl.drawingBufferWidth, gl.drawingBufferHeight); - // If we're using the default camera, update the aspect ratio - if(this._curCamera === 'default') { - this._curCamera = null; - this._setDefaultCamera(); - } -}; - -/** - * clears color and depth buffers - * with r,g,b,a - * @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() { - var gl = this.GL; - gl.clearColor(arguments[0], - arguments[1], - arguments[2], - arguments[3]); - gl.clear(gl.COLOR_BUFFER_BIT | gl.DEPTH_BUFFER_BIT); -}; - -/** - * [translate description] - * @param {[type]} x [description] - * @param {[type]} y [description] - * @param {[type]} z [description] - * @return {[type]} [description] - * @todo implement handle for components or vector as args - */ -p5.RendererGL.prototype.translate = function(x, y, z) { - this.uMVMatrix.translate([x,-y,z]); - return this; -}; - -/** - * Scales the Model View Matrix by a vector - * @param {Number | p5.Vector | Array} x [description] - * @param {Number} [y] y-axis scalar - * @param {Number} [z] z-axis scalar - * @return {this} [description] - */ -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); - return this; -}; - -p5.RendererGL.prototype.rotateX = function(rad) { - this.rotate(rad, [1,0,0]); - return this; -}; - -p5.RendererGL.prototype.rotateY = function(rad) { - this.rotate(rad, [0,1,0]); - return this; -}; - -p5.RendererGL.prototype.rotateZ = function(rad) { - 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()); -}; - -/** - * [pop description] - * @return {[type]} [description] - */ -p5.RendererGL.prototype.pop = function() { - if (uMVMatrixStack.length === 0) { - throw new Error('Invalid popMatrix!'); - } - this.uMVMatrix = uMVMatrixStack.pop(); -}; - -p5.RendererGL.prototype.resetMatrix = function() { - this.uMVMatrix = p5.Matrix.identity(); - this.translate(0, 0, -800); - return this; -}; - -// Text/Typography -// @TODO: -p5.RendererGL.prototype._applyTextProperties = function() { - //@TODO finish implementation - console.error('text commands not yet implemented in webgl'); -}; -module.exports = p5.RendererGL; - -},{"../core/core":42,"../core/p5.Renderer":48,"./p5.Matrix":88,"./shader":93}],92:[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(); - 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 - * @return {p5} the p5 object - * @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 - ]; - 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]); - } - }; - var boxGeom = new p5.Geometry(detailX,detailY, _box); - boxGeom.computeNormals(); - //initialize our geometry buffer with - //the key val pair: - //geometry Id, Geom object - this._renderer.createBuffers(gId, boxGeom); - } - this._renderer.drawBuffers(gId); - - return this; - -}; - -/** - * Draw a sphere with given radius - * @method sphere - * @param {Number} radius radius of circle - * @param {Number} [detailX] optional: number of segments, - * the more segments the smoother geometry - * default is 24 - * @param {Number} [detailY] optional: number of segments, - * the more segments the smoother geometry - * default is 16 - * @return {p5} the p5 object - * @example - *
- * - * // draw a sphere with radius 200 - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * - * function draw(){ - * background(200); - * sphere(50); - * } - * - *
- */ -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(); - this._renderer.createBuffers(gId, sphereGeom); - } - this._renderer.drawBuffers(gId); - - 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]); - } - } -}; - -/** - * 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] optional: number of segments, - * the more segments the smoother geometry - * default is 24 - * @param {Number} [detailY] optional: number of segments in y-dimension, - * the more segments the smoother geometry - * default is 16 - * @return {p5} the p5 object - * @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); - * } - * - *
- */ -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(); - this._renderer.createBuffers(gId, cylinderGeom); - } - - this._renderer.drawBuffers(gId); - - return this; -}; - - -/** - * 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] optional: number of segments, - * the more segments the smoother geometry - * default is 24 - * @param {Number} [detailY] optional: number of segments, - * the more segments the smoother geometry - * default is 16 - * @return {p5} the p5 object - * @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); - * } - * - *
- */ -p5.prototype.cone = function(){ - var args = new Array(arguments.length); - for (var i = 0; i < args.length; ++i) { - args[i] = arguments[i]; - } - 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(); - this._renderer.createBuffers(gId, coneGeom); - } - - this._renderer.drawBuffers(gId); - - return this; -}; - -/** - * 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] optional: 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] optional: number of segments, - * the more segments the smoother geometry - * default is 16. Avoid detail number above - * 150, it may crash the browser. - * @return {p5} the p5 object - * @example - *
- * - * // draw an ellipsoid with radius 20, 30 and 40. - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * - * function draw(){ - * background(200); - * ellipsoid(20, 30, 40); - * } - * - *
- */ -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; - - - 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]); - } - } - }; - var ellipsoidGeom = new p5.Geometry(detailX, detailY,_ellipsoid); - ellipsoidGeom - .computeFaces() - .computeNormals(); - this._renderer.createBuffers(gId, ellipsoidGeom); - } - - this._renderer.drawBuffers(gId); - - return this; -}; - -/** - * 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] optional: number of segments in x-dimension, - * the more segments the smoother geometry - * default is 24 - * @param {Number} [detailY] optional: number of segments in y-dimension, - * the more segments the smoother geometry - * default is 16 - * @return {p5} the p5 object - * @example - *
- * - * //draw a spinning torus with radius 200 and tube radius 60 - * function setup(){ - * createCanvas(100, 100, WEBGL); - * } - * - * function draw(){ - * background(200); - * rotateX(frameCount * 0.01); - * rotateY(frameCount * 0.01); - * torus(200, 60); - * } - * - *
- */ -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 radius = args[0] || 50; - var tubeRadius = args[1] || 10; - - var gId = 'torus|'+radius+'|'+tubeRadius+'|'+detailX+'|'+detailY; - - 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 torusGeom = new p5.Geometry(detailX, detailY, _torus); - torusGeom - .computeFaces() - .computeNormals() - .averageNormals(); - this._renderer.createBuffers(gId, torusGeom); - } - - this._renderer.drawBuffers(gId); - - return this; -}; - -/////////////////////// -/// 2D primitives -///////////////////////// - -//@TODO -p5.RendererGL.prototype.point = function(x, y, z){ - console.log('point not yet implemented in webgl'); - 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|'+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.vertices = vertices; - this.faces = [[0,1,2]]; - this.uvs = [[0,0],[0,1],[1,1]]; - }; - var triGeom = new p5.Geometry(1,1,_triangle); - triGeom.computeNormals(); - this.createBuffers(gId, triGeom); - } - - this.drawBuffers(gId); - return this; -}; - -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); - } - 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); - } - this.vertices.push(p); - this.uvs.push([u,v]); - } - } - }; - var ellipseGeom = new p5.Geometry(detailX,detailY,_ellipse); - ellipseGeom - .computeFaces() - .computeNormals(); - this.createBuffers(gId, ellipseGeom); - } - this.drawBuffers(gId); - return this; -}; - -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]); - } - } - }; - var rectGeom = new p5.Geometry(detailX,detailY,_rect); - rectGeom - .computeFaces() - .computeNormals(); - this.createBuffers(gId, rectGeom); - } - this.drawBuffers(gId); - return this; -}; - -p5.RendererGL.prototype.quad = function(){ - var args = new Array(arguments.length); - for (var i = 0; i < args.length; ++i) { - args[i] = arguments[i]; - } - 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]); - }; - var quadGeom = new p5.Geometry(2,2,_quad); - quadGeom.computeNormals(); - 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 -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]); - } - 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]); - } - this.endShape(); - return this; -}; - -module.exports = p5; - -},{"../core/core":42,"./p5.Geometry":87}],93:[function(_dereq_,module,exports){ - - -module.exports = { - 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 * vec3(1.0, -1.0, 1.0), 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 * vec3(1.0, -1.0, 1.0), 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 * vec3(1.0, -1.0, 1.0), 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;\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(vLightWeighting == vec3(0., 0., 0.)){\n gl_FragColor = textureColor;\n }else{\n gl_FragColor = vec4(vec3(textureColor.rgb * vLightWeighting), textureColor.a);\n }\n }\n}" -}; -},{}]},{},[33])(33) -}); diff --git a/examples/neuroevolution-flappybird-1/libraries/p5.sound.js b/examples/neuroevolution-flappybird-1/libraries/p5.sound.js deleted file mode 100644 index f3a9eb5..0000000 --- a/examples/neuroevolution-flappybird-1/libraries/p5.sound.js +++ /dev/null @@ -1,9336 +0,0 @@ -/*! p5.sound.js v0.3.2 2016-11-01 */ -(function (root, factory) { - if (typeof define === 'function' && define.amd) - define('p5.sound', ['p5'], function (p5) { (factory(p5));}); - else if (typeof exports === 'object') - factory(require('../p5')); - else - factory(root['p5']); -}(this, function (p5) { - /** - * p5.sound extends p5 with Web Audio functionality including audio input, - * playback, analysis and synthesis. - *

- * p5.SoundFile: Load and play sound files.
- * p5.Amplitude: Get the current volume of a sound.
- * p5.AudioIn: Get sound from an input source, typically - * a computer microphone.
- * p5.FFT: Analyze the frequency of sound. Returns - * results from the frequency spectrum or time domain (waveform).
- * p5.Oscillator: Generate Sine, - * Triangle, Square and Sawtooth waveforms. Base class of - * p5.Noise and p5.Pulse. - *
- * p5.Env: An Envelope is a series - * of fades over time. Often used to control an object's - * output gain level as an "ADSR Envelope" (Attack, Decay, - * Sustain, Release). Can also modulate other parameters.
- * p5.Delay: A delay effect with - * parameters for feedback, delayTime, and lowpass filter.
- * p5.Filter: Filter the frequency range of a - * sound. - *
- * p5.Reverb: Add reverb to a sound by specifying - * duration and decay.
- * p5.Convolver: Extends - * p5.Reverb to simulate the sound of real - * physical spaces through convolution.
- * p5.SoundRecorder: Record sound for playback - * / save the .wav file. - * p5.Phrase, p5.Part and - * p5.Score: Compose musical sequences. - *

- * p5.sound is on GitHub. - * Download the latest version - * here. - * - * @module p5.sound - * @submodule p5.sound - * @for p5.sound - * @main - */ -/** - * p5.sound developed by Jason Sigal for the Processing Foundation, Google Summer of Code 2014. The MIT License (MIT). - * - * http://github.com/therewasaguy/p5.sound - * - * Some of the many audio libraries & resources that inspire p5.sound: - * - TONE.js (c) Yotam Mann, 2014. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js - * - buzz.js (c) Jay Salvat, 2013. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/ - * - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0 - * - wavesurfer.js https://github.com/katspaugh/wavesurfer.js - * - Web Audio Components by Jordan Santell https://github.com/web-audio-components - * - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound - * - * Web Audio API: http://w3.org/TR/webaudio/ - */ -var sndcore; -sndcore = function () { - 'use strict'; - /* AudioContext Monkeypatch - Copyright 2013 Chris Wilson - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - http://www.apache.org/licenses/LICENSE-2.0 - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. - */ - (function (global, exports, perf) { - exports = exports || {}; - 'use strict'; - function fixSetTarget(param) { - if (!param) - // if NYI, just return - return; - if (!param.setTargetAtTime) - param.setTargetAtTime = param.setTargetValueAtTime; - } - if (window.hasOwnProperty('webkitAudioContext') && !window.hasOwnProperty('AudioContext')) { - window.AudioContext = webkitAudioContext; - if (typeof AudioContext.prototype.createGain !== 'function') - AudioContext.prototype.createGain = AudioContext.prototype.createGainNode; - if (typeof AudioContext.prototype.createDelay !== 'function') - AudioContext.prototype.createDelay = AudioContext.prototype.createDelayNode; - if (typeof AudioContext.prototype.createScriptProcessor !== 'function') - AudioContext.prototype.createScriptProcessor = AudioContext.prototype.createScriptProcessor; - if (typeof AudioContext.prototype.createPeriodicWave !== 'function') - AudioContext.prototype.createPeriodicWave = AudioContext.prototype.createWaveTable; - AudioContext.prototype.internal_createGain = AudioContext.prototype.createGain; - AudioContext.prototype.createGain = function () { - var node = this.internal_createGain(); - fixSetTarget(node.gain); - return node; - }; - AudioContext.prototype.internal_createDelay = AudioContext.prototype.createDelay; - AudioContext.prototype.createDelay = function (maxDelayTime) { - var node = maxDelayTime ? this.internal_createDelay(maxDelayTime) : this.internal_createDelay(); - fixSetTarget(node.delayTime); - return node; - }; - AudioContext.prototype.internal_createBufferSource = AudioContext.prototype.createBufferSource; - AudioContext.prototype.createBufferSource = function () { - var node = this.internal_createBufferSource(); - if (!node.start) { - node.start = function (when, offset, duration) { - if (offset || duration) - this.noteGrainOn(when || 0, offset, duration); - else - this.noteOn(when || 0); - }; - } else { - node.internal_start = node.start; - node.start = function (when, offset, duration) { - if (typeof duration !== 'undefined') - node.internal_start(when || 0, offset, duration); - else - node.internal_start(when || 0, offset || 0); - }; - } - if (!node.stop) { - node.stop = function (when) { - this.noteOff(when || 0); - }; - } else { - node.internal_stop = node.stop; - node.stop = function (when) { - node.internal_stop(when || 0); - }; - } - fixSetTarget(node.playbackRate); - return node; - }; - AudioContext.prototype.internal_createDynamicsCompressor = AudioContext.prototype.createDynamicsCompressor; - AudioContext.prototype.createDynamicsCompressor = function () { - var node = this.internal_createDynamicsCompressor(); - fixSetTarget(node.threshold); - fixSetTarget(node.knee); - fixSetTarget(node.ratio); - fixSetTarget(node.reduction); - fixSetTarget(node.attack); - fixSetTarget(node.release); - return node; - }; - AudioContext.prototype.internal_createBiquadFilter = AudioContext.prototype.createBiquadFilter; - AudioContext.prototype.createBiquadFilter = function () { - var node = this.internal_createBiquadFilter(); - fixSetTarget(node.frequency); - fixSetTarget(node.detune); - fixSetTarget(node.Q); - fixSetTarget(node.gain); - return node; - }; - if (typeof AudioContext.prototype.createOscillator !== 'function') { - AudioContext.prototype.internal_createOscillator = AudioContext.prototype.createOscillator; - AudioContext.prototype.createOscillator = function () { - var node = this.internal_createOscillator(); - if (!node.start) { - node.start = function (when) { - this.noteOn(when || 0); - }; - } else { - node.internal_start = node.start; - node.start = function (when) { - node.internal_start(when || 0); - }; - } - if (!node.stop) { - node.stop = function (when) { - this.noteOff(when || 0); - }; - } else { - node.internal_stop = node.stop; - node.stop = function (when) { - node.internal_stop(when || 0); - }; - } - if (!node.setPeriodicWave) - node.setPeriodicWave = node.setWaveTable; - fixSetTarget(node.frequency); - fixSetTarget(node.detune); - return node; - }; - } - } - if (window.hasOwnProperty('webkitOfflineAudioContext') && !window.hasOwnProperty('OfflineAudioContext')) { - window.OfflineAudioContext = webkitOfflineAudioContext; - } - return exports; - }(window)); - // <-- end MonkeyPatch. - // Create the Audio Context - var audiocontext = new window.AudioContext(); - /** - *

Returns the Audio Context for this sketch. Useful for users - * who would like to dig deeper into the Web Audio API - * .

- * - * @method getAudioContext - * @return {Object} AudioContext for this sketch - */ - p5.prototype.getAudioContext = function () { - return audiocontext; - }; - // Polyfill for AudioIn, also handled by p5.dom createCapture - navigator.getUserMedia = navigator.getUserMedia || navigator.webkitGetUserMedia || navigator.mozGetUserMedia || navigator.msGetUserMedia; - /** - * Determine which filetypes are supported (inspired by buzz.js) - * The audio element (el) will only be used to test browser support for various audio formats - */ - var el = document.createElement('audio'); - p5.prototype.isSupported = function () { - return !!el.canPlayType; - }; - var isOGGSupported = function () { - return !!el.canPlayType && el.canPlayType('audio/ogg; codecs="vorbis"'); - }; - var isMP3Supported = function () { - return !!el.canPlayType && el.canPlayType('audio/mpeg;'); - }; - var isWAVSupported = function () { - return !!el.canPlayType && el.canPlayType('audio/wav; codecs="1"'); - }; - var isAACSupported = function () { - return !!el.canPlayType && (el.canPlayType('audio/x-m4a;') || el.canPlayType('audio/aac;')); - }; - var isAIFSupported = function () { - return !!el.canPlayType && el.canPlayType('audio/x-aiff;'); - }; - p5.prototype.isFileSupported = function (extension) { - switch (extension.toLowerCase()) { - case 'mp3': - return isMP3Supported(); - case 'wav': - return isWAVSupported(); - case 'ogg': - return isOGGSupported(); - case 'aac', 'm4a', 'mp4': - return isAACSupported(); - case 'aif', 'aiff': - return isAIFSupported(); - default: - return false; - } - }; - // if it is iOS, we have to have a user interaction to start Web Audio - // http://paulbakaus.com/tutorials/html5/web-audio-on-ios/ - var iOS = navigator.userAgent.match(/(iPad|iPhone|iPod)/g) ? true : false; - if (iOS) { - var iosStarted = false; - var startIOS = function () { - if (iosStarted) - return; - // create empty buffer - var buffer = audiocontext.createBuffer(1, 1, 22050); - var source = audiocontext.createBufferSource(); - source.buffer = buffer; - // connect to output (your speakers) - source.connect(audiocontext.destination); - // play the file - source.start(0); - console.log('start ios!'); - if (audiocontext.state === 'running') { - iosStarted = true; - } - }; - document.addEventListener('touchend', startIOS, false); - document.addEventListener('touchstart', startIOS, false); - } -}(); -var master; -master = function () { - 'use strict'; - /** - * Master contains AudioContext and the master sound output. - */ - var Master = function () { - var audiocontext = p5.prototype.getAudioContext(); - this.input = audiocontext.createGain(); - this.output = audiocontext.createGain(); - //put a hard limiter on the output - this.limiter = audiocontext.createDynamicsCompressor(); - this.limiter.threshold.value = 0; - this.limiter.ratio.value = 20; - this.audiocontext = audiocontext; - this.output.disconnect(); - // an array of input sources - this.inputSources = []; - // connect input to limiter - this.input.connect(this.limiter); - // connect limiter to output - this.limiter.connect(this.output); - // meter is just for global Amplitude / FFT analysis - this.meter = audiocontext.createGain(); - this.fftMeter = audiocontext.createGain(); - this.output.connect(this.meter); - this.output.connect(this.fftMeter); - // connect output to destination - this.output.connect(this.audiocontext.destination); - // an array of all sounds in the sketch - this.soundArray = []; - // an array of all musical parts in the sketch - this.parts = []; - // file extensions to search for - this.extensions = []; - }; - // create a single instance of the p5Sound / master output for use within this sketch - var p5sound = new Master(); - /** - * Returns a number representing the master amplitude (volume) for sound - * in this sketch. - * - * @method getMasterVolume - * @return {Number} Master amplitude (volume) for sound in this sketch. - * Should be between 0.0 (silence) and 1.0. - */ - p5.prototype.getMasterVolume = function () { - return p5sound.output.gain.value; - }; - /** - *

Scale the output of all sound in this sketch

- * Scaled between 0.0 (silence) and 1.0 (full volume). - * 1.0 is the maximum amplitude of a digital sound, so multiplying - * by greater than 1.0 may cause digital distortion. To - * fade, provide a rampTime parameter. For more - * complex fades, see the Env class. - * - * Alternately, you can pass in a signal source such as an - * oscillator to modulate the amplitude with an audio signal. - * - *

How This Works: When you load the p5.sound module, it - * creates a single instance of p5sound. All sound objects in this - * module output to p5sound before reaching your computer's output. - * So if you change the amplitude of p5sound, it impacts all of the - * sound in this module.

- * - *

If no value is provided, returns a Web Audio API Gain Node

- * - * @method masterVolume - * @param {Number|Object} volume Volume (amplitude) between 0.0 - * and 1.0 or modulating signal/oscillator - * @param {Number} [rampTime] Fade for t seconds - * @param {Number} [timeFromNow] Schedule this event to happen at - * t seconds in the future - */ - p5.prototype.masterVolume = function (vol, rampTime, tFromNow) { - if (typeof vol === 'number') { - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var now = p5sound.audiocontext.currentTime; - var currentVol = p5sound.output.gain.value; - p5sound.output.gain.cancelScheduledValues(now + tFromNow); - p5sound.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); - p5sound.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); - } else if (vol) { - vol.connect(p5sound.output.gain); - } else { - // return the Gain Node - return p5sound.output.gain; - } - }; - /** - * `p5.soundOut` is the p5.sound master output. It sends output to - * the destination of this window's web audio context. It contains - * Web Audio API nodes including a dyanmicsCompressor (.limiter), - * and Gain Nodes for .input and .output. - * - * @property soundOut - * @type {Object} - */ - p5.prototype.soundOut = p5.soundOut = p5sound; - /** - * a silent connection to the DesinationNode - * which will ensure that anything connected to it - * will not be garbage collected - * - * @private - */ - p5.soundOut._silentNode = p5sound.audiocontext.createGain(); - p5.soundOut._silentNode.gain.value = 0; - p5.soundOut._silentNode.connect(p5sound.audiocontext.destination); - return p5sound; -}(sndcore); -var helpers; -helpers = function () { - 'use strict'; - var p5sound = master; - /** - * Returns a number representing the sample rate, in samples per second, - * of all sound objects in this audio context. It is determined by the - * sampling rate of your operating system's sound card, and it is not - * currently possile to change. - * It is often 44100, or twice the range of human hearing. - * - * @method sampleRate - * @return {Number} samplerate samples per second - */ - p5.prototype.sampleRate = function () { - return p5sound.audiocontext.sampleRate; - }; - /** - * Returns the closest MIDI note value for - * a given frequency. - * - * @param {Number} frequency A freqeuncy, for example, the "A" - * above Middle C is 440Hz - * @return {Number} MIDI note value - */ - p5.prototype.freqToMidi = function (f) { - var mathlog2 = Math.log(f / 440) / Math.log(2); - var m = Math.round(12 * mathlog2) + 57; - return m; - }; - /** - * Returns the frequency value of a MIDI note value. - * General MIDI treats notes as integers where middle C - * is 60, C# is 61, D is 62 etc. Useful for generating - * musical frequencies with oscillators. - * - * @method midiToFreq - * @param {Number} midiNote The number of a MIDI note - * @return {Number} Frequency value of the given MIDI note - * @example - *
- * var notes = [60, 64, 67, 72]; - * var i = 0; - * - * function setup() { - * osc = new p5.Oscillator('Triangle'); - * osc.start(); - * frameRate(1); - * } - * - * function draw() { - * var freq = midiToFreq(notes[i]); - * osc.freq(freq); - * i++; - * if (i >= notes.length){ - * i = 0; - * } - * } - *
- */ - p5.prototype.midiToFreq = function (m) { - return 440 * Math.pow(2, (m - 69) / 12); - }; - /** - * List the SoundFile formats that you will include. LoadSound - * will search your directory for these extensions, and will pick - * a format that is compatable with the client's web browser. - * Here is a free online file - * converter. - * - * @method soundFormats - * @param {String} formats i.e. 'mp3', 'wav', 'ogg' - * @example - *
- * function preload() { - * // set the global sound formats - * soundFormats('mp3', 'ogg'); - * - * // load either beatbox.mp3, or .ogg, depending on browser - * mySound = loadSound('../sounds/beatbox.mp3'); - * } - * - * function setup() { - * mySound.play(); - * } - *
- */ - p5.prototype.soundFormats = function () { - // reset extensions array - p5sound.extensions = []; - // add extensions - for (var i = 0; i < arguments.length; i++) { - arguments[i] = arguments[i].toLowerCase(); - if ([ - 'mp3', - 'wav', - 'ogg', - 'm4a', - 'aac' - ].indexOf(arguments[i]) > -1) { - p5sound.extensions.push(arguments[i]); - } else { - throw arguments[i] + ' is not a valid sound format!'; - } - } - }; - p5.prototype.disposeSound = function () { - for (var i = 0; i < p5sound.soundArray.length; i++) { - p5sound.soundArray[i].dispose(); - } - }; - // register removeSound to dispose of p5sound SoundFiles, Convolvers, - // Oscillators etc when sketch ends - p5.prototype.registerMethod('remove', p5.prototype.disposeSound); - p5.prototype._checkFileFormats = function (paths) { - var path; - // if path is a single string, check to see if extension is provided - if (typeof paths === 'string') { - path = paths; - // see if extension is provided - var extTest = path.split('.').pop(); - // if an extension is provided... - if ([ - 'mp3', - 'wav', - 'ogg', - 'm4a', - 'aac' - ].indexOf(extTest) > -1) { - var supported = p5.prototype.isFileSupported(extTest); - if (supported) { - path = path; - } else { - var pathSplit = path.split('.'); - var pathCore = pathSplit[pathSplit.length - 1]; - for (var i = 0; i < p5sound.extensions.length; i++) { - var extension = p5sound.extensions[i]; - var supported = p5.prototype.isFileSupported(extension); - if (supported) { - pathCore = ''; - if (pathSplit.length === 2) { - pathCore += pathSplit[0]; - } - for (var i = 1; i <= pathSplit.length - 2; i++) { - var p = pathSplit[i]; - pathCore += '.' + p; - } - path = pathCore += '.'; - path = path += extension; - break; - } - } - } - } else { - for (var i = 0; i < p5sound.extensions.length; i++) { - var extension = p5sound.extensions[i]; - var supported = p5.prototype.isFileSupported(extension); - if (supported) { - path = path + '.' + extension; - break; - } - } - } - } else if (typeof paths === 'object') { - for (var i = 0; i < paths.length; i++) { - var extension = paths[i].split('.').pop(); - var supported = p5.prototype.isFileSupported(extension); - if (supported) { - // console.log('.'+extension + ' is ' + supported + - // ' supported by your browser.'); - path = paths[i]; - break; - } - } - } - return path; - }; - /** - * Used by Osc and Env to chain signal math - */ - p5.prototype._mathChain = function (o, math, thisChain, nextChain, type) { - // if this type of math already exists in the chain, replace it - for (var i in o.mathOps) { - if (o.mathOps[i] instanceof type) { - o.mathOps[i].dispose(); - thisChain = i; - if (thisChain < o.mathOps.length - 1) { - nextChain = o.mathOps[i + 1]; - } - } - } - o.mathOps[thisChain - 1].disconnect(); - o.mathOps[thisChain - 1].connect(math); - math.connect(nextChain); - o.mathOps[thisChain] = math; - return o; - }; -}(master); -var errorHandler; -errorHandler = function () { - 'use strict'; - /** - * Helper function to generate an error - * with a custom stack trace that points to the sketch - * and removes other parts of the stack trace. - * - * @private - * - * @param {String} name custom error name - * @param {String} errorTrace custom error trace - * @param {String} failedPath path to the file that failed to load - * @property {String} name custom error name - * @property {String} message custom error message - * @property {String} stack trace the error back to a line in the user's sketch. - * Note: this edits out stack trace within p5.js and p5.sound. - * @property {String} originalStack unedited, original stack trace - * @property {String} failedPath path to the file that failed to load - * @return {Error} returns a custom Error object - */ - var CustomError = function (name, errorTrace, failedPath) { - var err = new Error(); - var tempStack, splitStack; - err.name = name; - err.originalStack = err.stack + errorTrace; - tempStack = err.stack + errorTrace; - err.failedPath = failedPath; - // only print the part of the stack trace that refers to the user code: - var splitStack = tempStack.split('\n'); - splitStack = splitStack.filter(function (ln) { - return !ln.match(/(p5.|native code|globalInit)/g); - }); - err.stack = splitStack.join('\n'); - return err; - }; - return CustomError; -}(); -var panner; -panner = function () { - 'use strict'; - var p5sound = master; - var ac = p5sound.audiocontext; - // Stereo panner - // if there is a stereo panner node use it - if (typeof ac.createStereoPanner !== 'undefined') { - p5.Panner = function (input, output, numInputChannels) { - this.stereoPanner = this.input = ac.createStereoPanner(); - input.connect(this.stereoPanner); - this.stereoPanner.connect(output); - }; - p5.Panner.prototype.pan = function (val, tFromNow) { - var time = tFromNow || 0; - var t = ac.currentTime + time; - this.stereoPanner.pan.linearRampToValueAtTime(val, t); - }; - p5.Panner.prototype.inputChannels = function (numChannels) { - }; - p5.Panner.prototype.connect = function (obj) { - this.stereoPanner.connect(obj); - }; - p5.Panner.prototype.disconnect = function (obj) { - this.stereoPanner.disconnect(); - }; - } else { - // if there is no createStereoPanner object - // such as in safari 7.1.7 at the time of writing this - // use this method to create the effect - p5.Panner = function (input, output, numInputChannels) { - this.input = ac.createGain(); - input.connect(this.input); - this.left = ac.createGain(); - this.right = ac.createGain(); - this.left.channelInterpretation = 'discrete'; - this.right.channelInterpretation = 'discrete'; - // if input is stereo - if (numInputChannels > 1) { - this.splitter = ac.createChannelSplitter(2); - this.input.connect(this.splitter); - this.splitter.connect(this.left, 1); - this.splitter.connect(this.right, 0); - } else { - this.input.connect(this.left); - this.input.connect(this.right); - } - this.output = ac.createChannelMerger(2); - this.left.connect(this.output, 0, 1); - this.right.connect(this.output, 0, 0); - this.output.connect(output); - }; - // -1 is left, +1 is right - p5.Panner.prototype.pan = function (val, tFromNow) { - var time = tFromNow || 0; - var t = ac.currentTime + time; - var v = (val + 1) / 2; - var rightVal = Math.cos(v * Math.PI / 2); - var leftVal = Math.sin(v * Math.PI / 2); - this.left.gain.linearRampToValueAtTime(leftVal, t); - this.right.gain.linearRampToValueAtTime(rightVal, t); - }; - p5.Panner.prototype.inputChannels = function (numChannels) { - if (numChannels === 1) { - this.input.disconnect(); - this.input.connect(this.left); - this.input.connect(this.right); - } else if (numChannels === 2) { - if (typeof (this.splitter === 'undefined')) { - this.splitter = ac.createChannelSplitter(2); - } - this.input.disconnect(); - this.input.connect(this.splitter); - this.splitter.connect(this.left, 1); - this.splitter.connect(this.right, 0); - } - }; - p5.Panner.prototype.connect = function (obj) { - this.output.connect(obj); - }; - p5.Panner.prototype.disconnect = function (obj) { - this.output.disconnect(); - }; - } - // 3D panner - p5.Panner3D = function (input, output) { - var panner3D = ac.createPanner(); - panner3D.panningModel = 'HRTF'; - panner3D.distanceModel = 'linear'; - panner3D.setPosition(0, 0, 0); - input.connect(panner3D); - panner3D.connect(output); - panner3D.pan = function (xVal, yVal, zVal) { - panner3D.setPosition(xVal, yVal, zVal); - }; - return panner3D; - }; -}(master); -var soundfile; -soundfile = function () { - 'use strict'; - var CustomError = errorHandler; - var p5sound = master; - var ac = p5sound.audiocontext; - /** - *

SoundFile object with a path to a file.

- * - *

The p5.SoundFile may not be available immediately because - * it loads the file information asynchronously.

- * - *

To do something with the sound as soon as it loads - * pass the name of a function as the second parameter.

- * - *

Only one file path is required. However, audio file formats - * (i.e. mp3, ogg, wav and m4a/aac) are not supported by all - * web browsers. If you want to ensure compatability, instead of a single - * file path, you may include an Array of filepaths, and the browser will - * choose a format that works.

- * - * @class p5.SoundFile - * @constructor - * @param {String|Array} path path to a sound file (String). Optionally, - * you may include multiple file formats in - * an array. Alternately, accepts an object - * from the HTML5 File API, or a p5.File. - * @param {Function} [successCallback] Name of a function to call once file loads - * @param {Function} [errorCallback] Name of a function to call if file fails to - * load. This function will receive an error or - * XMLHttpRequest object with information - * about what went wrong. - * @param {Function} [whileLoadingCallback] Name of a function to call while file - * is loading. That function will - * receive progress of the request to - * load the sound file - * (between 0 and 1) as its first - * parameter. This progress - * does not account for the additional - * time needed to decode the audio data. - * - * @return {Object} p5.SoundFile Object - * @example - *
- * - * function preload() { - * mySound = loadSound('assets/doorbell.mp3'); - * } - * - * function setup() { - * mySound.setVolume(0.1); - * mySound.play(); - * } - * - *
- */ - p5.SoundFile = function (paths, onload, onerror, whileLoading) { - if (typeof paths !== 'undefined') { - if (typeof paths == 'string' || typeof paths[0] == 'string') { - var path = p5.prototype._checkFileFormats(paths); - this.url = path; - } else if (typeof paths == 'object') { - if (!(window.File && window.FileReader && window.FileList && window.Blob)) { - // The File API isn't supported in this browser - throw 'Unable to load file because the File API is not supported'; - } - } - // if type is a p5.File...get the actual file - if (paths.file) { - paths = paths.file; - } - this.file = paths; - } - // private _onended callback, set by the method: onended(callback) - this._onended = function () { - }; - this._looping = false; - this._playing = false; - this._paused = false; - this._pauseTime = 0; - // cues for scheduling events with addCue() removeCue() - this._cues = []; - // position of the most recently played sample - this._lastPos = 0; - this._counterNode; - this._scopeNode; - // array of sources so that they can all be stopped! - this.bufferSourceNodes = []; - // current source - this.bufferSourceNode = null; - this.buffer = null; - this.playbackRate = 1; - this.gain = 1; - this.input = p5sound.audiocontext.createGain(); - this.output = p5sound.audiocontext.createGain(); - this.reversed = false; - // start and end of playback / loop - this.startTime = 0; - this.endTime = null; - this.pauseTime = 0; - // "restart" would stop playback before retriggering - this.mode = 'sustain'; - // time that playback was started, in millis - this.startMillis = null; - // stereo panning - this.panPosition = 0; - this.panner = new p5.Panner(this.output, p5sound.input, 2); - // it is possible to instantiate a soundfile with no path - if (this.url || this.file) { - this.load(onload, onerror); - } - // add this p5.SoundFile to the soundArray - p5sound.soundArray.push(this); - if (typeof whileLoading === 'function') { - this._whileLoading = whileLoading; - } else { - this._whileLoading = function () { - }; - } - }; - // register preload handling of loadSound - p5.prototype.registerPreloadMethod('loadSound', p5.prototype); - /** - * loadSound() returns a new p5.SoundFile from a specified - * path. If called during preload(), the p5.SoundFile will be ready - * to play in time for setup() and draw(). If called outside of - * preload, the p5.SoundFile will not be ready immediately, so - * loadSound accepts a callback as the second parameter. Using a - * - * local server is recommended when loading external files. - * - * @method loadSound - * @param {String|Array} path Path to the sound file, or an array with - * paths to soundfiles in multiple formats - * i.e. ['sound.ogg', 'sound.mp3']. - * Alternately, accepts an object: either - * from the HTML5 File API, or a p5.File. - * @param {Function} [successCallback] Name of a function to call once file loads - * @param {Function} [errorCallback] Name of a function to call if there is - * an error loading the file. - * @param {Function} [whileLoading] Name of a function to call while file is loading. - * This function will receive the percentage loaded - * so far, from 0.0 to 1.0. - * @return {SoundFile} Returns a p5.SoundFile - * @example - *
- * function preload() { - * mySound = loadSound('assets/doorbell.mp3'); - * } - * - * function setup() { - * mySound.setVolume(0.1); - * mySound.play(); - * } - *
- */ - p5.prototype.loadSound = function (path, callback, onerror, whileLoading) { - // if loading locally without a server - if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { - alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); - } - var s = new p5.SoundFile(path, callback, onerror, whileLoading); - return s; - }; - /** - * This is a helper function that the p5.SoundFile calls to load - * itself. Accepts a callback (the name of another function) - * as an optional parameter. - * - * @private - * @param {Function} [successCallback] Name of a function to call once file loads - * @param {Function} [errorCallback] Name of a function to call if there is an error - */ - p5.SoundFile.prototype.load = function (callback, errorCallback) { - var loggedError = false; - var self = this; - var errorTrace = new Error().stack; - if (this.url != undefined && this.url != '') { - var request = new XMLHttpRequest(); - request.addEventListener('progress', function (evt) { - self._updateProgress(evt); - }, false); - request.open('GET', this.url, true); - request.responseType = 'arraybuffer'; - request.onload = function () { - if (request.status == 200) { - // on sucess loading file: - ac.decodeAudioData(request.response, // success decoding buffer: - function (buff) { - self.buffer = buff; - self.panner.inputChannels(buff.numberOfChannels); - if (callback) { - callback(self); - } - }, // error decoding buffer. "e" is undefined in Chrome 11/22/2015 - function (e) { - var err = new CustomError('decodeAudioData', errorTrace, self.url); - var msg = 'AudioContext error at decodeAudioData for ' + self.url; - if (errorCallback) { - err.msg = msg; - errorCallback(err); - } else { - console.error(msg + '\n The error stack trace includes: \n' + err.stack); - } - }); - } else { - var err = new CustomError('loadSound', errorTrace, self.url); - var msg = 'Unable to load ' + self.url + '. The request status was: ' + request.status + ' (' + request.statusText + ')'; - if (errorCallback) { - err.message = msg; - errorCallback(err); - } else { - console.error(msg + '\n The error stack trace includes: \n' + err.stack); - } - } - }; - // if there is another error, aside from 404... - request.onerror = function (e) { - var err = new CustomError('loadSound', errorTrace, self.url); - var msg = 'There was no response from the server at ' + self.url + '. Check the url and internet connectivity.'; - if (errorCallback) { - err.message = msg; - errorCallback(err); - } else { - console.error(msg + '\n The error stack trace includes: \n' + err.stack); - } - }; - request.send(); - } else if (this.file != undefined) { - var reader = new FileReader(); - var self = this; - reader.onload = function () { - ac.decodeAudioData(reader.result, function (buff) { - self.buffer = buff; - self.panner.inputChannels(buff.numberOfChannels); - if (callback) { - callback(self); - } - }); - }; - reader.onerror = function (e) { - if (onerror) - onerror(e); - }; - reader.readAsArrayBuffer(this.file); - } - }; - // TO DO: use this method to create a loading bar that shows progress during file upload/decode. - p5.SoundFile.prototype._updateProgress = function (evt) { - if (evt.lengthComputable) { - var percentComplete = evt.loaded / evt.total * 0.99; - this._whileLoading(percentComplete, evt); - } else { - // Unable to compute progress information since the total size is unknown - this._whileLoading('size unknown'); - } - }; - /** - * Returns true if the sound file finished loading successfully. - * - * @method isLoaded - * @return {Boolean} - */ - p5.SoundFile.prototype.isLoaded = function () { - if (this.buffer) { - return true; - } else { - return false; - } - }; - /** - * Play the p5.SoundFile - * - * @method play - * @param {Number} [startTime] (optional) schedule playback to start (in seconds from now). - * @param {Number} [rate] (optional) playback rate - * @param {Number} [amp] (optional) amplitude (volume) - * of playback - * @param {Number} [cueStart] (optional) cue start time in seconds - * @param {Number} [duration] (optional) duration of playback in seconds - */ - p5.SoundFile.prototype.play = function (time, rate, amp, _cueStart, duration) { - var self = this; - var now = p5sound.audiocontext.currentTime; - var cueStart, cueEnd; - var time = time || 0; - if (time < 0) { - time = 0; - } - time = time + now; - // TO DO: if already playing, create array of buffers for easy stop() - if (this.buffer) { - // reset the pause time (if it was paused) - this._pauseTime = 0; - // handle restart playmode - if (this.mode === 'restart' && this.buffer && this.bufferSourceNode) { - var now = p5sound.audiocontext.currentTime; - this.bufferSourceNode.stop(time); - this._counterNode.stop(time); - } - // set playback rate - if (rate) - this.playbackRate = rate; - // make a new source and counter. They are automatically assigned playbackRate and buffer - this.bufferSourceNode = this._initSourceNode(); - // garbage collect counterNode and create a new one - if (this._counterNode) - this._counterNode = undefined; - this._counterNode = this._initCounterNode(); - if (_cueStart) { - if (_cueStart >= 0 && _cueStart < this.buffer.duration) { - // this.startTime = cueStart; - cueStart = _cueStart; - } else { - throw 'start time out of range'; - } - } else { - cueStart = 0; - } - if (duration) { - // if duration is greater than buffer.duration, just play entire file anyway rather than throw an error - duration = duration <= this.buffer.duration - cueStart ? duration : this.buffer.duration; - } else { - duration = this.buffer.duration - cueStart; - } - // TO DO: Fix this. It broke in Safari - // - // method of controlling gain for individual bufferSourceNodes, without resetting overall soundfile volume - // if (typeof(this.bufferSourceNode.gain === 'undefined' ) ) { - // this.bufferSourceNode.gain = p5sound.audiocontext.createGain(); - // } - // this.bufferSourceNode.connect(this.bufferSourceNode.gain); - // set local amp if provided, otherwise 1 - var a = amp || 1; - // this.bufferSourceNode.gain.gain.setValueAtTime(a, p5sound.audiocontext.currentTime); - // this.bufferSourceNode.gain.connect(this.output); - this.bufferSourceNode.connect(this.output); - this.output.gain.value = a; - // if it was paused, play at the pause position - if (this._paused) { - this.bufferSourceNode.start(time, this.pauseTime, duration); - this._counterNode.start(time, this.pauseTime, duration); - } else { - this.bufferSourceNode.start(time, cueStart, duration); - this._counterNode.start(time, cueStart, duration); - } - this._playing = true; - this._paused = false; - // add source to sources array, which is used in stopAll() - this.bufferSourceNodes.push(this.bufferSourceNode); - this.bufferSourceNode._arrayIndex = this.bufferSourceNodes.length - 1; - // delete this.bufferSourceNode from the sources array when it is done playing: - var clearOnEnd = function (e) { - this._playing = false; - this.removeEventListener('ended', clearOnEnd, false); - // call the onended callback - self._onended(self); - self.bufferSourceNodes.forEach(function (n, i) { - if (n._playing === false) { - self.bufferSourceNodes.splice(i); - } - }); - if (self.bufferSourceNodes.length === 0) { - self._playing = false; - } - }; - this.bufferSourceNode.onended = clearOnEnd; - } else { - throw 'not ready to play file, buffer has yet to load. Try preload()'; - } - // if looping, will restart at original time - this.bufferSourceNode.loop = this._looping; - this._counterNode.loop = this._looping; - if (this._looping === true) { - var cueEnd = cueStart + duration; - this.bufferSourceNode.loopStart = cueStart; - this.bufferSourceNode.loopEnd = cueEnd; - this._counterNode.loopStart = cueStart; - this._counterNode.loopEnd = cueEnd; - } - }; - /** - * p5.SoundFile has two play modes: restart and - * sustain. Play Mode determines what happens to a - * p5.SoundFile if it is triggered while in the middle of playback. - * In sustain mode, playback will continue simultaneous to the - * new playback. In restart mode, play() will stop playback - * and start over. Sustain is the default mode. - * - * @method playMode - * @param {String} str 'restart' or 'sustain' - * @example - *
- * function setup(){ - * mySound = loadSound('assets/Damscray_DancingTiger.mp3'); - * } - * function mouseClicked() { - * mySound.playMode('sustain'); - * mySound.play(); - * } - * function keyPressed() { - * mySound.playMode('restart'); - * mySound.play(); - * } - * - *
- */ - p5.SoundFile.prototype.playMode = function (str) { - var s = str.toLowerCase(); - // if restart, stop all other sounds from playing - if (s === 'restart' && this.buffer && this.bufferSourceNode) { - for (var i = 0; i < this.bufferSourceNodes.length - 1; i++) { - var now = p5sound.audiocontext.currentTime; - this.bufferSourceNodes[i].stop(now); - } - } - // set play mode to effect future playback - if (s === 'restart' || s === 'sustain') { - this.mode = s; - } else { - throw 'Invalid play mode. Must be either "restart" or "sustain"'; - } - }; - /** - * Pauses a file that is currently playing. If the file is not - * playing, then nothing will happen. - * - * After pausing, .play() will resume from the paused - * position. - * If p5.SoundFile had been set to loop before it was paused, - * it will continue to loop after it is unpaused with .play(). - * - * @method pause - * @param {Number} [startTime] (optional) schedule event to occur - * seconds from now - * @example - *
- * var soundFile; - * - * function preload() { - * soundFormats('ogg', 'mp3'); - * soundFile = loadSound('assets/Damscray_-_Dancing_Tiger_02.mp3'); - * } - * function setup() { - * background(0, 255, 0); - * soundFile.setVolume(0.1); - * soundFile.loop(); - * } - * function keyTyped() { - * if (key == 'p') { - * soundFile.pause(); - * background(255, 0, 0); - * } - * } - * - * function keyReleased() { - * if (key == 'p') { - * soundFile.play(); - * background(0, 255, 0); - * } - * } - * - *
- */ - p5.SoundFile.prototype.pause = function (time) { - var now = p5sound.audiocontext.currentTime; - var time = time || 0; - var pTime = time + now; - if (this.isPlaying() && this.buffer && this.bufferSourceNode) { - this.pauseTime = this.currentTime(); - this.bufferSourceNode.stop(pTime); - this._counterNode.stop(pTime); - this._paused = true; - this._playing = false; - this._pauseTime = this.currentTime(); - } else { - this._pauseTime = 0; - } - }; - /** - * Loop the p5.SoundFile. Accepts optional parameters to set the - * playback rate, playback volume, loopStart, loopEnd. - * - * @method loop - * @param {Number} [startTime] (optional) schedule event to occur - * seconds from now - * @param {Number} [rate] (optional) playback rate - * @param {Number} [amp] (optional) playback volume - * @param {Number} [cueLoopStart](optional) startTime in seconds - * @param {Number} [duration] (optional) loop duration in seconds - */ - p5.SoundFile.prototype.loop = function (startTime, rate, amp, loopStart, duration) { - this._looping = true; - this.play(startTime, rate, amp, loopStart, duration); - }; - /** - * Set a p5.SoundFile's looping flag to true or false. If the sound - * is currently playing, this change will take effect when it - * reaches the end of the current playback. - * - * @param {Boolean} Boolean set looping to true or false - */ - p5.SoundFile.prototype.setLoop = function (bool) { - if (bool === true) { - this._looping = true; - } else if (bool === false) { - this._looping = false; - } else { - throw 'Error: setLoop accepts either true or false'; - } - if (this.bufferSourceNode) { - this.bufferSourceNode.loop = this._looping; - this._counterNode.loop = this._looping; - } - }; - /** - * Returns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not. - * - * @return {Boolean} - */ - p5.SoundFile.prototype.isLooping = function () { - if (!this.bufferSourceNode) { - return false; - } - if (this._looping === true && this.isPlaying() === true) { - return true; - } - return false; - }; - /** - * Returns true if a p5.SoundFile is playing, false if not (i.e. - * paused or stopped). - * - * @method isPlaying - * @return {Boolean} - */ - p5.SoundFile.prototype.isPlaying = function () { - return this._playing; - }; - /** - * Returns true if a p5.SoundFile is paused, false if not (i.e. - * playing or stopped). - * - * @method isPaused - * @return {Boolean} - */ - p5.SoundFile.prototype.isPaused = function () { - return this._paused; - }; - /** - * Stop soundfile playback. - * - * @method stop - * @param {Number} [startTime] (optional) schedule event to occur - * in seconds from now - */ - p5.SoundFile.prototype.stop = function (timeFromNow) { - var time = timeFromNow || 0; - if (this.mode == 'sustain') { - this.stopAll(time); - this._playing = false; - this.pauseTime = 0; - this._paused = false; - } else if (this.buffer && this.bufferSourceNode) { - var now = p5sound.audiocontext.currentTime; - var t = time || 0; - this.pauseTime = 0; - this.bufferSourceNode.stop(now + t); - this._counterNode.stop(now + t); - this._playing = false; - this._paused = false; - } - }; - /** - * Stop playback on all of this soundfile's sources. - * @private - */ - p5.SoundFile.prototype.stopAll = function (_time) { - var now = p5sound.audiocontext.currentTime; - var time = _time || 0; - if (this.buffer && this.bufferSourceNode) { - for (var i = 0; i < this.bufferSourceNodes.length; i++) { - if (typeof this.bufferSourceNodes[i] != undefined) { - try { - this.bufferSourceNodes[i].onended = function () { - }; - this.bufferSourceNodes[i].stop(now + time); - } catch (e) { - } - } - } - this._counterNode.stop(now + time); - this._onended(this); - } - }; - /** - * Multiply the output volume (amplitude) of a sound file - * between 0.0 (silence) and 1.0 (full volume). - * 1.0 is the maximum amplitude of a digital sound, so multiplying - * by greater than 1.0 may cause digital distortion. To - * fade, provide a rampTime parameter. For more - * complex fades, see the Env class. - * - * Alternately, you can pass in a signal source such as an - * oscillator to modulate the amplitude with an audio signal. - * - * @method setVolume - * @param {Number|Object} volume Volume (amplitude) between 0.0 - * and 1.0 or modulating signal/oscillator - * @param {Number} [rampTime] Fade for t seconds - * @param {Number} [timeFromNow] Schedule this event to happen at - * t seconds in the future - */ - p5.SoundFile.prototype.setVolume = function (vol, rampTime, tFromNow) { - if (typeof vol === 'number') { - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var now = p5sound.audiocontext.currentTime; - var currentVol = this.output.gain.value; - this.output.gain.cancelScheduledValues(now + tFromNow); - this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); - this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); - } else if (vol) { - vol.connect(this.output.gain); - } else { - // return the Gain Node - return this.output.gain; - } - }; - // same as setVolume, to match Processing Sound - p5.SoundFile.prototype.amp = p5.SoundFile.prototype.setVolume; - // these are the same thing - p5.SoundFile.prototype.fade = p5.SoundFile.prototype.setVolume; - p5.SoundFile.prototype.getVolume = function () { - return this.output.gain.value; - }; - /** - * Set the stereo panning of a p5.sound object to - * a floating point number between -1.0 (left) and 1.0 (right). - * Default is 0.0 (center). - * - * @method pan - * @param {Number} [panValue] Set the stereo panner - * @param {Number} timeFromNow schedule this event to happen - * seconds from now - * @example - *
- * - * var ball = {}; - * var soundFile; - * - * function setup() { - * soundFormats('ogg', 'mp3'); - * soundFile = loadSound('assets/beatbox.mp3'); - * } - * - * function draw() { - * background(0); - * ball.x = constrain(mouseX, 0, width); - * ellipse(ball.x, height/2, 20, 20) - * } - * - * function mousePressed(){ - * // map the ball's x location to a panning degree - * // between -1.0 (left) and 1.0 (right) - * var panning = map(ball.x, 0., width,-1.0, 1.0); - * soundFile.pan(panning); - * soundFile.play(); - * } - *
- */ - p5.SoundFile.prototype.pan = function (pval, tFromNow) { - this.panPosition = pval; - this.panner.pan(pval, tFromNow); - }; - /** - * Returns the current stereo pan position (-1.0 to 1.0) - * - * @return {Number} Returns the stereo pan setting of the Oscillator - * as a number between -1.0 (left) and 1.0 (right). - * 0.0 is center and default. - */ - p5.SoundFile.prototype.getPan = function () { - return this.panPosition; - }; - /** - * Set the playback rate of a sound file. Will change the speed and the pitch. - * Values less than zero will reverse the audio buffer. - * - * @method rate - * @param {Number} [playbackRate] Set the playback rate. 1.0 is normal, - * .5 is half-speed, 2.0 is twice as fast. - * Values less than zero play backwards. - * @example - *
- * var song; - * - * function preload() { - * song = loadSound('assets/Damscray_DancingTiger.mp3'); - * } - * - * function setup() { - * song.loop(); - * } - * - * function draw() { - * background(200); - * - * // Set the rate to a range between 0.1 and 4 - * // Changing the rate also alters the pitch - * var speed = map(mouseY, 0.1, height, 0, 2); - * speed = constrain(speed, 0.01, 4); - * song.rate(speed); - * - * // Draw a circle to show what is going on - * stroke(0); - * fill(51, 100); - * ellipse(mouseX, 100, 48, 48); - * } - * - * - *
- * - */ - p5.SoundFile.prototype.rate = function (playbackRate) { - if (this.playbackRate === playbackRate && this.bufferSourceNode) { - if (this.bufferSourceNode.playbackRate.value === playbackRate) { - return; - } - } - this.playbackRate = playbackRate; - var rate = playbackRate; - if (this.playbackRate === 0 && this._playing) { - this.pause(); - } - if (this.playbackRate < 0 && !this.reversed) { - var cPos = this.currentTime(); - var cRate = this.bufferSourceNode.playbackRate.value; - // this.pause(); - this.reverseBuffer(); - rate = Math.abs(playbackRate); - var newPos = (cPos - this.duration()) / rate; - this.pauseTime = newPos; - } else if (this.playbackRate > 0 && this.reversed) { - this.reverseBuffer(); - } - if (this.bufferSourceNode) { - var now = p5sound.audiocontext.currentTime; - this.bufferSourceNode.playbackRate.cancelScheduledValues(now); - this.bufferSourceNode.playbackRate.linearRampToValueAtTime(Math.abs(rate), now); - this._counterNode.playbackRate.cancelScheduledValues(now); - this._counterNode.playbackRate.linearRampToValueAtTime(Math.abs(rate), now); - } - }; - // TO DO: document this - p5.SoundFile.prototype.setPitch = function (num) { - var newPlaybackRate = midiToFreq(num) / midiToFreq(60); - this.rate(newPlaybackRate); - }; - p5.SoundFile.prototype.getPlaybackRate = function () { - return this.playbackRate; - }; - /** - * Returns the duration of a sound file in seconds. - * - * @method duration - * @return {Number} The duration of the soundFile in seconds. - */ - p5.SoundFile.prototype.duration = function () { - // Return Duration - if (this.buffer) { - return this.buffer.duration; - } else { - return 0; - } - }; - /** - * Return the current position of the p5.SoundFile playhead, in seconds. - * Note that if you change the playbackRate while the p5.SoundFile is - * playing, the results may not be accurate. - * - * @method currentTime - * @return {Number} currentTime of the soundFile in seconds. - */ - p5.SoundFile.prototype.currentTime = function () { - // TO DO --> make reverse() flip these values appropriately - if (this._pauseTime > 0) { - return this._pauseTime; - } else { - return this._lastPos / ac.sampleRate; - } - }; - /** - * Move the playhead of the song to a position, in seconds. Start - * and Stop time. If none are given, will reset the file to play - * entire duration from start to finish. - * - * @method jump - * @param {Number} cueTime cueTime of the soundFile in seconds. - * @param {Number} duration duration in seconds. - */ - p5.SoundFile.prototype.jump = function (cueTime, duration) { - if (cueTime < 0 || cueTime > this.buffer.duration) { - throw 'jump time out of range'; - } - if (duration > this.buffer.duration - cueTime) { - throw 'end time out of range'; - } - var cTime = cueTime || 0; - var eTime = duration || this.buffer.duration - cueTime; - if (this.isPlaying()) { - this.stop(); - } - this.play(0, this.playbackRate, this.output.gain.value, cTime, eTime); - }; - /** - * Return the number of channels in a sound file. - * For example, Mono = 1, Stereo = 2. - * - * @method channels - * @return {Number} [channels] - */ - p5.SoundFile.prototype.channels = function () { - return this.buffer.numberOfChannels; - }; - /** - * Return the sample rate of the sound file. - * - * @method sampleRate - * @return {Number} [sampleRate] - */ - p5.SoundFile.prototype.sampleRate = function () { - return this.buffer.sampleRate; - }; - /** - * Return the number of samples in a sound file. - * Equal to sampleRate * duration. - * - * @method frames - * @return {Number} [sampleCount] - */ - p5.SoundFile.prototype.frames = function () { - return this.buffer.length; - }; - /** - * Returns an array of amplitude peaks in a p5.SoundFile that can be - * used to draw a static waveform. Scans through the p5.SoundFile's - * audio buffer to find the greatest amplitudes. Accepts one - * parameter, 'length', which determines size of the array. - * Larger arrays result in more precise waveform visualizations. - * - * Inspired by Wavesurfer.js. - * - * @method getPeaks - * @params {Number} [length] length is the size of the returned array. - * Larger length results in more precision. - * Defaults to 5*width of the browser window. - * @returns {Float32Array} Array of peaks. - */ - p5.SoundFile.prototype.getPeaks = function (length) { - if (this.buffer) { - // set length to window's width if no length is provided - if (!length) { - length = window.width * 5; - } - if (this.buffer) { - var buffer = this.buffer; - var sampleSize = buffer.length / length; - var sampleStep = ~~(sampleSize / 10) || 1; - var channels = buffer.numberOfChannels; - var peaks = new Float32Array(Math.round(length)); - for (var c = 0; c < channels; c++) { - var chan = buffer.getChannelData(c); - for (var i = 0; i < length; i++) { - var start = ~~(i * sampleSize); - var end = ~~(start + sampleSize); - var max = 0; - for (var j = start; j < end; j += sampleStep) { - var value = chan[j]; - if (value > max) { - max = value; - } else if (-value > max) { - max = value; - } - } - if (c === 0 || Math.abs(max) > peaks[i]) { - peaks[i] = max; - } - } - } - return peaks; - } - } else { - throw 'Cannot load peaks yet, buffer is not loaded'; - } - }; - /** - * Reverses the p5.SoundFile's buffer source. - * Playback must be handled separately (see example). - * - * @method reverseBuffer - * @example - *
- * var drum; - * - * function preload() { - * drum = loadSound('assets/drum.mp3'); - * } - * - * function setup() { - * drum.reverseBuffer(); - * drum.play(); - * } - * - * - *
- */ - p5.SoundFile.prototype.reverseBuffer = function () { - var curVol = this.getVolume(); - this.setVolume(0, 0.01, 0); - this.pause(); - if (this.buffer) { - for (var i = 0; i < this.buffer.numberOfChannels; i++) { - Array.prototype.reverse.call(this.buffer.getChannelData(i)); - } - // set reversed flag - this.reversed = !this.reversed; - } else { - throw 'SoundFile is not done loading'; - } - this.setVolume(curVol, 0.01, 0.0101); - this.play(); - }; - /** - * Schedule an event to be called when the soundfile - * reaches the end of a buffer. If the soundfile is - * playing through once, this will be called when it - * ends. If it is looping, it will be called when - * stop is called. - * - * @method onended - * @param {Function} callback function to call when the - * soundfile has ended. - */ - p5.SoundFile.prototype.onended = function (callback) { - this._onended = callback; - return this; - }; - p5.SoundFile.prototype.add = function () { - }; - p5.SoundFile.prototype.dispose = function () { - var now = p5sound.audiocontext.currentTime; - // remove reference to soundfile - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.stop(now); - if (this.buffer && this.bufferSourceNode) { - for (var i = 0; i < this.bufferSourceNodes.length - 1; i++) { - if (this.bufferSourceNodes[i] !== null) { - this.bufferSourceNodes[i].disconnect(); - try { - this.bufferSourceNodes[i].stop(now); - } catch (e) { - } - this.bufferSourceNodes[i] = null; - } - } - if (this.isPlaying()) { - try { - this._counterNode.stop(now); - } catch (e) { - console.log(e); - } - this._counterNode = null; - } - } - if (this.output) { - this.output.disconnect(); - this.output = null; - } - if (this.panner) { - this.panner.disconnect(); - this.panner = null; - } - }; - /** - * Connects the output of a p5sound object to input of another - * p5.sound object. For example, you may connect a p5.SoundFile to an - * FFT or an Effect. If no parameter is given, it will connect to - * the master output. Most p5sound objects connect to the master - * output when they are created. - * - * @method connect - * @param {Object} [object] Audio object that accepts an input - */ - p5.SoundFile.prototype.connect = function (unit) { - if (!unit) { - this.panner.connect(p5sound.input); - } else { - if (unit.hasOwnProperty('input')) { - this.panner.connect(unit.input); - } else { - this.panner.connect(unit); - } - } - }; - /** - * Disconnects the output of this p5sound object. - * - * @method disconnect - */ - p5.SoundFile.prototype.disconnect = function () { - this.panner.disconnect(); - }; - /** - */ - p5.SoundFile.prototype.getLevel = function (smoothing) { - console.warn('p5.SoundFile.getLevel has been removed from the library. Use p5.Amplitude instead'); - }; - /** - * Reset the source for this SoundFile to a - * new path (URL). - * - * @method setPath - * @param {String} path path to audio file - * @param {Function} callback Callback - */ - p5.SoundFile.prototype.setPath = function (p, callback) { - var path = p5.prototype._checkFileFormats(p); - this.url = path; - this.load(callback); - }; - /** - * Replace the current Audio Buffer with a new Buffer. - * - * @param {Array} buf Array of Float32 Array(s). 2 Float32 Arrays - * will create a stereo source. 1 will create - * a mono source. - */ - p5.SoundFile.prototype.setBuffer = function (buf) { - var numChannels = buf.length; - var size = buf[0].length; - var newBuffer = ac.createBuffer(numChannels, size, ac.sampleRate); - if (!buf[0] instanceof Float32Array) { - buf[0] = new Float32Array(buf[0]); - } - for (var channelNum = 0; channelNum < numChannels; channelNum++) { - var channel = newBuffer.getChannelData(channelNum); - channel.set(buf[channelNum]); - } - this.buffer = newBuffer; - // set numbers of channels on input to the panner - this.panner.inputChannels(numChannels); - }; - ////////////////////////////////////////////////// - // script processor node with an empty buffer to help - // keep a sample-accurate position in playback buffer. - // Inspired by Chinmay Pendharkar's technique for Sonoport --> http://bit.ly/1HwdCsV - // Copyright [2015] [Sonoport (Asia) Pte. Ltd.], - // Licensed under the Apache License http://apache.org/licenses/LICENSE-2.0 - //////////////////////////////////////////////////////////////////////////////////// - // initialize counterNode, set its initial buffer and playbackRate - p5.SoundFile.prototype._initCounterNode = function () { - var self = this; - var now = ac.currentTime; - var cNode = ac.createBufferSource(); - // dispose of scope node if it already exists - if (self._scopeNode) { - self._scopeNode.disconnect(); - self._scopeNode.onaudioprocess = undefined; - self._scopeNode = null; - } - self._scopeNode = ac.createScriptProcessor(256, 1, 1); - // create counter buffer of the same length as self.buffer - cNode.buffer = _createCounterBuffer(self.buffer); - cNode.playbackRate.setValueAtTime(self.playbackRate, now); - cNode.connect(self._scopeNode); - self._scopeNode.connect(p5.soundOut._silentNode); - self._scopeNode.onaudioprocess = function (processEvent) { - var inputBuffer = processEvent.inputBuffer.getChannelData(0); - // update the lastPos - self._lastPos = inputBuffer[inputBuffer.length - 1] || 0; - // do any callbacks that have been scheduled - self._onTimeUpdate(self._lastPos); - }; - return cNode; - }; - // initialize sourceNode, set its initial buffer and playbackRate - p5.SoundFile.prototype._initSourceNode = function () { - var self = this; - var now = ac.currentTime; - var bufferSourceNode = ac.createBufferSource(); - bufferSourceNode.buffer = self.buffer; - bufferSourceNode.playbackRate.value = self.playbackRate; - return bufferSourceNode; - }; - var _createCounterBuffer = function (buffer) { - var array = new Float32Array(buffer.length); - var audioBuf = ac.createBuffer(1, buffer.length, 44100); - for (var index = 0; index < buffer.length; index++) { - array[index] = index; - } - audioBuf.getChannelData(0).set(array); - return audioBuf; - }; - /** - * processPeaks returns an array of timestamps where it thinks there is a beat. - * - * This is an asynchronous function that processes the soundfile in an offline audio context, - * and sends the results to your callback function. - * - * The process involves running the soundfile through a lowpass filter, and finding all of the - * peaks above the initial threshold. If the total number of peaks are below the minimum number of peaks, - * it decreases the threshold and re-runs the analysis until either minPeaks or minThreshold are reached. - * - * @method processPeaks - * @param {Function} callback a function to call once this data is returned - * @param {Number} [initThreshold] initial threshold defaults to 0.9 - * @param {Number} [minThreshold] minimum threshold defaults to 0.22 - * @param {Number} [minPeaks] minimum number of peaks defaults to 200 - * @return {Array} Array of timestamped peaks - */ - p5.SoundFile.prototype.processPeaks = function (callback, _initThreshold, _minThreshold, _minPeaks) { - var bufLen = this.buffer.length; - var sampleRate = this.buffer.sampleRate; - var buffer = this.buffer; - var initialThreshold = _initThreshold || 0.9, threshold = initialThreshold, minThreshold = _minThreshold || 0.22, minPeaks = _minPeaks || 200; - // Create offline context - var offlineContext = new OfflineAudioContext(1, bufLen, sampleRate); - // create buffer source - var source = offlineContext.createBufferSource(); - source.buffer = buffer; - // Create filter. TO DO: allow custom setting of filter - var filter = offlineContext.createBiquadFilter(); - filter.type = 'lowpass'; - source.connect(filter); - filter.connect(offlineContext.destination); - // start playing at time:0 - source.start(0); - offlineContext.startRendering(); - // Render the song - // act on the result - offlineContext.oncomplete = function (e) { - var data = {}; - var filteredBuffer = e.renderedBuffer; - var bufferData = filteredBuffer.getChannelData(0); - // step 1: - // create Peak instances, add them to array, with strength and sampleIndex - do { - allPeaks = getPeaksAtThreshold(bufferData, threshold); - threshold -= 0.005; - } while (Object.keys(allPeaks).length < minPeaks && threshold >= minThreshold); - // step 2: - // find intervals for each peak in the sampleIndex, add tempos array - var intervalCounts = countIntervalsBetweenNearbyPeaks(allPeaks); - // step 3: find top tempos - var groups = groupNeighborsByTempo(intervalCounts, filteredBuffer.sampleRate); - // sort top intervals - var topTempos = groups.sort(function (intA, intB) { - return intB.count - intA.count; - }).splice(0, 5); - // set this SoundFile's tempo to the top tempo ?? - this.tempo = topTempos[0].tempo; - // step 4: - // new array of peaks at top tempo within a bpmVariance - var bpmVariance = 5; - var tempoPeaks = getPeaksAtTopTempo(allPeaks, topTempos[0].tempo, filteredBuffer.sampleRate, bpmVariance); - callback(tempoPeaks); - }; - }; - // process peaks - var Peak = function (amp, i) { - this.sampleIndex = i; - this.amplitude = amp; - this.tempos = []; - this.intervals = []; - }; - var allPeaks = []; - // 1. for processPeaks() Function to identify peaks above a threshold - // returns an array of peak indexes as frames (samples) of the original soundfile - function getPeaksAtThreshold(data, threshold) { - var peaksObj = {}; - var length = data.length; - for (var i = 0; i < length; i++) { - if (data[i] > threshold) { - var amp = data[i]; - var peak = new Peak(amp, i); - peaksObj[i] = peak; - // Skip forward ~ 1/8s to get past this peak. - i += 6000; - } - i++; - } - return peaksObj; - } - // 2. for processPeaks() - function countIntervalsBetweenNearbyPeaks(peaksObj) { - var intervalCounts = []; - var peaksArray = Object.keys(peaksObj).sort(); - for (var index = 0; index < peaksArray.length; index++) { - // find intervals in comparison to nearby peaks - for (var i = 0; i < 10; i++) { - var startPeak = peaksObj[peaksArray[index]]; - var endPeak = peaksObj[peaksArray[index + i]]; - if (startPeak && endPeak) { - var startPos = startPeak.sampleIndex; - var endPos = endPeak.sampleIndex; - var interval = endPos - startPos; - // add a sample interval to the startPeek in the allPeaks array - if (interval > 0) { - startPeak.intervals.push(interval); - } - // tally the intervals and return interval counts - var foundInterval = intervalCounts.some(function (intervalCount, p) { - if (intervalCount.interval === interval) { - intervalCount.count++; - return intervalCount; - } - }); - // store with JSON like formatting - if (!foundInterval) { - intervalCounts.push({ - interval: interval, - count: 1 - }); - } - } - } - } - return intervalCounts; - } - // 3. for processPeaks --> find tempo - function groupNeighborsByTempo(intervalCounts, sampleRate) { - var tempoCounts = []; - intervalCounts.forEach(function (intervalCount, i) { - try { - // Convert an interval to tempo - var theoreticalTempo = Math.abs(60 / (intervalCount.interval / sampleRate)); - theoreticalTempo = mapTempo(theoreticalTempo); - var foundTempo = tempoCounts.some(function (tempoCount) { - if (tempoCount.tempo === theoreticalTempo) - return tempoCount.count += intervalCount.count; - }); - if (!foundTempo) { - if (isNaN(theoreticalTempo)) { - return; - } - tempoCounts.push({ - tempo: Math.round(theoreticalTempo), - count: intervalCount.count - }); - } - } catch (e) { - throw e; - } - }); - return tempoCounts; - } - // 4. for processPeaks - get peaks at top tempo - function getPeaksAtTopTempo(peaksObj, tempo, sampleRate, bpmVariance) { - var peaksAtTopTempo = []; - var peaksArray = Object.keys(peaksObj).sort(); - // TO DO: filter out peaks that have the tempo and return - for (var i = 0; i < peaksArray.length; i++) { - var key = peaksArray[i]; - var peak = peaksObj[key]; - for (var j = 0; j < peak.intervals.length; j++) { - var intervalBPM = Math.round(Math.abs(60 / (peak.intervals[j] / sampleRate))); - intervalBPM = mapTempo(intervalBPM); - var dif = intervalBPM - tempo; - if (Math.abs(intervalBPM - tempo) < bpmVariance) { - // convert sampleIndex to seconds - peaksAtTopTempo.push(peak.sampleIndex / 44100); - } - } - } - // filter out peaks that are very close to each other - peaksAtTopTempo = peaksAtTopTempo.filter(function (peakTime, index, arr) { - var dif = arr[index + 1] - peakTime; - if (dif > 0.01) { - return true; - } - }); - return peaksAtTopTempo; - } - // helper function for processPeaks - function mapTempo(theoreticalTempo) { - // these scenarios create infinite while loop - if (!isFinite(theoreticalTempo) || theoreticalTempo == 0) { - return; - } - // Adjust the tempo to fit within the 90-180 BPM range - while (theoreticalTempo < 90) - theoreticalTempo *= 2; - while (theoreticalTempo > 180 && theoreticalTempo > 90) - theoreticalTempo /= 2; - return theoreticalTempo; - } - /*** SCHEDULE EVENTS ***/ - /** - * 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. - * - * 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 - * 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 - * 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 - * second parameter to the - * callback function. - * @return {Number} id ID of this cue, - * useful for removeCue(id) - * @example - *
- * function setup() { - * background(0); - * noStroke(); - * fill(255); - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * mySound = loadSound('assets/beat.mp3'); - * - * // schedule calls to changeText - * mySound.addCue(0.50, changeText, "hello" ); - * mySound.addCue(1.00, changeText, "p5" ); - * mySound.addCue(1.50, changeText, "what" ); - * mySound.addCue(2.00, changeText, "do" ); - * mySound.addCue(2.50, changeText, "you" ); - * mySound.addCue(3.00, changeText, "want" ); - * mySound.addCue(4.00, changeText, "to" ); - * mySound.addCue(5.00, changeText, "make" ); - * mySound.addCue(6.00, changeText, "?" ); - * } - * - * function changeText(val) { - * background(0); - * text(val, width/2, height/2); - * } - * - * function mouseClicked() { - * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { - * if (mySound.isPlaying() ) { - * mySound.stop(); - * } else { - * mySound.play(); - * } - * } - * } - *
- */ - p5.SoundFile.prototype.addCue = function (time, callback, val) { - var id = this._cueIDCounter++; - var cue = new Cue(callback, time, id, val); - this._cues.push(cue); - // if (!this.elt.ontimeupdate) { - // this.elt.ontimeupdate = this._onTimeUpdate.bind(this); - // } - return id; - }; - /** - * 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 - */ - p5.SoundFile.prototype.removeCue = function (id) { - var cueLength = this._cues.length; - for (var i = 0; i < cueLength; i++) { - var cue = this._cues[i]; - if (cue.id === id) { - this.cues.splice(i, 1); - } - } - if (this._cues.length === 0) { - } - }; - /** - * Remove all of the callbacks that had originally been scheduled - * via the addCue method. - * - * @method clearCues - */ - p5.SoundFile.prototype.clearCues = function () { - this._cues = []; - }; - // private method that checks for cues to be fired if events - // have been scheduled using addCue(callback, time). - p5.SoundFile.prototype._onTimeUpdate = function (position) { - var playbackTime = position / this.buffer.sampleRate; - var cueLength = this._cues.length; - for (var i = 0; i < cueLength; i++) { - var cue = this._cues[i]; - var callbackTime = cue.time; - var val = cue.val; - if (this._prevTime < callbackTime && callbackTime <= playbackTime) { - // pass the scheduled callbackTime as parameter to the callback - cue.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; - }; -}(sndcore, errorHandler, master); -var amplitude; -amplitude = function () { - 'use strict'; - var p5sound = master; - /** - * Amplitude measures volume between 0.0 and 1.0. - * Listens to all p5sound by default, or use setInput() - * to listen to a specific sound source. Accepts an optional - * smoothing value, which defaults to 0. - * - * @class p5.Amplitude - * @constructor - * @param {Number} [smoothing] between 0.0 and .999 to smooth - * amplitude readings (defaults to 0) - * @return {Object} Amplitude Object - * @example - *
- * var sound, amplitude, cnv; - * - * function preload(){ - * sound = loadSound('assets/beat.mp3'); - * } - * function setup() { - * cnv = createCanvas(100,100); - * amplitude = new p5.Amplitude(); - * - * // start / stop the sound when canvas is clicked - * cnv.mouseClicked(function() { - * if (sound.isPlaying() ){ - * sound.stop(); - * } else { - * sound.play(); - * } - * }); - * } - * function draw() { - * background(0); - * fill(255); - * var level = amplitude.getLevel(); - * var size = map(level, 0, 1, 0, 200); - * ellipse(width/2, height/2, size, size); - * } - * - *
- */ - p5.Amplitude = function (smoothing) { - // Set to 2048 for now. In future iterations, this should be inherited or parsed from p5sound's default - this.bufferSize = 2048; - // set audio context - this.audiocontext = p5sound.audiocontext; - this.processor = this.audiocontext.createScriptProcessor(this.bufferSize, 2, 1); - // for connections - this.input = this.processor; - this.output = this.audiocontext.createGain(); - // smoothing defaults to 0 - this.smoothing = smoothing || 0; - // the variables to return - this.volume = 0; - this.average = 0; - this.stereoVol = [ - 0, - 0 - ]; - this.stereoAvg = [ - 0, - 0 - ]; - this.stereoVolNorm = [ - 0, - 0 - ]; - this.volMax = 0.001; - this.normalize = false; - this.processor.onaudioprocess = this._audioProcess.bind(this); - this.processor.connect(this.output); - this.output.gain.value = 0; - // this may only be necessary because of a Chrome bug - this.output.connect(this.audiocontext.destination); - // connect to p5sound master output by default, unless set by input() - p5sound.meter.connect(this.processor); - // add this p5.SoundFile to the soundArray - p5sound.soundArray.push(this); - }; - /** - * Connects to the p5sound instance (master output) by default. - * Optionally, you can pass in a specific source (i.e. a soundfile). - * - * @method setInput - * @param {soundObject|undefined} [snd] set the sound source - * (optional, defaults to - * master output) - * @param {Number|undefined} [smoothing] a range between 0.0 and 1.0 - * to smooth amplitude readings - * @example - *
- * function preload(){ - * sound1 = loadSound('assets/beat.mp3'); - * sound2 = loadSound('assets/drum.mp3'); - * } - * function setup(){ - * amplitude = new p5.Amplitude(); - * sound1.play(); - * sound2.play(); - * amplitude.setInput(sound2); - * } - * function draw() { - * background(0); - * fill(255); - * var level = amplitude.getLevel(); - * var size = map(level, 0, 1, 0, 200); - * ellipse(width/2, height/2, size, size); - * } - * function mouseClicked(){ - * sound1.stop(); - * sound2.stop(); - * } - *
- */ - p5.Amplitude.prototype.setInput = function (source, smoothing) { - p5sound.meter.disconnect(); - if (smoothing) { - this.smoothing = smoothing; - } - // connect to the master out of p5s instance if no snd is provided - if (source == null) { - console.log('Amplitude input source is not ready! Connecting to master output instead'); - p5sound.meter.connect(this.processor); - } else if (source instanceof p5.Signal) { - source.output.connect(this.processor); - } else if (source) { - source.connect(this.processor); - this.processor.disconnect(); - this.processor.connect(this.output); - } else { - p5sound.meter.connect(this.processor); - } - }; - p5.Amplitude.prototype.connect = function (unit) { - if (unit) { - if (unit.hasOwnProperty('input')) { - this.output.connect(unit.input); - } else { - this.output.connect(unit); - } - } else { - this.output.connect(this.panner.connect(p5sound.input)); - } - }; - p5.Amplitude.prototype.disconnect = function (unit) { - this.output.disconnect(); - }; - // TO DO make this stereo / dependent on # of audio channels - p5.Amplitude.prototype._audioProcess = function (event) { - for (var channel = 0; channel < event.inputBuffer.numberOfChannels; channel++) { - var inputBuffer = event.inputBuffer.getChannelData(channel); - var bufLength = inputBuffer.length; - var total = 0; - var sum = 0; - var x; - for (var i = 0; i < bufLength; i++) { - x = inputBuffer[i]; - if (this.normalize) { - total += Math.max(Math.min(x / this.volMax, 1), -1); - sum += Math.max(Math.min(x / this.volMax, 1), -1) * Math.max(Math.min(x / this.volMax, 1), -1); - } else { - total += x; - sum += x * x; - } - } - var average = total / bufLength; - // ... then take the square root of the sum. - var rms = Math.sqrt(sum / bufLength); - this.stereoVol[channel] = Math.max(rms, this.stereoVol[channel] * this.smoothing); - this.stereoAvg[channel] = Math.max(average, this.stereoVol[channel] * this.smoothing); - this.volMax = Math.max(this.stereoVol[channel], this.volMax); - } - // add volume from all channels together - var self = this; - var volSum = this.stereoVol.reduce(function (previousValue, currentValue, index) { - self.stereoVolNorm[index - 1] = Math.max(Math.min(self.stereoVol[index - 1] / self.volMax, 1), 0); - self.stereoVolNorm[index] = Math.max(Math.min(self.stereoVol[index] / self.volMax, 1), 0); - return previousValue + currentValue; - }); - // volume is average of channels - this.volume = volSum / this.stereoVol.length; - // normalized value - this.volNorm = Math.max(Math.min(this.volume / this.volMax, 1), 0); - }; - /** - * Returns a single Amplitude reading at the moment it is called. - * For continuous readings, run in the draw loop. - * - * @method getLevel - * @param {Number} [channel] Optionally return only channel 0 (left) or 1 (right) - * @return {Number} Amplitude as a number between 0.0 and 1.0 - * @example - *
- * function preload(){ - * sound = loadSound('assets/beat.mp3'); - * } - * function setup() { - * amplitude = new p5.Amplitude(); - * sound.play(); - * } - * function draw() { - * background(0); - * fill(255); - * var level = amplitude.getLevel(); - * var size = map(level, 0, 1, 0, 200); - * ellipse(width/2, height/2, size, size); - * } - * function mouseClicked(){ - * sound.stop(); - * } - *
- */ - p5.Amplitude.prototype.getLevel = function (channel) { - if (typeof channel !== 'undefined') { - if (this.normalize) { - return this.stereoVolNorm[channel]; - } else { - return this.stereoVol[channel]; - } - } else if (this.normalize) { - return this.volNorm; - } else { - return this.volume; - } - }; - /** - * Determines whether the results of Amplitude.process() will be - * Normalized. To normalize, Amplitude finds the difference the - * loudest reading it has processed and the maximum amplitude of - * 1.0. Amplitude adds this difference to all values to produce - * results that will reliably map between 0.0 and 1.0. However, - * if a louder moment occurs, the amount that Normalize adds to - * all the values will change. Accepts an optional boolean parameter - * (true or false). Normalizing is off by default. - * - * @method toggleNormalize - * @param {boolean} [boolean] set normalize to true (1) or false (0) - */ - p5.Amplitude.prototype.toggleNormalize = function (bool) { - if (typeof bool === 'boolean') { - this.normalize = bool; - } else { - this.normalize = !this.normalize; - } - }; - /** - * Smooth Amplitude analysis by averaging with the last analysis - * frame. Off by default. - * - * @method smooth - * @param {Number} set smoothing from 0.0 <= 1 - */ - p5.Amplitude.prototype.smooth = function (s) { - if (s >= 0 && s < 1) { - this.smoothing = s; - } else { - console.log('Error: smoothing must be between 0 and 1'); - } - }; - p5.Amplitude.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.input.disconnect(); - this.output.disconnect(); - this.input = this.processor = undefined; - this.output = undefined; - }; -}(master); -var fft; -fft = function () { - 'use strict'; - var p5sound = master; - /** - *

FFT (Fast Fourier Transform) is an analysis algorithm that - * isolates individual - * - * audio frequencies within a waveform.

- * - *

Once instantiated, a p5.FFT object can return an array based on - * two types of analyses:
• FFT.waveform() computes - * amplitude values along the time domain. The array indices correspond - * to samples across a brief moment in time. Each value represents - * amplitude of the waveform at that sample of time.
- * • FFT.analyze() computes amplitude values along the - * frequency domain. The array indices correspond to frequencies (i.e. - * pitches), from the lowest to the highest that humans can hear. Each - * value represents amplitude at that slice of the frequency spectrum. - * Use with getEnergy() to measure amplitude at specific - * frequencies, or within a range of frequencies.

- * - *

FFT analyzes a very short snapshot of sound called a sample - * buffer. It returns an array of amplitude measurements, referred - * to as bins. The array is 1024 bins long by default. - * You can change the bin array length, but it must be a power of 2 - * between 16 and 1024 in order for the FFT algorithm to function - * correctly. The actual size of the FFT buffer is twice the - * number of bins, so given a standard sample rate, the buffer is - * 2048/44100 seconds long.

- * - * - * @class p5.FFT - * @constructor - * @param {Number} [smoothing] Smooth results of Freq Spectrum. - * 0.0 < smoothing < 1.0. - * Defaults to 0.8. - * @param {Number} [bins] Length of resulting array. - * Must be a power of two between - * 16 and 1024. Defaults to 1024. - * @return {Object} FFT Object - * @example - *
- * function preload(){ - * sound = loadSound('assets/Damscray_DancingTiger.mp3'); - * } - * - * function setup(){ - * var cnv = createCanvas(100,100); - * cnv.mouseClicked(togglePlay); - * fft = new p5.FFT(); - * sound.amp(0.2); - * } - * - * function draw(){ - * background(0); - * - * var spectrum = fft.analyze(); - * noStroke(); - * fill(0,255,0); // spectrum is green - * for (var i = 0; i< spectrum.length; i++){ - * var x = map(i, 0, spectrum.length, 0, width); - * var h = -height + map(spectrum[i], 0, 255, height, 0); - * rect(x, height, width / spectrum.length, h ) - * } - * - * var waveform = fft.waveform(); - * noFill(); - * beginShape(); - * stroke(255,0,0); // waveform is red - * strokeWeight(1); - * for (var i = 0; i< waveform.length; i++){ - * var x = map(i, 0, waveform.length, 0, width); - * var y = map( waveform[i], -1, 1, 0, height); - * vertex(x,y); - * } - * endShape(); - * - * text('click to play/pause', 4, 10); - * } - * - * // fade sound if mouse is over canvas - * function togglePlay() { - * if (sound.isPlaying()) { - * sound.pause(); - * } else { - * sound.loop(); - * } - * } - *
- */ - p5.FFT = function (smoothing, bins) { - this.smoothing = smoothing || 0.8; - this.bins = bins || 1024; - var FFT_SIZE = bins * 2 || 2048; - this.input = this.analyser = p5sound.audiocontext.createAnalyser(); - // default connections to p5sound fftMeter - p5sound.fftMeter.connect(this.analyser); - this.analyser.smoothingTimeConstant = this.smoothing; - this.analyser.fftSize = FFT_SIZE; - this.freqDomain = new Uint8Array(this.analyser.frequencyBinCount); - this.timeDomain = new Uint8Array(this.analyser.frequencyBinCount); - // predefined frequency ranages, these will be tweakable - this.bass = [ - 20, - 140 - ]; - this.lowMid = [ - 140, - 400 - ]; - this.mid = [ - 400, - 2600 - ]; - this.highMid = [ - 2600, - 5200 - ]; - this.treble = [ - 5200, - 14000 - ]; - // add this p5.SoundFile to the soundArray - p5sound.soundArray.push(this); - }; - /** - * Set the input source for the FFT analysis. If no source is - * provided, FFT will analyze all sound in the sketch. - * - * @method setInput - * @param {Object} [source] p5.sound object (or web audio API source node) - */ - p5.FFT.prototype.setInput = function (source) { - if (!source) { - p5sound.fftMeter.connect(this.analyser); - } else { - if (source.output) { - source.output.connect(this.analyser); - } else if (source.connect) { - source.connect(this.analyser); - } - p5sound.fftMeter.disconnect(); - } - }; - /** - * Returns an array of amplitude values (between -1.0 and +1.0) that represent - * a snapshot of amplitude readings in a single buffer. Length will be - * equal to bins (defaults to 1024). Can be used to draw the waveform - * of a sound. - * - * @method waveform - * @param {Number} [bins] Must be a power of two between - * 16 and 1024. Defaults to 1024. - * @param {String} [precision] If any value is provided, will return results - * in a Float32 Array which is more precise - * than a regular array. - * @return {Array} Array Array of amplitude values (-1 to 1) - * over time. Array length = bins. - * - */ - p5.FFT.prototype.waveform = function () { - var bins, mode, normalArray; - for (var i = 0; i < arguments.length; i++) { - if (typeof arguments[i] === 'number') { - bins = arguments[i]; - this.analyser.fftSize = bins * 2; - } - if (typeof arguments[i] === 'string') { - mode = arguments[i]; - } - } - // getFloatFrequencyData doesnt work in Safari as of 5/2015 - if (mode && !p5.prototype._isSafari()) { - timeToFloat(this, this.timeDomain); - this.analyser.getFloatTimeDomainData(this.timeDomain); - return this.timeDomain; - } else { - timeToInt(this, this.timeDomain); - this.analyser.getByteTimeDomainData(this.timeDomain); - var normalArray = new Array(); - for (var i = 0; i < this.timeDomain.length; i++) { - var scaled = p5.prototype.map(this.timeDomain[i], 0, 255, -1, 1); - normalArray.push(scaled); - } - return normalArray; - } - }; - /** - * Returns an array of amplitude values (between 0 and 255) - * across the frequency spectrum. Length is equal to FFT bins - * (1024 by default). The array indices correspond to frequencies - * (i.e. pitches), from the lowest to the highest that humans can - * hear. Each value represents amplitude at that slice of the - * frequency spectrum. Must be called prior to using - * getEnergy(). - * - * @method analyze - * @param {Number} [bins] Must be a power of two between - * 16 and 1024. Defaults to 1024. - * @param {Number} [scale] If "dB," returns decibel - * float measurements between - * -140 and 0 (max). - * Otherwise returns integers from 0-255. - * @return {Array} spectrum Array of energy (amplitude/volume) - * values across the frequency spectrum. - * Lowest energy (silence) = 0, highest - * possible is 255. - * @example - *
- * var osc; - * var fft; - * - * function setup(){ - * createCanvas(100,100); - * osc = new p5.Oscillator(); - * osc.amp(0); - * osc.start(); - * fft = new p5.FFT(); - * } - * - * function draw(){ - * background(0); - * - * var freq = map(mouseX, 0, 800, 20, 15000); - * freq = constrain(freq, 1, 20000); - * osc.freq(freq); - * - * var spectrum = fft.analyze(); - * noStroke(); - * fill(0,255,0); // spectrum is green - * for (var i = 0; i< spectrum.length; i++){ - * var x = map(i, 0, spectrum.length, 0, width); - * var h = -height + map(spectrum[i], 0, 255, height, 0); - * rect(x, height, width / spectrum.length, h ); - * } - * - * stroke(255); - * text('Freq: ' + round(freq)+'Hz', 10, 10); - * - * isMouseOverCanvas(); - * } - * - * // only play sound when mouse is over canvas - * function isMouseOverCanvas() { - * var mX = mouseX, mY = mouseY; - * if (mX > 0 && mX < width && mY < height && mY > 0) { - * osc.amp(0.5, 0.2); - * } else { - * osc.amp(0, 0.2); - * } - * } - *
- * - * - */ - p5.FFT.prototype.analyze = function () { - var bins, mode; - for (var i = 0; i < arguments.length; i++) { - if (typeof arguments[i] === 'number') { - bins = this.bins = arguments[i]; - this.analyser.fftSize = this.bins * 2; - } - if (typeof arguments[i] === 'string') { - mode = arguments[i]; - } - } - if (mode && mode.toLowerCase() === 'db') { - freqToFloat(this); - this.analyser.getFloatFrequencyData(this.freqDomain); - return this.freqDomain; - } else { - freqToInt(this, this.freqDomain); - this.analyser.getByteFrequencyData(this.freqDomain); - var normalArray = Array.apply([], this.freqDomain); - normalArray.length === this.analyser.fftSize; - normalArray.constructor === Array; - return normalArray; - } - }; - /** - * Returns the amount of energy (volume) at a specific - * - * frequency, or the average amount of energy between two - * frequencies. Accepts Number(s) corresponding - * to frequency (in Hz), or a String corresponding to predefined - * frequency ranges ("bass", "lowMid", "mid", "highMid", "treble"). - * Returns a range between 0 (no energy/volume at that frequency) and - * 255 (maximum energy). - * NOTE: analyze() must be called prior to getEnergy(). Analyze() - * tells the FFT to analyze frequency data, and getEnergy() uses - * the results determine the value at a specific frequency or - * range of frequencies.

- * - * @method getEnergy - * @param {Number|String} frequency1 Will return a value representing - * energy at this frequency. Alternately, - * the strings "bass", "lowMid" "mid", - * "highMid", and "treble" will return - * predefined frequency ranges. - * @param {Number} [frequency2] If a second frequency is given, - * will return average amount of - * energy that exists between the - * two frequencies. - * @return {Number} Energy Energy (volume/amplitude) from - * 0 and 255. - * - */ - p5.FFT.prototype.getEnergy = function (frequency1, frequency2) { - var nyquist = p5sound.audiocontext.sampleRate / 2; - if (frequency1 === 'bass') { - frequency1 = this.bass[0]; - frequency2 = this.bass[1]; - } else if (frequency1 === 'lowMid') { - frequency1 = this.lowMid[0]; - frequency2 = this.lowMid[1]; - } else if (frequency1 === 'mid') { - frequency1 = this.mid[0]; - frequency2 = this.mid[1]; - } else if (frequency1 === 'highMid') { - frequency1 = this.highMid[0]; - frequency2 = this.highMid[1]; - } else if (frequency1 === 'treble') { - frequency1 = this.treble[0]; - frequency2 = this.treble[1]; - } - if (typeof frequency1 !== 'number') { - throw 'invalid input for getEnergy()'; - } else if (!frequency2) { - var index = Math.round(frequency1 / nyquist * this.freqDomain.length); - return this.freqDomain[index]; - } else if (frequency1 && frequency2) { - // if second is higher than first - if (frequency1 > frequency2) { - var swap = frequency2; - frequency2 = frequency1; - frequency1 = swap; - } - var lowIndex = Math.round(frequency1 / nyquist * this.freqDomain.length); - var highIndex = Math.round(frequency2 / nyquist * this.freqDomain.length); - var total = 0; - var numFrequencies = 0; - // add up all of the values for the frequencies - for (var i = lowIndex; i <= highIndex; i++) { - total += this.freqDomain[i]; - numFrequencies += 1; - } - // divide by total number of frequencies - var toReturn = total / numFrequencies; - return toReturn; - } else { - throw 'invalid input for getEnergy()'; - } - }; - // compatability with v.012, changed to getEnergy in v.0121. Will be deprecated... - p5.FFT.prototype.getFreq = function (freq1, freq2) { - console.log('getFreq() is deprecated. Please use getEnergy() instead.'); - var x = this.getEnergy(freq1, freq2); - return x; - }; - /** - * Returns the - * - * spectral centroid of the input signal. - * NOTE: analyze() must be called prior to getCentroid(). Analyze() - * tells the FFT to analyze frequency data, and getCentroid() uses - * the results determine the spectral centroid.

- * - * @method getCentroid - * @return {Number} Spectral Centroid Frequency Frequency of the spectral centroid in Hz. - * - * - * @example - *
- * - * - *function setup(){ - * cnv = createCanvas(800,400); - * sound = new p5.AudioIn(); - * sound.start(); - * fft = new p5.FFT(); - * sound.connect(fft); - *} - * - * - *function draw(){ - * - * var centroidplot = 0.0; - * var spectralCentroid = 0; - * - * - * background(0); - * stroke(0,255,0); - * var spectrum = fft.analyze(); - * fill(0,255,0); // spectrum is green - * - * //draw the spectrum - * - * for (var i = 0; i< spectrum.length; i++){ - * var x = map(log(i), 0, log(spectrum.length), 0, width); - * var h = map(spectrum[i], 0, 255, 0, height); - * var rectangle_width = (log(i+1)-log(i))*(width/log(spectrum.length)); - * rect(x, height, rectangle_width, -h ) - * } - - * var nyquist = 22050; - * - * // get the centroid - * spectralCentroid = fft.getCentroid(); - * - * // the mean_freq_index calculation is for the display. - * var mean_freq_index = spectralCentroid/(nyquist/spectrum.length); - * - * centroidplot = map(log(mean_freq_index), 0, log(spectrum.length), 0, width); - * - * - * stroke(255,0,0); // the line showing where the centroid is will be red - * - * rect(centroidplot, 0, width / spectrum.length, height) - * noStroke(); - * fill(255,255,255); // text is white - * textSize(40); - * text("centroid: "+round(spectralCentroid)+" Hz", 10, 40); - *} - *
- */ - p5.FFT.prototype.getCentroid = function () { - var nyquist = p5sound.audiocontext.sampleRate / 2; - var cumulative_sum = 0; - var centroid_normalization = 0; - for (var i = 0; i < this.freqDomain.length; i++) { - cumulative_sum += i * this.freqDomain[i]; - centroid_normalization += this.freqDomain[i]; - } - var mean_freq_index = 0; - if (centroid_normalization != 0) { - mean_freq_index = cumulative_sum / centroid_normalization; - } - var spec_centroid_freq = mean_freq_index * (nyquist / this.freqDomain.length); - return spec_centroid_freq; - }; - /** - * Smooth FFT analysis by averaging with the last analysis frame. - * - * @method smooth - * @param {Number} smoothing 0.0 < smoothing < 1.0. - * Defaults to 0.8. - */ - p5.FFT.prototype.smooth = function (s) { - if (s) { - this.smoothing = s; - } - this.analyser.smoothingTimeConstant = s; - }; - p5.FFT.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.analyser.disconnect(); - this.analyser = undefined; - }; - /** - * Returns an array of average amplitude values for a given number - * of frequency bands split equally. N defaults to 16. - * NOTE: analyze() must be called prior to linAverages(). Analyze() - * tells the FFT to analyze frequency data, and linAverages() uses - * the results to group them into a smaller set of averages.

- * - * @method linAverages - * @param {Number} N Number of returned frequency groups - * @return {Array} linearAverages Array of average amplitude values for each group - */ - p5.FFT.prototype.linAverages = function (N) { - var N = N || 16; - // This prevents undefined, null or 0 values of N - var spectrum = this.freqDomain; - var spectrumLength = spectrum.length; - var spectrumStep = Math.floor(spectrumLength / N); - var linearAverages = new Array(N); - // Keep a second index for the current average group and place the values accordingly - // with only one loop in the spectrum data - var groupIndex = 0; - for (var specIndex = 0; specIndex < spectrumLength; specIndex++) { - linearAverages[groupIndex] = linearAverages[groupIndex] !== undefined ? (linearAverages[groupIndex] + spectrum[specIndex]) / 2 : spectrum[specIndex]; - // Increase the group index when the last element of the group is processed - if (specIndex % spectrumStep == spectrumStep - 1) { - groupIndex++; - } - } - return linearAverages; - }; - /** - * Returns an array of average amplitude values of the spectrum, for a given - * set of - * Octave Bands - * NOTE: analyze() must be called prior to logAverages(). Analyze() - * tells the FFT to analyze frequency data, and logAverages() uses - * the results to group them into a smaller set of averages.

- * - * @method logAverages - * @param {Array} octaveBands Array of Octave Bands objects for grouping - * @return {Array} logAverages Array of average amplitude values for each group - */ - p5.FFT.prototype.logAverages = function (octaveBands) { - var nyquist = p5sound.audiocontext.sampleRate / 2; - var spectrum = this.freqDomain; - var spectrumLength = spectrum.length; - var logAverages = new Array(octaveBands.length); - // Keep a second index for the current average group and place the values accordingly - // With only one loop in the spectrum data - var octaveIndex = 0; - for (var specIndex = 0; specIndex < spectrumLength; specIndex++) { - var specIndexFrequency = Math.round(specIndex * nyquist / this.freqDomain.length); - // Increase the group index if the current frequency exceeds the limits of the band - if (specIndexFrequency > octaveBands[octaveIndex].hi) { - octaveIndex++; - } - logAverages[octaveIndex] = logAverages[octaveIndex] !== undefined ? (logAverages[octaveIndex] + spectrum[specIndex]) / 2 : spectrum[specIndex]; - } - return logAverages; - }; - /** - * Calculates and Returns the 1/N - * Octave Bands - * N defaults to 3 and minimum central frequency to 15.625Hz. - * (1/3 Octave Bands ~= 31 Frequency Bands) - * Setting fCtr0 to a central value of a higher octave will ignore the lower bands - * and produce less frequency groups. - * - * @method getOctaveBands - * @param {Number} N Specifies the 1/N type of generated octave bands - * @param {Number} fCtr0 Minimum central frequency for the lowest band - * @return {Array} octaveBands Array of octave band objects with their bounds - */ - p5.FFT.prototype.getOctaveBands = function (N, fCtr0) { - var N = N || 3; - // Default to 1/3 Octave Bands - var fCtr0 = fCtr0 || 15.625; - // Minimum central frequency, defaults to 15.625Hz - var octaveBands = []; - var lastFrequencyBand = { - lo: fCtr0 / Math.pow(2, 1 / (2 * N)), - ctr: fCtr0, - hi: fCtr0 * Math.pow(2, 1 / (2 * N)) - }; - octaveBands.push(lastFrequencyBand); - var nyquist = p5sound.audiocontext.sampleRate / 2; - while (lastFrequencyBand.hi < nyquist) { - var newFrequencyBand = {}; - newFrequencyBand.lo = lastFrequencyBand.hi, newFrequencyBand.ctr = lastFrequencyBand.ctr * Math.pow(2, 1 / N), newFrequencyBand.hi = newFrequencyBand.ctr * Math.pow(2, 1 / (2 * N)), octaveBands.push(newFrequencyBand); - lastFrequencyBand = newFrequencyBand; - } - return octaveBands; - }; - // helper methods to convert type from float (dB) to int (0-255) - var freqToFloat = function (fft) { - if (fft.freqDomain instanceof Float32Array === false) { - fft.freqDomain = new Float32Array(fft.analyser.frequencyBinCount); - } - }; - var freqToInt = function (fft) { - if (fft.freqDomain instanceof Uint8Array === false) { - fft.freqDomain = new Uint8Array(fft.analyser.frequencyBinCount); - } - }; - var timeToFloat = function (fft) { - if (fft.timeDomain instanceof Float32Array === false) { - fft.timeDomain = new Float32Array(fft.analyser.frequencyBinCount); - } - }; - var timeToInt = function (fft) { - if (fft.timeDomain instanceof Uint8Array === false) { - fft.timeDomain = new Uint8Array(fft.analyser.frequencyBinCount); - } - }; -}(master); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_core_Tone; -Tone_core_Tone = function () { - 'use strict'; - function isUndef(val) { - return val === void 0; - } - function isFunction(val) { - return typeof val === 'function'; - } - var audioContext; - if (isUndef(window.AudioContext)) { - window.AudioContext = window.webkitAudioContext; - } - if (isUndef(window.OfflineAudioContext)) { - window.OfflineAudioContext = window.webkitOfflineAudioContext; - } - if (!isUndef(AudioContext)) { - audioContext = new AudioContext(); - } else { - throw new Error('Web Audio is not supported in this browser'); - } - if (!isFunction(AudioContext.prototype.createGain)) { - AudioContext.prototype.createGain = AudioContext.prototype.createGainNode; - } - if (!isFunction(AudioContext.prototype.createDelay)) { - AudioContext.prototype.createDelay = AudioContext.prototype.createDelayNode; - } - if (!isFunction(AudioContext.prototype.createPeriodicWave)) { - AudioContext.prototype.createPeriodicWave = AudioContext.prototype.createWaveTable; - } - if (!isFunction(AudioBufferSourceNode.prototype.start)) { - AudioBufferSourceNode.prototype.start = AudioBufferSourceNode.prototype.noteGrainOn; - } - if (!isFunction(AudioBufferSourceNode.prototype.stop)) { - AudioBufferSourceNode.prototype.stop = AudioBufferSourceNode.prototype.noteOff; - } - if (!isFunction(OscillatorNode.prototype.start)) { - OscillatorNode.prototype.start = OscillatorNode.prototype.noteOn; - } - if (!isFunction(OscillatorNode.prototype.stop)) { - OscillatorNode.prototype.stop = OscillatorNode.prototype.noteOff; - } - if (!isFunction(OscillatorNode.prototype.setPeriodicWave)) { - OscillatorNode.prototype.setPeriodicWave = OscillatorNode.prototype.setWaveTable; - } - AudioNode.prototype._nativeConnect = AudioNode.prototype.connect; - AudioNode.prototype.connect = function (B, outNum, inNum) { - if (B.input) { - if (Array.isArray(B.input)) { - if (isUndef(inNum)) { - inNum = 0; - } - this.connect(B.input[inNum]); - } else { - this.connect(B.input, outNum, inNum); - } - } else { - try { - if (B instanceof AudioNode) { - this._nativeConnect(B, outNum, inNum); - } else { - this._nativeConnect(B, outNum); - } - } catch (e) { - throw new Error('error connecting to node: ' + B); - } - } - }; - var Tone = function (inputs, outputs) { - if (isUndef(inputs) || inputs === 1) { - this.input = this.context.createGain(); - } else if (inputs > 1) { - this.input = new Array(inputs); - } - if (isUndef(outputs) || outputs === 1) { - this.output = this.context.createGain(); - } else if (outputs > 1) { - this.output = new Array(inputs); - } - }; - Tone.prototype.set = function (params, value, rampTime) { - if (this.isObject(params)) { - rampTime = value; - } else if (this.isString(params)) { - var tmpObj = {}; - tmpObj[params] = value; - params = tmpObj; - } - for (var attr in params) { - value = params[attr]; - var parent = this; - if (attr.indexOf('.') !== -1) { - var attrSplit = attr.split('.'); - for (var i = 0; i < attrSplit.length - 1; i++) { - parent = parent[attrSplit[i]]; - } - attr = attrSplit[attrSplit.length - 1]; - } - var param = parent[attr]; - if (isUndef(param)) { - continue; - } - if (Tone.Signal && param instanceof Tone.Signal || Tone.Param && param instanceof Tone.Param) { - if (param.value !== value) { - if (isUndef(rampTime)) { - param.value = value; - } else { - param.rampTo(value, rampTime); - } - } - } else if (param instanceof AudioParam) { - if (param.value !== value) { - param.value = value; - } - } else if (param instanceof Tone) { - param.set(value); - } else if (param !== value) { - parent[attr] = value; - } - } - return this; - }; - Tone.prototype.get = function (params) { - if (isUndef(params)) { - params = this._collectDefaults(this.constructor); - } else if (this.isString(params)) { - params = [params]; - } - var ret = {}; - for (var i = 0; i < params.length; i++) { - var attr = params[i]; - var parent = this; - var subRet = ret; - if (attr.indexOf('.') !== -1) { - var attrSplit = attr.split('.'); - for (var j = 0; j < attrSplit.length - 1; j++) { - var subAttr = attrSplit[j]; - subRet[subAttr] = subRet[subAttr] || {}; - subRet = subRet[subAttr]; - parent = parent[subAttr]; - } - attr = attrSplit[attrSplit.length - 1]; - } - var param = parent[attr]; - if (this.isObject(params[attr])) { - subRet[attr] = param.get(); - } else if (Tone.Signal && param instanceof Tone.Signal) { - subRet[attr] = param.value; - } else if (Tone.Param && param instanceof Tone.Param) { - subRet[attr] = param.value; - } else if (param instanceof AudioParam) { - subRet[attr] = param.value; - } else if (param instanceof Tone) { - subRet[attr] = param.get(); - } else if (!isFunction(param) && !isUndef(param)) { - subRet[attr] = param; - } - } - return ret; - }; - Tone.prototype._collectDefaults = function (constr) { - var ret = []; - if (!isUndef(constr.defaults)) { - ret = Object.keys(constr.defaults); - } - if (!isUndef(constr._super)) { - var superDefs = this._collectDefaults(constr._super); - for (var i = 0; i < superDefs.length; i++) { - if (ret.indexOf(superDefs[i]) === -1) { - ret.push(superDefs[i]); - } - } - } - return ret; - }; - Tone.prototype.toString = function () { - for (var className in Tone) { - var isLetter = className[0].match(/^[A-Z]$/); - var sameConstructor = Tone[className] === this.constructor; - if (isFunction(Tone[className]) && isLetter && sameConstructor) { - return className; - } - } - return 'Tone'; - }; - Tone.context = audioContext; - Tone.prototype.context = Tone.context; - Tone.prototype.bufferSize = 2048; - Tone.prototype.blockTime = 128 / Tone.context.sampleRate; - Tone.prototype.dispose = function () { - if (!this.isUndef(this.input)) { - if (this.input instanceof AudioNode) { - this.input.disconnect(); - } - this.input = null; - } - if (!this.isUndef(this.output)) { - if (this.output instanceof AudioNode) { - this.output.disconnect(); - } - this.output = null; - } - return this; - }; - var _silentNode = null; - Tone.prototype.noGC = function () { - this.output.connect(_silentNode); - return this; - }; - AudioNode.prototype.noGC = function () { - this.connect(_silentNode); - return this; - }; - Tone.prototype.connect = function (unit, outputNum, inputNum) { - if (Array.isArray(this.output)) { - outputNum = this.defaultArg(outputNum, 0); - this.output[outputNum].connect(unit, 0, inputNum); - } else { - this.output.connect(unit, outputNum, inputNum); - } - return this; - }; - Tone.prototype.disconnect = function (outputNum) { - if (Array.isArray(this.output)) { - outputNum = this.defaultArg(outputNum, 0); - this.output[outputNum].disconnect(); - } else { - this.output.disconnect(); - } - return this; - }; - Tone.prototype.connectSeries = function () { - if (arguments.length > 1) { - var currentUnit = arguments[0]; - for (var i = 1; i < arguments.length; i++) { - var toUnit = arguments[i]; - currentUnit.connect(toUnit); - currentUnit = toUnit; - } - } - return this; - }; - Tone.prototype.connectParallel = function () { - var connectFrom = arguments[0]; - if (arguments.length > 1) { - for (var i = 1; i < arguments.length; i++) { - var connectTo = arguments[i]; - connectFrom.connect(connectTo); - } - } - return this; - }; - Tone.prototype.chain = function () { - if (arguments.length > 0) { - var currentUnit = this; - for (var i = 0; i < arguments.length; i++) { - var toUnit = arguments[i]; - currentUnit.connect(toUnit); - currentUnit = toUnit; - } - } - return this; - }; - Tone.prototype.fan = function () { - if (arguments.length > 0) { - for (var i = 0; i < arguments.length; i++) { - this.connect(arguments[i]); - } - } - return this; - }; - AudioNode.prototype.chain = Tone.prototype.chain; - AudioNode.prototype.fan = Tone.prototype.fan; - Tone.prototype.defaultArg = function (given, fallback) { - if (this.isObject(given) && this.isObject(fallback)) { - var ret = {}; - for (var givenProp in given) { - ret[givenProp] = this.defaultArg(fallback[givenProp], given[givenProp]); - } - for (var fallbackProp in fallback) { - ret[fallbackProp] = this.defaultArg(given[fallbackProp], fallback[fallbackProp]); - } - return ret; - } else { - return isUndef(given) ? fallback : given; - } - }; - Tone.prototype.optionsObject = function (values, keys, defaults) { - var options = {}; - if (values.length === 1 && this.isObject(values[0])) { - options = values[0]; - } else { - for (var i = 0; i < keys.length; i++) { - options[keys[i]] = values[i]; - } - } - if (!this.isUndef(defaults)) { - return this.defaultArg(options, defaults); - } else { - return options; - } - }; - Tone.prototype.isUndef = isUndef; - Tone.prototype.isFunction = isFunction; - Tone.prototype.isNumber = function (arg) { - return typeof arg === 'number'; - }; - Tone.prototype.isObject = function (arg) { - return Object.prototype.toString.call(arg) === '[object Object]' && arg.constructor === Object; - }; - Tone.prototype.isBoolean = function (arg) { - return typeof arg === 'boolean'; - }; - Tone.prototype.isArray = function (arg) { - return Array.isArray(arg); - }; - Tone.prototype.isString = function (arg) { - return typeof arg === 'string'; - }; - Tone.noOp = function () { - }; - Tone.prototype._readOnly = function (property) { - if (Array.isArray(property)) { - for (var i = 0; i < property.length; i++) { - this._readOnly(property[i]); - } - } else { - Object.defineProperty(this, property, { - writable: false, - enumerable: true - }); - } - }; - Tone.prototype._writable = function (property) { - if (Array.isArray(property)) { - for (var i = 0; i < property.length; i++) { - this._writable(property[i]); - } - } else { - Object.defineProperty(this, property, { writable: true }); - } - }; - Tone.State = { - Started: 'started', - Stopped: 'stopped', - Paused: 'paused' - }; - Tone.prototype.equalPowerScale = function (percent) { - var piFactor = 0.5 * Math.PI; - return Math.sin(percent * piFactor); - }; - Tone.prototype.dbToGain = function (db) { - return Math.pow(2, db / 6); - }; - Tone.prototype.gainToDb = function (gain) { - return 20 * (Math.log(gain) / Math.LN10); - }; - Tone.prototype.now = function () { - return this.context.currentTime; - }; - Tone.extend = function (child, parent) { - if (isUndef(parent)) { - parent = Tone; - } - function TempConstructor() { - } - TempConstructor.prototype = parent.prototype; - child.prototype = new TempConstructor(); - child.prototype.constructor = child; - child._super = parent; - }; - var newContextCallbacks = []; - Tone._initAudioContext = function (callback) { - callback(Tone.context); - newContextCallbacks.push(callback); - }; - Tone.setContext = function (ctx) { - Tone.prototype.context = ctx; - Tone.context = ctx; - for (var i = 0; i < newContextCallbacks.length; i++) { - newContextCallbacks[i](ctx); - } - }; - Tone.startMobile = function () { - var osc = Tone.context.createOscillator(); - var silent = Tone.context.createGain(); - silent.gain.value = 0; - osc.connect(silent); - silent.connect(Tone.context.destination); - var now = Tone.context.currentTime; - osc.start(now); - osc.stop(now + 1); - }; - Tone._initAudioContext(function (audioContext) { - Tone.prototype.blockTime = 128 / audioContext.sampleRate; - _silentNode = audioContext.createGain(); - _silentNode.gain.value = 0; - _silentNode.connect(audioContext.destination); - }); - Tone.version = 'r7-dev'; - return Tone; -}(); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_signal_SignalBase; -Tone_signal_SignalBase = function (Tone) { - 'use strict'; - Tone.SignalBase = function () { - }; - Tone.extend(Tone.SignalBase); - Tone.SignalBase.prototype.connect = function (node, outputNumber, inputNumber) { - if (Tone.Signal && Tone.Signal === node.constructor || Tone.Param && Tone.Param === node.constructor || Tone.TimelineSignal && Tone.TimelineSignal === node.constructor) { - node._param.cancelScheduledValues(0); - node._param.value = 0; - node.overridden = true; - } else if (node instanceof AudioParam) { - node.cancelScheduledValues(0); - node.value = 0; - } - Tone.prototype.connect.call(this, node, outputNumber, inputNumber); - return this; - }; - return Tone.SignalBase; -}(Tone_core_Tone); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_signal_WaveShaper; -Tone_signal_WaveShaper = function (Tone) { - 'use strict'; - Tone.WaveShaper = function (mapping, bufferLen) { - this._shaper = this.input = this.output = this.context.createWaveShaper(); - this._curve = null; - if (Array.isArray(mapping)) { - this.curve = mapping; - } else if (isFinite(mapping) || this.isUndef(mapping)) { - this._curve = new Float32Array(this.defaultArg(mapping, 1024)); - } else if (this.isFunction(mapping)) { - this._curve = new Float32Array(this.defaultArg(bufferLen, 1024)); - this.setMap(mapping); - } - }; - Tone.extend(Tone.WaveShaper, Tone.SignalBase); - Tone.WaveShaper.prototype.setMap = function (mapping) { - for (var i = 0, len = this._curve.length; i < len; i++) { - var normalized = i / len * 2 - 1; - this._curve[i] = mapping(normalized, i); - } - this._shaper.curve = this._curve; - return this; - }; - Object.defineProperty(Tone.WaveShaper.prototype, 'curve', { - get: function () { - return this._shaper.curve; - }, - set: function (mapping) { - this._curve = new Float32Array(mapping); - this._shaper.curve = this._curve; - } - }); - Object.defineProperty(Tone.WaveShaper.prototype, 'oversample', { - get: function () { - return this._shaper.oversample; - }, - set: function (oversampling) { - if ([ - 'none', - '2x', - '4x' - ].indexOf(oversampling) !== -1) { - this._shaper.oversample = oversampling; - } else { - throw new Error('invalid oversampling: ' + oversampling); - } - } - }); - Tone.WaveShaper.prototype.dispose = function () { - Tone.prototype.dispose.call(this); - this._shaper.disconnect(); - this._shaper = null; - this._curve = null; - return this; - }; - return Tone.WaveShaper; -}(Tone_core_Tone); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_core_Type; -Tone_core_Type = function (Tone) { - 'use strict'; - Tone.Type = { - Default: 'number', - Time: 'time', - Frequency: 'frequency', - NormalRange: 'normalRange', - AudioRange: 'audioRange', - Decibels: 'db', - Interval: 'interval', - BPM: 'bpm', - Positive: 'positive', - Cents: 'cents', - Degrees: 'degrees', - MIDI: 'midi', - TransportTime: 'transportTime', - Ticks: 'tick', - Note: 'note', - Milliseconds: 'milliseconds', - Notation: 'notation' - }; - Tone.prototype.isNowRelative = function () { - var nowRelative = new RegExp(/^\s*\+(.)+/i); - return function (note) { - return nowRelative.test(note); - }; - }(); - Tone.prototype.isTicks = function () { - var tickFormat = new RegExp(/^\d+i$/i); - return function (note) { - return tickFormat.test(note); - }; - }(); - Tone.prototype.isNotation = function () { - var notationFormat = new RegExp(/^[0-9]+[mnt]$/i); - return function (note) { - return notationFormat.test(note); - }; - }(); - Tone.prototype.isTransportTime = function () { - var transportTimeFormat = new RegExp(/^(\d+(\.\d+)?\:){1,2}(\d+(\.\d+)?)?$/i); - return function (transportTime) { - return transportTimeFormat.test(transportTime); - }; - }(); - Tone.prototype.isNote = function () { - var noteFormat = new RegExp(/^[a-g]{1}(b|#|x|bb)?-?[0-9]+$/i); - return function (note) { - return noteFormat.test(note); - }; - }(); - Tone.prototype.isFrequency = function () { - var freqFormat = new RegExp(/^\d*\.?\d+hz$/i); - return function (freq) { - return freqFormat.test(freq); - }; - }(); - function getTransportBpm() { - if (Tone.Transport && Tone.Transport.bpm) { - return Tone.Transport.bpm.value; - } else { - return 120; - } - } - function getTransportTimeSignature() { - if (Tone.Transport && Tone.Transport.timeSignature) { - return Tone.Transport.timeSignature; - } else { - return 4; - } - } - Tone.prototype.notationToSeconds = function (notation, bpm, timeSignature) { - bpm = this.defaultArg(bpm, getTransportBpm()); - timeSignature = this.defaultArg(timeSignature, getTransportTimeSignature()); - var beatTime = 60 / bpm; - if (notation === '1n') { - notation = '1m'; - } - var subdivision = parseInt(notation, 10); - var beats = 0; - if (subdivision === 0) { - beats = 0; - } - var lastLetter = notation.slice(-1); - if (lastLetter === 't') { - beats = 4 / subdivision * 2 / 3; - } else if (lastLetter === 'n') { - beats = 4 / subdivision; - } else if (lastLetter === 'm') { - beats = subdivision * timeSignature; - } else { - beats = 0; - } - return beatTime * beats; - }; - Tone.prototype.transportTimeToSeconds = function (transportTime, bpm, timeSignature) { - bpm = this.defaultArg(bpm, getTransportBpm()); - timeSignature = this.defaultArg(timeSignature, getTransportTimeSignature()); - var measures = 0; - var quarters = 0; - var sixteenths = 0; - var split = transportTime.split(':'); - if (split.length === 2) { - measures = parseFloat(split[0]); - quarters = parseFloat(split[1]); - } else if (split.length === 1) { - quarters = parseFloat(split[0]); - } else if (split.length === 3) { - measures = parseFloat(split[0]); - quarters = parseFloat(split[1]); - sixteenths = parseFloat(split[2]); - } - var beats = measures * timeSignature + quarters + sixteenths / 4; - return beats * (60 / bpm); - }; - Tone.prototype.ticksToSeconds = function (ticks, bpm) { - if (this.isUndef(Tone.Transport)) { - return 0; - } - ticks = parseFloat(ticks); - bpm = this.defaultArg(bpm, getTransportBpm()); - var tickTime = 60 / bpm / Tone.Transport.PPQ; - return tickTime * ticks; - }; - Tone.prototype.frequencyToSeconds = function (freq) { - return 1 / parseFloat(freq); - }; - Tone.prototype.samplesToSeconds = function (samples) { - return samples / this.context.sampleRate; - }; - Tone.prototype.secondsToSamples = function (seconds) { - return seconds * this.context.sampleRate; - }; - Tone.prototype.secondsToTransportTime = function (seconds, bpm, timeSignature) { - bpm = this.defaultArg(bpm, getTransportBpm()); - timeSignature = this.defaultArg(timeSignature, getTransportTimeSignature()); - var quarterTime = 60 / bpm; - var quarters = seconds / quarterTime; - var measures = Math.floor(quarters / timeSignature); - var sixteenths = quarters % 1 * 4; - quarters = Math.floor(quarters) % timeSignature; - var progress = [ - measures, - quarters, - sixteenths - ]; - return progress.join(':'); - }; - Tone.prototype.secondsToFrequency = function (seconds) { - return 1 / seconds; - }; - Tone.prototype.toTransportTime = function (time, bpm, timeSignature) { - var seconds = this.toSeconds(time); - return this.secondsToTransportTime(seconds, bpm, timeSignature); - }; - Tone.prototype.toFrequency = function (freq, now) { - if (this.isFrequency(freq)) { - return parseFloat(freq); - } else if (this.isNotation(freq) || this.isTransportTime(freq)) { - return this.secondsToFrequency(this.toSeconds(freq, now)); - } else if (this.isNote(freq)) { - return this.noteToFrequency(freq); - } else { - return freq; - } - }; - Tone.prototype.toTicks = function (time) { - if (this.isUndef(Tone.Transport)) { - return 0; - } - var bpm = Tone.Transport.bpm.value; - var plusNow = 0; - if (this.isNowRelative(time)) { - time = time.replace('+', ''); - plusNow = Tone.Transport.ticks; - } else if (this.isUndef(time)) { - return Tone.Transport.ticks; - } - var seconds = this.toSeconds(time); - var quarter = 60 / bpm; - var quarters = seconds / quarter; - var tickNum = quarters * Tone.Transport.PPQ; - return Math.round(tickNum + plusNow); - }; - Tone.prototype.toSamples = function (time) { - var seconds = this.toSeconds(time); - return Math.round(seconds * this.context.sampleRate); - }; - Tone.prototype.toSeconds = function (time, now) { - now = this.defaultArg(now, this.now()); - if (this.isNumber(time)) { - return time; - } else if (this.isString(time)) { - var plusTime = 0; - if (this.isNowRelative(time)) { - time = time.replace('+', ''); - plusTime = now; - } - var betweenParens = time.match(/\(([^)(]+)\)/g); - if (betweenParens) { - for (var j = 0; j < betweenParens.length; j++) { - var symbol = betweenParens[j].replace(/[\(\)]/g, ''); - var symbolVal = this.toSeconds(symbol); - time = time.replace(betweenParens[j], symbolVal); - } - } - if (time.indexOf('@') !== -1) { - var quantizationSplit = time.split('@'); - if (!this.isUndef(Tone.Transport)) { - var toQuantize = quantizationSplit[0].trim(); - if (toQuantize === '') { - toQuantize = undefined; - } - if (plusTime > 0) { - toQuantize = '+' + toQuantize; - plusTime = 0; - } - var subdivision = quantizationSplit[1].trim(); - time = Tone.Transport.quantize(toQuantize, subdivision); - } else { - throw new Error('quantization requires Tone.Transport'); - } - } else { - var components = time.split(/[\(\)\-\+\/\*]/); - if (components.length > 1) { - var originalTime = time; - for (var i = 0; i < components.length; i++) { - var symb = components[i].trim(); - if (symb !== '') { - var val = this.toSeconds(symb); - time = time.replace(symb, val); - } - } - try { - time = eval(time); - } catch (e) { - throw new EvalError('cannot evaluate Time: ' + originalTime); - } - } else if (this.isNotation(time)) { - time = this.notationToSeconds(time); - } else if (this.isTransportTime(time)) { - time = this.transportTimeToSeconds(time); - } else if (this.isFrequency(time)) { - time = this.frequencyToSeconds(time); - } else if (this.isTicks(time)) { - time = this.ticksToSeconds(time); - } else { - time = parseFloat(time); - } - } - return time + plusTime; - } else { - return now; - } - }; - Tone.prototype.toNotation = function (time, bpm, timeSignature) { - var testNotations = [ - '1m', - '2n', - '4n', - '8n', - '16n', - '32n', - '64n', - '128n' - ]; - var retNotation = toNotationHelper.call(this, time, bpm, timeSignature, testNotations); - var testTripletNotations = [ - '1m', - '2n', - '2t', - '4n', - '4t', - '8n', - '8t', - '16n', - '16t', - '32n', - '32t', - '64n', - '64t', - '128n' - ]; - var retTripletNotation = toNotationHelper.call(this, time, bpm, timeSignature, testTripletNotations); - if (retTripletNotation.split('+').length < retNotation.split('+').length) { - return retTripletNotation; - } else { - return retNotation; - } - }; - function toNotationHelper(time, bpm, timeSignature, testNotations) { - var seconds = this.toSeconds(time); - var threshold = this.notationToSeconds(testNotations[testNotations.length - 1], bpm, timeSignature); - var retNotation = ''; - for (var i = 0; i < testNotations.length; i++) { - var notationTime = this.notationToSeconds(testNotations[i], bpm, timeSignature); - var multiple = seconds / notationTime; - var floatingPointError = 0.000001; - if (1 - multiple % 1 < floatingPointError) { - multiple += floatingPointError; - } - multiple = Math.floor(multiple); - if (multiple > 0) { - if (multiple === 1) { - retNotation += testNotations[i]; - } else { - retNotation += multiple.toString() + '*' + testNotations[i]; - } - seconds -= multiple * notationTime; - if (seconds < threshold) { - break; - } else { - retNotation += ' + '; - } - } - } - if (retNotation === '') { - retNotation = '0'; - } - return retNotation; - } - Tone.prototype.fromUnits = function (val, units) { - if (this.convert || this.isUndef(this.convert)) { - switch (units) { - case Tone.Type.Time: - return this.toSeconds(val); - case Tone.Type.Frequency: - return this.toFrequency(val); - case Tone.Type.Decibels: - return this.dbToGain(val); - case Tone.Type.NormalRange: - return Math.min(Math.max(val, 0), 1); - case Tone.Type.AudioRange: - return Math.min(Math.max(val, -1), 1); - case Tone.Type.Positive: - return Math.max(val, 0); - default: - return val; - } - } else { - return val; - } - }; - Tone.prototype.toUnits = function (val, units) { - if (this.convert || this.isUndef(this.convert)) { - switch (units) { - case Tone.Type.Decibels: - return this.gainToDb(val); - default: - return val; - } - } else { - return val; - } - }; - var noteToScaleIndex = { - 'cbb': -2, - 'cb': -1, - 'c': 0, - 'c#': 1, - 'cx': 2, - 'dbb': 0, - 'db': 1, - 'd': 2, - 'd#': 3, - 'dx': 4, - 'ebb': 2, - 'eb': 3, - 'e': 4, - 'e#': 5, - 'ex': 6, - 'fbb': 3, - 'fb': 4, - 'f': 5, - 'f#': 6, - 'fx': 7, - 'gbb': 5, - 'gb': 6, - 'g': 7, - 'g#': 8, - 'gx': 9, - 'abb': 7, - 'ab': 8, - 'a': 9, - 'a#': 10, - 'ax': 11, - 'bbb': 9, - 'bb': 10, - 'b': 11, - 'b#': 12, - 'bx': 13 - }; - var scaleIndexToNote = [ - 'C', - 'C#', - 'D', - 'D#', - 'E', - 'F', - 'F#', - 'G', - 'G#', - 'A', - 'A#', - 'B' - ]; - Tone.A4 = 440; - Tone.prototype.noteToFrequency = function (note) { - var parts = note.split(/(-?\d+)/); - if (parts.length === 3) { - var index = noteToScaleIndex[parts[0].toLowerCase()]; - var octave = parts[1]; - var noteNumber = index + (parseInt(octave, 10) + 1) * 12; - return this.midiToFrequency(noteNumber); - } else { - return 0; - } - }; - Tone.prototype.frequencyToNote = function (freq) { - var log = Math.log(freq / Tone.A4) / Math.LN2; - var noteNumber = Math.round(12 * log) + 57; - var octave = Math.floor(noteNumber / 12); - if (octave < 0) { - noteNumber += -12 * octave; - } - var noteName = scaleIndexToNote[noteNumber % 12]; - return noteName + octave.toString(); - }; - Tone.prototype.intervalToFrequencyRatio = function (interval) { - return Math.pow(2, interval / 12); - }; - Tone.prototype.midiToNote = function (midiNumber) { - var octave = Math.floor(midiNumber / 12) - 1; - var note = midiNumber % 12; - return scaleIndexToNote[note] + octave; - }; - Tone.prototype.noteToMidi = function (note) { - var parts = note.split(/(\d+)/); - if (parts.length === 3) { - var index = noteToScaleIndex[parts[0].toLowerCase()]; - var octave = parts[1]; - return index + (parseInt(octave, 10) + 1) * 12; - } else { - return 0; - } - }; - Tone.prototype.midiToFrequency = function (midi) { - return Tone.A4 * Math.pow(2, (midi - 69) / 12); - }; - return Tone; -}(Tone_core_Tone); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_core_Param; -Tone_core_Param = function (Tone) { - 'use strict'; - Tone.Param = function () { - var options = this.optionsObject(arguments, [ - 'param', - 'units', - 'convert' - ], Tone.Param.defaults); - this._param = this.input = options.param; - this.units = options.units; - this.convert = options.convert; - this.overridden = false; - if (!this.isUndef(options.value)) { - this.value = options.value; - } - }; - Tone.extend(Tone.Param); - Tone.Param.defaults = { - 'units': Tone.Type.Default, - 'convert': true, - 'param': undefined - }; - Object.defineProperty(Tone.Param.prototype, 'value', { - get: function () { - return this._toUnits(this._param.value); - }, - set: function (value) { - var convertedVal = this._fromUnits(value); - this._param.value = convertedVal; - } - }); - Tone.Param.prototype._fromUnits = function (val) { - if (this.convert || this.isUndef(this.convert)) { - switch (this.units) { - case Tone.Type.Time: - return this.toSeconds(val); - case Tone.Type.Frequency: - return this.toFrequency(val); - case Tone.Type.Decibels: - return this.dbToGain(val); - case Tone.Type.NormalRange: - return Math.min(Math.max(val, 0), 1); - case Tone.Type.AudioRange: - return Math.min(Math.max(val, -1), 1); - case Tone.Type.Positive: - return Math.max(val, 0); - default: - return val; - } - } else { - return val; - } - }; - Tone.Param.prototype._toUnits = function (val) { - if (this.convert || this.isUndef(this.convert)) { - switch (this.units) { - case Tone.Type.Decibels: - return this.gainToDb(val); - default: - return val; - } - } else { - return val; - } - }; - Tone.Param.prototype._minOutput = 0.00001; - Tone.Param.prototype.setValueAtTime = function (value, time) { - value = this._fromUnits(value); - this._param.setValueAtTime(value, this.toSeconds(time)); - return this; - }; - Tone.Param.prototype.setRampPoint = function (now) { - now = this.defaultArg(now, this.now()); - var currentVal = this._param.value; - this._param.setValueAtTime(currentVal, now); - return this; - }; - Tone.Param.prototype.linearRampToValueAtTime = function (value, endTime) { - value = this._fromUnits(value); - this._param.linearRampToValueAtTime(value, this.toSeconds(endTime)); - return this; - }; - Tone.Param.prototype.exponentialRampToValueAtTime = function (value, endTime) { - value = this._fromUnits(value); - value = Math.max(this._minOutput, value); - this._param.exponentialRampToValueAtTime(value, this.toSeconds(endTime)); - return this; - }; - Tone.Param.prototype.exponentialRampToValue = function (value, rampTime) { - var now = this.now(); - var currentVal = this.value; - this.setValueAtTime(Math.max(currentVal, this._minOutput), now); - this.exponentialRampToValueAtTime(value, now + this.toSeconds(rampTime)); - return this; - }; - Tone.Param.prototype.linearRampToValue = function (value, rampTime) { - var now = this.now(); - this.setRampPoint(now); - this.linearRampToValueAtTime(value, now + this.toSeconds(rampTime)); - return this; - }; - Tone.Param.prototype.setTargetAtTime = function (value, startTime, timeConstant) { - value = this._fromUnits(value); - value = Math.max(this._minOutput, value); - timeConstant = Math.max(this._minOutput, timeConstant); - this._param.setTargetAtTime(value, this.toSeconds(startTime), timeConstant); - return this; - }; - Tone.Param.prototype.setValueCurveAtTime = function (values, startTime, duration) { - for (var i = 0; i < values.length; i++) { - values[i] = this._fromUnits(values[i]); - } - this._param.setValueCurveAtTime(values, this.toSeconds(startTime), this.toSeconds(duration)); - return this; - }; - Tone.Param.prototype.cancelScheduledValues = function (startTime) { - this._param.cancelScheduledValues(this.toSeconds(startTime)); - return this; - }; - Tone.Param.prototype.rampTo = function (value, rampTime) { - rampTime = this.defaultArg(rampTime, 0); - if (this.units === Tone.Type.Frequency || this.units === Tone.Type.BPM) { - this.exponentialRampToValue(value, rampTime); - } else { - this.linearRampToValue(value, rampTime); - } - return this; - }; - Tone.Param.prototype.dispose = function () { - Tone.prototype.dispose.call(this); - this._param = null; - return this; - }; - return Tone.Param; -}(Tone_core_Tone); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_core_Gain; -Tone_core_Gain = function (Tone) { - 'use strict'; - Tone.Gain = function () { - var options = this.optionsObject(arguments, [ - 'gain', - 'units' - ], Tone.Gain.defaults); - this.input = this.output = this._gainNode = this.context.createGain(); - this.gain = new Tone.Param({ - 'param': this._gainNode.gain, - 'units': options.units, - 'value': options.gain, - 'convert': options.convert - }); - this._readOnly('gain'); - }; - Tone.extend(Tone.Gain); - Tone.Gain.defaults = { - 'gain': 1, - 'convert': true - }; - Tone.Gain.prototype.dispose = function () { - Tone.Param.prototype.dispose.call(this); - this._gainNode.disconnect(); - this._gainNode = null; - this._writable('gain'); - this.gain.dispose(); - this.gain = null; - }; - return Tone.Gain; -}(Tone_core_Tone, Tone_core_Param); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_signal_Signal; -Tone_signal_Signal = function (Tone) { - 'use strict'; - Tone.Signal = function () { - var options = this.optionsObject(arguments, [ - 'value', - 'units' - ], Tone.Signal.defaults); - this.output = this._gain = this.context.createGain(); - options.param = this._gain.gain; - Tone.Param.call(this, options); - this.input = this._param = this._gain.gain; - Tone.Signal._constant.chain(this._gain); - }; - Tone.extend(Tone.Signal, Tone.Param); - Tone.Signal.defaults = { - 'value': 0, - 'units': Tone.Type.Default, - 'convert': true - }; - Tone.Signal.prototype.connect = Tone.SignalBase.prototype.connect; - Tone.Signal.prototype.dispose = function () { - Tone.Param.prototype.dispose.call(this); - this._param = null; - this._gain.disconnect(); - this._gain = null; - return this; - }; - Tone.Signal._constant = null; - Tone._initAudioContext(function (audioContext) { - var buffer = audioContext.createBuffer(1, 128, audioContext.sampleRate); - var arr = buffer.getChannelData(0); - for (var i = 0; i < arr.length; i++) { - arr[i] = 1; - } - Tone.Signal._constant = audioContext.createBufferSource(); - Tone.Signal._constant.channelCount = 1; - Tone.Signal._constant.channelCountMode = 'explicit'; - Tone.Signal._constant.buffer = buffer; - Tone.Signal._constant.loop = true; - Tone.Signal._constant.start(0); - Tone.Signal._constant.noGC(); - }); - return Tone.Signal; -}(Tone_core_Tone, Tone_signal_WaveShaper, Tone_core_Type, Tone_core_Param); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_signal_Add; -Tone_signal_Add = function (Tone) { - 'use strict'; - Tone.Add = function (value) { - Tone.call(this, 2, 0); - this._sum = this.input[0] = this.input[1] = this.output = this.context.createGain(); - this._param = this.input[1] = new Tone.Signal(value); - this._param.connect(this._sum); - }; - Tone.extend(Tone.Add, Tone.Signal); - Tone.Add.prototype.dispose = function () { - Tone.prototype.dispose.call(this); - this._sum.disconnect(); - this._sum = null; - this._param.dispose(); - this._param = null; - return this; - }; - return Tone.Add; -}(Tone_core_Tone); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_signal_Multiply; -Tone_signal_Multiply = function (Tone) { - 'use strict'; - Tone.Multiply = function (value) { - Tone.call(this, 2, 0); - this._mult = this.input[0] = this.output = this.context.createGain(); - this._param = this.input[1] = this.output.gain; - this._param.value = this.defaultArg(value, 0); - }; - Tone.extend(Tone.Multiply, Tone.Signal); - Tone.Multiply.prototype.dispose = function () { - Tone.prototype.dispose.call(this); - this._mult.disconnect(); - this._mult = null; - this._param = null; - return this; - }; - return Tone.Multiply; -}(Tone_core_Tone); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_signal_Scale; -Tone_signal_Scale = function (Tone) { - 'use strict'; - Tone.Scale = function (outputMin, outputMax) { - this._outputMin = this.defaultArg(outputMin, 0); - this._outputMax = this.defaultArg(outputMax, 1); - this._scale = this.input = new Tone.Multiply(1); - this._add = this.output = new Tone.Add(0); - this._scale.connect(this._add); - this._setRange(); - }; - Tone.extend(Tone.Scale, Tone.SignalBase); - Object.defineProperty(Tone.Scale.prototype, 'min', { - get: function () { - return this._outputMin; - }, - set: function (min) { - this._outputMin = min; - this._setRange(); - } - }); - Object.defineProperty(Tone.Scale.prototype, 'max', { - get: function () { - return this._outputMax; - }, - set: function (max) { - this._outputMax = max; - this._setRange(); - } - }); - Tone.Scale.prototype._setRange = function () { - this._add.value = this._outputMin; - this._scale.value = this._outputMax - this._outputMin; - }; - Tone.Scale.prototype.dispose = function () { - Tone.prototype.dispose.call(this); - this._add.dispose(); - this._add = null; - this._scale.dispose(); - this._scale = null; - return this; - }; - return Tone.Scale; -}(Tone_core_Tone, Tone_signal_Add, Tone_signal_Multiply); -var signal; -signal = function () { - 'use strict'; - // Signal is built with the Tone.js signal by Yotam Mann - // https://github.com/TONEnoTONE/Tone.js/ - var Signal = Tone_signal_Signal; - var Add = Tone_signal_Add; - var Mult = Tone_signal_Multiply; - var Scale = Tone_signal_Scale; - var Tone = Tone_core_Tone; - var p5sound = master; - Tone.setContext(p5sound.audiocontext); - /** - *

p5.Signal is a constant audio-rate signal used by p5.Oscillator - * and p5.Envelope for modulation math.

- * - *

This is necessary because Web Audio is processed on a seprate clock. - * For example, the p5 draw loop runs about 60 times per second. But - * the audio clock must process samples 44100 times per second. If we - * want to add a value to each of those samples, we can't do it in the - * draw 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 - * a Tone.Signal from the Tone.js library by Yotam Mann. - * If you want to work directly with audio signals for modular - * synthesis, check out - * tone.js.

- * - * @class p5.Signal - * @constructor - * @return {Tone.Signal} A Signal object from the Tone.js library - * @example - *
- * function setup() { - * carrier = new p5.Oscillator('sine'); - * carrier.amp(1); // set amplitude - * carrier.freq(220); // set frequency - * carrier.start(); // start oscillating - * - * modulator = new p5.Oscillator('sawtooth'); - * modulator.disconnect(); - * modulator.amp(1); - * modulator.freq(4); - * modulator.start(); - * - * // Modulator's default amplitude range is -1 to 1. - * // Multiply it by -200, so the range is -200 to 200 - * // then add 220 so the range is 20 to 420 - * carrier.freq( modulator.mult(-200).add(220) ); - * } - *
- */ - p5.Signal = function (value) { - var s = new Signal(value); - // p5sound.soundArray.push(s); - return s; - }; - /** - * Fade to value, for smooth transitions - * - * @method fade - * @param {Number} value Value to set this signal - * @param {Number} [secondsFromNow] Length of fade, in seconds from now - */ - Signal.prototype.fade = Signal.prototype.linearRampToValueAtTime; - Mult.prototype.fade = Signal.prototype.fade; - Add.prototype.fade = Signal.prototype.fade; - Scale.prototype.fade = Signal.prototype.fade; - /** - * Connect a p5.sound object or Web Audio node to this - * p5.Signal so that its amplitude values can be scaled. - * - * @param {Object} input - */ - Signal.prototype.setInput = function (_input) { - _input.connect(this); - }; - Mult.prototype.setInput = Signal.prototype.setInput; - Add.prototype.setInput = Signal.prototype.setInput; - Scale.prototype.setInput = Signal.prototype.setInput; - // signals can add / mult / scale themselves - /** - * Add a constant value to this audio signal, - * and return the resulting audio signal. Does - * not change the value of the original signal, - * instead it returns a new p5.SignalAdd. - * - * @method add - * @param {Number} number - * @return {p5.SignalAdd} object - */ - Signal.prototype.add = function (num) { - var add = new Add(num); - // add.setInput(this); - this.connect(add); - return add; - }; - Mult.prototype.add = Signal.prototype.add; - Add.prototype.add = Signal.prototype.add; - Scale.prototype.add = Signal.prototype.add; - /** - * Multiply this signal by a constant value, - * and return the resulting audio signal. Does - * not change the value of the original signal, - * instead it returns a new p5.SignalMult. - * - * @method mult - * @param {Number} number to multiply - * @return {Tone.Multiply} object - */ - Signal.prototype.mult = function (num) { - var mult = new Mult(num); - // mult.setInput(this); - this.connect(mult); - return mult; - }; - Mult.prototype.mult = Signal.prototype.mult; - Add.prototype.mult = Signal.prototype.mult; - Scale.prototype.mult = Signal.prototype.mult; - /** - * Scale this signal value to a given range, - * and return the result as an audio signal. Does - * not change the value of the original signal, - * instead it returns a new p5.SignalScale. - * - * @method scale - * @param {Number} number to multiply - * @param {Number} inMin input range minumum - * @param {Number} inMax input range maximum - * @param {Number} outMin input range minumum - * @param {Number} outMax input range maximum - * @return {p5.SignalScale} object - */ - Signal.prototype.scale = function (inMin, inMax, outMin, outMax) { - var mapOutMin, mapOutMax; - if (arguments.length === 4) { - mapOutMin = p5.prototype.map(outMin, inMin, inMax, 0, 1) - 0.5; - mapOutMax = p5.prototype.map(outMax, inMin, inMax, 0, 1) - 0.5; - } else { - mapOutMin = arguments[0]; - mapOutMax = arguments[1]; - } - var scale = new Scale(mapOutMin, mapOutMax); - this.connect(scale); - return scale; - }; - Mult.prototype.scale = Signal.prototype.scale; - Add.prototype.scale = Signal.prototype.scale; - Scale.prototype.scale = Signal.prototype.scale; -}(Tone_signal_Signal, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale, Tone_core_Tone, master); -var oscillator; -oscillator = function () { - 'use strict'; - var p5sound = master; - var Signal = Tone_signal_Signal; - var Add = Tone_signal_Add; - var Mult = Tone_signal_Multiply; - var Scale = Tone_signal_Scale; - /** - *

Creates a signal that oscillates between -1.0 and 1.0. - * By default, the oscillation takes the form of a sinusoidal - * shape ('sine'). Additional types include 'triangle', - * 'sawtooth' and 'square'. The frequency defaults to - * 440 oscillations per second (440Hz, equal to the pitch of an - * 'A' note).

- * - *

Set the type of oscillation with setType(), or by creating a - * specific oscillator.

For example: - * new p5.SinOsc(freq) - * new p5.TriOsc(freq) - * new p5.SqrOsc(freq) - * new p5.SawOsc(freq). - *

- * - * @class p5.Oscillator - * @constructor - * @param {Number} [freq] frequency defaults to 440Hz - * @param {String} [type] type of oscillator. Options: - * 'sine' (default), 'triangle', - * 'sawtooth', 'square' - * @return {Object} Oscillator object - * @example - *
- * var osc; - * var playing = false; - * - * function setup() { - * backgroundColor = color(255,0,255); - * textAlign(CENTER); - * - * osc = new p5.Oscillator(); - * osc.setType('sine'); - * osc.freq(240); - * osc.amp(0); - * osc.start(); - * } - * - * function draw() { - * background(backgroundColor) - * text('click to play', width/2, height/2); - * } - * - * function mouseClicked() { - * if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) { - * if (!playing) { - * // ramp amplitude to 0.5 over 0.1 seconds - * osc.amp(0.5, 0.05); - * playing = true; - * backgroundColor = color(0,255,255); - * } else { - * // ramp amplitude to 0 over 0.5 seconds - * osc.amp(0, 0.5); - * playing = false; - * backgroundColor = color(255,0,255); - * } - * } - * } - *
- */ - p5.Oscillator = function (freq, type) { - if (typeof freq === 'string') { - var f = type; - type = freq; - freq = f; - } - if (typeof type === 'number') { - var f = type; - type = freq; - freq = f; - } - this.started = false; - // components - this.phaseAmount = undefined; - this.oscillator = p5sound.audiocontext.createOscillator(); - this.f = freq || 440; - // frequency - this.oscillator.type = type || 'sine'; - this.oscillator.frequency.setValueAtTime(this.f, p5sound.audiocontext.currentTime); - var o = this.oscillator; - // connections - this.output = p5sound.audiocontext.createGain(); - this._freqMods = []; - // modulators connected to this oscillator's frequency - // set default output gain to 0.5 - this.output.gain.value = 0.5; - this.output.gain.setValueAtTime(0.5, p5sound.audiocontext.currentTime); - this.oscillator.connect(this.output); - // stereo panning - this.panPosition = 0; - this.connection = p5sound.input; - // connect to p5sound by default - this.panner = new p5.Panner(this.output, this.connection, 1); - //array of math operation signal chaining - this.mathOps = [this.output]; - // add to the soundArray so we can dispose of the osc later - p5sound.soundArray.push(this); - }; - /** - * Start an oscillator. Accepts an optional parameter to - * determine how long (in seconds from now) until the - * oscillator starts. - * - * @method start - * @param {Number} [time] startTime in seconds from now. - * @param {Number} [frequency] frequency in Hz. - */ - p5.Oscillator.prototype.start = function (time, f) { - if (this.started) { - var now = p5sound.audiocontext.currentTime; - this.stop(now); - } - if (!this.started) { - var freq = f || this.f; - var type = this.oscillator.type; - // set old osc free to be garbage collected (memory) - if (this.oscillator) { - this.oscillator.disconnect(); - this.oscillator = undefined; - } - // var detune = this.oscillator.frequency.value; - this.oscillator = p5sound.audiocontext.createOscillator(); - this.oscillator.frequency.exponentialRampToValueAtTime(Math.abs(freq), p5sound.audiocontext.currentTime); - this.oscillator.type = type; - // this.oscillator.detune.value = detune; - this.oscillator.connect(this.output); - time = time || 0; - this.oscillator.start(time + p5sound.audiocontext.currentTime); - this.freqNode = this.oscillator.frequency; - // if other oscillators are already connected to this osc's freq - for (var i in this._freqMods) { - if (typeof this._freqMods[i].connect !== 'undefined') { - this._freqMods[i].connect(this.oscillator.frequency); - } - } - this.started = true; - } - }; - /** - * Stop an oscillator. Accepts an optional parameter - * to determine how long (in seconds from now) until the - * oscillator stops. - * - * @method stop - * @param {Number} secondsFromNow Time, in seconds from now. - */ - p5.Oscillator.prototype.stop = function (time) { - if (this.started) { - var t = time || 0; - var now = p5sound.audiocontext.currentTime; - this.oscillator.stop(t + now); - this.started = false; - } - }; - /** - * Set the amplitude between 0 and 1.0. Or, pass in an object - * such as an oscillator to modulate amplitude with an audio signal. - * - * @method amp - * @param {Number|Object} vol between 0 and 1.0 - * or a modulating signal/oscillator - * @param {Number} [rampTime] create a fade that lasts rampTime - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - * @return {AudioParam} gain If no value is provided, - * returns the Web Audio API - * AudioParam that controls - * this oscillator's - * gain/amplitude/volume) - */ - p5.Oscillator.prototype.amp = function (vol, rampTime, tFromNow) { - var self = this; - if (typeof vol === 'number') { - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var now = p5sound.audiocontext.currentTime; - var currentVol = this.output.gain.value; - this.output.gain.cancelScheduledValues(now); - this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); - this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); - } else if (vol) { - vol.connect(self.output.gain); - } else { - // return the Gain Node - return this.output.gain; - } - }; - // these are now the same thing - p5.Oscillator.prototype.fade = p5.Oscillator.prototype.amp; - p5.Oscillator.prototype.getAmp = function () { - return this.output.gain.value; - }; - /** - * Set frequency of an oscillator to a value. Or, pass in an object - * such as an oscillator to modulate the frequency with an audio signal. - * - * @method freq - * @param {Number|Object} Frequency Frequency in Hz - * or modulating signal/oscillator - * @param {Number} [rampTime] Ramp time (in seconds) - * @param {Number} [timeFromNow] Schedule this event to happen - * at x seconds from now - * @return {AudioParam} Frequency If no value is provided, - * returns the Web Audio API - * AudioParam that controls - * this oscillator's frequency - * @example - *
- * var osc = new p5.Oscillator(300); - * osc.start(); - * osc.freq(40, 10); - *
- */ - p5.Oscillator.prototype.freq = function (val, rampTime, tFromNow) { - if (typeof val === 'number' && !isNaN(val)) { - this.f = val; - var now = p5sound.audiocontext.currentTime; - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - // var currentFreq = this.oscillator.frequency.value; - // this.oscillator.frequency.cancelScheduledValues(now); - if (rampTime == 0) { - this.oscillator.frequency.cancelScheduledValues(now); - this.oscillator.frequency.setValueAtTime(val, tFromNow + now); - } else { - if (val > 0) { - this.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now); - } else { - this.oscillator.frequency.linearRampToValueAtTime(val, tFromNow + rampTime + now); - } - } - // reset phase if oscillator has a phase - if (this.phaseAmount) { - this.phase(this.phaseAmount); - } - } else if (val) { - if (val.output) { - val = val.output; - } - val.connect(this.oscillator.frequency); - // keep track of what is modulating this param - // so it can be re-connected if - this._freqMods.push(val); - } else { - // return the Frequency Node - return this.oscillator.frequency; - } - }; - p5.Oscillator.prototype.getFreq = function () { - return this.oscillator.frequency.value; - }; - /** - * Set type to 'sine', 'triangle', 'sawtooth' or 'square'. - * - * @method setType - * @param {String} type 'sine', 'triangle', 'sawtooth' or 'square'. - */ - p5.Oscillator.prototype.setType = function (type) { - this.oscillator.type = type; - }; - p5.Oscillator.prototype.getType = function () { - return this.oscillator.type; - }; - /** - * Connect to a p5.sound / Web Audio object. - * - * @method connect - * @param {Object} unit A p5.sound or Web Audio object - */ - p5.Oscillator.prototype.connect = function (unit) { - if (!unit) { - this.panner.connect(p5sound.input); - } else if (unit.hasOwnProperty('input')) { - this.panner.connect(unit.input); - this.connection = unit.input; - } else { - this.panner.connect(unit); - this.connection = unit; - } - }; - /** - * Disconnect all outputs - * - * @method disconnect - */ - p5.Oscillator.prototype.disconnect = function (unit) { - this.output.disconnect(); - this.panner.disconnect(); - this.output.connect(this.panner); - this.oscMods = []; - }; - /** - * Pan between Left (-1) and Right (1) - * - * @method pan - * @param {Number} panning Number between -1 and 1 - * @param {Number} timeFromNow schedule this event to happen - * seconds from now - */ - p5.Oscillator.prototype.pan = function (pval, tFromNow) { - this.panPosition = pval; - this.panner.pan(pval, tFromNow); - }; - p5.Oscillator.prototype.getPan = function () { - return this.panPosition; - }; - // get rid of the oscillator - p5.Oscillator.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - if (this.oscillator) { - var now = p5sound.audiocontext.currentTime; - this.stop(now); - this.disconnect(); - this.panner = null; - this.oscillator = null; - } - // if it is a Pulse - if (this.osc2) { - this.osc2.dispose(); - } - }; - /** - * Set the phase of an oscillator between 0.0 and 1.0. - * In this implementation, phase is a delay time - * based on the oscillator's current frequency. - * - * @method phase - * @param {Number} phase float between 0.0 and 1.0 - */ - p5.Oscillator.prototype.phase = function (p) { - var delayAmt = p5.prototype.map(p, 0, 1, 0, 1 / this.f); - var now = p5sound.audiocontext.currentTime; - this.phaseAmount = p; - if (!this.dNode) { - // create a delay node - this.dNode = p5sound.audiocontext.createDelay(); - // put the delay node in between output and panner - this.oscillator.disconnect(); - this.oscillator.connect(this.dNode); - this.dNode.connect(this.output); - } - // set delay time to match phase: - this.dNode.delayTime.setValueAtTime(delayAmt, now); - }; - // ========================== // - // SIGNAL MATH FOR MODULATION // - // ========================== // - // return sigChain(this, scale, thisChain, nextChain, Scale); - var sigChain = function (o, mathObj, thisChain, nextChain, type) { - var chainSource = o.oscillator; - // if this type of math already exists in the chain, replace it - for (var i in o.mathOps) { - if (o.mathOps[i] instanceof type) { - chainSource.disconnect(); - o.mathOps[i].dispose(); - thisChain = i; - // assume nextChain is output gain node unless... - if (thisChain < o.mathOps.length - 2) { - nextChain = o.mathOps[i + 1]; - } - } - } - if (thisChain == o.mathOps.length - 1) { - o.mathOps.push(nextChain); - } - // assume source is the oscillator unless i > 0 - if (i > 0) { - chainSource = o.mathOps[i - 1]; - } - chainSource.disconnect(); - chainSource.connect(mathObj); - mathObj.connect(nextChain); - o.mathOps[thisChain] = mathObj; - return o; - }; - /** - * Add a value to the p5.Oscillator's output amplitude, - * and return the oscillator. Calling this method again - * will override the initial add() with a new value. - * - * @method add - * @param {Number} number Constant number to add - * @return {p5.Oscillator} Oscillator Returns this oscillator - * with scaled output - * - */ - p5.Oscillator.prototype.add = function (num) { - var add = new Add(num); - var thisChain = this.mathOps.length - 1; - var nextChain = this.output; - return sigChain(this, add, thisChain, nextChain, Add); - }; - /** - * Multiply the p5.Oscillator's output amplitude - * by a fixed value (i.e. turn it up!). Calling this method - * again will override the initial mult() with a new value. - * - * @method mult - * @param {Number} number Constant number to multiply - * @return {p5.Oscillator} Oscillator Returns this oscillator - * with multiplied output - */ - p5.Oscillator.prototype.mult = function (num) { - var mult = new Mult(num); - var thisChain = this.mathOps.length - 1; - var nextChain = this.output; - return sigChain(this, mult, thisChain, nextChain, Mult); - }; - /** - * Scale this oscillator's amplitude values to a given - * range, and return the oscillator. Calling this method - * again will override the initial scale() with new values. - * - * @method scale - * @param {Number} inMin input range minumum - * @param {Number} inMax input range maximum - * @param {Number} outMin input range minumum - * @param {Number} outMax input range maximum - * @return {p5.Oscillator} Oscillator Returns this oscillator - * with scaled output - */ - p5.Oscillator.prototype.scale = function (inMin, inMax, outMin, outMax) { - var mapOutMin, mapOutMax; - if (arguments.length === 4) { - mapOutMin = p5.prototype.map(outMin, inMin, inMax, 0, 1) - 0.5; - mapOutMax = p5.prototype.map(outMax, inMin, inMax, 0, 1) - 0.5; - } else { - mapOutMin = arguments[0]; - mapOutMax = arguments[1]; - } - var scale = new Scale(mapOutMin, mapOutMax); - var thisChain = this.mathOps.length - 1; - var nextChain = this.output; - return sigChain(this, scale, thisChain, nextChain, Scale); - }; - // ============================== // - // SinOsc, TriOsc, SqrOsc, SawOsc // - // ============================== // - /** - * Constructor: new p5.SinOsc(). - * This creates a Sine Wave Oscillator and is - * equivalent to new p5.Oscillator('sine') - * or creating a p5.Oscillator and then calling - * its method setType('sine'). - * See p5.Oscillator for methods. - * - * @method p5.SinOsc - * @param {Number} [freq] Set the frequency - */ - p5.SinOsc = function (freq) { - p5.Oscillator.call(this, freq, 'sine'); - }; - p5.SinOsc.prototype = Object.create(p5.Oscillator.prototype); - /** - * Constructor: new p5.TriOsc(). - * This creates a Triangle Wave Oscillator and is - * equivalent to new p5.Oscillator('triangle') - * or creating a p5.Oscillator and then calling - * its method setType('triangle'). - * See p5.Oscillator for methods. - * - * @method p5.TriOsc - * @param {Number} [freq] Set the frequency - */ - p5.TriOsc = function (freq) { - p5.Oscillator.call(this, freq, 'triangle'); - }; - p5.TriOsc.prototype = Object.create(p5.Oscillator.prototype); - /** - * Constructor: new p5.SawOsc(). - * This creates a SawTooth Wave Oscillator and is - * equivalent to new p5.Oscillator('sawtooth') - * or creating a p5.Oscillator and then calling - * its method setType('sawtooth'). - * See p5.Oscillator for methods. - * - * @method p5.SawOsc - * @param {Number} [freq] Set the frequency - */ - p5.SawOsc = function (freq) { - p5.Oscillator.call(this, freq, 'sawtooth'); - }; - p5.SawOsc.prototype = Object.create(p5.Oscillator.prototype); - /** - * Constructor: new p5.SqrOsc(). - * This creates a Square Wave Oscillator and is - * equivalent to new p5.Oscillator('square') - * or creating a p5.Oscillator and then calling - * its method setType('square'). - * See p5.Oscillator for methods. - * - * @method p5.SqrOsc - * @param {Number} [freq] Set the frequency - */ - p5.SqrOsc = function (freq) { - p5.Oscillator.call(this, freq, 'square'); - }; - p5.SqrOsc.prototype = Object.create(p5.Oscillator.prototype); -}(master, Tone_signal_Signal, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_core_Timeline; -Tone_core_Timeline = function (Tone) { - 'use strict'; - Tone.Timeline = function () { - var options = this.optionsObject(arguments, ['memory'], Tone.Timeline.defaults); - this._timeline = []; - this._toRemove = []; - this._iterating = false; - this.memory = options.memory; - }; - Tone.extend(Tone.Timeline); - Tone.Timeline.defaults = { 'memory': Infinity }; - Object.defineProperty(Tone.Timeline.prototype, 'length', { - get: function () { - return this._timeline.length; - } - }); - Tone.Timeline.prototype.addEvent = function (event) { - if (this.isUndef(event.time)) { - throw new Error('events must have a time attribute'); - } - event.time = this.toSeconds(event.time); - if (this._timeline.length) { - var index = this._search(event.time); - this._timeline.splice(index + 1, 0, event); - } else { - this._timeline.push(event); - } - if (this.length > this.memory) { - var diff = this.length - this.memory; - this._timeline.splice(0, diff); - } - return this; - }; - Tone.Timeline.prototype.removeEvent = function (event) { - if (this._iterating) { - this._toRemove.push(event); - } else { - var index = this._timeline.indexOf(event); - if (index !== -1) { - this._timeline.splice(index, 1); - } - } - return this; - }; - Tone.Timeline.prototype.getEvent = function (time) { - time = this.toSeconds(time); - var index = this._search(time); - if (index !== -1) { - return this._timeline[index]; - } else { - return null; - } - }; - Tone.Timeline.prototype.getEventAfter = function (time) { - time = this.toSeconds(time); - var index = this._search(time); - if (index + 1 < this._timeline.length) { - return this._timeline[index + 1]; - } else { - return null; - } - }; - Tone.Timeline.prototype.getEventBefore = function (time) { - time = this.toSeconds(time); - var index = this._search(time); - if (index - 1 >= 0) { - return this._timeline[index - 1]; - } else { - return null; - } - }; - Tone.Timeline.prototype.cancel = function (after) { - if (this._timeline.length > 1) { - after = this.toSeconds(after); - var index = this._search(after); - if (index >= 0) { - this._timeline = this._timeline.slice(0, index); - } else { - this._timeline = []; - } - } else if (this._timeline.length === 1) { - if (this._timeline[0].time >= after) { - this._timeline = []; - } - } - return this; - }; - Tone.Timeline.prototype.cancelBefore = function (time) { - if (this._timeline.length) { - time = this.toSeconds(time); - var index = this._search(time); - if (index >= 0) { - this._timeline = this._timeline.slice(index + 1); - } - } - return this; - }; - Tone.Timeline.prototype._search = function (time) { - var beginning = 0; - var len = this._timeline.length; - var end = len; - while (beginning <= end && beginning < len) { - var midPoint = Math.floor(beginning + (end - beginning) / 2); - var event = this._timeline[midPoint]; - if (event.time === time) { - for (var i = midPoint; i < this._timeline.length; i++) { - var testEvent = this._timeline[i]; - if (testEvent.time === time) { - midPoint = i; - } - } - return midPoint; - } else if (event.time > time) { - end = midPoint - 1; - } else if (event.time < time) { - beginning = midPoint + 1; - } - } - return beginning - 1; - }; - Tone.Timeline.prototype._iterate = function (callback, lowerBound, upperBound) { - this._iterating = true; - lowerBound = this.defaultArg(lowerBound, 0); - upperBound = this.defaultArg(upperBound, this._timeline.length - 1); - for (var i = lowerBound; i <= upperBound; i++) { - callback(this._timeline[i]); - } - this._iterating = false; - if (this._toRemove.length > 0) { - for (var j = 0; j < this._toRemove.length; j++) { - var index = this._timeline.indexOf(this._toRemove[j]); - if (index !== -1) { - this._timeline.splice(index, 1); - } - } - this._toRemove = []; - } - }; - Tone.Timeline.prototype.forEach = function (callback) { - this._iterate(callback); - return this; - }; - Tone.Timeline.prototype.forEachBefore = function (time, callback) { - time = this.toSeconds(time); - var upperBound = this._search(time); - if (upperBound !== -1) { - this._iterate(callback, 0, upperBound); - } - return this; - }; - Tone.Timeline.prototype.forEachAfter = function (time, callback) { - time = this.toSeconds(time); - var lowerBound = this._search(time); - this._iterate(callback, lowerBound + 1); - return this; - }; - Tone.Timeline.prototype.forEachFrom = function (time, callback) { - time = this.toSeconds(time); - var lowerBound = this._search(time); - while (lowerBound >= 0 && this._timeline[lowerBound].time >= time) { - lowerBound--; - } - this._iterate(callback, lowerBound + 1); - return this; - }; - Tone.Timeline.prototype.forEachAtTime = function (time, callback) { - time = this.toSeconds(time); - var upperBound = this._search(time); - if (upperBound !== -1) { - this._iterate(function (event) { - if (event.time === time) { - callback(event); - } - }, 0, upperBound); - } - return this; - }; - Tone.Timeline.prototype.dispose = function () { - Tone.prototype.dispose.call(this); - this._timeline = null; - this._toRemove = null; - }; - return Tone.Timeline; -}(Tone_core_Tone); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_signal_TimelineSignal; -Tone_signal_TimelineSignal = function (Tone) { - 'use strict'; - Tone.TimelineSignal = function () { - var options = this.optionsObject(arguments, [ - 'value', - 'units' - ], Tone.Signal.defaults); - Tone.Signal.apply(this, options); - options.param = this._param; - Tone.Param.call(this, options); - this._events = new Tone.Timeline(10); - this._initial = this._fromUnits(this._param.value); - }; - Tone.extend(Tone.TimelineSignal, Tone.Param); - Tone.TimelineSignal.Type = { - Linear: 'linear', - Exponential: 'exponential', - Target: 'target', - Set: 'set' - }; - Object.defineProperty(Tone.TimelineSignal.prototype, 'value', { - get: function () { - return this._toUnits(this._param.value); - }, - set: function (value) { - var convertedVal = this._fromUnits(value); - this._initial = convertedVal; - this._param.value = convertedVal; - } - }); - Tone.TimelineSignal.prototype.setValueAtTime = function (value, startTime) { - value = this._fromUnits(value); - startTime = this.toSeconds(startTime); - this._events.addEvent({ - 'type': Tone.TimelineSignal.Type.Set, - 'value': value, - 'time': startTime - }); - this._param.setValueAtTime(value, startTime); - return this; - }; - Tone.TimelineSignal.prototype.linearRampToValueAtTime = function (value, endTime) { - value = this._fromUnits(value); - endTime = this.toSeconds(endTime); - this._events.addEvent({ - 'type': Tone.TimelineSignal.Type.Linear, - 'value': value, - 'time': endTime - }); - this._param.linearRampToValueAtTime(value, endTime); - return this; - }; - Tone.TimelineSignal.prototype.exponentialRampToValueAtTime = function (value, endTime) { - value = this._fromUnits(value); - value = Math.max(this._minOutput, value); - endTime = this.toSeconds(endTime); - this._events.addEvent({ - 'type': Tone.TimelineSignal.Type.Exponential, - 'value': value, - 'time': endTime - }); - this._param.exponentialRampToValueAtTime(value, endTime); - return this; - }; - Tone.TimelineSignal.prototype.setTargetAtTime = function (value, startTime, timeConstant) { - value = this._fromUnits(value); - value = Math.max(this._minOutput, value); - timeConstant = Math.max(this._minOutput, timeConstant); - startTime = this.toSeconds(startTime); - this._events.addEvent({ - 'type': Tone.TimelineSignal.Type.Target, - 'value': value, - 'time': startTime, - 'constant': timeConstant - }); - this._param.setTargetAtTime(value, startTime, timeConstant); - return this; - }; - Tone.TimelineSignal.prototype.cancelScheduledValues = function (after) { - this._events.cancel(after); - this._param.cancelScheduledValues(this.toSeconds(after)); - return this; - }; - Tone.TimelineSignal.prototype.setRampPoint = function (time) { - time = this.toSeconds(time); - var val = this.getValueAtTime(time); - var after = this._searchAfter(time); - if (after) { - this.cancelScheduledValues(time); - if (after.type === Tone.TimelineSignal.Type.Linear) { - this.linearRampToValueAtTime(val, time); - } else if (after.type === Tone.TimelineSignal.Type.Exponential) { - this.exponentialRampToValueAtTime(val, time); - } - } - this.setValueAtTime(val, time); - return this; - }; - Tone.TimelineSignal.prototype.linearRampToValueBetween = function (value, start, finish) { - this.setRampPoint(start); - this.linearRampToValueAtTime(value, finish); - return this; - }; - Tone.TimelineSignal.prototype.exponentialRampToValueBetween = function (value, start, finish) { - this.setRampPoint(start); - this.exponentialRampToValueAtTime(value, finish); - return this; - }; - Tone.TimelineSignal.prototype._searchBefore = function (time) { - return this._events.getEvent(time); - }; - Tone.TimelineSignal.prototype._searchAfter = function (time) { - return this._events.getEventAfter(time); - }; - Tone.TimelineSignal.prototype.getValueAtTime = function (time) { - var after = this._searchAfter(time); - var before = this._searchBefore(time); - var value = this._initial; - if (before === null) { - value = this._initial; - } else if (before.type === Tone.TimelineSignal.Type.Target) { - var previous = this._events.getEventBefore(before.time); - var previouVal; - if (previous === null) { - previouVal = this._initial; - } else { - previouVal = previous.value; - } - value = this._exponentialApproach(before.time, previouVal, before.value, before.constant, time); - } else if (after === null) { - value = before.value; - } else if (after.type === Tone.TimelineSignal.Type.Linear) { - value = this._linearInterpolate(before.time, before.value, after.time, after.value, time); - } else if (after.type === Tone.TimelineSignal.Type.Exponential) { - value = this._exponentialInterpolate(before.time, before.value, after.time, after.value, time); - } else { - value = before.value; - } - return value; - }; - Tone.TimelineSignal.prototype.connect = Tone.SignalBase.prototype.connect; - Tone.TimelineSignal.prototype._exponentialApproach = function (t0, v0, v1, timeConstant, t) { - return v1 + (v0 - v1) * Math.exp(-(t - t0) / timeConstant); - }; - Tone.TimelineSignal.prototype._linearInterpolate = function (t0, v0, t1, v1, t) { - return v0 + (v1 - v0) * ((t - t0) / (t1 - t0)); - }; - Tone.TimelineSignal.prototype._exponentialInterpolate = function (t0, v0, t1, v1, t) { - v0 = Math.max(this._minOutput, v0); - return v0 * Math.pow(v1 / v0, (t - t0) / (t1 - t0)); - }; - Tone.TimelineSignal.prototype.dispose = function () { - Tone.Signal.prototype.dispose.call(this); - Tone.Param.prototype.dispose.call(this); - this._events.dispose(); - this._events = null; - }; - return Tone.TimelineSignal; -}(Tone_core_Tone, Tone_signal_Signal); -var env; -env = function () { - 'use strict'; - var p5sound = master; - var Add = Tone_signal_Add; - var Mult = Tone_signal_Multiply; - var Scale = Tone_signal_Scale; - var TimelineSignal = Tone_signal_TimelineSignal; - var Tone = Tone_core_Tone; - Tone.setContext(p5sound.audiocontext); - /** - *

Envelopes are pre-defined amplitude distribution over time. - * Typically, envelopes are used to control the output volume - * of an object, a series of fades referred to as Attack, Decay, - * Sustain and Release ( - * ADSR - * ). Envelopes can also control other Web Audio Parameters—for example, a p5.Env can - * control an Oscillator's frequency like this: osc.freq(env).

- *

Use setRange to change the attack/release level. - * Use setADSR to change attackTime, decayTime, sustainPercent and releaseTime.

- *

Use the play method to play the entire envelope, - * the ramp method for a pingable trigger, - * or triggerAttack/ - * triggerRelease to trigger noteOn/noteOff.

- * - * @class p5.Env - * @constructor - * @example - *
- * var attackLevel = 1.0; - * var releaseLevel = 0; - * - * var attackTime = 0.001 - * var decayTime = 0.2; - * var susPercent = 0.2; - * var releaseTime = 0.5; - * - * var env, triOsc; - * - * function setup() { - * var cnv = createCanvas(100, 100); - * - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * env = new p5.Env(); - * env.setADSR(attackTime, decayTime, susPercent, releaseTime); - * env.setRange(attackLevel, releaseLevel); - * - * triOsc = new p5.Oscillator('triangle'); - * triOsc.amp(env); - * triOsc.start(); - * triOsc.freq(220); - * - * cnv.mousePressed(playEnv); - * } - * - * function playEnv(){ - * env.play(); - * } - *
- */ - p5.Env = function (t1, l1, t2, l2, t3, l3) { - var now = p5sound.audiocontext.currentTime; - /** - * Time until envelope reaches attackLevel - * @property attackTime - */ - this.aTime = t1 || 0.1; - /** - * Level once attack is complete. - * @property attackLevel - */ - this.aLevel = l1 || 1; - /** - * Time until envelope reaches decayLevel. - * @property decayTime - */ - this.dTime = t2 || 0.5; - /** - * Level after decay. The envelope will sustain here until it is released. - * @property decayLevel - */ - this.dLevel = l2 || 0; - /** - * Duration of the release portion of the envelope. - * @property releaseTime - */ - this.rTime = t3 || 0; - /** - * Level at the end of the release. - * @property releaseLevel - */ - this.rLevel = l3 || 0; - this._rampHighPercentage = 0.98; - this._rampLowPercentage = 0.02; - this.output = p5sound.audiocontext.createGain(); - this.control = new TimelineSignal(); - this._init(); - // this makes sure the envelope starts at zero - this.control.connect(this.output); - // connect to the output - this.connection = null; - // store connection - //array of math operation signal chaining - this.mathOps = [this.control]; - //whether envelope should be linear or exponential curve - this.isExponential = false; - // oscillator or buffer source to clear on env complete - // to save resources if/when it is retriggered - this.sourceToClear = null; - // set to true if attack is set, then false on release - this.wasTriggered = false; - // add to the soundArray so we can dispose of the env later - p5sound.soundArray.push(this); - }; - // this init function just smooths the starting value to zero and gives a start point for the timeline - // - it was necessary to remove glitches at the beginning. - p5.Env.prototype._init = function () { - var now = p5sound.audiocontext.currentTime; - var t = now; - this.control.setTargetAtTime(0.00001, t, 0.001); - //also, compute the correct time constants - this._setRampAD(this.aTime, this.dTime); - }; - /** - * Reset the envelope with a series of time/value pairs. - * - * @method set - * @param {Number} attackTime Time (in seconds) before level - * reaches attackLevel - * @param {Number} attackLevel Typically an amplitude between - * 0.0 and 1.0 - * @param {Number} decayTime Time - * @param {Number} decayLevel Amplitude (In a standard ADSR envelope, - * decayLevel = sustainLevel) - * @param {Number} releaseTime Release Time (in seconds) - * @param {Number} releaseLevel Amplitude - * @example - *
- * var t1 = 0.1; // attack time in seconds - * var l1 = 0.7; // attack level 0.0 to 1.0 - * var t2 = 0.3; // decay time in seconds - * var l2 = 0.1; // decay level 0.0 to 1.0 - * var t3 = 0.2; // sustain time in seconds - * var l3 = dL; // sustain level 0.0 to 1.0 - * // release level defaults to zero - * - * var env; - * var triOsc; - * - * function setup() { - * background(0); - * noStroke(); - * fill(255); - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * env = new p5.Env(t1, l1, t2, l2, t3, l3); - * triOsc = new p5.Oscillator('triangle'); - * triOsc.amp(env); // give the env control of the triOsc's amp - * triOsc.start(); - * } - * - * // mouseClick triggers envelope if over canvas - * function mouseClicked() { - * // is mouse over canvas? - * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { - * env.play(triOsc); - * } - * } - *
- * - */ - p5.Env.prototype.set = function (t1, l1, t2, l2, t3, l3) { - this.aTime = t1; - this.aLevel = l1; - this.dTime = t2 || 0; - this.dLevel = l2 || 0; - this.rTime = t3 || 0; - this.rLevel = l3 || 0; - // set time constants for ramp - this._setRampAD(t1, t2); - }; - /** - * Set values like a traditional - * - * ADSR envelope - * . - * - * @method setADSR - * @param {Number} attackTime Time (in seconds before envelope - * reaches Attack Level - * @param {Number} [decayTime] Time (in seconds) before envelope - * reaches Decay/Sustain Level - * @param {Number} [susRatio] Ratio between attackLevel and releaseLevel, on a scale from 0 to 1, - * where 1.0 = attackLevel, 0.0 = releaseLevel. - * The susRatio determines the decayLevel and the level at which the - * sustain portion of the envelope will sustain. - * For example, if attackLevel is 0.4, releaseLevel is 0, - * and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is - * increased to 1.0 (using setRange), - * then decayLevel would increase proportionally, to become 0.5. - * @param {Number} [releaseTime] Time in seconds from now (defaults to 0) - * @example - *
- * var attackLevel = 1.0; - * var releaseLevel = 0; - * - * var attackTime = 0.001 - * var decayTime = 0.2; - * var susPercent = 0.2; - * var releaseTime = 0.5; - * - * var env, triOsc; - * - * function setup() { - * var cnv = createCanvas(100, 100); - * - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * env = new p5.Env(); - * env.setADSR(attackTime, decayTime, susPercent, releaseTime); - * env.setRange(attackLevel, releaseLevel); - * - * triOsc = new p5.Oscillator('triangle'); - * triOsc.amp(env); - * triOsc.start(); - * triOsc.freq(220); - * - * cnv.mousePressed(playEnv); - * } - * - * function playEnv(){ - * env.play(); - * } - *
- */ - p5.Env.prototype.setADSR = function (aTime, dTime, sPercent, rTime) { - this.aTime = aTime; - this.dTime = dTime || 0; - // lerp - this.sPercent = sPercent || 0; - this.dLevel = typeof sPercent !== 'undefined' ? sPercent * (this.aLevel - this.rLevel) + this.rLevel : 0; - this.rTime = rTime || 0; - // also set time constants for ramp - this._setRampAD(aTime, dTime); - }; - /** - * Set max (attackLevel) and min (releaseLevel) of envelope. - * - * @method setRange - * @param {Number} aLevel attack level (defaults to 1) - * @param {Number} rLevel release level (defaults to 0) - * @example - *
- * var attackLevel = 1.0; - * var releaseLevel = 0; - * - * var attackTime = 0.001 - * var decayTime = 0.2; - * var susPercent = 0.2; - * var releaseTime = 0.5; - * - * var env, triOsc; - * - * function setup() { - * var cnv = createCanvas(100, 100); - * - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * env = new p5.Env(); - * env.setADSR(attackTime, decayTime, susPercent, releaseTime); - * env.setRange(attackLevel, releaseLevel); - * - * triOsc = new p5.Oscillator('triangle'); - * triOsc.amp(env); - * triOsc.start(); - * triOsc.freq(220); - * - * cnv.mousePressed(playEnv); - * } - * - * function playEnv(){ - * env.play(); - * } - *
- */ - p5.Env.prototype.setRange = function (aLevel, rLevel) { - this.aLevel = aLevel || 1; - this.rLevel = rLevel || 0; - }; - // private (undocumented) method called when ADSR is set to set time constants for ramp - // - // Set the - // time constants for simple exponential ramps. - // The larger the time constant value, the slower the - // transition will be. - // - // method _setRampAD - // param {Number} attackTimeConstant attack time constant - // param {Number} decayTimeConstant decay time constant - // - p5.Env.prototype._setRampAD = function (t1, t2) { - this._rampAttackTime = this.checkExpInput(t1); - this._rampDecayTime = this.checkExpInput(t2); - var TCDenominator = 1; - /// Aatish Bhatia's calculation for time constant for rise(to adjust 1/1-e calculation to any percentage) - TCDenominator = Math.log(1 / this.checkExpInput(1 - this._rampHighPercentage)); - this._rampAttackTC = t1 / this.checkExpInput(TCDenominator); - TCDenominator = Math.log(1 / this._rampLowPercentage); - this._rampDecayTC = t2 / this.checkExpInput(TCDenominator); - }; - // private method - p5.Env.prototype.setRampPercentages = function (p1, p2) { - //set the percentages that the simple exponential ramps go to - this._rampHighPercentage = this.checkExpInput(p1); - this._rampLowPercentage = this.checkExpInput(p2); - var TCDenominator = 1; - //now re-compute the time constants based on those percentages - /// Aatish Bhatia's calculation for time constant for rise(to adjust 1/1-e calculation to any percentage) - TCDenominator = Math.log(1 / this.checkExpInput(1 - this._rampHighPercentage)); - this._rampAttackTC = this._rampAttackTime / this.checkExpInput(TCDenominator); - TCDenominator = Math.log(1 / this._rampLowPercentage); - this._rampDecayTC = this._rampDecayTime / this.checkExpInput(TCDenominator); - }; - /** - * Assign a parameter to be controlled by this envelope. - * If a p5.Sound object is given, then the p5.Env will control its - * output gain. If multiple inputs are provided, the env will - * control all of them. - * - * @method setInput - * @param {Object} unit A p5.sound object or - * Web Audio Param. - */ - p5.Env.prototype.setInput = function (unit) { - for (var i = 0; i < arguments.length; i++) { - this.connect(arguments[i]); - } - }; - /** - * Set whether the envelope ramp is linear (default) or exponential. - * Exponential ramps can be useful because we perceive amplitude - * and frequency logarithmically. - * - * @method setExp - * @param {Boolean} isExp true is exponential, false is linear - */ - p5.Env.prototype.setExp = function (isExp) { - this.isExponential = isExp; - }; - //helper method to protect against zero values being sent to exponential functions - p5.Env.prototype.checkExpInput = function (value) { - if (value <= 0) { - value = 1e-8; - } - return value; - }; - /** - * Play tells the envelope to start acting on a given input. - * If the input is a p5.sound object (i.e. AudioIn, Oscillator, - * SoundFile), then Env will control its output volume. - * Envelopes can also be used to control any - * Web Audio Audio Param. - * - * @method play - * @param {Object} unit A p5.sound object or - * Web Audio Param. - * @param {Number} [startTime] time from now (in seconds) at which to play - * @param {Number} [sustainTime] time to sustain before releasing the envelope - * @example - *
- * var attackLevel = 1.0; - * var releaseLevel = 0; - * - * var attackTime = 0.001 - * var decayTime = 0.2; - * var susPercent = 0.2; - * var releaseTime = 0.5; - * - * var env, triOsc; - * - * function setup() { - * var cnv = createCanvas(100, 100); - * - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * env = new p5.Env(); - * env.setADSR(attackTime, decayTime, susPercent, releaseTime); - * env.setRange(attackLevel, releaseLevel); - * - * triOsc = new p5.Oscillator('triangle'); - * triOsc.amp(env); - * triOsc.start(); - * triOsc.freq(220); - * - * cnv.mousePressed(playEnv); - * } - * - * function playEnv(){ - * // trigger env on triOsc, 0 seconds from now - * // After decay, sustain for 0.2 seconds before release - * env.play(triOsc, 0, 0.2); - * } - *
- */ - p5.Env.prototype.play = function (unit, secondsFromNow, susTime) { - var now = p5sound.audiocontext.currentTime; - var tFromNow = secondsFromNow || 0; - var susTime = susTime || 0; - if (unit) { - if (this.connection !== unit) { - this.connect(unit); - } - } - this.triggerAttack(unit, tFromNow); - this.triggerRelease(unit, tFromNow + this.aTime + this.dTime + susTime); - }; - /** - * Trigger the Attack, and Decay portion of the Envelope. - * Similar to holding down a key on a piano, but it will - * hold the sustain level until you let go. Input can be - * any p5.sound object, or a - * Web Audio Param. - * - * @method triggerAttack - * @param {Object} unit p5.sound Object or Web Audio Param - * @param {Number} secondsFromNow time from now (in seconds) - * @example - *
- * - * var attackLevel = 1.0; - * var releaseLevel = 0; - * - * var attackTime = 0.001 - * var decayTime = 0.3; - * var susPercent = 0.4; - * var releaseTime = 0.5; - * - * var env, triOsc; - * - * function setup() { - * var cnv = createCanvas(100, 100); - * background(200); - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * env = new p5.Env(); - * env.setADSR(attackTime, decayTime, susPercent, releaseTime); - * env.setRange(attackLevel, releaseLevel); - * - * triOsc = new p5.Oscillator('triangle'); - * triOsc.amp(env); - * triOsc.start(); - * triOsc.freq(220); - * - * cnv.mousePressed(envAttack); - * } - * - * function envAttack(){ - * console.log('trigger attack'); - * env.triggerAttack(); - * - * background(0,255,0); - * text('attack!', width/2, height/2); - * } - * - * function mouseReleased() { - * env.triggerRelease(); - * - * background(200); - * text('click to play', width/2, height/2); - * } - *
- */ - p5.Env.prototype.triggerAttack = function (unit, secondsFromNow) { - var now = p5sound.audiocontext.currentTime; - var tFromNow = secondsFromNow || 0; - var t = now + tFromNow; - this.lastAttack = t; - this.wasTriggered = true; - if (unit) { - if (this.connection !== unit) { - this.connect(unit); - } - } - // get and set value (with linear ramp) to anchor automation - var valToSet = this.control.getValueAtTime(t); - this.control.cancelScheduledValues(t); - // not sure if this is necessary - if (this.isExponential == true) { - this.control.exponentialRampToValueAtTime(this.checkExpInput(valToSet), t); - } else { - this.control.linearRampToValueAtTime(valToSet, t); - } - // after each ramp completes, cancel scheduled values - // (so they can be overridden in case env has been re-triggered) - // then, set current value (with linearRamp to avoid click) - // then, schedule the next automation... - // attack - t += this.aTime; - if (this.isExponential == true) { - this.control.exponentialRampToValueAtTime(this.checkExpInput(this.aLevel), t); - valToSet = this.checkExpInput(this.control.getValueAtTime(t)); - this.control.cancelScheduledValues(t); - this.control.exponentialRampToValueAtTime(valToSet, t); - } else { - this.control.linearRampToValueAtTime(this.aLevel, t); - valToSet = this.control.getValueAtTime(t); - this.control.cancelScheduledValues(t); - this.control.linearRampToValueAtTime(valToSet, t); - } - // decay to decay level (if using ADSR, then decay level == sustain level) - t += this.dTime; - if (this.isExponential == true) { - this.control.exponentialRampToValueAtTime(this.checkExpInput(this.dLevel), t); - valToSet = this.checkExpInput(this.control.getValueAtTime(t)); - this.control.cancelScheduledValues(t); - this.control.exponentialRampToValueAtTime(valToSet, t); - } else { - this.control.linearRampToValueAtTime(this.dLevel, t); - valToSet = this.control.getValueAtTime(t); - this.control.cancelScheduledValues(t); - this.control.linearRampToValueAtTime(valToSet, t); - } - }; - /** - * Trigger the Release of the Envelope. This is similar to releasing - * the key on a piano and letting the sound fade according to the - * release level and release time. - * - * @method triggerRelease - * @param {Object} unit p5.sound Object or Web Audio Param - * @param {Number} secondsFromNow time to trigger the release - * @example - *
- * - * var attackLevel = 1.0; - * var releaseLevel = 0; - * - * var attackTime = 0.001 - * var decayTime = 0.3; - * var susPercent = 0.4; - * var releaseTime = 0.5; - * - * var env, triOsc; - * - * function setup() { - * var cnv = createCanvas(100, 100); - * background(200); - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * env = new p5.Env(); - * env.setADSR(attackTime, decayTime, susPercent, releaseTime); - * env.setRange(attackLevel, releaseLevel); - * - * triOsc = new p5.Oscillator('triangle'); - * triOsc.amp(env); - * triOsc.start(); - * triOsc.freq(220); - * - * cnv.mousePressed(envAttack); - * } - * - * function envAttack(){ - * console.log('trigger attack'); - * env.triggerAttack(); - * - * background(0,255,0); - * text('attack!', width/2, height/2); - * } - * - * function mouseReleased() { - * env.triggerRelease(); - * - * background(200); - * text('click to play', width/2, height/2); - * } - *
- */ - p5.Env.prototype.triggerRelease = function (unit, secondsFromNow) { - // only trigger a release if an attack was triggered - if (!this.wasTriggered) { - // this currently causes a bit of trouble: - // if a later release has been scheduled (via the play function) - // a new earlier release won't interrupt it, because - // this.wasTriggered has already been set to false. - // If we want new earlier releases to override, then we need to - // keep track of the last release time, and if the new release time is - // earlier, then use it. - return; - } - var now = p5sound.audiocontext.currentTime; - var tFromNow = secondsFromNow || 0; - var t = now + tFromNow; - if (unit) { - if (this.connection !== unit) { - this.connect(unit); - } - } - // get and set value (with linear or exponential ramp) to anchor automation - var valToSet = this.control.getValueAtTime(t); - this.control.cancelScheduledValues(t); - // not sure if this is necessary - if (this.isExponential == true) { - this.control.exponentialRampToValueAtTime(this.checkExpInput(valToSet), t); - } else { - this.control.linearRampToValueAtTime(valToSet, t); - } - // release - t += this.rTime; - if (this.isExponential == true) { - this.control.exponentialRampToValueAtTime(this.checkExpInput(this.rLevel), t); - valToSet = this.checkExpInput(this.control.getValueAtTime(t)); - this.control.cancelScheduledValues(t); - this.control.exponentialRampToValueAtTime(valToSet, t); - } else { - this.control.linearRampToValueAtTime(this.rLevel, t); - valToSet = this.control.getValueAtTime(t); - this.control.cancelScheduledValues(t); - this.control.linearRampToValueAtTime(valToSet, t); - } - this.wasTriggered = false; - }; - /** - * Exponentially ramp to a value using the first two - * values from setADSR(attackTime, decayTime) - * as - * time constants for simple exponential ramps. - * If the value is higher than current value, it uses attackTime, - * while a decrease uses decayTime. - * - * @method ramp - * @param {Object} unit p5.sound Object or Web Audio Param - * @param {Number} secondsFromNow When to trigger the ramp - * @param {Number} v Target value - * @param {Number} [v2] Second target value (optional) - * @example - *
- * var env, osc, amp, cnv; - * - * var attackTime = 0.001; - * var decayTime = 0.2; - * var attackLevel = 1; - * var decayLevel = 0; - * - * function setup() { - * cnv = createCanvas(100, 100); - * fill(0,255,0); - * noStroke(); - * - * env = new p5.Env(); - * env.setADSR(attackTime, decayTime); - * - * osc = new p5.Oscillator(); - * osc.amp(env); - * osc.start(); - * - * amp = new p5.Amplitude(); - * - * cnv.mousePressed(triggerRamp); - * } - * - * function triggerRamp() { - * env.ramp(osc, 0, attackLevel, decayLevel); - * } - * - * function draw() { - * background(20,20,20); - * text('click me', 10, 20); - * var h = map(amp.getLevel(), 0, 0.4, 0, height);; - * - * rect(0, height, width, -h); - * } - *
- */ - p5.Env.prototype.ramp = function (unit, secondsFromNow, v1, v2) { - var now = p5sound.audiocontext.currentTime; - var tFromNow = secondsFromNow || 0; - var t = now + tFromNow; - var destination1 = this.checkExpInput(v1); - var destination2 = typeof v2 !== 'undefined' ? this.checkExpInput(v2) : undefined; - // connect env to unit if not already connected - if (unit) { - if (this.connection !== unit) { - this.connect(unit); - } - } - //get current value - var currentVal = this.checkExpInput(this.control.getValueAtTime(t)); - this.control.cancelScheduledValues(t); - //if it's going up - if (destination1 > currentVal) { - this.control.setTargetAtTime(destination1, t, this._rampAttackTC); - t += this._rampAttackTime; - } else if (destination1 < currentVal) { - this.control.setTargetAtTime(destination1, t, this._rampDecayTC); - t += this._rampDecayTime; - } - // Now the second part of envelope begins - if (destination2 === undefined) - return; - //if it's going up - if (destination2 > destination1) { - this.control.setTargetAtTime(destination2, t, this._rampAttackTC); - } else if (destination2 < destination1) { - this.control.setTargetAtTime(destination2, t, this._rampDecayTC); - } - }; - p5.Env.prototype.connect = function (unit) { - this.connection = unit; - // assume we're talking about output gain - // unless given a different audio param - if (unit instanceof p5.Oscillator || unit instanceof p5.SoundFile || unit instanceof p5.AudioIn || unit instanceof p5.Reverb || unit instanceof p5.Noise || unit instanceof p5.Filter || unit instanceof p5.Delay) { - unit = unit.output.gain; - } - if (unit instanceof AudioParam) { - //set the initial value - unit.setValueAtTime(0, p5sound.audiocontext.currentTime); - } - if (unit instanceof p5.Signal) { - unit.setValue(0); - } - this.output.connect(unit); - }; - p5.Env.prototype.disconnect = function (unit) { - this.output.disconnect(); - }; - // Signal Math - /** - * Add a value to the p5.Oscillator's output amplitude, - * and return the oscillator. Calling this method - * again will override the initial add() with new values. - * - * @method add - * @param {Number} number Constant number to add - * @return {p5.Env} Envelope Returns this envelope - * with scaled output - */ - p5.Env.prototype.add = function (num) { - var add = new Add(num); - var thisChain = this.mathOps.length; - var nextChain = this.output; - return p5.prototype._mathChain(this, add, thisChain, nextChain, Add); - }; - /** - * Multiply the p5.Env's output amplitude - * by a fixed value. Calling this method - * again will override the initial mult() with new values. - * - * @method mult - * @param {Number} number Constant number to multiply - * @return {p5.Env} Envelope Returns this envelope - * with scaled output - */ - p5.Env.prototype.mult = function (num) { - var mult = new Mult(num); - var thisChain = this.mathOps.length; - var nextChain = this.output; - return p5.prototype._mathChain(this, mult, thisChain, nextChain, Mult); - }; - /** - * Scale this envelope's amplitude values to a given - * range, and return the envelope. Calling this method - * again will override the initial scale() with new values. - * - * @method scale - * @param {Number} inMin input range minumum - * @param {Number} inMax input range maximum - * @param {Number} outMin input range minumum - * @param {Number} outMax input range maximum - * @return {p5.Env} Envelope Returns this envelope - * with scaled output - */ - p5.Env.prototype.scale = function (inMin, inMax, outMin, outMax) { - var scale = new Scale(inMin, inMax, outMin, outMax); - var thisChain = this.mathOps.length; - var nextChain = this.output; - return p5.prototype._mathChain(this, scale, thisChain, nextChain, Scale); - }; - // get rid of the oscillator - p5.Env.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - var now = p5sound.audiocontext.currentTime; - this.disconnect(); - try { - this.control.dispose(); - this.control = null; - } catch (e) { - } - for (var i = 1; i < this.mathOps.length; i++) { - mathOps[i].dispose(); - } - }; -}(master, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale, Tone_signal_TimelineSignal, Tone_core_Tone); -var pulse; -pulse = function () { - 'use strict'; - var p5sound = master; - /** - * Creates a Pulse object, an oscillator that implements - * Pulse Width Modulation. - * The pulse is created with two oscillators. - * Accepts a parameter for frequency, and to set the - * width between the pulses. See - * p5.Oscillator for a full list of methods. - * - * @class p5.Pulse - * @constructor - * @param {Number} [freq] Frequency in oscillations per second (Hz) - * @param {Number} [w] Width between the pulses (0 to 1.0, - * defaults to 0) - * @example - *
- * var pulse; - * function setup() { - * background(0); - * - * // Create and start the pulse wave oscillator - * pulse = new p5.Pulse(); - * pulse.amp(0.5); - * pulse.freq(220); - * pulse.start(); - * } - * - * function draw() { - * var w = map(mouseX, 0, width, 0, 1); - * w = constrain(w, 0, 1); - * pulse.width(w) - * } - *
- */ - p5.Pulse = function (freq, w) { - p5.Oscillator.call(this, freq, 'sawtooth'); - // width of PWM, should be betw 0 to 1.0 - this.w = w || 0; - // create a second oscillator with inverse frequency - this.osc2 = new p5.SawOsc(freq); - // create a delay node - this.dNode = p5sound.audiocontext.createDelay(); - // dc offset - this.dcOffset = createDCOffset(); - this.dcGain = p5sound.audiocontext.createGain(); - this.dcOffset.connect(this.dcGain); - this.dcGain.connect(this.output); - // set delay time based on PWM width - this.f = freq || 440; - var mW = this.w / this.oscillator.frequency.value; - this.dNode.delayTime.value = mW; - this.dcGain.gain.value = 1.7 * (0.5 - this.w); - // disconnect osc2 and connect it to delay, which is connected to output - this.osc2.disconnect(); - this.osc2.panner.disconnect(); - this.osc2.amp(-1); - // inverted amplitude - this.osc2.output.connect(this.dNode); - this.dNode.connect(this.output); - this.output.gain.value = 1; - this.output.connect(this.panner); - }; - p5.Pulse.prototype = Object.create(p5.Oscillator.prototype); - /** - * Set the width of a Pulse object (an oscillator that implements - * Pulse Width Modulation). - * - * @method width - * @param {Number} [width] Width between the pulses (0 to 1.0, - * defaults to 0) - */ - p5.Pulse.prototype.width = function (w) { - if (typeof w === 'number') { - if (w <= 1 && w >= 0) { - this.w = w; - // set delay time based on PWM width - // var mW = map(this.w, 0, 1.0, 0, 1/this.f); - var mW = this.w / this.oscillator.frequency.value; - this.dNode.delayTime.value = mW; - } - this.dcGain.gain.value = 1.7 * (0.5 - this.w); - } else { - w.connect(this.dNode.delayTime); - var sig = new p5.SignalAdd(-0.5); - sig.setInput(w); - sig = sig.mult(-1); - sig = sig.mult(1.7); - sig.connect(this.dcGain.gain); - } - }; - p5.Pulse.prototype.start = function (f, time) { - var now = p5sound.audiocontext.currentTime; - var t = time || 0; - if (!this.started) { - var freq = f || this.f; - var type = this.oscillator.type; - this.oscillator = p5sound.audiocontext.createOscillator(); - this.oscillator.frequency.setValueAtTime(freq, now); - this.oscillator.type = type; - this.oscillator.connect(this.output); - this.oscillator.start(t + now); - // set up osc2 - this.osc2.oscillator = p5sound.audiocontext.createOscillator(); - this.osc2.oscillator.frequency.setValueAtTime(freq, t + now); - this.osc2.oscillator.type = type; - this.osc2.oscillator.connect(this.osc2.output); - this.osc2.start(t + now); - this.freqNode = [ - this.oscillator.frequency, - this.osc2.oscillator.frequency - ]; - // start dcOffset, too - this.dcOffset = createDCOffset(); - this.dcOffset.connect(this.dcGain); - this.dcOffset.start(t + now); - // if LFO connections depend on these oscillators - if (this.mods !== undefined && this.mods.frequency !== undefined) { - this.mods.frequency.connect(this.freqNode[0]); - this.mods.frequency.connect(this.freqNode[1]); - } - this.started = true; - this.osc2.started = true; - } - }; - p5.Pulse.prototype.stop = function (time) { - if (this.started) { - var t = time || 0; - var now = p5sound.audiocontext.currentTime; - this.oscillator.stop(t + now); - this.osc2.oscillator.stop(t + now); - this.dcOffset.stop(t + now); - this.started = false; - this.osc2.started = false; - } - }; - p5.Pulse.prototype.freq = function (val, rampTime, tFromNow) { - if (typeof val === 'number') { - this.f = val; - var now = p5sound.audiocontext.currentTime; - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var currentFreq = this.oscillator.frequency.value; - this.oscillator.frequency.cancelScheduledValues(now); - this.oscillator.frequency.setValueAtTime(currentFreq, now + tFromNow); - this.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now); - this.osc2.oscillator.frequency.cancelScheduledValues(now); - this.osc2.oscillator.frequency.setValueAtTime(currentFreq, now + tFromNow); - this.osc2.oscillator.frequency.exponentialRampToValueAtTime(val, tFromNow + rampTime + now); - if (this.freqMod) { - this.freqMod.output.disconnect(); - this.freqMod = null; - } - } else if (val.output) { - val.output.disconnect(); - val.output.connect(this.oscillator.frequency); - val.output.connect(this.osc2.oscillator.frequency); - this.freqMod = val; - } - }; - // inspiration: http://webaudiodemos.appspot.com/oscilloscope/ - function createDCOffset() { - var ac = p5sound.audiocontext; - var buffer = ac.createBuffer(1, 2048, ac.sampleRate); - var data = buffer.getChannelData(0); - for (var i = 0; i < 2048; i++) - data[i] = 1; - var bufferSource = ac.createBufferSource(); - bufferSource.buffer = buffer; - bufferSource.loop = true; - return bufferSource; - } -}(master, oscillator); -var noise; -noise = function () { - 'use strict'; - var p5sound = master; - /** - * Noise is a type of oscillator that generates a buffer with random values. - * - * @class p5.Noise - * @constructor - * @param {String} type Type of noise can be 'white' (default), - * 'brown' or 'pink'. - * @return {Object} Noise Object - */ - p5.Noise = function (type) { - var assignType; - p5.Oscillator.call(this); - delete this.f; - delete this.freq; - delete this.oscillator; - if (type === 'brown') { - assignType = _brownNoise; - } else if (type === 'pink') { - assignType = _pinkNoise; - } else { - assignType = _whiteNoise; - } - this.buffer = assignType; - }; - p5.Noise.prototype = Object.create(p5.Oscillator.prototype); - // generate noise buffers - var _whiteNoise = function () { - var bufferSize = 2 * p5sound.audiocontext.sampleRate; - var whiteBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate); - var noiseData = whiteBuffer.getChannelData(0); - for (var i = 0; i < bufferSize; i++) { - noiseData[i] = Math.random() * 2 - 1; - } - whiteBuffer.type = 'white'; - return whiteBuffer; - }(); - var _pinkNoise = function () { - var bufferSize = 2 * p5sound.audiocontext.sampleRate; - var pinkBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate); - var noiseData = pinkBuffer.getChannelData(0); - var b0, b1, b2, b3, b4, b5, b6; - b0 = b1 = b2 = b3 = b4 = b5 = b6 = 0; - for (var i = 0; i < bufferSize; i++) { - var white = Math.random() * 2 - 1; - b0 = 0.99886 * b0 + white * 0.0555179; - b1 = 0.99332 * b1 + white * 0.0750759; - b2 = 0.969 * b2 + white * 0.153852; - b3 = 0.8665 * b3 + white * 0.3104856; - b4 = 0.55 * b4 + white * 0.5329522; - b5 = -0.7616 * b5 - white * 0.016898; - noiseData[i] = b0 + b1 + b2 + b3 + b4 + b5 + b6 + white * 0.5362; - noiseData[i] *= 0.11; - // (roughly) compensate for gain - b6 = white * 0.115926; - } - pinkBuffer.type = 'pink'; - return pinkBuffer; - }(); - var _brownNoise = function () { - var bufferSize = 2 * p5sound.audiocontext.sampleRate; - var brownBuffer = p5sound.audiocontext.createBuffer(1, bufferSize, p5sound.audiocontext.sampleRate); - var noiseData = brownBuffer.getChannelData(0); - var lastOut = 0; - for (var i = 0; i < bufferSize; i++) { - var white = Math.random() * 2 - 1; - noiseData[i] = (lastOut + 0.02 * white) / 1.02; - lastOut = noiseData[i]; - noiseData[i] *= 3.5; - } - brownBuffer.type = 'brown'; - return brownBuffer; - }(); - /** - * Set type of noise to 'white', 'pink' or 'brown'. - * White is the default. - * - * @method setType - * @param {String} [type] 'white', 'pink' or 'brown' - */ - p5.Noise.prototype.setType = function (type) { - switch (type) { - case 'white': - this.buffer = _whiteNoise; - break; - case 'pink': - this.buffer = _pinkNoise; - break; - case 'brown': - this.buffer = _brownNoise; - break; - default: - this.buffer = _whiteNoise; - } - if (this.started) { - var now = p5sound.audiocontext.currentTime; - this.stop(now); - this.start(now + 0.01); - } - }; - p5.Noise.prototype.getType = function () { - return this.buffer.type; - }; - /** - * Start the noise - * - * @method start - */ - p5.Noise.prototype.start = function () { - if (this.started) { - this.stop(); - } - this.noise = p5sound.audiocontext.createBufferSource(); - this.noise.buffer = this.buffer; - this.noise.loop = true; - this.noise.connect(this.output); - var now = p5sound.audiocontext.currentTime; - this.noise.start(now); - this.started = true; - }; - /** - * Stop the noise. - * - * @method stop - */ - p5.Noise.prototype.stop = function () { - var now = p5sound.audiocontext.currentTime; - if (this.noise) { - this.noise.stop(now); - this.started = false; - } - }; - /** - * Pan the noise. - * - * @method pan - * @param {Number} panning Number between -1 (left) - * and 1 (right) - * @param {Number} timeFromNow schedule this event to happen - * seconds from now - */ - /** - * Set the amplitude of the noise between 0 and 1.0. Or, - * modulate amplitude with an audio signal such as an oscillator. - * - * @param {Number|Object} volume amplitude between 0 and 1.0 - * or modulating signal/oscillator - * @param {Number} [rampTime] create a fade that lasts rampTime - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - */ - /** - * Send output to a p5.sound or web audio object - * - * @method connect - * @param {Object} unit - */ - /** - * Disconnect all output. - * - * @method disconnect - */ - p5.Noise.prototype.dispose = function () { - var now = p5sound.audiocontext.currentTime; - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - if (this.noise) { - this.noise.disconnect(); - this.stop(now); - } - if (this.output) { - this.output.disconnect(); - } - if (this.panner) { - this.panner.disconnect(); - } - this.output = null; - this.panner = null; - this.buffer = null; - this.noise = null; - }; -}(master); -var audioin; -audioin = function () { - 'use strict'; - var p5sound = master; - var CustomError = errorHandler; - /** - *

Get audio from an input, i.e. your computer's microphone.

- * - *

Turn the mic on/off with the start() and stop() methods. When the mic - * is on, its volume can be measured with getLevel or by connecting an - * FFT object.

- * - *

If you want to hear the AudioIn, use the .connect() method. - * AudioIn does not connect to p5.sound output by default to prevent - * feedback.

- * - *

Note: This uses the getUserMedia/ - * Stream API, which is not supported by certain browsers. Access in Chrome browser - * is limited to localhost and https, but access over http may be limited.

- * - * @class p5.AudioIn - * @constructor - * @param {Function} [errorCallback] A function to call if there is an error - * accessing the AudioIn. For example, - * Safari and iOS devices do not - * currently allow microphone access. - * @return {Object} AudioIn - * @example - *
- * var mic; - * function setup(){ - * mic = new p5.AudioIn() - * mic.start(); - * } - * function draw(){ - * background(0); - * micLevel = mic.getLevel(); - * ellipse(width/2, constrain(height-micLevel*height*5, 0, height), 10, 10); - * } - *
- */ - p5.AudioIn = function (errorCallback) { - // set up audio input - this.input = p5sound.audiocontext.createGain(); - this.output = p5sound.audiocontext.createGain(); - this.stream = null; - this.mediaStream = null; - this.currentSource = 0; - /** - * Client must allow browser to access their microphone / audioin source. - * Default: false. Will become true when the client enables acces. - * - * @property {Boolean} enabled - */ - this.enabled = false; - // create an amplitude, connect to it by default but not to master out - this.amplitude = new p5.Amplitude(); - this.output.connect(this.amplitude.input); - // Some browsers let developer determine their input sources - if (typeof window.MediaStreamTrack === 'undefined') { - if (errorCallback) { - errorCallback(); - } else { - window.alert('This browser does not support AudioIn'); - } - } else if (typeof window.MediaDevices.enumerateDevices === 'function') { - // Chrome supports getSources to list inputs. Dev picks default - window.MediaDevices.enumerateDevices(this._gotSources); - } else { - } - // add to soundArray so we can dispose on close - p5sound.soundArray.push(this); - }; - /** - * Start processing audio input. This enables the use of other - * AudioIn methods like getLevel(). Note that by default, AudioIn - * is not connected to p5.sound's output. So you won't hear - * anything unless you use the connect() method.
- * - * Certain browsers limit access to the user's microphone. For example, - * Chrome only allows access from localhost and over https. For this reason, - * you may want to include an errorCallback—a function that is called in case - * the browser won't provide mic access. - * - * @method start - * @param {Function} successCallback Name of a function to call on - * success. - * @param {Function} errorCallback Name of a function to call if - * there was an error. For example, - * some browsers do not support - * getUserMedia. - */ - p5.AudioIn.prototype.start = function (successCallback, errorCallback) { - var self = this; - // if stream was already started... - // if _gotSources() i.e. developers determine which source to use - if (p5sound.inputSources[self.currentSource]) { - // set the audio source - var audioSource = p5sound.inputSources[self.currentSource].id; - var constraints = { audio: { optional: [{ sourceId: audioSource }] } }; - window.navigator.getUserMedia(constraints, this._onStream = function (stream) { - self.stream = stream; - self.enabled = true; - // Wrap a MediaStreamSourceNode around the live input - self.mediaStream = p5sound.audiocontext.createMediaStreamSource(stream); - self.mediaStream.connect(self.output); - if (successCallback) - successCallback(); - // only send to the Amplitude reader, so we can see it but not hear it. - self.amplitude.setInput(self.output); - }, this._onStreamError = function (e) { - if (errorCallback) - errorCallback(e); - else - console.error(e); - }); - } else { - // if Firefox where users select their source via browser - // if (typeof MediaStreamTrack.getSources === 'undefined') { - // Only get the audio stream. - window.navigator.getUserMedia({ 'audio': true }, this._onStream = function (stream) { - self.stream = stream; - self.enabled = true; - // Wrap a MediaStreamSourceNode around the live input - self.mediaStream = p5sound.audiocontext.createMediaStreamSource(stream); - self.mediaStream.connect(self.output); - // only send to the Amplitude reader, so we can see it but not hear it. - self.amplitude.setInput(self.output); - if (successCallback) - successCallback(); - }, this._onStreamError = function (e) { - if (errorCallback) - errorCallback(e); - else - console.error(e); - }); - } - }; - /** - * Turn the AudioIn off. If the AudioIn is stopped, it cannot getLevel(). - * If re-starting, the user may be prompted for permission access. - * - * @method stop - */ - p5.AudioIn.prototype.stop = function () { - if (this.stream) { - // assume only one track - this.stream.getTracks()[0].stop(); - } - }; - /** - * Connect to an audio unit. If no parameter is provided, will - * connect to the master output (i.e. your speakers).
- * - * @method connect - * @param {Object} [unit] An object that accepts audio input, - * such as an FFT - */ - p5.AudioIn.prototype.connect = function (unit) { - if (unit) { - if (unit.hasOwnProperty('input')) { - this.output.connect(unit.input); - } else if (unit.hasOwnProperty('analyser')) { - this.output.connect(unit.analyser); - } else { - this.output.connect(unit); - } - } else { - this.output.connect(p5sound.input); - } - }; - /** - * Disconnect the AudioIn from all audio units. For example, if - * connect() had been called, disconnect() will stop sending - * signal to your speakers.
- * - * @method disconnect - */ - p5.AudioIn.prototype.disconnect = function () { - this.output.disconnect(); - // stay connected to amplitude even if not outputting to p5 - this.output.connect(this.amplitude.input); - }; - /** - * Read the Amplitude (volume level) of an AudioIn. The AudioIn - * class contains its own instance of the Amplitude class to help - * make it easy to get a microphone's volume level. Accepts an - * optional smoothing value (0.0 < 1.0). NOTE: AudioIn must - * .start() before using .getLevel().
- * - * @method getLevel - * @param {Number} [smoothing] Smoothing is 0.0 by default. - * Smooths values based on previous values. - * @return {Number} Volume level (between 0.0 and 1.0) - */ - p5.AudioIn.prototype.getLevel = function (smoothing) { - if (smoothing) { - this.amplitude.smoothing = smoothing; - } - return this.amplitude.getLevel(); - }; - /** - * Add input sources to the list of available sources. - * - * @private - */ - p5.AudioIn.prototype._gotSources = function (sourceInfos) { - for (var i = 0; i < sourceInfos.length; i++) { - var sourceInfo = sourceInfos[i]; - if (sourceInfo.kind === 'audio') { - // add the inputs to inputSources - //p5sound.inputSources.push(sourceInfo); - return sourceInfo; - } - } - }; - /** - * Set amplitude (volume) of a mic input between 0 and 1.0.
- * - * @method amp - * @param {Number} vol between 0 and 1.0 - * @param {Number} [time] ramp time (optional) - */ - p5.AudioIn.prototype.amp = function (vol, t) { - if (t) { - var rampTime = t || 0; - var currentVol = this.output.gain.value; - this.output.gain.cancelScheduledValues(p5sound.audiocontext.currentTime); - this.output.gain.setValueAtTime(currentVol, p5sound.audiocontext.currentTime); - this.output.gain.linearRampToValueAtTime(vol, rampTime + p5sound.audiocontext.currentTime); - } else { - this.output.gain.cancelScheduledValues(p5sound.audiocontext.currentTime); - this.output.gain.setValueAtTime(vol, p5sound.audiocontext.currentTime); - } - }; - p5.AudioIn.prototype.listSources = function () { - console.log('listSources is deprecated - please use AudioIn.getSources'); - console.log('input sources: '); - if (p5sound.inputSources.length > 0) { - return p5sound.inputSources; - } else { - return 'This browser does not support MediaStreamTrack.getSources()'; - } - }; - /** - * Chrome only. Returns a list of available input sources - * and allows the user to set the media source. Firefox allows - * the user to choose from input sources in the permissions dialogue - * instead of enumerating available sources and selecting one. - * Note: in order to have descriptive media names your page must be - * served over a secure (HTTPS) connection and the page should - * request user media before enumerating devices. Otherwise device - * ID will be a long device ID number and does not specify device - * type. For example see - * https://simpl.info/getusermedia/sources/index.html vs. - * http://simpl.info/getusermedia/sources/index.html - * - * @method getSources - * @param {Function} callback a callback to handle the sources - * when they have been enumerated - * @example - *
- * var audiograb; - * - * function setup(){ - * //new audioIn - * audioGrab = new p5.AudioIn(); - * - * audioGrab.getSources(function(sourceList) { - * //print out the array of available sources - * console.log(sourceList); - * //set the source to the first item in the inputSources array - * audioGrab.setSource(0); - * }); - * } - *
- */ - p5.AudioIn.prototype.getSources = function (callback) { - if (typeof window.MediaStreamTrack.getSources === 'function') { - window.MediaStreamTrack.getSources(function (data) { - for (var i = 0, max = data.length; i < max; i++) { - var sourceInfo = data[i]; - if (sourceInfo.kind === 'audio') { - // add the inputs to inputSources - p5sound.inputSources.push(sourceInfo); - } - } - callback(p5sound.inputSources); - }); - } else { - console.log('This browser does not support MediaStreamTrack.getSources()'); - } - }; - /** - * Set the input source. Accepts a number representing a - * position in the array returned by listSources(). - * This is only available in browsers that support - * MediaStreamTrack.getSources(). Instead, some browsers - * give users the option to set their own media source.
- * - * @method setSource - * @param {number} num position of input source in the array - */ - p5.AudioIn.prototype.setSource = function (num) { - // TO DO - set input by string or # (array position) - var self = this; - if (p5sound.inputSources.length > 0 && num < p5sound.inputSources.length) { - // set the current source - self.currentSource = num; - console.log('set source to ' + p5sound.inputSources[self.currentSource].id); - } else { - console.log('unable to set input source'); - } - }; - // private method - p5.AudioIn.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.stop(); - if (this.output) { - this.output.disconnect(); - } - if (this.amplitude) { - this.amplitude.disconnect(); - } - this.amplitude = null; - this.output = null; - }; -}(master, errorHandler); -var filter; -filter = function () { - 'use strict'; - var p5sound = master; - /** - * A p5.Filter uses a Web Audio Biquad Filter to filter - * the frequency response of an input source. Inheriting - * classes include:
- * * p5.LowPass - allows frequencies below - * the cutoff frequency to pass through, and attenuates - * frequencies above the cutoff.
- * * p5.HighPass - the opposite of a lowpass - * filter.
- * * p5.BandPass - allows a range of - * frequencies to pass through and attenuates the frequencies - * below and above this frequency range.
- * - * The .res() method controls either width of the - * bandpass, or resonance of the low/highpass cutoff frequency. - * - * @class p5.Filter - * @constructor - * @param {String} [type] 'lowpass' (default), 'highpass', 'bandpass' - * @return {Object} p5.Filter - * @example - *
- * var fft, noise, filter; - * - * function setup() { - * fill(255, 40, 255); - * - * filter = new p5.BandPass(); - * - * noise = new p5.Noise(); - * // disconnect unfiltered noise, - * // and connect to filter - * noise.disconnect(); - * noise.connect(filter); - * noise.start(); - * - * fft = new p5.FFT(); - * } - * - * function draw() { - * background(30); - * - * // set the BandPass frequency based on mouseX - * var freq = map(mouseX, 0, width, 20, 10000); - * filter.freq(freq); - * // give the filter a narrow band (lower res = wider bandpass) - * filter.res(50); - * - * // draw filtered spectrum - * var spectrum = fft.analyze(); - * noStroke(); - * for (var i = 0; i < spectrum.length; i++) { - * var x = map(i, 0, spectrum.length, 0, width); - * var h = -height + map(spectrum[i], 0, 255, height, 0); - * rect(x, height, width/spectrum.length, h); - * } - * - * isMouseOverCanvas(); - * } - * - * function isMouseOverCanvas() { - * var mX = mouseX, mY = mouseY; - * if (mX > 0 && mX < width && mY < height && mY > 0) { - * noise.amp(0.5, 0.2); - * } else { - * noise.amp(0, 0.2); - * } - * } - *
- */ - p5.Filter = function (type) { - this.ac = p5sound.audiocontext; - this.input = this.ac.createGain(); - this.output = this.ac.createGain(); - /** - * The p5.Filter is built with a - * - * Web Audio BiquadFilter Node. - * - * @property biquadFilter - * @type {Object} Web Audio Delay Node - */ - this.biquad = this.ac.createBiquadFilter(); - this.input.connect(this.biquad); - this.biquad.connect(this.output); - this.connect(); - if (type) { - this.setType(type); - } - // add to the soundArray - p5sound.soundArray.push(this); - }; - /** - * Filter an audio signal according to a set - * of filter parameters. - * - * @method process - * @param {Object} Signal An object that outputs audio - * @param {Number} [freq] Frequency in Hz, from 10 to 22050 - * @param {Number} [res] Resonance/Width of the filter frequency - * from 0.001 to 1000 - */ - p5.Filter.prototype.process = function (src, freq, res) { - src.connect(this.input); - this.set(freq, res); - }; - /** - * Set the frequency and the resonance of the filter. - * - * @method set - * @param {Number} freq Frequency in Hz, from 10 to 22050 - * @param {Number} res Resonance (Q) from 0.001 to 1000 - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - */ - p5.Filter.prototype.set = function (freq, res, time) { - if (freq) { - this.freq(freq, time); - } - if (res) { - this.res(res, time); - } - }; - /** - * Set the filter frequency, in Hz, from 10 to 22050 (the range of - * human hearing, although in reality most people hear in a narrower - * range). - * - * @method freq - * @param {Number} freq Filter Frequency - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - * @return {Number} value Returns the current frequency value - */ - p5.Filter.prototype.freq = function (freq, time) { - var self = this; - var t = time || 0; - if (freq <= 0) { - freq = 1; - } - if (typeof freq === 'number') { - self.biquad.frequency.value = freq; - self.biquad.frequency.cancelScheduledValues(this.ac.currentTime + 0.01 + t); - self.biquad.frequency.exponentialRampToValueAtTime(freq, this.ac.currentTime + 0.02 + t); - } else if (freq) { - freq.connect(this.biquad.frequency); - } - return self.biquad.frequency.value; - }; - /** - * Controls either width of a bandpass frequency, - * or the resonance of a low/highpass cutoff frequency. - * - * @method res - * @param {Number} res Resonance/Width of filter freq - * from 0.001 to 1000 - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - * @return {Number} value Returns the current res value - */ - p5.Filter.prototype.res = function (res, time) { - var self = this; - var t = time || 0; - if (typeof res == 'number') { - self.biquad.Q.value = res; - self.biquad.Q.cancelScheduledValues(self.ac.currentTime + 0.01 + t); - self.biquad.Q.linearRampToValueAtTime(res, self.ac.currentTime + 0.02 + t); - } else if (res) { - freq.connect(this.biquad.Q); - } - return self.biquad.Q.value; - }; - /** - * Set the type of a p5.Filter. Possible types include: - * "lowpass" (default), "highpass", "bandpass", - * "lowshelf", "highshelf", "peaking", "notch", - * "allpass". - * - * @method setType - * @param {String} t type of filter - */ - p5.Filter.prototype.setType = function (t) { - this.biquad.type = t; - }; - /** - * Set the output level of the filter. - * - * @method amp - * @param {Number} volume amplitude between 0 and 1.0 - * @param {Number} [rampTime] create a fade that lasts rampTime - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - */ - p5.Filter.prototype.amp = function (vol, rampTime, tFromNow) { - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var now = p5sound.audiocontext.currentTime; - var currentVol = this.output.gain.value; - this.output.gain.cancelScheduledValues(now); - this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow + 0.001); - this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime + 0.001); - }; - /** - * Send output to a p5.sound or web audio object - * - * @method connect - * @param {Object} unit - */ - p5.Filter.prototype.connect = function (unit) { - var u = unit || p5.soundOut.input; - this.output.connect(u); - }; - /** - * Disconnect all output. - * - * @method disconnect - */ - p5.Filter.prototype.disconnect = function () { - this.output.disconnect(); - }; - p5.Filter.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.input.disconnect(); - this.input = undefined; - this.output.disconnect(); - this.output = undefined; - this.biquad.disconnect(); - this.biquad = undefined; - }; - /** - * Constructor: new p5.LowPass() Filter. - * This is the same as creating a p5.Filter and then calling - * its method setType('lowpass'). - * See p5.Filter for methods. - * - * @method p5.LowPass - */ - p5.LowPass = function () { - p5.Filter.call(this, 'lowpass'); - }; - p5.LowPass.prototype = Object.create(p5.Filter.prototype); - /** - * Constructor: new p5.HighPass() Filter. - * This is the same as creating a p5.Filter and then calling - * its method setType('highpass'). - * See p5.Filter for methods. - * - * @method p5.HighPass - */ - p5.HighPass = function () { - p5.Filter.call(this, 'highpass'); - }; - p5.HighPass.prototype = Object.create(p5.Filter.prototype); - /** - * Constructor: new p5.BandPass() Filter. - * This is the same as creating a p5.Filter and then calling - * its method setType('bandpass'). - * See p5.Filter for methods. - * - * @method p5.BandPass - */ - p5.BandPass = function () { - p5.Filter.call(this, 'bandpass'); - }; - p5.BandPass.prototype = Object.create(p5.Filter.prototype); -}(master); -var delay; -delay = function () { - 'use strict'; - var p5sound = master; - var Filter = filter; - /** - * Delay is an echo effect. It processes an existing sound source, - * and outputs a delayed version of that sound. The p5.Delay can - * produce different effects depending on the delayTime, feedback, - * filter, and type. In the example below, a feedback of 0.5 will - * produce a looping delay that decreases in volume by - * 50% each repeat. A filter will cut out the high frequencies so - * that the delay does not sound as piercing as the original source. - * - * @class p5.Delay - * @constructor - * @return {Object} Returns a p5.Delay object - * @example - *
- * var noise, env, delay; - * - * function setup() { - * background(0); - * noStroke(); - * fill(255); - * textAlign(CENTER); - * text('click to play', width/2, height/2); - * - * noise = new p5.Noise('brown'); - * noise.amp(0); - * noise.start(); - * - * delay = new p5.Delay(); - * - * // delay.process() accepts 4 parameters: - * // source, delayTime, feedback, filter frequency - * // play with these numbers!! - * delay.process(noise, .12, .7, 2300); - * - * // play the noise with an envelope, - * // a series of fades ( time / value pairs ) - * env = new p5.Env(.01, 0.2, .2, .1); - * } - * - * // mouseClick triggers envelope - * function mouseClicked() { - * // is mouse over canvas? - * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { - * env.play(noise); - * } - * } - *
- */ - p5.Delay = function () { - this.ac = p5sound.audiocontext; - this.input = this.ac.createGain(); - this.output = this.ac.createGain(); - this._split = this.ac.createChannelSplitter(2); - this._merge = this.ac.createChannelMerger(2); - this._leftGain = this.ac.createGain(); - this._rightGain = this.ac.createGain(); - /** - * The p5.Delay is built with two - * - * Web Audio Delay Nodes, one for each stereo channel. - * - * @property leftDelay - * @type {Object} Web Audio Delay Node - */ - this.leftDelay = this.ac.createDelay(); - /** - * The p5.Delay is built with two - * - * Web Audio Delay Nodes, one for each stereo channel. - * - * @property rightDelay - * @type {Object} Web Audio Delay Node - */ - this.rightDelay = this.ac.createDelay(); - this._leftFilter = new p5.Filter(); - this._rightFilter = new p5.Filter(); - this._leftFilter.disconnect(); - this._rightFilter.disconnect(); - this._leftFilter.biquad.frequency.setValueAtTime(1200, this.ac.currentTime); - this._rightFilter.biquad.frequency.setValueAtTime(1200, this.ac.currentTime); - this._leftFilter.biquad.Q.setValueAtTime(0.3, this.ac.currentTime); - this._rightFilter.biquad.Q.setValueAtTime(0.3, this.ac.currentTime); - // graph routing - this.input.connect(this._split); - this.leftDelay.connect(this._leftGain); - this.rightDelay.connect(this._rightGain); - this._leftGain.connect(this._leftFilter.input); - this._rightGain.connect(this._rightFilter.input); - this._merge.connect(this.output); - this.output.connect(p5.soundOut.input); - this._leftFilter.biquad.gain.setValueAtTime(1, this.ac.currentTime); - this._rightFilter.biquad.gain.setValueAtTime(1, this.ac.currentTime); - // default routing - this.setType(0); - this._maxDelay = this.leftDelay.delayTime.maxValue; - // add this p5.SoundFile to the soundArray - p5sound.soundArray.push(this); - }; - /** - * Add delay to an audio signal according to a set - * of delay parameters. - * - * @method process - * @param {Object} Signal An object that outputs audio - * @param {Number} [delayTime] Time (in seconds) of the delay/echo. - * Some browsers limit delayTime to - * 1 second. - * @param {Number} [feedback] sends the delay back through itself - * in a loop that decreases in volume - * each time. - * @param {Number} [lowPass] Cutoff frequency. Only frequencies - * below the lowPass will be part of the - * delay. - */ - p5.Delay.prototype.process = function (src, _delayTime, _feedback, _filter) { - var feedback = _feedback || 0; - var delayTime = _delayTime || 0; - if (feedback >= 1) { - throw new Error('Feedback value will force a positive feedback loop.'); - } - if (delayTime >= this._maxDelay) { - throw new Error('Delay Time exceeds maximum delay time of ' + this._maxDelay + ' second.'); - } - src.connect(this.input); - this.leftDelay.delayTime.setValueAtTime(delayTime, this.ac.currentTime); - this.rightDelay.delayTime.setValueAtTime(delayTime, this.ac.currentTime); - this._leftGain.gain.setValueAtTime(feedback, this.ac.currentTime); - this._rightGain.gain.setValueAtTime(feedback, this.ac.currentTime); - if (_filter) { - this._leftFilter.freq(_filter); - this._rightFilter.freq(_filter); - } - }; - /** - * Set the delay (echo) time, in seconds. Usually this value will be - * a floating point number between 0.0 and 1.0. - * - * @method delayTime - * @param {Number} delayTime Time (in seconds) of the delay - */ - p5.Delay.prototype.delayTime = function (t) { - // if t is an audio node... - if (typeof t !== 'number') { - t.connect(this.leftDelay.delayTime); - t.connect(this.rightDelay.delayTime); - } else { - this.leftDelay.delayTime.cancelScheduledValues(this.ac.currentTime); - this.rightDelay.delayTime.cancelScheduledValues(this.ac.currentTime); - this.leftDelay.delayTime.linearRampToValueAtTime(t, this.ac.currentTime); - this.rightDelay.delayTime.linearRampToValueAtTime(t, this.ac.currentTime); - } - }; - /** - * Feedback occurs when Delay sends its signal back through its input - * in a loop. The feedback amount determines how much signal to send each - * time through the loop. A feedback greater than 1.0 is not desirable because - * it will increase the overall output each time through the loop, - * creating an infinite feedback loop. - * - * @method feedback - * @param {Number|Object} feedback 0.0 to 1.0, or an object such as an - * Oscillator that can be used to - * modulate this param - */ - p5.Delay.prototype.feedback = function (f) { - // if f is an audio node... - if (typeof f !== 'number') { - f.connect(this._leftGain.gain); - f.connect(this._rightGain.gain); - } else if (f >= 1) { - throw new Error('Feedback value will force a positive feedback loop.'); - } else { - this._leftGain.gain.exponentialRampToValueAtTime(f, this.ac.currentTime); - this._rightGain.gain.exponentialRampToValueAtTime(f, this.ac.currentTime); - } - }; - /** - * Set a lowpass filter frequency for the delay. A lowpass filter - * will cut off any frequencies higher than the filter frequency. - * - * @method filter - * @param {Number|Object} cutoffFreq A lowpass filter will cut off any - * frequencies higher than the filter frequency. - * @param {Number|Object} res Resonance of the filter frequency - * cutoff, or an object (i.e. a p5.Oscillator) - * that can be used to modulate this parameter. - * High numbers (i.e. 15) will produce a resonance, - * low numbers (i.e. .2) will produce a slope. - */ - p5.Delay.prototype.filter = function (freq, q) { - this._leftFilter.set(freq, q); - this._rightFilter.set(freq, q); - }; - /** - * Choose a preset type of delay. 'pingPong' bounces the signal - * from the left to the right channel to produce a stereo effect. - * Any other parameter will revert to the default delay setting. - * - * @method setType - * @param {String|Number} type 'pingPong' (1) or 'default' (0) - */ - p5.Delay.prototype.setType = function (t) { - if (t === 1) { - t = 'pingPong'; - } - this._split.disconnect(); - this._leftFilter.disconnect(); - this._rightFilter.disconnect(); - this._split.connect(this.leftDelay, 0); - this._split.connect(this.rightDelay, 1); - switch (t) { - case 'pingPong': - this._rightFilter.setType(this._leftFilter.biquad.type); - this._leftFilter.output.connect(this._merge, 0, 0); - this._rightFilter.output.connect(this._merge, 0, 1); - this._leftFilter.output.connect(this.rightDelay); - this._rightFilter.output.connect(this.leftDelay); - break; - default: - this._leftFilter.output.connect(this._merge, 0, 0); - this._leftFilter.output.connect(this._merge, 0, 1); - this._leftFilter.output.connect(this.leftDelay); - this._leftFilter.output.connect(this.rightDelay); - } - }; - /** - * Set the output level of the delay effect. - * - * @method amp - * @param {Number} volume amplitude between 0 and 1.0 - * @param {Number} [rampTime] create a fade that lasts rampTime - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - */ - p5.Delay.prototype.amp = function (vol, rampTime, tFromNow) { - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var now = p5sound.audiocontext.currentTime; - var currentVol = this.output.gain.value; - this.output.gain.cancelScheduledValues(now); - this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow + 0.001); - this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime + 0.001); - }; - /** - * Send output to a p5.sound or web audio object - * - * @method connect - * @param {Object} unit - */ - p5.Delay.prototype.connect = function (unit) { - var u = unit || p5.soundOut.input; - this.output.connect(u); - }; - /** - * Disconnect all output. - * - * @method disconnect - */ - p5.Delay.prototype.disconnect = function () { - this.output.disconnect(); - }; - p5.Delay.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.input.disconnect(); - this.output.disconnect(); - this._split.disconnect(); - this._leftFilter.disconnect(); - this._rightFilter.disconnect(); - this._merge.disconnect(); - this._leftGain.disconnect(); - this._rightGain.disconnect(); - this.leftDelay.disconnect(); - this.rightDelay.disconnect(); - this.input = undefined; - this.output = undefined; - this._split = undefined; - this._leftFilter = undefined; - this._rightFilter = undefined; - this._merge = undefined; - this._leftGain = undefined; - this._rightGain = undefined; - this.leftDelay = undefined; - this.rightDelay = undefined; - }; -}(master, filter); -var reverb; -reverb = function () { - 'use strict'; - var p5sound = master; - var CustomError = errorHandler; - /** - * Reverb adds depth to a sound through a large number of decaying - * echoes. It creates the perception that sound is occurring in a - * physical space. The p5.Reverb has paramters for Time (how long does the - * reverb last) and decayRate (how much the sound decays with each echo) - * that can be set with the .set() or .process() methods. The p5.Convolver - * extends p5.Reverb allowing you to recreate the sound of actual physical - * spaces through convolution. - * - * @class p5.Reverb - * @constructor - * @example - *
- * var soundFile, reverb; - * function preload() { - * soundFile = loadSound('assets/Damscray_DancingTiger.mp3'); - * } - * - * function setup() { - * reverb = new p5.Reverb(); - * soundFile.disconnect(); // so we'll only hear reverb... - * - * // connect soundFile to reverb, process w/ - * // 3 second reverbTime, decayRate of 2% - * reverb.process(soundFile, 3, 2); - * soundFile.play(); - * } - *
- */ - p5.Reverb = function () { - this.ac = p5sound.audiocontext; - this.convolverNode = this.ac.createConvolver(); - this.input = this.ac.createGain(); - this.output = this.ac.createGain(); - // otherwise, Safari distorts - this.input.gain.value = 0.5; - this.input.connect(this.convolverNode); - this.convolverNode.connect(this.output); - // default params - this._seconds = 3; - this._decay = 2; - this._reverse = false; - this._buildImpulse(); - this.connect(); - p5sound.soundArray.push(this); - }; - /** - * Connect a source to the reverb, and assign reverb parameters. - * - * @method process - * @param {Object} src p5.sound / Web Audio object with a sound - * output. - * @param {Number} [seconds] Duration of the reverb, in seconds. - * Min: 0, Max: 10. Defaults to 3. - * @param {Number} [decayRate] Percentage of decay with each echo. - * Min: 0, Max: 100. Defaults to 2. - * @param {Boolean} [reverse] Play the reverb backwards or forwards. - */ - p5.Reverb.prototype.process = function (src, seconds, decayRate, reverse) { - src.connect(this.input); - var rebuild = false; - if (seconds) { - this._seconds = seconds; - rebuild = true; - } - if (decayRate) { - this._decay = decayRate; - } - if (reverse) { - this._reverse = reverse; - } - if (rebuild) { - this._buildImpulse(); - } - }; - /** - * Set the reverb settings. Similar to .process(), but without - * assigning a new input. - * - * @method set - * @param {Number} [seconds] Duration of the reverb, in seconds. - * Min: 0, Max: 10. Defaults to 3. - * @param {Number} [decayRate] Percentage of decay with each echo. - * Min: 0, Max: 100. Defaults to 2. - * @param {Boolean} [reverse] Play the reverb backwards or forwards. - */ - p5.Reverb.prototype.set = function (seconds, decayRate, reverse) { - var rebuild = false; - if (seconds) { - this._seconds = seconds; - rebuild = true; - } - if (decayRate) { - this._decay = decayRate; - } - if (reverse) { - this._reverse = reverse; - } - if (rebuild) { - this._buildImpulse(); - } - }; - /** - * Set the output level of the delay effect. - * - * @method amp - * @param {Number} volume amplitude between 0 and 1.0 - * @param {Number} [rampTime] create a fade that lasts rampTime - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - */ - p5.Reverb.prototype.amp = function (vol, rampTime, tFromNow) { - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var now = p5sound.audiocontext.currentTime; - var currentVol = this.output.gain.value; - this.output.gain.cancelScheduledValues(now); - this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow + 0.001); - this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime + 0.001); - }; - /** - * Send output to a p5.sound or web audio object - * - * @method connect - * @param {Object} unit - */ - p5.Reverb.prototype.connect = function (unit) { - var u = unit || p5.soundOut.input; - this.output.connect(u.input ? u.input : u); - }; - /** - * Disconnect all output. - * - * @method disconnect - */ - p5.Reverb.prototype.disconnect = function () { - this.output.disconnect(); - }; - /** - * Inspired by Simple Reverb by Jordan Santell - * https://github.com/web-audio-components/simple-reverb/blob/master/index.js - * - * Utility function for building an impulse response - * based on the module parameters. - * - * @private - */ - p5.Reverb.prototype._buildImpulse = function () { - var rate = this.ac.sampleRate; - var length = rate * this._seconds; - var decay = this._decay; - var impulse = this.ac.createBuffer(2, length, rate); - var impulseL = impulse.getChannelData(0); - var impulseR = impulse.getChannelData(1); - var n, i; - for (i = 0; i < length; i++) { - n = this.reverse ? length - i : i; - impulseL[i] = (Math.random() * 2 - 1) * Math.pow(1 - n / length, decay); - impulseR[i] = (Math.random() * 2 - 1) * Math.pow(1 - n / length, decay); - } - this.convolverNode.buffer = impulse; - }; - p5.Reverb.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - if (this.convolverNode) { - this.convolverNode.buffer = null; - this.convolverNode = null; - } - if (typeof this.output !== 'undefined') { - this.output.disconnect(); - this.output = null; - } - if (typeof this.panner !== 'undefined') { - this.panner.disconnect(); - this.panner = null; - } - }; - // ======================================================================= - // *** p5.Convolver *** - // ======================================================================= - /** - *

p5.Convolver extends p5.Reverb. It can emulate the sound of real - * physical spaces through a process called - * convolution.

- * - *

Convolution multiplies any audio input by an "impulse response" - * to simulate the dispersion of sound over time. The impulse response is - * generated from an audio file that you provide. One way to - * generate an impulse response is to pop a balloon in a reverberant space - * and record the echo. Convolution can also be used to experiment with - * sound.

- * - *

Use the method createConvolution(path) to instantiate a - * p5.Convolver with a path to your impulse response audio file.

- * - * @class p5.Convolver - * @constructor - * @param {String} path path to a sound file - * @param {Function} [callback] function to call when loading succeeds - * @param {Function} [errorCallback] function to call if loading fails. - * This function will receive an error or - * XMLHttpRequest object with information - * about what went wrong. - * @example - *
- * var cVerb, sound; - * function preload() { - * // We have both MP3 and OGG versions of all sound assets - * soundFormats('ogg', 'mp3'); - * - * // Try replacing 'bx-spring' with other soundfiles like - * // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox' - * cVerb = createConvolver('assets/bx-spring.mp3'); - * - * // Try replacing 'Damscray_DancingTiger' with - * // 'beat', 'doorbell', lucky_dragons_-_power_melody' - * sound = loadSound('assets/Damscray_DancingTiger.mp3'); - * } - * - * function setup() { - * // disconnect from master output... - * sound.disconnect(); - * - * // ...and process with cVerb - * // so that we only hear the convolution - * cVerb.process(sound); - * - * sound.play(); - * } - *
- */ - p5.Convolver = function (path, callback, errorCallback) { - this.ac = p5sound.audiocontext; - /** - * Internally, the p5.Convolver uses the a - * - * Web Audio Convolver Node. - * - * @property convolverNode - * @type {Object} Web Audio Convolver Node - */ - this.convolverNode = this.ac.createConvolver(); - this.input = this.ac.createGain(); - this.output = this.ac.createGain(); - // otherwise, Safari distorts - this.input.gain.value = 0.5; - this.input.connect(this.convolverNode); - this.convolverNode.connect(this.output); - if (path) { - this.impulses = []; - this._loadBuffer(path, callback, errorCallback); - } else { - // parameters - this._seconds = 3; - this._decay = 2; - this._reverse = false; - this._buildImpulse(); - } - this.connect(); - p5sound.soundArray.push(this); - }; - p5.Convolver.prototype = Object.create(p5.Reverb.prototype); - p5.prototype.registerPreloadMethod('createConvolver', p5.prototype); - /** - * Create a p5.Convolver. Accepts a path to a soundfile - * that will be used to generate an impulse response. - * - * @method createConvolver - * @param {String} path path to a sound file - * @param {Function} [callback] function to call if loading is successful. - * The object will be passed in as the argument - * to the callback function. - * @param {Function} [errorCallback] function to call if loading is not successful. - * A custom error will be passed in as the argument - * to the callback function. - * @return {p5.Convolver} - * @example - *
- * var cVerb, sound; - * function preload() { - * // We have both MP3 and OGG versions of all sound assets - * soundFormats('ogg', 'mp3'); - * - * // Try replacing 'bx-spring' with other soundfiles like - * // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox' - * cVerb = createConvolver('assets/bx-spring.mp3'); - * - * // Try replacing 'Damscray_DancingTiger' with - * // 'beat', 'doorbell', lucky_dragons_-_power_melody' - * sound = loadSound('assets/Damscray_DancingTiger.mp3'); - * } - * - * function setup() { - * // disconnect from master output... - * sound.disconnect(); - * - * // ...and process with cVerb - * // so that we only hear the convolution - * cVerb.process(sound); - * - * sound.play(); - * } - *
- */ - p5.prototype.createConvolver = function (path, callback, errorCallback) { - // if loading locally without a server - if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { - alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); - } - var cReverb = new p5.Convolver(path, callback, errorCallback); - cReverb.impulses = []; - return cReverb; - }; - /** - * Private method to load a buffer as an Impulse Response, - * assign it to the convolverNode, and add to the Array of .impulses. - * - * @param {String} path - * @param {Function} callback - * @param {Function} errorCallback - * @private - */ - p5.Convolver.prototype._loadBuffer = function (path, callback, errorCallback) { - var path = p5.prototype._checkFileFormats(path); - var self = this; - var errorTrace = new Error().stack; - var ac = p5.prototype.getAudioContext(); - var request = new XMLHttpRequest(); - request.open('GET', path, true); - request.responseType = 'arraybuffer'; - request.onload = function () { - if (request.status == 200) { - // on success loading file: - ac.decodeAudioData(request.response, function (buff) { - var buffer = {}; - var chunks = path.split('/'); - buffer.name = chunks[chunks.length - 1]; - buffer.audioBuffer = buff; - self.impulses.push(buffer); - self.convolverNode.buffer = buffer.audioBuffer; - if (callback) { - callback(buffer); - } - }, // error decoding buffer. "e" is undefined in Chrome 11/22/2015 - function (e) { - var err = new CustomError('decodeAudioData', errorTrace, self.url); - var msg = 'AudioContext error at decodeAudioData for ' + self.url; - if (errorCallback) { - err.msg = msg; - errorCallback(err); - } else { - console.error(msg + '\n The error stack trace includes: \n' + err.stack); - } - }); - } else { - var err = new CustomError('loadConvolver', errorTrace, self.url); - var msg = 'Unable to load ' + self.url + '. The request status was: ' + request.status + ' (' + request.statusText + ')'; - if (errorCallback) { - err.message = msg; - errorCallback(err); - } else { - console.error(msg + '\n The error stack trace includes: \n' + err.stack); - } - } - }; - // if there is another error, aside from 404... - request.onerror = function (e) { - var err = new CustomError('loadConvolver', errorTrace, self.url); - var msg = 'There was no response from the server at ' + self.url + '. Check the url and internet connectivity.'; - if (errorCallback) { - err.message = msg; - errorCallback(err); - } else { - console.error(msg + '\n The error stack trace includes: \n' + err.stack); - } - }; - request.send(); - }; - p5.Convolver.prototype.set = null; - /** - * Connect a source to the reverb, and assign reverb parameters. - * - * @method process - * @param {Object} src p5.sound / Web Audio object with a sound - * output. - * @example - *
- * var cVerb, sound; - * function preload() { - * soundFormats('ogg', 'mp3'); - * - * cVerb = createConvolver('assets/concrete-tunnel.mp3'); - * - * sound = loadSound('assets/beat.mp3'); - * } - * - * function setup() { - * // disconnect from master output... - * sound.disconnect(); - * - * // ...and process with (i.e. connect to) cVerb - * // so that we only hear the convolution - * cVerb.process(sound); - * - * sound.play(); - * } - *
- */ - p5.Convolver.prototype.process = function (src) { - src.connect(this.input); - }; - /** - * If you load multiple impulse files using the .addImpulse method, - * they will be stored as Objects in this Array. Toggle between them - * with the toggleImpulse(id) method. - * - * @property impulses - * @type {Array} Array of Web Audio Buffers - */ - p5.Convolver.prototype.impulses = []; - /** - * Load and assign a new Impulse Response to the p5.Convolver. - * The impulse is added to the .impulses array. Previous - * impulses can be accessed with the .toggleImpulse(id) - * method. - * - * @method addImpulse - * @param {String} path path to a sound file - * @param {Function} callback function (optional) - * @param {Function} errorCallback function (optional) - */ - p5.Convolver.prototype.addImpulse = function (path, callback, errorCallback) { - // if loading locally without a server - if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { - alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); - } - this._loadBuffer(path, callback, errorCallback); - }; - /** - * Similar to .addImpulse, except that the .impulses - * Array is reset to save memory. A new .impulses - * array is created with this impulse as the only item. - * - * @method resetImpulse - * @param {String} path path to a sound file - * @param {Function} callback function (optional) - * @param {Function} errorCallback function (optional) - */ - p5.Convolver.prototype.resetImpulse = function (path, callback, errorCallback) { - // if loading locally without a server - if (window.location.origin.indexOf('file://') > -1 && window.cordova === 'undefined') { - alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); - } - this.impulses = []; - this._loadBuffer(path, callback, errorCallback); - }; - /** - * If you have used .addImpulse() to add multiple impulses - * to a p5.Convolver, then you can use this method to toggle between - * the items in the .impulses Array. Accepts a parameter - * to identify which impulse you wish to use, identified either by its - * original filename (String) or by its position in the .impulses - * Array (Number).
- * You can access the objects in the .impulses Array directly. Each - * Object has two attributes: an .audioBuffer (type: - * Web Audio - * AudioBuffer) and a .name, a String that corresponds - * with the original filename. - * - * @method toggleImpulse - * @param {String|Number} id Identify the impulse by its original filename - * (String), or by its position in the - * .impulses Array (Number). - */ - p5.Convolver.prototype.toggleImpulse = function (id) { - if (typeof id === 'number' && id < this.impulses.length) { - this.convolverNode.buffer = this.impulses[id].audioBuffer; - } - if (typeof id === 'string') { - for (var i = 0; i < this.impulses.length; i++) { - if (this.impulses[i].name === id) { - this.convolverNode.buffer = this.impulses[i].audioBuffer; - break; - } - } - } - }; - p5.Convolver.prototype.dispose = function () { - // remove all the Impulse Response buffers - for (var i in this.impulses) { - this.impulses[i] = null; - } - this.convolverNode.disconnect(); - this.concolverNode = null; - if (typeof this.output !== 'undefined') { - this.output.disconnect(); - this.output = null; - } - if (typeof this.panner !== 'undefined') { - this.panner.disconnect(); - this.panner = null; - } - }; -}(master, errorHandler, sndcore); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_core_TimelineState; -Tone_core_TimelineState = function (Tone) { - 'use strict'; - Tone.TimelineState = function (initial) { - Tone.Timeline.call(this); - this._initial = initial; - }; - Tone.extend(Tone.TimelineState, Tone.Timeline); - Tone.TimelineState.prototype.getStateAtTime = function (time) { - var event = this.getEvent(time); - if (event !== null) { - return event.state; - } else { - return this._initial; - } - }; - Tone.TimelineState.prototype.setStateAtTime = function (state, time) { - this.addEvent({ - 'state': state, - 'time': this.toSeconds(time) - }); - }; - return Tone.TimelineState; -}(Tone_core_Tone, Tone_core_Timeline); -/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ -var Tone_core_Clock; -Tone_core_Clock = function (Tone) { - 'use strict'; - Tone.Clock = function () { - var options = this.optionsObject(arguments, [ - 'callback', - 'frequency' - ], Tone.Clock.defaults); - this.callback = options.callback; - this._lookAhead = 'auto'; - this._computedLookAhead = 1 / 60; - this._threshold = 0.5; - this._nextTick = -1; - this._lastUpdate = 0; - this._loopID = -1; - this.frequency = new Tone.TimelineSignal(options.frequency, Tone.Type.Frequency); - this.ticks = 0; - this._state = new Tone.TimelineState(Tone.State.Stopped); - this._boundLoop = this._loop.bind(this); - this._readOnly('frequency'); - this._loop(); - }; - Tone.extend(Tone.Clock); - Tone.Clock.defaults = { - 'callback': Tone.noOp, - 'frequency': 1, - 'lookAhead': 'auto' - }; - Object.defineProperty(Tone.Clock.prototype, 'state', { - get: function () { - return this._state.getStateAtTime(this.now()); - } - }); - Object.defineProperty(Tone.Clock.prototype, 'lookAhead', { - get: function () { - return this._lookAhead; - }, - set: function (val) { - if (val === 'auto') { - this._lookAhead = 'auto'; - } else { - this._lookAhead = this.toSeconds(val); - } - } - }); - Tone.Clock.prototype.start = function (time, offset) { - time = this.toSeconds(time); - if (this._state.getStateAtTime(time) !== Tone.State.Started) { - this._state.addEvent({ - 'state': Tone.State.Started, - 'time': time, - 'offset': offset - }); - } - return this; - }; - Tone.Clock.prototype.stop = function (time) { - time = this.toSeconds(time); - if (this._state.getStateAtTime(time) !== Tone.State.Stopped) { - this._state.setStateAtTime(Tone.State.Stopped, time); - } - return this; - }; - Tone.Clock.prototype.pause = function (time) { - time = this.toSeconds(time); - if (this._state.getStateAtTime(time) === Tone.State.Started) { - this._state.setStateAtTime(Tone.State.Paused, time); - } - return this; - }; - Tone.Clock.prototype._loop = function (time) { - this._loopID = requestAnimationFrame(this._boundLoop); - if (this._lookAhead === 'auto') { - if (!this.isUndef(time)) { - var diff = (time - this._lastUpdate) / 1000; - this._lastUpdate = time; - if (diff < this._threshold) { - this._computedLookAhead = (9 * this._computedLookAhead + diff) / 10; - } - } - } else { - this._computedLookAhead = this._lookAhead; - } - var now = this.now(); - var lookAhead = this._computedLookAhead * 2; - var event = this._state.getEvent(now + lookAhead); - var state = Tone.State.Stopped; - if (event) { - state = event.state; - if (this._nextTick === -1 && state === Tone.State.Started) { - this._nextTick = event.time; - if (!this.isUndef(event.offset)) { - this.ticks = event.offset; - } - } - } - if (state === Tone.State.Started) { - while (now + lookAhead > this._nextTick) { - if (now > this._nextTick + this._threshold) { - this._nextTick = now; - } - var tickTime = this._nextTick; - this._nextTick += 1 / this.frequency.getValueAtTime(this._nextTick); - this.callback(tickTime); - this.ticks++; - } - } else if (state === Tone.State.Stopped) { - this._nextTick = -1; - this.ticks = 0; - } - }; - Tone.Clock.prototype.getStateAtTime = function (time) { - return this._state.getStateAtTime(time); - }; - Tone.Clock.prototype.dispose = function () { - cancelAnimationFrame(this._loopID); - Tone.TimelineState.prototype.dispose.call(this); - this._writable('frequency'); - this.frequency.dispose(); - this.frequency = null; - this._boundLoop = Tone.noOp; - this._nextTick = Infinity; - this.callback = null; - this._state.dispose(); - this._state = null; - }; - return Tone.Clock; -}(Tone_core_Tone, Tone_signal_TimelineSignal); -var metro; -metro = function () { - 'use strict'; - var p5sound = master; - // requires the Tone.js library's Clock (MIT license, Yotam Mann) - // https://github.com/TONEnoTONE/Tone.js/ - var Clock = Tone_core_Clock; - var ac = p5sound.audiocontext; - // var upTick = false; - p5.Metro = function () { - this.clock = new Clock({ 'callback': this.ontick.bind(this) }); - this.syncedParts = []; - this.bpm = 120; - // gets overridden by p5.Part - this._init(); - this.tickCallback = function () { - }; - }; - var prevTick = 0; - var tatumTime = 0; - p5.Metro.prototype.ontick = function (tickTime) { - var elapsedTime = tickTime - prevTick; - var secondsFromNow = tickTime - p5sound.audiocontext.currentTime; - if (elapsedTime - tatumTime <= -0.02) { - return; - } else { - prevTick = tickTime; - // for all of the active things on the metro: - for (var i in this.syncedParts) { - var thisPart = this.syncedParts[i]; - if (!thisPart.isPlaying) - return; - thisPart.incrementStep(secondsFromNow); - // each synced source keeps track of its own beat number - for (var j in thisPart.phrases) { - var thisPhrase = thisPart.phrases[j]; - var phraseArray = thisPhrase.sequence; - var bNum = this.metroTicks % phraseArray.length; - if (phraseArray[bNum] !== 0 && (this.metroTicks < phraseArray.length || !thisPhrase.looping)) { - thisPhrase.callback(secondsFromNow, phraseArray[bNum]); - } - } - } - this.metroTicks += 1; - this.tickCallback(secondsFromNow); - } - }; - p5.Metro.prototype.setBPM = function (bpm, rampTime) { - var beatTime = 60 / (bpm * this.tatums); - var now = p5sound.audiocontext.currentTime; - tatumTime = beatTime; - var rampTime = rampTime || 0; - this.clock.frequency.setValueAtTime(this.clock.frequency.value, now); - this.clock.frequency.linearRampToValueAtTime(bpm, now + rampTime); - this.bpm = bpm; - }; - p5.Metro.prototype.getBPM = function (tempo) { - return this.clock.getRate() / this.tatums * 60; - }; - p5.Metro.prototype._init = function () { - this.metroTicks = 0; - }; - // clear existing synced parts, add only this one - p5.Metro.prototype.resetSync = function (part) { - this.syncedParts = [part]; - }; - // push a new synced part to the array - p5.Metro.prototype.pushSync = function (part) { - this.syncedParts.push(part); - }; - p5.Metro.prototype.start = function (timeFromNow) { - var t = timeFromNow || 0; - var now = p5sound.audiocontext.currentTime; - this.clock.start(now + t); - this.setBPM(this.bpm); - }; - p5.Metro.prototype.stop = function (timeFromNow) { - var t = timeFromNow || 0; - var now = p5sound.audiocontext.currentTime; - if (this.clock._oscillator) { - this.clock.stop(now + t); - } - }; - p5.Metro.prototype.beatLength = function (tatums) { - this.tatums = 1 / tatums / 4; - }; -}(master, Tone_core_Clock); -var looper; -looper = function () { - 'use strict'; - var p5sound = master; - var bpm = 120; - /** - * Set the global tempo, in beats per minute, for all - * p5.Parts. This method will impact all active p5.Parts. - * - * @param {Number} BPM Beats Per Minute - * @param {Number} rampTime Seconds from now - */ - p5.prototype.setBPM = function (BPM, rampTime) { - bpm = BPM; - for (var i in p5sound.parts) { - p5sound.parts[i].setBPM(bpm, rampTime); - } - }; - /** - *

A phrase is a pattern of musical events over time, i.e. - * a series of notes and rests.

- * - *

Phrases must be added to a p5.Part for playback, and - * each part can play multiple phrases at the same time. - * For example, one Phrase might be a kick drum, another - * could be a snare, and another could be the bassline.

- * - *

The first parameter is a name so that the phrase can be - * modified or deleted later. The callback is a a function that - * this phrase will call at every step—for example it might be - * called playNote(value){}. The array determines - * which value is passed into the callback at each step of the - * phrase. It can be numbers, an object with multiple numbers, - * or a zero (0) indicates a rest so the callback won't be called).

- * - * @class p5.Phrase - * @constructor - * @param {String} name Name so that you can access the Phrase. - * @param {Function} callback The name of a function that this phrase - * will call. Typically it will play a sound, - * and accept two parameters: a time at which - * to play the sound (in seconds from now), - * and a value from the sequence array. The - * time should be passed into the play() or - * start() method to ensure precision. - * @param {Array} sequence Array of values to pass into the callback - * at each step of the phrase. - * @example - *
- * var mySound, myPhrase, myPart; - * var pattern = [1,0,0,2,0,2,0,0]; - * var msg = 'click to play'; - * - * function preload() { - * mySound = loadSound('assets/beatbox.mp3'); - * } - * - * function setup() { - * noStroke(); - * fill(255); - * textAlign(CENTER); - * masterVolume(0.1); - * - * myPhrase = new p5.Phrase('bbox', makeSound, pattern); - * myPart = new p5.Part(); - * myPart.addPhrase(myPhrase); - * myPart.setBPM(60); - * } - * - * function draw() { - * background(0); - * text(msg, width/2, height/2); - * } - * - * function makeSound(time, playbackRate) { - * mySound.rate(playbackRate); - * mySound.play(time); - * } - * - * function mouseClicked() { - * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { - * myPart.start(); - * msg = 'playing pattern'; - * } - * } - * - *
- */ - p5.Phrase = function (name, callback, sequence) { - this.phraseStep = 0; - this.name = name; - this.callback = callback; - /** - * Array of values to pass into the callback - * at each step of the phrase. Depending on the callback - * function's requirements, these values may be numbers, - * strings, or an object with multiple parameters. - * Zero (0) indicates a rest. - * - * @property sequence - * @type {Array} - */ - this.sequence = sequence; - }; - /** - *

A p5.Part plays back one or more p5.Phrases. Instantiate a part - * with steps and tatums. By default, each step represents 1/16th note.

- * - *

See p5.Phrase for more about musical timing.

- * - * @class p5.Part - * @constructor - * @param {Number} [steps] Steps in the part - * @param {Number} [tatums] Divisions of a beat (default is 1/16, a quarter note) - * @example - *
- * var box, drum, myPart; - * var boxPat = [1,0,0,2,0,2,0,0]; - * var drumPat = [0,1,1,0,2,0,1,0]; - * var msg = 'click to play'; - * - * function preload() { - * box = loadSound('assets/beatbox.mp3'); - * drum = loadSound('assets/drum.mp3'); - * } - * - * function setup() { - * noStroke(); - * fill(255); - * textAlign(CENTER); - * masterVolume(0.1); - * - * var boxPhrase = new p5.Phrase('box', playBox, boxPat); - * var drumPhrase = new p5.Phrase('drum', playDrum, drumPat); - * myPart = new p5.Part(); - * myPart.addPhrase(boxPhrase); - * myPart.addPhrase(drumPhrase); - * myPart.setBPM(60); - * masterVolume(0.1); - * } - * - * function draw() { - * background(0); - * text(msg, width/2, height/2); - * } - * - * function playBox(time, playbackRate) { - * box.rate(playbackRate); - * box.play(time); - * } - * - * function playDrum(time, playbackRate) { - * drum.rate(playbackRate); - * drum.play(time); - * } - * - * function mouseClicked() { - * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { - * myPart.start(); - * msg = 'playing part'; - * } - * } - *
- */ - p5.Part = function (steps, bLength) { - this.length = steps || 0; - // how many beats - this.partStep = 0; - this.phrases = []; - this.isPlaying = false; - this.noLoop(); - this.tatums = bLength || 0.0625; - // defaults to quarter note - this.metro = new p5.Metro(); - this.metro._init(); - this.metro.beatLength(this.tatums); - this.metro.setBPM(bpm); - p5sound.parts.push(this); - this.callback = function () { - }; - }; - /** - * Set the tempo of this part, in Beats Per Minute. - * - * @method setBPM - * @param {Number} BPM Beats Per Minute - * @param {Number} [rampTime] Seconds from now - */ - p5.Part.prototype.setBPM = function (tempo, rampTime) { - this.metro.setBPM(tempo, rampTime); - }; - /** - * Returns the Beats Per Minute of this currently part. - * - * @method getBPM - * @return {Number} - */ - p5.Part.prototype.getBPM = function () { - return this.metro.getBPM(); - }; - /** - * Start playback of this part. It will play - * through all of its phrases at a speed - * determined by setBPM. - * - * @method start - * @param {Number} [time] seconds from now - */ - p5.Part.prototype.start = function (time) { - if (!this.isPlaying) { - this.isPlaying = true; - this.metro.resetSync(this); - var t = time || 0; - this.metro.start(t); - } - }; - /** - * Loop playback of this part. It will begin - * looping through all of its phrases at a speed - * determined by setBPM. - * - * @method loop - * @param {Number} [time] seconds from now - */ - p5.Part.prototype.loop = function (time) { - this.looping = true; - // rest onended function - this.onended = function () { - this.partStep = 0; - }; - var t = time || 0; - this.start(t); - }; - /** - * Tell the part to stop looping. - * - * @method noLoop - */ - p5.Part.prototype.noLoop = function () { - this.looping = false; - // rest onended function - this.onended = function () { - this.stop(); - }; - }; - /** - * Stop the part and cue it to step 0. - * - * @method stop - * @param {Number} [time] seconds from now - */ - p5.Part.prototype.stop = function (time) { - this.partStep = 0; - this.pause(time); - }; - /** - * Pause the part. Playback will resume - * from the current step. - * - * @method pause - * @param {Number} time seconds from now - */ - p5.Part.prototype.pause = function (time) { - this.isPlaying = false; - var t = time || 0; - this.metro.stop(t); - }; - /** - * Add a p5.Phrase to this Part. - * - * @method addPhrase - * @param {p5.Phrase} phrase reference to a p5.Phrase - */ - p5.Part.prototype.addPhrase = function (name, callback, array) { - var p; - if (arguments.length === 3) { - p = new p5.Phrase(name, callback, array); - } else if (arguments[0] instanceof p5.Phrase) { - p = arguments[0]; - } else { - throw 'invalid input. addPhrase accepts name, callback, array or a p5.Phrase'; - } - this.phrases.push(p); - // reset the length if phrase is longer than part's existing length - if (p.sequence.length > this.length) { - this.length = p.sequence.length; - } - }; - /** - * Remove a phrase from this part, based on the name it was - * given when it was created. - * - * @method removePhrase - * @param {String} phraseName - */ - p5.Part.prototype.removePhrase = function (name) { - for (var i in this.phrases) { - if (this.phrases[i].name === name) { - this.phrases.splice(i, 1); - } - } - }; - /** - * Get a phrase from this part, based on the name it was - * given when it was created. Now you can modify its array. - * - * @method getPhrase - * @param {String} phraseName - */ - p5.Part.prototype.getPhrase = function (name) { - for (var i in this.phrases) { - if (this.phrases[i].name === name) { - return this.phrases[i]; - } - } - }; - /** - * Get a phrase from this part, based on the name it was - * given when it was created. Now you can modify its array. - * - * @method replaceSequence - * @param {String} phraseName - * @param {Array} sequence Array of values to pass into the callback - * at each step of the phrase. - */ - p5.Part.prototype.replaceSequence = function (name, array) { - for (var i in this.phrases) { - if (this.phrases[i].name === name) { - this.phrases[i].sequence = array; - } - } - }; - p5.Part.prototype.incrementStep = function (time) { - if (this.partStep < this.length - 1) { - this.callback(time); - this.partStep += 1; - } else { - if (!this.looping && this.partStep == this.length - 1) { - console.log('done'); - // this.callback(time); - this.onended(); - } - } - }; - /** - * Fire a callback function at every step. - * - * @method onStep - * @param {Function} callback The name of the callback - * you want to fire - * on every beat/tatum. - */ - p5.Part.prototype.onStep = function (callback) { - this.callback = callback; - }; - // =============== - // p5.Score - // =============== - /** - * A Score consists of a series of Parts. The parts will - * be played back in order. For example, you could have an - * A part, a B part, and a C part, and play them back in this order - * new p5.Score(a, a, b, a, c) - * - * @class p5.Score - * @constructor - * @param {p5.Part} part(s) One or multiple parts, to be played in sequence. - * @return {p5.Score} - */ - p5.Score = function () { - // for all of the arguments - this.parts = []; - this.currentPart = 0; - var thisScore = this; - for (var i in arguments) { - this.parts[i] = arguments[i]; - this.parts[i].nextPart = this.parts[i + 1]; - this.parts[i].onended = function () { - thisScore.resetPart(i); - playNextPart(thisScore); - }; - } - this.looping = false; - }; - p5.Score.prototype.onended = function () { - if (this.looping) { - // this.resetParts(); - this.parts[0].start(); - } else { - this.parts[this.parts.length - 1].onended = function () { - this.stop(); - this.resetParts(); - }; - } - this.currentPart = 0; - }; - /** - * Start playback of the score. - * - * @method start - */ - p5.Score.prototype.start = function () { - this.parts[this.currentPart].start(); - this.scoreStep = 0; - }; - /** - * Stop playback of the score. - * - * @method stop - */ - p5.Score.prototype.stop = function () { - this.parts[this.currentPart].stop(); - this.currentPart = 0; - this.scoreStep = 0; - }; - /** - * Pause playback of the score. - * - * @method pause - */ - p5.Score.prototype.pause = function () { - this.parts[this.currentPart].stop(); - }; - /** - * Loop playback of the score. - * - * @method loop - */ - p5.Score.prototype.loop = function () { - this.looping = true; - this.start(); - }; - /** - * Stop looping playback of the score. If it - * is currently playing, this will go into effect - * after the current round of playback completes. - * - * @method noLoop - */ - p5.Score.prototype.noLoop = function () { - this.looping = false; - }; - p5.Score.prototype.resetParts = function () { - for (var i in this.parts) { - this.resetPart(i); - } - }; - p5.Score.prototype.resetPart = function (i) { - this.parts[i].stop(); - this.parts[i].partStep = 0; - for (var p in this.parts[i].phrases) { - this.parts[i].phrases[p].phraseStep = 0; - } - }; - /** - * Set the tempo for all parts in the score - * - * @param {Number} BPM Beats Per Minute - * @param {Number} rampTime Seconds from now - */ - p5.Score.prototype.setBPM = function (bpm, rampTime) { - for (var i in this.parts) { - this.parts[i].setBPM(bpm, rampTime); - } - }; - function playNextPart(aScore) { - aScore.currentPart++; - if (aScore.currentPart >= aScore.parts.length) { - aScore.scoreStep = 0; - aScore.onended(); - } else { - aScore.scoreStep = 0; - aScore.parts[aScore.currentPart - 1].stop(); - aScore.parts[aScore.currentPart].start(); - } - } -}(master); -var soundRecorder; -soundRecorder = function () { - 'use strict'; - var p5sound = master; - var ac = p5sound.audiocontext; - /** - *

Record sounds for playback and/or to save as a .wav file. - * The p5.SoundRecorder records all sound output from your sketch, - * or can be assigned a specific source with setInput().

- *

The record() method accepts a p5.SoundFile as a parameter. - * When playback is stopped (either after the given amount of time, - * or with the stop() method), the p5.SoundRecorder will send its - * recording to that p5.SoundFile for playback.

- * - * @class p5.SoundRecorder - * @constructor - * @example - *
- * var mic, recorder, soundFile; - * var state = 0; - * - * function setup() { - * background(200); - * // create an audio in - * mic = new p5.AudioIn(); - * - * // prompts user to enable their browser mic - * mic.start(); - * - * // create a sound recorder - * recorder = new p5.SoundRecorder(); - * - * // connect the mic to the recorder - * recorder.setInput(mic); - * - * // this sound file will be used to - * // playback & save the recording - * soundFile = new p5.SoundFile(); - * - * text('keyPress to record', 20, 20); - * } - * - * function keyPressed() { - * // make sure user enabled the mic - * if (state === 0 && mic.enabled) { - * - * // record to our p5.SoundFile - * recorder.record(soundFile); - * - * background(255,0,0); - * text('Recording!', 20, 20); - * state++; - * } - * else if (state === 1) { - * background(0,255,0); - * - * // stop recorder and - * // send result to soundFile - * recorder.stop(); - * - * text('Stopped', 20, 20); - * state++; - * } - * - * else if (state === 2) { - * soundFile.play(); // play the result! - * save(soundFile, 'mySound.wav'); - * state++; - * } - * } - *
- */ - p5.SoundRecorder = function () { - this.input = ac.createGain(); - this.output = ac.createGain(); - this.recording = false; - this.bufferSize = 1024; - this._channels = 2; - // stereo (default) - this._clear(); - // initialize variables - this._jsNode = ac.createScriptProcessor(this.bufferSize, this._channels, 2); - this._jsNode.onaudioprocess = this._audioprocess.bind(this); - /** - * callback invoked when the recording is over - * @private - * @type {function(Float32Array)} - */ - this._callback = function () { - }; - // connections - this._jsNode.connect(p5.soundOut._silentNode); - this.setInput(); - // add this p5.SoundFile to the soundArray - p5sound.soundArray.push(this); - }; - /** - * Connect a specific device to the p5.SoundRecorder. - * If no parameter is given, p5.SoundRecorer will record - * all audible p5.sound from your sketch. - * - * @method setInput - * @param {Object} [unit] p5.sound object or a web audio unit - * that outputs sound - */ - p5.SoundRecorder.prototype.setInput = function (unit) { - this.input.disconnect(); - this.input = null; - this.input = ac.createGain(); - this.input.connect(this._jsNode); - this.input.connect(this.output); - if (unit) { - unit.connect(this.input); - } else { - p5.soundOut.output.connect(this.input); - } - }; - /** - * Start recording. To access the recording, provide - * a p5.SoundFile as the first parameter. The p5.SoundRecorder - * will send its recording to that p5.SoundFile for playback once - * recording is complete. Optional parameters include duration - * (in seconds) of the recording, and a callback function that - * will be called once the complete recording has been - * transfered to the p5.SoundFile. - * - * @method record - * @param {p5.SoundFile} soundFile p5.SoundFile - * @param {Number} [duration] Time (in seconds) - * @param {Function} [callback] The name of a function that will be - * called once the recording completes - */ - p5.SoundRecorder.prototype.record = function (sFile, duration, callback) { - this.recording = true; - if (duration) { - this.sampleLimit = Math.round(duration * ac.sampleRate); - } - if (sFile && callback) { - this._callback = function () { - this.buffer = this._getBuffer(); - sFile.setBuffer(this.buffer); - callback(); - }; - } else if (sFile) { - this._callback = function () { - this.buffer = this._getBuffer(); - sFile.setBuffer(this.buffer); - }; - } - }; - /** - * Stop the recording. Once the recording is stopped, - * the results will be sent to the p5.SoundFile that - * was given on .record(), and if a callback function - * was provided on record, that function will be called. - * - * @method stop - */ - p5.SoundRecorder.prototype.stop = function () { - this.recording = false; - this._callback(); - this._clear(); - }; - p5.SoundRecorder.prototype._clear = function () { - this._leftBuffers = []; - this._rightBuffers = []; - this.recordedSamples = 0; - this.sampleLimit = null; - }; - /** - * internal method called on audio process - * - * @private - * @param {AudioProcessorEvent} event - */ - p5.SoundRecorder.prototype._audioprocess = function (event) { - if (this.recording === false) { - return; - } else if (this.recording === true) { - // if we are past the duration, then stop... else: - if (this.sampleLimit && this.recordedSamples >= this.sampleLimit) { - this.stop(); - } else { - // get channel data - var left = event.inputBuffer.getChannelData(0); - var right = event.inputBuffer.getChannelData(1); - // clone the samples - this._leftBuffers.push(new Float32Array(left)); - this._rightBuffers.push(new Float32Array(right)); - this.recordedSamples += this.bufferSize; - } - } - }; - p5.SoundRecorder.prototype._getBuffer = function () { - var buffers = []; - buffers.push(this._mergeBuffers(this._leftBuffers)); - buffers.push(this._mergeBuffers(this._rightBuffers)); - return buffers; - }; - p5.SoundRecorder.prototype._mergeBuffers = function (channelBuffer) { - var result = new Float32Array(this.recordedSamples); - var offset = 0; - var lng = channelBuffer.length; - for (var i = 0; i < lng; i++) { - var buffer = channelBuffer[i]; - result.set(buffer, offset); - offset += buffer.length; - } - return result; - }; - p5.SoundRecorder.prototype.dispose = function () { - this._clear(); - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this._callback = function () { - }; - if (this.input) { - this.input.disconnect(); - } - this.input = null; - this._jsNode = null; - }; - /** - * Save a p5.SoundFile as a .wav audio file. - * - * @method saveSound - * @param {p5.SoundFile} soundFile p5.SoundFile that you wish to save - * @param {String} name name of the resulting .wav file. - */ - p5.prototype.saveSound = function (soundFile, name) { - var leftChannel, rightChannel; - leftChannel = soundFile.buffer.getChannelData(0); - // handle mono files - if (soundFile.buffer.numberOfChannels > 1) { - rightChannel = soundFile.buffer.getChannelData(1); - } else { - rightChannel = leftChannel; - } - var interleaved = interleave(leftChannel, rightChannel); - // create the buffer and view to create the .WAV file - var buffer = new ArrayBuffer(44 + interleaved.length * 2); - var view = new DataView(buffer); - // write the WAV container, - // check spec at: https://ccrma.stanford.edu/courses/422/projects/WaveFormat/ - // RIFF chunk descriptor - writeUTFBytes(view, 0, 'RIFF'); - view.setUint32(4, 36 + interleaved.length * 2, true); - writeUTFBytes(view, 8, 'WAVE'); - // FMT sub-chunk - writeUTFBytes(view, 12, 'fmt '); - view.setUint32(16, 16, true); - view.setUint16(20, 1, true); - // stereo (2 channels) - view.setUint16(22, 2, true); - view.setUint32(24, 44100, true); - view.setUint32(28, 44100 * 4, true); - view.setUint16(32, 4, true); - view.setUint16(34, 16, true); - // data sub-chunk - writeUTFBytes(view, 36, 'data'); - view.setUint32(40, interleaved.length * 2, true); - // write the PCM samples - var lng = interleaved.length; - var index = 44; - var volume = 1; - for (var i = 0; i < lng; i++) { - view.setInt16(index, interleaved[i] * (32767 * volume), true); - index += 2; - } - p5.prototype.writeFile([view], name, 'wav'); - }; - // helper methods to save waves - function interleave(leftChannel, rightChannel) { - var length = leftChannel.length + rightChannel.length; - var result = new Float32Array(length); - var inputIndex = 0; - for (var index = 0; index < length;) { - result[index++] = leftChannel[inputIndex]; - result[index++] = rightChannel[inputIndex]; - inputIndex++; - } - return result; - } - function writeUTFBytes(view, offset, string) { - var lng = string.length; - for (var i = 0; i < lng; i++) { - view.setUint8(offset + i, string.charCodeAt(i)); - } - } -}(sndcore, master); -var peakdetect; -peakdetect = function () { - 'use strict'; - var p5sound = master; - /** - *

PeakDetect works in conjunction with p5.FFT to - * look for onsets in some or all of the frequency spectrum. - *

- *

- * To use p5.PeakDetect, call update in the draw loop - * and pass in a p5.FFT object. - *

- *

- * You can listen for a specific part of the frequency spectrum by - * setting the range between freq1 and freq2. - *

- * - *

threshold is the threshold for detecting a peak, - * scaled between 0 and 1. It is logarithmic, so 0.1 is half as loud - * as 1.0.

- * - *

- * The update method is meant to be run in the draw loop, and - * frames determines how many loops must pass before - * another peak can be detected. - * For example, if the frameRate() = 60, you could detect the beat of a - * 120 beat-per-minute song with this equation: - * framesPerPeak = 60 / (estimatedBPM / 60 ); - *

- * - *

- * Based on example contribtued by @b2renger, and a simple beat detection - * explanation by Felix Turner. - *

- * - * @class p5.PeakDetect - * @constructor - * @param {Number} [freq1] lowFrequency - defaults to 20Hz - * @param {Number} [freq2] highFrequency - defaults to 20000 Hz - * @param {Number} [threshold] Threshold for detecting a beat between 0 and 1 - * scaled logarithmically where 0.1 is 1/2 the loudness - * of 1.0. Defaults to 0.35. - * @param {Number} [framesPerPeak] Defaults to 20. - * @example - *
- * - * var cnv, soundFile, fft, peakDetect; - * var ellipseWidth = 10; - * - * function setup() { - * background(0); - * noStroke(); - * fill(255); - * textAlign(CENTER); - * - * soundFile = loadSound('assets/beat.mp3'); - * - * // p5.PeakDetect requires a p5.FFT - * fft = new p5.FFT(); - * peakDetect = new p5.PeakDetect(); - * - * } - * - * function draw() { - * background(0); - * text('click to play/pause', width/2, height/2); - * - * // peakDetect accepts an fft post-analysis - * fft.analyze(); - * peakDetect.update(fft); - * - * if ( peakDetect.isDetected ) { - * ellipseWidth = 50; - * } else { - * ellipseWidth *= 0.95; - * } - * - * ellipse(width/2, height/2, ellipseWidth, ellipseWidth); - * } - * - * // toggle play/stop when canvas is clicked - * function mouseClicked() { - * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { - * if (soundFile.isPlaying() ) { - * soundFile.stop(); - * } else { - * soundFile.play(); - * } - * } - * } - *
- */ - p5.PeakDetect = function (freq1, freq2, threshold, _framesPerPeak) { - var framesPerPeak; - // framesPerPeak determines how often to look for a beat. - // If a beat is provided, try to look for a beat based on bpm - this.framesPerPeak = _framesPerPeak || 20; - this.framesSinceLastPeak = 0; - this.decayRate = 0.95; - this.threshold = threshold || 0.35; - this.cutoff = 0; - // how much to increase the cutoff - // TO DO: document this / figure out how to make it accessible - this.cutoffMult = 1.5; - this.energy = 0; - this.penergy = 0; - // TO DO: document this property / figure out how to make it accessible - this.currentValue = 0; - /** - * isDetected is set to true when a peak is detected. - * - * @attribute isDetected - * @type {Boolean} - * @default false - */ - this.isDetected = false; - this.f1 = freq1 || 40; - this.f2 = freq2 || 20000; - // function to call when a peak is detected - this._onPeak = function () { - }; - }; - /** - * The update method is run in the draw loop. - * - * Accepts an FFT object. You must call .analyze() - * on the FFT object prior to updating the peakDetect - * because it relies on a completed FFT analysis. - * - * @method update - * @param {p5.FFT} fftObject A p5.FFT object - */ - p5.PeakDetect.prototype.update = function (fftObject) { - var nrg = this.energy = fftObject.getEnergy(this.f1, this.f2) / 255; - if (nrg > this.cutoff && nrg > this.threshold && nrg - this.penergy > 0) { - // trigger callback - this._onPeak(); - this.isDetected = true; - // debounce - this.cutoff = nrg * this.cutoffMult; - this.framesSinceLastPeak = 0; - } else { - this.isDetected = false; - if (this.framesSinceLastPeak <= this.framesPerPeak) { - this.framesSinceLastPeak++; - } else { - this.cutoff *= this.decayRate; - this.cutoff = Math.max(this.cutoff, this.threshold); - } - } - this.currentValue = nrg; - this.penergy = nrg; - }; - /** - * onPeak accepts two arguments: a function to call when - * a peak is detected. The value of the peak, - * between 0.0 and 1.0, is passed to the callback. - * - * @method onPeak - * @param {Function} callback Name of a function that will - * be called when a peak is - * detected. - * @param {Object} [val] Optional value to pass - * into the function when - * a peak is detected. - * @example - *
- * var cnv, soundFile, fft, peakDetect; - * var ellipseWidth = 0; - * - * function setup() { - * cnv = createCanvas(100,100); - * textAlign(CENTER); - * - * soundFile = loadSound('assets/beat.mp3'); - * fft = new p5.FFT(); - * peakDetect = new p5.PeakDetect(); - * - * setupSound(); - * - * // when a beat is detected, call triggerBeat() - * peakDetect.onPeak(triggerBeat); - * } - * - * function draw() { - * background(0); - * fill(255); - * text('click to play', width/2, height/2); - * - * fft.analyze(); - * peakDetect.update(fft); - * - * ellipseWidth *= 0.95; - * ellipse(width/2, height/2, ellipseWidth, ellipseWidth); - * } - * - * // this function is called by peakDetect.onPeak - * function triggerBeat() { - * ellipseWidth = 50; - * } - * - * // mouseclick starts/stops sound - * function setupSound() { - * cnv.mouseClicked( function() { - * if (soundFile.isPlaying() ) { - * soundFile.stop(); - * } else { - * soundFile.play(); - * } - * }); - * } - *
- */ - p5.PeakDetect.prototype.onPeak = function (callback, val) { - var self = this; - self._onPeak = function () { - callback(self.energy, val); - }; - }; -}(master); -var gain; -gain = function () { - 'use strict'; - var p5sound = master; - /** - * A gain node is usefull to set the relative volume of sound. - * It's typically used to build mixers. - * - * @class p5.Gain - * @constructor - * @example - *
- * - * // load two soundfile and crossfade beetween them - * var sound1,sound2; - * var gain1, gain2, gain3; - * - * function preload(){ - * soundFormats('ogg', 'mp3'); - * sound1 = loadSound('../_files/Damscray_-_Dancing_Tiger_01'); - * sound2 = loadSound('../_files/beat.mp3'); - * } - * - * function setup() { - * createCanvas(400,200); - * - * // create a 'master' gain to which we will connect both soundfiles - * gain3 = new p5.Gain(); - * gain3.connect(); - * - * // setup first sound for playing - * sound1.rate(1); - * sound1.loop(); - * sound1.disconnect(); // diconnect from p5 output - * - * gain1 = new p5.Gain(); // setup a gain node - * gain1.setInput(sound1); // connect the first sound to its input - * gain1.connect(gain3); // connect its output to the 'master' - * - * sound2.rate(1); - * sound2.disconnect(); - * sound2.loop(); - * - * gain2 = new p5.Gain(); - * gain2.setInput(sound2); - * gain2.connect(gain3); - * - * } - * - * function draw(){ - * background(180); - * - * // calculate the horizontal distance beetween the mouse and the right of the screen - * var d = dist(mouseX,0,width,0); - * - * // map the horizontal position of the mouse to values useable for volume control of sound1 - * var vol1 = map(mouseX,0,width,0,1); - * var vol2 = 1-vol1; // when sound1 is loud, sound2 is quiet and vice versa - * - * gain1.amp(vol1,0.5,0); - * gain2.amp(vol2,0.5,0); - * - * // map the vertical position of the mouse to values useable for 'master volume control' - * var vol3 = map(mouseY,0,height,0,1); - * gain3.amp(vol3,0.5,0); - * } - *
- * - */ - p5.Gain = function () { - this.ac = p5sound.audiocontext; - this.input = this.ac.createGain(); - this.output = this.ac.createGain(); - // otherwise, Safari distorts - this.input.gain.value = 0.5; - this.input.connect(this.output); - // add to the soundArray - p5sound.soundArray.push(this); - }; - /** - * Connect a source to the gain node. - * - * @method setInput - * @param {Object} src p5.sound / Web Audio object with a sound - * output. - */ - p5.Gain.prototype.setInput = function (src) { - src.connect(this.input); - }; - /** - * Send output to a p5.sound or web audio object - * - * @method connect - * @param {Object} unit - */ - p5.Gain.prototype.connect = function (unit) { - var u = unit || p5.soundOut.input; - this.output.connect(u.input ? u.input : u); - }; - /** - * Disconnect all output. - * - * @method disconnect - */ - p5.Gain.prototype.disconnect = function () { - this.output.disconnect(); - }; - /** - * Set the output level of the gain node. - * - * @method amp - * @param {Number} volume amplitude between 0 and 1.0 - * @param {Number} [rampTime] create a fade that lasts rampTime - * @param {Number} [timeFromNow] schedule this event to happen - * seconds from now - */ - p5.Gain.prototype.amp = function (vol, rampTime, tFromNow) { - var rampTime = rampTime || 0; - var tFromNow = tFromNow || 0; - var now = p5sound.audiocontext.currentTime; - var currentVol = this.output.gain.value; - this.output.gain.cancelScheduledValues(now); - this.output.gain.linearRampToValueAtTime(currentVol, now + tFromNow); - this.output.gain.linearRampToValueAtTime(vol, now + tFromNow + rampTime); - }; - p5.Gain.prototype.dispose = function () { - // remove reference from soundArray - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.output.disconnect(); - this.input.disconnect(); - this.output = undefined; - this.input = undefined; - }; -}(master, sndcore); -var distortion; -distortion = function () { - 'use strict'; - var p5sound = master; - /* - * Adapted from [Kevin Ennis on StackOverflow](http://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion) - */ - function makeDistortionCurve(amount) { - var k = typeof amount === 'number' ? amount : 50; - var n_samples = 44100; - var curve = new Float32Array(n_samples); - var deg = Math.PI / 180; - var i = 0; - var x; - for (; i < n_samples; ++i) { - x = i * 2 / n_samples - 1; - curve[i] = (3 + k) * x * 20 * deg / (Math.PI + k * Math.abs(x)); - } - return curve; - } - /** - * A Distortion effect created with a Waveshaper Node, - * with an approach adapted from - * [Kevin Ennis](http://stackoverflow.com/questions/22312841/waveshaper-node-in-webaudio-how-to-emulate-distortion) - * - * @class p5.Distortion - * @constructor - * @param {Number} [amount=0.25] Unbounded distortion amount. - * Normal values range from 0-1. - * @param {String} [oversample='none'] 'none', '2x', or '4x'. - * - * @return {Object} Distortion object - */ - p5.Distortion = function (amount, oversample) { - if (typeof amount === 'undefined') { - amount = 0.25; - } - if (typeof amount !== 'number') { - throw new Error('amount must be a number'); - } - if (typeof oversample === 'undefined') { - oversample = '2x'; - } - if (typeof oversample !== 'string') { - throw new Error('oversample must be a String'); - } - var curveAmount = p5.prototype.map(amount, 0, 1, 0, 2000); - this.ac = p5sound.audiocontext; - this.input = this.ac.createGain(); - this.output = this.ac.createGain(); - /** - * The p5.Distortion is built with a - * - * Web Audio WaveShaper Node. - * - * @property WaveShaperNode - * @type {Object} AudioNode - */ - this.waveShaperNode = this.ac.createWaveShaper(); - this.amount = curveAmount; - this.waveShaperNode.curve = makeDistortionCurve(curveAmount); - this.waveShaperNode.oversample = oversample; - this.input.connect(this.waveShaperNode); - this.waveShaperNode.connect(this.output); - this.connect(); - // add to the soundArray - p5sound.soundArray.push(this); - }; - p5.Distortion.prototype.process = function (src, amount, oversample) { - src.connect(this.input); - this.set(amount, oversample); - }; - /** - * Set the amount and oversample of the waveshaper distortion. - * - * @method setType - * @param {Number} [amount=0.25] Unbounded distortion amount. - * Normal values range from 0-1. - * @param {String} [oversample='none'] 'none', '2x', or '4x'. - */ - p5.Distortion.prototype.set = function (amount, oversample) { - if (amount) { - var curveAmount = p5.prototype.map(amount, 0, 1, 0, 2000); - this.amount = curveAmount; - this.waveShaperNode.curve = makeDistortionCurve(curveAmount); - } - if (oversample) { - this.waveShaperNode.oversample = oversample; - } - }; - /** - * Return the distortion amount, typically between 0-1. - * - * @method getAmount - * @return {Number} Unbounded distortion amount. - * Normal values range from 0-1. - */ - p5.Distortion.prototype.getAmount = function () { - return this.amount; - }; - /** - * Return the oversampling. - * - * @return {String} Oversample can either be 'none', '2x', or '4x'. - */ - p5.Distortion.prototype.getOversample = function () { - return this.waveShaperNode.oversample; - }; - /** - * Send output to a p5.sound or web audio object - * - * @method connect - * @param {Object} unit - */ - p5.Distortion.prototype.connect = function (unit) { - var u = unit || p5.soundOut.input; - this.output.connect(u); - }; - /** - * Disconnect all output. - * - * @method disconnect - */ - p5.Distortion.prototype.disconnect = function () { - this.output.disconnect(); - }; - p5.Distortion.prototype.dispose = function () { - var index = p5sound.soundArray.indexOf(this); - p5sound.soundArray.splice(index, 1); - this.input.disconnect(); - this.waveShaperNode.disconnect(); - this.input = null; - this.waveShaperNode = null; - if (typeof this.output !== 'undefined') { - this.output.disconnect(); - this.output = null; - } - }; -}(master); -var src_app; -src_app = function () { - 'use strict'; - var p5SOUND = sndcore; - return p5SOUND; -}(sndcore, master, helpers, errorHandler, panner, soundfile, amplitude, fft, signal, oscillator, env, pulse, noise, audioin, filter, delay, reverb, metro, looper, soundRecorder, peakdetect, gain, distortion); -})); diff --git a/examples/neuroevolution-flappybird-2/bird.js b/examples/neuroevolution-flappybird-2/bird.js deleted file mode 100644 index bac989b..0000000 --- a/examples/neuroevolution-flappybird-2/bird.js +++ /dev/null @@ -1,103 +0,0 @@ -// Daniel Shiffman -// http://codingtra.in -// http://patreon.com/codingtrain -// Code for: https://youtu.be/cXgA1d_E-jY - -// Class is exported (eslint flag) -/* exported Bird */ - -class Bird { - constructor(brain) { - this.y = height / 2; - this.x = 64; - - this.gravity = 0.6; - this.lift = -7; - this.velocity = 0; - - this.icon = birdSprite; - this.width = 36; - this.height = 36; - - - // Is this a copy of another Bird or a new one? - // The Neural Network is the bird's "brain" - if (brain instanceof NeuralNetwork) { - this.brain = brain.copy(); - this.brain.mutate(0.1); - } else { - this.brain = new NeuralNetwork(4, 16, 2); - } - - // Score is how many frames it's been alive - this.score = 0; - // Fitness is normalized version of score - this.fitness = 0; - } - - // Create a copy of this bird - copy() { - return new Bird(this.brain); - } - - // This is the key function now that decides - // if it should jump or not jump! - think(pipes) { - // First find the closest pipe - var closest = null; - var record = Infinity; - for (var i = 0; i < pipes.length; i++) { - var diff = pipes[i].x - this.x; - if (diff > 0 && diff < record) { - record = diff; - closest = pipes[i]; - } - } - - if (closest != null) { - // Now create the inputs to the neural network - var inputs = []; - // x position of closest pipe - inputs[0] = map(closest.x, this.x, width, -1, 1); - // top of closest pipe opening - inputs[1] = map(closest.top, 0, height, -1, 1); - // bottom of closest pipe opening - inputs[2] = map(closest.bottom, 0, height, -1, 1); - // bird's y position - inputs[3] = map(this.y, 0, height, -1, 1); - // Get the outputs from the network - var action = this.brain.predict(inputs); - // Decide to jump or not! - if (action[1] > action[0]) { - this.up(); - } - } - } - - show() { - // draw the icon CENTERED around the X and Y coords of the bird object - image(this.icon, this.x - this.width / 2, this.y - this.height / 2, this.width, this.height); - } - - up() { - this.velocity = this.lift; - } - - update() { - this.velocity += this.gravity; - this.y += this.velocity; - - if (this.y >= height - this.height / 2) { - this.y = height - this.height / 2; - this.velocity = 0; - } - - if (this.y <= this.height / 2) { - this.y = this.height / 2; - this.velocity = 0; - } - - // Every frame it is alive increases the score - this.score++; - } -} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-2/ga.js b/examples/neuroevolution-flappybird-2/ga.js deleted file mode 100644 index 6d143ba..0000000 --- a/examples/neuroevolution-flappybird-2/ga.js +++ /dev/null @@ -1,81 +0,0 @@ -// Daniel Shiffman - -// This flappy bird implementation is adapted from: -// https://youtu.be/cXgA1d_E-jY& - -// This file includes functions for creating a new generation -// of birds. - -// Start the game over -function resetGame() { - counter = 0; - pipes = []; -} - -// Create the next generation -function nextGeneration() { - resetGame(); - // Normalize the fitness values 0-1 - normalizeFitness(allBirds); - // Generate a new set of birds - activeBirds = generate(allBirds); - // Copy those birds to another array - allBirds = activeBirds.slice(); -} - -// Generate a new population of birds -function generate(oldBirds) { - var newBirds = []; - for (var i = 0; i < oldBirds.length; i++) { - // Select a bird based on fitness - var bird = poolSelection(oldBirds); - newBirds[i] = bird; - } - return newBirds; -} - -// Normalize the fitness of all birds -function normalizeFitness(birds) { - // Make score exponentially better? - for (var i = 0; i < birds.length; i++) { - birds[i].score = pow(birds[i].score, 2); - } - - // Add up all the scores - var sum = 0; - for (var i = 0; i < birds.length; i++) { - sum += birds[i].score; - } - // Divide by the sum - for (var i = 0; i < birds.length; i++) { - birds[i].fitness = birds[i].score / sum; - } - console.log(birds); -} - - -// An algorithm for picking one bird from an array -// based on fitness -function poolSelection(birds) { - // Start at 0 - var index = 0; - - // Pick a random number between 0 and 1 - var r = random(1); - - // Keep subtracting probabilities until you get less than zero - // Higher probabilities will be more likely to be fixed since they will - // subtract a larger number towards zero - while (r > 0) { - r -= birds[index].fitness; - // And move on to the next - index += 1; - } - - // Go back one - index -= 1; - - // Make sure it's a copy! - // (this includes mutation) - return birds[index].copy(); -} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-2/graphics/background.png b/examples/neuroevolution-flappybird-2/graphics/background.png deleted file mode 100644 index c856c95b18467169b55d7f879d27d6cd00d44797..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 235935 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�XU&5!JiVW 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 n`e*H#$>0j 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 oQ8D19WHRma{~6%zUjXbYuf+* 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 diff --git a/examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow_fix.png b/examples/neuroevolution-flappybird-2/graphics/pipe_marshmallow_fix.png deleted file mode 100644 index 0e0296eaa8e062b17ddfc1318839ddbe6c31051f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 20787 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 this.bottom) { - //if this.w is huge, then we need different collision model - if (bird.x + bird.width / 2 > this.x && bird.x - bird.width / 2 < this.x + this.w) { - this.highlight = true; - this.passed = true; - return true; - } - } - this.highlight = false; - return false; - } - - // this function is used to calculate scores and checks if we've went through the pipes - // pass(bird) { - // if (bird.x > this.x && !this.passed) { - // this.passed = true; - // return true; - // } - // return false; - // } - - drawHalf() { - let howManyNedeed = 0; - let peakRatio = pipePeakSprite.height / pipePeakSprite.width; - let bodyRatio = pipeBodySprite.height / pipeBodySprite.width; - //this way we calculate, how many tubes we can fit without stretching - howManyNedeed = Math.round(height / (this.w * bodyRatio)); - //this <= and start from 1 is just my HACK xD But it's working - for (let i = 0; i < howManyNedeed; ++i) { - let offset = this.w * (i * bodyRatio + peakRatio); - image(pipeBodySprite, -this.w / 2, offset, this.w, this.w * bodyRatio); - } - image(pipePeakSprite, -this.w / 2, 0, this.w, this.w * peakRatio); - } - - show() { - push(); - translate(this.x + this.w / 2, this.bottom); - this.drawHalf(); - translate(0, -this.spacing); - rotate(PI); - this.drawHalf(); - pop(); - } - - update() { - this.x -= this.speed; - } - - offscreen() { - return (this.x < -this.w); - } -} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-2/sketch.js b/examples/neuroevolution-flappybird-2/sketch.js deleted file mode 100644 index 2ccb33a..0000000 --- a/examples/neuroevolution-flappybird-2/sketch.js +++ /dev/null @@ -1,238 +0,0 @@ -// Daniel Shiffman -// http://codingtra.in -// http://patreon.com/codingtrain -// Code for: https://youtu.be/cXgA1d_E-jY - - -// GA additions -// How big is the population -let totalPopulation = 250; -// All active birds (not yet collided with pipe) -let activeBirds = []; -// All birds for any given population -let allBirds = []; -// Pipes -let pipes = []; -// A frame counter to determine when to add a pipe -let counter = 0; - -// Interface elements -let speedSlider; -let speedSpan; -let highScoreSpan; -let allTimeHighScoreSpan; - -// All time high score -let highScore = 0; - -// Training or just showing the current best -let runBest = false; -let runBestButton; - -//// Game stuff - -// let bird; -// let pipes; -let parallax = 0.8; -let score = 0; -let maxScore = 0; -let birdSprite; -let pipeBodySprite; -let pipePeakSprite; -let bgImg; -let bgX = 0; -let gameoverFrame = 0; -let isOver = false; -let pipeSpeed = 2; - -let touched = false; -let prevTouched = touched; - - -function preload() { - pipeBodySprite = loadImage('graphics/pipe_marshmallow_fix.png'); - pipePeakSprite = loadImage('graphics/pipe_marshmallow_fix.png'); - birdSprite = loadImage('graphics/train.png'); - bgImg = loadImage('graphics/background.png'); -} - -function setup() { - - let canvas = createCanvas(600, 400); - canvas.parent('canvascontainer'); - - // Access the interface elements - speedSlider = select('#speedSlider'); - speedSpan = select('#speed'); - highScoreSpan = select('#hs'); - allTimeHighScoreSpan = select('#ahs'); - runBestButton = select('#best'); - runBestButton.mousePressed(toggleState); - - // Create a population - for (let i = 0; i < totalPopulation; i++) { - let bird = new Bird(); - activeBirds[i] = bird; - allBirds[i] = bird; - } - - -} - -// Toggle the state of the simulation -function toggleState() { - runBest = !runBest; - // Show the best bird - if (runBest) { - resetGame(); - bestBird.score = 0; - runBestButton.html('continue training'); - // Go train some more - } else { - nextGeneration(); - runBestButton.html('run best'); - } -} - - -function draw() { - // Should we speed up cycles per frame - let cycles = speedSlider.value(); - speedSpan.html(cycles); - - // How many times to advance the game - for (let n = 0; n < cycles; n++) { - //bgX -= pipes[0].speed * parallax; - bgX -= pipeSpeed * parallax; - - - // this handles the "infinite loop" by checking if the right - // edge of the image would be on the screen, if it is draw a - // second copy of the image right next to it - // once the second image gets to the 0 point, we can reset bgX to - // 0 and go back to drawing just one image. - if (bgX <= -bgImg.width + width) { - if (bgX <= -bgImg.width) { - bgX = 0; - } - } - - // Are we just running the best bird - if (runBest) { - bestBird.think(pipes); - bestBird.update(); - for (let j = 0; j < pipes.length; j++) { - // Start over, bird hit pipe - if (pipes[j].hits(bestBird)) { - resetGame(); - break; - } - } - // Or are we running all the active birds - } else { - for (let i = pipes.length - 1; i >= 0; i--) { - pipes[i].update(); - - if (pipes[i].offscreen()) { - pipes.splice(i, 1); - } - } - - for (let i = activeBirds.length - 1; i >= 0; i--) { - let bird = activeBirds[i]; - // Bird uses its brain! - bird.think(pipes); - bird.update(); - // Check all the pipes - for (let j = 0; j < pipes.length; j++) { - // if (pipes[j].pass(bird)) { - // bird.score++; - // } - // It's hit a pipe - if (pipes[j].hits(bird)) { - // Remove this bird - activeBirds.splice(i, 1); - break; - } - } - } - } - - - if (counter % 250 == 0) { - pipes.push(new Pipe()); - } - counter++; - - - // What is highest score of the current population - let tempHighScore = 0; - // If we're training - if (!runBest) { - // Which is the best bird? - let tempBestBird = null; - for (let i = 0; i < activeBirds.length; i++) { - let s = activeBirds[i].score; - if (s > tempHighScore) { - tempHighScore = s; - tempBestBird = activeBirds[i]; - } - } - - // Is it the all time high scorer? - if (tempHighScore > highScore) { - highScore = tempHighScore; - bestBird = tempBestBird; - } - } else { - // Just one bird, the best one so far - tempHighScore = bestBird.score; - if (tempHighScore > highScore) { - highScore = tempHighScore; - } - } - - // Update DOM Elements - highScoreSpan.html(tempHighScore); - allTimeHighScoreSpan.html(highScore); - - // Draw everything! - - background(0); - // Draw our background image, then move it at the same speed as the pipes - image(bgImg, bgX, 0, bgImg.width, height); - image(bgImg, bgX + bgImg.width, 0, bgImg.width, height); - - for (let i = 0; i < pipes.length; i++) { - pipes[i].show(); - } - - if (runBest) { - bestBird.show(); - } else { - for (let i = 0; i < activeBirds.length; i++) { - activeBirds[i].show(); - } - // If we're out of birds go to the next generation - if (activeBirds.length == 0) { - nextGeneration(); - } - } - - } - -} - - - - -// function keyPressed() { -// if (key === ' ') { -// bird.up(); -// if (isOver) reset(); //you can just call reset() in Machinelearning if you die, because you cant simulate keyPress with code. -// } -// } - -// function touchStarted() { -// if (isOver) reset(); -// } \ No newline at end of file diff --git a/examples/neuroevolution-flappybird/bird.js b/examples/neuroevolution-flappybird/bird.js new file mode 100644 index 0000000..2cccc5b --- /dev/null +++ b/examples/neuroevolution-flappybird/bird.js @@ -0,0 +1,114 @@ +// Daniel Shiffman +// Nature of Code: Intelligence and Learning +// https://github.com/shiffman/NOC-S17-2-Intelligence-Learning + +// This flappy bird implementation is adapted from: +// https://youtu.be/cXgA1d_E-jY& + +// Mutation function to be passed into bird.brain +function mutate(x) { + if (random(1) < 0.1) { + let offset = randomGaussian() * 0.5; + let newx = x + offset; + return newx; + } else { + return x; + } +} + +class Bird { + constructor(brain) { + // position and size of bird + this.x = 64; + this.y = height / 2; + this.r = 12; + + // Gravity, lift and velocity + this.gravity = 0.8; + this.lift = -12; + this.velocity = 0; + + // Is this a copy of another Bird or a new one? + // The Neural Network is the bird's "brain" + if (brain instanceof NeuralNetwork) { + this.brain = brain.copy(); + this.brain.mutate(mutate); + } else { + this.brain = new NeuralNetwork(5, 8, 2); + } + + // Score is how many frames it's been alive + this.score = 0; + // Fitness is normalized version of score + this.fitness = 0; + } + + // Create a copy of this bird + copy() { + return new Bird(this.brain); + } + + // Display the bird + show() { + fill(255, 100); + stroke(255); + ellipse(this.x, this.y, this.r * 2, this.r * 2); + } + + // This is the key function now that decides + // if it should jump or not jump! + think(pipes) { + // First find the closest pipe + let closest = null; + let record = Infinity; + for (let i = 0; i < pipes.length; i++) { + let diff = pipes[i].x - this.x; + if (diff > 0 && diff < record) { + record = diff; + closest = pipes[i]; + } + } + + if (closest != null) { + // Now create the inputs to the neural network + let inputs = []; + // x position of closest pipe + inputs[0] = map(closest.x, this.x, width, 0, 1); + // top of closest pipe opening + inputs[1] = map(closest.top, 0, height, 0, 1); + // bottom of closest pipe opening + inputs[2] = map(closest.bottom, 0, height, 0, 1); + // bird's y position + inputs[3] = map(this.y, 0, height, 0, 1); + // bird's y velocity + inputs[4] = map(this.velocity, -5, 5, 0, 1); + + // Get the outputs from the network + let action = this.brain.predict(inputs); + // Decide to jump or not! + if (action[1] > action[0]) { + this.up(); + } + } + } + + // Jump up + up() { + this.velocity += this.lift; + } + + bottomTop() { + // Bird dies when hits bottom? + return (this.y > height || this.y < 0); + } + + // Update bird's position based on velocity, gravity, etc. + update() { + this.velocity += this.gravity; + // this.velocity *= 0.9; + this.y += this.velocity; + + // Every frame it is alive increases the score + this.score++; + } +} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-1/ga.js b/examples/neuroevolution-flappybird/ga.js similarity index 81% rename from examples/neuroevolution-flappybird-1/ga.js rename to examples/neuroevolution-flappybird/ga.js index 8af440b..da9585a 100644 --- a/examples/neuroevolution-flappybird-1/ga.js +++ b/examples/neuroevolution-flappybird/ga.js @@ -12,6 +12,10 @@ // Start the game over function resetGame() { counter = 0; + // Resetting best bird score to 0 + if (bestBird) { + bestBird.score = 0; + } pipes = []; } @@ -28,10 +32,10 @@ function nextGeneration() { // Generate a new population of birds function generate(oldBirds) { - var newBirds = []; - for (var i = 0; i < oldBirds.length; i++) { + let newBirds = []; + for (let i = 0; i < oldBirds.length; i++) { // Select a bird based on fitness - var bird = poolSelection(oldBirds); + let bird = poolSelection(oldBirds); newBirds[i] = bird; } return newBirds; @@ -40,17 +44,17 @@ function generate(oldBirds) { // Normalize the fitness of all birds function normalizeFitness(birds) { // Make score exponentially better? - for (var i = 0; i < birds.length; i++) { + for (let i = 0; i < birds.length; i++) { birds[i].score = pow(birds[i].score, 2); } // Add up all the scores - var sum = 0; - for (var i = 0; i < birds.length; i++) { + let sum = 0; + for (let i = 0; i < birds.length; i++) { sum += birds[i].score; } // Divide by the sum - for (var i = 0; i < birds.length; i++) { + for (let i = 0; i < birds.length; i++) { birds[i].fitness = birds[i].score / sum; } } @@ -60,10 +64,10 @@ function normalizeFitness(birds) { // based on fitness function poolSelection(birds) { // Start at 0 - var index = 0; + let index = 0; // Pick a random number between 0 and 1 - var r = random(1); + let r = random(1); // Keep subtracting probabilities until you get less than zero // Higher probabilities will be more likely to be fixed since they will @@ -80,4 +84,4 @@ function poolSelection(birds) { // Make sure it's a copy! // (this includes mutation) return birds[index].copy(); -} +} \ No newline at end of file diff --git a/examples/neuroevolution-flappybird-2/index.html b/examples/neuroevolution-flappybird/index.html old mode 100644 new mode 100755 similarity index 98% rename from examples/neuroevolution-flappybird-2/index.html rename to examples/neuroevolution-flappybird/index.html index 7481ad5..e540f29 --- a/examples/neuroevolution-flappybird-2/index.html +++ b/examples/neuroevolution-flappybird/index.html @@ -1,4 +1,3 @@ - @@ -11,6 +10,7 @@ + @@ -23,6 +23,8 @@

+ + diff --git a/examples/neuroevolution-flappybird-1/pipe.js b/examples/neuroevolution-flappybird/pipe.js similarity index 59% rename from examples/neuroevolution-flappybird-1/pipe.js rename to examples/neuroevolution-flappybird/pipe.js index 1907eb1..7ee05d8 100644 --- a/examples/neuroevolution-flappybird-1/pipe.js +++ b/examples/neuroevolution-flappybird/pipe.js @@ -5,25 +5,27 @@ // This flappy bird implementation is adapted from: // https://youtu.be/cXgA1d_E-jY& -function Pipe() { - - // How big is the empty space - var spacing = random(80, height / 2); - // Where is th center of the empty space - var centery = random(spacing, height - spacing); - - // Top and bottom of pipe - this.top = centery - spacing / 2; - this.bottom = height - (centery + spacing / 2); - // Starts at the edge - this.x = width; - // Width of pipe - this.w = 50; - // How fast - this.speed = 4; +class Pipe { + constructor() { + + // How big is the empty space + let spacing = 125; + // Where is th center of the empty space + let centery = random(spacing, height - spacing); + + // Top and bottom of pipe + this.top = centery - spacing / 2; + this.bottom = height - (centery + spacing / 2); + // Starts at the edge + this.x = width; + // Width of pipe + this.w = 80; + // How fast + this.speed = 6; + } // Did this pipe hit a bird? - this.hits = function(bird) { + hits(bird) { if ((bird.y - bird.r) < this.top || (bird.y + bird.r) > (height - this.bottom)) { if (bird.x > this.x && bird.x < this.x + this.w) { return true; @@ -33,7 +35,7 @@ function Pipe() { } // Draw the pipe - this.show = function() { + show() { stroke(255); fill(200); rect(this.x, 0, this.w, this.top); @@ -41,12 +43,12 @@ function Pipe() { } // Update the pipe - this.update = function() { + update() { this.x -= this.speed; } // Has it moved offscreen? - this.offscreen = function() { + offscreen() { if (this.x < -this.w) { return true; } else { diff --git a/examples/neuroevolution-flappybird-1/sketch.js b/examples/neuroevolution-flappybird/sketch.js similarity index 72% rename from examples/neuroevolution-flappybird-1/sketch.js rename to examples/neuroevolution-flappybird/sketch.js index bff3fc0..58fe6f0 100644 --- a/examples/neuroevolution-flappybird-1/sketch.js +++ b/examples/neuroevolution-flappybird/sketch.js @@ -1,36 +1,36 @@ // Daniel Shiffman // Nature of Code: Intelligence and Learning -// https://github.com/shiffman/NOC-S17-2-Intelligence-Learning +// https://github.com/shiffman/NOC-S18 // This flappy bird implementation is adapted from: // https://youtu.be/cXgA1d_E-jY& // How big is the population -var totalPopulation = 250; +let totalPopulation = 500; // All active birds (not yet collided with pipe) -var activeBirds = []; +let activeBirds = []; // All birds for any given population -var allBirds = []; +let allBirds = []; // Pipes -var pipes = []; +let pipes = []; // A frame counter to determine when to add a pipe -var counter = 0; +let counter = 0; // Interface elements -var speedSlider; -var speedSpan; -var highScoreSpan; -var allTimeHighScoreSpan; +let speedSlider; +let speedSpan; +let highScoreSpan; +let allTimeHighScoreSpan; // All time high score -var highScore = 0; +let highScore = 0; // Training or just showing the current best -var runBest = false; -var runBestButton; +let runBest = false; +let runBestButton; function setup() { - var canvas = createCanvas(600, 400); + let canvas = createCanvas(600, 400); canvas.parent('canvascontainer'); // Access the interface elements @@ -42,8 +42,8 @@ function setup() { runBestButton.mousePressed(toggleState); // Create a population - for (var i = 0; i < totalPopulation; i++) { - var bird = new Bird(); + for (let i = 0; i < totalPopulation; i++) { + let bird = new Bird(); activeBirds[i] = bird; allBirds[i] = bird; } @@ -55,7 +55,6 @@ function toggleState() { // Show the best bird if (runBest) { resetGame(); - bestBird.score = 0; runBestButton.html('continue training'); // Go train some more } else { @@ -70,14 +69,14 @@ function draw() { background(0); // Should we speed up cycles per frame - var cycles = speedSlider.value(); + let cycles = speedSlider.value(); speedSpan.html(cycles); // How many times to advance the game - for (var n = 0; n < cycles; n++) { + for (let n = 0; n < cycles; n++) { // Show all the pipes - for (var i = pipes.length - 1; i >= 0; i--) { + for (let i = pipes.length - 1; i >= 0; i--) { pipes[i].update(); if (pipes[i].offscreen()) { pipes.splice(i, 1); @@ -87,22 +86,27 @@ function draw() { if (runBest) { bestBird.think(pipes); bestBird.update(); - for (var j = 0; j < pipes.length; j++) { + for (let j = 0; j < pipes.length; j++) { // Start over, bird hit pipe if (pipes[j].hits(bestBird)) { resetGame(); break; } } - // Or are we running all the active birds + + if (bestBird.bottomTop()) { + resetGame(); + } + // Or are we running all the active birds } else { - for (var i = activeBirds.length - 1; i >= 0; i--) { - var bird = activeBirds[i]; + for (let i = activeBirds.length - 1; i >= 0; i--) { + let bird = activeBirds[i]; // Bird uses its brain! bird.think(pipes); bird.update(); + // Check all the pipes - for (var j = 0; j < pipes.length; j++) { + for (let j = 0; j < pipes.length; j++) { // It's hit a pipe if (pipes[j].hits(activeBirds[i])) { // Remove this bird @@ -110,6 +114,11 @@ function draw() { break; } } + + if (bird.bottomTop()) { + activeBirds.splice(i, 1); + } + } } @@ -121,13 +130,13 @@ function draw() { } // What is highest score of the current population - var tempHighScore = 0; + let tempHighScore = 0; // If we're training if (!runBest) { // Which is the best bird? - var tempBestBird = null; - for (var i = 0; i < activeBirds.length; i++) { - var s = activeBirds[i].score; + let tempBestBird = null; + for (let i = 0; i < activeBirds.length; i++) { + let s = activeBirds[i].score; if (s > tempHighScore) { tempHighScore = s; tempBestBird = activeBirds[i]; @@ -152,14 +161,14 @@ function draw() { allTimeHighScoreSpan.html(highScore); // Draw everything! - for (var i = 0; i < pipes.length; i++) { + for (let i = 0; i < pipes.length; i++) { pipes[i].show(); } if (runBest) { bestBird.show(); } else { - for (var i = 0; i < activeBirds.length; i++) { + for (let i = 0; i < activeBirds.length; i++) { activeBirds[i].show(); } // If we're out of birds go to the next generation @@ -167,4 +176,4 @@ function draw() { nextGeneration(); } } -} +} \ No newline at end of file diff --git a/lib/nn.js b/lib/nn.js index db53b8c..3ba7edc 100644 --- a/lib/nn.js +++ b/lib/nn.js @@ -161,22 +161,12 @@ class NeuralNetwork { return new NeuralNetwork(this); } - mutate(rate) { - // This is how we adjust weights ever so slightly - function mutate(x) { - if (Math.random() < rate) { - var offset = randomGaussian() * 0.5; - // var offset = random(-0.1, 0.1); - var newx = x + offset; - return newx; - } else { - return x; - } - } - this.weights_ih.map(mutate); - this.weights_ho.map(mutate); - this.bias_h.map(mutate); - this.bias_o.map(mutate); + // Accept an arbitrary function for mutation + mutate(func) { + this.weights_ih.map(func); + this.weights_ho.map(func); + this.bias_h.map(func); + this.bias_o.map(func); } From 545cc15c9eeed30c46d3e874a1e4703cda2997a6 Mon Sep 17 00:00:00 2001 From: kim-marcel <35607481+kim-marcel@users.noreply.github.com> Date: Wed, 18 Apr 2018 00:36:54 +0100 Subject: [PATCH 13/29] added community contributions Added a section where the community can reference their own libraries they've built based on this one. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index a7a35d7..16786d8 100644 --- a/README.md +++ b/README.md @@ -67,6 +67,15 @@ The Tests can either be checked via the automaticly running CircleCI Tests or yo Please send PullRequests. These need to pass a automated Test first and after it will get reviewed and on that review either denied or accepted. +## Libraries built by the community + +Here are some libraries with the same or similar functionality to this one built by the community: + +- [Java Neural Network Library](https://github.com/kim-marcel/basic_neural_network) by [kim-marcel](https://github.com/kim-marcel) +- [Python Neural Network Library](https://github.com/Gabriel-Teston/Machine-Learning) by [Gabriel-Teston](https://github.com/Gabriel-Teston) + +Feel free to add your own libraries. + ## Versioning We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/CodingTrain/Toy-Neural-Network-JS/tags). From c961aaa140bb02219563d70e2f6fd3337562d129 Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Thu, 19 Apr 2018 08:44:49 -0400 Subject: [PATCH 14/29] New neuroevolution steering example This is a new example with a lot of great help from @meiamsome and more. Discussion in this live stream starting here: https://youtu.be/emjv5tr-m7Q?t=4898 --- examples/neuroevolution-steering/index.html | 27 ++ examples/neuroevolution-steering/nn/matrix.js | 138 ++++++++++ examples/neuroevolution-steering/nn/nn.js | 184 +++++++++++++ examples/neuroevolution-steering/sketch.js | 123 +++++++++ examples/neuroevolution-steering/vehicle.js | 241 ++++++++++++++++++ 5 files changed, 713 insertions(+) create mode 100755 examples/neuroevolution-steering/index.html create mode 100644 examples/neuroevolution-steering/nn/matrix.js create mode 100644 examples/neuroevolution-steering/nn/nn.js create mode 100644 examples/neuroevolution-steering/sketch.js create mode 100644 examples/neuroevolution-steering/vehicle.js diff --git a/examples/neuroevolution-steering/index.html b/examples/neuroevolution-steering/index.html new file mode 100755 index 0000000..b5e5249 --- /dev/null +++ b/examples/neuroevolution-steering/index.html @@ -0,0 +1,27 @@ + + + + + + + + + + + + + + +
+
+

+ speed: 1 +

+ +

+ debug: +

+
+ + + diff --git a/examples/neuroevolution-steering/nn/matrix.js b/examples/neuroevolution-steering/nn/matrix.js new file mode 100644 index 0000000..34b2d97 --- /dev/null +++ b/examples/neuroevolution-steering/nn/matrix.js @@ -0,0 +1,138 @@ +// let m = new Matrix(3,2); + + +class Matrix { + constructor(rows, cols) { + this.rows = rows; + this.cols = cols; + this.data = Array(this.rows).fill().map(() => Array(this.cols).fill(0)); + } + + copy() { + let m = new Matrix(this.rows, this.cols); + for (let i = 0; i < this.rows; i++) { + for (let j = 0; j < this.cols; j++) { + m.data[i][j] = this.data[i][j]; + } + } + return m; + } + + static fromArray(arr) { + return new Matrix(arr.length, 1).map((e, i) => arr[i]); + } + + static subtract(a, b) { + if (a.rows !== b.rows || a.cols !== b.cols) { + console.log('Columns and Rows of A must match Columns and Rows of B.'); + return; + } + + // Return a new Matrix a-b + return new Matrix(a.rows, a.cols) + .map((_, i, j) => a.data[i][j] - b.data[i][j]); + } + + toArray() { + let arr = []; + for (let i = 0; i < this.rows; i++) { + for (let j = 0; j < this.cols; j++) { + arr.push(this.data[i][j]); + } + } + return arr; + } + + randomize() { + return this.map(e => Math.random() * 2 - 1); + } + + add(n) { + if (n instanceof Matrix) { + if (this.rows !== n.rows || this.cols !== n.cols) { + console.log('Columns and Rows of A must match Columns and Rows of B.'); + return; + } + return this.map((e, i, j) => e + n.data[i][j]); + } else { + return this.map(e => e + n); + } + } + + static transpose(matrix) { + return new Matrix(matrix.cols, matrix.rows) + .map((_, i, j) => matrix.data[j][i]); + } + + static multiply(a, b) { + // Matrix product + if (a.cols !== b.rows) { + console.log('Columns of A must match rows of B.') + return; + } + + return new Matrix(a.rows, b.cols) + .map((e, i, j) => { + // Dot product of values in col + let sum = 0; + for (let k = 0; k < a.cols; k++) { + sum += a.data[i][k] * b.data[k][j]; + } + return sum; + }); + } + + multiply(n) { + if (n instanceof Matrix) { + if (this.rows !== n.rows || this.cols !== n.cols) { + console.log('Columns and Rows of A must match Columns and Rows of B.'); + return; + } + + // hadamard product + return this.map((e, i, j) => e * n.data[i][j]); + } else { + // Scalar product + return this.map(e => e * n); + } + } + + map(func) { + // Apply a function to every element of matrix + for (let i = 0; i < this.rows; i++) { + for (let j = 0; j < this.cols; j++) { + let val = this.data[i][j]; + this.data[i][j] = func(val, i, j); + } + } + return this; + } + + static map(matrix, func) { + // Apply a function to every element of matrix + return new Matrix(matrix.rows, matrix.cols) + .map((e, i, j) => func(matrix.data[i][j], i, j)); + } + + print() { + console.table(this.data); + return this; + } + + serialize() { + return JSON.stringify(this); + } + + static deserialize(data) { + if (typeof data == 'string') { + data = JSON.parse(data); + } + let matrix = new Matrix(data.rows, data.cols); + matrix.data = data.data; + return matrix; + } +} + +if (typeof module !== 'undefined') { + module.exports = Matrix; +} diff --git a/examples/neuroevolution-steering/nn/nn.js b/examples/neuroevolution-steering/nn/nn.js new file mode 100644 index 0000000..db53b8c --- /dev/null +++ b/examples/neuroevolution-steering/nn/nn.js @@ -0,0 +1,184 @@ +// Other techniques for learning + +class ActivationFunction { + constructor(func, dfunc) { + this.func = func; + this.dfunc = dfunc; + } +} + +let sigmoid = new ActivationFunction( + x => 1 / (1 + Math.exp(-x)), + y => y * (1 - y) +); + +let tanh = new ActivationFunction( + x => Math.tanh(x), + y => 1 - (y * y) +); + + +class NeuralNetwork { + // TODO: document what a, b, c are + constructor(a, b, c) { + if (a instanceof NeuralNetwork) { + this.input_nodes = a.input_nodes; + this.hidden_nodes = a.hidden_nodes; + this.output_nodes = a.output_nodes; + + this.weights_ih = a.weights_ih.copy(); + this.weights_ho = a.weights_ho.copy(); + + this.bias_h = a.bias_h.copy(); + this.bias_o = a.bias_o.copy(); + } else { + this.input_nodes = a; + this.hidden_nodes = b; + this.output_nodes = c; + + this.weights_ih = new Matrix(this.hidden_nodes, this.input_nodes); + this.weights_ho = new Matrix(this.output_nodes, this.hidden_nodes); + this.weights_ih.randomize(); + this.weights_ho.randomize(); + + this.bias_h = new Matrix(this.hidden_nodes, 1); + this.bias_o = new Matrix(this.output_nodes, 1); + this.bias_h.randomize(); + this.bias_o.randomize(); + } + + // TODO: copy these as well + this.setLearningRate(); + this.setActivationFunction(); + + + } + + predict(input_array) { + + // Generating the Hidden Outputs + let inputs = Matrix.fromArray(input_array); + let hidden = Matrix.multiply(this.weights_ih, inputs); + hidden.add(this.bias_h); + // activation function! + hidden.map(this.activation_function.func); + + // Generating the output's output! + let output = Matrix.multiply(this.weights_ho, hidden); + output.add(this.bias_o); + output.map(this.activation_function.func); + + // Sending back to the caller! + return output.toArray(); + } + + setLearningRate(learning_rate = 0.1) { + this.learning_rate = learning_rate; + } + + setActivationFunction(func = sigmoid) { + this.activation_function = func; + } + + train(input_array, target_array) { + // Generating the Hidden Outputs + let inputs = Matrix.fromArray(input_array); + let hidden = Matrix.multiply(this.weights_ih, inputs); + hidden.add(this.bias_h); + // activation function! + hidden.map(this.activation_function.func); + + // Generating the output's output! + let outputs = Matrix.multiply(this.weights_ho, hidden); + outputs.add(this.bias_o); + outputs.map(this.activation_function.func); + + // Convert array to matrix object + let targets = Matrix.fromArray(target_array); + + // Calculate the error + // ERROR = TARGETS - OUTPUTS + let output_errors = Matrix.subtract(targets, outputs); + + // let gradient = outputs * (1 - outputs); + // Calculate gradient + let gradients = Matrix.map(outputs, this.activation_function.dfunc); + gradients.multiply(output_errors); + gradients.multiply(this.learning_rate); + + + // Calculate deltas + let hidden_T = Matrix.transpose(hidden); + let weight_ho_deltas = Matrix.multiply(gradients, hidden_T); + + // Adjust the weights by deltas + this.weights_ho.add(weight_ho_deltas); + // Adjust the bias by its deltas (which is just the gradients) + this.bias_o.add(gradients); + + // Calculate the hidden layer errors + let who_t = Matrix.transpose(this.weights_ho); + let hidden_errors = Matrix.multiply(who_t, output_errors); + + // Calculate hidden gradient + let hidden_gradient = Matrix.map(hidden, this.activation_function.dfunc); + hidden_gradient.multiply(hidden_errors); + hidden_gradient.multiply(this.learning_rate); + + // Calcuate input->hidden deltas + let inputs_T = Matrix.transpose(inputs); + let weight_ih_deltas = Matrix.multiply(hidden_gradient, inputs_T); + + this.weights_ih.add(weight_ih_deltas); + // Adjust the bias by its deltas (which is just the gradients) + this.bias_h.add(hidden_gradient); + + // outputs.print(); + // targets.print(); + // error.print(); + } + + serialize() { + return JSON.stringify(this); + } + + static deserialize(data) { + if (typeof data == 'string') { + data = JSON.parse(data); + } + let nn = new NeuralNetwork(data.input_nodes, data.hidden_nodes, data.output_nodes); + nn.weights_ih = Matrix.deserialize(data.weights_ih); + nn.weights_ho = Matrix.deserialize(data.weights_ho); + nn.bias_h = Matrix.deserialize(data.bias_h); + nn.bias_o = Matrix.deserialize(data.bias_o); + nn.learning_rate = data.learning_rate; + return nn; + } + + + // Adding function for neuro-evolution + copy() { + return new NeuralNetwork(this); + } + + mutate(rate) { + // This is how we adjust weights ever so slightly + function mutate(x) { + if (Math.random() < rate) { + var offset = randomGaussian() * 0.5; + // var offset = random(-0.1, 0.1); + var newx = x + offset; + return newx; + } else { + return x; + } + } + this.weights_ih.map(mutate); + this.weights_ho.map(mutate); + this.bias_h.map(mutate); + this.bias_o.map(mutate); + } + + + +} \ No newline at end of file diff --git a/examples/neuroevolution-steering/sketch.js b/examples/neuroevolution-steering/sketch.js new file mode 100644 index 0000000..cb303dc --- /dev/null +++ b/examples/neuroevolution-steering/sketch.js @@ -0,0 +1,123 @@ +// Daniel Shiffman +// Nature of Code: Intelligence and Learning +// https://github.com/shiffman/NOC-S17-2-Intelligence-Learning + +// Evolutionary "Steering Behavior" Simulation + +// An array of vehicles +let population = []; + +// An array of "food" +let food = []; + +// Checkbox to show additional info +let debug; + +// Slider to speed up simulation +let speedSlider; +let speedSpan; + +// How big is the food? +let foodRadius = 8; +// How much food should there? +let foodAmount = 25; +// Don't put food near the edge +let foodBuffer = 50; + + +// How many sensors does each vehicle have? +let totalSensors = 8; +// How far can each vehicle see? +let sensorLength = 150; +// What's the angle in between sensors +let sensorAngle = (Math.PI * 2) / totalSensors; + +let best = null; + +function setup() { + + // Add canvas and grab checkbox and slider + let canvas = createCanvas(640, 360); + canvas.parent('canvascontainer'); + debug = select('#debug'); + speedSlider = select('#speedSlider'); + speedSpan = select('#speed'); + + // Create initial population + for (let i = 0; i < 20; i++) { + population[i] = new Vehicle(); + } +} + +function draw() { + background(0); + + // How fast should we speed up + let cycles = speedSlider.value(); + speedSpan.html(cycles); + + // Variable to keep track of highest scoring vehicle + + // Run the simulation "cycles" amount of time + for (let n = 0; n < cycles; n++) { + // Always keep a minimum amount of food + while (food.length < foodAmount) { + food.push(createVector(random(foodBuffer, width - foodBuffer), random(foodBuffer, height - foodBuffer))); + } + + // Eat any food + for (let v of population) { + v.eat(food); + } + + // Go through all vehicles and find the best! + let record = -1; + for (let i = population.length - 1; i >= 0; i--) { + let v = population[i]; + // Eat the food (index 0) + v.think(food); + v.update(food); + + // If the vehicle has died, remove + if (v.dead()) { + population.splice(i, 1); + } else { + // Is it the vehicles that has lived the longest? + if (v.score > record) { + record = v.score; + best = v; + } + } + } + + // If there is less than 20 apply reproduction + if (population.length < 20) { + for (let v of population) { + // Every vehicle has a chance of cloning itself according to score + // Argument to "clone" is probability + let newVehicle = v.clone(0.1 * v.score / record); + // If there is a child + if (newVehicle != null) { + population.push(newVehicle); + } + } + } + } + + // Draw all the food + for (let i = 0; i < food.length; i++) { + fill(100, 255, 100, 200); + stroke(100, 255, 100); + ellipse(food[i].x, food[i].y, foodRadius * 2); + } + + // Highlight the best if in debug mode + if (debug.checked()) { + best.highlight(); + } + + // Draw all the vehicles + for (let v of population) { + v.display(); + } +} diff --git a/examples/neuroevolution-steering/vehicle.js b/examples/neuroevolution-steering/vehicle.js new file mode 100644 index 0000000..c866a40 --- /dev/null +++ b/examples/neuroevolution-steering/vehicle.js @@ -0,0 +1,241 @@ +// Daniel Shiffman +// Nature of Code 2018 +// https://github.com/shiffman/NOC-S18 + +// Evolutionary "Steering Behavior" Simulation + + +// Mutation function to be passed into Vehicle's brain +function mutate(x) { + if (random(1) < 0.1) { + let offset = randomGaussian() * 0.5; + let newx = x + offset; + return newx; + } else { + return x; + } +} + +// This is a class for an individual sensor +// Each vehicle will have N sensors +class Sensor { + constructor(angle) { + // The vector describes the sensor's direction + this.dir = p5.Vector.fromAngle(angle); + // This is the sensor's reading + this.val = 0; + } +} + +// This is the class for each Vehicle +class Vehicle { + // A vehicle can be from a "brain" (Neural Network) + constructor(brain) { + + // All the physics stuff + this.acceleration = createVector(); + this.velocity = createVector(); + this.position = createVector(random(width), random(height)); + this.r = 4; + this.maxforce = 0.1; + this.maxspeed = 4; + this.minspeed = 0.25; + this.maxhealth = 3; + + // This indicates how well it is doing + this.score = 0; + + // Create an array of sensors + this.sensors = []; + for (let angle = 0; angle < TWO_PI; angle += sensorAngle) { + this.sensors.push(new Sensor(angle)); + } + + // If a brain is passed via constructor copy it + if (brain) { + this.brain = brain.copy(); + this.brain.mutate(mutate); + // Otherwise make a new brain + } else { + // inputs are all the sensors plus position and velocity info + let inputs = this.sensors.length + 6; + // Arbitrary hidden layer + // 2 outputs for x and y desired velocity + this.brain = new NeuralNetwork(inputs, 32, 2); + } + + // Health keeps vehicl alive + this.health = 1; + } + + + // Called each time step + update() { + // Update velocity + this.velocity.add(this.acceleration); + // Limit speed to max + this.velocity.limit(this.maxspeed); + // Keep speed at a minimum + if (this.velocity.mag() < this.minspeed) { + this.velocity.setMag(this.minspeed); + } + // Update position + this.position.add(this.velocity); + // Reset acceleration to 0 each cycle + this.acceleration.mult(0); + + // Decrease health + this.health = constrain(this.health, 0, this.maxhealth); + this.health -= 0.005; + // Increase score + this.score += 1; + } + + // Return true if health is less than zero + // or if vehicle leaves the canvas + dead() { + return (this.health < 0 || + this.position.x > width + this.r || + this.position.x < -this.r || + this.position.y > height + this.r || + this.position.y < -this.r + ); + } + + // Make a copy of this vehicle according to probability + clone(prob) { + // Pick a random number + let r = random(1); + if (r < prob) { + // New vehicle with brain copy + return new Vehicle(this.brain); + } + // otherwise will return undefined + } + + // Function to calculate all sensor readings + // And predict a "desired velocity" + think(food) { + // All sensors start with maximum length + for (let j = 0; j < this.sensors.length; j++) { + this.sensors[j].val = sensorLength; + } + + for (let i = 0; i < food.length; i++) { + // Where is the food + let otherPosition = food[i]; + // How far away? + let dist = p5.Vector.dist(this.position, otherPosition); + // Skip if it's too far away + if (dist > sensorLength) { + continue; + } + + // What is vector pointint to food + let toFood = p5.Vector.sub(otherPosition, this.position); + + // Check all the sensors + for (let j = 0; j < this.sensors.length; j++) { + // If the relative angle of the food is in between the range + let delta = this.sensors[j].dir.angleBetween(toFood); + if (delta < sensorAngle / 2) { + // Sensor value is the closest food + this.sensors[j].val = min(this.sensors[j].val, dist); + } + } + } + + // Create inputs + let inputs = []; + // This is goofy but these 4 inputs are mapped to distance from edges + inputs[0] = constrain(map(this.position.x, foodBuffer, 0, 0, 1), 0, 1); + inputs[1] = constrain(map(this.position.y, foodBuffer, 0, 0, 1), 0, 1); + inputs[2] = constrain(map(this.position.x, width - foodBuffer, width, 0, 1), 0, 1); + inputs[3] = constrain(map(this.position.y, height - foodBuffer, height, 0, 1), 0, 1); + // These inputs are the current velocity vector + inputs[4] = this.velocity.x / this.maxspeed; + inputs[5] = this.velocity.y / this.maxspeed; + // All the sensor readings + for (let j = 0; j < this.sensors.length; j++) { + inputs[j + 6] = map(this.sensors[j].val, 0, sensorLength, 1, 0); + } + + // Get two outputs + let outputs = this.brain.predict(inputs); + // Turn it into a desired velocity and apply steering formula + let desired = createVector(2 * outputs[0] - 1, 2 * outputs[1] - 1); + desired.mult(this.maxspeed); + // Craig Reynolds steering formula + let steer = p5.Vector.sub(desired, this.velocity); + steer.limit(this.maxforce); + // Apply the force + this.applyForce(steer); + } + + // Check against array of food + eat(list) { + for (let i = list.length - 1; i >= 0; i--) { + // Calculate distance + let d = p5.Vector.dist(list[i], this.position); + // If vehicle is within food radius, eat it! + if (d < foodRadius) { + list.splice(i, 1); + // Add health when it eats food + this.health++; + } + } + } + + // Add force to acceleration + applyForce(force) { + this.acceleration.add(force); + } + + display() { + // Color based on health + let green = color(0, 255, 255, 255); + let red = color(255, 0, 100, 100); + let col = lerpColor(red, green, this.health) + + push(); + // Translate to vehicle position + translate(this.position.x, this.position.y); + + // Draw lines for all the activated sensors + if (debug.checked()) { + for (let i = 0; i < this.sensors.length; i++) { + let val = this.sensors[i].val; + if (val > 0) { + stroke(col); + strokeWeight(map(val, 0, sensorLength, 4, 0)); + let position = this.sensors[i].dir; + line(0, 0, position.x * val, position.y * val); + } + } + // Display score next to each vehicle + noStroke(); + fill(255, 200); + text(int(this.score), 10, 0); + } + // Draw a triangle rotated in the direction of velocity + let theta = this.velocity.heading() + PI / 2; + rotate(theta); + // Draw the vehicle itself + fill(col); + strokeWeight(1); + stroke(col); + beginShape(); + vertex(0, -this.r * 2); + vertex(-this.r, this.r * 2); + vertex(this.r, this.r * 2); + endShape(CLOSE); + pop(); + } + + // Highlight with a grey bubble + highlight() { + fill(255, 255, 255, 50); + stroke(255); + ellipse(this.position.x, this.position.y, 32, 32); + } +} \ No newline at end of file From 8d1f077b360b9155495bc888c1d023f8906363c5 Mon Sep 17 00:00:00 2001 From: Daniel Shiffman Date: Thu, 19 Apr 2018 08:49:44 -0400 Subject: [PATCH 15/29] oops, reference this repo's library files --- examples/neuroevolution-steering/index.html | 4 +- examples/neuroevolution-steering/nn/matrix.js | 138 ------------- examples/neuroevolution-steering/nn/nn.js | 184 ------------------ 3 files changed, 2 insertions(+), 324 deletions(-) delete mode 100644 examples/neuroevolution-steering/nn/matrix.js delete mode 100644 examples/neuroevolution-steering/nn/nn.js diff --git a/examples/neuroevolution-steering/index.html b/examples/neuroevolution-steering/index.html index b5e5249..a079f88 100755 --- a/examples/neuroevolution-steering/index.html +++ b/examples/neuroevolution-steering/index.html @@ -4,8 +4,8 @@ - - + + diff --git a/examples/neuroevolution-steering/nn/matrix.js b/examples/neuroevolution-steering/nn/matrix.js deleted file mode 100644 index 34b2d97..0000000 --- a/examples/neuroevolution-steering/nn/matrix.js +++ /dev/null @@ -1,138 +0,0 @@ -// let m = new Matrix(3,2); - - -class Matrix { - constructor(rows, cols) { - this.rows = rows; - this.cols = cols; - this.data = Array(this.rows).fill().map(() => Array(this.cols).fill(0)); - } - - copy() { - let m = new Matrix(this.rows, this.cols); - for (let i = 0; i < this.rows; i++) { - for (let j = 0; j < this.cols; j++) { - m.data[i][j] = this.data[i][j]; - } - } - return m; - } - - static fromArray(arr) { - return new Matrix(arr.length, 1).map((e, i) => arr[i]); - } - - static subtract(a, b) { - if (a.rows !== b.rows || a.cols !== b.cols) { - console.log('Columns and Rows of A must match Columns and Rows of B.'); - return; - } - - // Return a new Matrix a-b - return new Matrix(a.rows, a.cols) - .map((_, i, j) => a.data[i][j] - b.data[i][j]); - } - - toArray() { - let arr = []; - for (let i = 0; i < this.rows; i++) { - for (let j = 0; j < this.cols; j++) { - arr.push(this.data[i][j]); - } - } - return arr; - } - - randomize() { - return this.map(e => Math.random() * 2 - 1); - } - - add(n) { - if (n instanceof Matrix) { - if (this.rows !== n.rows || this.cols !== n.cols) { - console.log('Columns and Rows of A must match Columns and Rows of B.'); - return; - } - return this.map((e, i, j) => e + n.data[i][j]); - } else { - return this.map(e => e + n); - } - } - - static transpose(matrix) { - return new Matrix(matrix.cols, matrix.rows) - .map((_, i, j) => matrix.data[j][i]); - } - - static multiply(a, b) { - // Matrix product - if (a.cols !== b.rows) { - console.log('Columns of A must match rows of B.') - return; - } - - return new Matrix(a.rows, b.cols) - .map((e, i, j) => { - // Dot product of values in col - let sum = 0; - for (let k = 0; k < a.cols; k++) { - sum += a.data[i][k] * b.data[k][j]; - } - return sum; - }); - } - - multiply(n) { - if (n instanceof Matrix) { - if (this.rows !== n.rows || this.cols !== n.cols) { - console.log('Columns and Rows of A must match Columns and Rows of B.'); - return; - } - - // hadamard product - return this.map((e, i, j) => e * n.data[i][j]); - } else { - // Scalar product - return this.map(e => e * n); - } - } - - map(func) { - // Apply a function to every element of matrix - for (let i = 0; i < this.rows; i++) { - for (let j = 0; j < this.cols; j++) { - let val = this.data[i][j]; - this.data[i][j] = func(val, i, j); - } - } - return this; - } - - static map(matrix, func) { - // Apply a function to every element of matrix - return new Matrix(matrix.rows, matrix.cols) - .map((e, i, j) => func(matrix.data[i][j], i, j)); - } - - print() { - console.table(this.data); - return this; - } - - serialize() { - return JSON.stringify(this); - } - - static deserialize(data) { - if (typeof data == 'string') { - data = JSON.parse(data); - } - let matrix = new Matrix(data.rows, data.cols); - matrix.data = data.data; - return matrix; - } -} - -if (typeof module !== 'undefined') { - module.exports = Matrix; -} diff --git a/examples/neuroevolution-steering/nn/nn.js b/examples/neuroevolution-steering/nn/nn.js deleted file mode 100644 index db53b8c..0000000 --- a/examples/neuroevolution-steering/nn/nn.js +++ /dev/null @@ -1,184 +0,0 @@ -// Other techniques for learning - -class ActivationFunction { - constructor(func, dfunc) { - this.func = func; - this.dfunc = dfunc; - } -} - -let sigmoid = new ActivationFunction( - x => 1 / (1 + Math.exp(-x)), - y => y * (1 - y) -); - -let tanh = new ActivationFunction( - x => Math.tanh(x), - y => 1 - (y * y) -); - - -class NeuralNetwork { - // TODO: document what a, b, c are - constructor(a, b, c) { - if (a instanceof NeuralNetwork) { - this.input_nodes = a.input_nodes; - this.hidden_nodes = a.hidden_nodes; - this.output_nodes = a.output_nodes; - - this.weights_ih = a.weights_ih.copy(); - this.weights_ho = a.weights_ho.copy(); - - this.bias_h = a.bias_h.copy(); - this.bias_o = a.bias_o.copy(); - } else { - this.input_nodes = a; - this.hidden_nodes = b; - this.output_nodes = c; - - this.weights_ih = new Matrix(this.hidden_nodes, this.input_nodes); - this.weights_ho = new Matrix(this.output_nodes, this.hidden_nodes); - this.weights_ih.randomize(); - this.weights_ho.randomize(); - - this.bias_h = new Matrix(this.hidden_nodes, 1); - this.bias_o = new Matrix(this.output_nodes, 1); - this.bias_h.randomize(); - this.bias_o.randomize(); - } - - // TODO: copy these as well - this.setLearningRate(); - this.setActivationFunction(); - - - } - - predict(input_array) { - - // Generating the Hidden Outputs - let inputs = Matrix.fromArray(input_array); - let hidden = Matrix.multiply(this.weights_ih, inputs); - hidden.add(this.bias_h); - // activation function! - hidden.map(this.activation_function.func); - - // Generating the output's output! - let output = Matrix.multiply(this.weights_ho, hidden); - output.add(this.bias_o); - output.map(this.activation_function.func); - - // Sending back to the caller! - return output.toArray(); - } - - setLearningRate(learning_rate = 0.1) { - this.learning_rate = learning_rate; - } - - setActivationFunction(func = sigmoid) { - this.activation_function = func; - } - - train(input_array, target_array) { - // Generating the Hidden Outputs - let inputs = Matrix.fromArray(input_array); - let hidden = Matrix.multiply(this.weights_ih, inputs); - hidden.add(this.bias_h); - // activation function! - hidden.map(this.activation_function.func); - - // Generating the output's output! - let outputs = Matrix.multiply(this.weights_ho, hidden); - outputs.add(this.bias_o); - outputs.map(this.activation_function.func); - - // Convert array to matrix object - let targets = Matrix.fromArray(target_array); - - // Calculate the error - // ERROR = TARGETS - OUTPUTS - let output_errors = Matrix.subtract(targets, outputs); - - // let gradient = outputs * (1 - outputs); - // Calculate gradient - let gradients = Matrix.map(outputs, this.activation_function.dfunc); - gradients.multiply(output_errors); - gradients.multiply(this.learning_rate); - - - // Calculate deltas - let hidden_T = Matrix.transpose(hidden); - let weight_ho_deltas = Matrix.multiply(gradients, hidden_T); - - // Adjust the weights by deltas - this.weights_ho.add(weight_ho_deltas); - // Adjust the bias by its deltas (which is just the gradients) - this.bias_o.add(gradients); - - // Calculate the hidden layer errors - let who_t = Matrix.transpose(this.weights_ho); - let hidden_errors = Matrix.multiply(who_t, output_errors); - - // Calculate hidden gradient - let hidden_gradient = Matrix.map(hidden, this.activation_function.dfunc); - hidden_gradient.multiply(hidden_errors); - hidden_gradient.multiply(this.learning_rate); - - // Calcuate input->hidden deltas - let inputs_T = Matrix.transpose(inputs); - let weight_ih_deltas = Matrix.multiply(hidden_gradient, inputs_T); - - this.weights_ih.add(weight_ih_deltas); - // Adjust the bias by its deltas (which is just the gradients) - this.bias_h.add(hidden_gradient); - - // outputs.print(); - // targets.print(); - // error.print(); - } - - serialize() { - return JSON.stringify(this); - } - - static deserialize(data) { - if (typeof data == 'string') { - data = JSON.parse(data); - } - let nn = new NeuralNetwork(data.input_nodes, data.hidden_nodes, data.output_nodes); - nn.weights_ih = Matrix.deserialize(data.weights_ih); - nn.weights_ho = Matrix.deserialize(data.weights_ho); - nn.bias_h = Matrix.deserialize(data.bias_h); - nn.bias_o = Matrix.deserialize(data.bias_o); - nn.learning_rate = data.learning_rate; - return nn; - } - - - // Adding function for neuro-evolution - copy() { - return new NeuralNetwork(this); - } - - mutate(rate) { - // This is how we adjust weights ever so slightly - function mutate(x) { - if (Math.random() < rate) { - var offset = randomGaussian() * 0.5; - // var offset = random(-0.1, 0.1); - var newx = x + offset; - return newx; - } else { - return x; - } - } - this.weights_ih.map(mutate); - this.weights_ho.map(mutate); - this.bias_h.map(mutate); - this.bias_o.map(mutate); - } - - - -} \ No newline at end of file From 1ce9f5a0bf597c7540be467fdca5de854f161ffd Mon Sep 17 00:00:00 2001 From: Thomas Smyth Date: Wed, 25 Apr 2018 15:29:05 +0100 Subject: [PATCH 16/29] Missing semi-colon in matrix.js --- lib/matrix.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/matrix.js b/lib/matrix.js index 34b2d97..b232d36 100644 --- a/lib/matrix.js +++ b/lib/matrix.js @@ -67,7 +67,7 @@ class Matrix { static multiply(a, b) { // Matrix product if (a.cols !== b.rows) { - console.log('Columns of A must match rows of B.') + console.log('Columns of A must match rows of B.'); return; } From 46d23710ea11221fb114dd001df2a17c098c0570 Mon Sep 17 00:00:00 2001 From: Fir3will Date: Sat, 26 May 2018 03:30:24 -0400 Subject: [PATCH 17/29] Added another Library reference --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index cbf60ce..4cb3d73 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,7 @@ Please send PullRequests. These need to pass a automated Test first and after it Here are some libraries with the same or similar functionality to this one built by the community: - [Java Neural Network Library](https://github.com/kim-marcel/basic_neural_network) by [kim-marcel](https://github.com/kim-marcel) +- [Library-less Java Neural Network](https://github.com/Fir3will/Java-Neural-Network) by [Fir3will](https://github.com/Fir3will) - [Python Neural Network Library](https://github.com/Gabriel-Teston/Machine-Learning) by [Gabriel-Teston](https://github.com/Gabriel-Teston) Feel free to add your own libraries. From 8a96a388474dc24bcb9e5b5ec402a74d60912fcd Mon Sep 17 00:00:00 2001 From: Michele Abruzzese <33634641+michezio@users.noreply.github.com> Date: Tue, 5 Jun 2018 13:29:16 +0200 Subject: [PATCH 18/29] mod constructor args to be self documented modified the arguments of the constructor to be self-documenting and added documentation to explain the cloning constructor --- lib/nn.js | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/lib/nn.js b/lib/nn.js index 3ba7edc..0cb4527 100644 --- a/lib/nn.js +++ b/lib/nn.js @@ -19,9 +19,13 @@ let tanh = new ActivationFunction( class NeuralNetwork { - // TODO: document what a, b, c are - constructor(a, b, c) { - if (a instanceof NeuralNetwork) { + /* + * if first argument is a NeuralNetwork the constructor clones it + * USAGE: cloned_nn = new NeuralNetwork(to_clone_nn); + */ + constructor(in_nodes, hid_nodes, out_nodes) { + if (in_nodes instanceof NeuralNetwork) { + let a = in_nodes; this.input_nodes = a.input_nodes; this.hidden_nodes = a.hidden_nodes; this.output_nodes = a.output_nodes; @@ -32,9 +36,9 @@ class NeuralNetwork { this.bias_h = a.bias_h.copy(); this.bias_o = a.bias_o.copy(); } else { - this.input_nodes = a; - this.hidden_nodes = b; - this.output_nodes = c; + this.input_nodes = in_nodes; + this.hidden_nodes = hid_nodes; + this.output_nodes = out_nodes; this.weights_ih = new Matrix(this.hidden_nodes, this.input_nodes); this.weights_ho = new Matrix(this.output_nodes, this.hidden_nodes); @@ -171,4 +175,4 @@ class NeuralNetwork { -} \ No newline at end of file +} From 19115f1f6702e5eaf94d1028a1cdc18b1147bc95 Mon Sep 17 00:00:00 2001 From: David Snyder <45735850+GypsyDangerous@users.noreply.github.com> Date: Thu, 14 Mar 2019 22:48:06 -0400 Subject: [PATCH 19/29] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 4cb3d73..04a74ab 100644 --- a/README.md +++ b/README.md @@ -74,7 +74,8 @@ Here are some libraries with the same or similar functionality to this one built - [Java Neural Network Library](https://github.com/kim-marcel/basic_neural_network) by [kim-marcel](https://github.com/kim-marcel) - [Library-less Java Neural Network](https://github.com/Fir3will/Java-Neural-Network) by [Fir3will](https://github.com/Fir3will) -- [Python Neural Network Library](https://github.com/Gabriel-Teston/Machine-Learning) by [Gabriel-Teston](https://github.com/Gabriel-Teston) +- [Python Neural Network Library](https://github.com/Gabriel-Teston/Machine-Learning) by [Gabriel-Teston](https://github.com/Gabriel-Teston) +- [Python Neural Network Library](https://github.com/GypsyDangerous/simple-deep-neural-network/blob/master/README.md) by [David Snyder](https://github.com/GypsyDangerous) Feel free to add your own libraries. From 3bac6a4bd2c5c664cdf87ef32820d39569382450 Mon Sep 17 00:00:00 2001 From: Shekhar Tyagi <36845555+notshekhar@users.noreply.github.com> Date: Thu, 27 Jun 2019 21:40:59 +0530 Subject: [PATCH 20/29] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 04a74ab..51b3494 100644 --- a/README.md +++ b/README.md @@ -76,6 +76,7 @@ Here are some libraries with the same or similar functionality to this one built - [Library-less Java Neural Network](https://github.com/Fir3will/Java-Neural-Network) by [Fir3will](https://github.com/Fir3will) - [Python Neural Network Library](https://github.com/Gabriel-Teston/Machine-Learning) by [Gabriel-Teston](https://github.com/Gabriel-Teston) - [Python Neural Network Library](https://github.com/GypsyDangerous/simple-deep-neural-network/blob/master/README.md) by [David Snyder](https://github.com/GypsyDangerous) +- [JavaScript Multi-Layer Neural Network Library](https://github.com/notshekhar/neuralnet) by [Shekhar Tyagi](https://github.com/notshekhar) Feel free to add your own libraries. From fcd745982388d8592113c9337777a714b42f4a45 Mon Sep 17 00:00:00 2001 From: Giacomo Rosin Date: Thu, 11 Jul 2019 23:22:15 +0200 Subject: [PATCH 21/29] Update README.md --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 51b3494..a1bd41d 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,7 @@ Here are some demos running directly in the browser: * [ ] Support for different activation functions (see [#45](https://github.com/CodingTrain/Toy-Neural-Network-JS/pull/45), [#62](https://github.com/CodingTrain/Toy-Neural-Network-JS/pull/62)) * [ ] Support for multiple hidden layers (see [#61](https://github.com/CodingTrain/Toy-Neural-Network-JS/pull/61)) * [ ] Support for neuro-evolution - * [ ] play flappy bird (many players at once). + * [ ] play flappy bird (many players at once). * [ ] play pong (many game simulations at once) * [ ] steering sensors (a la Jabril's forrest project!) * [ ] Combine with ml5 / deeplearnjs @@ -74,9 +74,10 @@ Here are some libraries with the same or similar functionality to this one built - [Java Neural Network Library](https://github.com/kim-marcel/basic_neural_network) by [kim-marcel](https://github.com/kim-marcel) - [Library-less Java Neural Network](https://github.com/Fir3will/Java-Neural-Network) by [Fir3will](https://github.com/Fir3will) -- [Python Neural Network Library](https://github.com/Gabriel-Teston/Machine-Learning) by [Gabriel-Teston](https://github.com/Gabriel-Teston) +- [Python Neural Network Library](https://github.com/Gabriel-Teston/Machine-Learning) by [Gabriel-Teston](https://github.com/Gabriel-Teston) - [Python Neural Network Library](https://github.com/GypsyDangerous/simple-deep-neural-network/blob/master/README.md) by [David Snyder](https://github.com/GypsyDangerous) - [JavaScript Multi-Layer Neural Network Library](https://github.com/notshekhar/neuralnet) by [Shekhar Tyagi](https://github.com/notshekhar) +- [F# Neural Network Library](https://github.com/jackroi/NeuralNetwork-fsharp) by [jackroi](https://github.com/jackroi) Feel free to add your own libraries. From c6c5d8ff9234bd2ac857d52c0b2c1b79a0dc2bc5 Mon Sep 17 00:00:00 2001 From: Anirudh Giri <35490486+anirudhgiri@users.noreply.github.com> Date: Sat, 27 Jul 2019 00:10:50 +0530 Subject: [PATCH 22/29] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index a1bd41d..31bafd7 100644 --- a/README.md +++ b/README.md @@ -78,6 +78,7 @@ Here are some libraries with the same or similar functionality to this one built - [Python Neural Network Library](https://github.com/GypsyDangerous/simple-deep-neural-network/blob/master/README.md) by [David Snyder](https://github.com/GypsyDangerous) - [JavaScript Multi-Layer Neural Network Library](https://github.com/notshekhar/neuralnet) by [Shekhar Tyagi](https://github.com/notshekhar) - [F# Neural Network Library](https://github.com/jackroi/NeuralNetwork-fsharp) by [jackroi](https://github.com/jackroi) +- [TinyNeuralNetwork4Java](https://github.com/anirudhgiri/TinyNN4J) by [Anirudh Giri](https://github.com/anirudhgiri) Feel free to add your own libraries. From 667aefc407cd89ac8277316fc86213322bf91b5e Mon Sep 17 00:00:00 2001 From: savvysiddharth Date: Fri, 4 Oct 2019 15:02:29 +0530 Subject: [PATCH 23/29] Update README.md --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 31bafd7..205c585 100644 --- a/README.md +++ b/README.md @@ -79,6 +79,7 @@ Here are some libraries with the same or similar functionality to this one built - [JavaScript Multi-Layer Neural Network Library](https://github.com/notshekhar/neuralnet) by [Shekhar Tyagi](https://github.com/notshekhar) - [F# Neural Network Library](https://github.com/jackroi/NeuralNetwork-fsharp) by [jackroi](https://github.com/jackroi) - [TinyNeuralNetwork4Java](https://github.com/anirudhgiri/TinyNN4J) by [Anirudh Giri](https://github.com/anirudhgiri) +- [miniANN Neural Network Library JavaScript](https://github.com/savvysiddharth/mini-ANN-js) by [Siddharth Maurya](https://github.com/savvysiddharth) Feel free to add your own libraries. From 08df54364987ec29ec964c09093f8dfbf6eae9e7 Mon Sep 17 00:00:00 2001 From: Yubraj Sharma Date: Wed, 23 Feb 2022 18:54:24 +0545 Subject: [PATCH 24/29] Added my implementation of CNN Convolutional Neural Network from scratch in JS. Example is demonstrated on MNIST dataset. The uploaded brain.json contains brain with 80% accuracy on test dataset. The example can be run on browser on : https://therealyubraj.github.io/CNN_JS/ Click on the load button to load pre-trained brain. --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 205c585..1b8ef4d 100644 --- a/README.md +++ b/README.md @@ -80,6 +80,7 @@ Here are some libraries with the same or similar functionality to this one built - [F# Neural Network Library](https://github.com/jackroi/NeuralNetwork-fsharp) by [jackroi](https://github.com/jackroi) - [TinyNeuralNetwork4Java](https://github.com/anirudhgiri/TinyNN4J) by [Anirudh Giri](https://github.com/anirudhgiri) - [miniANN Neural Network Library JavaScript](https://github.com/savvysiddharth/mini-ANN-js) by [Siddharth Maurya](https://github.com/savvysiddharth) +- [Convolutional Neural Network Library JavaScript](https://github.com/therealyubraj/CNN_JS) by [Yubraj Sharma](https://github.com/therealyubraj) Feel free to add your own libraries. From 95b7b562fa5a67caf423d8a1995b15c92178615a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20Esser?= Date: Mon, 20 Jun 2022 10:47:35 +0100 Subject: [PATCH 25/29] fixes small typos in README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1b8ef4d..1485fe9 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,7 @@ This Project doesn't require any additional Installing steps ## Running the tests -The Tests can either be checked via the automaticly running CircleCI Tests or you can also run `npm test` on your PC after you have done the Step "Prerequisites" +The Tests can either be checked via the automatically running CircleCI Tests or you can also run `npm test` on your PC after you have done the Step "Prerequisites" ## Built With @@ -97,3 +97,4 @@ See also the list of [contributors](https://github.com/CodingTrain/Toy-Neural-Ne ## License This project is licensed under the terms of the MIT license, see LICENSE. + From 05f68ae482092d236d52aadca78e6e63812c8e21 Mon Sep 17 00:00:00 2001 From: Mordecai Velasco Date: Sat, 23 Jul 2022 22:59:31 +0800 Subject: [PATCH 26/29] Create node.js.yml --- .github/workflows/node.js.yml | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 .github/workflows/node.js.yml diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml new file mode 100644 index 0000000..0715afe --- /dev/null +++ b/.github/workflows/node.js.yml @@ -0,0 +1,30 @@ +# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node +# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions + +name: Node.js CI + +on: + push: + branches: [ "master" ] + pull_request: + branches: [ "master" ] + +jobs: + build: + + runs-on: ubuntu-latest + + strategy: + matrix: + node-version: [12.x, 14.x, 16.x] + # See supported Node.js release schedule at https://nodejs.org/en/about/releases/ + + steps: + - uses: actions/checkout@v3 + - name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v3 + with: + node-version: ${{ matrix.node-version }} + cache: 'npm' + - run: npm ci + - run: npm test From 8729326773d2cdf3a1ea21b03943d888b4e1632a Mon Sep 17 00:00:00 2001 From: mrdcvlsc Date: Sat, 23 Jul 2022 23:21:07 +0800 Subject: [PATCH 27/29] migrate ci to github actions --- .circleci/config.yml | 34 ---------------------------------- .github/workflows/ci.yml | 26 ++++++++++++++++++++++++++ .github/workflows/node.js.yml | 30 ------------------------------ README.md | 4 +++- 4 files changed, 29 insertions(+), 65 deletions(-) delete mode 100644 .circleci/config.yml create mode 100644 .github/workflows/ci.yml delete mode 100644 .github/workflows/node.js.yml diff --git a/.circleci/config.yml b/.circleci/config.yml deleted file mode 100644 index 6ed94cd..0000000 --- a/.circleci/config.yml +++ /dev/null @@ -1,34 +0,0 @@ -# Javascript Node CircleCI 2.0 configuration file -# -# Check https://circleci.com/docs/2.0/language-javascript/ for more details -# -version: 2 -jobs: - build: - docker: - - image: circleci/node:8.9.0 - - # Specify service dependencies here if necessary - # CircleCI maintains a library of pre-built images - # documented at https://circleci.com/docs/2.0/circleci-images/ - # - image: circleci/mongo:3.4.4 - - steps: - - checkout - - # Download and cache dependencies - - restore_cache: - keys: - - v1-dependencies-{{ checksum "package.json" }} - # fallback to using the latest cache if no exact match is found - - v1-dependencies- - - - run: npm install - - - save_cache: - paths: - - node_modules - key: v1-dependencies-{{ checksum "package.json" }} - - # run tests! - - run: npm test diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000..40dc002 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,26 @@ +name: ci + +on: + push: + branches: [ "master", "main" ] + pull_request: + branches: [ "master", "main" ] + +jobs: + ci: + runs-on: ${{ matrix.os }} + + strategy: + matrix: + os: [ubuntu-latest, windows-latest] + node-version: [8.x, 9.x, 12.x, 14.x, 16.x] + + steps: + - uses: actions/checkout@v3 + - name: Use Node.js ${{ matrix.node-version }} + uses: actions/setup-node@v3 + with: + node-version: ${{ matrix.node-version }} + cache: 'npm' + - run: npm ci + - run: npm test diff --git a/.github/workflows/node.js.yml b/.github/workflows/node.js.yml deleted file mode 100644 index 0715afe..0000000 --- a/.github/workflows/node.js.yml +++ /dev/null @@ -1,30 +0,0 @@ -# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node -# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions - -name: Node.js CI - -on: - push: - branches: [ "master" ] - pull_request: - branches: [ "master" ] - -jobs: - build: - - runs-on: ubuntu-latest - - strategy: - matrix: - node-version: [12.x, 14.x, 16.x] - # See supported Node.js release schedule at https://nodejs.org/en/about/releases/ - - steps: - - uses: actions/checkout@v3 - - name: Use Node.js ${{ matrix.node-version }} - uses: actions/setup-node@v3 - with: - node-version: ${{ matrix.node-version }} - cache: 'npm' - - run: npm ci - - run: npm test diff --git a/README.md b/README.md index 1485fe9..194b914 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,6 @@ -# Toy-Neural-Network-JS [![Build Status](https://circleci.com/gh/CodingTrain/Toy-Neural-Network-JS.png?&style=shield&circle-token=:circle-token)](https://circleci.com/gh/CodingTrain/Toy-Neural-Network-JS) +# Toy-Neural-Network-JS + +![ci](https://github.com/CodingTrain/Toy-Neural-Network-JS/actions/workflows/ci.yml/badge.svg) Neural Network JavaScript library for Coding Train tutorials From 91aca06e5cb4afae0dfd2f276218efe6ea773fbf Mon Sep 17 00:00:00 2001 From: mrdcvlsc Date: Sat, 23 Jul 2022 23:30:11 +0800 Subject: [PATCH 28/29] removed node version 9.x in ci.yml --- .github/workflows/ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 40dc002..7515594 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -13,7 +13,7 @@ jobs: strategy: matrix: os: [ubuntu-latest, windows-latest] - node-version: [8.x, 9.x, 12.x, 14.x, 16.x] + node-version: [8.x, 12.x, 14.x, 16.x] steps: - uses: actions/checkout@v3 From 3766a5ca6891274e26b4b2a55df15939893f31fd Mon Sep 17 00:00:00 2001 From: mrdcvlsc Date: Sat, 23 Jul 2022 23:31:41 +0800 Subject: [PATCH 29/29] added node version 18 in ci --- .github/workflows/ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 7515594..cec827f 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -13,7 +13,7 @@ jobs: strategy: matrix: os: [ubuntu-latest, windows-latest] - node-version: [8.x, 12.x, 14.x, 16.x] + node-version: [8.x, 12.x, 14.x, 16.x, 18.x] steps: - uses: actions/checkout@v3