From 1807bf41a174aa3c236aa4da8b5793757297f383 Mon Sep 17 00:00:00 2001 From: Dominic DiTaranto Date: Tue, 30 Dec 2025 17:18:16 -0500 Subject: [PATCH] migration --- .gitignore | 1 + README.md | 13 + assets/Chopsic-K6Dp.ttf | Bin 0 -> 24264 bytes assets/Dominic DiTaranto - Asteroids.mp3 | Bin 0 -> 4304631 bytes index.html | 17 + models/alien.js | 89 + models/asteroid.js | 82 + models/dust.js | 40 + models/flame.js | 39 + models/particle.js | 36 + models/powerup.js | 106 + models/ship.js | 112 + p5/.DS_Store | Bin 0 -> 6148 bytes p5/addons/.DS_Store | Bin 0 -> 6148 bytes p5/addons/p5.dom.js | 3408 + p5/addons/p5.dom.min.js | 3 + p5/addons/p5.sound.js | 12879 ++++ p5/addons/p5.sound.min.js | 28 + p5/empty-example/index.html | 15 + p5/empty-example/sketch.js | 7 + p5/p5.js | 83507 +++++++++++++++++++++ p5/p5.min.js | 3 + sketch.js | 276 + utils.js | 104 + 24 files changed, 100765 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 assets/Chopsic-K6Dp.ttf create mode 100644 assets/Dominic DiTaranto - Asteroids.mp3 create mode 100644 index.html create mode 100644 models/alien.js create mode 100644 models/asteroid.js create mode 100644 models/dust.js create mode 100644 models/flame.js create mode 100644 models/particle.js create mode 100644 models/powerup.js create mode 100644 models/ship.js create mode 100644 p5/.DS_Store create mode 100644 p5/addons/.DS_Store create mode 100644 p5/addons/p5.dom.js create mode 100644 p5/addons/p5.dom.min.js create mode 100644 p5/addons/p5.sound.js create mode 100644 p5/addons/p5.sound.min.js create mode 100644 p5/empty-example/index.html create mode 100644 p5/empty-example/sketch.js create mode 100644 p5/p5.js create mode 100644 p5/p5.min.js create mode 100644 sketch.js create mode 100644 utils.js diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..9f11b75 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.idea/ diff --git a/README.md b/README.md new file mode 100644 index 0000000..d6e5e0b --- /dev/null +++ b/README.md @@ -0,0 +1,13 @@ +# Asteroids [p5.js] + + +### Features +Used the p5.js library to develop and design a clone of the classic Asteroids game. I added in power-ups which allow the player to slow down time, get better weapons, become invincible, and explode all of the rocks on the screen at once. The particles that explode from the rocks are repelled by the ship, creating interesting patterns when the ship flies through them. The game is arcade style and never ending. + + +### Motivation and Challenges +If you were to look at the previous video game I made, you would notice it was written with functional code, however did not follow the four core principals of Object Oriented Programming. I paid special attention to these four core principals in this game to demonstrate my knowledge of Inheritence, Abstraction, Polymorphism and Encapsulation. Some of the challenges I faced and overcame when developing this game was how to make the alien ship aim and shoot at the player's ship and how to manipulate the angles on the weapon upgrade that makes your lasers fan out. Furthermore, I also used a recursive algorithim to define the starting positions of the asteroids at the start of every level, ensuring that the rocks will not spawn on top of the player, thus giving the player's ship ample time to move around and get situated. + + +### Music +I also composed the background music for the game, which was just an additional fun experience when building the game. You can listen to it (and the rest of the album) here: https://dominicditaranto.bandcamp.com/album/amphibians-and-asteroids diff --git a/assets/Chopsic-K6Dp.ttf b/assets/Chopsic-K6Dp.ttf new file mode 100644 index 0000000000000000000000000000000000000000..dec2e88126e11625a7e856ba97b80448f950312c GIT binary patch literal 24264 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%0A}ZLtL-o8d@xT()&1b0Q-ayZmiqRy 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%0AwWb!e5!t%*I zY@O(1vR|=G;1cvtFlU4erFiOWiI-tyMCG5LxX8^mP#({SjU)xHX%a~p%%`fWq?<8f z_>uj1L}FYI{#!6!K9_bWR~V0?CpCYz1}RaC-Xd4pcNevxqpub(pO7Qb1*e?cw(u_9 zEBp(V)cjZ2`40N}*C_y%XJcoLy^~1spq1fGyMG|}F!ln1KWNj#{DV0diML%AprgpB z6b62Pi*kO+ILMVZi!yv>6QXl;Do2YY_PA0g%uPhRQ^~jUd>LA9Y50vi>$gv8Ku(9B zF^^#HJ6jIlb)m%9nR6;C3MH!UG+iYtn;n~nCCaf+-Tq*)Sncr#SN1+8BCwLj_rAlW z;IE|_zJQ|%ARM@<8!c9n7`$lQ^k3&PJe3;;CKd}fp*B94zRR6nLn@T$D67Wa*icP@ zJ4sG7(jY{xJjIK+c)_X;(z`PvAaV6Mbe$&sP0nk1Rcu&}bLCylu#x)I;`$r%&qZe$ zSi!vx?;jt~000=wr|X+;pwGAA_th;?)5(=x!fyokL4+Kv;)p^Kq--HEaH40sG=lP zOco`kesOYPU{wV`gD1uI;oGDj&__NRulz0`=-WMnjJddVdVbJ+Qab+E9L0Ml{iMOS z?kue%O`D-N8`#>0rH!%f)}xSXi80Z`uXnH8KRd>J_~P~2_gdoe(^bcdpqoQ>?5L6V zs|EQl=c0bO?pRj)r5R8AnB%1-+-QUErc%8{9-bZb>mChvHJ*-IE=N-84>uKn5#3?{ z5DkD2T*bILn2g5o8b}){j<@m~2o%cA>hJxF#%jKbOCM^Pb&8%W6M2`l;=Nr4vL}a- z<{hBHMDJGoaDycG;r=7Y83?mV;RIR^uCDU8$3z)!4Jzy@1|{*ULA##OBtg(7UCZDR zQOt5z{>V1RSDq0M0UC1WlDHGcPHru&-wf_xCkq8rSrW8Nc=#rS#kvy#M#JokL4>9- zv>}mugY5>O;<;<}X7#4M@i6$8*7oVx@wX@S-=x2~W38}Pi;b6K7hld5@11?Veb;{# z5`5#_u_f7(6LdBFK4j6I%)Vn-$$25n!tweRi+%Dbj77TsHlS!p`o*5@#q;*-#s!bt zrrV>>N7C6LOFqNLT`RJAJg-h-qT_%XOGDCSXkkYH5Cg#D$|{U}4s&@YGa5O?2n{`D z;hgg$SirruNJZNNlL))1G0;f7Dr#!hZC-o)V`v!x4QV$}3YRqeCC?xXB&Q~*qQt2# zkxJqp_r%Ex0jKmX3VHih(!TkCWIQr*eK0Bnrf8it9+zS}?s{oGB9cclLuDN0ov{c@ zU$rtii7AEk{Qj@KE{$6o*t+RM`HeqU*ai9Dt$WsojddL}`_dt250!4^PDR(S9p9E_ zFLDmQT-B|loDE~MX^*elN6vns>moVow>_H@aw<;Bri_Pw8{ z`{&P⪚J|Qpzz=Vy${c3Bh(@8$I0MF1}P;&gp07)1kBE9Vb z{-cLU;59Nw^PRm}rY8BCfY!W|ekP8Ka_|7QW&jb?q4Q3d3g9jGAjKFG07-S{yO{-W zMnD{eKOTcAxA`UJAFf4|`m%g`D*xz^%;0ak^A6kGr`kNGJOaT;gigCF2biI{Ko`cW zKKg+lhR<@Cl}<;9QH{JNZ40iJ9Ce(2VfFsgJO90Bt8Bxh zId|(^(AJC%eeL6I=4SO_+G^P6*hMS?z;WpPt|=E_7DB{dt#S*C$Ng#tACAbQ`eHYJTV zEyj#%NBf5DBzRm2>Ff7ygnz~&EdJS8Gg@Dv@!XgPXK+!@!Tv(%ts?NwCAaj&C>r#Z z9F?Jz3IK_CI09;@pO{NUQKPhRyJMrTg@z8!QwW}HIUa?v6f|`k-6N@`O!r2@+}M*@!Vn-yTwRbG9+VIj_P>Ao zAD`3jq{&tC^u+?mk2?PMsapb=6k>`?1tKUxEBS!^2}Y9uz(d00)dz(;hGTG%0Dur+ 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≫cu;u^ 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�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�Y(Y(F8LT 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%0D<~9Zs;bp)Wuogv%6r7HWixm|A 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

  • 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

    f5xwXI)tVXVz!D@_Un`%t) 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 d9j_$c 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ⅅ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 z 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

    !>IEAaN%Gta~dcVs3TbI+*4rOml3Djm%`2LuXTT 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 z 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¬m{V2T%PfUAbfP ze!cfEmnymKlrb5c0gJIaQe-pVfFea4glJTpk;Lb^eQC?oesM#f;GWl+c@~IHsJsj$HZ@a$;edbP~iaC7*uglL@+)Y)Zh0Qb%XOk z)lZHGLhz0d+n!u|=-1mXyXnp3MLiXrnDb)bd~H7a45B7Pu(Rs*u}SfkdhlC}lx_Rz zZS-_n(xRbrT#q+M)dT@`$~_1wNUFGu0^Zbc^F13sz5)wP-^H(O=BFNR{_&|pRvnGk zqq5mlbHC{jRUjL#`Qb;R!*j}i*>3y8GL11P^dIDG)6b#E1;*3IsX7;sF&Qr-KU*WTf-}usF;Go$W1a76`u^Ce`)bk_3`|PZ5 z@a-OJBDS;QZY+?eG}IIS$odxV{?RMyRLaSi=3z=WOh7iROQ}FAv84fe%z@7OxCp8lBlH)XlL8 z(L(fSR9{@I^IZAa$$Dlp0=tY@aTu&sQ}v}STCYQs zr|Dr*mGCVL7DEJ}Dcbj8{x&zrsA^=g7X$*A*Y-%u%bCZJ$sUOzKT}37I2Deq4^gq% zaf?trC$YkRwo_V&Axz?CcJlM z`I*N~h$`_5v4=Ar8S|I7THse~?QfISryCGM!3m5xuk&PvtS%vn8>J z6qVn#=?SD~D88k*@Ph;&G>Otr6;)-HY}z*(-dOYs&SU!HE?J^T^FaxrB{r0uD2j<; z{+uUD^i#XKhz3TgJW-f=%Z+2yJ|}- zDYOkSf{d7Q>ii2|xhph|N;@=1ee7PXB4POhG%Al>7Ywccrp^eCSNzB0?mh4c5u6=`s2;dkE=)8joB?!<)6%+Im zY`cxjKM-gU$k|V1V|*SRGOIR;$DJvZ`@qYxo)Yv$d+kk|;{}q=R1}v}?tcBDbOZvM z7FIPDR~-HHEiQh2T!!W4S)?+Rl@s^wsdmtpp(LTEPUkwYg@a+u^oh*%2L{|j>nqVXRhe+vaq!nTcMARvf@+YXeh1om(IYHt4 z^6G-?9k`zcRnR01TIYOyf$tS5F%rpf&SMr9799Og`5;>Yk(6B{>yQ^E`D~8b_CSYc zJ%OqNQ`qzC8XaSZj%;7Igf8KSfV@CkU=Y77Ii&~`wOZ4VnEuDOQ!zr`Wdb&Q0F+=J zJ&6)k+)ZMpKcZR~m;I=0-d|pct{4|LMpvp?PlU3VSgL#|i|#g|(2lZ^$_P36vR7>S zt-}DfAE_gq;t;+ypNcdON!5oeyYtFUP_17~lDnvBPW+VYpG#z5J%xjCegCP9)kl*G zY#!L;1{n=xg~sASo$(T7{-I)3#}Ibzi68!tp}BjokBp3As-%)4>tJN99VS5KPU4&b zwmoF&i3T$0-VzOk-h8=z9=6NUJa)1C)>){U-Fv!bI8u%Lmml1p+W>pX1_IE^baO1| zX!_F{DJ@izo7?5m>Z<#dKXcy(j@>&w#dLVCJzvHiWn2Gz_i}15CWz!6gnqChk`0^jgBa&P-{}bd5;3N67@w5=C7D@%j2cRx(NRGCQD0n zQX~LPr4Sd&2ecLeOkwc9!;E)uHPfjT}B@1ly-4330bx z*DxO~UGtM6i0~f)APJzk+=Cf_l(TtvgnSL&}9Aye%;UFk_s8U62t(2#@kU|&_{_HPg_kR2YY>* zg}P6E@(P002lp-v_?^!rs)%{}BY$(UJ!=a@(DRV0N39H+)>pWja4){3VO+cT_`sGZ zV6c*+SC2M3!3OdRsyfP8MFmqMdm~gJDT1%LHY5C(K6tnVcZ0;`&(pu;RQ2KUus>>> zC*$BM^MpW&LGd60hG0@k^^U+KVpp)H*xZ;!qJx>JWwPd*Q)IDR6;6UAqZX>vF4v*T zGpvY}Iu>90&O2t+L411etHI26Z{&tyThb6g<<vN)b!E1OR* z5QnEGe#gYQ7X2n`+c-=|7+LE^m%;6$jzRmsB1fn8I|7;CbTX|~)In|_EKI=9lC&pD z#CaTm7Q|-Bm^lS^cz7?{;j=$s)dgE$+ItN9uw!^%- z^)vqo0Sn*&#Z8vSq@IvkbVH)4dBd|o*=wW`&nze8U!y%zFwO)(ajoP1O_YfF`t3pO zA3w?EvZrHx0uys=ak3eLL2~p+G(mX&gVF#xwm>=zUn;0CNK*tc6cd>+fR2tF<2?&o zG!hChBoN^>W(Y7p1qw~VNTVQ$AVCi&*&sIXbR&MXI%)6U0c#hcBZmYr(wGA1@BqYg z)iiKOd3bnc=uG^25axKAznmC7BEEnCaFjU#ZIs9&->q--K+(_CissUqdfJ1&W$kG< zNED1CntgntRf#D!arccTXCEm5*)Is8NmHy8$%ehKMcr0dFJDNYOx-quo*W$r+VWfA zjv+D#i|Cw5l^)j9TD@$sMx!Z8e^?ruE1?&2no!x;Y#qe`&r9z^ekgtR=8W!6(Ijess zAaF&NhhyjdgB;t39l#s1kjYLLLqMmrHshEnfZm(J=)N6_j+JBqV}k;ABBb-LW6UEZ z1RupfX>LhzMB}0IDu%&Vv&`HMnR1P=-_uRKiI&ua!RMMK6PJ3j!|!hw>bk7d??yT* z?!E6jA#I$hpgq^cLD-qUUwKfd;4$TTyT@FW6e?o}Q)w&iNYhGTs9`k@GM!-zU9z!Z zcMgrI@Sr&}Cx#1oJ`tIfecoBPCs5Xo#60xxC0c}8 zpsA1r0#>1EO~ax%Gh%j-g}pTxyIbAEp_Z#GM{f$vU@LTeei>(bx57f1|+^eR1XMMtMx7jS6Y%kW-%b z60yzH9}#ULtNt37_3j8&c7)AMF&CW0tE?xeMww_|EiyP&K-hSRN>HB55~@1_o)i{5 z5`K-O{TCqj{EZE?PmKNL^NEWU|Gjs2@^!7`WIto7`!&BCjzfu>{p0I)87*>A@#LaJ zJ0<&wdC7L%mO|IwFqV)B=wnDMdUVe@m-t0>&qUtlP`XGQTSsx5wuL<{oJ7a)keNN4 z2N2rHBA}@ZrzWhRu&mnwb6awHUV3UvHgbVIdSt;?-R|!0Ut<7ZS+L+WuNx~zE`xyY zw!gc4V3N0L@HUWW1Y;n8V~+izy4bU;7hp&!0<>@?hZ_|h8pL2!T&FZU0P|PjgmM0Z zoX;2`6v^i6(zyi`Ub^q7Vh;o$*mZ`S)Zh+F;~a6`k`hO=%@=K1MBgO8>;IzN=y%T( z{=Jmy3&t2z=TuYaTN2ZoR^!$~|NXb0-3xTnl~3JPYFgAS?%X|U^-hL|A0YQfi!Jv} z*O=oaF>PNn_RBarz9v|GyjF*mS+8%T3f(mr>L(g{ZCJ5Lom!3Fj2O7kRZi4gMV&0u z1vJOS1jfR;)}R0mR4{>G(oVlaG8?vf^UM}x;9I2fhu4gXFUImei+}534%oADyC2TP z(3`41<==d#voMRlJ`;sN1$a9*f3`hvostq*y}AM6o?cs!!~a$&dviaQ?E*P z#*FswKYXR#Xv=I(608*n#Vkfi*8iGoDX?`wuYpdgwponCZOPj94q8 zxQu8)nywFJTvz{qp5JJ;JHFphT$+c7(c+alrwwe*lYzKoJi?q|r`Z7eJpd9^ZU$BJ zn3VNv&031U=)FB<_mo(5R<|gI2x70J0a4cfBI+%p+G^Wq-Jr!aIJCjtU5dNATW~4v zP~6?UxLa{API0HW6n87disj_}#y)%J4;lH(9QU)<{mgkytR*g2TH;DJeJqN?q^NJX zryIGCJ2(RD@SeC_8G6Gae#OSDZv}4!(8%?>66$9v3wpOOShEWZJ>XACjM`S&kIO+a z&1qA5Ep;JwVw zO8jjGdb20Cw$n9$e0~U}p_0e-($h`&dO=#XZ5gNDQnA}#aEnNKX5JElC4r2bS)QslXCM&YsKE_ z-MM2^W=>*U6a9AFKx;|}K(tDIX}qJ3sY41Soub69{x`tUwV5%NZ7-~JpeFhpDtRF} zlJvbW;s-~?wYBTuRa+>_@1+R4;x^WWu$@7_z{mFj$Z;U#E}VKkNwQ6kl)T9}y{-dY z(VZOS>rfpcocJk5B(3sf+#*|nV_N}X4;nIT2?nr})%oCLQM#I!yQ?R+oj}qxFmhC{ zN5|HeO7!$}>#*a#eqFpMUZ@7IJ+IZ~z%NZn_Fd*%O2h8feu~#*J2Qd&1XWrC3*&89H@aWR6V%Z z^wu|Cav{>~?U45}%+4ZEkH?C!)iN?EnYwS*E?02_>@r8j#YF4aKVmqm170!)C$Er-#{xg;@W?OHLf3#U6pK z`M-cC{;sq9E6alQM!Px5fks7yRS$vUuT%d9<2lSe69-Ir7Y_TRcjYt95Dl^gAD7L9 z_M_23$ul{Ze!qS8Nm;!wY~PTG?05R*zUqIy791%n7_v(>QNuo+H~tZ$+wRZl$oh2< z$s8jM_?-;p6!&>qam1uS&R?fl>g(hEE%eb;PVQe=*AGH9mWjqU{>_Xwh zh>EZngK*ku6aP6hzleuJ@epBVtLIFlXZjydKY>q-@ODe2luu~~qRFdH?l4wGo1!X0 zzvlPj$U6vh4vP-Rm<$vSf(pqCMXiw;>If0r4RjaxzB5+So42!M;(Y`$!<$M5#{7}Z zUWB8ZZgon|ww)JRw0|EJzjL8f4IXdYk5p(jsUXt&I_3JlkY*8%;a~gW<0Yad@_2Fh zzODVwH~p8n+=xnrg}=DLJ{l?&(@QUsGk2|c$Gt^%6rBNK!6 zqD<2UcbnniCr^PYwzvrkW|ezghF)d&as!erKh&rvsLr3>o{o~EMztEh=hl7bbJ`L@ zeUT_r|DqXO)32>w=b#x~`!MdL*Iw|;F2YF8n?Z`D%1AhBU(sIe8ilnqrzh(mCpWzI z^smN=LCwVY-#l|72;@&ZB1mHlIOpU*5w@E%jhrT8DXDwzTY4-dVJKH2nwH4}EY*Q(i# zb4=BGyUFM%e7K;=aeVPy3Zbf6Pc+W?J-SFwEP*gHe!^;udpWg8i|7u&I{QntypN0B z+8hMpR3*??4|(qPt(I^000ClFxMDOzU@3~Qo;KqxcmRW^7ZU%%L}8-GvLj7RO_w!c z<0xSV0i3AAYCFKJ|0FloR277vX0GnwvIFZ=Yo`w_@M0FGlU_e0ruC85>IAADfZZ6mj z4x8Qi-X0F2ZEI9y^d8ddXyix#c*SnnlDVK)9!Ux0*t{qN3?f8?i4Gi5FoaHsmEsS) zxtdzeweJ0&r>Xz{&u{3L|ND6UYQ}XSk*d+~a1a9Xx<;Q7dSJw6*4OJnkrlkSgTA>wQCL|4+|i| zCJK-2uMW4R)zpmNn$?fWGV90wJ#tpEMaK^;UfnT3d&xb$Bh^80XxR7zUDb4-q=8KK zl88^5py@Ps($p~Xt^rM>zuvQyuNMMo8dp94c05@vFx@K)z z6e_PAdwevj^%z@?BU7;!|3FumAHN=`S4p%_nc~&)U zi)t`)AS8BkWn4|3?lme}wqQ(6U5}UQPMCR8KR0%zAEvgq>mads(c^JG%HTO&`wQXv zZDoJ`uE4KEo3xfX%vrt3jptZk;gbNcG!Wb(?S)tgseA2jXP#z+LDU4Tj3CpXDG=_Vx(Jft2KwLu$(|cM zjXTzcW8unqA3g+hSpazvfz(6Z8$5H*6m{VUv>?PW-Z2lxn$hG*JC|JdNYSCm`hN(f z{Tl@pzu#Kp5bsCBs~qkak`RZ}vt7`aevlStCjZ_o+t`=!>#{Dsj#Z4`z{9q|Ri;bN zh>y0K58Wfbc74rU;yslqAe=h7tgFdAQ>pGz@7HO!wLj1DZ2bK>1qx^QzHO_sZ}xRw zeKuAA;*#>wB7cK)(qMS_#}Ma2HrN7796~d1jAE-Ssp5rZ1%X_tQ)7C&0{`!n%1+v- zslXI1^`>VJddVBlfi)rAoA(JF?iNq|j-SNZ*QP#!5Z;v`5r_r^a@$H7dg19{`{f{5()G|TNptG0b(i!;mzZ2Z+$}e*l2pbG9krV8RG9SULX|!}? zsP+Z+#tp8Z>50dtis%r_;dm)62O|Hz(SyE} z1&RA+$c|e9B9j=xMHo(?eQNT# zefsIg=6WXRrm(%)nttlVX09G$4SAoVGLx{e+HQbh!fqdKUV#0}HdiQ-|J1l3#^mwe zl#?F!3xfY?v<{`qIg9U2OoJ0yaLY>UFQ`^vXcHK0BjfqjL)%DVeV_YODUabMey=xm zsidB@NUcjn>#%m*mD6gb!|5crYt6aHiWAtsSF`;?TzPl8GQDyHv&veymnCwto@*zA zPTf5kTbmODM^6^Wg?vd6KYjG*Lf=i`o~g`BbjnH*ZsUEM9`j0U39=TF9{L>@nvv4l z`G>v!=11JulLk{*>LApXbA()y z2;O3!yjqiwnVe?gFjY?YvpO%7dllhXTk$6a^S=cgT#s0#;S4WtW6B1eqz3s^%_fw2-x{+yqTt}NfZ&?u7zYU$X808 zg=_l6&q~5ZL#Vnm^KG1U=mhV)d&u`>GWG3ctHX}k;HM6AE>^HaO~F)+n&AgLBzj>~ zBy%9tC@OBoOtGix?68D}Z-~GDQ_wJ&v{%}llp|ZzyX5ESz@%bL{|DHGPcLTwNv_$q zGl;4hYyfRJr%(vV@kPai$B}YyxS(B0rPjIIImA+i2KH6DtQzb%02V-&Z*THT_LHg4;!21Uv)Z z(>x$=9*WeqQB@H}tyDNuZpJVa2;qQ;@cvc=F_z*!b>u2O{YZ+%uCgmCtuckjk1EQi zedkJ(>S*XQMV{-Mz5WLdqWybTlM7inh!h_dQOCONI3*>+0D^xnp7|=9KGbtb_Si(i zomSB)7Y;04P=ObfHd)w3vUQ)zpiwJY=ZGzf^t5T(SQX~a=XDp?FXSX;?Gxnj7B^?5 zoON+*AxXV;W1uH9(rz;(Ym3D-G*vi+^x(= z-pNpEdzy}KpEzuW;6WMzug`nXpEYNhfhA2x&1+L2riZW~?Jxaq`}!&3;aq}EM7;(h zuuTCU!;dF$XD5!HqOQmpfLPf7Lsbn6>!u&cj;+nJYlUQQMv~eQRi5vVigWWp@bWL% zY*8*3#gk{7{W@4zwbL?NI8=kLsp)sUfi9_ku5Y#Rwr?HhC?dn?$Y#)wH5<*kF>@1r zJeVjT>U?64A=5p3xuLD!&!yU&th}^X<5$_O&T%V*#-U%9T5%c+Q-ckw&-hwIKh_qq zn@TH?<1Y*iEj;)4FENcUjUBnp;4S}D1i(`d)tUMq)^l}5Ud-FqaZFAtq|EfTwUoZw zcRWmO5G-$acWyt_UAm2&z+ynpIfgARwfNXMZP;v_h*_P|#h_%V9d;u+1FN(z|4DA; z5CT9jx7qNc=k7POWbg-56cbmifuS&*fes+u={Kq;RK*DGFrWeK9gFKJs%lAiBk~!} z@;;i^8p)-sMHO@$Fm#na=vckDr6zIn3y*Qsb+DtrBeZsxPF5lob4PXqNPaIG*S~Xr zhd^|}w*PO=Kx5Hxkuf$J_I9As(E@b%W^_eD-DDVbVsA0H=`INw1p0n8K#+UBconKT zAp;h~*r%mOj_Ino9g4ZY%${MQLzTLDxc7|$r4H$QE76afr&JG?JAOFC!biE zZ$cgZ?Gm;M>cI!P&c9NOka5X;xL!h6?5xt=MAA#xPY7*KDGVO+8cx}!RBdNYkeXlh z_@-Xz;d_hYpHs%=ddb`0Tim7J#PqU1B6gqI*omtAnrR@8D+GwbUq6RPV-;1} z<;A+Dn`(yf;B!{dr8d1+*iF@;dXXKNM`TTk+N%EAqN|F`c7pFY`Vi_HwcXNZm%C%g zyBMXb+(;qk9d}=+vIViwft;unKwh1{bWADrLm5<(t0^|V_&)se7g54xQ>UM?POvk> z1&bR{^d}hUtI6T46GAItCs-9qyb?;gHTK5e(J`{zJLxYxb+9j}fK%u>Jdex2iSjpX z-D0<65P+FTJ!)(*bf_Z|y_}j86FQ`+_*2s>UFX&uB|{_hZcA4(OBP26&z{qcOa2xj zKC)qfiK0J~x)XgJ>^QmYPgnEqJFZ@+((A>DWV>4n{HrPYUbIRlmc2AyShcnS!08{~ z9d+zU2O!kYwJjV71h86Z#A<>IFHujI`}?I5v-Zb~I<$hYze(Qwf4BN&CjS5kEw=hE ztn&SORO@+Q#BxHd5|g^!;PK`hdfN zwBdPMOG@$MisGV*EB;j-LE@u83L0649aYFA?HE~XxxcH)qXt{**bBFy*@a}w=55Rq z31jq%R@MdFaYcqQ>Mgb(7N;G=Bm73HmCmBy#oT z1@FF4Ma{N&d4tu6$zL2h8XJdCqQYVCVwP90IZ?*NL2nZ8+ZJ%~<^Alh`bUSS=s3EM zAFbANj&?kdS9sb*^WLPW%WIq^V!O3dUEV-U;_%SA8KcWlVpSGP5<>k0`&cBpN`NY8 zm-Wt5{Fhk1J>&e*c`;&B1OovYI&>AVp2=N2-52TTd|-ES2b6Dyg4>P)$g) zmp-GYKUZSU=~qC0>O2i(?Nh^Vua~ci1ZY7owlt-1fLXv69kmXKL`m?Q8qq z-wT#voazD&a$t_GW^-r2Y%jIB7{LHD;_jp!c#Y|w-|7LC?f*@=Z0DCC>JpnZKQzS# z>!D{O@TmD=1?wHjZW-Sc&DIXU68WZ{@lMxkohVZRRN+4b%ou>nS ztE5|TX!#>eSv(^Q3Dx3~p;*`Ao049mycz9_Qz?A_+EuoDU3^hNJLCcf0y#*A9iX7s z{m}NTnyeBO=j{d!P!Ty)=d@DWe{e<_*huZSr8a{f_|x}6W!NMgSz9ib#PhjA0xX7O zF-8X1&y>#=4{=-)5%8WLTDNE8>k6mvJ%-UJG=UNXn|h_e3z# z7;WbN6;WUHTNun7^OJ13@{KFU-Xex-CGnF~M&nA67)nsCnQF@_^LLPvxv~~Dtw4xW zxs^=f=fCQ6L%QV;tVXg2pe4bJ?_?_IVQ2NTlk}JPa!4&%#j)ZFS|Df8h^Qz4P|;fw zF3!f_Qb$RwB<4;)91w{>nJOrXWcs75QV3zd-T#X%J$?jS9IY(D5G7Sw$3g#UX`bsZ#&LJ*X5(zm znGF6&iwHq@`zg1BA)dT;#!(pzfegHwvMfq-CXtsJAd*dRcml=Lj3Lj1##U8n>>fX?{19u3+0*rW9fLm3oUdUtz)2S-6z zA@gjGS*zGIS{9PCAwm)nsWj;86_al8ZaU}A)D#VOYD6_jqsjF*l`E_~0X(r%u`Y*f z9yij%;|_3n23nd?t){`l%UG_?I0p=7NZS@Ge|Y+Mo{+moWdl(6nTOfF?9dF@r@Xq@0{aQ1!P6Uona z=ICvcCiaJo&Fwb9)q_}~dO=>%KEhJT0ia{_%3Goz*|ZxG76+f0P1G9L`yGY13l4xW zbWN;;7)s}3=?oN`+L&hu%%4ay8$?D#fC&rI?dsGj@`%JBHQDWyNYT69i2STCe0r$) zot&lW_y;1NGybxQRNL|^c~@~#B*DN3HFhZn->)4!pIPo=+&Or>^sLkx*!XR835>2K z84*F)Hm6jpY!*P>TTTa7`=*EK$_Xkdgt_Fhv!nQF%)(N}cRPFVzvAX2TR69rW*vu% zCu_&gD$9S)x4!<^RKeg6vZUz=ZooqUKo=MQ4X*>5bCB8YD6Hz)f0A>MhPFO@x70aT z&qSIS6u`}fAb1R8ZN_0?w!L#yFmRv@!tsxIf@Zl&G&kjsQ%SXqC!f-9)6|xCdSM5gOvd&17a!S{O;v{A3CT$x{TM&-F}sA$$8f4z-C$$oOh!8+y-8<8|63QbAv3f~?^`#A zQHkI@WW)~-|L3&lyH>?F?vX9=5uXIJv%(yU6-KYktuOA@6oEhA%<@q}JIC{NJ))-< zN+;q24NfP2uX+7daKgf3g9Q);hS@~`8uBENRZWzv(HRn@B!-`LaZ+UdZ1WwqN!0CE z<;(_?CUQoBjD-#JqXUP?@y-Bj!<)7E#Xlkn&Mw}aAWcS*eUQCqSO82tl6M(q9SEMO zBS>{_L9`4e#Yp)B5+-7Zc8v@L0=5n)Q?efkC5wL`K$fAcOKDZY@4;HFyY%(4hX1S2-a{4V95y5Jku{aA07py^sVVK$ z%w7`ot0_CO*y1%RSUY#<wl!wLolT+Th`QyDp0v^VZS_a}eA~g0t$lNgcRM&PLhxNJ z!SQY_A<^UAt1;?OqlEaz9i$5t8}e}$Jivp76J|Wh9K#}P37H0Ohe(9A+2unX-YbZd|?YbEaG~(55N_e-4bih!n9KiBD70+SYPCx%9$g>p;YYhNBfc zfe3pxJGnnW@GW1R?>l3)n{HC`41>_ahvU%WAk_vp4)LbCt;D~3{KeHzf8QdWzT`>?U!d;>P?5T#rXolZX=g5A!pAc zHn;e$VYx-uOnYs)rk)%i;!DmRxkku%%lx|beVa>&j$^738Hbzn+O zJhq%GyoZxLT}>m4*}AZ!tE?{RF0Iko{(GG1T^&rG4YGz8O(j(9k^S|D?HQc_fdyaF zo^F~Sv&gSNydDY^vBZ68Xw&a5yB>u4%) z7-$T`U}c~5Y>HLVPk!4EGPKDSg$|BV#n9#W)^7ikxxU^-2j~A#iia>}bH5eb!foS% zmgZnc^ou}wIE8A3sA?7&ijq?@be>ESTe zQ}suCfbpRgLUK=lzim>lG4hfhRxw8*@)ED@S)Q8x_M%Ut~#-D*^XPlz` z*R^bc{Miif52q*_9ZYx2s)BUuqVMolp7f*gHvWwK+1-S;V0Lkt<>$GNrRxR91kOba zK7GUB?xDHuu}fQ~W|g#YD{;%$_3yF5VpJ zQ)U*s=4_M+4bb;7lyjBBx?A)e{hV1oU<|cl%vPmT~O3V-QE0h zrr}Ynvjs_ag1p57nC>F1^Q}g9KhWogm%{^uK3W1SzoUdvxr<;{L0J#QvrL@G?smO@ z=sbeB1?Uy4j=ux~9oy#T7XtZfwmbRs9Tq&8+QWtTj}xiB+KNt;N$kk>-dDbBHZUql zaI;3svHvD^Q3;_8k#+}Z#6N?b>;;jCKZ`0Vd0^K`?L+(br1*%*_)D@r@m5f;pz_@OR21$wm_el-$BvJ*!o`KHPaV_e8P2>MbP6hl7^MThz zQzB8x6-vGF1xH(u{2W(9@8KS>1XgipMpv30Ce@xCGBokn<0^S>9i=U81>UazTOVI9 z;GAU@kTz^R!E68k*+c=b)@69iC{p(L=wxeVBD|7M#!`>ERTQISGvc%Ng6yN{<6y~J z8@EX00fD2jQW^4tZ@n#j7BVN;S+#{zzaD6i`^4)$T(PZt9EN7QwwFY?+x^Y741Mya;&(f zV|qOeMHWlDxByU=maLS87nE(PIoTvGf1^>Ju565(zEGo@5Tj$PWb(XK8)8&{zXUM| zgm{@i7IbATDgi;556V?7$=m}!o7@j9V`brq9l3Z!Upko1l3gawva20fB2iaI%!KQ(!za8#VYZSww+YaC_>t(3{A za;7+y7#;|uP$DYJJocM8r*5U6hkqZhJKCuMBMRw;#oEHA#xK-lX>V$n|C3w|$q4{q z$Y%A0Nl{hXlGp*f=MC~dR`U1;KsHUVeQ&q{G>T#L+{!WvFb`Ya9E9=-7)%n5+3jmv zy%p5S`97{LYdOxX4jBynQ<>f3=DCLK)(~9m*O#^{L^{`H)EkXvX|?mgFfkAnMquGM z(79-3iJFeqgG}LNv7^72`i=CChE<)E?G2dAR%+6T(O{%aYARN&FP^!t)8ov^|C(KH z8<~YXz573ORt!1;Ut{}DD81ea-iu=)kV%1HT8qwHDpz8+yI&0GG*XiAc62#ZKn`;t zI0u#)e_AGF1U42CV3UvK%J|JTfeG)P{R5#A1-W#*3(yw19NBbl4kIjz`XG}?j@m5Q zyuU()5$Z4a-zV>^)1c?>pYAKi z|M}tda(BXD)n2f(B?un|1QabqgAs-1q@+#Q<4OTTKLOhm{h}`8{i37*lBjRW8=mao zF!6W_e>7NftYd-JM-B{8ag*E+KhOF+_2vqX$zuLcX%>xTDvubCZ_@90^1Sdc3f4T{ zOcG7?<-EB)YV^&lzI$%B&#nYM`fV>F;1N)#s69)7x3)|D{^vt)lUV~GM@Fu_TZ3Su z4`WQG4*;b8TPFUQLCEweXD0bc0M4u**@<;awuKCNNk#oZ1bib%b=0r~oY{0}{2?m< zaX6IxpX175coIk7vWCN2gJ;6&do`#`$i{3Jl+_n`=u(bffyjG#wc0XED&NWu4HprV z$MIuE5X^!OS!{U2k)1ixR8nVFEr-6u&)Z#h7cgip5Nb9G4gc;b)kd0e_-nipG~JxkV70F;zK)%!|S_esuupPZ;|7h5ArML$ScFPm3 zaNn??(acz^Z9EKH|D%7)#fqY{5>a{S>zv8HR(O5w6^`;{0q(-Mf!xfS1o9$%yWD^U z02p?|1{jA3VKZYOV(f4OvlS$B7^13)dh@>=EaMGpA{wt68-FZu&Is(j^=bZ{*LNQ; zY8Dcb%oV8jwXI-nETA0n3cWBdfP+TDVY|?gg!~cnhg(>P(?Ez&8XanFl`#TWh>p3S zU#11(mC3L8^}d1-7ZSAJVD;V9?l0G=G9m8FyfFAb9}^NS5lg8 z^>}m@p)1x)f}nUY*j? zNUSH;!CX>wH*R|fx5@FHSg-at66Tpvj%Cj@%+(4#8(!P9GMl!vVph+F_H1gvjjq2j zwMD9Y;<;G!vefRbeUNTnxLzS`aZ6jjr>yVfDL**mSc!sKkm0WfQgBTpiRz{pY1TcG zRt=+e1#EW0Pl#-Xk>;WRX7~kcYLF@?srT&^$&z|I#FRUDN%H@uoTy$b9L<%FwuFj> zvwWCu-5`mr!vrmeZ2Ynr}A$yUcjez zb} z5Kj}iJhkEe*tSj!c$e%K+U7`TtdmCj$^O$|)KB_D+%nH)LEp*qQ4kq^dli-_MwvWD z!y4ZRTE=v@%#4YdyegGf^J7(* zXrELoN3rt{i7Bd>X^_Lq&hkvI9mXFTTV&cw*5O!C_!qSYPZNQs@dJ}uEUp($n9v@Bd zK5l_4`qDtEsteOWuVz_Tgk>qmN8s5IJ@yT}ZQAJEXq|#5KfIL8Eze^7^zf7_SyNvl zqk-^6^4nDEpO1O@gbvuuUHv(%rf2Y`dH24;onnf6a zQc{(LCixZ*O|HG)9onwl2;j`UT`k0A;PJcMa0wM2->rf;YV(qBe|FEqLG0{PYd^W3Y ztmdl{$EYe|;Vd83hLr0*XCr?E+TT5p*?^ESi?Fel&>6yP*p!VUZU?YzuUSJj!H9d({*P1LjOnFrjV1fk*2HCQ z_5K?$`ZS@vEQ?V^+Jd^f9}LE9|AhTw#;-pWD)-Uho6r_tR+I6q-zThc&N%z*qNgH3 zf`d#kFhK}H9U}0^VS!}DJen_}Jr#=)n^j@Xtd0)GugU?=c$2pbDUT0q2w4^<4Jqkg5ppZ|5X zPPMz@;%gpgXnw7|p#63U|L7UU3??00uC)%SFho41L{ArIXQ&K`7ud)l{+1NsHR}GM zVKSuEIKw4ur$fR3tQ!ntVd36Zq=fXBSU5TgCn;HsU1LplGlxmo(|B(mm1 zb=ix9s_gjjiph<&gnRy1m}*?=O7+O}YBl_@EDX zUlwarl*LsM{LsM^Swuy-1{aM21G)rfE@2sC*m4-Y??jP-kis{Ui_1O;q_53nPv?dm zg`pG%DJ_Sd4->e{SCZySi!?w;7P80+jrlRM4>RqC$c0dzBr+m1NVi>UO}gfWyxJ)* zGL}Ja0lL30n%gkQ%IX%^CF+Gx|5|j%8g(k=u4PR7RfK#@i;(+CbGHRvB>|zi@{9Q- zI)sGQVDe{*slBy7>vFXC>s;O~t9z(hc=8*>Oh# z1YO-I&uC={u$s_fa%?h!p`mgrzL@M&miPceJR{W_*Y_Doo2)#02llLiWpzGYQ4D-Z z02a*q-jrtyL!piK_{JnoBqbwRoDc%7yOFK-Kc&^sS(89(rjBu^r+|=<$8;t=&nt11 zc>WR?Da@+C~@g2dV3z0~ja0@4z z!65CUuO@ozek)X3-V7`FpGa8t3Ql3;)C6^D2b?FQCq#JfrUmN{&=rIo z3dkkYGl8?%qgFhyhr`nktXfy`vmX&$iIJ+wygk@yLzmO~5wSo>RV1;k!1kdF8>Bu@YSE#DLK=01)|7hid1CPnbJ zhIZ(xM7XM=FjoRyE&{0bEv3qIr1yW4yT9rL zAcUK1o1-aFXi56^fWxD3;v-$44$V^?9J~7nvXe5l(nWYzt@3Zbt-Vs0-B-_Y1v=`pF16?u*oMerCjThgXjfVk{a z#-?~76kL>ZCn?G>jmh_G-?JVYZr5Jk3m)vAy=)^B;t=1wDC05OHz*A6Q8{tL87qk)qLpF_ zsgBXIKQZd7so4}<9Q#BaG{W=)L`eo3qYXYVum}Azw2)USDaHvdRCvhRp-IT){ZDdC zBv1sul;tw?^1)2=C&R>N%yN9C67yQ2#ohISlf#M(8|-jerUGX-Zrz03wk4RTWLh@j znT2uqzdr2Jrz0!hTYbe_q;)y*nJzsNxt&lyxn8SFYQUpeTMK7bOjY+Y7FxE=(4}*# zUOorv=j*oVyxG`h%vg*Gq{PPqDH^sV>kb7#EzDbNEr*3gQ06?#i5G> z$uc|fg?yVhPE&ifZQt5>j?x$bpD+yP7*#FzC@4J_g)K;I={K)#Q01^I)qa<(+?o9Y z=wI6W&K{VN9W#-`@}aXnU(d-OmoIza3TR8|LV>vG)!NDM!=NCRs@wA*Hn%0--r_7? zD*yKPq~(HNj!~*uc$F1lCRca&NK20Sml1&|dUAKPBt>o1B>I3#@KY9S5=WuwwPYJR zYBWt<)YwlQOVVS{mh}xs7z$NIlL&|TM%XrrM^=Wm^dN+Ds13H7@3vXo8>6w)D!oMB zRv>Yx{lTBg*XV{7BH!nw2Ew8Sutfu4ta4VVlGEWyky-kyg2%$eVgX1Xvtih10zzUy zoA^Kw1v(ut-8derOJ0yt7huPUMV1jqild1S_c5aCcXW5+T|OsX#?FAjYNmte$~l~* znqh=-txyKZ6DwtL>TGTq7zuz){Ch;k5$bmQqP6tX-xegggiTX^adjnj4*KFAeX?wc za@qsK()O)98g`uZw^Qq8Yf*|8)k=r7gcP3L@fU`e6=l|y3FHZd@sK9rL3B2842&MD zeA%>BOB%0$aUXt(XiC~x&9tO`LmS5ddwvT*P!x;=2tc;<(-*{Ls{TwMCzV6F4)dSn zz79SIAxJ|5UdTMv`ag+#OdU!|w8|9fJ_`iTWZQCQCKMu>N*z=jq&&z=pWj^##2>(+ zNX(O1n6*>On`m7XXpW@_*!h$guI)H_Y}u`S;EC-0Nn5c<)pzto!D@b}ZaVJG`cn{1 zsKM+IY99NtU&*<0*gN9;)v*8ZbMylZ4D1c40RX5i3XTWG4NHc?CCl>dfv&0SVZQ_= zVHai~4#O6k+FQ^o5SR4dW(6<-sBu^=-IJqF4Zo}EM~s51csWHpk&+aRuXOjR8G_fU zG+x&Yb$VpmMIG(Gz=(?cLg_T)XJLmG2p9VEbVmF@7f;U<91;;+Z0A zh;V+`p&Qh|?L;bfpVpjNB85tyZW9muxxEpkMO(5NGvzUXg9-mSsE{uTnBRW?#l86M z+j4vU=&$tX4|yx-eD?sr9vaf*0Lsu-BnkmJY^Gu{<=BF-&=eXLzb0=e&Mjzb05dm{ zVuwlRsUKGBQwKg)UF*a7oL+K=;?4j*-}{fNQ17kn`>52i7v%@dDn(U2-1Ra{ZYt%u zyEEeAMQ)+ZwQbl+cxg{xCNrLT<=vLeTdPz_)x5p^5I-s{;&2H9pnKVdT8Bg z_^uQ>GMgFmWX4G5@cOpZY6iBQrx!1pZ!H2PmAED~KHL;nf}4E|!{hkbH)A$cxjDrD zB&VzX1V9uro!@ujDYib+_cv!SBsfe}s{OGZeMw|fRS~l~0)ZAVFy5bik%HR#wKo(p1vsH)9EGs zv+nfrCizK`?`0jH(eKIEF?|)yYGXvsWSxfH8eUB8boo1(s_r>|^CA8gUEnn2zGCnC zp%_3K2HaY;$gyLOJZFoYXcFakX1?;;Q*?ve^s`Kv6<j6`)TKvv@{ChU7PWzJS{d=yq0FkzUGzKM`m5H{RRTPL(3*nv|q05Fq__uOIiZ8RphsC7{frltG z;R-_$=^4OWoR9EPI&eVW>I7R19K^Cu4W5BfDP_VpI`_; z{wKLLyVD>SqJ6pCO3>HDUD05OejdYRK)?Gi#84S{kh!+_|sG zpYbbjnE8>OZDh7E3fa#Lnu&8&*I-$eJxK0Y&WfPY6J{=RbTjnw*$f>Z7um`!o~Cj` zn#odxe?yki>7;Hwneh2{6J^evhWq3hpxfF>zij=g!I%#p39(LGL`_fl)bLT$#y7E( zfJzJ@y?X;zhycV$Ie;c+S`0Y!7 zs@2gF5#U;4=zq8bo|ulg5YORud^_`=7E0hso`CHw)_c7&I26gD3i0?fly#4rRLfDd z$9i}51j&hsVq@%hi&d!f3tAh7 zl6iUC2W5ASS}USlJDYHmuQp(*jc^tCd?3f&Rm=q#0)6;H5~*k=$oDZ2@j=;QASdTd zb0r3X07Scnapge-iWj*^6n~q3gS_gTzx4w!>`Ck)XIw|`^T9}idd-3Q4S6v8HEKv4Vw-c;Y68AvS!~@3EIv70}~-h zr9B6OVr&Cvbt72ZyQPH=&P>}@Jg44C@`&XstnzG4zOURxj>tdpy;84SqI^D74fXpR z>I07deZ1N2K872doIGYuXqG5d`6Mn$_~jF=;$IXBe;dubkXI{{MzhmT5J9?6XgH_; zNsg*xI}D-9QbW+k;6`2MY)i;)kQgCVNZC?D>_^Sn=g_t}yQ)09-Ya2hLeeR}rHV{2 zSr2KotU`qC%KHuy8wfhpfh7TZ6ZU5lx}x~tG3%x-&w~YvKBk2jbVR}*uD#Cwua-}40WH7;flFD0xR13g7~nZSZII`k4nIJG*QsgAR^H-;t_9Ph#Tyz%}^ zWTgi33wmc$HMMW|Gw+vbIJ_tTH8;C0=j;<@77cJjQxv{fH-?ac+#Hn;-)4%-rKIC; z-o8vIxPgQ*&$o&8OdyZEywjRLe$UWmClZzYsgCV%`2S<;tD@oxwr#tS#t9bO-Q9z` zySux)yGw%85Zv8ef)m_bg1be41PJu&oO{PO@8i}-%l_#ed(T=`wbop7mc1gWl1lbi zvHQ!C{Oaf&dZ@7d^hOf$^B@Rn3%n3M< z0}v4_58ffQAiN)SUsOkMT{$n8XyV0a3E#8X*5t&J?l@eoWW=G$Vjh!4v*aLA`&OFf zArgYTtl%$W;22)CYr3{%9eN>Z3W01QPbs{v_^UiZUPQ2fm)!g*KmY&(9ya?2sy*jm zYK{jg0HcH4tZC?&COm3VQYoltbPzx>Ia8fPjTqnl=H!xi20v;$0Z3z@&?MP#PMulj zRF9sUkfMuga;sV|C{+bDqRP{S^@Tp^Y#-76ibJX{HpKv>#y2+h9d=Tu5LIYj`akA# zk-B5RZNE1iEm@O&yEQ0XAVPhKC~;SSmt21h=0Auhm+q;JZ^>t!@;xve6}+ z&sF`;wM#lAbiXQq?8Kb?)#*K*55cmLzVs(^#$Y4!fw?|C;hr?xe}qj4B(y^!U(U`Q zC>4bSboDeR{>g!niHl17KsIv#)vLzAz;WMZvyUNcnw$aQF!~{C2PUE$pp}_BnPNm> z0YUBbFZbW;|D<0Ux2$nS4abuA^0zZYvqx-AFRJgV(xvuF8(-8A+U;%{|2_WncNgtt z)@cy6UK54nw%wB;UMfXyF94(wF97_;F@BH#tD!v|&$M2pgDV|WCYTsaMR{RTlbI)j zODW$@#lY;>tKwqX3!z9Cmuh^QJ-z^Ru@!_YDF-^L7H^N4p@GqcfeN{@Y=3Arbi|^? z1{a3Ali1I)^>7?m7ZwOdHLwbwhWdms(d9PldGne{MYR zJ2rT|f)8m)=qn4F@?a5(DX%bP_4u7me)M3}pVF*o^X@ zmnW7eVbSf#F%j)%IMLu7EVzFyj&O5S8(&?Y78DTpR+V%52T3p73Z;*{tDA;J8K)FJ z45h;L-g)8M14ny2B=t7F^c=%Wnqb3=KS4#Z9$B|<1+LFn_#jNo8!S0&B*eQM24BI&`=-rg%I1s$iEw(z^sr}o*7;f zliN0MNfS(Vn1nhTOiqSg&z0!;F~HY8K-z0LTs7?LZXoBBkkyCK8Ra&}0^i97jF=gK z8gAJ3SnT`XP}0&Wb*y#(Atr9#lznA1*v#i=LKMg1j{8^=01pB%hDppr=lK6W z-a`NT?XPizBy+#n+JK3S&ef{XjS$qwG6e}YZdi!y};;52LQN*V(sq#3> z_OuG~q3Iw!g?w6kNvF&RIS1OrQ|yZfF|!EqqPPV1O+VD3$pJRQo!_})|H%Y9D6Iof zaO0M4UBv+NH8lvcRsf3NY3qI{k%TghsS{e&#}A1|Ros6Or}=}a6G$Fc^Uxj=Q=BN~ zw91&G2>im?^NYr^30cYBQ(~>wFq8yvTXJPj@>&(LXK*$4R;NLwMxXf|0 z*a%2A8{ee|2G>(>9mKg2Z-^gCG^563)pgV1Eb@RoGK%YpyJ|pP*W$^H0XVM`+ilXj z0Z!^tba!GJ>ojaRff?OqHU@L4@0+@+<#@yG%L4pZ=-mrDef&n&-rwit`ryLoOlc1r zaHjNVD2qkGD@y%zJ6t@IKM37p^sl%+>cO%9tV}t;WXrATcAa&?)T(HcMWsV~BUi@# z=fD8MI8Lowd9{08VRIj<&Z1&iopb^wEPcSLCCL4=TJ3BndBaf4rTR`jkRn>aqK(~p zQu`8r#M`H4c6Pd`TXH^$;5(|Y`&3L7O$v^LO(LOEQB^>Jv@+wADNDNvm16drsiEKI zsqa%kXZE-6Ch$ZRLzpmOfG!N*4SRC5-#p)waet*M;x>}mXsMr(7`Rp<%ctsFR>;Ft z;OGoMY<~{a(#{u#et+t{9ROztl4U?F23|#92Oxj;c9gUA0Qi24oFU0Zh?QlGQoK5F zT9#^rii51E;wdz7yZ&)R*z)AU`REhV($Nw32&G%xaHB^sPm3c6thj0^s)yrRl4q<@ z(a0&`X7K#TVeBv{M9i~tpS5+T>^!JsB2Oe}KW|4cA0v|m@+ffkx(CaA{`zlS_307> zfH-`0sZbRUmCFtK&104DILb|vgxQAZ(;Q#JX~Fflie#HrPe;P$U6WrF6uL(gRe03W z)Ub*9!!e4Ts|C0x)gF>mLh2NB!2HW==GJOfPA!QBlZ{Tt#=;b_sreZ#YM=R13xe`W z>1IVCHLrSHaq#reBLHCUrz9|f*iWQRMgf$VXwDr(q&IvoL_$ivvP&qjO*fi0wY_Rl z-)PW&Mbdbkj(}TYZalD--y;nf)chV`+({z@=xYOLf@Om}%BQ|8KnV`pCBumtQHE($A=ATqu6rEjxM zsxs4INWApBbiZpSGWfWtY31LwB(y$u=c1Hc7Bv>WXl>ii7!@T?uP~)EMQxXEbNP@N zuqrHk$MX44zCt;R7-ep!`VXH)gWAZ44?RKqTqw1@_)hUeC8^~%)W$F&EUcqeYlq29 ziB_3U&mG)z$DTdVv=Dh1F$Mu&sQU2@toU651@>??2)NmWUW@5kIAJSvyXbNQjx5)n zcdq<6k<950;X7AWp>AKO!gWBmy0-l>@Wy5P6H25j=b^NTa+ku1YVO1YBw8wjpxUyy z2PTF@K(l+?`V`Dqw?b{#Mg@iQnN5m2pmFJG6a8YQodXN(6Cno{UgnN15P0!Nmewr) zR`Hli68quqS9VJFcJ^?j>zYlfwRuZ4zpuzbIGpGwGi0%H$C)}S*J)CoXnjj9-09^i zTah(d26}7SryO60Dvj0e6{fak7^*Ta<8xyiQ_lz+ozit@*=~Q|ZKFFXJW2k8oMM$$ z7`%klR^U6XXT?*4U7`8}{2^yKH0ls}x=beS`|6bFm<<3RJ^e?S7hvBc5`Q%ATZyU1 zhdB#WhfkI)CNCHpaj?i-8(m61`N6e}2$+_r)Q|#$QB(%3?WMK$(Cg(>vS%FCU{PDh zzytmZ$a%7r8J*Ng5+CDuR(w=qLOMPi9n+N^Fk{Cn_d85A=ZD;I`2@DAHaR(hI3Xb+ z0492>!HAkF5qE4CIU-XPHC+609Vh{eBZip_OU@az&XKgkv>MO3CQ`>`6 zbx^HzIc?Gu+(Wce|9#blxv1k^)1j8U%;E(Kz3c);FD9Snrul2CZcQ{IqJVDc2%=x} z5jGsUpK->S5&K=qOacXgi7OiNLeu$Bcv-?n|)QA>`Id_hqy-r}|w>DxO@fPCC} z_S2^NX~kde_aRG5A0pD7;t!kQ;ng}WbKC0pI*)(GPbyQpjCQQO z$m^VXY#h@M190*Xl4P4FD!3L-^f?4=Ql=SMEXgPofIUeR1mmiaq(}N6N($sYv(vAx zq+7b^O&eo!{Vb((L6KTZ_mt*lP-(f6vfW9C@)t9f2#(MMLxM{j)Nj>zgv` zI1R)UB1Q$k&~Pz~bW3mY_>Lrth~+y&3fUAoc4qQ8%N}qUa}*=B2=jD&0Y~ ziS5sZ7JEgS_AiI2oN^w2kC2R)mO&5Ib+FJ55K0%PdxR8tI>|(hzcM-+Z$h8EH50K= zwTD{{23>9TrNd50;(G9rHM^bN^E_eEA9`+*s|aXm`OdqKMynx)J@~?*5Qwa9sC~^e zB-?@w(z?+8J^~*KL6#6=RJq9}YE`(ID7(Re0 z@+Nfo@Jypz)w^m4PA8e=082E4+Xz4oEmFfhmX=DqQ|DoES@O?q#pYkyZjDNA)wJ{+ z@C30ZR3fXb!iTT9KP1ZcXf*t)|NKx?*;@6~9Iu4TP}5MqG>;Ml(%O4lY1Igc41KP7 zhzM^K^)Cto3XI0}6ph6Y<5y98VFeYz0T0%K(2B3d!~?8MyxGips(P;&wTg-dXfr7zT#`wdXwUt~5ESsd1K|0G$N1 z$sggHM7}Pr4{?$vEj=rCBOtbsrS%gZOV_^KJGzww=_r=2efR|@>4Gzt)q$UmCK-BTExfr!}MQd5PI`H)=_vSv1rJuCtpB8?`Ng)`>ox z)*^Zv|J{x?$~&d2mHvucLV}th#33`cB}-F3+ln)*3``@&9xOtE(@aU+7#Sd&fN^i; zt@X}j87j`FmrI_{mG5AFF?n26gJ)$QC`;`Z7UeoKFfJnFNu<_wEM;+geb1=8q&pXw zvd_U(Ah^kXmolt|;RzrB!)T9+MT$x`)dRy&`wN#e?Oir9ee3J8!H3=FC(s~g``fFN zuM0Wl5gSj&iN$37Xpz*Bq#2nNv~zg!=0OTqzz4ELWYsu4}jqAR=+SN}9;9B<%jp<&K8;d-WOX~DFf!CTO3fE-H(0_*lT+C1 zM?yGtnXlV>JFYYoNuP(zG)`quOw~ZwBVas;ADYM$`*bb-cj06Iy@Fv#11Oj~=f}xPVEcn{_?B zi)7Uk`LGYlqQVG|4^B3{irPRFMc=17(fp+*2FwgL(`@&WGsDQ?>6YIv%h{e>z8*=k zAXH!Dtd<&A+wb?`*zaEUjs_;tkTZK6s*-T9mT%bm;Q;{NhKysOjH!a;CzEsiv1k=!7*_2f6GyD7r#@k_Vj)~rINSkQ$S{u6n_5tNcg@NHH1}|Yy5x5r@Cj4ZK2KK&pakEII z`mxh`vwhB3nl+jF%5`>z-AFIl(p%JC|LSryu|iB8lEY*)bV9#PgV!i}mz=Kob%#Dg zA6fH|2C;`PTWW89^9M((2tw*V^KRMW}T z-PAw3FWAhfB^GRS_|SrfP5b5x#Lev8X6dHmEeon>Q>PyvXw9Y7LY4!6rt`VWDu?XK zqLjlz+D-RN%64CRiy=3<5Xkw$zypD_U=*574*;XCZ?Kh1<=r61(eV7%cMoY2m>8pT zIhGWyTL?o5PO#O{`->S$+vANQSnTiy`ycnx$H8UC8H6(X}!wkW3 zrU)KYw9Lcuy$pU^X%cmYL|eGsLqY<}Tvaj2=3a1swI5pp<2EJKInx_M;0 zR)R|0i7~R2NQ3`k&m5tKQ2}IErg&s^Z{`ZJ`3-VQ9m97R(s5B{lmXeL!wDmDlLr7m zpFbTNV-FQX@WorCk)$WNWd$wdM614 z->ZSYdTt*hkDgEEaJfZX53H@HxGThlV1QBu+g1^&to(+)VoU?falerae?0uhjCBv` z9u+>=N|Q*{gxu05AXmtF7%x6k!rA)W3} zYA`htzL5F=gZfal&T2sF>GF-{Gb0GP4`Ky}B0h@jh%j+SYIC7eYp9GmF-B0kliSw< zq5zc4@Dcao6F?o_ME%TiE;fxa&m^lgWSk;g`Wmcv)DE=N-Fj)0S~#!c6{QOgLFBdf zyuU+sjlNU})#|E^njdgb*?yP4+PKn&Y*h0roNIswn$yVVy3j1HowWF;*vK1Xj zOvyF=y#5*){@!rq(Ds6HfW9;eF7~!H#Z4l3yLt9wGx8cLW7r~~h$wXGV~~^`u6{)E zmYdwt(DA519+5zP3wg`DFpmwvfb#uxLEFD4)8D5`|3DBt?T)JBy`t z`JDPi*nK*uOW7U)rT*VnhVtX3@#_yPj!>647n}KNT1(Gr$Z0#2$`}8T*ZOAccLVVh z|A{1C!;S#};aKlyG|?AXQW`xbfw;Lrqf*nS6_*aw)d=Nas*EY%Qywsi=R`af%cM?izc0SNIJ9efLcL1R&&?`E;Nb+NahBfjh?H|NJA9;m zr*Dv*vdTd$L-V`}naj?{Qs;V392 z`1U&tUe;=%mq|1%P_f6@oTWkwn5}$6s}ugaye2rK2JC$|)WUyxUSl<^fy?{%@ADM7 ztD?D<4FgZ%MVGwYJ2ZO0ppizXl`KJW#I|ast$H{oe99MB$n&f)BK-B=xTJdmuDA5* zT(Q>}E1|^Q6=E0VWZ=gX06>pZ1z8QozT@0s@NB9QE6-3IIk^NI8wu(BWA}2LmMYqf0k@);nwi}HydHER`M9-rVt-qf?h0HkMAAY2Ke*v zZe7Jm>u*FDEJKD}bI9xRaUAam(^Xs+_Uw*Gf}|wz>x~2Z1my5Uo;W&62t~qD zcWo{r)xZ8F+i@|p;2j#JPo6uN!o9e$eBRPyYa*N-AAs{d`>p0bu_r-^NzTolD3uXV`}WZygJdAvQl|Q~hFj?LS-%$|nTZUU!jWu_&SM3H zL8l}DyKitb42d=j0}%_|Dn9KrA2^Wnh za@*!afN%4P(4*X1;^aY)_%o=5sZ+#q1lO2~RMpg!=x(CDAx#V)<-j5-?D1AvfA-68 zl}C|$f%E&gOYoPIK0mL8cr@qRKYDgr_;6!Y4Rf1UZ)O(>VSmX5YV^7WKeDK*Hpd{q zX+RW8zXc;-J@G4?#c2oq8pFXnQvbj2i^5?tHkY+l)c=bkBFpHCY8g{}G`i>FIvPMr^7w|(+>jCmj}24aM30jr$6U>_{n27hTLd+& z$s>V*%cVCX$c${c_|Y}9shf>`1qU<2H`W>kDm#MoN|N&~+pF^MZ_l5Ka&S3?XE4|bL~MVzc7rHRetQKHRAg3X>pt=7uw?A%8ZZ=E zB#;=C|I%TYU4cev#JJ@b>HB@;h|YuMibw1BKGu95XE7vc(o%k&JS53Q>6R9#e{1np zvC2}(sw>(eEf*gYjk3R&u+enmk!pKChvJZ$vM;Vi#M=dJj7&Uu!ptt{@|5O9Rx>TK$2LL ztPHE8pOn16R!pP#(0{>Jb#T_c+3VV^Y%^%3^Y>m$zwRN-ouvW_?yXF*(w8n~txLV5 zHYbBXN}JY9jYA*9Qpx&5s$W0)Kt@h_(=q|%hI!;oITPr^ED$I~vYxE~*+eK>^uVM4&(|dal(3quRbkF#`p}SLMdzH886uCfVr| z`y~Y|6sz$Bm`ldr57)k{isR4pW_mDr4u)XEiuw)k)TX) z38et6L8x{H!_7C98!e3r=r@Czu~x^%p>QdSic6zHC6!Vg zYwv&&>Op1T+$lY@flt9kut1lmAGF6HA88VksuRLt9wD-SEJ@xqsH(p0=G2QdH5sL+ zrH5*r1wHlRwRnk~ySb+}-{{g)i^)ZC0EzuqUeFz8@&|g6K9B>lSL+&)wdVxjejF&L1;W!g>A1}}ot225+<{@$|w zgWO%z?&4HCx<$TeUhBsi@)uI4F zy!|e6nK;Vm(Ue%6TO8YbdoSIl(|tM*11s4OqFOCGiw!i~tyjn=9w1$w?Yu6vF)WN? zVKGPOa+e- zMafO-pd14IG3g3tI^f#^rF_&*F|Co%t6m=-mPo?rZ+a?){(StSCF+1{nU9w z7EtJ`?KbqJwPYpQHxXOa@K(l{Pj3ctC<5V!SWk^twdBZ!c*ZyItARiu8bSL@|5SyxZW4JSkq~b0(5JUnx_7U`Pzg9AD|r(o@v@MRZaNcp8y^ zkURSQ5<`n)rAp+a8y4V{z-Z<+tecw6Kil^vzSGFS(^0cA@Cp#z0bs3c3d<|uVG{xg z-~_ymU2%Zg@3qZKi%>LlJ0h~N7(j=*q{IqE&5vyl64#w}-rbUF#Qs#40aMA?6u$jWcXN;gD3 z000{fm7RbCDh?rvl}g7)WpnH+ig?QNGiSgFJZn6Btmt4x1)|5n#jtA7;^Q*OEMZm;!zib4%oG1WiB}Q_dLRQN#KDwNVvBMgDVH%uB+gsG6BSa( zQtVv}0Mze?~zkIf_0L{#rC-yEJ=}qzW%!^5<5ZK;nG@3ji2*y;~r0Cwv}(K zP`}h$kW29`H$wqM-kB^g=SwMkeZNPzQ1XB`wgU}O%qUQ#4BCo3xG%H8^m7ZS4pb1eR0)&JHFFPxoj5+%<%s zr|y8-G^PNuBUYBxwU5C!5Gz{1bl(Shm@TsZ%!Sp+Bm+yv3}U)tm=N)eq(3knvHgP_ zjP6Ak{E@Z#s{>RBiD`?aUJk%=Nu}A{4}b;M*mZIh0l=MV5f&;WScT&64VZ$iH4q{TDNpU|(ubcl+pf12g>|5Fln9LgHXB~^j>2>gG zJDH;a_3|#f4`1*({x0~T|2sCFn$PjMLD{juymf}o3D)?D#LxEk3_w_Ioe_TzaVGYG z2EtmAY?lj|pU8T&nYZ9?xL%@dL*HSSZ+i1}@-Y1h2 zBo1E|d797ya$Hax1@Efr!RQ_j!u`v?QAGnrApbM=dHJu~Xech4S(iUxu!tWY6%_ys58Idcls{(-2qzf9T_D^LwO|-&X;S)NcS3yB zo~fNpWAVq~Xi2;Tj7mxshmQJyTR;%5DA&DBuBEUnxzH`siasy`1ODvSpRJ!u>oFG@ z*9e~j94}BLZMmi^WZd0cOOZC{0w zLRr)Z@KN3^JYWX%OoZV8l9;5bV9aP8dFt{k;hJKrbAd>jtE--B?v~N`=FGmWt?+CA z=*%gPtQ%YF_ij{}PI}ok*!6xVSYb74&(q_${d_WhXAdS_ELDwfd-(^s^<4Qd>3*xt zdGmc3rQ_W6vpxV0L9A;XwXZqLdq?7tPDBsGp~ybvU>n))bT`MmBkp>>*H%|>fv@a` zb!8jomdcnx=+tZ- zb~s@etwT=H+dlC1spAWz^6^hp?c#iiDH9*$7BV*Q1`*pzPF@q^lbKK|Gr#RN#NO{4 z+{oQ2ivGij=Ic$SH7hw?@N3HKl#0an6%zdYs8ZAczwMO;ucP~ed<>|Aam8zMjmX(9 zmy@4{HCdidR!Ia41B23rnTO#u;*E}Wkohs6SvxZTOFrdf;`LOtmUfhMx`v57pzftw!fVd!S zFhdB1fB=$=>}*y~F!q{oxGe^-#DJM4c1o=nLrl)Woq1QipS#B++>eQ*UM=_RYn%Voq ze5+>m$_y2)GP=eMDzY^F!^EZew%0j0pLOalI@y)!L%B=R1^Ok{WeW4WXUQ}-U|h`@ z_AX`2ZR&(we4|``3GCahvjhp;|mxE0E1I_(>iBPBu>ToQygPsA)`mU*c(MB z|K>3}pt(`oCB$jaT=BLz+x|F`I#&8sTn=u|D0t0rg70^se<1Z){JFD@LF+x(h@&VD zP35pcAL-JzUQk#sBpS{?%fF^rkGzQ7QTjVZfS5^HCJ}`cKGB3VmjrDu?cN>8T0(d+K@fTcfC&sPWdn;8aXBrQK>Pu@aIPnUDVM~BgOIfK!-;nBRq70#1V*X^c;b>j zUhnWojKf`<2!pju{RZ%p9Et@opcLP;FdD+O_F{ea295C0W2uWv5WDom_)Bme6MVH` zXm^ux9k0~5%sJCt`lOaXG&Xxgh?Zr&Q*=LE!pVZPhQDM!uSk^6*{Q=pH9i(?r7P4Noxn@u3 ztdp%?}m452HjW{h0$In9@$lV=%B}J;|$|mkj8sxzXN(8hcAXEKgXu1%0hQaq* zXrjoImdQyg)C)1T;hgvz*7d)eP@j=4ond7r*NPaO0sGe|h)OIBKwa^M>64Po^4Eu90t4QE zF)~|yAZyX>o%^Za6u~=GyfZ9SCSUt&NOga8!{471D1%C-&wXG2cJ@xf=8G=8G0rE1 z{wz|}Yh0#%{~dt%tJmcsA)Z-Hjd6IbcnPOk(I|YJqL@}@PFD_#5eJ5s752?w=AkXjt+0vnmXUp=CR`&<&I7z>&N8hQC^Tan+Ti{Xr5r&fu)@Jr>g zrv~D)8%xJu6Cy8^skf_GqxCd*f@CU`P_avfB9)0&Z1zNn#n(TuNLpeM+U2O`K2({X z;lMp{_N7+KWql+`0WeO$AyoAIb$VmSD|cNoThJx3Gg!U+qL<0_&DRmmmqCu7z?=40 zdCsdU`=uopWp{DSN>VC}hQr+j=K`U!_D*%7G?jPuqVTuc3-7Pa?-hWE4Tlpt+0@J_bRW7J440fhv3_LU%tZoT-~T zNT^-$+9nH-i~{6-bHReYiz=gm!Z(%OldHr}9J#I5z`jo2$NbcpK zB2H{~-!E0C!AVNIkZJ4}o%t9-b+5IN@~d=nATnSrr=h)3}GtUz@*w$Ewrzn4>wh+kY8Yy4H!QW?&|&!s8FiX)ar&6?Oj$a?DFd z0C;!<-K%$!9=f1_T_NWvg7{A|%0in!S(+>1sQe;iF-kxdQQ>1ccSzlS&R<_8^dHh% zJYe4xR{j7JfBv`wephWKG5W9Gz7F@Zs{+42l$sT(tNOnAZOp6IDsTmLzJ^Mgu0x(i zzZyc`zYb{pSA+kb*9UX}2q&N_J|0dr!vgQ@qq1>z&@kGTR45Z>WZjE1)cg?gW#x2H z&1*&yt3_yL!sCYP`Mu_5YPNANwM5@tPapl_JM`50_1oHC=5n`QH9(Z8vNFQRn@i0L zhPIrF3l^81VyroQ1MO%OyJ@8CyI=S+YRbN51=W?=$LpL92bS_?L8s#jTkzVZbcHXfE5=NQcF zZJLhwM&v+q+dwzg@D|vJ%%A^dzoPO}JhHx)e`INF_JScD9GnG;urVo5{M8^|K0p@5Hyb3GPk!4#Oys3?dTF=tFN-sA}3i%66-XqW^&`cwZ5;}A4-k2pNA7uCr8(^ zO4-cN+#WleuCVRo#A2#2ET%qb`tjDH{;X%H*Y1p*(U$ws#alW~2-Pnk zlyGaibw3V$-Cg`>YCGQ%ZT0@U{degxQX+pb=* z@kN-7D`*N+cHkl97}iquZNF*z@4qr_RHul;8)W~i&`uczA&NwtS)nI zG{0=D{Ciy{zdOe5R~iXo;!#l+JrgiDJ+Y$6UJA&(qDSR2e z-~gb98V5$0kN7_-$SrG}SE%&V1*Ht6FA|fO4 zWIRSPx8>keviTqYv)Yz^GEUGAb7hhmhhT^%RT6_jO%I3qve@0Gcn#}vhYn=ElhQ?&nX;zX{u0E^wvP4lE1akzV^%*PEXoCzZ2jWm~`HW<~46SSXw# zJbbj)s_EUmz?{#-=WZZS?2@t1xqSb=ZXqm+mm8XEESHRl5vDA>e-;aa1Hjcm8a`1x zRxe0-CrH#Ah%nbGmeHlui^ogt1Wk73?Wy?$v{HI~j?6TUXC(Dv;C0@`!gCdi9{LWL zehc{V2Y(VGtA$VdA#hQ2;LQ4U;L$GX(_8!7KpE&rm0KTngpZ?WkjqI7?zxT@AonB7 znMqD@^FxUm+%^ga1tNwT2Dzn#jGP34laz+F6^P*s73mEIZh?Bn3&-3!qX-AZjgZy7 zS+h}(6coRvjab%Ts?dVB4CTCCT_4sy(lUQLsO<3RvBCK*vmmTdH1`=mt5c<ljF46PG9%J`JvRWg#gP^rAF$SigGO z$MUzkWu|uPb=EQ&k;o#^zUq@3+txt%#3npG{@PSG+l3(ZkOYcUg#HeWboeji{wKu! z=M`!;577Ahpv@7f@<(PE*+mMms85>d6yx$J4S^nRMd4lWHV}95SM8l&ZOlPZ3PY`N&>_5cVCne9 zs`r#didqq7ZDKM?%Vf^w8VI#|9H!aR9>YB0p7#u2tXvbrj#^}G7N-HZf2_;6 zUI~@vlq4H!>lUpsMpn?t#&hn+Wm2&n2W?eNg9Q54LS8|#p%%NhSJ^nGn*J*0U0TwU ziuTi02(^Ot<8$aM;!_3yk=1}+Zu$=DxWj;r#i)j!LrZVgj9Nmuo->PjK9U5AArP|{ zqc@O?Rw;UpRFj;D=HDAZjh9`{I%;pkmi$Aw74CJ>TeWtaq%2qYZW^@ zncwULk0dIto9Dt=&3xmV{joJlouHNK1#YWRZi!36^vckSE6BZ&LAlG-F;ysCqBfht z<19sMRvRz>s}Vg>trqDaPn$byacG^Dpjc#isFy|!PEz`6lHo~*VsV^Bmy?pOU}~9B z_zf5afGO%E88~k8WOj8S)nxx}%RyxR4|3#J4{-2y)~m~^Qf5}P(D=cUg|A<#D?tCv({tS-=f|!MH_fq;dwM9v7(A!~192}VxHppTIg*(X z04r4!>=G?qHod6ZPx*`lhT7gfdgrnBL|TTxxI!o%SN{t+sI|@iIe=yWI5+~2x3lN~ z)o}^orCWmA_hI7M!m432d8pzSs4U^w833R_nfZX2~rndRQ<$g#`sFD zo;I5ko^=J|mR|)sYn{Aat38g@b^?Q!DDqz)bQ9wr-fYC^_c~P}HF($BoT0X{U)ioY zJ0Bz}|Jn&*uG@Xz8w4tK@>0vQ%RJ}Na>olPs3Bo%{9)u#X#Ex=z^YME6ZHk5h-aQr z8xQ%sf+Hy*Fw%<1NV{ZSCf$rK_wf8u?-LXI;@J~pKw4Vq82`B?vBwK zm~Y2)xS=B1=xQ*UFnaN(J%24!LH2R>3x{2krJt5nKbz68^>gkPrAn9HX`FRplv*d8*}d1_^HhM8kxvq=%9w+-?!oMm4o_-o(*>4 z{~#BZavKIuVYzzsj@!b^vBucGeDwWmj=FYi7*Z^aV+gdr3sGWP90}3R_6d%MQ*GD& zgF-B#fsPm%{_e8)LTELVvQdWRwFPxLIYg{>WQ+d8fYGX3v}O?cuu^<0Y`WE97`m=; z^>7KfQvX#5d8oNG0_4CQI*505xuBt^8xcpDbERtx{_+wNYaTi)R1ZVTff zkGUR@wZrr3M%j|M5~-Qzpa{F-DTCqeRua#p?ry)9@F9#VC;p)LK~iEBYtBZV(cLpi zW4>N?_r<8;h^f@k`#OlbT)z5!>X!}mUPT1=FkYx4N%r(1mYu`(@#Dki&6@jEGzA*W z&TkfksZ(qpGC2HP$OaVF4*$knf2FUw+_*h;YcKMFt(0Df1%QYwdYx`wG6U*#-Q zAVZWK7cZVsqpV&y6ax(&hR=q{O0+5eTtCm9kxI%qFtGzaVgpgD>~jwU%uu5wMm{N8 zxbJ1(OiAPFQ(FK0BgjSGiUERaV&_5bhcy{3$}u8PM9cZw5A7wo*>{MN-%eUDv#~eM zPy8;@;4@P}r)+vVP2S~`mY%_nqz)_ckxIEN5-(y^g;8OZ>yGZ=Nd+PTx%(EVX7u4V zgTXj~8t=TZ9Bkg4C`E59vW_DFW@kG7 z658NJ`}p4WsV@u}34Hm1qX;k?x^p#K#%apwpoue$&HjTqaUh!0LJeO%vknt6-!i@w zmbhyw`?LDSc@qxDAdjXbIZ_y)1SO3S1sD;l7(zq7Wk-xpoCWKpfFmrt zV5A2cf1pR1&Zn~S-4962PvC!7hA9VDw6|{=W0FDGrgtHVZ;cu)kP@;vBdIckCeFRi91Hw>$+uaic(^dklma+}}wKUgu_Wm>FXQLR4l&RP@ z{;2ZJa6(k`t-2rIK8>uGds}N$ea>}kyyrs7(odK&t@%{A*KSbhXlb#>tTzu$HT=(* z`W=!Bak=c!v;5x+Pv$*c`uM}_006gCoCOt-A`F1$X4LRvAqz)Wsn8cjvUZwSjgeR* zCMPya7-r%b$Gnnicq+$ujm|k?FyawgfjiA+;jZVQK1H8LGC@-&b;R;lf}$a?6L0UZ zf_1dyHgH5f>t`s-gO5UJ7Vn-s;~N>|k0Ub#a&wgR^oZ{9>T<5hvb(f9zyzah6C*9D z&j5q`CC?oCRHnr;$f2?(lg6X^f83(CL1A}1yau93^Wn|$AUiRMm`W*hcLpLt*dy`t zl}#9&!O7asH5(=6E{EWDqAYSN!AYs~l0%Y75u!az_N6SMxU$`3N4j)v*7c3iVmmKg z&7qClKaH+*tS$yO4clbf2JY0wr#FW?$L0Uwp}+i=2EbG4ZiQN#0n|^B`_JkC*v_t= z*BodUa!?1%`}+OT;0M_<05LxQq;0qw9yZ1BiZQ3kV=-KC#6ET{W*88lcyCr53rt>o z0&-JOP%23WEb-xdEL) zY^W_Hzi8~Os1ow(`W#+;XMM0cNu4ZpLd#E$1c!@^S-O)43^C$qO!UI_hSv2IkIPb&fnpj|6Z-;^7dWNAFJ|MQrRmk1U!L-@EGInj}lFB1)cDhV4WN_Y!Eh#}f_G?tm!7tML zf0VsrbR|*SExMDAZQFLzv2EMv*tYF-Y}>YN8=a0iPRHIS{hl+%_kDNVanHEx&)&6v zRn?xgYCUt!XHKreRqhc9rr4?UAu;O|bu!B;wOkeb(iT1ic1OiEzQ*b0_aP~E+ddj@ z3w97TcXK13mQWhz@u^QZvpUYT`4OYm9o(++4P*@a6vjfp_YPX1B=m7-_ z1As=S~(M=i`?#tOUstW6`V4A|}CRmZO{RPO2I=A48oH8hiMVjb^Tc z+#rWBNruuSFXfo9kNm{G>9#$e>p?DbRmd@6^{ppRT26cWHOF3R|n`D|pT+h%17CEJMa7*_?a9yqGq&a|pTlsN$_|@AgdO@!Jyhr;u3w8>?6~DPZw^)qt zzbS#O{A#=R#J0U?oh|)6h+R~^A-SVf(B{g~l|e1Cfir!kY^9<*T-@wRu5U=P!3I+X zWhzdDwY!!rt_a{ovoiq*CJZkV!$v~`K&8@}21oS8DQPTe?(h7DwF>?iwVYFDly%RRbm3%ca?$AET1jGkp3|@0{eJb=@ZXE|&A2rH+{JwPJYM9+ z#C)^Hh{+B;)?MxLtHG<6+L|wz!w^wW{dD(^CUI=fA-V37*xc!WM_)o}I%%;XjM-+; zl>m6Y>5op%^!&v;BXAc~4zbi7TJQKjY5}{I=#_Pxw)(0dYexRmDE|!<)p!#W^DzgI z6f7VGK$`U#WI7*}re)6petttSj2Z_sM4rfitK1UmQ|H(=QtirUJTb`upW>VO3k8lD zC4V0VS_8BFbu#lhO!btk->Pn0RFKadx; zkY+$OaHTXpEPdF4!J(o-BOX&6D9`@gv(ZDnyp()yqer^U z)iHVWzFu4Q9PNLYrf8_cFOWP>9M!(%_Ndi_GhndRTj~I~KKjA0zZa78nqy=Cv3K6+ zEqn&lZHOwWA#$*ai6|CSzVvL84oDmhP~jXBon~Wdu@|Ib7FVh)eui z8ls5RhL>*AC@ee{HlDzneEz$F%Mg!3nHn}9t)iXBYgR?x`6u^3$dz=C0>Bz{*1Q#X zo*iVo5siNPqk=nXUG^XjR2P2b|3*Gr0ZX!Q3?A1w2Tmd*FhHr2)dR5H&>{dNmES4! z#L2KjWc3!;qbgg~y+}a(wq=lneTNbr7|br^z%IlEW3KQ^tWzNvtEb9h&}K=zlo5Kr zE4=fV2>jM_10Zdl^x~4vWNni!iLIH8;Xhuq_-{p{m?&3PpV1uj-P=5JW&&WF1pkPj zjvg?{DAz*`2sRHhA>klkVPImx!4R(xDUz!P2r1=*b(cbXi=8F{rGV>|r3wu(4k(Cs zNCf#c{B6qOj+iB;x8IP_sze;J+%lxykST$wkQ4{ra3BS;8H-5hCn#FBUOzZ_1qeV+ zlhY$k(xvud?&)h03_vok()hcd@^N{`R!XkSoT|emOYO(y>wT)DEOuvE>tIZp)o_ksXQ&?Sk8sC|$RDQMaUeSPslJGmS~^wlzr{v>Xr$ZdU&;iPwr zH<2bKDg6mj-g{U^w8h}%8p%)#UoDAuN8H-G^0K(poSoj+SS@==v*AoJ57+_oY-C83 z42Ja0>1`N$13MS%EKsa4>4+Rg68|p_Jt`8e-Z>zNtuE^+2x089SKCa@p<*f3aLS)a7*VhX0d-_+fG0!F11q07T zy(9sEKtYsKAq7M%z^93NbTvmi^-4A<|2Zm^u_MKdql`H?&<6=(3Ml!GB1}YtHv$Px z8iks8pN?qbUhUoTddjUqA_oUP#?$%E1(Tm0Ep6v&Fhohtj(v1a4S}!agCufo+aagn z1=05=_re81}Y62UYhKEdpdh2AMHl_5L@#z8@Y1)6ycOo zDAJCr{(3?wl9^zswVU#(J5Fm0&h8lk+RI{2%7w(FRA0^SYKXWtfrag+I`qj%OLO^o zg4GUcbEfa~a}im|&@nGp4^6FApUGHh=QOdYt-w!*ImD;yzK2U+VE1OwAv~=8-mi`E zEJefwDH={-K1e1qHu}<&?eViy_R(VZ5kbo`&*+{P8{$96rKEpl+c4{@S@Noua<<;;$vR|xK&aTLz5S^YkpR9;J346L;*TLDSbLeNnlnaKoiMOma z&7}YGL1M#any3!VbG5^>aFKVFC`@i#Y|AVXp zwEq5T_RX?$APo!-<3?LeVM>I743v-wQU!x!%q2(gMi*>l{5{n%BH+XawMClSTE-V? z3}pSDV^$-WkJRvXzp%e6e;6Xx#9EG@8E~9pr50A6thYH@-wsU{^6^+5(6HV);mSNo?#QEK&1vgZJY<9yXvv; zP9cSxETab&5Z{O9YWY_8bk=klkXxy4S($|_aWyFDzO~$O9sjx}ZbBN~|ILzKv{?Rn zwUWJBt&82ItN^>Bla-=B0v`cQD(m1VR;d!CwHyGr?7On+u5%Rp>r|c(5Z@qD#}17K z-F#9@bp6P-von_Ot~iTa{L!*H^G(;)<*|pF z@n<9_2`)uoC4yPkUlE~-6lobK1*l{;T|;@YE4#&c&R$CGI;*oFk0W{{YdRmgyR~WH zj=s(6$5j0&OKohG;C}h|ufzCI3j8bE-SMyaqloV94-Pf!$tXm{etsel_4Ta^v2Mc?#J5{~y zE|QztB={U2S$YA6uER@clr_VAr0+9Sulvm*<-EA6>a(hf=XIOAz$5gmDc9`Ak~HA3 z^$}W04+zFSQ83Ato#7u!q>z+m3NRRXFfNYBPCOQTJVffaqTn_9pPE`gvY$RW7_9Jm z;kIzG;$<5@m0DsotGer$E|DRY_HX^@IHi|qm+ULoXR@u}Yje;s?pH~9-kVIu)iu&Q zMLfk@)QdB5=IrK7aoXuryPJ14qms*!m|@TZJIMQuPMn3zDuQ~>!;NTXZJYY4{h-GFao>&(gbyAOrX*Lw{HK~yfylk3*I;&|;>S=YR; zNvp$&`>zb^E52T&)aATnUz9h(z3-m|D#E4l5?yQfd9)?ug@zEl|-Aa+J zfcXw>h1eHvhdecR@BBf5u2yG89NkRi$F5dAfEIV}2Jur-ERS2`(O;>(Tdr=d!R=Qc zM(}GF=DUW+_}i?T@yeM8iiSW6WjV<}v4~#CXeM4QSYBN7neEaYowZc8#&e(V-V}_t zZE7w=C=1CATUpeWjBn+TTCs;2gbcMa5cr|MjWS+byOqZHG34~T-76j*Uqr6emRok3 zEMT7uHI1zc{(rc;|MT(e%q{PJbMp1){_nwo$%Kmy50BAVK z(U3s{h|uhYgpHs&AbL1psi%n_j?JoT%BI1BL#*HEP!2;Na-VYiZYfNVny2L;k{hkW8xkpeX+m-n*VK{N1h-!XY=s!BUT0YD=70&t6Lz$OOc(l*1`5H1+|1l-otsv2gY&?P|0Nl$yFk#dy9@p0$au;ypyEIA; z5SG+>z&&nE-cB#H;mEPH z4>+v6)Bi9oC{tmiv94X(ZwKOXABHFwooO=5)c!R^p&CG-%+}6c9D35nDs(lB8UeXAE7IQ2n7yay0H)lC?tSD8JrB30pr^UrWmG z1`K~QtPUMJ6`r1?vPF1WU)(d5oEr8H>)_d>uI#l-7YPDS5e_Y4W;Qz?T1y!9!rGP# zXNC^;&6Pw*0*kFs8i5TJM{8nFFX9JtdWQ!aY~8WMB53IK9b8tqfe5}qQK^ZI5jb~_ z2a|8RC;k~tw!qU;lmM+A3Nt2g~9qsU2-Lihpw= z-LvmkgW&SNR39@F5!#b(V4$}tV)lwu#2oxcDmJ-=zSJbxI2xRe=b~0_w>)j$zh7x& zlBmZVa)7rgk=t|mV7E=yZF?poK%T3fG>wRK?(2_%_c?JLz}fgNkK4XsAuv;i(^63mpB;?d?@;{^MZtNk+6Pk>@by@rT$q>M>-*ZE zgn9Z~q-PQi(n|lko7by@wO^EmpDz}-}&^(Z`QTYazE?)8WNmVkO6fL+= zF^q*kUoGl{qMDW8r{HJtd2%IPbR#x`+}9ecwZd5DHv>lF17aRhTdhC%%EeYp(eVcy zQ|u9z)Io^^A2%^sObU+P*+Q2FR&)P;?&<{Y}DKl>CoJQ&f{1 zM?NSZZj_9^5{YS#(|3`d(Iq|Hd->R)=Y7e$6GzTp00=y@h4KA?7{@LAdtC7hLQ1Mt z)SXUQLQYBB0$R}-1_I60uD<+8QF))IFgT)t3Z*lw$T>U5KkV-j<&AXgaqBc~>T6d~t zNV@RqyPR?pELC}1bzYL#IQ>W$TYlY2Q*=AqqTVxQZYS!gRpQ@;mPtS4d=_cjtsLUzTL0wc zLU(J)7)UW&|CP1(A##f0r>`RJQjW6Tl&=ulyG*S3OeZ1`q3!hRYx~oem;?9y3~fe9 z1SAPpC^v99lyPn=!YX6aSNvJ#G8MfaCvRD!5K zhPNX?Pzq2u2^zpO2t{r=1>)1C_<=uwWe6=>C_t=9!&ww6oR*D?L^$1Beg7*u+kY8p zPR7{c(n>t?&s4}DJgwf+5+UlI{!=eIa5}Z@703~%VEMha#}5HR0yZXM`tQ(m)gr|F z)pU6r$IqYdNcW7O5$Q2xw})w$=B?01S7+Uu zj-S)T+N;LMxDq?VQE7(!)9Agn>LVnTtvXX~M1n@i5foHVclnIz>JO0;43E~#sFPrf z!%{34Qpo(5Ec>FpqGybFieh|yq!5zvO)DbH)h#57R!kh77}$6EpfDOoz{JaQ$(c|9 z5drukGzI=dCXKf4eP!`1*pLsJIyCAvdiF;F2ZtFIGzJs;Li+x@88j(QiU3VjcB5wA zAA+eg5xO8tBP24ec01p-Cwah+7z}{T?PwkkZ252w`QTE4br1J%=F#4ystu+gLP=D* za`uUsMhHFh%Gcee$4?*Wb4s3=XFDlD*AKW48%%BR4BM zu7)~)?>?LrWv!Dlvl=-)5s|ELs{Yw0%lT3^-rwu_^3}_QezN#2_i|A-fndJ zPgUU;mbBs$7u9`7Yq%p=evVqhAp!aU02-!k zXMJ`8WC}?sBwbvJtlyY;v5vRb?w{ZX4p@W^Z`R}_u{b6qOMJJrlQMd&NyXaDBzlNLcAs1Lh*Af46T&hmPl!D5@Y5WJd3Ep=A_^zJ1 zHJyFFJ*+pQQIJ38k)ss-KI1?&{W*I`$}>ifDE(JW9u(uDt{avVc`nm3R|HVs?sxhn z0~Rq48%>0+6r`(!djgm0Il^wzLN)9CJFxxGH~3OtoDbjs=Vttz60_sXe24zIs4q9G zZ^c)1LEgcr1P~hgjE3~T-m_{Dl*WQ2-?DT?0|yPM*)$oSSBX&8nI>c^GtiQ|BfyZS zP7-T|9oAR?5(DemlrW7>IX@(mKP;JywObX&?mW5Ac z0yCpIW5?d6PDMBhgFU-f71{%eJY|Z#0zZM{cj%ZmXMEB~D8Eg=9I~dL!yL?2gl$tQ z5+;9Fgi(PQW3jI=PzQ1pYi!Yr9-fGe_DWOn|Inss_o&R1b9r0-AzhE|FBi<^eaG9elDm%q)3k{nZbc&R7 z%RT}#%XGJfO|t&l~Lsgm_R-x`x*0 z-h_OGtr#_~Dm8qL14T8~AHf7luPOzg!x`~R(F{lDzBT357MJMoN=o7}9~WbZF6Mi7 zq9c%lzuV~YdF_`EK4xv>M7d;v4CAK{>9@gZo}<}%E1flcpM5#Tt)E;hl#u@oWB-Hl z{oe;D<4cMOxNTQfpLS7>qwLSGkiI7-2a1Gr0jeiB%nO#)eXzU6GB;7?%yCA$yja2S z%@Wy@D*Y2YIkZYt;KBh{bo9UaX{X9t2uDuuv?s$TT8&bd&K(q1OOzHY5Zqt5z*lW2 zkBGUP_B4joR@b|5aj4_oObpcPi>D6r3~bgrjg~D?P1N2#-@1p3@4EkLRey3h-kEz( z+ZxNhe;nubggej!hqS#W9jzm>T9~t!=Xgl?^l_uDHjLx2EB&96o~^}8ZGH)+UN<$` z$uAiU5|0Rrm#Qcb{75RBqnh2EVz(uC$3Ky4;=4iYoHt`sDQQeIRkHp8si3}+|LB$= zjCWph1ezMLsX5{+)F=mZmstH^Mc=CkBmd$X9wfst-}UkrLvUx*0k#TH`~W<`#UfQ4 z&L*mqKTSK02VlvoKV+A7+Re&^HMn7!B}UzJ5EfLk4mRM0vfDx$Wk+HEoK>?(XqVu| z<*ublDs@MA8f6vabx$05(VgRrZK;KvQLLYSUaqQdrL!Gc?{jaJ z+WRitnyyS00n^i&mnOMu8cU_-9M%F1VqWsH#p)A)>c#Dh)4_cjZ3Y}scb(xGy+H?I zTQ|{(^Nx=mq?9_$GYDeSVmY+UCIOQ~eVnr1y;CIM z*T#~9ndipex-2yG;cF{!$xO^T&R$X#ZzrK}AS$YCPMy!l*fi!ULtFj`Wz;$t)*A!hkX z(QQxq`f3?Njo76KjcEGuKd7#ovR{oYZ)%OhuE;DL&&g>aJ;TOVtXhR4>c=a4EkD`4Ot4>C zf!k18;dwbmx5%l-5E9%6xX<=%PW9;;oeuGiH9gINxKo`p0I0~W-1{bq;oS1^$Z_?o zKsA=(J`pYLuPCCkQ4~z<^q>DA7flHa0MFJ_J7+Yxagd4nFdRu&k9F2-Necj(CqDP9 zuLn#dK*`v6C-XLEo+H+GY>?Xbm2*fXXH4$e+6%mU#lAfDUYakt_uO0ZORJSFDOta@ z4oSrye^#}pZh$o$PpeHFxe&fC%mobfP|<{{At52LX_+HIGd(C1gF%QBWh<@^X1qM_ zo5f=&BG8ua9#H8^Yu85^M^IpdLex!l>*O<4;AEyqKI;Doff+`KVRD2PA{1PM-*CZk zWhaM?sxH#7Mz(@{@MZVV4U4>pSWgo*bc47Q(iAm1m1#k{q$jIgw(@S^#E%?W948ox z*d}_sq)qH&(uK!~nCk8R;Ojf~>_V6t{@4sZa&}p@5khB96-rj_^eLlJcBUFWRzW&M zCXa6EvgNk3tL9UtN1NGlGu$vqL=?LEO+}+td(eY;IF#@%a;Gpfdm+H=ew55{`zMDC zZByiy%8v_ishyRvn1=Uu_|)DhmnY8W{YydnU*jt3KF-eDIhhq`_obKp&lo@3F78X& zw8o@k0e}Ijr=UuaK$rr4G2tPAMn`4CL1lokP+(IKgcMBZ_d`*#ga?co$|{RPCF$P5 z%3TRQhEU!9LCL2hIj@u;z%zol0DaTEe9XU;-;Vq8aI;b#&3|aRKT{D7EC=y*omH9d zSAtkzL63r8eOx{HPQ3C+{gI=S8kWM%T6R zXkl>UV{(jkn3wP3MX}J4ffHyp&O)#2t|kv8wZ>kdfoi|IISXEZ5IszMyG@B8RbvZb zaZxO1(f;zH!VohLDWgcEn%o-#Z69{W5}D z3}xd84^@TQt|g1W5d@=B-zY#quR*AULn=$|pms}*Q(haX5|PjTGA3L=GA<@X*@3HiX=7Z1w4m)wQXv1r^uw5ao7apLGZ!FD(s-*-; z@?qzf&%f6nW1E;-k6iIf@9buusk%L|vLF>omBWuo35iV_+`($*O>o|H1`0qV9>^6{=hEyu!w2I*?t5RdT>&4U0&umVVIC}tYEq%N914NyUeM1Nfgys^Oj}S zi2sXZWp@*`GyYUTA8U;U@blhF8N`)CD6sXnBGwTB202|fO$nXcO}iO9XrWO57c=ck zT~6EiI3`wwLQlOuoXwkxjn7n~$%pyMSJdG)+{IpSNNXebrZ1gUsTihN5v zpk?JQT|Ccq1{o6IJkt=6Lljf9mEIs+jh~+be%imH|9>s*NXR8ZS;6s=B&0%8BeaBP zmgoUD*nS*8U!d^%Q4vV;YMOENHWK?4$flY43%tfqS+e{1pe+la?zbm4is+;V8*v33 zN=i$Qfw@GnboT+jraHI%k7IU7X)mN1!Ow`)s`aPPsk**1#HPAo1gq|=txwKnj*-Vw z%nGE|j-S}heHI#R9k;;?!d$vwU1M+RwC&jDaIo1H2JBuYKzD8Jm40S}4VV;(+Az}) z989cycss+>PYUiwiNndElPrYNUb9d*WuTB-8+q9<(2LJe&dAKv?rqnz5EOVA7mc-4 z9LGGvoV9%fa`ei*y91XwHwaeq(S9ldK*S_Zzph{*L^2|Q8nWahdJ@Yv>LqmCQIKvF z3M8(?63g0_b_;6pNHB_BBoZyg7Ziz{zW}qGdjCaKt!7S=z{40aFw+!n$40il)&)QG z*htPe%D^eGZp!=!vuiGTl)YT-_+sHJA_$Jkl{=aY7R*&!S%LmE#yqZda=T|3nb=q( zYc;od2fpNB;=n4`F@${JG}C|0DkrMvZM9p^`her3rRr9$NvJ1@YGV0jT{igrQ3eC# z@ppST;z&txZj)zmX!}On*7@_)?k_gCE;G>2J23m};quVgpA0|{|DyX>t2%P^7pcn2!CSsB@ds<#Bq>a(Y3%dnu8y-diQ9ZV7Q&82cJ zT;OhD{+v9X-NO#N`*|{36MZ&eP6!IO@-f>vT9f^r8@uF*cSKeT6c-nfkK!K!VX5bc zIIItJ&VlUHEusG|?GFUrNhm!n; zB@zcj`;!)YQb5@##Yzod>+^@y7@C*P>1Vd+?hO4f-)osJ*e>*|@4!{G*Fj{ef|G-p>+eUvw3WbG z0Vm^9Q;?b5Osq0W-IYB!)o!yVbGIWw5u3c@QVK+SC#vt(%bar&VymYEkf<1lKf4S8oS|yw#bGWAH+%;JsP7Zo;4HVv8un| zixYmUv^#-4?aX3kTi`!9eWRa2H={bUTSC(_mpRF7AH%!5^3#7L3=(Ci(gvilrt50dZcBxG#kSdm(iq&Vy}Gal&G@Tyeh zv!Wc=GX+QhIr>#HUKCJb`j=#wV3C+g-N6tP3&jKnd^~;TAl7f-EKaPvpe_l9csOjd z!d;+4{qt;EasWkc)ry}nU6^;py{YYN#Y6q4rFo~K_f8Buw(dvrtbf-&GxC<&b9c8= zC2LF%CTx3S-?c;AQg#zN7G-E2wZKJgM0&_mEA-Bw!&bjjHwCxQXOt&_iYSuE;toWEAx?rncoH)wi@`iJ9oXpNY)S(&JSA? z0D0RY(S#8k;z1VSIS;F;1cH1~gFA(w=~3jOsPdbJgq zYpT&c9ifrA5P>)81OzRxQjL^|)ii*U=ul9$$YL-6IfMI>TsA^nb1^U&lHx~kI5X%k zv(ReG=o$BNm442IvwT!+9c+(aZLd8IS2hqy#;2n>`;w}hXC=?m&(`|M$mQr|sUJJV z@o-s_gAE%d{e_dPKd1$$+mb^4F!ZfaQ98;jMT%&}VT>m%f!aFW{Hq;dO)d6sG2byW z##%1?JhmDH*!kX1fXm%yoS3YAA|^e>sVcm*wf?CEEMIv3f?S8w69CHJZ1L0D5b#{B z&G*&dWtvN9`H~HQVZc1=V@?17?_5~gek*jCOx~Ep0dHSSTx^XDXw&-5a#n~8z^JWjNPDjb;_A;2-GOp{W%?^1(OLqhXmc^=nMd8(;_*u{~Fj(|T3#U2jh3 z=D6=i*CAE3jk^2eJ=!xy=JZkH5D!uc?zk(5n(8g+M ztTQ{(1PJ{9a|ryfJ<#b{^;y{`A{m4uGDH&0$NTEl`5HopRSwz~{Rsga#*-?X$k9_O z33C;H__yMEFT@TUA~nfDiSfre4U9DqM8AASsV%?`**0a+r?u2m-+53b z;bkWXX@GE>?n}EV5>(blRI|JOfBWL*oPjxep0x)W*BfWTStnkOO(5~^pJ8$yP06$M zgA21;Pf_`-vdQMNTA+>w%LEEWAa;fBj4-NJNvTJ{-_6kn2)tNG8MsdvteM~`w5#^G z+PdZ0IP!B>#U_^Da7Ryp%A=7b-e$$NX$`*m^|UpjAuHC}HrIpE_%al2-HSGl&l;JG zHKfK~OE|Na3MkJHGpA2EKYZ=6N8a0KSo7|l{z0yjSO@^FVya_r_6xvU6rFdH4L~QJ zGN5B}7ots|?FobagQ)B^{IF`DV+U_K)=KhHV3qLunspQNIgdHdXYcpRwi=O*{Wj975nAu zw)Isp0@oS;B#U!^F&KhnVj|)FJup<`B2jaSqZz&WiH@S2ktnSf_QqkLOpYzbv$lxO z5?MqMzBRZnXx$3Qi4fakO^Q}@7e1#ABax7V)$EDKr4}yNl|>V0G}bEtrg?z?v3r$YoB!UPOXR|3x%61gO`|ZBm=IW>KTlNrCy8xkrYao z@s&Zge=%({>gnn_o9M&AQ^R2R4vIr$VnGHVA_n9)cw~EYLPW1yG%Vw0sY3TSQR9GrHLu>*cm+d#il(mjD9G7KJ4=jfEk< zD}M*0@sasZlvcD5`4+b}iBv6Uv`hc?SIV=Uy(Ml6yUA-@U;C^yG?$RMGh|b)7_1cr zr9Tk{UOkX8S#x+%sdaR=ILiNiX74kE>obh2KbiU-G-Iz zeZ*&TZx5B$xTw-9hc9bm&Q>?^OhpS!iS44@Cv%&-t3LvRej|UQ``AKQ^}5LaZ&tr&8S8x>^MOP1(r$--Oto92&DkL(Ms7jw0<4-mwL= zh8(kMKE{1L+?t+{9NtKH7qy0f&MXw|ShE%eR7257V}tepB&I6G3`5J5s2WF-p|3}L zEF>ZrdMo?x2|K$*w?huPhS+B&l6cQ+Zfqiq#MYruY~uG)-^vde3L{f;k|a9;B{7%g zN?Lx(Ycp4U>EqSmBXXHRj-R3(ZE_wX)Z&#ooNs-%%<(UoQAyTk)dSRNXe0z!451!P zwG`2n`xzMK2CEx4dSt=vu)ARLap6mJaMRTD5#Dl{5X z%gs+BghjVR+Ec6|Hxd_YJMiYC)<3nn4x2~Bjo{FHfe3ku`}-3v^cM$l+mP&z48-xtbB4e zxm5JF9CLga9LbV`wafhA3dn_3npk@)wnGZ`pB)w+9=v<;*}Beuu;71HL?KCH}Qz)}FYfi!=kvmo41xA{5iwI7yDzx$=Yks?Srw z$+2d7V1u!+Vg)`gcl_?!fG4CM|K?*g?a#tsyb~z=>3}a&O`-(20{00Q;k}V$CS(phau-!8;hG z;_9w((PJIyj#V)bUQoWepIxKYQ&$M9bo(lr>oA%1Ic5Gn?K(p@x}r-b%0UVFbqe8H z0kg>*48$7z$C*`Ix~pa<=UYKIBay{gPWK}5--LaQO6;K6e~8EiSsr4=UTn#;iE(3X z=)~PL+I;`T9p4tWV8I)$6}uJoj*rZ15iHA2_`Z7kN1E7xYRK;;uFQH8@EmFP@_qjL zgI6=3Z$ZiHzbf5Ic=f_qVjL%JR#)8bqU|StiRn3&3y{cRdpg!+)nG zyEA3x)rc6@qt!QYRc}UNqJw9$bI#D04v9sLlfJD`GK$h-+52i~%#1^P8afi#k=?hh zlQb?6!m4nY$3q{p8`M$Bt8UVy(^1afmznfh*4QZ?F@T2Sd|HQ|PNB~b7l5X;$_gTT zF9$^8)Wg6_pXxoz3TxO_{QR}U8$HN{V!{*Nq4L*|h=`FEu&bGMpkAG3GbkqIkR#nZ zNS1wqQC+q2abQGWhKU*oF-t$wp&YCHd#3M5D}I5SI)yEx1CrA<{-F(cc~7V^CgDywiW);ngS_vnq@+$M9AEWV1R`U^W#r7Xboi^E zM=X**kyb7K8rhv|V~SkBr^?CU2?mD)cVfHuwtN`Vp#@i~XY<$}{V;eFzkDk~kv2;k zm;KIc+asCP&QEugz&5AVbC4OrvoUBD3M?cOZfr1*(n-1q9JiuBlADG+>rcg0GOzbx;3oYpyQ-hx6z3LikYp! z1@GVeI>IWphtzf5=hklJUPmr9d6^dDoOZi>tZP=Zd9C1csj&pcZcMhKumZaU7daj-2^{X9{KI@ky5im@u>4rK1kb1n zV>~c8O+-{Gvs-BoV+vN9l=#S@MjoHLBU*p7l*w0SHC^dKOgt}ao8snLKk)IPM6zl> zvh+u-miDfV>`wV*6-0@f+ul{f?ovu}SjP&e9W z=$!?Ci|Kyt>I($8N5e82h59S&*_u={-JSL_(7J}CS~6NAO(nA2#0FF$VgLq4W+{@t zB97CYFU__ICKKO23{vOZ$76~w8cJ<1?X6jy38P;9w>~RZl!B`p_5A(63~kHvyXtz8 znKdCWk!Du@K~6|VTc{p1>(g|ejNH>n@RkaTUe+gBh>$)Z0%9K#{88|cpRmx--G;8Zz$w-Zt9_lT%*r3ckkh@A;~-TF$6rt3;8uE+XX8`u1lX zS8#4Se#X2+{7_>uJ9wg~f??!LoDKK8CpN2?U)?@nM;|uKg-wY@%bGkex~V9ut}x3> z9SBX7pj0g~j88|QseGSb|{ zdymW{2Fl^XRZkfX5=2OGJncqT;S`%?Jq56amlSnGA61p8Ur$Xi^p_L(=p-s#Dc^D1 zR==Wx9Y#3nYl!Q_ekvaM+a=mrmd(};_tF<@C(~A*$ybPjixQ7;eKoeg@iO%XnlPIUC{y~mK z=OX~zTzB;xQTN8>JhRh?G97cnR)XHhaiV~}>i#Zu{a>X zmK_dhcRC9GJvu#EJQtw`S0GZv)?~=Y&$gwF7Oc4~E^HnFU+L;q%b5oS;08b2Fx434 zO6c;Sq1gYASq=;Upfip(j>>2G2@Ay<#Ke@Z>nH;WGL|43EK641FPQ)pFAGmPB{>HX zUr2_aUcM_fo5uvI#D8Tqkk22gBu^u0(HeJ)B|8UeH#;23>WU*d%?1M+2l>U2a!fG1 zfAv0iEH5var|w*}`Lko~Oj4nIQ~m3EEJDGfU9_uhj4J&rfH8EEA>+~UMXSke_4TFX zlr+S;OX?&V+IsK(LG6KXwAk0r#U>rBdR1VB=!i94eaM>kv~J5wC^-&{gf0!L}fzBGby(X(&0NLjzME-vprk`Z;3uMd#fcs-a2L(PgzS z-8~p65mdh4BCtau7O6ZtRy^)0Ms%hy2)UMZ`M>$+GVsAZM_d{u!|3ivfgSGMP)Jd+ z(_yiD4PlRr3ZIozg$@&<;p-2Cu_CdXVWbTTHMP8oUykkS(UG>s780uLCxK!SLp=@< zRfk$!j?ieJDYvXpQpf%2b8UCVI!~ew%(iWmn`7YCQW(?S4J|U5tIzeLjBVon%qLHJ zlAcy9uHf(0e0utr^7kqq8^+b5o97^&J_1g_s7iPe*{WLrAi+k*t)Sz4+qOGrbR#O> zqZbJ@8$#dc;?4d+&VKo8mRr+ZX!6v#F`vSjF(UU-ez7&E?y;3BthV6`Ni}4QEm<>e zZj@8haedBhFXMkydNDX@&3fiLM&G>#u5?2tdj)D9pIC!w| z6)Pf3(VD;P`U(UZBoYsf^u}ALJ&;2`$&^>)RAee@7|I$*!uB`(JK; z%e1W(%K4n(vDR_Odh_Z!Ef`?v{#nFSf9p2(b%VuMcqZNhg@4(3DfP?2JX@6EA@_^C zaQs4I>bn>~*|z?sDlPn3YyOy%pd-KNT|6%IpX6LxA(>!ly@h!siy2cnT@1nEa$PYG zsr#BhsBg8lfAa&Oau5g5cSF_c;ACBN?1bS!;9w6zb#6dTiL%?|B+=lo8pwf?0Z@}-hSKE2Q9+4(5RJ4#*SO1K?o^PW z{@UWsOst|ZJ6}ydSBB~BNb|L9ky37+)^P_?@@M_5xmnYkoLqfwCl*96k8i>BNk4N; zJ7-`0*igZ~s+qey_CzB0Gc{mSLaE7JtfdVDZf=wH z>{FIcf*fV7G*l0A1v=o*64r&Pr*)*e#FP1F{`xWZy94{pdKYcxjvvV5^=$J*$$e7l zFc~_61FSu_Tw1~n;}4So;I}9V80PPn{jBdk^)4>jt5DX2Hku96jTu$2#}>bF4jPxM zhX3ad{ol`RxKV>AmhX3U0WR%c(1j2{4FMvx90hwJGuy1q!U?*S-rQs@)Va8_cyO@J zSi`3)CO7|F)ST3xG#r-{S|+P@jkwu|vZyI0@hhQH=^=Vi(SDUku!+`6dsh)Zf(n(g-8>EX8ek+|f<0sd>|B zjE-)9ii2L5)8}jo)c6A&10K$$b_nw}bK45GBiwSU5^jfko(^CBUD1{*82qyb@*<9u z3q14R11opKI{;}ia`7F~-!;xmWDlw8(=Op#w&wz%gflO|WDS5R^Jy@6dEcKs?0Q{W zi=pQ=TZY73A|57iG6cjNRbs{E>?LMIB8gh(CQ7E&EM5`{fD&DSLIa7XPq}DP2a_0a zzoNoi3r1Z>zvxTSx%rEl!g5pBG1I$q!t%O{jxM_d4(-EAS=uSA8{6pRq*)j{eM5VZ zJ5N+AM{`_(iJjZJ6lN%0|K7qC_hWK0Xi%Hu86K`BAj`MdzM-7T(A|KCc0kKUVO;;v zt|)rk+WhWDNP5dquQ5FXUSz>L*kr0Yf!U8nCIkS|Z;gDHvYpciKV0o)GyjoW=goW*Xjq^a@+lH<(R67GA%gkF@j80~x z&*iKfjb+?_l7BxvJO4L>`oCjytOes**u%Z)KUW3htvB#7%hxa<6cCYGiV_<7%U3N3 z^$Q^OnWEp;0IhH5`AWkne>q>^Y1Er>w0)dg-xTF)Qplv`>&m?TAzMG{j5q8I6<>&t zk5B5k?~g+!$Tu4LDWAzbnHwRQ$tMp;>x7L{n?Zx*QfYy9QQk__6U7rng83%ag&@z5 z!t&5JzS!~+$_&d2i{$LP-$wb9j{0i34aVc9WT_W&#n@IyC3LFA)@VDk-KtbBQx$O{ zY1Lo!IU0xC?PDAbu86x6`gQStKfN@2rnkh)nm39FQE_-rYmOJ^k!($e%yucwvU94b z(@K&-DVK4}%AQ<1>Hr8A;sHTEG2Yu98VxPl(X2eEmOUOHm+f;(j)%XmBwSSd7t3AP z8vOB^(bZfFw{uAO_(6M zvgYOJ+A7yg+Qtz%*T3dVWLSJ@b)G9GP$e-0Mw0(Q;vp%!RX)y{yVm9DH~Ica(A$hM zU9Kr+zPvuQC4ogW8D0@3(`wk9(t0~bC&=#f1pLCw1U_7HitwX{qmKM?DWoGEeZXN) zqGQ1qm`xEwug^>%$3lS)RD%i5sMwp&zI~!hA8%5{oz6-YO&DYze74_h-#D^U;nWUX zOVDowQaiIq6ZeO#MjiCLX>H)mmEEo*nvVTikYN5~rFbS*ExB!DVWX}<IcmHLxkN9UF|h=?3Vim4JYvEws%cB}o#P~o z!hEoY<;Gp2T8jI@rOSi#e&3&4z)6|3e0fF%7Ji^y4ny?&m5S(HafEoKVQRU($CfbO zpFbv;zq*&-T7Y%|*d>~lU~tFUY6bV#bX}4(9Vj@WwQBZ1gWqPc2!E=73WHIl(|^@| zFlo^_myMB7?&O=B*Ka~aK6du~`oe|d_CYMtWEYg5yl8IeoRs8p_~qS~yQzIJ!|=b+ zHWCR%0N4|AO;aQ?HkHE{L$k3MTw@4$hoeDc1pC4lJ51;3Cbz>U5R2Mi_oOGLMa1yC@d^hxVRQGajMv%G*kKF^~mi4igG3AsO6N+Tx!YlBE#lQCzk`sgVd@xasqe&5|x zf8TE9LE~Hfd%pHf8VJ^PHc$a?Pcv-`ZM6FuhY@6nS#3>8!kKXNT}Bsn)*U82wdC*i z==f@j0#GTb#l@3u&e#(AOc;(;+;rL#M_I;N1=iHX`K?o%=1~Mx<0zCDTwLXg>0pk3 z5>%tF95EK@=Bt_gE;ilN^3#2dE4Y430iUr+)|=>q+un0ttDVhUyW?#V0Z~h$P^pLe zbc|ZC-=Z;@V4q=VFhW8zbc++{JA&-p#))10gi2jSThdPZ>` z5^I@a;PMq@+kA$!)}rRcXw%($}orpkw$1`3Q_aety141 zK&}B8^I;twhST<-QN|Sk#X;O$QDu4m@LY{;oQZzvgvw~~l?iI8LQG!gk9VAYpSTea zh&oDA{_Qs&hBGo`yEYs&?wY|sQ%9dEWc}Ub(i(vvE=9ufaJjH@VI_{r3YVH31C0nk zsRkF;R7KJqm#d)U4+e`i+Z>+SoZ$u7MN)&`i#B85KCHg}RR%5XvwZ8htbK2&NaR%w zV85nq`T5Lw&TH=TPRf7$YKp-;Fn%~8Ao}d{?J0hr^F(tU#dN94R_nfPs|Rcdjy)@Y zM4q9oo4VK60uEK(#I0(vjZ%*1(CiVRrfj~+Z{2C`4Qio`LA6ry7z#Ax1}V|d%R8X+ zSOMG-)0L5xm1F@uF1kcibjm}!#7i;Du~BPUAsJ5C(F5S`;-sX%?Ttb63$y#|uAK5U zX$;I0e_BqIGKk8##FF)2)Y{CRb8N>C8Yh`3%^b$wx8HjT4f)dW->qb2o@wESqLqG$ zqncuwNih;4i&87AVd1fH^dZ15LE{Pz6JWK#Tf!4AfTq@(1C0RAP&386F)Yl;tW+`@ zXy(RBpk|&8_+T;^{@!ICdegxN*4w`MtP~*ar(u*sb@2*{NB{NKrAG4)#>b>9=_5A0 zNR{V=V>DIPgw7NZle}|yuRcX;O=|WoHjk7$TX$EbE4}SE`YfUmG)B&0Om{WSpa7s;N5kx5u%pX>tV_y*}I$e z01u{uxarohm8EQfW=Vqz-G=i%%DCCu|LmcV5B{$s{PyT2LgXG22>y4(-5_NL9H#zh zdoMp!D>t%2EJB43tl~iK5Bc-wm7q0uBnvS{KKF1IM+^kLVP1U$Bd%>L1`5OsJW2?| z68k}?PfCRpwC!P}Mqw)akczp0{mKq)mo5W`1cD~vC$?tWcOKOE`Egy(n?zk@Ed7ww zZw#n2`8=oW9tc&*ayMMP3iwtu^ zPP9y2vAKLMn!YQDcZ|6b8KE@C-mJ4^m?unLrB)x`w*!;o-n=0rsu$6F7AgegTMARI zUanE&XJZ>zO|GdyY|g`Ug^%fq>uPk4!OKYcfH(2De)>c^p~lWNK_bTht@=(a{jHyaCn%2fgdcfPs0XtRqI@seO0DSix zM6+5J8^u!^#Q>q`*!=1m2E+()&15GzG1mHyvv?UFm#lUxM@L{p{*xRXc5)y*rq!CI z@eV-Xvs}UjDik)mrQ-z+)~GbjnQ}xK<}xl<-zOKHc|IO@ker>_Bel*ro6DeUCSy;B)I>Y`-Nvn!?}tTD1{%)g z>UR!c*0rX^5mR*)-q~1q%)w65KsJ~+p%hSv3RNs7YUgzwuCI-0tR6p6R}R8)4%NLU zqN~I;dVCKZq!vhRk)P~?M+|AK&$%a${XA4Pj_Yy+1M3A!M{(GD({<5#-qCew?2W9y0I7y zE?z4b%}uE=%P@28d1Nd_Rp&lSe^>mNTfMYBCtyjFuhzl8@R~kc&{B%v{zqC{Qm!i~ z+0_EAe^yhq&m@S$xQq;Www-w-xO&K(g;`RLXB)GmdF08@#Pqjl;zCdwsRYl}5h_EF ztxikg&vPm8=~-US_pKlvYs|5LfK!WY@Qwd>(|W01Ks$AD0;M*Q`VXl{i6V8>jsW<$TWyJIa!0^PW}GzLIs6 z9I5GM4;86~+BQ1(uoG?_rVb=-`XeKU=un%JB`}m*?*EgVAWSa+j=@OF6obp@li5p; z5VRW}T8VLu;B+q$0gK>Y+zNhG6yJLN1wcjB@4ircq3tJfH9agugeYes8uJ@*6@n_f zLF4(BROTQO>;lL6+CyKe4LTw{@*J2|5Ufc z!4QaL(r*B22M(;K542!o?_Ab^!4h-RjIk}XXiBD-yA_rVw@Pg=;FcG}pS|Lj;cGfG*usTODW-(LU#`*`%$c#QM&yA*tV33pl-RIY*jVz+k>QADOh z4nTR|_UfxQhl`=@*a?5IQWn*w{!el`y!QaOYRe^63^@~XTgaf12!{`UQZ#EIdqxIJ zbxSy&S96V_NS_suGHRr5s7mMyZY!oq_C#ndbxB@sY#oot&8(wpG}?fxf5w8&nfQF7h)FY8>=hq~A&^UAw5DyazicCfF1qC`ddTqak83e-jBEj2> zMFprsyQ|cWPi|X}BQ_5u1V$x$sD`b&lSh`^+`#TrqM=SB$zWs^RXr^xh-!Nq82nJQ zt`X(wk$7M`HQ3wts}uFk@l{+Z&g;GP$y2Pw;{%2~J9O0i>6blj()<(|ei410a&`PZ zkw$}w^3wK;Iz1;J*cU8rQ{$WIKseU`3)cVuWHCQ!TXL2GfokaAs~0Ls!;2~nJaj%B zUtjC~d<-IpUHbD+a=eX?!SDe6Ibu(f8zWmC$m4^JI*qHce50q>Jj+>2D4DbSKyhIy zDR+8E2rU(yuc^I;I4uS3$6J^yy+>xnJ|4@@YF3LuMUP&R)!w)Di z8#>Wn^u~|E&0i2b)x=Qt)KL)mzMo?0sk2S6L=tcmqEbo73C$uKI0H+@y!AgEQF~6PV}k1Ty!(8_pqc2 zXnPOWxMOP^`oZa6>}a(a$OeVSe8OQ5%$9B7+?WBlW+nmOH=l32s z;4mYyZ?)q4vEk`QSLfZdten~O5p#%atFq>OzMHFu@#_U3MH zv7MP78HxA;AM8;=OB=Z(aR}W`KTD94uQ;z>&We)%F0 zggo_;;zxW0JW!>&M*D;^3#N)2$5$dYS~-y5VoKI-Z(2EyMr1H_dy}l%9GmRc_%r$4 z9cJju25Z>=LBWAm13>Hk{M$#7Yc7!h4J8cyQ%qG-p%|HL5@ zt$SWt=EvvodT05JTYQ1oqe_ns<8WA6IZAI>l7`MD+8ageOXh6ff(eZuT2cEy$1)S~ zTluY??W>mkKWvU{cX>W9{{>$YT0Mf#ES^@-=pP@J|5|7WcSm^Rui3&Ti*?1sSs3Re;s>7N8^H(*VzY_SUkra+MeZ#p{FDWDQO6kU9Z0mv;wipyxbGe4e>Ljti2| zC#Mt?K>Zq;mtQDe030vx$39_%Qhc#U-CiR2902+yh&{NHUW%`a8tI?pB1)bDXviHT4#msLASyIb@tf+pdS*zibSL^Z$ThEXTF62JoOY5%o3$f zm?^#JqW(9+5aA27g8i)J-Pe zEVTki*{gEUpwsI!?AmiYSMFsmi~KLrqz^T>x^-pCxa*mZ>s}`(f(fGVBb6GHt$~=%a8H;KA$zUr0;+W=6?*gMt|x(N&(lbiPCqvTG@UK36Cx>7zJO3j%@t2bpj0$$ zD6r)hU;?b5<|+Viq)h?w{PB@mNMk}YTolk>c|q04Dvs4I4lLgKkN+gMCGi#s534)( zN!!%P`2^zo4UWbgbym43^MUHAt>z9*=idsACKXZ6Nu4Ht_HvZl@Cn$UItrwDOX1VV zGR`UUo&4gm62?)c{4@IwAXrNYnkSxw<`nfq zWyASkCi<&1d0ma$u{}CrZriWD_AqS!!wO^BCdO8VyLj3y5LutjZ8Cw| zj^oyZJ=KulT|mYsr{ZB15?$&A%VZYnb6{oW91q!#vykGfHadOniBe%P50PvVumV66 z1*xw(h*84QOaPsLrjZg;X^3N!5t6MEhLVW@i6O=0pd?NDDfE(5H>4XRzAwdkhdzj3 z7#Q0H6pwh5cWh#ALjR=6q?12d2xQThEv zd@2i1x?B=03|hzzsKNLF6lEPOV2BogdLYtfRKgBD7FxBfA2P!;`{&Sf%z>2kpY)aG zyu4jJW4v|DBOKJj9A#>S9D|yfE6Xy{yuL0}y3G%A*v(>dbXT<^RLIqcZsi!*-$t9G z+Ii_Z-rSw5Lm^cr_ND&C97+n_oH1^)Q02x<6$iI~m(uW^H`^d^-b%$NB(^A7uy`y7 zb@Hj5{aZvsqC_?{2Wn0*Tj6=)*L0d~C<<9Acmkf>)EeucU$#dSwHz^Lk{o#;c}oMX=mYfOE=HOb5MSX0F&fJT$1-uf z5o@t}CNJ=P<2aw*lE~M7D|Rha1;iFkcd_rG_TYHkahOmr&CI(wex(t)pZ4sD0#+9Z zc)W!O^GVn_^KHE4zP_jn{4b&X<}U&{Pko-M0ng3J{u)Z(B|qUQW2Dw`bJOIBjY`zs z#hFp(D5EMCVn@MWOC88Ms10k6YepRg8F84ABM;q*($J-jNlzt))Z_xuA~B^gMI*UF zd%1eWVEy8KSa-kbI!aBE>W6o1xm60t8Q82jFIF?Ma?(?z)pit?Z5i@gdcCz*(rjDOJX{e)6du4y%+jt7Sb z2rlmQRG&wOv1>3A#BbF!9ws_yGW;o6^9?=>K!DYnqYcjRkfzpqHg2Jc??{?W92I72 zgdyxf_4%p%+^-AiiJHc(mFa3Ml}zH0N2NQ`k&?v1#^hs)Q$d8nV3@Bec3{#pQ6@Zc zG!S9`MC{4Z+a!lXoYGxya+Z|_q4+^lK1mcd{s#)41EmAtQ1#XWAXR;t&uf<#Kmg8S zgk=r22NYxCrBFEairQWTc25^$9`A=0M(@8Omi*vQ>yIM=;zw9K ziP0&_8N;AR97-A+#Z(8yH*isbG#I>k^1rh$|C9Em{p7ApiCJQeIVy>MG7B7HX+}o> zs^x{421=b%{{$yS^v7ezy?l1-K0+OvCCNmWBa7rp1>z5d0&0L>qzu4jb!Aae z3Dkt=qDOt;E(J|qm5=E%~wRr zvS9#g_f`U=a0hNXN%6zv;Mk9=;5)JElSKQHW`)AmD^A@emO~BfJ`GS`Pvt5dOqDFV zOI)}JTK?9gAWLsT^u0DOoo|`H<6I zp7BeAY))t*A%(V?rlNQfV<7DB|E4L~!jA>QVVG(AFmRnHQa^*O!-cW^Qp{^g-HJSN zY~8}~e!$k#$19DRf8~ghL7x@g%bPS%R1^wEgbjt`)OM0Oi!36$F0&d;j7~t8;mZICr%L*8UT9`l)B8hq!+@@b$j;GFa;A#lZX}Tljl`Aan z#0dWK5a(g0C6Dlwm=!jw@]yA2ZT7T{8ccxV*S&!G~>N=^&<6oLGUlnHIeBz$! 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℘p001uwT7uLyP#D919SySp{yJBxpU&^XDAn4Jp((^+rK5y-%(MIdXc|Bs>wCd{g&$FSehdM) z64FQT-&&eHVbmI`s~MeAqz{6o<%fcT5*0N8A;H;-BfeTm(7G3kc`YH3Bms0;)5M&{ zV3i~}wQAAoWWR}EdZx7%`H;i&wc;CsuwnPV^UNvCD}FVkjuwp7Pzf8#psvYPnXn@- zsf#H6K=kN}CVP-TnULPl6+^?pFs0=-`c!Xj<=FnIrNRhLmFCfFOzZH$m#nBht;d@0 z&2YLqket9?+k5cc`F(8g{dGIN&R%yOn?|4pQE)vFa+1y;i*uc1 zrilOPp=*}D1tB&^tzSZlf`=3c31@x*a2A8@-_nDiFyd-?noIx~4b|piAOvzy=o|%# z`}doo(K7o96r-BD0c~=%5t|>!F0j!*SmhXKa6_bW@v3Qn1jFMhsW<{i$!MvdjbHff zeroi35?DSTNleb6MgcQeh$AKLiH=pq4d{)SAjE^DnMs51K=Au{(D#7)WcOBo4 zcOOEHM8GTlQH!{6(RDcBw_-OQ&%$?=wLa{66!<;iT z7Ufvx1|K^-wo-p}n*4Y|p~fSWT2Ie(j6(c%E!x3I71fTRHp(BZ`Q?lsZDrJyU<@B6 zX`7*W`k7&J`VZq~4WGLT0u|rg%-j5N`{!D^L96fa226rG;I)BIJ;J@4bsq*=B3ASD z8Ept5R5)TsbvJKVJ45b^j029SqvAw#^EjG@QhXxi>onm3YPr|!AgI}tJv5^AC9Y~1 zlTO)xNVxIlL*+BXJ{c@Aq}uD75dQKwvyeoh9GKiUPKp028!BGX2=lw>a=Mw`b^P|X ztj;IJ+vVD{$=j5v!)f`X&bYm*#!gmUzK|cZVyq;}+SS3H_O{v6^?iOXoue0?^@~ex z)CN)yb%%lY6E(HkuU%)2+XKz|ELnU{iTq#utooO0z34xA-EDh$6)GrI1fJ<|cR$It zAdS7?MELtCFL6$@!$1SgCD>Nhvjf_AYVv0cuAOrN% zC|zfb4Ku6<7QVh;hbc-?qMJxgE!uNmJ_oiJf?uWsqLetPZKA?8rPMj0oT+kVE6*>X zfY3v9clex8?KG+ws=TW6h)BTr-@HR(GlnQAoMu4rp$cNS)Dx?)5vm>~$D%TSRO87i zM*fcGF+Pwt;eosT9fMI|FGG4|O;il~RWiEW8f;s<`p;0}%E(f;iEV!`9m_7>E1(r( zr2_^Dy?GxBA{kp=>`HLXAsRb=+^|(3s2p?x!W3JV^CZcTJ)E5=o;2*#Ha@$0X=LnG zGKfagYXc&qTuFc;%G)lH#Ogb0@cN+<}+^BN5KNCUavZ zlHiA#>3FRITXq@cdD5t3q;N9_TFzYyVrR`IzR*wUweT`MDR$qfc!DMGx{~bHA(}2= zFoYfd|5|@l4n%14UI?2T3;=r6OFuAxm?k!9MyWLENXf2H39U03$!i=9_V`Qgx=!=mILpTomc(9XP+A19hOtC z&R`-uy)D=&qbZldaWdVZ;6a^EhWPpR-QBWzaN_U7EX(wGLxME_Am?fI2tZtj+W6uO z0>mNP)z7p6aQjOg-y#4|c!{;(rXYY}rt+tBu2@IT4br>zD3}LD1AV;)gM(bj)kcTC zzb*5Q&6S@fHhotA680J#W-Tnx9M)SQlS#;naP9gYRNh+WXB&cLe8<-n38(qG8??$q z?haRHYYTil(T1k$-3~TrpB@OyJcNCoA_!c5KdkIzz}Y%$yCY|8`&q6}&X`_|6PBx# z_A)R6Pp1(a0QiP4Z`ug^S*+HgE|w=5H~QIrl3b>fXzrD0@Y@|C+CnL)Wi^s`|X!Bf7SQ4#g3uD+Zd%-wlRCQpI9?qCk zR&IMUR7@Kq^cKi$XAsu;anx9`yKVLivy-B}l2cpGG3SdPKY3C1lZ}yAea6Pm;OnBF zVX-jemxOZgl4|U}Jip&4m1l0}CQ?AXEK6~uM( zW8T>F<|Z1qu3wzhB=MfsuT3`J+S*3*Ag$I*jO1GzSE-dTpT6#O`Ukl{;=v$btIpO7 zoRp|4Mb3B2BP*=pOvi`xAUeoAMDCVrz&TUXb|EdUq_iucjV<*|>%x}vKvmzpXC4nN z{+D=9Qwg{gL)n2v#Qeh#84uhh>jw4PW@?REEhI#Ku_AM9isr9ZSH5F(eSG}jz!#B3 z2sQCQ4?xeXsXz6J@&wy{PSHGY*(ozs6)TPs{c$n|Xe=J2l#Xy902G;mo*)y%03l@f zlptv8ED$}Vq)MtRXb+lG0KFI!5af!bK3|)G2u%roWvSOtKzf6UC|&@Y)gE*{^c<3cE1K;LACq2O|6CQ!|txAcF;)$34X z`^G3~gXpqw;N)|pCFwKa2qea7yAw{=RdIjCAej>RXQymOb6Tn34@~I@#Hx7Fgu zt7rc`Gq!K`=l)Y;t7Q*va1VSCfkNOK)&?`e*0EX2|ocl z^D_fgFI`T^0*D9&5M_T{_a*5PypCk7%9YdrL6gHld-MYni#Mi2#58E}UDTnnmo9Wh z*S$Zs?`6acHOSNzPo8QbU+)%_1A@t-^zXeh&4wrik(y1%)!eH~4a|_m6nDneCK9@Z z+RizL*6VyJz9y8Yg#Y<|3#^R}5OAiA_!y}drL3ef%t+3Hl-z!dX+dLTeas(E7Q)GE zb}zCeqwjU6(aIb^YwImQn7(*O68eS?@mB zerB5JMP;P9aVme}%PwX7eK3pk3qxTTFWb>DQEtFpWd5dN_erEpE-@RCvFAr!Hx-!M zgap06Urt`;-*x8i=KuYskhSmfhML73bMB;(;o0~1-CTIYwcP%%RM@Y48eupev1>0%4!kz*>elDKg$Cmz1X< z6$Z6Hl+wR5a*bXzQ0*(EY7)9;h`L~Fyxg4(SZ9Z|b=Nm*cis2P?^oWhSAl``#&6E; z@9zY+-aPk#%MW0d=UpkTaNk&eM_Vk)nNSncQ}2WWEP4&;q$%HEW;mzt=J3xSK$ILy zWQcxMR;c>rp6#y^POUrL+HjfL0whz@I!5!&BPMl1Uwv*$U{;Zqu~Uz?A0S73i0qQL zACsN^;6F=#+&(n37+~u+Hd-I&^m5J7^Y-0ut~1)b?!e=pkyGRm2EZ~}>;yvQjL1vK zUqJ?VVYwPRpR-}h0b&^i87WzJa>s5GZyu3PQ7&Bkc+_xVH zKMjuAXZN$jH^Fksgwu$o^L+npFP=zY5T~;JK6+yX$#v+dhvTzhSYonSn&d#6H~H}R zd3fLDIwZS4JS$@c@;RPZ{+W0e`CFky0|wI^#^Ln+%+KD2pI|cNCmkT z(>xl$S5=m@&G>C4L}EUu7P${>y;V``n%V{<@yzn=XogY)1UcEgEe!;O7IGi9<=tA^ zr}QOj=1x%Ceruq@!fsKVwKavb>=|MR}D0cirCODi(6QgI;f;wrFvP(VmN<} zxz%tsga_t;--Xkg@T^A7y_2X%9Qz-_Nx7|ew#N2FE1cGk{V8oNDsKNAIXEAC%{bSZ z3+$ahLc>~h(#G1Si~3L0oi)zJXIlQo{o8EzKUAViUjx=K_U^oqRN&`7m!a9rqS!*Q z&3F8fGWobNY}Fr8KT0(p|JMmNs?{V(lHaaKY-sBUNb3rlg?#a5+);3bhQoUj@n-x8 zhQ3=3d>d%5F!VaMPaZ*PD`Uq+5*y>l!mkeL&!WRTi^4`tr7!vix!J3be~r^y0T9TE zkJx{#!vWCFQ5bah1wn1#)chg621Jd)fBkkuNJxxNoJ0YO0h}n2PF6-_ zf)F$r`_>B@c|e65tu5*wE|c=;N7f!u>(oYqDu`8ueh~vS# zqL0;es~Npo7D4=UHF5N_tGA^)*D`SYW+h=+(m|dIM=i_h0hLSEEvB~{O@TOSq^0-r zrpGPIF`r2q25Q*34@QH)1C^n&nI$_xua$$xi+P=7qKpqeM&jz#n9uOlOpn5CTdJgy zQSvAcFA{w;w+!v|eelm4`2Alt>%VnE$Eee}b9edw8ndIH1f#~fM5=CI zMyCKs(-f@uETqEqdfegxrBn`*`Gf@4Fxgb9F|Gp2SesctYI0)ClDy0Gm+21hcZ?+} zqk1GNtR2nD8?z7BcTMa*@9JM?M)_oXM*#k(}Fz z@86tno2@)A-nS6aBfTvxtZY-_M8(X8#3K2>x=9UmwCf|)GHFiQsCV)`TGeJU!{qD2 zSJUGp+fAe~bAu3JOhD;L5k)DWvX!!8`YoTGN!)xj6gA0-^N?P2#E3Q0MMD<}?)( zEo5ri!^I0DWMIZy^)C!+hYPgpFeOUcJjto(LL*uRU_>%g#WFLAE$zs}#y#-csbGeN zyzIM4cX(%H@E}&uM4Y-JoNO?4t;6ym{+4T8(oSLWUe6(>k`Im7w?9$@`7zW7&|~4E z=ksfyxR_zn>^^DFk;FFM)jiL@j&g(98dYfT)M~7q_YmEe%vc`sD~U+-w^3R$ig^zW z4y6xq>!sIpBFB9nV}wkMW1>MMXm102X-6vn41 z*CWcGn4#&GHHsGl3lzeJj-GUR8O=xj0S3ZD$__HHvgUfxx=BU_`d~RHAv{|-hWy~p z@?CBf&sH!PjWwfK8pklEYynVi-y&zp%sp8bjzgED8RQWiMx2F_#A|{;DOhEC*dY2_ zl@@gtiaLB80H{@KfQf}JMXhRq(Omn4h3TK{vic8l-XC)Tu-qow|E!$6`IdKO9e@%u zR|jI{pt14KL?EFYiUl@#kmpzGv`M!u(qvA(Dc6jCSR<^->C7A|(d#p%WG<_&RM3H% z8oy3SK(+r`#li~K=BnC@{;FGIMOz0!sQ&gi8 za6A5EqBjZOEYYgfZ1|JGRMhC9UH&T~VHk!-)Yq&6JNJZ0(}z+>MEg zxx8H}F5+V+iQD1z4i8mvwpVptWlko)!P=qf#g<{6R5dkQr(6G78g9)oO(di4B^E!T zWp8S>g5U>J(I}mFMj;GcsW;PW*&x9mJpf8FI;I>zX*F8AreNy)Ll zs6_Il-)cIYq3Nal%V>nqEORQUxdxKGSHmD9Ebmswp?WRzaG%?5~PVW&k>sYRluBj14XYc71x4(tWCX)SvFv0dMTb^oaEBlksPLQ?LWtw5AOv)bdJ({w+8_{LwmrpCIIXQ zNKr6^38q4>{ZsH2FwKFL>%}*7dXT0qVnx`Q_Ne|n!>)sHIFm=N;G;%iWZ?g}op-4N(lT7>4fxHR_A!^1RPPUoDWU45fA8-i^4CnpxdJY{+7e#Ku@vq)+Eh{|b>y}1Q+ z4V(Lc*`mKx|3qYYZj|B-TkE?0V(Xe2e-dc|iw795KMzwcOf&ul7(8+&r!rz$WrV{4 zPT7NN>Y8_lfs~rwsnW)x?IkcaVFCdBBvk?B(9+?SRZcD{T9676Hi{U6FFO~JthI!` zTh=LQvMc4p&sIJL>g`IcsD25%Po`9bZFz!;6gON0Jz>qtP0P)%LQJujKm1^{gxgkHWwW_brlyAPoqN z$GK-ufQGIrE}-6?0F0Of0ifs@tcRZeS-B7#ZGaS<`SuGPsl39_)_0)@ee5T9$A`!u zI*k;&4hTo$^0DkXyZ;)wh&eZke$&`#NGLwin5ZaZ>leuG+)7hPr7fDvbXcei=O5eYE|dO>)PHft zpC9F_(^h(Nc$D#eS?hEhUeP7!aK|%LIruzluvDNl`WHM~dqC6)R#&P0)Unoirg+)2 z_UFAlHo)qAyTP+(pz+UYDYL@rs(tOBj@YRMXtM50X~j_hRi0?&w4>XizGahPocM=O z?-U)Ja!t;kWi#cV>Qpc0qvhlIQfC*>I4A1%#(vWp|3^Y=#jL+;?R|k+U@8@-vuTJgnQ?;Cag0{{tW2ZHslpBdf&BJ8ZR`YP{o@-US%t@{lkEPgnOEJX zii4U8dRY+gAi`|UjiZt{JGW(QD(B9D?mu<8*`C-Sq@Jj?e@w9c$kgnNAOHt3(Ecqv z2$2kvArQg@bHh?$YyUx$Un|^ncMGoQ1oylDk6rus`kwMZ;e!`Qc}_ELH9PQs?~fMI zhEEb-cvpxZM$%Ozp-GMd(oD-)|CM7x4Sei_Hm-@vSVaCY4L21*Yt=YHPM8zNaw^IK z$Vv=*yCsQ)Fk$XPZa0p&s)Y&}=Thk_+T|MjW-Bvmeea3}A3Y-b0|&tobbwl=Q%W0a zacJlMaDWtWEwzrX{JW?uE4n=cV+%z7%t$Qf*1u@choi~!bBTj!Ha)2(6|;aW*^^Gf zzI#H>09yMP?2AI8P>g&>wYdFsw|~4rZdo^%MK;=$M~(=ChT)?_s_B;x>g%cce|syY z+C_R+{##U+&WH@@+&V-nUHf7)=iM3VS9$OwghU6vVIKhGE!G_GOD){aT}#k z_Zw@FDU=ru+RD^GLC&BKgn)S4^n}yZOP6W1kPSkvyAACSQaxZ1t7;19`5m zm%e-`Cf*2|r2a$-T+ChuB+s)_wQ1%D#G$YKxz0b&P>QH)vo)HyfL*CmwR9SA5#8}# zF49dtWBHW?k)S%bVvj+e>A7J|@Xhyk`Xo>9C>yDcg{!>~p|W2%lGZGo2MuO1s>QT* ztQiyEcjGCyZy!MYWYie{tQ_*QMG)}SbmIk)#7qas4@O5s!7KMb3oflvJ7hi7`)z<$-4+hsla4iik z#oeK}ySux)l;ZBL#odZK#ogVZcyTFGG?RY+zge?p9_BvWtlXz0YiFPHIp^$s;uSaD zg&@_wI#tc|h_D6;VOSMLZLVcqb~`yXm!q87EDJ2=4Z%`BWjNOE4<_Lh@9Wv6m(>c?GcsmGerCOBc` zec7z$vEjsQ2e7@c2+V;C#C92K71>_qG0@dGK^g~H%B=u5gwq!DM^w`KSevJW;)x#; zAt6%2_~$XCs812+sb;+ic4F0meWkZAjA_f=b#*FFF#Al!=lAQ#HE$Aa%j6X3HfZaT zWpj3Rr%cm}1Nz08osRrAqt^GGhR?63yWqzhMZu~^H}b1%1|j=xb*a$KmA zafKQ5`FL=l2y7igik?K(Ad+o}HB zLv8sv_9Z%`MbyUW$JbVLI^tXiJg7>&=Cp}@9((21IYMd* zn|KwhkHR-cQ|O4?&ZLRR1->uZucr*0CutHy4(>Bm3yn7}@{hQB^0}y1CFW&Ur18vu zwMpx8AX};0NKqMhWNjUnbE={3Z~6GF|JX5I>*q%9bY{`2q4j$JGiHx4R*IIIUcH^V z-SUK`^s=!^nr{3JyYtYMw?3V@ySnabyBgNd3 zPW?nQQDoYVgb*gir^AS2r{bt9l`jQt4c z6p)_>FAxwY3ae}!R0=PR7LKo!pyl!*r11dK>Edp4`hW@zk`h4-?`^8F?$4hou^tOF z%B-q!a2^(jYZHm~$u3BRo2%Q|@|Z7TlK(-)xxYtW9yQk^mug^}n^GA5-CbpV=H_!V zI<_E`GUZ3VIA;24oO{Y(>PTP&v_AiOOKQ{y5u_EJMuk!WEUzu*_It7pKUhI`ysn?P zGgG0V?(rfqmC1AgeS1?+8}bb1Q;r%bodY69biDjY58hKm)?o07W7IZP`Q2=>bD&uq zj#{I1K(6V8QHZdAblVABamk6)IopbU7&{ypcUSqxX4q5-Nd#c%my>z(Dnhm0Gdqbm zf8F|E@{aOeW(Ft~n`|(yI(8i9q)%1>hY3<)0UO=?4Kpdh=m8VHR{uopw7i;&wygZ1 z=SRhTafK7@+N|LL1y{Lhy}mNKht+5r{&{%ri!KF+}LLPWUPEjE20e}^A-@Fq=l+7rp>Z7U;4**uQw0d$I zV!-V9p#S2Z0tT-Z2_Unp`&f!`2hVRr#>p#lDd12Cx>3sEER=^s{R;WdUVXZ$CU!q|%jBaZQV(I~{ht z)k)k&xF@iQH4Z+dRwq~dpmucW8kl+V*Vz!VsmK_QjvdxjAHL*J#ayv0O3k@o!d!JT zbVuczXSlGKFj}OxxdRw0N4S8bzda*eg#;%DdS)_tTji?Y6_n*eynQ0 zpi;*RM;(KUoq zE~n0Y5hZocYRXK#n3keas+2GY*yE@#H4oJ_ZnIf$I&<~wcW%48mN&^Qj8JGvtDCJf zvqZh6b-DGf!@{1iru`y?&yJ`5C=2I11nd-TWFdg|e0&YYbz8-dR(Kv(xtN9Y7lD)r zHEB^G){76wN#FA+z(yD2Q4P6ULna zr$$?0>3&}?H#X?>xp9>-e?HbG&~KWyTw>(BAjOG?_~}1keih)zd2oF zSG3C{>tK}AN7D!Zz{1?>`H0g0L6LxS-BbKLopqAP!oj<{;+5^|Mdi zLn7O-Uj+}Q>;GcJ@Uh@A$ZBo1_EG7~Lr*xMeKUi>FO-neGE&os<0$uu%k;p^Fd=I% zl7m7>K^M)$Ngi0pW4l!xD_)ee7-dzebbtL+Y=#{pmHz8<&qd8a>eb1bCELb2Rg0HwF7-h(+3?8^jycSKY~Ti92VDS{3W_nzit^ zX!CYRgU-~|D<~{RYf?-ilQNe!-p9{8)*GvvP{L>4tdh-_;wao-{-E{(kaho{5>+MC zCcGGa-xg>sYaGTHjU3IOsQW!z;F9)riGo$^YhM8;QCqbNIWF`O>xc zZ(kezR=WevowpDEHvW(kpwD>EZBdg_ zn6Cl+?TC0B!x}T{2QUDx$|PdjJC|s^qzNjA;Xl#MYQ6qR6&7P*!Orb2oe|;~ z(?GotVO(PU;)2*e8uzB>D(dO0f%~{@?c5U+G|*IuiY{HE;t8WBPsh1n@SndfVFp(d z&wWQFDR;>5g{NC2^w2C{60mpKn~wsRM)<%_#t`E8Tcj7!am_E{Jeo7jLcd?ZnL$ex zRtORk+ct0L7TGm=tXQ+Cp+pw?U$XgsUXE|;a~g@S2VPW0{`Y)};qilwc-nz}dZl;t z54KA900|Hh0JdoNZygzd4iaw0Wq~gVPSTMooAjyXsV;J1R6;_GkT|lHTF&JWuhFL{ znZ}y$rP)bA{F7t1ry;Wo9}wwI(ds$EHdqaOEJ@nKGrV4c!C+^Qm|67avMZ|Km2FnB z74UIa7lkeR5BjI~y0IIXe;M&F#SYW6=Tn=m=jm^U|32KS+}bRbKeeDZyj5g`8Iipi zpi2kdG9!s!vX2CtmT9q%Jws=pd?TP4S4{5!7CQ@me@)LQ#*ftj1A8w)miXIRCnF;z zZTH5dac#gUmD<}+-0zG(lmkv$5Tc>ga!ao!QXO z@;lDD3UA%6HBF5y&%b=JHyPyA$?eWPoLt&g_3)_{{ImUPpHurX*j%d7zY$&jFzE_? z>Ehv+7?daJB@6%{bCH8^OlJv`4-WecP#5~0LpsfU)GJPE(8;;bO{Y8}kVYUfvN6QK zFG&qjF82Q*H!|%AfYZ0w1RDn+s)S@&9@hb|h9C{E;swAf(5~saB~6YycFye5@l<5Y*23ixm)pLRVT2a2O}UCkK^$ zDW(Y{KkHYtq3PU>W)jH?DsO~vD4|VkD6p(cn%(0wO=s`{c4(aQZi{-%sy;8Dz62&i zGLHMaf-enrF);2t`PRCErE4(?^E3@==77H*{5wQ#@JNtZuP|~!ZT$TyOTx- z39&z<>8B#3ri1^2Vd8>}?8gf9QV1>IfA~u_#Dl?Gi{t885g8H8($q_>A~(tSN_rc` z{8*DT$jUJxs{wt@R1RU%y>InM5q|F;#GYZI{UchO>lHA2r&)UE*goOw9BE=j;!R2s zfWmTvZ{0P&qcznnTf%B_G*X}*lQ#2Us zo3&$Db_Mj&^=Bd-ot((B!?kzC9~&SFXdlbNjjA#>w@od%{|luQQ4X-*o^*8?s2((B z&ec_}aHCEVn_8)SS}gsQ;=B(pOAyj?|5MOS`XL|)gi=*V%G&WMvRQXb_YU0i)&qXa zv!dwiEGN?RtnUEX=4iCqbwW2{7LhS!yNidJgg8XKt6OJQ$z!^(p|>@7S-D~0;C@O9 zeJ{`AY^Ff%eU*?7f|Hi{o@jqpg!EJJgDTs?gt)n!gN_CL$y(Ot@r7kJYsTI`-VHw?1X`Ed{K8r)4%= zC77nmrcRj_kcrLQ_oGoFi*af|FNMK5ZBSA=KU_nhosl#VH&L>{-Ii}`^Uvv2!mr~Z zr(&Hz@YA$o=_LBuE_`3atrA&H%=U;@@KfyH0h*8gjW0srx9;)(m+b5R?0ozGzr#X` zHwO)>)FP-NWHbWRGzm(TD1@k@r5|Bvu4(8J4$l)v$+YB~F)>l`W9N>Gk~e(69~*$? z^D5-E9VZUi6$j~R%Dvy5GrBpq(jU4!Pt5`Zy+tUsv#=SH*B2@5<%y+%7S^OKcLK$V z&Q;=kvCid%bS7rCi*_p4ATG{@z+++!V!A`s9XhO4qbl7%MBgR>5nA)1UOg-^0#;7Gjwyen3 z>Jdmq6MC8QDXB`{^w&`{nOwil>#mPUKR<4K;@+rdJvC*aHH{aONrEVG;lU?Xm4SrTt^1Pss#p-D=c| znQ>?|fSJy`b{|lW=)!|Sk_z~q4!FjSCM97{9ycA`lGm2tK^eDVbn_GvGU|87F*mpG z4Y;H0XKtJ6t5~FZG07dRZ;G(g_cdUSslZ5n8CR!Ha(J7jBSYtkdb07Zuh?Ni%pTSA z$Z;rPQdhaDigN@zetdLM*j^pKIMR5Ch^&5QKendt>>l#U*EK(eTaqzg{|mru5(Yr4 z=&p}2Q@H6#C{LE6O0aIjNOSNE8tD!dI1LXIU0M*A3~NDx+hy&1v9p^=HCY6im*8>h z;tOc*co*Y?N0xlcMv^+MIyJuUM{p<_4Kev5^mT2${JWDww-1>z%uC7%7<};-G?=hm zZi0ds(-%6AGz);mV>mKBhZjVkk)Xh!1VXYDcu~>b1S8JmYaJ)1N3d0?cBSV`&RfX>kH`YvUUhRd?WkJ&T}U$6=Pxv<+X&80aud zJb}T--8aFH_gQ~v0a^@PB2DZO7e|q$a{41>O9B! zn^5|p%rrWon2#*Lv%WJTks@mN--M=!C`90;YdLQlFSF+n9i=Zo)`BDMDy~rX2+hW5 zbst_xT0lZ|ll}C(w^<(a>w$FuxnyaAOJ@vS9WI(Uh()rx3qAAmkP!AM=WX<>RkW%Y z@ygj=3y<#jmjyOA>{79^Z)hIHOxi$Di*-g{H`bO2Z7%XME-}fLs4>8nYwYyb54iBO|jD)NME9@#z-S&uD)H2qqcli zWw{E6Ec}D7Il){kp*_hyrRtd(DO(`=PT^qeP496hAXP4e5l$A!-T!4GtNNTI(A2{a zQKa7wUAbR$ZNJxSk?-Q=W3G1ppwCrD{;HOKN4sk*!p`3^qD*U93u<&lIQk#E3obA+@ZWZHww97k!b0{$(&A#Qr0 zV6T@d&yOP}YZ< zv)vkR?M5=&{U6C4{dxjWDQGV&Wcc2?$kOo|Qocte2Yvj zDE}UeJKKFXoiI&dW0OSl8BL`CfGWF!0|T(7Ltah7mE$M7kvB{gr^-%YqacO(!Mld< zjx_{m)}kXy(k+ac7jaO|>4Qdy;6)r`UvRZ-zgygu8#%5Sgv&a_0vLKowswCids7AD zPUFLUR_-4RXKf~buc(c#{QrbmNRo<#nNhRbOPc}YaZ>5B`WnIV=_*)w4@!xk={=^p z+&HJn9n6%_d}w8*APOy;(WIPXJ$iavY>rXRNeMULHc8o1)=^~hQ`3IixEg=Hj(<{0 zaUe+X3Mzr!yxv?Gi}AA~kxz=K+MT9X`1_1$vqRa&#R__etIrn+V!c%ayL>bDQ5s>u zFS!u4aOB8D4hNBG{o`@)wyf!Xw)U|~xq*E58QydIL1~~1Qog=kV=OV17@au^OZ?pm zM^Q&Fgw^lTq3W>{F&8gn%O+r=dK*7yllwRmw^LZ^@-S&4H(RqZ(j84DglX!HUHrg0 zT|jkLbDdFR^r-1S<}iQC+PEu1A>v}w%-xZM|5&SkcDpkR(c$+vBv6R~RKvIV(!{?< z!pg9S*%ZP;FNpwz%*$gb&rIajM5hO|4#dkQ3n$Vk4RqrtbndaE*CbfhHJ-m`i|r0Q zj+EH;*|ewNiw-*>sv!lTA_J_%aYuhjy{?p?vv0;VEwho0NRFS4)awiN_@7K$XY1n| zO2GjJhhShDiGf2%B}x(cU_)ot^Z2*dx3A#GcSL+7f(a_&h7^|?C5nM5uASHDaj`M# zVpq}v@b#pc80kOAWwjj!!9AKT@OjC)=oCNG7@y1FzU3*)Q*1^OVOFtU$7Pt!=$AR^ z1keO#0TC6iUK4&*#@@#ia$I$bL`_~dVL2DlTHxPsuW*MOj;76?5S5+%I6w_klB3vW zy!&fYe#P>ttyN^O_gnHwgytN$1OT8w*6*?rU`nJMLBq2%D;a_KnURagFecM317ULV z2iG@v%_zirLigkc>&z7TvC=>Kng>`rCl+mCUe-~-%ok38B6~j{rb9WI?YUj+1?!7) z>{nYz446vKFMj;&S;j(~P--ki_2)_#j+0EgBp3OxrjD#m#^uI89=dDmy0kx+ zm=?RRjeRb|Ki+GL%_<8Q1VD;fc5F`EV<0^gBmIK>Y?hZ~Z2p2%o;jLkFNs(UH)SOn zB88ntZ6Vx*Lhd_gDa^}})Af%1(Nz=S!H|CPN;0UBsIJ9DDar*$u(~;g)w!+zb51T5 zdUrWAK>r9%0bmA1^-Ty2FbbffVho1v&2Ym;YuOdXbjz58hs+r{!68!G0+d^>^U2-9 zl51#=%2ED~WTt|c$*1#ZR%IByV2fpVQUIR05eivYqM*q_<-K|?^$#XVD*;qwO$zYa zw(7;VJ{%?3P&Cq<#A*=513zUlYSgdmh@1Q{Bk6oxeZqmyq=T0Q{<5mF8e8mRJLj%W z7l+&)_n#*;3e67Xb$qO^JL~OK| zk|{4DL|G`r0;{Y4K~C-t97d&PG@qSm>Y^LcAt^wWLE!Bxt#A_E7f^lj`!0%R+!{5B z&#?0|CltQGr0JbIL6T8qvZI38?9N{21j?A*7)$aks7eJB001Osqbp>oVGzKR!NLuKkd$D604f-O znQ#O?v;+@pDh>OWE&G(sc4^eNR_=)#_ahV-%?0~0(uAD96XZ1%9mB-EN&DEvYiwMz z@^e6|U%%vI*9@nsya^3c>TI`XNzohIo`s~O3~37&KM#K_w;>si3Znd=Dw}8PSfvdZ zSkVn3O_yJC%WI;O-3PK$`}w%yq;>UrZd8J#zhq ze09WQsl-rbI_V1`dxu8f7c}|=ELPQ$$2=F18iLDlq`w;IE%gZwEKlI8Q8a!3;<-DBP8-X1Nuh!)z<;pK>=fhq|XXzF|| z^|J7!qtmb~Qovm*k?3gBRLs=aL6q`kk zl3bm({p*w$%~X2b^*(&K%IOTNV7PA|&Z)X1mKS=cSouKK!0Q9ri1Lul?=5}Kwej9; zU#be=w}b_~lCvi39~L$C#LKFgzme&uR5n;6O%xyNmEE}>-gcJ02M-f&$MAE*p!0=i z{B1o2Kmj4eUWI8ppMr*{VP+r(K)4So0BD2;%M?A%3>)1{eJ2dqxV&vCFwzm-tw=pq zwko#_IVRJvpHpjRM@zdWkl~7V<~PM;HqACVqzHDCmrcsm?;DhyF&Vhw*RQW)%4{Y7 zo11jmG|6`uyUB3mg#qe`h8L)yur(ixCMsKQeye#W)ZIVo43_d;{@HWC+yg0=3P9`; zR_yHLv%t?Ptll4TIn@&_M~OtF0~R2dqiDF6Eip>QR-=c#iI-KK6JGx#SJ!XIcUiv_ zGV2pZ%0~P}fWSn{&dnNyH07(Dh6{^CJu^~)RxmnLiXKvc9(->ndZ8KfK#Rr5f{@r& z#%$lAc?F9r#Z=ma4yP>v{hLMwY?7$1Dwpuea?fItKP0C!d{BtmSu`3xJffr*LAIz> z3PrUkun|_nK#ls+Pfg5gG5|xMIvy#L(dZNXWh{DnnmECkMcC0M5u4(#BKmxV8hX75 zkeLycBj8jujfgHT2~#f~N2R_c>dz|vc{D=sp3^-?(c4qMN0oNniC`6pCFK%jogx4o zWoQX50KHUB3|fU>%o)~-TZRK;Svo?Sy}r^RhBJf=S0@!2=|_i^-U#y=J#un^esiR0 z;l_n)s!$oi+tg9Pe~?pPzY2hJ)|{sjo0pd+ki2bd8;^j&2EF!0PYTx=jHDsK!n zvKmgkJNa}crJ=j_;u{&=2^)(jQJGIl>HOL?nsg+`wEmKDTvT5!v++-cY+Q&UeP!s- zLkSTFHMNQ|S-r`y$0;Y4HqED-{dWAp|5;*z!52fN;Lf0YVaQPu z@YvymzbJ8o$jG1rpa6Jq+nneRKR{e; z-&<$Q9hU72tTxf%m^HF}WHi3bB120;n(9WqH8ot24^?R>YP*D(a)+S40Ts!*{m-ky z!ugES(r~*RKLx3THx`!9MZP*hBhR6@PeB)vI)^^5dug#GIM$BeW#Mh6F8)OMn$F~? zYHqhie44OgJ)1#+EEGIDi&wPO_4*roQ@NtvmAYN9f2>sW)na~K+3ALCnu1-ySH^0c z9U0)JUt2 z!X=yVedGVJ9BOBD0Gyy9MEdXxAOqLYbq)gHEcqJR3owkK;#Na!Te(xBA*ICT$bj22rtpvA<4Gv~snh;YBeN~-s z3L_L5rd1v#&0M18Yd9j;rRAVm%>EO)$c3r=+&U&YEUVkim8(2l6#X7vW3x_deSRgM zZLV{&rZWdU%YjtbLQimKVpVcK0{)6;glQ!uGXw(QF>PE)Tn}5Fj@XTBo#^Gy(o-r2 z9-LmiIh=o8KT!J0$YXWv=fGev!`X9SSU~h^;)T=hz~BE(sA2vTLEcRX1VzjJA&48* zntj)0g9cVjn3#ZhVmgmf_|z#2jRCV@9Dmw~k*uFj{r4oNd3)db;tXf!?RG4odck#Q zmu(Wew;eRAyUt=|Y?OS=hVG=E=++g(ecq{m=})Ez^qWdm>?OWc+$@-32GcITSPLv{ zFP`ib7snML?D+3r-(H&~rs{j77S^>AY4x`5-!8Q1@Hxr?CA6B-y#m=gC%p^0vvqtC zzWux}{iXas@wk$G=1xbVJADH@pAS26)nlte0^ruCLN?RQeXj4u1&2&< z5_J1#{}vPX(~L|WhK~{gxv>ir@qsz2!2aNh!0yhStB_uVn)ae@Fxo1`GdpY^=%}`@ z5*}W}9wmc(u&=*YmX_8q7^+u3S%tm;fRKdr33j+ZW{{5A8zm-IRvmwB^W2}h79rO$ z_s|;|ISK?(R|3zs=OKROmMzP7!ydILr~{_57v8PxOFdlfbu+uD!u1}SMCC{7IbnJg zl%7Y$aGjX{AUAH`3xI32TD70%B#SJqC_S)ZLbc1W-p=_`os(s}Xoo6`rfOG)xh~J82IsC!G=|`r=P+?;^xl<&UP5F2AdJQo66^Lg1$@Hfh-z zI?dx+xq3_0rD6ySGR{_YJe2V>SJ77VvC&LXsIl@mkVvW-6VG(3KZtF;(60i0;HPk) z?vjTVd8X&n4-$I$kN*De8>H>^|6K3Jh768vDhAJQ!U(GBS}7JPWPsNRwD`Ex>UQSS z>E7$t!y;do4nEenYOxapTqC*yFV0nK6vS#=F*_CNQJy2F@*#4yr0nEML1!dqb}Zwz z-=Ek~JU%)P%7ztk!ZB-yB>cjyKXAhDpy01emTTwC3C#7-ehTOIb1263NMx)Sz{Y)i zHw)wsTE8maQY6cC9P{s4A6$Z_S{H@_K$%51Fv^<9nU}1m6cx*xaJrkjf2Z@Qil!?b zV{ZCdm-BjWX<%k^XOrsykkagIU@%be>wX`wPsrc4 z>!<6DlsY#(l<9cHoat4owYpo5Q+X_ncNsQeBk7@bBY`hfC#m&eDx96y8YK{#$OOMid#8{juG;;`X|g*1ANp^gh)&pJX`1 zVR#NDeZyRl^<2FX`Q&hk@(km#XqhBjQ7_iq0 z%otSeJ7kN&4-wc9ze^+xIT8M#rQEYj4c9O;pMgy~mmg{SnaglW%fA4#m|z3_0V!fk z{(HtD7zQ)>dLvTWK27+GPhfE7al6aQj;ICQ`WuzD2|QsE<^d*n(Q#+-)1RIPfAF)E zZW5KJSExJaam6-RDaaUE_Cdwi7`nJ7q|Z~Wn}dK9W83p5k!j?~bn*%Iwp%ts&7*z+ zD)OCjlOt6&ifi-c(v*R)aK_7|#AyD6i0V+Y33#Vv~N$m#o=hgQN^w zcX+Jtd5*Zl)g9VXMW@zBzOg$CY_b_oi&>#sb!@n3jc~&Wem2kUIonIaXGBat-AlFV zUG)?@I?ab~taQ!&(6W-)t5>FX1~+Lgnrd2c?G7LQ*sJ>d@PV#Q#0L~b|HRYO-u(?D zvT*;}sQRwaMu*r>p!BLvx#Rbf=_irfAFS2&Z&&H5wU-}fFu*srtwOjx=UN$xg6>A6 z2>!2-#P#jx3+0NvJwVnY?ZR_=%Y!e)2q^s$7lj&$O=TPbiyD^23>6v%i<}k%%IFp8 zM@E8DaiaqSktxMve>D|#PoEG#L7{+(`A`xnk_#Qq6ciyx2F1EO*hS|CHDN9LkL8+& z8Uo-Rt=8ZE1=f=Bi&A<3X=bKzdlvvYJg*#q1yTucU2|&Br4Uvh%$JjZg3?kcAZweP z%5F?Q<>TIEM{oxRY>98z+~?c=F#X!D8};n@o3tYJ%_N>@JV8`$=x}LE6rF#otc8X9 zWc=XzPDYnBK}mJ{TanU%%Yn_u;>da3cJ=!jW3H`@z@Ud5rcLz7u(ZpD$*eiwBIRgvc4@|P;9}gWll?3+bb9xj(7Km`%KpOgMGoz z0RW7>v?f@mPPL{j7W%pa%oZrd{9@)-;6yohL>MXJBtB^+bD~LkVUHgyz`EqfLS*bq z!-~Z29;swP-=_`MaYw8${&1r+3R#ibFI0AAig5FCyf$uSokafU6NhJi)RLxUwW|qI zyuoSpYZ)sYiz`g?-8r`0w|5G8wC=C>ahGa4LWY`XSKnW{#%CUSxIC(c+zGg+KyVKn zgLA(WN2cgJki0xYtuU#xHco6)E2pfk5PpG(rvefHN`1dH4~9$^P+($wh?M>ihQw$= zVG=|%KaP%8B6Dk=LSALG{drVn3rw-uW})!c4D{ zYq`W#=T9YT3@Yf|#LVqv%xVMI7c}%DS}${L$!?A5JMHdX(ajDzePokRHlI5zo&P~@ zN$YC>vTL~ZyDI=Xc<8id@)rQVrro$ZJpkz=#%E86z^kCj)LQItrptjpP;x86FM6`m z<-zS>fNg4ND~k2SaU-10%Ru@o`ZzC-#i>7AYZo~4@p|BY5%BD|Tkiex^!?+^{~lbd z*BCx^8*YO>m_bbfkSdfYVDnm}&D%QdGdCk^mzb$8YJ#VyQrNZCt?p`A$)S{*W=$n) zq;V2$h}-`5Hf?&EXPHeMwi&zeH=x)sNXN96Q^_K3axj;TW69N?FxO8RrkTGCw6Go1 zUQRoJSB}BkFL~g{v~&An?&Hnbh_f829Vy3E6n~q%y~Tk2!~`t20048ow(tth`L$)~b9)Y2#e-U#k4|tlRHd3+|nK|B(Rr1?!9nWgl?-H}pej#Q7&_x4X>ZuOiiPhpic7 zOAnmjBmJSqYcSE;;q^#BdsVX`IFFByX+-rc`csi=gV5c#MKGA9a)+;$&gaco>P0R{ znQSppe-#s0A=Pq@g&2T6&L0{Ri4lURYDeE#Y7=~R9;vKes4F{P{qQ~TV!=s=AoF&8 z0Ujkf#FvfExVLHGw+s1o&?i1ko_?{NeCh@l}ZH}@EV< z554&@u%jdq^|R3X4EW{eS3duHIK7KP{QR}QtJ~CdjpbO9Vz&qcY3WlSH60XDEB76y zKvJGzQa=_dP2;QtlU^@F{h`o^^u#Q9JXPifiW?k{ClAJw={vKa8?>lukEEfKyy|t_ zeZyl^`n3xOf}RFWcbi71L6h!{A^7 z`1a)U+(g6z>R_?`K@})n30ylF3}cxNie2U|%+f0^vKT>Glh7A5d1Oi`3J05$ajJ?6 zZ-cvky&s*^pg-9%IHy1wjGK9u8sBUNHy%1Zj+qrEIX`P@CK?z7Y<2!ONP+-m20*5Y z(0F$g1_YRA&5Zm4;6ysw|J!XNh*_}%VYv(9EKhCu*$K-+mCB?j$#nyCKN)IpPm{^1A6rqJ^qmUf0rrxOi#D*^YQ=Q?mftjQULut-;uZYt$I-*KJ#DXNwXiX6U6v& zVVo$XVTMNEndD^N%2k!jtEFa5@AuJPJ9K`U*~|Z^r=AKgR()MwyA47mVFaZ41NpNVnJaD$NB9xM-_--C=?I|bt8p*!? z_$`PBwiB$wc%NA`&>mI$b1;xhlMqRG-Ssu(a6av{w=|ZY4pF6C)E;Sb2%lCX7*3Tn zuusT3`!v>d0hx+{XnTVEh;B%;y2@Z+?b*C-oj$$m+l9eX65kGyQ;no+pT%SXx#f7n zW>T7BJE^pv$mUx1{9|d;Bhkq4eYBtEi{`$e`pDhlynpv;^A!CGeCBi&?)=anUhOKk@NGuqyW4|%ElbB@`(7b>LA;qj=OBG zF((P|;Y_fh7Z9zC&4Vg@+}5loTSc@bhnA*wVe=vNhfZ!4^=YM&CB{cv zY^7x@%oU&jZkTtgrkoqGH3vC~4S8vFm`3TGjYd0hSk$^;6!bT#YoyA_%tQ(x&Q4ly z1P?SXkuj1Zq1dE33N0!|z=+!VXaoZCZ*b;b3u4nH5$|*2LFfc9AydNX27V9aIa5m2 zs1T~Xcy(=vUwcDf;c3m-*KG+5Zde}>dCF z=Ud{YijrKU652wTKgo|au|zbg_R@Tkbb6kDoXZNIxsLRmno7`;K#8YVlrE>lKrS-$ zn4bH>(E9UIRz=z@Ue~gEcuk+I@ic4vh>DJp<}lZF!`|)Qz1{QU>S?&H=O4a`F8j2k z@5(qI*mv(AF~p&`^yQ0FmbNIcI1= zo)a}$pytx75P#8mD1n9yH75=cp;z>RS`t#Zq95jT$)9)9@a95lsy>Ge%rzn2kJ*56 z94DtBTYzvq!Qj*vIuLH8Rfu_}d!)kag-gq31cyv1+uokUD+Z9X@NCTt0}cxn#Hr%~ zkop@KIDiUtw^l(hlBz;Rg*Kgx4~0!&IURw9C8Kn~;P%Q2-8=Xh`rGm|Ahxhq-3wx+ zM}KPCoj@5{udrsyg$& ztSmxV?D>>t^=emR|%O+ZLqUsbj1;5EDlv>4_|Dn=#{2U{1C#N)Ha)p zOLEwBkU4Q7bg%H0_2p612%9mluUcX$Yd5$bM_!%S@{YjNcC7cApYWt+&WYv_4`X}f z`|&Op2>m+;h#VOcY8esc8E1c%BwqzhC>5?i_q&yR5BB3dd|*Esw2`wH8NbUq@t@k! zq&;EDc*z@^#QX@iZeA&|Iu`gb;a@?&5zXLHTNA&qXJ<7tP}-aSwn_SZUOBbqC4IIZ z>}QiZpVgyoqvv;sSF}{jv>)t3l=F?|PG$W!)61^YTkc|8U=%_Ws1^BK##VObLqs)Mm=r3<%yw7;Af%6N3JNvT?efM z(1jnmua5Cmo>F71q~#y!Gszu-Nx4R9{0x<*m?u!VrN?j|0(yanb0FhMtU+@_^ULzZ z+5_1m6i|2<(C4(*GZ6R$<&^gqD5KfiUcZ0He(mlHp!SE-DfZxn1t8MBq1(v<4mV`J_p2gSt zBuxUzH*>453>W(zM=dr_vEwZl`c1q`@T_jzc9N$%<&fV3Alq38aGS6i0MfM$f{F`+ zfO^F4;O=)saTl^Q3WN!Et0-~ViJByCEno3-s$4-q41@3DA&R_99;e_UdXFX`YnDCu z&HW%@EwMmusE|0e&%Q9CH7_7E7`W6A$er@zo;zU#T7P9ZF0mfpu^9Mh&`u!SNhDv% zOTT#=)vm!9#L`B_X=2y3J-oA3_>SM4J?zy8fryPpFL>A~F_u=BV zsqrA@U`*4TP~n&3sFg*uQBuom201?x#hRa|N^bjj)+)E>}I0f?w(Q!C3KPPQDR;i!=*mztE zT}}gI`QPTzxQu@rw!fC7Jp*HVRv?o}go%m52RrEYqM}|So5I1(#v}$91-pSNRm#D( z;&PO|i4ojkvo9F8!|6VldpZr;jywGBtRon!y9taK=BgnDu?l#M=6}!hEhc9@h`wFs z)>y9@@#0`8F9v3`Kgi;fn?(piao&VPo!W8yF;Oa#(`4D8I}w$^A&gcm)}`OSip)E3 z7Fj_%oknrirQoG1uAih|w(7&HIyIkReYI&a4Ny@U006w;|BcI)kg5aVFs;^~&P9Kz zN<_W!x5Z#RC7V{$`y#0neZCJW{OvK4sD?z&FpphpY*{ub@*9NRY+9b86c}BeKg+YS z<`!GGSf95d86Qp@Z=ZdfA{A1;Cr$%z`O#4)D``27$Ev>nE{>vbgEyF~3av4&KQuKIznTMAEJp zx=|fJ)@6tZkxrxhZxP@U9YZq^N$k(E)9ld2C8sKtjM=>-ABw8p$$I|b3iuD01ox{L zWViOCW2M{{C6`>q06uneF9OaIxnyCmi8~Y`3lTCbLvNraW}vX-daV9(m<8Yq%nf^_ zQ2^rQD}jR>hzz5>p^DR;;j)MGJhSP~q9>neY8fT(#CulZ>wtbnrD-bhbS2ZOn7056 z)fG5Jjq9IV{WZ4>S%atQ*~eVwM0Ma3(+T)9^lAd+|HJtWr_;wwj&*7_@Ea)#pT)WN znJ&EsgLdeEQbw)jm2UaHC072ot?$D>Ffid_wgWTzNk(yHZ06v}73tXXEcH&^)CuXw zMOMYKIM33i^vTB5OInsU6z->Ad_$N;3>-CGDtI_W=(s7B-5K5F?mx`Y`-8JbkHQJ* z2{=q9z4GE}s!J|OG-x5i46+<@MIDAX)qvOlM2Nu4!>perFZh*HHp@@$@RuQXln*Xf z^)&v~8DmbXVfrFq>Rxlh9#iKA>GC_32XCBAfN4!=fp4pu;W)Yw_-8($=ud9%2L zY34Jg*sy5rX+x>oKTP)6=xC6# zr@pV>w}@dz!HQ%y!Zcaf?WGHR*Jtw^#o!%}h;o9cFv_{5&pI&fHf3N#cy)n$1U*=2 zG9vw-jFuO43HVuRN?#Fv9*2(4u~KU_qrBcM4!apvf1d3&8dX^rKv&k=%ua$<3=$k3 zkh+D_wt3s$@sB|VVTTzHNKa(=j#Ivqt~@G2TD?7G&mS^t`93y$;TD4oJ3YbWiXqh}q8BJZ)U&|w7Wl7hh*6{f zK|a|5LV;qwXjo%z?op#DEQ$ggsSXo;?W80dHVg)`&zvd}PtOW18JJXwYLM} zP-0_?kVJd<^mieey@Bksl+?yzll5)P5R5(~yXVPEe!vitPf_O2RIZO4BEXB*+M3e0 zs*uvh-LkUdizU-RV-agJ`AyKs%bu4!Ms>gPCN^jL?z|J}7j362xyq(Q4?snM8&Ixz z3U?xNDt}Sn23`m335T(g0?Ck3kv<|v<4ePEedLm3BY{F&o92LLM*^^tVTc2PqX}7M z(Q&~;R~n5*_YI?~PHQs6>szQd{})^57+hJ@t?M1zX2-T|+fK)})#=!_ZQHi3jyra` zV<&g_ch0F(b?==&_Nv-HcGX(z-E+<{<`~aQu8&Jj4T@aQIGR{O4m!Q~`}aS|!Me2o z3r!5vR?LL}R+5?9Wz7KcL1Ja?ZhtV@>N5}4dVnMqmL3v2hV+vF8vRdPA2*e=W z6`wjk{LV*YbUb@;jCxPzPKq+@r+%KoA@<`*8PT8&e7bSGoBVgE`~SUUbDQJAw06_=`N@wWZ391j zl?ON?_O&1R)PuwrR3J{*Hal4yy!szRAT4V@weH)_vHQ+P&AJC;=iL4f{hb+)KGH4? zxgjQb@jVl3h0#;XeRufM?R&9-wWhbpo)Y}p`OjVX0Y7zW?1xzXFq#bhm8mXXU5DQ(KSs-YLJHIvfe!FczR6fSA zXi|Px#)|#mZYxzidY`SetpDWN5>ROksR1-lo zD?1c_{3k*RnJx55MfAt%opES3_m6*)QyZ`{&WCtB#S$*fOrV>mnbJ-js%7= zp^7v2F93wsS(+hb!<7AZ&7wwnjsE%1-<&VoHkDlSTfSUsN)mre$Rn@bGyMw~$>~5C zQ-_)v{?JphA_=?ss|?PPf_>2G-;A5NZo1KND_}Bv!80SsoE$L0bE4FN3aU`MNn`MV z;HF716&5CoBa?m&G!uaO{lVf2ttjxv=-OVD<`Mz`zyN@o#R{1V6Lg$E^mA{OhRSp4 zVD5VGBP+A<~CLWRw4%0iegx=|GCx0{os}^a;R0ZrvtIAuGUId zxrz-~+`Qg)u^G~HoVPDYxe*Z4waNCH>wCQs#~77&QT?%>zVg-bDew@NJ-X6BmRU`w zp;)!(_f>mUdEpa2bzFPg`}dJz|Mib{Tsp}nYr7*Pvbcy40P1myjM66Ia+mhYfOH)@ zSc_@J%5q^-1tr<>X!Su#yd4DBJuYVzv4OMAuI>4`ZIt@<)#1i=)#EI3;q>xL@ase3 z^~Wt~idKlKGz?MTqIy)4Ks~tw3E=l5+8{d1K7d^lm7`TWKp0d=Aj|M#Ay=2CW z;7h1%zA5cbjMp% zOZ5<>W_24xgWq(T(K>0}F|JQ>$I+IWo5s89{~cq-4!NSweu*fl?lm;!O0jsd8UDpymbz%Jx zem^3+Vu}K{k|Yq@T+r7S5}rp}%8i$(ii6fX5>ndWcXhy3;&J#ynQFlmbp$h1&m@k~ zeq}%Cv{o_{i&)`|Ze4OvnzmSnEik!5ae7)%mx2HXhDc>ovuYK~ZpC|GED?h*p0U7z z66Hhh>hWg}n2JG$fCcWzAYMI@UgUyOR9=#JC+Syd3iXg5uCYm$C?4 zrT^$rQ7tdISdqt^KD_Wd&lAn-nml3J`W+nM*5&r_1T=Y{wa&h)g^sY&D9yAlK9I6r zn{mLSd(84Zx|hkh~ZuA!7a9OF78V|zAp;JmJ{F~*hr+oZNK)&m|!Ltuao6>YL9}A#yr`Vko z|C*pru7nB2oVP?Lnqy@{p(wX2AHac*_s=u?#kpK^B$L!FMSI0)sw%$Q|52%|U@{<* zRBnItO#r?pIkf zD0BQtt5Sy|f5Q-#V|riQh1C7RR->D?*0|~icOwHoT=KR~wS$@~|0E9OTZ;;76_}WM zx6prQk85u361kWQ8zUK!%pX;)v-p!H29VJb+vm?*j@v8F-| zYW?`cG1@9zA_yD+ zI%K*IByUZ;8YVOY0xHIqXtOf4@#UO+%Im=k%kc1D@xY?B)lnBA2ul1sp2P@0lVS(% zs`)J=*uQR!_04xqb&9JeB_{V85hf2Q&>V*>5t-=FeUA$aNAU=_+62z+QIgz|jAcv1 z1#K=25u%Md8fF&3Pfl{>-CkD)&e&y9dH*D5z}x9hcBa36fF$Fn5SkgoPtu6iVP^%* zkqodSRJyk1Keu-;Z*%qPg5@haTSBQo8YjcWe&mBl!vnsZV}k@427yNacB+CxEA|g7 z2`#!>lLowC8`B&-$kR`_qHXaE3_ebSy>_WO^M{ zaM%U+9^`5Wb5`3>IsYicvH$BKauz+tFdcG9S8g-c$2px7|CIq?TX>!1%l^K;f3bpv z^E0K-c08_L{%LhL3lI;iRtAoUYaY34cocc2eEfF1+l=HR!oHXYZQ*%E)v9lsI;K(duetPw{%l1_oUa4rt^NcB&0GIbCBW>l8CJ}~Tt1`sq3RtMg=A?qg9 zOluPf7-v-PIQf;_j+LThW!9*R`-z#-6TB)`b3+G=f#lACdoxN9^t0S%k%HOHK!fck zL|%O@-lM_Z>$v-{YL?}=tQ`7DZP6l6oDqLFo#s|sYa<4zm|F8b7|89}i4o?pg zqP;XCiEjE9&n;R@|Cbk@3Dtiz6k3GidVDxEP;Cml9^RE$O$#N0DyD?RU6s<6n1}+* z(cYM%mPIdR81@`=*$n4E>BsvY?gf9{_lg82$LuB1>KggaZ_5Bzyzkgu*QS8}oY6$( zLt-C5^5G3dP{Rb1_U=>vt?dz6yo-o$pKsIVVVw4 za_cFzid}oXGl5-Vx>}qn3Qm6^77SN3*H%^ z8`S~=I(p^ofFO*CND@-34MwzKvKQWix~9gj^aAq2z|?hVv6@Jg)&|stvPtCC_k5MJ z;Q1c*$to9ZzT6pca)}c-xGr5nWdrEd!c1Bnn?a}HR269~@Jz>7!m(cuYL#H)+OQNv z01%HimG;|zlAA%k^@k`j*Lg#d%{P*zu{JvL#3qh2yJY4Bam=Ky2!fptd+nZX z&DE6^MkhV@rG=}_S*qf7-}Bm#644d(lS#snf19cm;i)X%AsGFwn^ zCM4kj4S=4y&32J0ZM_Aj6;hDMfVNeM(NItKmBOyzUUG@V!7-ptLroPqgDK(9$tr5C zlAqm0($|gRnT!fV~R+Ie&Pud(0!$A+I2Q7rJ&kg@A1`wSM?>NjCb3fT6mlm)11Rtr?EU$z>qc5t~QI17+&ZKjFm?{@h|z%gtR~t z-JYLDtSLA=883;^U(f(l((@cLw?^`uPnQ=A-Onnfsy z^)ruawuEC>Ad4ADC}|@Mc&OAGdLU_i3#*1Wv}?f|B02(@Su>gk6-zi0nluS7VN$U$ zW2z4&iPaHA07>bVw@BlWVrTK?n;?HPhg*?Ju%EbC&XXtzyuVrFMPZJ@4^KQQIqNXa z0)y%DW1rA6#J{1q6b=Kb-bMrh7JO!PQO^GFYYJ)7TGf#>%+4ndY-<%F6<`ywz2|gR z2#6O{k2gLsl}#tmn*3?vFD*b#DQJ{1U$);Jp?fZ^XP z_u}&C4-sLd1zcF?4Tin#jLzJ#K~fAZ8#skaQK)^hnVuzjmpUpiIAGD>UGOn@y$C%g z`@0<2+hIwol4+Kr^;56EnrC`ardD1i(yMCW`|Al@MP9D6<;x5rLy44`pycDiR9?D8b73Og|@v z!c%h67uhbPQLJ)x-oAFez^TDQS^t!~apsV@$rvTbaw3Tuh#Y;=&0RO57Vh3u>zkCF9{h^gd`PeHfF*~Clu0)5Ft}GEi-xFUvYR$>*yYJTq^Kd`! zhn3+iC1Q!BnOuGU%Px&>ymWju6tVZLTAr>=?8E(*Y>jWGzRQ2b>nQcL_8#b`_;r2r zC7jjWBwFDwL=Go`z^))9l3|%)RM|O%q%gV7ff(por!;acc<152?V9FwR@gWxtJsy+ zA*X_%bgucwXW2PWr-LNucPyBs+1Je z-Cga6({u@_foPpMGeIjUaxp&d%fbHC#7Mq7OEUKN;nt=qfT;IL`+t(tr+o~Bm@w0P zlVhKE46CFwJNbe6l3+AlzYby^Q`r;UgA5^dj3<^5YE69YSkD#-qYR_u$AR zGfv27Ws+@LmG>?xt{T}{`J;vS3~>ehZTwZ{4*7DUN*IE1fHL;u+wyMFe(rTylQV+- z|0}uwk>3AY)h#W&-DJ^-ir|wFz$C}ijRMu?!KqTjK<1P9T7NU=@%Kkb$Vs#oX- zlBqv~%fMRk(@@-0fYw%bD#|i?wdSbFi#9(LxljzZ8&4#oVxaIbLLu>LAk$r(i`LJ^ z!`kh0%3k5cYJxYHEevSgi_r1fL|&Zwrf0L>GH624#J zk|`^RZwom!IcNt{cbTj>*!segRg6zMe!!F^s!w57E)Sc-$BGv70zbcFsZ2tI( zS`3QcpDT_lm;Thhf2>IIy%gcQ#6yq>;2IYWA%!=D?^!Yh{JGjWrLYl;^$c5j?61OR zWHrl8!*q9atFMMT??!vixyFn})1;lChBJSv57h?`XZedowAiy8!%VEMYFgz%=p3r- zJTn3Js!{sB8yX#`#b^ns>%u?D#lBwqL$sN%zcI==>yl;00O8a)83p>&J#hg{D3z}7 z1>sv<0Dos-Ybo_tuncABtTYe^O^9B1rR7Sb>x4bD$*1jT*lOMKmt^bYh=8;sAm^Yp zED+?8o<0@ofaPZe&w`@j%aY93haQ-{mk_W661bORW#Hy!VE-S9RaUy|{%qtBp{CIT zwTeUby6P_|WRXD5!=`{cKY-p?GkS=ZSiwhKaLwfWt;ka0!6#4Z#B z{MEXX!MKTuHkwtpXM8^puVmGzaA-{UL&i{5>l+$$UOVA7D?;5IVN3=`jn$}} zE}XhRHibTW-VcmiX}&C@_p3eRct+?kI=U;>V;Y(36X484*n}@Ef9}guWLTn3MQB=}~SAi-3fpIi+S?2mh4;xZmUNRib5Ouz?q@N?` zfN!@wDNMfeM7heMi&`U2)(CBsSC%_}j9=P*Hj&ZHE{VHnXOvqFrQRrSv%I=GlZlhH zs@3D@gpEgs4~=3zk%$=zyNG6qb^(vbZFF0n(3BYn3RMvwYM>Cicvr!R;Qq*gMq}6x z#LjPmPjVq(HO45k29c2clE&sc?>7ZQW4+je6AO_}5-<0Ksjd5=y(^^^4Zx~m7&sqd zW>3zHI_>3nba!mLWWnW^tZa89DmXWSbyKXw=kUCBQ}o z-(1TZEb>+laJi`kjEA7DU#yrK8GD^(+J@v7+_j9~X(KMServp~5yZn56l6juL&bQl zwkkA{DdIO=$<>{9$dvT>Ev@yQhiKHW!vGg~bgwLbV$x@J@e2{1%>1tABz4_G_rkQY z+oV}w2BZ7Q$S$$l>}-^B)N1YOOm$`(*nbmp_NxriI^Wr|03b72YiDe4ZDAVtP>Y!V z2RZ4yr(sl0AJKJo^1*j9Rv{`G8+6<(Z7e*=Z8pgm&yqnQ_#ND>Z3{eF^e)*4S}-nREhp8XPW7ehnQ?Oufh~Lh0;OS7l@a=ETpM}N zemLysiVv2)Rby_UW+XNxWRSAY{rr7;#E$FCZhjIPO$3BpCa9SMHERvNzJq~$B4omN4!KExUdFtHx%aVy)h9Lt+ zzf@to=I8MhCyKAc9liAZX7mp^s@f)u2GTMLdSdlU_|lle=w{%r1VPJm`s{&QM!^$V zC5E$N*~V8OM}Wvw#^8u3C&Sjrv7uMni<_(aWpu4jvjXb?tTlD5*MaOgu zEkgE;Nw6#2w?2p=0`?f$Si*{659BPFiIIqmbRL^v%Agf9BU5qRBXH|;MyKN7?qKha zf*rh%s(%GLTc3ML+C79b4gS#3xra;@r~t3cKgV$DlOLjzr8E`QN=S$qV=f<%*^6Lb z38dbe;yt2UJ? zD@6XV7mxvJ*6zSgk7LWA>y`{XVtAfaIH#jXPiay_e9{FZ!%${XFpP z>MqmJelip5sEY{rfOtnP9v{+f$wk8bu!4{yI@g@>1O<+%z2;gYXCoylwF)TftTTZ)>L9D9|b}Cxrm#L`UrL}zM(StQyWX#+B3o=Yd_Ej z*J;M)KF6%sb2V6x{k}q6rr>6N+{Gh<3gb!&2OjZi&UcIZeM?AU4 zb5KZh5o`ABx;&vOMiH&oSYtRKo3XxZZJlXA3YRa^FkqaCs@k(1pId-<4P9A)XMKN4 z&bett>x}YzYz09D_s?8`a?!tXIX3Di01T$nuQ$a}W7(07Q6M7Mo?7T7xkU-;`tOHi=7RhZ)~q@aURuI z((twNYCH#_Ou~$yWBc{mgQ^-;P$F>nw_LCJ1eGsLyvoc5|4Wi4*BfKDtK6}G?IH6p zsjDwufkB@YAVLKUgaK%OBWVpmN*R=x@DO3$-^Gfjg(2WL*CrsQ))$|h;M*sNl%ioS zJU?9oUf7S5p96Fw9ZPE1ZcBPfhDf;2mMg9`RePwvJS<+h#mH}BM1T4x002DF!q8i# zAYPIX0r3*(;97~)El2N}*Wl#p8SQ_exmgUKVNx+bYRkm!uuX%92$;o2)lSEa{UxB` z1!_@VECiTihjb;UXRDR+!bCWD=(>_Rv{T5h(klorVk)I%QQtx-nXwnjmu2~=NW0Zk z@T?vcmPhvFj^`jKh6t7PVuk)wyA;ItCjc7HQ(afloJEtovxc8060c`O9f6-~f)@Rf zKNLeLRRjxmz%9NUqV*|~zTfUDe;U4bfyErWriq;BR|NMX#)!cAHbn%3hdklH}<>5r2@Z7yi z?Uk*6LNN{dvs)~C5RN6jh60YR?h4p zFy-xq&$x%Lk8fWOm9B1~=4_Cg)SS_n!UQmhb5Ny503vU)#5QQ?){1aPH#~H6Gbem2`FH`JEa&?i;|Ek=p#1Z zP(2!hANv2(nqM#bIntmEC~9yF5jBVT>>;D@{ukV59>JnJqZMd)@gcRJI>zV}_ww4G z&-Xd&NigrMCD)S*%de|1;N#HrX%;Ir0bsz_`zs2GHOZ*WM?;99Zpi?qP@(YIhml9> z@kJ)dysQSPtVBGrkp;{J5i!rSvVjdPO1r8SD;?YnRew8|F_Kw3Tw9U>>(sy zSPti6(}YXNgu6D=pfkgbNgU*S|9&?9+dNc@HoHb{&)fhbaXvC~ZTR$^Px)j zl)pPOrLuX^e}iA_V}MB7^>~hSR_w2k{JM+ z*@%j;OOCoxjEVCjrp>TkUlmX8eo!6y#O#jw@Bt->#;#Prp$gJJ`7+ZxbcQQaCG+q5 z)b+xa^<&zr`r92DM6;=1(G!q5koF-2CAEy+9FkhK`9w7?jC~ynuzByBK0M=M;Hu>XXj|uQ|705 z-F2Vt2HnY}e}3pSq|F1pKM(JfmL3+&T4~u@t-vV6dHu#6IBNp~b0K5Q$Pwye=`4*T;=E<2xNnuY7wK{t&+IxH=}Sx0`5A+m1=(& z+Z3AK769PM(re=Ka!JB^?|VsRYS~eeGvP?xoP){*f2y*2SW^df_Rf#@%GIm}S(Vi* z`=d|Qwc-X3z1=(fyKC3YF}|;d?uX4ykItn*5e0_@!oc2SVEr2ifM6rGpwKEE8IVY% zJmvt4(C9Hj(lmP5X(S9twv-~1Kqd1$V?;nDiKK)PhKn&WkG2kP${=cXSdpYqOldMJ zvX+(B&9>hf-_Qi}dyjkboA7&0i7<0RB|ph)EyKw0wRh0sNef`b70<7Bnqm~qJEp$Xm~_oWl00kF|L_{coSV#s=Z zJqTd*B@=%p+?TjnR4&a+WHmM6rw$h)!E-}R5qO*=K2ZPc6%*4?F9jl$3^t0zSjyiYB>xrdd+RX>XywHCLtjMg zD4KB2)Ifjcq$7E!A?^5qTWSw1F_rs2$+285_`?*KtN(N%0!+i4oz9#B$Q4M?8M=hUG9b)v0&2a1Ex_V-|e^@o5l?2a|d_ zoLBv}x-`7`iFF?7iSc#!x|83gPx zB$=Y4{xUHG6$U{L{e24Kt#v?5*I$1S86;Z*jo&?vB>&(!KR_NIDW8xiC3H>1-E7UQ z4Eh~3*&hwLB|tRNKoC~g2n^f@-L>g-kLZ$P&9KycW&tl(s$l}b;UfbwsDBB=HFM#H!UJHDOKjlJg8*WtJqBpDfiT{)aHl|3{fX=#I%XDDl~&7NkKgh(5^Fq$53_#H)1_b4D`=c z|CWJcM{A9ifu9?+ggcv0^G|Y2g!ujtHKw|LX1@WF5Inn=LI8Z}8BNY+R_MV*(cxP=Y7@V`?>n5t=YG;IPq!;gpD6v%ixkgn**2t1VSeW z$FyE6@M^Z6L{?>X>Nv*uQ&UcXr2ClP!;Y6rrRG;-mq`+twVoZPHIHHfXC`*n|8BPa zf#o!t!pPh=&^7+3oV(Jm8wo;<;_%6!-V-AqP16*=t49h9< z{eaX4{9)`DW@t}rDP$vTQ}UZa1xc8~a>3|w+xd0dTJsFGqwbYZzE%5B{Tvsb8QA!0 z+zwWGB&H?M$565=ZEhGCS`cG9?`rFwOa7M5%Gjn$~lPq#dD zghAS~!7vU;^FR_Xrbu8ttuH*7%sBDp^^Im!5 zUm~z6!noTwkM#2iwa%UU)zZFSIOy7CXGLERer0V1G&YoQ>XiY^sX`j8j}ZIL?P0;N z6rNgOVwOb6QU{?{X2WJ9@$~7&&G37N#M};rZ}|@XjOvmZ=*BWt-x;BvCogFtTjkv4 zx+hY~%LR5G+#4K{j`?f5Bt8F0&KQ}_AM&@A`T?WqK7SyuAkG;N?n96=f)VrhCwg`B zT_p5s_$S>WtGLi^#o?n3n@eo@Mq?7|d%{eOE1R%h-AFqtwJnkJ2L+W}u+v2rT z;@9RnVa=KBTgq|cS{>DLM^i5AiK_le+a*70p=B}>%QjqqQ88=womOB#A5>6;pSv-E zs?-OQCdj^(stNl^CHGBfiGvS@ZLW3qTttc?s$WP&g2dW7tEep!Y9bMKWKbn?&hOD3 zgzTY$2I(+jl_e5%3Y(>ePD(67m!Uz;TgDs4uSg^B)yl$s_cgIT7$5`+eEob1VvM^f_%7&zs)ZJ>HP}IygnE)|IE)d8eH9=qkmMCO%R|d zL!R8M(2nZFyn{@Wu=YKSC7{y~8T(&446(o#i8p{`h+BWvRc(He3l4O>coTk(vOn4C zrd<1db?GMtAOj%#gE9D++H{X9lY;^Y#l#Hp(>Ks-SS%rgIZeO)QccKT%t0gY z}+1X^i-2BVwz=K!CWYnG{ zG(%psy1$M_uV-$r_iK|gYglEHR~n(+agl>fee_>bth;RF;u~O0VG{!c-%_|0|4?{V zTqs!RuD$EzeaX*#pQ}+>0YyL#hiS*uiX{#y9PSNOraBh4wkIXlJhO!+8Kfh22btgR z9(O2LSY{UzPOp-fsPCV{8R3U0O{=9?#x#cCVo&Mmtv#(favi^f!M5A$v{qDxr-&e=TcH2bbt_9`^|C$DYb#H~t@b z1LXr_L=USoNDkNA`aI=E4C){HbvXYd=XIm(4-sy;Vh2QhnH}l)RvQ9{QZlsv0S(JC zPF>jZ0i~?j4h9}y8a>7*p3|%52SBwzgYeS&Cg6dRQ{s9S%;0Q$*x@(S<;2nvF>2CX zXBr0{u{A1tBrkPFDasr@e%cs(`8;&_W=D+G@U}j5o8{Epw|4CIb*)}*EVtnawr6Lh zLA68Q@+*GI{Q0`*vM+31+fMb*$+a<0-6-hLX%#+5!WPkvkFjO277N4IQ00>vDPR>7 z9#K6U$TFb77txR5*%IHwBp09@LxuM*M=jM$xV=Z0Sw&aZMw@BK$9B|2$*I*~N|r8P zj0~h(UR5_jk!fiDc??>FBGY9v;2fG@bo$dwVe@Ts&Zcs=skH+wTHx_pIF0^#Mx@86 zz-fOgceISmOZUV6pH^hs=};T&*1ZZ+!GfRPe3Wr5uJMZ8&Zy}o$y1qTBg5#N8Z-`9 zt7PdkD!R$pk5aD2&$Tk6e>Bddr)bRr*;gfvzjEl=yAp6=*L-w*9zwBC>e>)CA{FH4 z`dpWiAIKA;z5!`1-{2vE)8lUdpb$cc2pj+a&>ep_D*(&NMix3a%>V6_KYC$EE`?w%aO*<(E>H_;TUdd(&yN zth+*6lTy`US!?t-l_J!!3^^FsNCok;M|a8ktLgUKlvBe*F1#&7{Y@9ejS5`q2*MC! zfn0VU^WHd9tT+itdexQq>^xgUs^p*KIG!;8kYuL%pZvc8cBUI2W2XQt@jRm(AnHpZ z@tm{%FMz_@`Il0T6`C1gdqu3?R&wkwd?LBBIFyS10{^+zwTAn{P8$z|h(pNZ=g4IN z2?$<%eHFb$dQOl5u3QP-@&4O~R=F$g3Bs5eXm&LVNGT+n>e11?>$Fvu8ozL_Tz6l3 z*&X2>0SCQz-IG6TyEDGU-qWKE<;rP@NGB!%n4}l>^u!zKs}I%Y7=}Iq!v@G=)WUFn zrz;+xrEIfxg#5NnhZI>_IlwY5I4(7EG8t=X7 zl73g`rMl`XUyKN?=*aN^@Bs`t^rd?O-glxzNO8ll{R!t&tcj%FrkI@V9`xDP1_?O6 zi;tR2iAOfU#`XI?!lr9qzQ1>o8}#hum`f*^lN^)?uKBwe>caZW%xdQ?Fd9IN^$(pj zye$4s?F!Cro+-Z?gKw_GxZmkr>`atBXf@n2d&4wNTSD^cr1WdTSS5^uYCKV;)9STM zuAi%;ZF!^D^moVzW^|TN_!c+0vz|Jp;l5B{!XhI5mElXkzq%GmfDLm0Mo%dU#5$Co zAx71|9;_$FOGih;JsuUF*yf72;>0-w8y3+Yo zw+t_-uHcRYqm5h=XAOG0mLTiA{ga&3EHHc!G+Fn77n>ImjqDMGbVf^XvAAqNn7~NB zXnu%b%20kI&ZG%B^BrclRl95x4FJg84V)5)apnJHh_xtn?0>bDQR+W@B4^i6=8#D; z-CCcgo3YRd8~REkyDDrbO|j-KFT_pIpgWdt!Qfo2WUjfbXB&27cb3NB3}~Hj6^)Fn zp{mCT3sAB--o-&&2^@zlAZ3`j7iB6i{|RcD$6WE<+e?EAX^qE zjx0Xg$O-LiBP%MUXDD$ibg<^gG$_e~;2tT36Dw5A1)BGY(k?T}WmAzlf9oT+mv zgW+XGh)ak8)nI*2++A%1No!Qiw0T3Z)~or?w7r`(0qE6grvpc7%?U$f2a^J5>9cA6 zYoZ?ySX|D8RnQcWO8Xo0t`1BT#1Jf_VUCq>^9kT&7*r-%t!%sPVds7w1lBS7rHkrp zJZo5T^nc2S|2%FHRnER%Il(2;6&u?F7I)>v`t?Nnu>8jAzGa3Jb{T0 zLn$CXICxc=^F)thuwFnoOdSUpgtT8iNiJKGLTjrhz5;tKu{~N@$c_-eUiIp z99OC4p2U?$o6MgurSrIxXUMmuV_0W)CaGk?!k zBfJ%E0`+JSRU@$VhZ8co$p%&EfVjy<+jDGv0Qk7+`Wv0-ysR0|E0bkED6*gXg zAC-dxx>fb_t0wJ3O3}}1M_{WXhApI=t#&NbuGO4hlU^(1%-pG46`H*@+){>=wtTz^ zOS&+zpu!v#8ZpCTqPwAigfb94b12k&wuU2#WQk1gI-U&U zfOlg^9$+#AEyT~zZGNv+%D>l>Tp+I{RrPs=_C zMK)0;+rFeyb@SoU$JopP4TZjCu(rK74aaJA6$^|a?IpzIbHnU-RT$G?0kHT?7P1Pp zRMp>uFWjdDMtH1(mldEE?a4FZYxWfIX_{D*Y9<=LiqllrbG;>js>|%(wZqzi@l8uZ z*{S^sbUZ4R?p{pYyjVFQnh`ya0Y(*=^(p}dVW59hs4aa*V?;=B{}PV|t3#|u#vpde z6U{8Bibs?iA;;M~m@#g$j@Iop8tLr)liXTI1}KEE&hnD9M54CDYY*SZFgmw|qFlXa zgbMn3OAsa%5$XUMr~v4qBSTB+V8uwUtY4GVpOV zI8}-}rE+g$cG7r`E>@7iIpa;J7liUwox*+%CY7+KITHvnMy?FkzPIo!2?t)j*np~=BbgPIh z9pT=Hr5brSf_j;V%_!IZEE#B&HbI@$`mrQNU=Rad+B15~D`@gV`P~_`V;iZkP6X(w z)9tDh9kI<5Th(6y)oF+3&a?stUo>@B%!j<(+9>0=jl7Q zUs};>jo?E45zmJl2vch^_>>AK9m^JNR}DG;a_5w6-}agZ2)89?<(uxF^c8Jlx6elhoKZHsOl;tjifoFi|V}x>2 zA!l%@{K`hBw9LABaxJxI7gbcBOTvKe0@ ziUE3oY24qC8ib2$x_}>mjEWmYmUk#!`G4qor|8K3uvxfcCmnlY+qUgYY-eIlY)w3| zZF6GV_GBhDCT5@hzwi0hx%&E|_v*guUbUa!URCu}L7_v>igNJ4W;g_qFQWl5fW|eV zyi$@mOvM?WO_JSd^CEFLmN^rZH1=|D043RiBNvjy=JJ;e0rnpPXhYu4WIy_uF%c2v z=YP>qqc^uOk*IdHETeXYRo7iz&s)Rur&J|$9@qWP!J0NZlmHFV2g@s8Sar){d`x4a zupXS`Q4UcClv3#{ZfW2_3f%O@g%c!W^9Np^^rKrM2o#&=>la07!=c~@1mH|q$$K{a zO^$OjvfmQ@%+<-COgl}gY_o=$G`$ap%pQYBB(p)W14C`}ph$bDm9KrRjn9d?cqv(o zVrw#n$`fDB>PfBAW>^6d^6Ip|s{jCv99dITnF1d~EVcz5;Mk9qc?0Ck?kd_^X(Gsh zFjJ~NzgRwi4G<4F?H(;5b<#bXq`VPGkWC9=BNErxt_X;b8L4NxokdAwKXFzq3|1(_NewYHRw%Z45kzcsb*sMsMtLf1p&@IKx<(E1<) zvyXo3>Of)9lDba76*>bcKk4jzBH(P1)O0iskYPA<-$p0(&bKg(_`PZBoAkVFJNQ^F zHeZt_z3h+Z4eA0;x2fp8(iNC%YsL0r1spam&eYbg%d@o|Fl-EUk^B7y?zF@0gN;nc zB$78p&0}qvfdw@4KW^52A*Q}g;(G?Hp`zd=GSO@PH|35?uOp;I^cM)f@nG0SWPumF zlyNE}<&;?cf}?WiIq$1joB73~aXWAR+v21$Y?B9ivjct?t4k^~DUKAU2@}o$g&O;+ z+*%5fi)?{GJ}5B=00#IRD(jD}w{u(0DCy4DFtC2SPY+8dpz-#K}mC#B1<3BqR$014c`-fTU7K8SkZS`^pH6M1b7TuLhbtXUj z9H}e-cjqGZRby9!I~=)e13$C{bbg@btvrT8hmkDK&v(Cs>fF>C{YnA}Bn^Uq-SLrv zr><9t&dhuJ*A@LgTr7Nd8dWjbA?!RlH(;sAeU44dsYAWB{wliIT}09uDZAD zB%{!RDOiyK4|h?#Sp2-Ac7yVF){?)`f`u9k~-)8q!Iib6!NXaW~#S-jL+3Vu)dX9Y|&TE|(SXP0`JY*@pFvG=fh zuh}SH)LK2xY5o9pbnwiyx*fL`<32q9c6&s`BYJGihMaq*kD4ilkKgCTK-kmG%w7AP zB5S(l6OE2BKK_6eq1zvx|Ko;r3z6wTw((ZU+=Za=Kgbp8-p0e!*?=MUrNH9EE?01- z1b-%7+M)4HF1OmQ;vvTQbgOJi^qm!a(_*KcSHjv(!SL355F~PFd*j;~5yYK&@hwMN zKFG^Yqsb^{T?~&bo`ila^5ow??)&^$6C41$Na;ybVTU&3&yPD*(FVe6L z+EXc)*bxmHs)bL)F4%~qs5SnO4tmA1Ua*zpG1{q>Dzo1H-FFTObh=I8@E3!70W>A(+CEkqrI*0j=vf+If58kr`E^e zoQdGXXfY)zQ?o7mp9M6>5R6#l7CcmGmHv(C}xJCT(I zwwY*y6Ub@=mj>Pn&-^1x@v`M%m;2~y4B9;~`lLJz^u~4K`m6+yvPE&pa5txQF8@hX z@I}ilpT}hev&Bq>VOPjA1x9uLQf`Aw`2PA$s5Kk(+0%Gj0m1HW#;TY>>#gnHs3ATy zm^{9K%`T}JjX_;6Jb`PK%<6Lg>FV|!sn3{Fks}xyASt`7hodVwD5W`_ zR8i&p+x?As90za2Ub*S{59V#uIertg7WS`gTsCYf*oro!j9&HZry$Y&w1= zkB3U_5+l1LYJ{~%k43wh`Z|47alpPf=nEtZn@8b#_U*h z$_@_vK-htTh-4u8ptj$Tu(_b*dKNA^Cr;^RQW}vW`*eEP21?bB%v}b3Hv|z>q^jXA zlir=-{hlJgBt zPi+zB?>QSv}9p6PW8QQjrbCQhSr3@CLhy(sz5p{eD683Yq-wsdJm3h7y) z7gOF1pyH>{0#m_Iy7hD*F0ib>d*|PkCUi(ejW)97TOO$oRSs3A>#)Yy2I$?WGK`wD zp7|S3P-))hsDgLQtW(l>pT@&y*h>US8xJIW-#$Rf(wunTBHvNdc6$jPP2@rV{gK)^^t`^F{_ zxPMhzSdgZ5g`BL1g@&XjgvY~|#rjek$tY+eI=h77wqv%Vryy!Wb>CvD2&oy$KH+x~ z22oxIs~lQo(w+7O%BC=0OiQxU1j!VoGR_V;2(##C?sV@sscX#jYp2F~BL=uRKRR&3 zmx7i1_$)C{uP2RC&V5dbPN&!`A!_tP&g!m!J$?k<(AGMcfsRM-_?>vTiq zng#rmE_J0lY6G6?_VrobTK6>8P2a8q<}jfn^(tkgYJU%RI?OmIfsdnvdo2r zWf_-E3nDhdn&>Z!w>OM9xck%^pXRGd&CI_R5iTOrd@t!`j`6B+$YCP zAjoW_3S41`+uVrLzZRLmf%0(pw7)!aU%mR!3ZNu17<=KhAo$ zrWvJXJ@kx{nmZ*%xq5^{GrZdV3_mUtXd@F1hevI^-PG=Z^N}Qd5wzzjRHoZDb1jYo zTJ0Dcg0(531$qxfQg*h>m=R%%b5;;7k|(3hPpfH~Yzj&(rvzx4c$TNLI~Ta0JOe-1 z0*fDtK_LYVMaz#Dv$vEOJaLrXNUZ;zt64}v02oILeGpjH7cUVIy5Iz0Bn7%%P%hAd z5*hs?V=J0WFxrcuikxdQ&F-YZ5JYYwXY!;Fz7to+Nm;m7%X0FSo!i4UHtETu4Z*q8K;l)M1zm1$ki4h z^@}cD%;nqNcb$>G-2^S;>NbN6eR3MMdF$LeDRx~rJ5!Yi$SdejYEu4CFMF35_h{IM zaKhtkk33LAG{QR(tSDY5Elxln+UbX3QF_b0rUw6C`Nz~1(5JXzUQr!r0R*c3Z>>y= zkgI2v%Fm&UgFy@q)*SX{1b{)8c##+?*)*eO7)Anh-zuF3THCG)6D=8E!6(})4;@h@ zXneo;I~NoCyH>NNRV-7W1EGM<{32-OA26Q35^JO|9hr{|zWGk2Kt(d=#^_-p z0t6;0l(8L}$C6#FuF8vx!^pP&uH9|kaTc&9H2$z=5Wx&F+o>mOVEkW3EH&!+h9dO> zu2lz~TXI$;O5Uq?4LJ19i2&k`l#I4mO!X@`asClP9Ez_n(QC^h0+VbcH9lD^By*SP z7J`yxShYoymevNQoKLwnu6Ty=`|`Ww{*T_2mRGL5{lx}McNGtqlT(X;z__NK4VMh^ z5AhDu+8@-uYfp53fBr5o_Mr+bx@jkmOy%_oVxK=tU4|ZGl4n4{{}X13}O`MqBobl6o2u^dExtu^4=WmKO~! z6GG`VLP-Ryr2Rpng0)^C%0zgJQEJGqV=GC?mVr)!GEZvdc2-s`$otJYVT_tPBz@yZD`b25TEE{P+#)mT8$@ zaFjjgv@`1H#LTMWzKqUo72WRe^C%u z2(6YG;MP{feP6{QFD#nGxi$nK?@pa9$a=AGMLOB4jkuORE|!<~E%G#F^npzkX2M95 zJ@er{{9y^Z1mcn2@*Q)5Q0HJ}bX&8D9iLMEMmrGF%A0NC{ub+9ZL_yz-Gb? zH#fPL&yu}?@ElyD_pT3x1xP>?kRk>NgkXEiVDe`cp0EF!Y3TfY9MNIYNu_!jK1(;b zm>V#?yk2kO;`t9ls!_UMAw^xc=iHqUye@(4=u<M<2dIdq;b=F2~zFK`&;=zx(4)A=$D>B zvnKe__QS14o|bT}6;{hVNy;;R(}-NsliWvosEz8HeMf9+6z*Qt3b?I6{Oc(w8YZ zSG8wyuj65)zGI$P!r_FOie%@!XS1GR_b8~Fe;FVcK_aroQ<}ZtRWle};T+;?9na_a zVKi(k^SVtSN+}_Iz0VNV@C#8BYM3+;o)Qki3JRVYT83H>GRU;`P%dP$a;nDY4o%7= zn0$xcU_{F>gKT>!5h6vloNUZ;C6!~-+gjr*!Pdu@kiRiLc!W(W@pD^JW-^g>O+nbA zJbKM#A)4g*Nv>LU_eCS)BVneAt9_FN^9|ldJLJ}<3q%oexu5h>G0AxZEqsQ_WT|x* zqiEPRL0GUisiT}3K7ac_t*l-kUKd;}S2o=LAeS!v90Ge_v!Ib_eq%-ZCSnSgi|1b~ z>Dc%M!YloBBeLXI&pA^=r3x-vtcf254tzL_wC^1C<~%EaQ)ek2hHN6S?dPjh)2P;p zBb461c_j|D6;i%SI1Yyfo7B`nFJ(DPYR6l~hyqhrbwNu!!C6sBx{J5ZKdoZcGQwbY z{iorS-y*`vkG-l<8w&%W`VW7)K2S#tIkG4~qsfhIX$UVUQI?i8Tb$Ia0uTC&W&c7N zfGnuZ?5rEU7-i__3tR%U0Zd^)(sRv84aH~w`TQew*9OkcXyOtJX%Y%C|bs2gg?r z`yyXeVIugXt+28mVN669rJ9m3PrJ$fkcP!scIwZ`z-|O8(&+O27K=7}Cfre<#}f;* zO;~#5MFr>q{z$TvaNv?qx-yV`73%Bp0=5QxqFV?b@WD}|szv|e#wi8x1nSn^krej) z%m0As2Q$Z8M~P~9IbTc)%>+?{5g}#^3i_qQSx>$J;Vmgb>M8#qCs84YA`8zi-js$I zx4`G{vcTU-C>c3gGRHaWXGrZpCj zjv1*S&d)XI`?k{5+#?`BE1$NR-e&YeURm^4)BmXY6XX{`up}1C8nMbn##V@zLJ`IU z_=SpBmOlnUaqRFT2=FXXJL|`8_mOFbtBog$A|hQXZla{M-5__K@InAkG-ten;nLx! zXG`_cf4qmTWf&^&FB@4I4+RJI=ncPrkm=>>Q1+ePn%{og zrKZZ5D6SD##&Dma1Uv47T59$+TLM-`5^O+^sa+ubcxo^e2qB+&UO0t-_pO3=13$J~ z2xA0hX0-ogAUgT$1!M@Ku4Vn4%1g?>&PZeFQo_p6q_Q#X>A?^e96LPFG;O+>TD9YS}ji%?$6hf;#AEARvGFQY66N` zhSJTc6XkwtvDrJ9`7b4)I(`V8U)NzGhQHR;$cA|7C!BwVmBaMjW(>gVMMPW06yx{x zxkM=u)5nU&3=|F);aw9yz91gVyC!`g_QC4~nsD_T(jXNRm5tcBUve;N8BLcQl_eb=D-^7GzP z(A#3?{uv4u0HB!W%%RFxGKL&nQ0Sa&*%1mr1B_IVP0!^Vb=R42+=`p1*F zCE{xJThf*vC0*pEzm^f&LK=_OB?}*cnfW|{`^a>(bLi1#tCLXxo-yl>b{NDB$4mQ_ zzoh71-x(6d0fk3S@pYfO9U-h6mTFiK)^}-=FWvu5xjcfCAec`p^)4rAQbR?%9aG3y zoZMn9rAEAgEVgrx@aT>VXmcPClKmoZzh;64vx1-$7<|*RTld-;Kq`URNREy8Ge9}e zvQ}*1otQUwrfEs>yfBaV9THeEU*|TwGfe1hSrO{m%$bJVr~2o_Lc4XT>*0W0cJdz2 zp`UICbhrSg|AY8jk#_IAK+Y?fgrF-+-VSyZNe58DGqSPqBkiplgy~$H}N4$82Td`GOlh5d5w2tQ7|oM>11O<;ebGs z($j9k-qHraP*Ym<&1k8FwmZbDY0LP>&&NOm%}XE5eO)%T4YK|P*YTx_+frD z+C36fxQe_*gUk*RK$8S|BWSoaF4i*6M+0MQ9Nez|LGGK@zX(_|niz;z^^E_;}XQeZT{yL zcP4HkmiG@kn~sF@yMf+1JB%_#Sk^vP1~)z9=$^H`HAS<*NR4kNuvnZ?$Qm14V2hq0 zG@{OVpFOWz^6K&Om2k8|1-JQBrup;oD;c1uCTI0#h8KEXCK#Z&9%acQ8bTIhl?(uC znT|os3{(<}CsnOsNWq7aJ6tt#zns#dv5t~gymMQU=`L?8>6p*|NF2azs_qkj_zH%cby;c+zIJdqH# zAcm~W(9KC#v;C+CUA8!$ugIPTSXq;3&Nv!Q8e3m_6?aOIh3YgO8p&tbvjcFb z6W%BLYjJKQt@XQeKV6(w3V*fH3b0gW+Y)m`Hlt`i5lZ@e?CopCW@O=-?hWfA&}ksB zSlIa@DRfcEOyt~^Q;BU@@^*I2R#C9cb>2T2ndd%mIe{((?u$TuADMzx>A8}m05a~E zZf;oU%>K$yTzCM4bm=2Y9gfg4x>iylc8zi1C@~C3vgFK>U$t-E zaP>5aPEV!geQ;P{d|9`(xsXwEIbDLTcx*Y9yE|FyH}{MwSkC^FV}qkL&-rmlgne?E ziZ`4{l_hWEqV`m=y${=xD0NUfx*}V;k)hqp2c_VDND?ve%P5!(%jIkzd1tE{`8Cr> zW!#ry6{W-I;3kS{kH~^&Xy_meH`{=F_H1WwDs}j)TwW=zl*GpUikp`-4q{{JE#>B> z*eF?*rlCPu+d4*@lSpD($s`Hk4HnJ42^Ug93r#q)F~v{o3sbECNSa!-F#N$}8~@!o z(4F&dAB3vDpOnCN;T?G)&;>OjG=MTC%S{`A1xp(ogeQXlnHK_sMh(4zfpYAJ?>n60 zjA4~S{|~4%D^4^{7kUH3ijGB!L5XUzQvPEJ2}z@-Lp*CDqhW7POS+|2i=#K8TAL$h zNr@7{_sg1+_0Mnylvd@3wD~U*zVf~dXphpMt)m+wfBka|b0E(xSP!{{wDNJR&%|#0 zy(Ccl3l(_%ANP8$1klwi8 z$0pPcB;SsjSFj1}eFSZZe@a|1j7q3ua= zX|7U4?svI-=R`PH?{$Z646Jf1bIbdgQ^ji52PbYds515S>=X2Q-#x>@)Bh2Ijzd09 zFZ2<+O2rl}3T!>`nS_jm*0~WUff{52TAI44flaBZNYu0nbkJ~c^Qo%WOP+v512 zvZ6O$6{AAmh?Z;BVM`EVAU((THZ{(Y3<1vk*d8Y4;m`|tQfXZYr>_nfz0$UKk@qjcr z!U#`Py#LmyYf;fq)u?QPk|EUI)pVH#l;oaf%HnBO<9prR|7Cpt_wpp=#wUH#o*K9M zKUt;VFHcTgSGYP??N^$;8pxr+o~wQZD`p?`w+@Y8; zH1pe#YDhWsJ#AVtA()-lUup>2P>0-1o2-^ZX9@JH5kG{`dKL&p8g1~PL zRO;bokjkgzirT0}#Np-izzRjEQnFqI0tVHoq04abtZnwJpN#R*Yl?Wyv9LMf_<|jJ zT&Sn>)fStIQphzNE2CQ8)5kn~U#Fed!%FDTt6 zfIl63!lJiZS^BIz>ANs?%%-K|?}~78@_%))Mi3he_t|Etuy6d}T?Exe81=emo?;xy zWQE5sV}6#R!b1y7@AD@XRLoLNXuuX$XHcfl1^b=fd}X7~6m$PQMe}i91vIsQf$z%M zpPVmEo*B#Gm@8u^DR2`{)6F6^O<=%ZsBHpfu~*Npe3X)sDPacmh=6w!K~A8x|Cbi_ z|HW|rzbpMxF%mwbO&UsTav^WbZDAOB5uyGzg@oW@&Jcn1xLJ^H+U&L6IRDsQ!C69YLe&_x7z@vf-iO$LrqPyi zau-+3KH~a_NEzeROU0y0*(W(*S5$cj1Z{v$#8{ISyF8NlzlFl~N?I|8ExPcBR%!9j znglTqF-n!~V_^={PN)vZ7VYC*DyWb&jtul4GuU5r4{hw(_Oh1=T6H>H;FZ67Ymcs6 zoV7o!a-J#>OJXmOO#XTN>J1y)YHuq0lOfnl)FkT=qsDuVhRPb3%deaDs7R^Yg6>g) zB7xDfH(+af*()IMQ;j^Zl<~F<1@x*0V?!1t zLPD6tOoVvDE#UgVuL|{novtU-({1AU_*|?kY?>hb#p-5(mdZ|wwNYJjrXzmvvFlr* zth>7^#N&S72k~{M{rRxv%Kyj!T3P_5G*;Whu|-90*&)%`g^U5rSl;_J9hHDzL5%Q3 zcC^vl-BO_wLDM;!H7J2Ne~2VI*0SYg#s1Qj`OWV(IVYi;Dp6@9re*W+Tj0mjXT&jZ z1zkICG^#UefpZViIXnl4f2D5g>Vm=LMvHIyBu1%>vk_qbT{!yadd2zzP= zbj3<26RMnFjAAyv`j5=Y&tY1IO4R%`tb}Oc9MtE_ti8E z=uLX}sl8Pj7FJB>B$NS3U}1??guy4O^)eM`^FuO`veMGAE&oJBVSJA1pcpohMSuzZ zh&+}s9q7xe>~u5 z{+W-&95$m3Z(wJAv=m+cZ+mfidy zRK|VK8_mb3O(bR=p+#YsOe<`@=MoWe&qG?#4pGAp;Wuusio_e4uY2moml3-jq5JMw z(!9v49p$$kT{n_pr%Wk<+fF*^=yDM9@#5@_Dt28mzX5;&vi=+g!yNS4&*mmaxC}?y$Mzr%FpyV<6WV4;H~+ibs`q552G4r z`Puz5QiG_>*s;}8)(av>uZtp>bG~D&roDeU_kl_e{)UJM8H=&g7^Fwr)aZj}`$Igf zGfAQ7TaU^QKqCW4?CN9UgJ0Ahn!LdxVkmi*yps%3kQT#m8eWw^Ngn-}F|0`Y%R@03Hi>r1Q z3pl(y|Bgd$xh!S;p_qWpZT)PG^DPjU?G^-0L-*0}M~9^POTYZj0w4eaeiCtkmC)i_ zchT%J>n&lS-w=Vs0vQRrVqAmgqNvb7d`NG91r0KHDHLIUQf5V5%O2nJndFd*!2?&KhAf zYmqjjDt5;XPUf{ihQ;SuO>`3vhQmh0l=Br?1lM!^)q77-o*OcOLxZ|Ww?u2sk)nk8 zQ)f>)8H}8ZM(L=0>e6!(rL=A4+@z=xlP33|@G$wLNmWRD6(Kkg0x!WLadc;0vUghz zrT$qW0$>HU3;YK;Zq`EpOrXW8y^5r>HZ@|DP?RU$ZMstJU$lv)@(aIdYzwNDVh9LG zIZ0YMEQ>5B_+Y76*QbR3n<(ek3VHJ>BbdIYbGb7ytxa>|WZrUhfTLMXM2eOsZ*iqf zF@t&vp0sKKv=BNe;#-XY=*h#$gS^rsnb8{S?pu_Hfo6ooFJy`NuCzYcJK7XfljGYD zxHv5U0Nh0kNS!4*nI|EGXCy-mxs?e^znH?I4_1z+*2irSr*`H9bjE zAVE;#n42KxR_^0E`wVAZG9IJ<-;_2z7)UF>p@GOf7=R_-73AQ}9v zgM2n8`1iv_Ih2W%Xc#O5kTyc)C7{K?ixrr>(8n=*60c#+WKw4DcrA>Hy|wXdytmBz z?w{Qa^ZiG*zcNd8 zo-12y)A$d3@7EqYWIUr28p#uyZdZi;d^yfVCM{4C)*U~XTCIWQO%8MNgs{X4FVsK| z#b$zNY9ty5wUp`XN%{`fKgT`+ia8zyL}eF60etWPfPq`AKDP~~`wTsEbe-o_{VqiXA5fe)e7hSQ)r2`&J;%b=*G*jou;haj8 zlrj+P*mDkvAxEZY3f?vI{>p-r2wvh-XqZ1&YJ&guJnC2Uw(!yy2%1R*pbMG+5PW{S zIKyGlXVU$6N5641p};7qyETIxF85|NX;2tQr(oc8U(=5U@S;tp8B!$A@g%~ueFzq- zwqppHUYADyN*Khi)MqqPjB&J@sr;UJ^KN^lk7~LjOGYmmEhe7z#Wuu%COr;uZGv4j z@p9I8ncLK3=V&t4#H{mrVwOuEop`M|BuYf&J#+wNheLht!xnxG#9>>6WnXaF`nzPz z?W%6c$nicEH?ibzGaLDLUW8x`@Yu0*;A+>AbPXj4(rr5>Puuv>22Irz&9OR)-BC7D zVl|XQbH%9B_@E|8^r#NcRIhAs2@#Ii;dNlnlonH?hNuQj3Jv6BvkQEm#bXr{41%X~ z4oG*u6iWGI{`7*&ap9u&=MEYoa}R{&taQ^DWDF*@-sV`wNJFV1|rn^Q9w}}*_($N(+Faj;znjJst^ll{b z(NurC%G*tS%O7nYz1W2Qx1fbI6Dro+_6Sj!V=jKL!eorL;bJ(tyY)szXPq05J{qsk zv44#LZ!P|8@vH7O#FvEbeI{Uph$?VDS&3*SSM{qQ$laL2fg%z!2y1C5sYB6K6(jfr z+mC48YQADmXSC=L{+eqV8ilixuB6095Zu6K&lQ$N3SEuF zkw~u9b)RI*u=x_uBUVkZF+F%l9tV#Y9-ena||AK z_d8i6=wC@#taktrIIjKz(v{6<^M03d52Y+ZEdy?CHD5xhhW6!{b_O%Caxzl6u!<=0 zu8|x}0F~@j4RokRrWU0`!di0*U+j76?TPD%E@uQ6R*8K}Ns|v&)Qu73VhdId2T$YX z!;5*|h@#w43D2Bl$-1TkP6@ecM-3nB@bc=O>E&zaLg>pQqrdNw2FVhZoboy zox8<9{>#s>h%U{ZdIDnMH`D~sc0d8!tqijOE@TA=8T}z#>OvO$Z8S+(Fe^>2XdG3; zfRgP|-(2k!m!j@AN34QT5%eyi_;|C2FH!d5e!B>y{W#nxkk3#Yy7iW1{aBfhFh z1Fa~!&H4@P&ovECR{;jESiYvuvn6WAc4A{oC6~@~q^$s{vzFxW_4pN4?w3(;J^X8- z`!Mv%$k2kik;Q4{^IdkH)Nh7oEbrFLXVB}YTRk%pqm(_drgxrpRn;FAbC?N7EN3(b z4Jc<{xNSql6!gOW|At(g>Qe|Tx6R^`x4yGyto)8COrF*Xc*qIi1-G!CwMGzk004&21$!;a0e707S_-(g%_@b&6&^A9ueB#YpnM&9W1GEGI+>WADcdR2ewz3vW7VrSLg>KNiUEbcKB0rdOw4c`EB4tURy!=E{#a7$|J|)63}w4B=`l0=afUokFxV5U55dP%sWB+b>3F z_ah)ofwZ~nGPGaQJ4aGb)0b3l2MHE{Kv#PULwbs%m=zR`K&X4PaWRB7XFabV#z2P9 zZ<~DKpF&fQks+_7`80Ql6>iRvng1oSX)McF&%7W(0pqFgf8GWX1xV^eG`rE210b4iC8{2OQ%HHGlBr#z z)FNi2CDv}A;oWe0UU1RvdTUqOb{p6&Qdo6*|GAO>($jbAXh;HLS=X|FB2x4 z6`Xo1f?`oUSHph@at1;IZl(_QofU!CCIm-I76?C@2L5Z9mNeY4<$SRiDrY)pdlRZTRg{-vm zY0xgTiyQ@+OC1R5qSQXpb_OMNizD)reeZ`t67B3Zg77qTPPbYj?40?%ajRfq<)p|Y zfX3_HPcRAY`nnu5)fMN=va9m^(7&eh^4A3}E$Q0#yFlci#8~jH(GKPae&)aj+akdP z^FQq?9&}CKc5vAL2RTehu=pTnp{2oM*yQj{en%)IKx-vktESX*V1~`EH7xb73Szed zyW1;Lp){V31PhllwupGp{#bXMfADYVBZu&~Eb59_Mrw3~S)E^O;Y9Xi_fb(0;~!tH zKXyT1doR8kscE{Bd`?m^yfdvoDrLV~Iu-n#qO`zj8 z7m^PuCwKS2G&8vee6bGCm$TZU%(fLLrJB{?QU-{s8um}{rx$bSBAPQ9)^Cqk2?bvL zos1_OVZpGJ*MdqqYtQ7TE*1GWJ(ejF(}bI5S&l+UtK_DnP(c00K!6(Lz4b|CW3}We zbxA8L!oQo(Sz+x0pT+Nqn{ZwCYTA;&*A@8w*vL-Pt4Xq=)@0ea@+tg!@{oTe4=rji zApS+h>~Hs9a9<%J+nL;yz-Qb1PNsAox7>xNOFPfi!l*AOC;2}S=v89HkKQJ`uC zCzgKLfx>(TnGUVaOf=29NB(&jtR|O`hajhnW^HX?b{G zAtEFkXDgV7GIvQ#A_eg(U=-Ev$?+F{g>!b6Ddrr*(`elK;>n>}Hn2&flD~A5o?h4g zGz(4VVpiz!@^oi$s-@ZV6QA*tdqz%`%kb`QIt%Rvk* zy+A`5RP+_I=&{1uRlTiPhSt8_eY@WY;Pfuy@y2NU33y}6=oaDm2XBTGsp%jG-cR`P1`N42+>Y?Jxa}BTon$-61P%5Wm_rdddK8Q% zZJw@2Wqk#+^@iuF)=(Qs->j<4XO*>lp_gWTYD!G`k-nB}Z2#lhXBL9SJQ#JHHd-i`D^*iFL84f)A$3S*ZRw~f27X%+fw(fQ10_Z~?# zsVGS#lT`}V+c}EGIq`akUXnVQr0-6a7>-D)UK7R-!{DR3w-BfB9y$*Tj#j8*eBHIG230N#LgOX!2Zssc-jvN@7lWMtAh#9z5Cjuqv!cPM)c;*RX2;Yl9?S5jR!yT@^nRl~_+Wi* z>E=-;;Wp8iS${H2p6Won3*TI6Te{DUr`O8?SqxnL{wcB<&TRxIaI$Ega;;0~8du+u zZB*xfe)Zq; z?@(c^p>DmLl;bdPFq#zN%N}(h!E$yHXe3Yt7~(h0C_vG)n-tpFuZ!W%9D~wuH##_b zi3(DL(;k+A82BM&z7nlEw}{M11;2lZiWmvu>(DuEBn;}5F-1wv)7mm*r|&GHdOXCC z#HNP#<+mYpF$#UCc(b+IujzyEmXTHJJx|tFo<4q089yZ$1b%R#+6F#2D4iJX3mnBDAA==BLobE_MJ_m)-S@0bq-_i5jliK2iv#R#y@XSP$`4 z_BLMi!}%LdL=C};Fn>sZAU0?$ynlv}!^H37^2Pg1fjLjDYDO_r8rF`Jrq-x6k3sU^ zF>TRYrDE4H)`MeyKy)%{%ekSy%`0b*eY5r(%Z}C2#ARJfqQ`P6XvLQyhm)D~`wW&S z0-x{PM!s?hvh3`~6M3#!oL9&QGcM~Hf-lOsimf9N04 zsK=qz zKRMIo(PSrLQ{sSig0BVO{jR2O3@tAJSb(M4itQh;*Der2Vv;ypQ@nBkCKnt3XXZz#wxVJE4Pr3X(@1cc`1nr4 zxHNU`>B`5}J9GkVob-$M-i09Rz=1|@tL~<*5A^^4dUHP1^{X@9x*2YE?f4D|_n%N= z;-8Q#`djhN0dPM#fy7?rAf!%9w1Jgf)a>DkLgUxKgV9Evrsp`YQpbk42&eyXv`Q4V z9FayDL5u3i~It5HavJ{R6#`8)^&_LwB0 z9=-1N_5P(T3n_odyQ$s!`TiLI4x_EvzjRBz8`FF{tjOg$|37@aRa6{p)HFJ{ySuv% z?(Pi1CAho0gfO_fTX2Wq5ZqmYyG!tdph4&Ge*bsYe{Y`{xfChy#B4yBD_r=~0*B@Z_%kDcw_BBsD+ObJO!i4y72gy=%9zg9)M z^sMd*8CDr6?zIy8u<$v>^nb%7wdj3|YlIGUx4SRsa@ zl#C(MV^HIn@P!o^aEQREfdKMR8X&UtKIa`wCvchx`JYN!=ZU|owSRfG{9TIi&me>ew zZdRF&mYj%k4hO`WFQ*t!Wn9T_=`HtJdo*e1h`l16S$W=S??#e0Q0l9w=C3Rmqp`(L ze0g=@HgFR@-3V26JbblqX{2YP7rTw-b@c!F_u-k8sCY)~XoV$Sr{i1av{Hb}u3p}0 zIH(BSI@}*_npiO!gbGLf?L!whbz=y?UP_zU_$#{l1R@>^8NF198jqD-A|N*x?K!3-LKm9)iRgJXM!kr>@?GdIi(8O7p%g zojT4mKe!nJI$439H zav5=w0Jt_=-3wINLTyI-4bkvVIIXERwVd-+j5tmrchPr7D){Ja<&8Q5zpxinuuEFi z$3X;cEy802oZ=h@3?k{|jHD;i?e7D~@`-KCxYs;N0Hpv#Dhtk7eBkW$pyzwy zauMfewI`6*<0s$WIMB5s-YyDAu<13wwFy+JXL-!5sFJL;YL2}7whjj7F4RKLAgj+o zeeaWsW9K|V#O94mE+5$rTk}nh1I%&@YJ{Vs^JYhbqCC0_A%uo!w~Xx7NS`1aFr`Vx%@OcUSl zg-4QQL=Qz0*HWyKa-+Nz!&ir|O0fbgU}D>y?#aJ+f;^v3SBkbKuvbm+KJ;Wymk_q@ ze=1~?XN%_dwzHAT%{pH1yme}TMbrkvsA^;LpRm<>M<1iKSj5Ss#&A|CO5dT@w}hi) z{3u65EC~lOI6j#19gI%DwAbB#&sL~HG}$3^?AqKL4C;FCgSzhg0{Is)C= zRIN`+e~^9s+}XliTJJgC@7W-MaKJw5c@e4ji*V0Cyj3iGtxP@aO^P)JF_D&9@QUmT z8B>rz+e{EzmyvhvENh<022n=B9!a6TTZnE>D9Jj)7uNPLdVkUrHW#Uetyz&_Y=|rW zxb3Ov-Q@QTwmfzk4h~(U4Ny1=X)=!oTEfm^KjH+2owZn9L?!jtiy%=EW%MB;%al{;;TtF@yyW>ScJ!7de2av&NL#AM^+|oc z`~C3zEwC2yECE0rrJQCJc=`!CW*tG76otpfwgSLb?Ui$5StFBYYcN%z6e(%as+rM< zs<&?R7tRBS9e4oy0&qE#rzJ-;!;Tr%d^vmCYyQ)Kl z!;EBTeXEKh@hCf7-);MvWKh&0_Q$d?3P4H z0;im9{L?mf>ljOyyYx2r30sgXBwqKxl7Q{(<(5*{J%a+AnZ&oC#Bp(CuMFtc!ildpe6x`t124LnAVXd zV!mfuy5)|+mK$>=l~jiwVM&J#|HjB5%3>afPy&{)A);14+tp%$FrNg**~3M6xp=4Z z{7=w`^k@jU%+z*ik;$mg)RsA0q~ZsmS*F5$I~XdH?3}(~4lv*{)+ZJ8W-jq@7n-VM z^i0qR04NZx;b@%_yiqC-89o(05FV;~940*#Dry)6>*^8~g(Ks3iGE;e7^(M_d72VS z$^3|Oh|roPT50O`x3-q-bh~zM*cjO>&mk&I&JL8AE}yJ`!Bw6{r9afaMo~A7Dh+hZ z?x*_JdUEBa*^F7<^Ux$-cf*)qq2UKGlk8MXgEBRw!Iqwrkol3yNuuOvA41Q7ovt6x`#mDrkN8O&NJdGCHQU6I_IpYf~0>$>&0KaRbYKsVN$H z)_%=O0mwm{O#UPlxYiUQFb+3W9+`v8aN*M?|8C+K!2P@GoxboHy;S`*gc#v-$s@d! ziC+K)hn`?`th(|}XYI}`$AgB!<`ntD{PvMEzfqJc$d@^gl20&hqDQbg) zAg^!7?sbWflSl2on+{$NzaYq?$RFj9ye?_MoL%b_2UExJbGDiX1sXkUL7a%Rw_J>Rj)->!*Kb?*f@k&-TR!|#>P5GST{*ZOWtQ>t$|CicW zP;%)Pvv(yP8Fi21fy(VR6RrujV!v`W6UZBQ?jV)X@JNjR=8{d`Qy%!Wu~KuYE2vW3 z&Ggr5IsIRQR)*C!2OLzM2*kTzTJCJ?UVLjwd^?mL=}sC$SdPT>Ow%NEJ(3LwzKy4{`z=@UBOVn zuoG`-X^+d?IRTm{L5_=dooFS_XuFEFy1mnuz@#*SK>!;&)6t9YYS7s;q;B_PWbbYn zHo`AL)1k%=Gj^5^)0T{v9atFE)R@$4Ex>A9#rcg0mTxX6&Y-1a{J~cnA@o1U*=!Sh zR70Ds7gSPTb(zU45$P73bbNx%%cFrV5|`Y`OP0ej@dDI zfwO$F8^x4kFTpACpAx&9ReU>dUQ0YCq7JIQi0jCENoGkkY*}mRtWg0e>6r8D@zg^d z4`zk@MHMFm#$s|=dLau5&gbbkwA9MXtO`y%CdeM^uBx2 z_mp_~{$@rWGwN(p!qig4T6qu-ttG1rC>E*HCXu_Wj&oOCDMF=(q0^1)BrneiW>fzS z;kh0@tTsaO&w#^cC<@UJV#w}@kLh<6nIC9WC|l;BAXK(@Uk=+$s&r6j)fKUt*X6?w zC&lqHNnYd}vtRNoliTecy?JWYU+%FgHkffQhyI7tPpASJ=`Y;*RmZwur6iF!x^QDB%B%LhAuGv?Lh ze0LVf%AOo#P{ItarQaNs7poaV#K=6ob+9zhEu#qO!jgFZf&30QeNTG`dP9a6PHW>r zR$+uiHcQ4c&GZFd{w9O&hIt{vLcUfKgEZF?CPV}5C&pn*{G@=pKDstucV|y%~z1&1(T3A$T z=;D=UP{FW!9lNkQg^7=oPM22297T|oL`+^|Q;B|mV zr$|onq~Qg=m(50>z1dfzWJxTuz1k*4ia=+FaR-8X=0}U{Tkhm}%x?yD{K$4Rtd8uW zR?LmQ?*kQ@4!@RhB5o%1-*KN{8z<|?()&vDG`q8c#9IUF*Na|z_}*rChMme=b&b7W z2j|bXCst~3m?k{PI98c?$8d=NUk~f%*a>KRkka0P+)+E05QkbJgz^yTw)_+8fOavl zvxDJ-mgPr@YgIQ?ESrT#tc3X-s`He*nK(^$oN%r}-lRK_;==xX99vUP$_$RI5-+gm zYV#Ml_f~H zx{fP4`pB>j|17PZ5~~sK^Q({I7YQK#i(VA6xTVTv((+J(*lIy;6|TY6T)<->H}e;YFNX?*^-sEkD*iur{_v8%d7@DZXf?C@ zI^PLKQfwS;AWVLk1=n7%Cm}ba08r~FrtG{?Zb=6@=gVy;h2RSFFnMJQ;PRF&z7ro- z`8;+VKeFrJ!0R5Z-Rb3){Bgk<^q(#_qg>*ez~y zTwVVFW$E~J|pe8)Q@+`P1`wv%0NdCqiVj(ue(h0LK1gB?V=&Ew;4)P#c_T4DsQM}0GY8b<3hh|{?q1S_39iG zmUA8UQ2E=hjay(xOVJ!c>car(D4B)07kda-4Yl$s6|NjwdrI#W3W_*_XwSD5P(A{O zDmw9L3&zu!mkGW%#9JAP&*7vSmyjTOs@E*XsLKWqrXkl!XHcPQ&243Q8i0|joBES; zKC*pc$hHtNG>z^j<4yZ7v`4~5oXt~E+d7; z0)~+Z5!O^qV-g;behfUl?1KwU$%ti2ypBZ;^@EOnha+eE}n)TZyx z@|La1Q6=V8A@rz=>#YkpyDx&ETCLPz#T@@=BJ#oE&Y^z{y2w{U^!*q@RwP7(fl2b& zThn4R3swX~;gbW^PW5EqQJ^Kw`)N?3WlS~h;-X?;B$D(h0cpsIPH4i(0)pvk%AWs0 z?$2Z~08YqqNz`2eU}U5JTu}>PYNFBnJPn4HsjOz+I19DVJ@@%;;YF}Q*P&o>F)J~hoqTOy&}0f(vIiZwjRhT?c4v+} zs8%`Dwh@9*wkrRqZCri*J;Ty=(VqBrH|BCiGu0R@^u6;|k9xk0J7sb?S(0sdRhw13 z?#B8}bi9l}tBJK7NiW~|?b&}}EO;q$g{Ep?erbShIliozBr5+@t&3^VEuUBX{}R>z zz7+(LDTHmBZd~UjCMC>{C=CzJR3sJtXwz=c387eIy9*by!{C>W$06Na`{N2 z2QG$;JWg)#5xnv8CDzEMQa;vKnsnS?Am|HQN(FXH@d7flUF}Vn8D2{ zBAdrm!X*(bBbr#5j#dFba1AvP5=Eb?+ssg_v)VW#pePhQBpa_Q>|#M~o4gpc4VoR= z%upl_otizcOQE?D{|FU7_wchM5&N{eEw^Og_S?Av^Q@}F+;ICttjZr=F}6G_1bOq&$~(ca5>Oo>(c2@1YO4hUyKMR(dVS- zgToOZfK#%P^@nf7ZA%P=E(gtnbazB>rS1oGw}qZ1jTFe zDBNJfMkQS)Gp!|{pbg%7Po{^FrQQczCue)z| znwE`dyN?7EDUbUx`=uwC+jQ2+VcA@>1pb=d3B*oi!Q)gT0D(_QD}GdNRqS7+IM)_~ z3edm?SDgM@;k$y#(2Dz)X2DRNrcil~NT%_%E+_72gKr>_N&zU!!;48^_+9Y5+gjO= zZ@SKX!ZVvet{eqg{7>JzFU>@>T1eN5U+CK3{9c>K%^pMI>EF&4pWJP;3N3AG)F0p8 z>mjO;3J63WdBPk%;y@-WWRy0-t2TK_p>&hb{+IM!kc7~l6{2qp^IBuSwq#>U^DvOI z3yKW|ov%=i!_dRxq_RTX?wWbAvqb)iHK%^02k(NL^Ajyp%C6lgi|-^ZHvDKELkZHS z8VANhxMps_ns2Ahx;{0c+5*3`oasw#{AwneSDbVoDp{8+Gx0*R=7&+kGfVMXmBQ<@ z4k(l6J?fqTuA?w~<1*o|Zckpj*ZsIG@R7&;yHRy!*NF^&_D01OG(^*f)SI>RkGwxBY?8MlLgarr9WV(7$8JH`JNx$4?f0PKd< zX9ra2e_F$xZ)Rs=II^i`ait#ne5sCanT4;5<%N_O$>m_J@E1;!L~uDg)YxP$U(4MsY3oG}!rx+Rk#`F2+Qr z4Wge}^P1WY-Imfc*IXrQ%6b$yU*>MBavnSC6YC)v#9`3Ou6jYg-xII4|4Re@j$P=V zT;`Ag(%S2Xl^{}k)?~H%M*}^mn*yj`vdvkBx45vSiKEKS?5W zg2Ng=j5u*3h`Q)e+p(rb46(*tCvVIb)9Sr`f8POr}|jqN-49UVn*kE(>VYjhs~El z6B!pVnK#asru>Vo@(_zx-Eb>Q*|EOZ{-nX9?ZKCCQ9ZYKw*~CHq9;x(Qd-FUEVJ*i zRwXx4!MFS(tE{-({sboNeNXKMwr;pxrLcd^MNPi%a7r8ips*EHd65K8RSLdcbL)Y` zN{;@+5P$0)aQb)On~k>cg!uQPutUtAk+?_BKld~_@!{V$d-2GunKmmBnqKSD3T}NF z!)rI%%3pr2=7`qk7I^shAE!xbKzNEk&b`LGy#y4!z#qms+q7|(7erh6QvX3tcW?#_ z+hnosz$$%i6v_PCcB~b5IaO1o2RP77<=B&!{^}s{Y0`dirL%8R54w#*T~Rp#f01QP zm>X3IDW;pNWL)wu>ZFJ!3UOT+oGE46oxYU4%)+;aptzt$X<6@5rMmH*AVo#HP*amz zH6d0rT``%`Uw9^}Cfe^k5|Td0q=XBkuZHdJ7UDMyX{*by(Dnc@qF1kH6_F_-tED18 zB~%2iq2&Y!Pm^5}4-l-clctVc<{1Y!8K$C!ky`v^T7gs9l{~N1n;KE-ab@*jSoE|G zPHrPt?=Rqi9b$_x4A6+Yqh(Fac4NoE8%U!?7>dnZTOs@$`WsgeBc5Emy5d(O4apaD zuIKkpy$=5>`;La;Avd8irH1{7+X?6N)Z0k9*`IL-CHgJ7%|Fu<$JEn4{8eNT^!%;nb?Peng*|R!9WfSubZmnh@L{YB0GH$~HW*{2L`m9EVZc+i>u%;u z#ug_!Am4scBpE7JuZ$!+AmYSBu&R*Pn-dSWF4Fr#7fm|%DH};QMC#5|IiNIW;BnDG zuc-N*hf8k<3iU^bW|GjDa^>odwGuzO6z}MzD~$VXTVOHaSF{d?eSoh&k?{C`-6li>0f-tQ(ozX^NgAO4{}l% z*8n(Nt0f1J3|G8kOrROVxaL5jdTTlu={L~s;iD6*&kk&hh2)RU_p~wX7D2@{x6T6$- z%DHZkzHrdCxQ*iOvSr_MMWT3>-DUZo_c|}fmY-S4t&9B;}APnj?J_w*g7B?15OWrva-_We(I)a11z-^`kln9fq^dwJ;7AZ5W8Z53z zaqo;_wq`G5v+Cyz!FKW*h0P{IMCI(qa!{FIr@La(V9wF2Bq?t=?_Wo$KI&+ybv-d^(KL{Yh`{wJqz}T2F=HHLJKHki#U4 zyv6TnAHmb5916=np?{&RShFGpQ59GwN*ono;{>g1P%ej#QF@kwiZT#KH_K?=nEgwE zh_zpZ(I>ylcj-bPegB7F{?BIt^Uu|iU)Zs`nnC}2m93=8eEEI)IKSZl-h2ZLaBo0G zhldG{B4UPCsQP>!obd`Tv8;eC1-_Sb9E(85|BOq72@MY*EQ(V&pmmKUV~_#asL{)D zdW_DI@B+;Hp}~@k(2?{ipCZ-Vqwk~_F(rD5G3SI8<>T=!%VjE)wr~LvwO13;BS&P= zj00ccprb+V3V=0M=8kngX4J1SaKq8JV|rapyMNjW#y^=K@Q9HFBn-Xa_#+N zSHFC6GJi%5pjj5=_7)C?5=}m@_?85a6@N2%UEAlHi4@$Cd)<}U9_ZiLd9}Y z_WRV0jkY5}05AFBFw&h$UNAeBtAv7z}zwVs=`1HZqyo5u%o?EqHAM^)>(el*H0+~wrN9q-s6~+1Qum(r z_b<&iRr+Fe)^hdf z7S2=ae=*NmedQfpM_Ylyf!}1H_OUD_kfEnso}yZCWljeXP}%W9A*fSKXUl5fUv~g% z%w`Qd^AnNX6ONRv(tb{bzvD4b?XMtjHIK`h4-Wbi1X&Spd)_d$bJHsXpruqng@DSC zWPFCh(BSebkb{Bz)EYTIRVrJ4H2Bupx_S>D-j*{e^c1-B*xa<{-jKj4t$E<=G)#QW0nEU&npxM&b?Tr(qy1Y2i65e*EWaeEvcKRJ2%@K$MZ+&ixVz`on+ zd!Wj=%FwZJn9_g2TK8~><8(WNPGu8~Osm`r7m0M+8mI>Hjr>v~>a+ob6LNTj7ln}M z%`0opPX3vLo2)5DSa&(Y^Q8sB{HwRzO~=|F7Re_5bgI_8R~ovFjH>)j)Invev@N9!<5l53nPS zs`_@+I>M{7p-5v35vm>JWpT&BgDgk%0eBvNq2(k_6?5sl=ah17u<`qG6JYbrYemiN zU9jvui}tW9-XS9GgMWARs1xvQwmo>h$EF)cAEwhZnlVq3mCgRjSa*B9 z%lW5nlJR_!XT7@4u1Bcm?d|&3F#YGEM;<8goEa-dpS|vT;^;wrli?W&Zw>7d~R?_lKBQRJ$3|HetxBYt_3Qh>%5x zV9Jw&&e)pYqkmW;&+6fl``qGH0htts?0}#sKh#nTsA_;jv}!a`y{1aGrL+jb;21|x zSCaA3AtNzY2Ao8)b_cUS8dLI6^?eAFv~nV-^L(pmdqtMIyt|bysu0O(A>J_!;k>(- ziUw@e-HV)8cEZ7=Q=AnDwWMG=RQ6D_o?J9hoT)FM(%Tt)iMB0~Q`F0E=G3>RpVWDysQ#m-{zIm6evG zqTX1fc0FX14qq;#5a|1_2F8Q23X+~ww6*m4{CaV-D8WVCxELXWQn=FyYi-K935nsM z+EY_A=s8u=JUp-TptmuvBM73k43h5Yn5R}o2uhC!K|VA3S# zT2fax#za~I%0E%C87Y^ZVcPYi^wnomGFYLk*CqU${153c7i@c3--)ESb-71|kJ<1%rK>wwz&4gxWAu-C=7T&x@ZG3mvn!|Mnwd$B|5VdeZA zJ~0%!V{L}n;498-f>N>dY_CkU`{H(xIMO?tmtog&zELLAwmq*33m9xl@iAWjNJ#Vp z0Q2H&8#Tc~o8hypS@_Y{cJY3;{L|Q7io~VXB;FK1pwX6wf#w$eh3VD>jY0MDwM~T@ zIbkVE@x!Ds2IyajXPN4sq*?Umljror>U8OrbDxf1_`yK^%e$i-!+w~OdrEecd5+shP}$AT;TXYbK`Srz_4?=Pt!KspmtfJPmu5k zp-0N;v-;rZu+po_QD$zJcVRxv|bC>g+hmkD+R&a^Q$Izi} zH0H31IbM`%`65@wA=Qr2Y5$JJ*tfARC1yNXDlMKxRNk(ZeF-7KSw?zx|JD<3 zTdvO!)!iu$J#`mb3xUb$J^I^yC7<5ryGlIYX9PVyD+vrKqQpQ009Y(JTm3b*g^aM0 z`Gh2<5@0Y;I?Pn%)U?9nZVaFNlPj=<#e`0R2$K-1yct$R6K)2cE~!B(2RWEu69Xv> z9s}r4=x$}pt$($Q%)nrYRk_tm1K5(1CbtMgZEA#&ZPmWAsCS=2@ycEn;1Du@R5z+h zh}M^y%%joCSn^7dgB^>5j6+YKf+C*#8|5#M1rMbw5JglRIN@3|7=k1~OyMJ7~ zss?hPfN&2~*SLT@b_R@m!)XHpVEO(aYiB_{B_nXBjR4h?4zTu$PepATSlNqW2Xrvt z%O%vvROa63b?{O3u5auN_6niXg$E=o;cI2E#ix*P?LBAEUL)495q02pKYOHPi!-t+ z7tTogwI&LBb6Y1pmdRZhNXlbKH9z zFwCq%mGu|`EB`^x9_|4Qmv6Nw>?l|44zlktgHF(XN>#gRBo00TR-Hv4n~}s_URo`M zDVw=ijh=iO9nXr8^kXvgK=|vgK5v>Lo{oU&YaJpdkIFt`e9p9;UsKTR5GD;q{sF$8 zi&Gb!>$h~dO5NFg$xlsMQB~o6Jf+oBz9*z1y7z{h#&45JjF{JbbXL_?m{HXX7jy>b zexYKTYFdsR!cZnz5E8?|W+g+5)VOD)gqQf9A;!$TvNuRCj-ZW7-dYZT!Q%JgKrnDgd_z1mxA*0eg^sFP*PEUNEs|IQxw*wtA? zqU{}OffIy1U=m#8)RL&YIk1j3x*(NesR1f-7y5cJLnEka#dH`t6w`g>jNn)v9G2-+ zglKYcTN1P5V3N`rPf!Ao6kP`SqCtM7QfJz=Bq`q0@1q)HD~J`ZMO(!UK3c3CeBJ{1 zun31b1~^E_dDt;UcMGB`U%!k~SE=LDy$E57G1=g_$`Fp4C(GB0$TJkTDnGor45O?- zt*mhTLO))KrFdqB#zPut`CFJk0$5{P`|uzG$2DRqGWLhSLKp7ImRcdNlL@22`ATUJ z!2%46i&2ZJWrMT#ve0~GDE$?By@Dx^ib7eF15A7mIrQXGw#tNjpc?l&Ik%|r2Vmx~ zFLt4&tdM9r^lU*2GEjEVwkSEon7I)uW}5Wzh_%6_@5j9D*8FzGn#fgkme1Pn^bx$q zc9;53%GGsML6Fb6-fo7PS4KB-iUlcwt53bXKC5?U@5x$#Lf;{-e{1AmsIm{4K|JmD z7ybDFv%+FE(%b(a$5wJ516OaULE_7DV<&&!ZWeA#z?P|Wwa+xL+Hl?)7E={IhtADw zv(zx0kz)R7{m_;B_hGkcEdu-?`Pc&(gBAxir1P@}!_m{13+0XUAn$fI`OV3(&<)jr5OtA8~BprOanVyjr< zn7XeX!LXk~DuUPsub^N?sV4KGhscT&l#)PDfroXCY|54}rIIu)N4=I9d}c2Zo8ZlW z3ud;`M1j%BLPR3QhY97zY>-kACMJvw595D;Aw;QLna;#3&pLUo7)nWn`q0T|iC|p` z+X#Hv9Z?(23cG7uvHyZg*C1h!n7Nk;JVLxre^L^8>5F}SHT`-E*?*GC69KiX?oKJK z2tiyc4Pjx`v48xM0A&2S_!m(^+0-DT0PjL+8-_k^y`J|9|E~x)zL+B_rrhVVr!xzj zk2>9_3YYqC&F^xL zOxpesEY0`E+<>4nn^g&7{SA zVM{Pc=ulZaDr&Y6YLw6dL%o6h1J2wHbbn;kK5zUR7XI>=E%3AlsR`7(Vj`Dt^g{8* zd0LGxkmHj4Wz#5k(M!vNUN~VnUQVN~m-H4of^+G#2=xs936DRCtAHp-q?*Ak$7~Cj zpx&)J9NFJu@JnQXsTA$R`0%MODn>3r6TU2}+9W0ngBAdQm2bZnVtsNZNa6|CTSYw$ zRuY_-7bP0QcswUAAv zVxG5x{;3#!-S)h6thi#ks36SrThzwJlI`iFP|Q9@hMU22jLgutO7hQ2#WUfq&|-Ox zv_)Pg4SS0pHyVeDwMJb1PiFPh`m?@uPf}7`UeRsnFaYLs`)!Zu_i%!YB6lzoJ&2Vv z-itpenwXJL0=tDdx+}4^!<6h^BXm?(oA(6c`+8Th?UXqq3CV%>qJ-GC#l{^Ldn;Gv zj@wt`mUuJRMHlYh+cIXPUM&bTZ!=%h+o^r3H(3?}XUiN(x9$!kscyPwcFFYxL0DrszD;aT?QmdBk zqU;#2d3w^?StADqmc>VDdds8SsUtlj`vhN;a<=h&8J;lwTe%^~y!+F&x7A48;%&&f z`|-8wF3TyWM&7BSBbzntB)qC%!TE)nA7Xu9!z75K?I!a)5QXxDj=tO4IEt1*NNBnT zKnz7IS(;o$eKq||ISL&Y!pK?4DKG%9;W{W2idcx}q^c1dIgU!p2roj2hKMhQ8Aa7_ z?O(!(9%?vdg0+w$Eam!ROj=9+uUXiqqzrmKudPjcOD!pia_Z8}UGqt!ADagBH9MtsJAL4tm7o_*+ru;cF+#ICbAEF>^7sM&P>* zxU$#h%dFob+9b3tzupCMLK+4C8vXLNv2nh$wTRRua*Wd?At^1@GJ*{xGI~!eD%WJ$ z8nL-7ARu=x9zT`@nc?bALWE+;Pmpxw7(@jk5LE_Nu6OZYd7wIWW zwQI+>;Xih(nocu~^JfXa`Anmiwu-l}l&XlPb1T=`e7<;ADDE&vQ<#C4NMoWNr7xfU zFeR=0xJ|UwbRZTyEwvF9CFPOX1cB20Cs|Xi+B(t$jM|oHJCJ(}IE0A^w&5$H4+8~z z@@SJUy8EDnI|Z}lbYxQsztB`;2?_2`T#O1P%4FXP$urheHnL*6Mg7F&G}jwOkV>^e zx}}L%arP*A`S0{GBz7O3P9p+^8=sE5*_GHV92b8MmCm#;XYEEBGOaD>b^I6F4%QC5 z%4S;<^qFO=7(NCPm|F4Fxh^uft(W2^i%YND6nr$(0hm6A^uuHe)I4SRj4){CmSCii zU@2q-b-dpSQ1Hv9L%xr zdGE#YvoQU>_*S; z?=D$FH|XmF&r^M~n^hY>`PXMkn9RLu9@L>JfgLUXVod5?huT&Dw}tutb$TH>??*r# zfFca<`d*j6)wF)S_MS+`ZO5~m$Xo+u%w;9Hsgo>W0g(92{ZJ_9$WkuhsMjxv3AD*V z2mFv{tV$HH9799*0nlmkbRJIbjtDRc)j9`)HQ9$Sfz~DyY;8TbuDNo)_|QY!ZH$qg z1Z93?mCe_XiK1}SKJ-?>%xE>3D5jN7A4+0WQb~qy+1!m|33IO1*TeXCy#L7h-HC^6 z3(yUuYnbbtDpc1784?#O_t?tshD_E3Yt^SanAq&CaI( zmX>y(tNdJT-=ZP3*nJT_8v3c2UM*kl(e-xh(U#-0_Ea_gm4mV2Rb}dL#KD!A#mA!= z00Jm0aJg}1!@bk=ZC~wA#gcu=;j~XL5_>v>KFJ*?IHd+xm@U@im(4J1!|EN zBHIxN+|bkneCeNZfQZ1JW<{mdYK5I2I|OB^?j3M>PQU(5P(0?F&IP8;%Tqnx{I|;C zA6S5q-lO#1Z72a=!_V6vL&12*0XA=$U?fT$HvW%RupC6Mj-}C`{m)RF@YkM`7q99? zJ+PstwGQ@gYD4t*)@2g8Ht;z=gP-!|gD`ilHRh2NEgS_#|$@kV={5MN# z;0w1u1z?Vye=aD#HSRy;+Q?|e0^iq){|IlJDJs5n6|g(7kZe!A2dRjLvu_lP2fh#g z`}3{lDOe-iN?RQuqXsZDKhC1Tiibsv;Ti%IpwkNq3|3gwK4f)qO}`e>wr}gKNEW)et2%H)|ef%;{yLYO673DH;t&j zRG_!r*z-J@?T&l&CWg_q+?guOHVlEtt?N3mPsdvBejU>6`6mYzk3@ZB__yknE9$3M zOd>rcv%Co(iExKMBv97PPz8z~t-$;*tom$8(B!Sp)xdcQnT_uo{45mXlzEetf^ zAvi!;!CN5Z5S_Mw_Z2|27}obK9QlzI?sE&}V@Vd+R?;Tw>*m z3{oX|GqgTu8*!xFSRv4(>LFZyRx#YxWb`2v6><$-KH~^M{Wc7qQOD*T`Z3hdi*FWak)G{wGiBST~H5ej|R{MTSq#Y><>mOXe`&kzB z-QS0|cG@yj(0cv)&0-C?d}JUfOx6whbN1F-@U{#2H-f*1i(Qu7uLR}}MTFDf+0W8j z{Y1OKP!$#D1=f_&ktzZ3o|94?gO2g&XS>`pU_zLTFfgf=X|7}@AVj@FCvDxyp;wSa zifwYKhZXT_Cb6G$#vN1Gzy1{_Xg2U-NvY$yQ(gvxB(3p(2piU9+o_c5Sm{#86fW2X z2tSM|9j6ZS4;$VLog9>~YKMOpcA3aoG2>vo0;XuYKQbYX;F|%|Ych0p@6x)s0XJUF zU=7pIJFKpfST7u-jf;+tu#mFV%rZ1;9~CYP$_KP4^9{o^rczlBX(I7B>8Sr82h4Q_ z!~Qm2(d3Z6(I{gP7mYH&mQ6LO1)^026WZHF&@pm;xt1(`f=kE!^BAZKdH-DxDFWn8 zq7~!n2!@GDxIe;%rz9{cAlslb3}$A|QBI=HDi$-o!Ka4bXgi?It<-55J%()7R(~I;b?g%%*idJ?>V=*RUSZU7zzk8Ktuxp>><{Q7zB>&KrBN9}`s))_U&QvQx?( z6EP`4E&Lc;5Fptf;=ZN_vw}Y-B?@jaB9w-4plt%fZKq7;s%;)Em62X=Oo#LqhkvOI zdNWd?RxSAc4d>iei0{f`2!tC7950oCw63c7m!h!`szC=obs2z!{p7Pvg|B*dN?-|TKWKz3!*bS)TikA&3kEt@Y6 zpG`1Yy=@pMLDO!idCv4dEwub9y=zD%&J+uMu(3=e2XSR|>nlon{Gw8EyuFl*BI4*< zH9`@^82=ve<~%AiG}ikNLnEMzFj(-C!GZ@U0e~gXBhMj1WChB<&fs!@gbjwib~BbK zVVu>GSskq7sPQjBSMN``Rq!kq4cR$-1285WrA4V@TJEB%=Az>5V|=)=g2Icc&x%aU zZ;)qpRe-a01_38H|E{|z*Lgm8%(D|CFaXW^r8ax4?YrASiOnd;gNf0t_+*I<&dy4& zQ!FuPE=?D|YkL$BLEsf&4}fz8V9{+M?_(BPO(Dd>Bi$8dO`&Gnqs(UssmuSz7T3!QV7+GB^lN08(Ufi20GqevHn=v78A3Tp`L~` zeKHn#uD`qyjh_?~PoT1R={ziA6gXKOT0~BpQReJ)3%Wfr^6&pK5E4m3^}Yr*01JRl z%ek&e*~7*@p}|6wQdq+8%&bv*ah{mI)^Q%Gv9EK+U*zFX!^bIbvm;~jkl_aG>G;5P zF4Ej2bXSkzP#w>)h}EG&h$&-G1fcrT2naPltE6{E7MZmMEy)afOyvmmZGk9MX;hz< z{9qSn)VY?=#;b};mbI*c#(o62J>K<^!uGRYe5663^MFWU@4>iXZMO)nji!vFl)ArQ z_e!@1XWDCyp_J67cNOg6fc-(&piCWpz`_{c)llP8mZ(3Ud86@4XGFx=TLwoWJyWn1 z*}=`&M}7e9zt4(aCza9lE-#bxIHLuhk`xGe%C2WTaz#eBRZ%=6>eUfbEXkYzq)NtX(HqX@h`6Zf9c7mDWeN9gIHA@-<2q9wC& zg={r+cO^8@mBpbR;AR_%GR;1yOsdk-DlS_$}D7Z3WV4N#u9 z3??#k*+DX8+TbGCgdTXU(g6Ux$-tJ)ehYJN&hsFbg?bQzI2cqP*eH&0+GDJZn;ap# zpHhXI^YhD`fBi2zT`yKAD|*uYtHkaz!v)K6FDmj_Jc+O_?KtexQTYh`sm(hvWJmak z5}g3E_Oi`Ndcvlxd;435dGkFFOAgDlAEi0&zc$|QUcY*F2NaCmX8VX1u?X?=5n`(X z0AV=+)pHn_vt)hTXsXA7w&YCAM6HJD)79ZHk$0cznGlf-zNh%=FcHRjw%xAu9$mg2 z?jpNs(k8B0z{Jd0GD0@nd%rsTymTSz^C$U*@+k-upZ2aXnhWV=5J`>j+G71+d-!o3 zBe2Re_#R^CjbYph-{P4HC1L}@f*2Nt37QO|R98PcXo`q?6|=4=%v81%Pw;2z*p*|X zbKD$yL7U_!mbhV(%fh5{9a?+Bm;m|O< z;ppkdU07NE_g;PM=z#^@n=dXX3j@u{pQlYDJh1!|)y{j+#v>~~+~u(UjcgZ{n}6T! zf;<_=j?8U8dQtHeC!YpFj{a4BuYwPg;J7~TGpR!t0q{T8ACbzD>K@UjLs|0 zIXx4+_fmmwtb&l*1S>`&$RYvp2ZPA}y4-|>o@)*lEe0Z%f&C%ECfMQ*t^{-|tKv?X zNDvEsD^+^L%vcai)--Fo$#q(4C&=@5Q?H@-tiit8u&RijFoeZcun7Y_8ZqKp(Hssc zwmFFlllJ&&oph!R1aGF(b@EFar*}*>f0;J#RVO}QI1imlJWSUho3L5CBgAmKUDIfG zT6$N0M&;*bJ$WOvXk|@sk)y^YYLMA{`WU|axL~)rMV+AJ(UmeWmOI5JuV-928?za@ zLpS|!IR+VDat>zjmWuPgxw9l~90nGyYqFIpTb56xDU09y+#3-4m8@6rk!AkA1nI&1 zAX58~ns1Qz_c5BNm2R=l;uzX7l7G_x6p#Xwg!OI-I~cwbT{Q_6fFJ`O3YTk@jtg&R zPe1lTcK!t(dKe*a3)6&PBdJ#^$O1g2Nl+B#=P*ZiV}v3HgFOrQ&EszlHOpIj&AF>8 zBk%2Emfz-lA-u(jF?Bk3tb`tymERh|c{_fIO{X(DqL`F^o-OJ><&yS}Q@a_r(*%Tk^GFC+y)&5HU-dIZ-1gEMT6V{{Paf6 z$$bCAYLHd1>2WtZAeLG1%>aepKhQZ{sA^jbd0QL?&t7HGc}}OMwWTEn&|f7Z>$-!F zPDcj7)U8RPhLdoOFVE5HNj?xVwj?g{Y|fB2Z(8teGyE*bO`n@p7o_aPb_}R>9KLgt zZoTc^wMY?K5JINdl#$Nf-Wv`V|5Y^0lQhViPpXGTR+u)f?A;3iHxuEaTX4mtDLcQLGN3|6!S4C+idBAPjdLfq3h6^l9|=lBxN)!^2r7b^QAozYCXfOlsF8}Qrlm5gv1HLC zi}Z6K&#O~K&j+irWgYsg1%Fu#skX_Z$G}b?YbPjkml>M3);aqH6`rsL2=V-89xmodv1x)O_tA$FPUS@uNe-O{e8iKx zyD^&pm|NN8>7dqS#l+(Vr%VSDdQg+JWmsFF%KGz^*SqFybjBv@DL0+_ zSX6Ug+b~`Y_hNXfv1I9WSz}Xl9t}=c7%TfGNJ%r0LPrsc5dveL+_z5>LbJ-dD5kK+ zh%7@6#o7nU8?N=T~XnIt#knT5UW=;*5rawvV`_2BGAM0-JGrxCQh4Q}`e{ zGWAwl6Z1Y2T1$u0D^A?HzJU?2iAH7{_G>nxI1Te~?rD z7Yu-LGTVUI?f{g+x*+FF0IcXj$8)N=zL&)F`%vtwbo*#dc5~3Atw_=2JPwEgU7_|K z9w~m<-&%`7Sc+&Jp37_)B);>MJx*ZJw-NMSvGw7o0KhlyelN4(o?wWf!2284C`e%` zbzY}gHK5a6VsicOt=;lR%JazMe0-p;F+G>jPv@BTUhZyRekIxJ!e{%)wzlbicMF1D zFXyTUd}6h73LQp@E!>3ht$*b^JFlrA7g^v9iLcTmAH^W-)l;o%%?_|1pb5E zFVF5E7--{ldjzf;X^BY^0jV@hML*NJvM=Mp*mWFN6*4pK%~FfURGKDRtfW2#nb*Z?L0`JW;aHJ zw)^LeR7ZDNs)-Gi4mF^qhJ`L^qMcecfJKogl;9SlD$fJE987{OytE? zxi^*L9c8PKq-xyd+V>mhgO2A3qUL$9#b{@ zq`a8*oly!#h#STUeXZ$kB5KFtCUI6&Khf>v6@3v9fEVoO_P+}G9}n<7imLs z)@p-fdxH38`Ry@K8uI?V51790f*A$RG!MOg%=1}8tLk{JaGTHu9iLZ2dsn2Tl{+pk zT2?0nn5|PJ^qG;ytQwmOi__Aghz%ZWf_sV!)$*@Shp^7mYs(M;elwT<*mmfI`_&+7 zy|U6z7_L6-NtOP@u79}-)Jpj*r7%8*Oooi_isej!csErxAT5hv`r**Jh$wcG8S(7s zy6nx;vYwo0e#>(Co~OFlNJ%8&?rw1amltb?Vo-}hLG3TcCnmM}$#ArFU%?f>Z>(z9 zAP8~|0=i zO=q>QtGtTf)EyD%`({eKNurY5 zMof!A{BBU}Kt&(Sl-IGQB?zQu(Wh`nX74g&T0Lpr^830-tE~Yqtuoj|zz6BhN{$6I zdRTwL3EkP1c34BnK!EbSc-rcbKMU>8VBC@xp%~Snw6ogi^UB>*#1EVAL5O0#nwWXJ z*OEyZoY^B)*P3ETLsQn>_gDY`dJr(WTM2>Dx(>zXX9NfXE)FHTvdXg>OzBiGZOgcZ zCmo(-lSQ4trUz&G9)T2y6heK=5_q309 zv2Tp_q5R?HH}aUrW#_gA;K_sKZ)oNQi4y03(QX*vMO=S5sN~D{=zL*#^7~s6K_M)E zgY2>cPxa-x=56u75=Ig7S~@(tZpZ%@HVuwi3r79LRU-D_8& z8``3cDaJjkk$w+=qLh>k9)A1>q1BWrYWXg@POTG%V#9UI7~tCK5Czqkvu;vfU<*J5Vl>fH?>d zA<&7_E0+>CKu?R}Kynv(T#ed)HsS`p($59a^(Ub&AbTvtp!X%g!(bvJc*^_fmRn36 zEZ~@AN&FTRciOuE$~{H6(*HBFql)A5kCCdV)gtq>@mzk<$=oFljxWjCT zTob#vIbHC|-_;_-=vK>i`qh0r`>PByTz2e{ZEmq;`AxyHqcWT4yfU%s{-bz*jcr)* z&V&S|N`m5EFRB8gq;(8JR(TX}i}y5j8SJ?^MHm|?M&a{@dcGk18J^eWU%#i$Y*)zj zAuj2{*fLOL(O^};7;SM3jY*I@`ur~2iAFZ63qo>l!zR*CxT7+N%R)5pB}RFqz|j-} zY5Vulz{k{Jn4t7#wJ1d);t&nRlx26HRf)dKDID+9p!SCu2#eMyN5^E3LjMyo+DDGa z-}kYp%zzDr9rVD{J;x>z^td>O5)+zY7(p~30)vK>W_icLHs(m0LCt9SJMj5#R)jFZ z6n~hr#&4GSQC+=xi?0dV{%QUdmC!lIGo}lNN6}lEHkLJp=5&7-l>1ZAu5)6#s+i|{ zqRnQZa}=J&%{C<-v0!OV2uM46=YH$4v%+pThdhF;Ut~4G~XNz%#yc&V-zbI!#d?@GH=4zis{8UV&`i;hN{nML_Ko8CjD#m|Urm zp(vo^hWs%Bo3jE+nP=vUM6MxCGB7tZ9MX_e&pRORb;Ojp{C-KxZ|a$BuMg0A=V#qiiS% zFEeBSMGXB%RYp#Y#%IL2qvn}bG`E_HXVImZ;sw9Lu3V3~keTjSLAt>CzblOv5Cb{P z%ZBeV(VK27b<4x|Y%A?aZU0p{*|KXiSa=InA|LS^>pHm{(*q+N+hj4+6Z`RqA_lq# zgdLY#;BIk?&Ui={@ME4GhUpcPtQ&W?2AbYn4NN)^Z=`@M^*xSiqLIUCm9K7SwJY4q zphk6>z9?>Qku>kVwwyzFX|_Ztfroq}hUhr46Vs`~dDblOTMX=eD(WaYpkO1n*RJ+$ zyvnqxItBo3ku@?9hu()PW;$Xze~9WK;ReLzA8_}jwwD4T;z84q*^mdDl}KUB4a{ne z8K9eWOQx(v!=i$UKfk8+n8GANMTLh41u6C=4U!93tU88MV)v+5@YNLam#VRPN*SKK zS8q5v|8Z2znLs>FzWR4-?W?TIFm_+QuQ{Fi`7Vcgb#98*CeEsj?33*;gdX`Y_OGfT z=sAo#6K(e`&qmE-l`g_pZvJA(J*!?f?|rjGY*n<~89l=w&60 zy-|e9RV00?S52YqSEClYKihjWad`QbkKO%j<(yOz6FX3zV)1`v`Yc*=f@2FEfzo(L z=W6=qm;j>F6~@0Fn?PZE5eUBvgsA6k=AIv81&X+*IYW|l0I2yN{i&70`ofvmWiWVL z^d`>{jz2|2hii#XJ&E0^5MWwP+t-9e?A#GF7JOhCbV)vd9a*x1ME4)KPh?L$w!T(_r0Ko6O zq0~6eFMASGtN`R3b9fpmApj?L!EHJ&XEb6CZvH1VLk1Ek(c;Cgsv4Xw^D1IkKPpN? zBVkDG#K_@KF^oRNJ<|x2n>Yxt<|K7nj7o$JQ~?wf%Jmxmt^aAkbu&6Y(*s6xrOO}^ z=Wy`Usrjp==zO_10jEo2znp+ zj2G=`dyLcm7B-E244o^f$3T5lG^lo(C z@16ZEAn)7a+b3Sy{BH`Bhrr%<6G4IXJo$5e8rHT`^k6uMcL=!Yw}#iS-C!_ z+dI`|JWcU;Nj{$xVQU1OEwFEF;;fJ2`wbAD|--rj7x8H%`j zK`WFobl<&VxU$&Gt5U()K0ym9>yUf@@v+B>eX|YWhlPDf(X*E?41ruH*8t#yfT11kSjbbDAP|fK0}M0@GOhqCSmTr)Yc?WP=8l>iqF*_(1hSIkuVADBz zMmvA$#q(^myi>j;%U%5%_0}zZb%o{j^l!8MljUPmevD<|k-GYJp--^q?`^IJc3j-gP6=9?dk_c&}iXN*?e|@zuQ~Z89u9n zQ500=g4CwYlsvTn7XxP4pn51(@Ho^k10u=<;LkoBOv_RHXdF!_{Ge#{Uv-eRz(8pD z$R24Vl1v(=vM*YzKUVdqJ1x0If-mXOqt(;TuqB~7>%VVHKkeUp-+Qao(ObJh(J|oD z+qG4}q^M>|v&U8_c%k(=BIsA>*#mW0X)zSjFu&9QD$yL=qbg860K`x)1aktFJ^Q3I zQ}wE>5u9(u$g0Dcc&>Ei6WUG^rDt!SO@}*RiZg9Va7^ZtTsOZ2q$KHjTynm2{9(t8 zk^05d?>E!F#61wRr0c+rb?*OSa(!GbOF1@A`pAGqoh)BerBVLA2~zz%vVFOMrZ0cs z#Me44gcL8~9zDoABaX}X?LWvJkABdHc`H>-cL2ac!PmEr7+|&a$@D1?fVfj@%g6}^ zT*taQ85k08gjOS~3E&xzHh-a`)GJKsO)^kj`xeJ4>;&>AIlt(3S%|t(-xYW_ilD-} zS?xZa(Q0{7$qMad2-uMEWt+s;KfmEut6G?N7H;N=ePO63J+FlHZhz>e|L1CyGz%F1 z@%g~qt1^{pjqNa+zzRD9t}XgALztB* ziLx;Z-&{ml>{z@b0wlvzVIVi#y@MJ>6|oFWBO=cjp0c2Z7Rwro;32Et9l;aPj%=YJ zR)H^?iO~s3FgZcb(}PWBBElc!U{e_Dn&OM}2`&fPgbO+Ih{QuPBg|2JO~hlhi6GKy zZ#HRcVbY}<^Qj6OIb)R!JnLaDZb~}D8*fhyGlMM?4_vg{+LV`^O#E9nOxygL{@&&0 zjjtsQ{$!gH%!OybX=$EZ#O`Sx0e?J(R`VrRF-_JEqf( zY3jPAk;go#?Vs0;@4X%EfpOLzbzKdR#?hNU22KUbTdp?R4ffYax`DK9D6dY)#ursa zTwy4Dlpz#qTld{Eh_IMs01;0*v3+^IMxwheKFi8xD zr+actc0`ZEL(M~@2tn6Y`qq<^aT9V~Y3V;XT_2`&N78yV6C}wWm&6-4*ne>H@H#Z7 z=r4jvExR^qe^aQB?cLn+^WGKKJm3M_L;5pFr*c-yk2hwhCqyv>F<44+-2z zKpNo~WsyY?4JDSi1{AoNvDtGXLL5pH{YFbE z589yKK_(vEra`7HRiW8Jo)V*)IQ{W*K}{;#l8aebjY4yCyQ7JK@|g}hZL)lJxy?); z@#KElX@=8O|B2Gsy^T%Yasb`9wRf>>ku;z#cqoOTozKB$0l~gUjpwEggUES-5ZFr2 zxYz!SwEC0&aA$XB zk7HQiMQGdEdnr>J5(s&(8UTo?a?LY8Nrb`BcX80zB*lyTdQ#ZAg9+c1Dy!13g2pJa zLJgm659#a3p2&(A)5jPel4Q*BG#=i=){>&xUn1a+Npek+InF?U#xSnBk;Ad!0}&A{ z;(tOxQ+kfo71wF?jBG9Tz%~)f^5i(p+*Phz?pEP$y7^YV5(&fdn+x#i-I%Nu_NrU6R z6g_cT{jQ+f+a!Kmg1kyDLH?02lomrJ^7cH;p!e?&M;r=*rjUJo!w)NyeuEDsc<1&H zoj0Y!om$td>C0G%-<+Tb=hmR*i}8Rt=HFDHDL)H zo`vvT3NG8#VyM(erePw3Az=9+mNrlP1=L-nlETVxA3;( zNss*e&3YZWZ+>$zmdY%rUAm!lxw7XI7i`mRgzf~3Y54TYy|!)rNmq>cTd=20=S!h@ zw>2Vz!gUX~(A=kxw_;K}$eTzSu@k<52v69+=G2|!04wJ$JR8TX`&N=5HZ%+x`|y>9 zj7!Zj*ew(W$O`BXvp|HU-KeHdLdi{TnWbE@AER&M!mGHrgXC($S#xYZ2qUGAk2!=sesb{BWspB zSoEEYOOZZ}Ts`OZSI%&GKY^|O^??5K7nN^MB4L=+A=p_0eJ4ngjGa~;9`$Cr)sxN& zoI-ACwVtW7IT;XS=VTAOxGgR6EKL%+t3|hSf8+^ZN zkFW~~_(sY!Hf(RME*?`yW@tU7!+{vg!Pk`vZRZYVi}w(J+!c!&ojylrQYa9yG5)*Vig}!E&`!>d)acPEQ9Q&-t>J> znAKwPv&Y`=_jkW~eG>bZjg(lvtxxrjPgD24lAHFrw;H|A12f)d2Fu1T%ffFnPC5M3 zkH+raC7#Vkfe;_(|B9T*`hAe(SIas6IKvW0$!CCN$PjULG6&~W5Jp>8HA71u;KRM< z=-~+RR%27TYxY_ziVlR)+kKOP2S8!8Q)7p3fjY2E$mmd8_vqBaKZ!`{eaS_$A1<^J z)C)6X=dtJnB5Vr)j%)UbeFL7c6ji75WdD`BLx``Z6gd5+re3sJ@}-r+4!au$-V45d zlc+MrK19-@^Y?4=9670DGJkq)fxL-%Xa=ED{ipf^=Ee=B)TPulpiM@8Am%ED*om{| zM2VsfvLnT%!GqG^6f3Z?;1#TxS+kl3EU$LsK~h6Z)<7!>FP;oyGpj>$ii#jI2}DyU zSTkSK;Ju(Qz(6SZfC-@7b}VX_VlYNkf&pCXk z?N`APB z-713NDbRyCB8JWd_J^t%2G_)O?61TI53FcWCjYoS>HDCy(K!J_KMygppAzpL*9!>K zomQq#Yro$mDp+gi@1yTb26$>D~)rSV|6)CHVvBHTlFJ$ zCw+d@+YtmA!RK+0ZSA?Yml{M#UPw^gZDekjRDK~cfrI=D!Y~&ehAIL;iR#pm(E$K( z(%}uh;j5;is``L`>Wsjf+S=1qbY4FNS7eF8OdV7QsQhSjw}Ax7AQ;oXup9_kny~B? z7U){yglJ-Y3P`eS{E<9z((tC(SbfciK{<%4Ka#60sBatZcj42pc z2~x5(%vA-(tL9?mSh(7uRP@vja-Fw0;#``GV-dAQy( z5Y_mdMKu+5olBeMV`sEggZ;w-E%i>O%eL-^zHjf6ab-4D3u#KXPG3p)wDCj9ifY%{ zig~$Y5CCXJO=?+u}VFZLi1Rw5Q)=~gaqL3h~l8+J`aoB4Nnp6a20Xj8(iT5par0!J^_LUcTq*S znph#t!7yRukgQ!1KNT0I$ERctn&LADer zoc!EuT(Zj+DYA^xwf9u%4|*E$SVG%s4%=Jx+0;aQ$+BC=IVNMEkADU~bGPbyG@V~U zzqy{Id-Fq8PZ6a7%d(%s{^#`a2cUAk%wA34-6>IPj{RSqpyU{w9J(_DFs->v-?&sY zl914z(=M!-weWk|;;3aS@9|%@zYsG`0KhV@10b^Z8-)zS>T*K{RXV4Fh0F&|y87NK zf{jIos*Ap}g9uf`!C-KR?_yFMPfoOJ<$ET6ydotzeY2O?X-L+yA)sbHzJoXwo`(ilsRm264r6ZbhT<`_8}ZQA9@n-tt5Ibz()4 zL4a4T2v7t7g%>yvD*K9B8S`FW%3h{mwE9J!SO4o7g2mn&W$~xuxqT|pRx_LBZ(for zYbRQ|2^BLQOJb`3)9*_E^c59m&wPQ%hw(@ZAPmVow3V#kw|c%$Mm&!tN{QljSfj` z8ZlxTD?-#t#!bum%i5@CRxxBC+#fr5?7?DvdBg-1O8vZNP4h=}W9m_0TuIBa^uUro z?o_lFVAr+k^XD%tD z)vrK;6XROM*ys}O(29SM!WgQ5Am^XgyNm>{D-eh0dVyBkG2{r@MyKcQcg)ABD;>Dk{aYzf0QN8u#GbumE&X zyM{5v;gRKJB3!!I=Yf0Lm46Nop;M4&06>-$>|!%uHkcKLTbw9Uqi1?;0|Jsd>|ftSNr;{)7AItqFXs?I$r3JIA)lFkk+re{Qo?)-k0dSX0XZ3JgVIFJepV@?yZcF=u^S!B)lyT$D%&w92* ze4%xmpJpK9mP-#cILVpK^4@T&`+$=edJ9yHc8mHjD7AGyio&tFqW=YB+Zlm?j88@O zE$Gzc-#W|;$J=hr>IItYhgtr#?cX4PDh_!}>CTVy-cVP&REF;}>})thn(FV7%37Yr z@95=H?L5DhtRe3;0Q8GIaB>)%>jruaH&s#=9=I(+JdzM2lLL9W)x~X{!$u(;$t&}Y zZEr?Y`CaXs8)*-UtTD|*%Hkc%*&r`Bh>6{LU802%$lJ!#Okfd~B)S(cUs7rvNv)%j zprF&zCFIoGkZ`;4FI-vtsiUgL?b$*6sG`JU{^f3_aY$g!%J9t{Qq$SC_|;mi@F&+& zAOx$&%B{G%8NX`r4+}BC_K;}q+2kN7rO;ro>!&;r(O4q1Y=_PUfnJy@ zGn^=M3)v%8WG9s@YgTTmluKR#hv)(sX5>^ltH>O6ZkN@e)FJBJWo{OUx0haG(-5^G z`vjO;erO#QPG6FuMBzWkx$1obfF3_gaHNbdtzZ$wOpoob))E!lGlCGja%va~W&ux9 zXL^=)4W>14svV|mHWz=EVjA?d*DHN3uq&^JKolKbDog}ZnFP?A zaOj{w)Cm`LcL*}&g=XkuH0a~HF+?^_yT#K-qn*KINq^XMJA;=xlU>2GvA8;}ctVrx zcK$v?6}tNihSZ+AT)bNTc)XVNHkakulqbbGg=M3MteRf$yuFaqpc(**h8YZ&RR7g? zJ>*6FKFuL=N);;$x-Zcn_8kB;rZ758NLqg>^7l~;SurFwi4q)U&Kz5WKW1qZ;6eNz zd0;%0tYjP=a%XyI95%C5xjiut9l^9uRImwYCW`5SXSTZU4^i3#Sa z%R*B|Chx}ARsS{Lt?&V|ie`RQ{mH|tzS++fKAx-4i~-wUYHG!DJ65O=zUd` z4PEx5RA|r&>EGjL?D$20^FJS6hpb2WL$oU*YhUiJ6FetPI2?C9X^ZkSM^seoY1#;aD*{y z+s}dbFNx5KeAokWZpMvR^%8v0d9>Y77G?Kq!2egbX3S)gK_um-Teh^F3oG? zwhbLse*Z;g$4$XbnJH~+Ot_rE$e!n1ev{G4b*3G0;-G38xm?mIS-APF{@{P1bi2^G z(dtK_g~zrc{J*ytiAL%j+((X>gMbuT0&N=N&6oYib$6wz0Qo()hniP!nO;HYL2gUC5!)KXt)_f7zDb})ekiNcoz*L zZXOi@usH+W&%vuFBp9`AA6FHK~9ij z?V_`NEZo|OSjC4cjFO9k6BI*ci__w*q9z8Z64;uUGjE~;lshq39%N*vY3qjc>D zLS20)bb=s{suJk+*G~+$X`l84ALuh%dZ(3l+Cc$av44gSrKyILs_T}BQ~pk2zui;l zl@HpC*ZL5YgBM|`&PRTYc~L{|10fG{ur@wX-Wub{PB05&5COjL*hu8yaR$Ce3)4=> z6EMPONRvLCFkt2PNv1zgUK?A&k2|zuApSNLgSgAjQ;LW` z01fYpsLG&tl;d;s;xV$wp13j%8OORCk#YWTzDG2P{8<*G>N?vm)W4TpCfokR8U7t7dg-0b|MdK^ z1aS<1M5Gc#yzNAp2%b&3&!Tfb!~;M9dzt>}pp>D*NNrGL3(WW`N*SzK{8UBho0@o} z&ajvtM>%tYTc;K!{pZ#i)3w-T$QWQZ;-J2CLnTv~kIb;$qVHIO6vdf*S5e};XI=DG zxkdPkzx2AmL94UuX*=F3eWJm7YZf!D#rMbUZo5F#*Ls_&%*8Re`GaYVYb%$m&A@B% z5*!#UUTJh#$MT~l1-Ps7P`cv;pgX~%I7fJKQyUz1N^Rz8HSg71u(`UJehV+M7P9%T zI02>s@m5Zh1|8JfQb$yaw0VV&n>``>ld3_4FI6r13nV6{%WcV9QZY+{*(9gNe*0LA z>I4}1G?o715e;5HefSL(l^O=XS~pY!#h?|>3fct#_7ThHuroOxiU~zF7}hlpmYL}9 zfyl~^zlt{q+S?z9Z?*>9IgfK5UpH|jrS=weU-hThgDE>=kg$~XZdMoy%+-2EJ1L8^ zj9oe)OM+e>gYQu8>!X3M{n#~7$RYq>g85;C0vUyhD*mQ|0y-W`4h2g(lp%OPxJ8OY zStJObnI2iUlk0}V`xGi}UWE_yB*g@oXHw$GBr1-LDO@VK8+^djDhR4oU#pV+_yy(T zTQfncv4|HC;kLGU%gqaQ+D?P2B-^@+9{x1`7hkI^zIP0(=rG?pY^{f8P-)@=5yMGN|9CAf1PAQ7^@nBD77(px>T!ibd7q zRKJ45XtgW%BagKq{XsVPxQD!t8hcFYRGA9Cs;pI<2m}4?A#kXe@!pK1DAS$fE~JN9 zL%P1a3xkTaDP8TRt4^q-Dg&Bb_oNxLir-%(D)Oz7S*Mfnz+m_$$G5}pAhMVtcxuo( zYrbE{7y@b-n-RBywAFl?gxSl&F0mk z1^YZ15baEX-?4mRWiF`+MI$~2Ny73^1YWO#F*5)5OOfCW{VLIl*54cq1c^cqcr!Qm z0g$AH`y8994n7l%H)198wKCZw*UK7eMf3asT>!_{T$F=ny`foK}o(UwY;>XOncv`c(!u|g{&b9kUPk0Ey;7|$8jYfoi6Bd2>|^4W4B^Z zq!m6x$`Km}3KkU*8chxj1z**-$0zL)M#*D5CN(ZVl5Be^(3EIu_n?Ba9RYsc>PEVVMUol4& z8I+#)BCPZQ0=W|nK{=LUxH+t~f*{ROSmS!P+Ir)=bRKI#W8ja(ckTk8uG_!4es6fel72BqxwdFr`JMsYl5dgH3;ouKG5d^sIWIp$prt2FDyDFTC zW$3xG4R6HLcqEdu=-(K8lQK83*sw%kZPTva3X{@~#c%P;Vags=4E?C5M)was5 zUk+Y+A(_t*#cqG>tC2e`Lf2oAMcPvUJ>bKf&mH<}svyh)%J3c(P{iaT+-?A1LMIW~ zS2SgVqkzLI)y5M7C4-y=XWj~!{d;z*z&R|U2Z@Y|mn$6WcH+q9&`co-f=yZ^VFb04 zjgX5;H8d@1q_YCH#Z*jF9Mq&ts1Y;eiq71Gb2G(iowV)Ms^Ujw4;v%&yQh0ZIE1Y_bFH8iFXYrpHY)<97|ASm0)G;9Z%xXS2 zTi(T@Cg=Yn>??!fin=WuXx!c1-JKBJ-QC^Yf;8^#?(Qx@gS$f@SRfEQ!4s^f^VPgp z^J=DQ&cE)e{?WJA-TRzk9z%g#$PM!lW6d2<(g)Q#u84r3WOmY#tC0+RVcsGXMcr(EOnQya1natyL^% z-Pkk~&^Q+w&EMotO6~AG@=F#_e||d~TdNgyjIpnoJG9p-r_p(*h-SuG+c*1%UKCymo zZhx?d^Cutw%=OCnGZtFIEZVRuEs>DMI+I5umgeUU2_KzNvxk3;&gVszUn-?8 z6eFT_>7GAp%2)5~M5`^)QnpQd$^3JRn=58;W!`r3h+BV```3cOy*r)nW+E|GI)zpL zQQOc{{Ys+au~p0OGx%-K;t*thXo3fuD&u1BI31jJ))`$XzypBzz-NRwreVy$+VS!;*D%aNPY+kxk!`{r|<{=rkD&8`S{WE zy;5UxMC^|oS{%i*%R6WofTw!i#Ym_(U6SdcyP;b){B_-UvVey!s6jp5)ugx%RlVbc zrVh?q{oIT#QRq&=*Rx5OIdg=0PjQWp#HfUfz?R{<;iObfn!h61Yi0ia+4RZkG=F81 zt&;))_k=498i!96%&yF!vtTCc0w+J`MhKE508(-=;6sB-mI{UeS`@-8P*|y&+A~Se zxalxCCM#vqM|OTniaipRdtw|}ZO}FHcDPPp0r{f~38)DGX5C7(m>oXe*nktKq5mh# zc%LzIoYLycdvbQx9=7l91S`;(9D$iy{(iik8_(@PW*uE=pi?WaN&S_f^Jv~gNHLF0 zQ0}p=>$Yp&=iF7tXROF9eybn&ev1J;r*?Xm&u zzbc2E`-ldIXt_-MS>o3IJkHkqPzBFCQO4!iaeBJ+tT2=sL7tI@tB%QUOlS8cH6&%D z*?_b>$wg?5a}DlL$XQaqvgck(^!sJ%={~M7oi4D>>v*P8dC|2yc+xaj zNoBRqTFW8g_B#0r2ETo1eU5~gT}%Xig%I@tn(=QkZCV3ZBVmFLZ(r9;(27GnTP1RI ze|_vvle5w^&f?s&B{Zd${iSk^VCX)vi6%nyD8zk;c7FfZA3^@g;V#jw{@`+zI?LAvUDF)exi!bx*DLjk~W`%XS;$)&hf26rQq<6rXMR z9JeOp@ty7_V+Y$}eiirKGgZWSYNKQK-mecZT9xIlm1M!8p~iridq5D6%=}|$4tSiV ze~>eSy+?@RwN%ajY;bFjVqjo3GmKlAsBq2k7b+{qzBY<#n3-`*QTIJh8eQ$E_A4(5 z?YDT<$qFt(`oZ*}hbWzH*d9bu%%O!$8`M?2+Z68HQYJ`SR!*>ToE8y70wnhyhRU@ zL|4rXL}Z-c2wKUs+I9lt77_cmPE(RDJTT?P%q5xk{wpLF>m!&Y93Ooizh8;H1LjYT zO%-gqpZ0K6$mOe7V{T$$@V!UjT0?_>;cMjlUSa>wN%_LprnwV|+xc@%KHUa`huTm3 zCr|w=>2Dtgl;+IMO=vU8D-%xPVgMM#GBdQ8<>}^3(aKm*!r5GDRt=RihV7}BM027u zq$XX6C`p~%B^3wq@dpv=SOJQ{C~Z?0gH>3k!!Z=<%CJ4X+KxjSPWEiIczJ|)dyWaD zABmJGz}UhVrob>bLx5HE2kBKX&AcgO@Y}$JU9f9DqV`ze&BpML~0g>ZC zEXG9$ii|l@3{-+)22~ytuJj#}tT8$qC1GBIk$?dOjjzo*Aupo`PZ$bkwJbhHA);mx zYJ|lxG%ro6*@HpQhlq1TSlNGLAhQy6eo~z=UFKfN6L?CI%U!cZ9st?ML=qU($QOt# z_bX$_Epde*@O%5exBpz!d~vz3848#b>KOXg-~Bcy^5Xim8uBtj`2PB($@hcS%U^+Y zC69lQn=$zd2d8bhBHU+j>n_8jU}dvHpqwn@VzoA1n9iu2o#!#&w%uYRF}5>-`6E}XEA*M zK;zCvH_1_G;BYF*cuFSemysF-Y}=BQOSvevX^=RB#mVJyECvCBxhm1`CjD@Om{Xe| zxm*gmX3Sg(1`z}Ske^vP3Qb>|B?^??kn7>J6&wnuT{gFeo6+eNFRH$F4D5YI4KHkT z3>vanxs|BJ_etUSEGRr$8Y(g-S0;09zun+tDQsDtwT(#>GNHY9BIPojtUe;aq_?PX zdeZ8fLqJPhx{(wrnlqW}A27H`zW6NS`%Rd87ZeC$p>7I3c|n#dL8`p6&gemr?e|Wc zs#6gx(yS}I{!ma{J%>eX{ zJ{Oc@i)z2Kas!7|);usdM*f-=AaaTcluDRLh?V9?%$AHsQY%2oMA8xB5a4K-iJftR{CF(Ph_J9@ zBs^(JmF27DWCRGO?6|BJ2}F5dN2`d!DPX+MCe^X zsyU!I0*zT42P-4*>;95&D;Nv_VfZLHsP@>au~^74IkfaQNrZ96SP+YH1e$V3OhUuJ ziDbx#C7sdX0YDO7!vx~_(rz`RqLX?S-!VXn&eiQT^TMYqSd9}|>zw@QbOMhRB`c!2K3L;1kV%zuz5duXnBdi(_IBL z`}h1Say68{BBYZommQO(R$OF}Sgl68aNp8JU0U%Gs|!x&vvdB4xgfjMz?F&I5YHSC z<*3){6D>R`DSI;MWW@S8Gk#mrx{v2HGzk{#wINR|-n4nh1^>W%%*v5Vx46k|Z*TqC z9nzghfY}7T_d}U);d{aubNZC=_&52Z^GZNMW}Sv!Bn5ba6x1h0JUyFxFo= z`<=9zOi!3i+@DZU9@X~0JV)%>)vF@R{lKkBL;$4IPh3UE5-f9GC82iVekMmfI0Km=x!h_qff~e54X5v zn3kreS3`WBj04=mlbi?Rc|)jczv0ZZO4Vex-x%{D_R!sp>?f&e<~;VMnGn+$57&=8 z0ei>DnoQ_uK7w0_XgDN-jIK-BMKOi&i+x<&>^(U$0^awtWDC35?`a;YlcTgKY#AUB z6c+OfDJjs_9vcq{`!%j$$u^d$r7Hgusipb5#X)D8SMbUR52*Zs~C#0igzR8soeE)W%9cCA#Xv&rP zpubABHVC=r@VFILd`{#kNkt1vcD1PdwRxxHy7@j3wXM~o)c0Z3;3OLE|5Rjz94m+%@4wLAG z*S)!08_nUVxML z_4TK1qxZA1_D(Yv^h_w2C4?=fk@ewcEQD9#IGOAf!8BR$I^Tr^+cxEVr|04Z*v3UP z#%IbKcYVnXAqw`&Biu3`tvt|V{}(0`06@}zj9;#rp=87^D~SvRps<92OMr&rFk5Q? z7C9F3E_Lc-HCfs5d@((yX>6F1VvW8j<%CaMQ0wX#!j4QIz_}cl@J=sWkeb9CHLu@8 ziRaX6kkIt?)6v{m%H59Q_d3Z|)M!}OVhfE$1ewP{d1s{{RP+{xkp5{z>EdNU$qQY} zQ$nXF=NdqyjG!msHQ@eSH&^idXTX+VChyA7+hQ(VBQYk2h)KiC{`8%y^VX_N3Y6u;jTIS4v z67;oG1l$zT2RUaX)XFHJ$cj_(FG^L+aK3A4P&&^o!uAV!^mf)vlL!Z;N!xj_MeuYab=KK?ePG{>8z?4P3qm8bJQ9kUm(=|SIny88VQ{>b zE5x~yw-&YAdFHgi_&14i*AU^fD?QU$6saH91+S?y`;Ld(6>Y1jKvRY5^vkAF(c{C^ zFcBGYv<_dD)$%B-Mkg4ocTGio11r7?kJ^~J|?q-pw3e!M5(y?Yrf;ba~*;s zjYL$`)_y=Kq;`w_u5tznqpR*_!R;y$D2JAgxAm08j*kuW7miOj{T6~VKn>MzcajtE zrMndhU?K@{7r_a!gg**?$|0u?4jpmFkwLd{Jq$D7y#5>lCdb8n*J}}QQ@-@3z%he3 zt2?(rQRS3l)J6<@@ZQQ+PtHmR#)cqkt^6_F5X?v8thgKfjlH|eFzv$O!`%I2+V~*l3sKlI&VSP zqMjU;vy>W2MKCOg848NPgsImkhD(o!4~Ih0h@1w(0TGV0_S_BTtVT>K?5*%+fiP`p zp*ZQoB9e-V(lVnMG6%5)7p!41I7=g5%RJuz6IyD+H+cj#((sH4=3GX(1=O8Ky2W~; z3ks-M@#wg4xH8j}Ye)o>HJ&~kr>qL8RV9)AWYqmcg0$wpHiG>zQU5`XbAJ!w(qpkA zoFk=X89Nha9#)0_kScX`j5=+B%{U)LrFZThP}h`p;d;(|SRtkNE;=R{Ojq6fW?5%} z3h^^fg0^f;hR_*z9L4tmOYvyH584N9i~5oT6Cb^KN~F(^yJ-t1w4-1vS;CsciI)n} zv@d(*%7@;qv6I}t@KPpC)EIcjp0t8Bhci9l@i7iP-;AD)Jv%0_-&B5qA5tJwF0~z# zoNwVGbMB|ZEr1EJ{!z@HFD-r)Ubs|BFo4mBR*YcF5i>OO5i$8t@z4lL_ee8=2sP_N z8%B@15}O*6@X-liMl38Tzz$SeYNl>LO@t!D!MOr0F+NNWBZc|_*NwhpEsKX6q?+(` zL@nmkPFz^yhXNtsE7rO;`L<2L!BnAvtuWEnF1g|1M$$`)q#Stx!iuC)QQ37_qz^K6UnQ8%A|k3LFl=MUhiWi zOB5U|?-7tzfn*rW{+FllAV4=Av*qs${t;TB4P~{wFYUBchdxh);YZzpYQ{{mp{A_t zAA$|YD2gnd_jzqEo!WCdWtljjxiK1jCn8qOPFniXiXh3(&+7XMW9S>6;3YilD#PCR zyWDgb_ZSPY-!&Ff&}IU`<^W)fy-W`61P4_Zaw@D&N22;#k~UnRf$YL|hfTHpZK-8x zG?akrQVge_xLIAH;O=<*r3uTCE#6EY$f2~e57Nj;v=_-leFLV zkH5y6_eUF_kcD=~_n>=)VYvJR;|S(%WK-0i)IH4zgrBg zzNwhvUuuHSYVaNE0D$BE)zgDnDp*?S$dn#2GdCYKWOzig0~{QLEGYp8=`YJ~&&s#$@Q9E_0%tE9R;bjS|K&Xy+fU`{gON#~ck4KD8u@%jmcvO1hq! zb`HKcn?ywDQ{f;4D)uE;P^IoK-hVG7HR;v|gIgw$(+f~YBa=lRc0o|V)wPc;C4iX?Ud61o_pQ&isNf5~koUnIWNyfBw>K+! z_Fq2F9}j>-{_c8uGlSo|B}oHW_6E_3YM`JHAbuTNzGUktreU+{W*VcgR1rpLa`eK~ zjt)T9$go9>a&aumd3qu&0ui{dDx^>)>@ke97;pW|`n|<#-FsW{yHoqEpOt9$978+v zL5Se@ee1WO^?{x4UGT;VE z(OdTHt)exeHA-kusbb}kL06#{_e3}YZ>$`CL}zquE`~DoLya^*H4i2W-ms3090tnDaCXKt4FEh zS`nk}C?nHc#jp`}ma%#}MJ$mqhr6jJXbcDRa$QQ-45ls&Y2det6AcA3cKTd zjM@b3Pfgm8zU3*8i-OldROrZTEbRlTA5PF!2wMr9+gaQXq=QM`}NfCzWtD7S@7XrPvqAg#v{?I}ZKL&cJ|G8K+8 zW9GEUU$5ZI=%4Q2{Hw-()b5<;nytyHO;=y?3d_@2+0AH3uE-<8XcK^aS3N6VO}h7- zGD_|X*~tStEV>@<+SWIAot<{OTf4bS{kFJ&DCQF8H8h6$){W_IIz`r_l@^*+@byRj zz$K?x31)VfiGv(qtnJT)tup9q(l?H3tYRWc#`0JKPa+>ADy>?0cdJiK^85eZTV6c8 z&C=Z@g(BF74=;^v(dWK(3)KjIdkYxq20sdSgEz3<|0D3y%X0$()6I82F_JncM$D3% zM=|3lXPY)utcy!zI0gQ$oD?%!PLo*i%v3|w4>ksR@G3e6 z08R_#7q%LOk{AWZh{y&OhI#l4HzQkbM7aHYaC&a|sKJ(tcfdWEd(2vYjxUxt! zU?7X@*gOtcMbH+ZP}SzB{HpN1`1FL6qqr}dXt!hLt)oa8Wr zqFk{yb)i-o^}#GhYz?yuF>Y4OQ;*;bA68keO2LCe8#}d=6+gjVtKHLtYwyW|@3g4C z`!1MY$yYf8>QrwDMC{5;7j|k^8@vZ?S*e*PC9pTChW2@f?_$(4EA2Qzw?68=%ZWca z9>Y*zhU9aSY5n_gUz!sp+}nBBH}Kp35X3bD9Gqg6MFFMx=KLK~UveD;TT~^fo(az^ zy%9kXh4b5H;uz;+{yx{a*|%X8cJDiZW5tDUKR+UM+|R=tFntm@?#s#Icr%pmMB3SH z-8u@@3#VshH|J$qH~Osd?8rt_xzzi(sd;DA+37El3n$a~ugVo@Hi2N-wAK_A$;uSQ znbElsu^|ComJKWcXC?&9ol&^2S^8<(G4JEWL>*8Rd@7mRV{%J_E)%gVd^0G2c-Tng; zuv4L}-ujAFxCR#4-$=Sd=E8oUG@>PLNa+6vtF$l8EKq+Tive~8Kh;q{gf;f_AS((2 z%aUzqQlNN>7#R;CbqvA>y8|&cVz?qSsU30-823ghN?Lf5bOnRnN1w2XOinYxaF&g4 zn_n?t2RmZZp8kqiw<~iti(no9STEI5Z(3EFaGIu@7FGV1L!BI7vMN0TQ-#=%aOFwk zSFn=+p68888KL*;6w0JbFy3w)a!>GN=KcUiwr8|@{#N|gSK$TUzmaBEqv30%Zc(4p ziOD3}P=;D3)8~X%q$;_Fo{ajz5(FDhOhD7_W7o0WktjL_Pg93LUD8Z;A9cd$sdY8g z>x#{N?}z%OxDs*n?8(M)gnd`atTMr(&A!{4xuL_Ph8qOC9!;DYO0EK1{X5F{RPwBv zcW`}mKX`-YLKWOdfvhkiLzU^^+#Bwav#cK*6)Gm5pdt6fGxo+fb|6K>s3O-s~7G)(oFI!HrW_CIw!`z@^5hs&?&H0j0JMseo!#J1BtiHgqG|%;firZQ0 ziaU*ExjeNdKbMb{D&Bw=?%!3La|hA7nt-8vmgm7PX`&%;^WX9!URnTxri`^E78m9m z&0GF{f5vNunI0K;%ri$0E$VMrKse^OCvFl9tsFHaY$^f)9PC#+ATtq)WaKC!pd3w1 zESgi7l~wr(4@*8BGlzy~+0KT8D#dKrOkCI}3tiAckbMS5XFHS!Na$c!tI)kRXbRxx z&vgdSTuW|323+b~B!(KfB7jtkKo@~0S>x&egW)|nML7$WUh}S_jHn&0-&Oa?}de-EdMwa1S)|Jlwk09uIXjVB^wU7x%XzP>}m)y;Sf?4M-EV} zBPe1UHDRY3C}`A%fvO4hj`=dxDHy-_ZM9;cH#`XPpbhJlKYi75pxM#x4B$lRNqtDVe(yH@ychxoH*bCdze1S);9sI4kNfce4x%_X zN`M%IO^1Rc-e4={rwqsWk$JX*<7Q5qke%)- zvUr)(gFkbaXi{W4#_T>s$2xLT8+}2NSH`Qs+cP1OvpsdIfE^xBo0_Km3EW-YXy@p@ zD}T(aGD($Dw~O$us-aDTGLQu;Y`j#F(%GI&*2rv34q7Ep;Qgc9PLi@u9$JF2n=PRX zcBXam-1Aeek7=wVgD%?bWhiaRXb*Vk?(VtLwu58z>jK&AErE@&3E7t-p68YEBfS-= z(iv1GC1uB_VmI)0&}cE_0sUJK*XEu%8w;I{kW1PBtoKK(xX$1=rMu$ezA$$yYj){z9ka_jGeSRX*EhAR|a ziU4r@W1TN6HpPh(m>!~Aat8Qo^ahy&HGS_K!Q}Y6A^o;51$kD>B}^faOWpFnTEuVx z6aZ+!peL6@ifC4}7R?*dmTwG9QfQ*Tp89jL?z z^la^-ju3z-Im%Aw^!gvc*Khma*C+5^#C6NHO@y2{Bccqe8-ec9dMYBSkziD?Qrr+4 z^i+z9h3|Ndr`pla>OFdV*GeQcBWdonIq{8X`)WS)7V(? z$ArV50#!f$4t#$jB1Dv($hhdj{|HmnDO;kbqhGWQRQM#lN+_Mqyh4Yg8^TR!TQQc{ z6Ug)h?sq~vt2Hrd%BkqS*nr&g(@lQ%_n|iy`-tpzqXf_h0ziEGwG>{w5@98mG7~qF zCC@xc&axLF#vJ>c6?S(uv)qVa81&{g+(b*IHj_H05J%uJ*!|aef5_W#7c2{Y33<=N z_OsK#M69QP9zhn8G!zzt(`tyy=+VP8(;(!!PJu!1>W3P&gPRyRD}kdY74QmT)?pWk zo{<_&aVCyKBP=&g81>^tw;|k{ppN7*QZZmnMoi_W9&4faN{1UY^+2=w>4!D^F@9aD zl#i8`=eISo3MnoL5qmckQDb?=2Lf)%Ni8rOQ;b^dVQ=@k=Y8 z_aSkP2t)uty!TfurAQ4hgpxWg>dcx5=l5l~P|9~I@_wV_PNGD8DjZ%}trp;Dc4Zt# zvTTQ(ZHahWeVR;@elK`B;4@g45!?<2_vGr3Ol7fj0u=v2F8k0Q1bndj_K8K(O_6G* z(EO4OJMj}FXk=YpD9-*N>H~tvF4>$}368`_8fs(Y?ZT#gU?C7_V4U!l$DxPE?86*U zcNAg)k;<&z1m+r$dYj7%x{rz&9B_@R8l=7B|+6I-Vb$2Su#T|&A!^Bd-n<7_J*BO`h9TxYVw zdM@#JSzk)NV#6-HnPQy`idy@xc0oqS@f*=cJTN45<~^HM!cSVDx^Y0P8f_8@jSO0Y z$uMIFqgVEu$W%)*7r@q9^hYe` zGCKx_BH+`vzdKZEcHCSqp;0WQPeZdhP;9nbPgpKa{E60BA0s3^Wc<5>zfL>o#Qy$< z_84o8@5=XJoKNkN_)aL&U^2kXzlN3Y2W>wvr9x=(o zxLw>cG#uV|+Xk9VaZwb;+UT4=v`(f*z1uD-A2kLFjuglQ=if!3pv9n|jk^KxnC9CZ zyy4e`abADYVbvbK$ezt>6shOc<|wQ^uq7wF9R#IYwtT)Car5&NB8n5r1Fdb1kMZWb zW!njZT|acX{9*buAM%{}-;5GmYd-Uh{K**97XhI)N{M>gUF3NtHT6~`<+*YyI!TP zUK&)HeAH5*l(U2CL8>c+hAg6>>S-<}VO?5wXKam^#MjRkEG9pzD%#@uh5`5{-z)^C z6DCZL=gttsRS7+e;1?nrG&*BE?rH^IzMSdq=pd^y!lXNSS&T*1vXB6?<<{w_(a;I& z?Na*+W!v5;zk?<=-k()RpQy_(V6Ws<(HM)-%!lqzebE>YF|knQ66_$9E&)L?N&Gf) zAS&9qPJ|nisAfe3-%-1r#f}6cQSA6pTi-eSxi=LYS0&HUz=T;W;$ZU5H^%<1(MT*I zm(A2suIHMs%5g6t+FrkwqHvk}`77rfM}xT)+gC}Rb4OK|m-d;JG$s*w9%f_{SWplw zYS*mV!@nYUV4|RQov6x8rV4&Z|4AUXlb9>xrHUfAaeYy{lbYI4-jurFOszPg zq=GVfKmERa0!u;Fiqb49C$y8E!nr|CJv6}urALi`@DFmUk-tH(b#{6$D7*(I5i{K8 zv@L|NA*PofxTh7d?H{6J1we(xTIl6*Z=Ze00NXrt(p(9cQIfmpnki}bNbVF8ro_=S zxQI^1i4i>Zk<*K`1Y6b`e(2v+E>?9deNNu1$!UfjL*DYc!1)*NyCi84bYUC#{N+1h7ikrJl^A44mvey}PpT^KBu z1tiHXHs*^otUF$@f4#BEN!PjZm}u<`i~T#fLt<8>T-W*d6BCd^x5bIrB{!|uFY%Gn z%wQ4qTtvGg^za>-s!RP)GPx`#&n4u#=;!RS5p0hG1_re2;E$N8+wl<)8<7PX2?uID z0ti8wk2+Ajkco27I1&GxlV7`Ze2g*n#$SAym>ku^g0)tpSx4b*aR0Y7y?q2-G@h?2 z{#()W)}PwJ#NuZhQqQ%e9soA-{b3w(1QD5aG#k)oM11uWNghvLq7tSTO_SE6bztso z(G0Via!VzrNEuVQy!R5{SQBq$i=RH8e7&Gs?P}%3*uZxqb;?SLU!jT#%abV+agkIB z;qwaIXiDD4`ZA!R|2W0>Vthh(FL_y>OEJG*oS~w#TfStH$*D)CwDtlki7d?@;SGj- ztmRq}b6VOuH2OX%g*l-(M)x!)lB-5?bdq!{R(*+5pQno};v@ulufGNzVfHnGtqw}G z0TYVOTg#LHDkaFs7@llZi;`2oFf9`~t&50=<)gS-80a5EGqn+t`tbO#u_|-v()2Y# zqz{Dl?dFM`+|vaajNa*7OL%#-R8fTSB)(XjVO$(uDM$oOWqVZIv3amk`JjVM{H@iQPH3*oJv3gA0z;#Lq@Vuu$#B`ZF+DOh0#b|1yM}zGm z{H?y3T(uNLaK)1|`JbMg9;`Xe*wUF;K$h7NG8`7&%<#-MVI0DkWHKVA{1SyF934>@ z=Hdi{F57A?g2J&v8Rvf9$|)f+RTWc+GI~Bz-(rN7?u2XX8!_ zwXTF=b|cA=hs7WEpV-pJ)GmgS5wc3GZ9Ra&oK_8lPco_S%?xYAGBoQW=@ z*a^|lxIj&)OM>khjGi%c~EGp@GF`_8D;u zC|*3GiaJ7zJ3k~5a!b4YmLfEAmM5fb+U8RmTuU_8Uq^>tiyT;JpvJyx)kl|g#0+^m zYN?f&^sw$G)|q(w zK^Ucn%G)Jj*g7yE3OwQ-{ti5{&%Oo)ZpChzp?W_tSYlA)x^50oP=w@5i+s>H+INJN=T3U+Z($`r$$j(@XG znQuhOsvP(9z4xVfaJ)00zi|?K)O3CPUXhmS=1;X7lK_N{s%DEn7GF!$_eAr*LU}`( zTGZ&sGz>ml;C_#+0SrSf_W+Co?rq&vp3^y5!)eYh%vfIrWMo4lLZf&Nt+?h_as{F! z<9aOYb!fh|>Uqu>GVC*-wP%erASq-|FExjy;4~yQvVGu`HJj)w-ki^k96bu8^T*XFWu->n%h#(7U4(-OozoZ<5gP*G<*`P_)E3lZYFYhg^EH&0H)8np zgF{@71$hXbCA|{^#FVeTQhrs;(%BERde$VXd{ymw<7cxNBq9&^Wd}r%k^w1!Uq>XQ z{^PsUQTPxF`^S3I5{2)JjWp2*`wJ(0)^gKCjx8wLf;z89GK^jILhQotS9(yfX|5|R zD=~)(_Q}=wZMK*yk1c6HXbIxVsYWse6rs%UC7A?WpLyBpyS3)^vn%K9(?U}t|H0B8 zTvFja7y~2ldkLk`e?tx~Ga%YF;N7ZPJV^sS4-{_2TcL(>I_1pJKEsJ9R!Bq2tiAK; z?d+RDifvfp^trxO?o^A(uprilQF%Ttp(p$zVLuwilk6Jq3rkslR}De=v#YJ0zE77=*jmom^z&mZ%J!wFS0Tbw z)yuVoL;iC9CoUv}5{ZBK;VK~P=qT|hTPB$8QgG9#%wbUWiT;~AyPQGNJl{3(wPmMT zLi+{uW1WxKx2qa|`52qq{sZ-=r1F)AJ@k)OPP^!+<`p|@g^0PMTfS~+jYt2J;Y|W0(f**USTeT(Qxwk6L6SV(D z*bh~0E)*Kr2smq$q$A#4S#h$ah0zZ};pV+$anDist$ z#cy>JEv%n#ef2+nXjOD99t0`=-1cT z&73%)?5U-lz2Mf@gek`-Z%BEf0`Ge!8ER^3u~gXr$!cy=xu1?-@;z%qgH@QZ=pnq( zDAO-3Q2`_%2mpY(8n7GvLIsUP`Dv0azwi_Jk5h(@`ca#>huWeBH?z678M=}trU(tr zXM&F=2Il2`jdE|9wyuA_5GL}Vm;ap~fA=WAj2j&J`Fwac-s z{MGxF<5tRgF7x{yGlr}1zT!j(;VD1=Mdl{_E;Sdl>Xfx?0)47jo3xx?Un6Uy}^}U0}G6&Lh z*AhkSdP3!#)N1_?COpgIsi>Gq^)ny+26ZzWLv^Bi6w%I;3A}aDxTq;$#^L279I~9% zcx0{E;y|Sjt0Y_^rKL-l5-v%|WXgB_+A!=s#Ovk}I>9AT4kYf8G2Z-^o1xV_uj=d} z)Q|r93azG==pVXqQtqEu-?yHhAU3#PDKMY_^qcoQcn9R^n(iaHvbkSpSJ?_sxEz+Z za}|@bc2%rW-0;xNc;D6!@!RjA=5$rOgjZu&Gn9o5-DHS^sInZ zn7(!4e95u($O{Wk=t!5pE^ADuTR%H3zp!N|x;y?~RGn2+TumFLyBl|RcX!v|9^56k zOK=E58h3Y>#@z|-?(PX5Gz3i`Ko8%4Gc)I^Z+op>@2RS@_p|Md=MRh%MpU0?6xRRx zD>g9wHJ^^i_i<91Vk8bZ!>W)@O$CDrMnZ^tLT;Q#7!Uvh5h;YCKk_e36YnYG3PqcHHaV#^;N=WhLo|nSG8wHzBQEVMg&X zbjQFrO=+S~h=i4_=4xzw>z)|!G-)`JwLH%HD0L!kODsX(Dyz`?#BU_MF7rv&<>Hw^ znb*s`^=ecTVafj~2M&eOefrZ5MP!-~NgGYNGy~IVrV?U$stuR?P9ukR5SfU*X?NeF z6$}6@fxg{Is+6Ds!nt)|K<0R6F|L7UV5HyfK^aHHLhh`wbGVlu>}8;G(95 zyKq*J9vDatmQ>&mO9NY2SEh3Pgl%gqy~+NfPf`q8JPw`Fb)XU;weIB&bJVt>&P>R} zQ{y&jQd3F4w-IdYDSF;iZ5rb=XbKo_8ZxQIfZ&m#&Qi87e)aNi8&}C4i>I=7`-6)k z+Pb`^J?K815 za$dDp1d^}Whd+M|T2hd8qxdM0WK!<#D`W83gs?2cTw^40MnLO6A|_(ieosBP`SyR6 zO3UQcN_@mIUPj;I7m53yFfQ*+H-c9354QR>bc3KI4rgxBn7x@!*-%&B4;3^~W%#Oq z#wgb?|E4cXNDKF>ywQ|IrL^s+7;VeQt&1*B`d_|ICA#2c})ZZ-Lz zF4#hwMQqp5WTLim;h4O*n($aIb)b=rVt&`wj92;-i>NqG)Y*;idZ4`Q9Lvk8BeBeKrut5xv?_;45ti;n^GeZ-s( zRSNPLJ+43;Vlx1!>0b=|5153gDAhn!z<-ik20(-1+wE2kKU=w5AZ?kLhxp-}xEZ|P zkqk!S+Ve$5SH=<$3m4dTl^w}*!m3l)wS*&*+w(9}jqSbOTdT+(6*Ed}RDg@v)hw#| zur^&1H70`m;DdycuwF3Pu2NU-nZuSxc8NEik^exTo+`^zcx#3dl<)z578107Og4Po7ne>C*Wk4=B=?*1c$4W%zHIiQJq_W`axcUp^1- z7!5(Ree1p5e{_WS^cx>IN;$e)OHG5Y!^j=g(Wy;oq6*`Sio$yEMnT2VN&$^k_*=0v zFe*(Lkz~4*(-FBW%Q^g(YDW$vh}bud>`c z#E_G*W{$#p!>`*tr35Z$&s)M6h7tx~HU1GV!3ZFMSX7I;n#lap^B9*pSdeUpAMV&G(FDS#Q#{2d~?O?04$cY7@J(i!z!ngze{F=H8` zCrDhRTCTlom|#qt{E_Q39Xg^E5lAGZ^;UYJ&3_XALG*gpIT*>2-K_+3Eue8r&=j>Cbw8u?b+*2snXv-9@%FrhVNN`&t` zWf>5e-T|?K+s|WH@aBbqkR&`yNk81Xzk7RYl1j!y>`J18{nFLHTTHIF+d#kgI=VBl z*|<8Esp@<)+&Pn5+uo&PyoN$hQfWFYYd`AP;$eK6^@$$XJv zV8M1#ZG?xOQ;_SVpT)*F8g79S_uUSRAEUs_g^mTzJa;hH@URP zeJ-kXWrKE|lF(5hAtAoo!|QlyxTN3_<%Vq(&J)N5xR{AAX>-m>T@(ufjU6I6)_(>n zFXGK>4DJo`=Xp#~`H?_ZpwOT5S~k2;=r64P%`>WZr{wY6U6{UcD$}q3iFQ2GhS0fshP}zwd#{P zl}dPY)lz{b6i65e82F}_npTUaJX&qGzr&Y_(*E7oOScAzB_6lbgFaK+0zEo7gZV2C zu`FWgpcS2(@TVC$7WFmm_N0#*Z6u$z!shC}{P@)Cp=LTa$xI+GnuFm*!oo*%b8n}^ z(pZ3uQ(HjLX}{w%)N4Nk>8LL~mPkEH3%9&&wbd=t*XD^il+BO;k79qc%Px-3@O z=-D%0k#PrLv}~EApKDwxVFk!U)up2&!Hl2sKglh0p92_R>^A^V3lH@WSwZG@t%Tc#IA!l! zX_xFQyi#vVPA4)suWxmA9ra5UN(Ot#Sf;So$_QsO(UGSXzBnC%u!qqSzV!`bvHRo+ zZ7&1f0AAKR=j6@;JC;ie+yJVoAeVzZqqOng-;H;N6GSEgjgPBvkZ6XM6%3AjaZ9lxtLj!A#{@iC96706yr8p{fAu?$n8uB|ynK8=_Q4wh{ zb^!?C%#KSY9R`X5cgq7ukNJxH;BSty;-@UJvnN(~(AH8-gZR|a^+rQGe4>N(BC0xc z=QI`g0{1O0^_+2&7NcOk*LX!Pl`p*Ewkza2AjAb9S`DZeR`9VA`rcT=dYF^0O8g63 zq~Ri!lhUq^OZL%T#N?k6jqm+tE#N$SJ`qEkio};$Us-C{z`%x=)F`7OCk>lXn^nN- zjmi70nROLVyZ+HQ9e}&N`KGJJ z(B;k#C;xsDU|-Edj$ca%{C+_XdoLaRzK z?7^C`v={lG=6@ZC`)PWfM_HF8*7qcExXuxpAkxx>1kBlphT#~Hd;8t?Azq6ZR}$IU zTV0`+ETj_wnMu}wJO`L20<1H5{>|@o^;+kk;{POvXR`pN2iWR6qN;&pM~G+5={`{c zSCvtF^P;g+tKUt*g4*>F!koqoaq^m8y6N#F{J;B}@TKhRYLd`rqZ+6-ZoJiAs+y)a*Ky#l@YFW3UV zH)qojVuN6Srl60ICFDIYWlB;hJ} zi{goWl&yIjNmYB&otlaA6w zpverg0jCtgp9(^X2W8ExAMxE9xsEHn@UehXI6P$1~kMtL z7w1G$RrGs~f==qXYh#5r-sD3FRMGO$?l~3u?z3vRe=CCpNPt{H@P;E!B_|+wYhY2y z4J`nif+^&xj|#${S>i$j$RRQ>qo`-w|E30E26GX*vV-F58pGgV4*&-MN-RcWi5}Oz zR2;SDE7ZKL^+z=zUz33J=yi@@nA+l$h?x&u&9V)1?m}DkuIO znXMU4A~6SnRWK=Z0V#5LtAHUYt>Nny_o495?^_`jK|BujLx*16I$Z2CdSei3i?yWUz_(!wUW$zg>Jq>)4Si( zOfrEI@W7TaOZFmJiSYw!Jh@m>19vgFp4nRN zfkhLs&`3SkWs$GTm7S6BaaY!%%OF7dXq8TsY766D!cCUSC{G@U+2Syr2yo>2ljoV!3StdTw)U2!OZpDsX(<>iD zG&D9Eq{byQxmxq;F8j}P7Q6aRV-3#eD6qjKLH}cDs$Q;uX`2i;{~?iCXdRu`{fGLZ z$~CX$;XX*0Y=8*NMObUzmxzR5on}1``|(9d)g@E=$0VboUgIQ z?zOO)#qaCU2+iAMdLs^kgJ{miHICx$wbdCTlby6nPuY@Bt#(q?-+L@Id1k z&5u7-so#;gB$xb-(X4GJ99JU4#%v@N;z>~aBb{mQ^gF#8%044*huZR`w(-#ZN+W4C zBd)UBhSzUR`hHXTXi2jvHFVWuGz0qK-ZVTlr9{%SWDyI@3=g6wYYm-XMZ_!Na7R>v zlyQqYq$^=Tx>bIqsfP)_(tV5L3P%UX@wuMen!iu)i6b(eLCse=cl(C-Mh4grU~X93 z??vR|BWm+DDNgpZNU(#TfdaBzNYs542f>;iXYLBOtO?D&VWM|!d^?wYyyEUB);n|k zXE*O~v^H~de5kgOGsD1|-q5AT;`>6`{M~;`k@ME@#8AQGL>rnGf(n?j#-{+EDJ*e5 zW6$7d(dv8tQ2`ajJ{p%y3hJ9NL>Yol;TDXG&r0^O7iqOSS>XnP5&d=K`AY3DB4%nG zlv5=;4h*m9;i!MDLmZL6*tFtFg()%bZYy^OPWZcD!B1AMkwc zu>3FJ+~!l6W@iH|M~V*G#*V1fX>pwYZiuK>y1CAOQ*MzT3PzOiU5Hh)HZv&|&bP(D z#(hXMt?gw!lf|jp4bM>T)-SANY-VmPs_E4^(&pF$C{U}duf&ypV>b*eN?t2BjSH@9 z8>F0q+~B!55Z5H|)X-@!PSRbe+3j=yQv>M}#fzAksiVboU2WgIWyykEemv(t`ga8t zUcM%DNUohBVFK#0=4B2MJnzZK(VbxkL*cE=3%G^b6hkF*XqfiQ2R`gsb2#uMgxFhf zhr_Rk`WA;dkh$@c#1aes>uOP{3XrKVoSLvs5H1U(Nhh*s5mM917iebD_zA*(R6vcp zwC)M{>v2}wmp9IsO`~(tVv!@9BBGhkuO6Sg?%QZC(9BSQiNa8B3x}|hijJ1Ut$voC zk-IB7xLkJ9>HcY41*cCtoXtcKU8pK*m=U+{lU@`W^K*pJomgkXxFQT4Ucll9L028 zWdT7a>|#D7FmE<2@cV)nJbITU+Ia{mPf|r1Ns%emKCo{gtW3Ab44rVJa|pGWZ>+`+s)1y@E$Df~&p8w3-d~#}VdT z^HWtKzW1VfF`j5!%xbaB`lyU=7XKcY(^pC-QT6DU7@U*Iy`R`w+r$A8m$ed{DPW$y zJs#3v4aF*ESaiFAH2qQkTFZeoNt_CtrQ+RM2FqrIFVdmtc8D&|%I5N0WM{5>g@(08 zJB&SwCS4f^Z=RB=wth~J8a@vq(3<;z!j3;)%<$3sN_+sMo<~DZdDvKDW+VbeC#z!h zdw^>P%49Bc*K;HeH-hyU>r$cKLyrpAL2V2NVBk_Ng!=SThMW{gdX1^l>~Ggr2oGHW zs==?tLe|g3UsV*e&XvC#O^rb0N4>LRzui$@Nw*DR*YO`7w0@|Zdn8_F`J>tU1xsOZ zk4--P64icC4r9mBhP#8E4wT!3^NDvwC*@A})U4iAOZ%Kqwl!-xo{PpIW(T*$KrDZ> zTl7QMmj4hh9loaKsSovPW4kEOVs$^hEE$erdzqFtOF^<0o;BUJ5!v~c9(S+A8d<$u z{-!-u3M3$uJ8O;*S<*$0#8Y`V#U^7{c0a7=LGiR@aO&6iB|q3)F7G6>oUsHh;}ugB z7MBp*fDZjpf^yz45!8|MQu2!P>PKeS3$|xYm~-flrvDA*Gy`*Cf(Iq`B_@h6mufv- zSP;s-+JM0Fk`ZXYq9J$yV0a*zQjij02FA7%*P2HPSl`CAn3^-~bYdzOLj%DeN1~z< za{?N1bzl&}5p4`mqNXbV`b2pAX4dK}090a3xRJMc8pHGb|Y!$aKcoTB;1RtT(*OVW$wHRegVAbqWyynOxf z>II~Hzr^zJ!0F)%TV@cX72t9!K8BFfz9;M=qGWM#J79+7VCks<2*~IFo(E6NIL?rB z!S0git)h!!_L$;QEn0dm)}fJD87kPtyy-Z+=YfbhZ)59r%v1j0e`{ufWpSY^Tyod= z+uxtZDCK5e`%)WTI^PsL?Z_nCm6Qfam(-sahY0b^4}nMt_be=02Em$j;%L|{Q^g-w znlBV_7RH2l`Rg1%%oV<}8Fhs-%Xo#*PqruFK<2`9s)|((n`q&a*++71C$yJn6xmpB zH^mVNGe<0s{Q>^h1f38;&Rk9s6Xz9ujv>Kw^SO4hzO`7~Ree)|PYeI557*wc| zL^wF5LMk%=1RYfFNGKTGAyaT-!4Yx|%-RK;0hiB1qTnQ>WKt41WrB-lS6~Ruq;|%; zg_shPTM`i$jJl06AD`!enk_o8oaOZ~qqvKL%FFKvc#DM&Z(Qo^x& zS{MCIE=IzUImm1kv-8~j%j?DF9VB?EyJAB;p?wrR?d2@gP&?>IbNnu&Ct{Upy~#XcWFjyF)!DxZ}I^iW)j(?_b?~ z{I$i^q6_Z|yQ=^IdFC9#Kd@PXI%km;X#fXeYZQ!Gh*_-OU^MUhDmu^E$MS9)Xd05HQdHl!1`LAe<|NgiH{O~-lPMaaY z6KgFn4DMiXnVtCs3kCpmeza4KG*K-JC;9V`bY9d&a5f7zH=%k*puhGODvnW4^dvn1 zrIf;iR=(^wg1u3#OWbRn|@NEM}4ab@Ku0&tcl7u%O8VTGjR&*;>l*Xr~9TG0QUe!5GM z%XywHm2Cc{C8anOSG#IvIpra3pg9ejjVgtBnQxGA6Q1TXZTx?dYp36hlMA;|%gr%z zce8(XFhBl8OqDC@V(y02NXA4Kfv;bWKd6ZOj~+8Yy~YYXb+4EuN3^Z7Q$=CT%Y~Xk zZZ%~kHd;7n#e=Gw9re)9uZI7JrW;4!S`wPW)xU5g%FKcsLlX8NKkWI`d9SZA3XoK| zGCPQtUNBk`0M>is4h;^|3!(zn_h5{*6@c&NT+XG?ar;?x(7IbkW2O2Jku)qVTvKh} z8@)p#9O7|v*Ry_zFIDn)QwCu&YSGPb`Tj$VLtRNC4MR67x`kse>o|AOXp44y_YMN8 zKe2C3G=7DTfsYsOvr(APqe(iH0!dmj7KaTqOb37vjKAlrhml4s2_{1M2rqOd&A{56O09Iu!9peuW03cLTv z1w9iMn(xswDRs^@gSb%s%GZs=f4gJ9^d1@boSy_@8~)nvf_70kL-+yq<;Xa}ChXmq zIbm1tqM=y)8NJ%Xs`1z4wCKkqL68r$$~X!T>2gAh`{i*Ab-|I6QWA^stdBXM%=HnTWg zMvtyP4TY_LIuY|_3p@8_17BP0W+SVFNX{`W*+1Da$&!Ex**SZ)QL~821O&9FGj@WY&GVV(%`H zN4TzK8ol5zRehVkaI(GTaQ_}L+Y`_;s$J|RmIIja9ra4!y>xW?jxE|Hqn5^J23Qp4SS1r!v?gTBFCdG{XiF1_ zGn_R8oKA&ZBgX#Bi*M0&)!r=o#!Hr?l~Ske=rZCriE%~Bm&IbFxl3qi=)bCccQ&*c zI%WxHj1)#i^!oeN%yU1NI=0vDs-qFpzTC6tfL=8pX)G@$O#mj{&e;A;R+Qj9$j+J) zMRZUC2#zgnsYTR>^+el>5va=e1Og~V;^Pam-eEmrf&;KYl^Gn#=6s^$6N>;Au>F8x z2o4I9r65`HOOHyDMOAPomdcq#pN=P{W!X&}n#1?HxsneAs%iMS6lDRt)7NceLQO^6 z3M0Fon~Fp@Foe8|-raRd0)hn=t=kfZvq{!eh6{>1`E<(GLqS!1bD5Y;ub=DU>UI`i zW~sXvvUO%=iU7c_JE}--Gai0yR0?`p6$loHgOU*wmpTCnGuOUn^_1e zO1P7ULQFC^L7YnSjStYAoB`Ov=SP^ZxZ#gck4@$hO&SKNgd}8p&IA{#e6#bNtz_UN z5dKt_OU{b7C?Ok#zFnk4IxN;k{ zd>1p&x694Dx)A_*arOs;9x%*EGozzG641)7lUG+GhuPC4trSl&zBeOcHJ_U-?CyER z3s3BaYPcQEN@>1P+KPp0X~-@-r(Gi*x30V^y#IEiS_%nyVGKsLn9yaegP$_mJ@14H2PwSlk`f|2!@lE-H$M9DA^ zojP7&udOZa-D-JfTw+_3I%&S#^^awPW<6l+S99 zy?MfLzpqY>ZjvHxZ)(Xt6!H{BTPpgA!3t-TC9?PbnTNhVum7QP-k&!Ep`L1!%=yjB zx0{Zz7zs{9=L7!vhG$^_Dmhs2;C6~A_=X#k3DZvh3m|JIDIkhKf>K4$nn_Z2!grrC zUu0BL@&;xU;a4ww@A5P5Xq9;)`228ubH|zHZt0R)##(=)ELg;Sbn7ecdts3}yZ5C^m%10J zrZ@2sQhwA-#oI|g6l&^YS|1qn{)hkle9`oHvbgLsjkG;6oUnWF5+QJ0C!DnLCkHII zd*c@?pTIjhvsG|sM4W%njys3R=qb;>3?x?5O+ZYex3CHvGoAQv%9$RM0O0K`OkB+O z0FGr_@iXt4%;ZAb{75iRJI#Tj@i!n*bPhcYrhqu7g{%;Zh^mvPWK->*aPs-w?b{nH z-As4B&I|c4H`k>8#Ecycb&sv4$xC-=dH&J^$BDrptIwZq7b|TSoJou8AmQ1ExTcm$ zyi|Nd*59hW8Z=^R6kWlxBIIm&^G@eMVQdmxH3-B_=z}M zCC)x|AsSRVS1CPxOOV&=NNez(H$?BgkV550?bLL93xbAt4tcBdL;LqzoQejE+59cIP0H_VY=1sV{W04u&7c)u zw-a3JFKeUQTXuDRxIRh$)z_BS_v^Fm3`3vEPN39(!DkVA=44=sI|C1aQHYtEU+Gn+f zRX|EJY|794k{G`jVj0)7xG#}pe-_zj*C586{2|r<$*D!K^;kq9aF>4|DN)Ikm(Z(= zFT-&f-o6QvD;KTW0%QCP^Sf1pHnhID^>J9`+rvWE1LiYA#?)ng0}o1r&MF3b2%^0h zyGd@h)i}$Jbp*NBpS9w=(OccXoVi~4%6c69FMBi-=aRBv$u!ZGX}`#otYPD2VriNb zAUlbvt-H6*lcd}PWVhkNuN8rAgIdAwHd6qM*ixB7?a-!7xII=Xy!;NX7kl9o{KM(X%N4@pU(2mL4TydjUr%WjnIdbA{eYif+ za$Hv#`LuSHaVFM4CEjEbgI}BCRN*}2F8iP4f>YT6GG|ts zUr~82G>5ALtj~~f;R;PuXtyNs(W+ZtXp0QrD>3-0dVcB6Fr2G&W2b5LtAO1#C51p zT=cAfwFb5Q#{s=~D}*kbpD#dv0DzM|7r0C?no>oGkdf@caSn$E$y58_V)ycJVWnfW z>RSAn;{~1U8gv;L<|plfgoNXnPq~_1vF29+WNRL{U2oSxMq_F6j{TN=d>J|h?;q)x z?s%If#g*#p9ZED(d%rhrW5iu1bdm~X`lu^AxV6zMvU(K7?eFz>3D0VN!6o5N@t4GD zF)ynw%+m3x8{5?6_+WbMWV6!tv+kVI8w?BaIq+pp7?T#HE1A%+S}>nm*knlP(zBmB zNgpgsn$vS^$kh<-F1ktn{HOr)}?SvJj8_D=54w%dvcpjWi>Smqyyyb6~=l-II5uBJN3g|EWC#eKnSBj;)FH&Ft zb!w}ueGaFn6nk=bJ(!V4qmn=+Dh*f?fkX^sWgp?iKd&K&xk4AitvX=s4Hk`T7Amer ztW~w%=#l2trIB#Bx)=rvbKI3$`Dw-+Mu?m}aC<3*(7MzeI6Q#I#N$i(km}xeJEcr) zu3Hjga5*Y64R;-psk^mjuaJ2RG3EIBjr=8}mc|K)9;4sHTHbC3PigUV}@#|@5r8qfA4?1aehVznAn zvStz&+uDLaI}`SC+k;P`SUgqe)*kbs;qu1{cC}T!dub}R|4GiX%mWOE zV50XA!^zi(CFX~Dj4?iuhfbZCU$7I!J9nwd_1rC>Pv!%(<9!1Oz2|wDWO_D)rX{Dn z_dZ}T{j!nFJ2?qyQR0>Y4uX#K^aYb`qoOO6P$gOMG?X@ILb`X>D9~=&nxP{FczA^9 zwMrYy1S88P%VQTje{}QzMGwTz#O>^oGH7&gBr1o3)JyaM??a(d8CMe9OF<*iy;Quiht=I<4im9Ak&EiKyt)oi7P_~CM=@8s8%dq<%WhP)`zD!ezWF(wwDsY{ zVst9?%lJ*86Md=HRFmm=tLzaff!NDE+R43*+dGGjC&cxFT(+trOU1qT)&yOv);oMi z*|>SN^6phT$>&v3)y)!2`k%u9)MgAQ}``eFK;k#dS7wzMACq-CLAEev5j0q`_EJVNseqU16Eel zc;!M(x5)Ucx>|H}0hi5ON2TWp=s zeU>p;&34Q`;9W!|l}~Z>kSEkWvrM<6foz4nvc~RpnKQ{==_;=*YJ7z*xd5fiKp}>b zBRFMCqXzE8Y%CD6c9lauuLEJXZE_>W%9?>N?P^Y&;Y<<-dpjAGiWP>xs!Xs_%wMO& zX+4QM{Q4y9#sj0|<@+VH`p=&$7;S$Nv ztH!PO{Q33jW$RT2Vckzg11jQkPIFNB7zU7?>|zW~1!q-#&6>d#Uxgfb~66CpABn!izFJASv4Ibp&fV?HJDn5=%vE&9;N*n01 zyLRw!01(?|Gvzr~q$WBWOKL#gR^ZNlgw8acK25W?@YtHg1WILMcV!DlVbW&a9>kKm z)kxAZ(9bQFF4XbckDRGrTe zL?f7nRtB!FZ<{SFF8`2@ydEg%v=;RUI%@lKqd}qln?xWntSRiq$qm158*=!iJ9Vlx z7EuXhGW@geU?_?#00=kxD}|O@n#F5GR;I#&(F9o3pWJFtuI(J=i-T6m_n+j_AV&b$ zISZ{^IrbFO@#<?zCyl8M?+#{%0!SNoaSnw|phQCRb#?fYW-rz>dH zG%C9jpPs!quwyn^kbn*f-$hS|FgzsJD3hr}G#5y&LpgMp*49(y1m}0ae)H3Hu znU$q{em9%N$aZB5MfmyMvc)9Cqn*mVf5=;Jok`M#%JE{PUcEzW9E2_3U&>%nl1z*C z$*}EZ1GD{c2y^StAg->@p8e=tbO(D9?wQYU@_f4wGF+_A)y_MeF{I8J4OXE%kytUY zwMBlmP!7%Fq93OWTIt#j5}mT$VjHx2Vt5RMhgL*l8#&n5>QiX>21+r<9S(4Gg&1z z-d`?h&SmZ+o@)t@#uF4l4f+V>V2QFt5=Ln4_qF<*+>5m$&F(OFs;c6RKumW0j;;WESyqLj8Dw6QcW$58@t)8Pq z^GpF)r1z^4ZhW<1TXTfPD+F{dEesdG@l0F>4|zRfp1X^sl4|XkBDG+6N*GojSnd_@ zoFkl4oKMa)O>05pz)j5V>Z>Q-JuixOVKeZjeT>!W0?n|Gu%d8a{yG zl&qH>QN)LQW|aEP5ti_Q@e&_7pM&qX?7hNc_3<-)vu+$fF8eOseYWbdTd5vav$7Pm#Fh+Tul;Ni)_?l>w2$pQ5}DW36oCqC9{{m zS7Tz=SG`0)_xbSN8a&m*NdANdy-@zOpj5#GDQEnyTxdQlG7eL^h2_BZ&MOA1W1@@y z0fXYDKOSxRA*E<569Q8dHo7s#wAhuS_2ZP!3)~1rw*D!qD~iec4;2Pwbdj{;-udWa zQ>)OI3M9jMxL8piea^0NY>uyCD!TMqs|i(W_~$uz)ghI1;qq@a%={ssWeY}vT)g2O zA80>L!4Q?O{^5--cl{!<^&1G-@bf*EMe7@6tNKTb4s~})&O??1>B>!O$ z09r`lg{vJ^C!_Y`NWmn1kX%ABzU6U;1?Uet}ICPh;yZ!SU*r)W7#KZ{Jh%$IX>-_r=sr*xoa z_}W&(%gsY8398A#NJap}YNl)8<=w+w&NdP7tl5*jpGF6p>$xgE>#}_31j^~1JFrx? z!8or+`^GKoO_05Vh1`lypW6$2Tvf!y9T*a=QY_GTo^D4uL{h0go8w>V4|QL_tMW=O{gSbt z05~^```C?^b_|dVdm%W688w~F!R(w&if7nlhfBtOd-a-~IGA8r34<@up z<1!_+h)1Mh3VSh_{HCJMAt7uzRxGIB{Vhda%SKha!~^HVERtsX3#hMUstJRs?7NvL zlFO-U`d2%kM3sxHr8RN17hU48^#FjPIxAcq@Lj8wLnWIPx# zGBRx0oV;6L4|370H*A#zeo-$jgRC_Q^6{U4_z%bnY2bC~&x_}JFBsDvcs<|9FUTkM z7noU)OCvGBR5Q&vQJ(T_a**a1YL1kg52K@@tF;rPYvtwuQx7G^+*NB=M)W0$f3H$l zfd9kSSp~EewOu+ufS|<*Rv<|6;!dHsyB2rX;*=8H-QC@tLUET;+@)yo;uOu$f4-T2 z=3-{w!-UWPyMRgxnzx1{YEDm_HCjo&TVCM1wR{7)oj5-Iy<#87n&*c zq7Aj`&1cwg{_3-D!sf}1q`o>^bq~C5cSJam>Ic*^`Y8}Ev1nzAN*f#$La#3NY?X#f z^?oitZnm7Ex)IHv#DX9i59MneI!i%syAgzun#rqcHvlqKBf<33!TuY)z#^@&R&sKl z^!xy|lfw^AF@fMl7OelcX@dbFGCic>Q zkkzL}Xnagx*8Hzs?#A#g3US<2g~W~}&lz1dRmfxn|68h}JsYwA@Vle3t5krv5cNx= zL9VQHc6EpvCSnH*M}y`5xch@@T;j);5qRapztCNVzrN{bB@B}U$Py7$tbCBzA9%Q) z2N`_``VrgG#<+1p;3o;3E(`A+1S!0kgZSD#T~}1xS4H(#-bOI7pLv4NvYh-81k;lb z{&ImDhXm>HSdWYgqSuY$=kOX>1g+~*n#G3ElBEl9Ihc@f*nr@ETGF<8qcY`D5!`o4 zI2?H^cKi-hI;M*&z~Z%C2nm5OVMb`FuBIaw-28D1)3?p(X6Y)yCd$S6YIZ5R>GYhV zT8LqGKgTMX2YE!qv^o$GKK82_KjTDQ{xo5C*c*ve3wz}}=$~6`qP8}uG7@@v-2@i%i` zj(^8D%iX;{W5p!B<2j&s4%Ye6(smT6D8_>EjU<)JWZSd&ufGvI^4bq^?cq;bWr5$) zV8c=6FTBqc(rh3w-!L82WVkI|I zYcnF5P?ik+q=|n)4m06z7-GNqG>H;Ro|n9=uQ6l@&n;E)lnvb5$o4vHgZc|=ZApNr z@V)I{lY|FlFDV87n7!_D3g5bvnK&!31*`9uk=_!Oq~Uv-Gh`#@r&Jw7t z_f}w6JiYwXT6>2hsgP7GUIZ~-XWKXX_SUyjNXi_1ETrHjv;_eOqP@uitM=}Vj}uD0F=D@z6it*K{k z9ns$iafC?*-zmx$+(#T3#-H58aR0#o9@Jh<7*ny#H+}`~8o$fWn5W);6D9g(y8;Kc zYqk4rapucv8ItWi*PIS%$Dj;p_f21PWkgPbxWCh-K6Geqe`N};qxM{W3LaphjL?Qc z2f#?ZP!0-WY^5|c10wF@H~26}=-U+-xQ08Og?svVrDr|6gbwSs+Q zmFA}~+&e9r7(!`z`eYuC_V9aU2<_OZ0BwpciQ$Q1^;fk*HTrGiw^NfFFkFNB?4lxn(R zo+DKG(f!20;+DK}c`eakpV!g*#CGF>>GMyPE0U+5m%|>`Z2fxAe$TpV!@19WEwINN z)z;Sg>d$1K&+gLq984TPz>alae*e%rgTd5PR@rxoBJ6W7&)CXWsV=4hWbME1QF!Ng(WsrhkvR`;QNQ15B#fyCX=a}8k3}`YsFEg5KS5QCi){+78LG@jiIFh3KuG` zph^pJ;-n&Y%SwctFB5_TN8?J(mrkM~H!@duLdh=2-!+6_{P*hj-+~GB=o-N=>A$iS zD*fWJ8Ckt#D?0~PZP0BShYWoiZ%xlKzu3Ypt=Ez`iyy4K+g#rdmh%9+s7D!~CBepm z6Umc~GNZ>s;8H<^L;%54f1TNCrt^Qm?LzkWS>-S<1Z=(DP)USz-Ko_QUVeCj zpCU}7n*qAB_p{YJo2`<`3JZ)ylQR;jJUwCf%TlWcIKYGJ#OPoCo|X~Jedf_7324v4 z351<%)f}po`d_u5P+tnZ%X)xMsZ>tZz1}*`UNA;}4ENW;iN_R@0cEY?7uF`w#1_f@J9eVq zKDnUr=kDaVy>e1Fw?6wxn8eSaXjjdyO<9TF88;f{OvPZ_`drz_lPo9vFX{Qe*W<*a z{gO3Sy;u`zB<^$z0u?*tX3IDInbOO-_D9 zlsPcm?uh|JS)3)_$>?EvzMY)U;KADnQa_FlOFbe^7CX*Y$EyO!Py-i8>23c2hLJ>a znD)j4)hRo_oZO7Z&S(z8DHFH^MLHR0`rXo8J4YRlK{i!C{q7O<4=pSHjLXYW`|bOE zc9#TMxq0dk_S>XM{iunHI+v2yZ(IBH)deY5XZJd4G1iVO-fZ zpU}(LfBR@ok|oL(-)ojf{jnQwEG%bST$)VKPp-LL`$?@|xq|woyi#v6rHjbX(4_fz zv-7uBni|<}6yndDveY$KpOXQvISD|kmh@6UJt`0Rz3!A+Pk6}!o;ksCQ2(M39@REq~rG%7%j z{HP6^F^WtNl`AcK+a?B6E%j{@Hq^-`-*VzNm<}IesVY_Ey>@3Ep!aq8%3Ps--#F*> zx|l5-O3dsKk)@vn(;64@!yA=w29*H-c=MqJqPMgdU$O6sO2h`QYrgBQ^L(mbbU8}Z zk`wJr5B^CP3=aY+QiN4LnE3MZ8uqvhgVo?F190t| z3Hg{N6yJ}cLQ4r{X~We?ISI5apXt)%%2H;M%brA+`TbiE0m?jHB&oWA_;3Xvh#tad z;5|#btvJttRqeA0DMSSOCQ+d|8UgAW?gX?go?GGtzFn_c6Z*gd- z#z`#m%o46fQuZkPfB66l1@o4*rKQcJ`~2ihLpF+O_ls^StE!ki;&;9eYS|kUw(KT| zw`Q#9U46<_8T@j+08HB1_3uenz((Ptk}d>%pTktFNF}mVOD=hkD_-1)-Zdhn0MKUp zdJ%sUYp`p46d@`hTD$IrYzMia2V3RAt1Ge)13F~##qdjauCY>??XXVrKm7LKO|3Wl zNPgRKR&MZT{pHVN(titz{g*Ie44t6>)~BBZ#l-;th@2aFJ^p$15`<#WF=s5Tlr$?(NDT;-A1!eR zk&)*38Mr=SO^q}D8Z-ZsW&QR$Mn&heBq)8vRW$bHr(p-I^qKr}p|1`EmulNVfm~)> zAd230i6_=j4~$!=qFz`vVDqDOS(*87Q$Kvr;N`t#^Y7?_Ce+Zc#SQ zDBnN7j$+QgdXfOt5`Lp!s!wE*k9Zc=5uv2CnPEwlfPoB|GeP|2(f~w#KpBS-3)Ur2 zsn?kf`=^yOk7Nkw?IIDpW=;HVKW5Yu5H@T)YU*9pM^jjDb&yk5vc}vaP_AC~>_YQy zSWAE@#=Im=H?4V)WuV?BaL`E{vrH&t8y~;#`uuOSI11A*H)8ar+r*EusuQQ!<>Z`& zK9ER*dI(NMeP_B5slT&IOp}W3B$dT)jy6g1`Ah{qrUJXXoR0+b@C**qy$02fNt07> zufN4-_fh%+nL;8HN4r~Q7T!G5u*gr(vMPbw!(c9z5DI0A!T{=6c@ZtDojsAEU%jQUnRKuw^7o9@bdXYjT}jSq$>8UwylcAa~pjzC}+`Q2_CFh zHML#l3>UflC{kIFz=} z4@cEyS^InQt9r#8sy@V#8Zl#w6B19MrPiNQRA-pW8($kGl1r7&<*ifuvg*gR@q;AQI86Yf{;(c z?+^`-Y3CT5g|76j!;Ln4{He6Fx|e$3`sewsFI%h6={^gv^!}EpZ1!k;`67?t0ef&1 zk(LI+BX~Ge@0-DMqREe<2Lh#;8s!_qr8J1KKfWgkF$re#5ap~>P$^sTrb=j?E)l{^ zJiq*IMPqz^{2?PzvzqNw>6U4-H6*F^pi4r=B!oOhQI5*DF2nkEDJ#i`Esi}z2^Zbf zRzHprx&jDP6Ld=Rgl&LBXBTx7u%I%xCTLPL%EW@bba9H}g9(=^NbLH}X@QXY($Qe7 zm}9Xd5x%@X8CC8w4{y7~43C@^-|&Q)2@>lNE++bf;s6l+RbHPU$v+>yTdOlO;Vy0b zLoTWC0f6-0WCmA9?A(CnAxenKfw1?ra#FW}l3d0p6o|hyn;tQjk2VA>t^IS4f9Tif z@c|KoW_meh$i`=5C6-jWw_9mP{xJ#_Xn@w!iytV-c?ZDW3@_{#O`he?~@cdGm$T6HBl^0vlf&7mO)lsR;Lx z!2}Z555Y2_X8bt7szWiehNvK_{4-cB(nJ(~OgbBjta+3qZ=_HRm~Uk2^hj7`jT3Z2N}|!`=wYZi`d7RD`_+4-d!@Than$@Jypl~i{Cq%fV8n`XY z80;Sla<{<4o_yes8u$=9dtG#>Mq2p`Lvit_;-c9Y?@_zP)H>q<#jMVpkRf%ywu2J_ zoQMnnXZQQ4{)dfmt6ZrEGBkLxUKIpIA_n?XB3tQx3U!7=o!5b(6XzglP0Fye1)Pgg z&aiJOs+p%(i+p4-pimO==)$V%et;KULr7ln_|UI0+D8GI_{2R4y)kd3nFJb5?{+sj zs@ihKYMBgcfo}q83wIN(1E8W8G>&jt3dFUbLFV5hot}0yMk7TOE=T{6t7y9pqGdMK zIF{i_P)0?C8JXJHO9l5(}dMNQAKiyk+F2IDxwAiPF_+OLx z{(G18e`~e=KR+?QZhrMw|B?Oo&a>-` z&K0ugu<67ppggoqqnvio>62a0kF2o!mbhdl?Kvw?D2vadaYLlg+ilGAbKphf)<7x2 z`R#j0*k1O7E=(H>fSc;DhMtLAC5_&LH^@7&RPvSr{VczT$!-2DKXRH>5i1Pcwm6$P z&Zv$WG&+Q!fAt1+RLzn&+I^Z;N`KXharD>Q*$NVMe25XXe?VCHs5mz?MwY#^Y+qfY zUV2atTS<9hTUEkr_NHPX}+Y5E#5rg!&bEYUQ*IM`_5ft^l@Tt-pGsJ+VEbH?z_ZI=}C{t>W+t>Gl_9T z^mlM!U;y0`>;raXJTdAP2kqX?U+fBMyQ!YT4VWeL1OD`v;WcjVj zp)6~zwrcuYzZTM_7L5Cx``{lp%Z)B>m=3z!GMC1- zintvl?Uz2jF{c_n0ptO|AW;XI?gzA^rGLm}R$TxP@6Bg2?YQ$Sq!=QE zAQ||lnXkP|)8W>Mj6$hJOMl{sKZ7eqf!WDH&C%N;rYO`u6vE$2SL~G_>eN5C%s33c zX`9`hX?Q~%ahG|>iM0+}JZAgSTasj+Qe=?+Jfb9Bd{pZ8Ha%C&PiyS|^tMqJzd{G; zrhX0T_X-}0k8lz-IVmu5PFJx_#=*%b3 zQ>DU7u7%mWkjL(t1J2O&dn17qlGlmGT+CED)@-v4%Jf?g#}Bl9-!M{<=z@R9?Grr!5E-mAj#1uD*+?d^-~`;)RoZ>A!49OO`Lf>pL~C?J$Tfy9md3IpNeuRSc8Q*$`km^^+7GuC z8jE|w7cIfZ`$$_AWql=uc39AvE_e}p{OkjRU2!paH2S@W`qPJ4gl33~bKLK;VWUcj z%rJ1zD1_~>ir-Qx&Vo7dnwXYGf_U?y0EEiU^ycz_eh?Fb16>@ga!DK#D*U6s&kU5U zU=kx|)e~U9e2So%!UxM}AxIoz70%)TxLAS(ph?Ielce_iv|%$R7n;}nk4oyRC*5RBKgr5!;xyvTHH`VTJD2SoCDacE87$`T?v@RxJ}i5$*i70L2|tFd&n^qjHD=Oi0!7i4&W3N6Jx5U z9r>t0w=4#6gj1%Vf`Ikx{vkIW4uhh2g)P00l3MDj?ckRIHuT&yE-V~ z5HUrzLE3<)S=ScMNnQ^HnRY-_C5R-k_;}R1?0`{UKnI><&nl=wk)iTtolUh%Q;Cga z*#CUZ%UZ=P<7ds8R0b!uLdzAKt0|L^AWLDYYj#;i^)%s)V%y$niClq3N%!$@hozm) z>dclahi`4X*<2bW)-*5G)t`3Sx>83tjkHQOcoE|ADF772e!Y?Sl8fH#@fF~2idQ$X zsdCJx_t+vmWy1uYC9Cq{oTB6PL{p<}8iL1!vAPyuE^tYWBC*egcZV+YwSAb+ep6$M z2s~CP79YVXMIm2|QL8eN!vHFre7Nv|^y(+@Av&=SMJXy$#SXKwc6jF+$(fSNhI`{$ zl4EwL{gJuijt;VOj+T{)HSg%^j;v7P#Ust%8w!`DYoWFs1eY*B>>>{TmC8t zKpgNm90h_pc|oGQ1%Kh3jXYx=YJ$;J5q1WdZ1f3UPlOEMEu567!p$iNOikcH%couQ zJ#71VL%+#CO&W?R1dVS+P5`?EQij06e@t1Cj%7ssz7m;7kJ?nAk&JV_JmZ^O|0701 z=3wl6=3~}DDBU5!)@81xcias!i#u@<>CX9hc~M&iv4)%->GOt0e4)7u*^+5g_${ma@S z0N|3gX&JG=W?(_`o?hcw1b{lA=c6Zp6j9mSGU7e$#Mn}n0e`U~uDpZYizZAWzx87~ zXU6Nenv5%u^Cs9QljM}vMLltzhzMlWQ;j{MVibTt95x;g_;J+<`T9xEvej;5J|nZQ z8K1-}YvXRZ)F-TX1;ZT~AZ>@1=T448p)Kk(jnF8bPIbs;X332ak)@N_eb(TctiH0i zPx0x&qBtEqY_p~~fdA9=fY{biHFPib!uS2U)mh{2Ezh7c;sna>>zg=Xekj_9uFmQs zy$z9h<(p3i-!D>t@t~D0_Zl@7*K5_;1M@l>w+>(ImYcWgY~XQ*;h5CddA*&<7i%H6 z1^wsTY9C*SY>&L02?hLIcXocCUSta=6CX+xf!Rlv3$UF$xQK*#j2pGSY5^6lD~Khf zVLU6Qb8;;YU_*Gx1n1GC=zfr#S)NVEn)Yrw41+0!Q5$uhH<( zI)xu!#U1Xjo|engq&OE@W^mC;qO?KSb-s!Y zc1Si8gSm+|?mJ*nl?@YKIJzE$KRpR}eqbU`t|-^e4kv?5`#V2rD-+%? z91QV1`0&K`HxnQId^YGd{osPfTZl5yL&}eto(r4y zJAg^PC}zu4`sO;qW=l$5{4qmd8t@`MA^`N34JV=AA-W?x3>-aHQ!#Qx0u)rlRgnyT zLZ~)pi(dk(q6?ti85MT5gBm1v@*_b;-Z;-FunfU$bk;n(a^m6knQGbthyj#8~kncyCR+H1(m-O6DVs;(}4B6Y`!+wy5AIh=1TK)HmN>VFdZS92xnqJbCwx-=n9uy_*zKDYB_R$7DG7A}i_aGnO^6T+ zah(24ORClF5VfwDyEu9{6L~q^J+SF_9avn@$4JHSj`-BAE&Dzl3KjZ)&uc=@)vpL&W*9WI@R2$=92b}qE<5MA&@*8G`&P0M=7N~da ztb6xDsTW)CM4-2Ezs{$*OCKOlJZCUGYhA9&7eigvJ=HqdSF6`I1il(N=y~d0KN>%I zSoN>p;I-QLxV-xwIP=H^ndlca;Wn=#AYfIcfWkW%*ay3s9)dVOg8SgWUs3Rg_uqml zb)F3Vmb&ET++bW5qIoX zBn+H*v9jim_H3p=rouxlo!|ciy5b>7&j4?`egl9Nz!~2)VS*e#6N(stX*(fzz!H`$&||RxG;* z&dpE3>JZ|L{CF%;2fgbsJi1Hr*lKQ76HZdD%U1lAYaKUwyLTExGnn5U%npXNDO8-X zi|mfmYg;XFjWs7|rx7|P$ks!$)-ybp?9{8kUWp3Frc%zoz%I3F89t{BHmxO1^(ks` zd)+=(o42J}9lt+}m>elNE{Joh0KZxM;`pU}2nD9`N=2Zi==@NW;<}ZNlP3MP|Kn~f^A)|P|D_U zu^i^&MR!EzZ#Nmb1QB(F$@jOhTyXl%QuVO{(H{j-9>O{GCg;`sIm9(R6FOA}zmbSH z4vl}#LRw7w`_Nq3E_RtB%u3NZ07pR=_ciPj1*%AIU=sxqlC5!tIR_RgXC6w&^hPby z7LKmBYi5p0ak`}ar-64}wFiS5bjIP?pW4Z?`y+5I_k=4CVX#Athh`kKmf1d45d(fKZyHLQ6beLE%}$u>B1~>Z2&b^rpj%chywASUMGdht5AHLxQvJhfuXK0u zL}35rgJ1$@N%v<8W}-RAR3hGAgPwm&?dSN(v4;?<-?cer|p|@ zpxWLXNAcq3OH9Pb_YP)nsU@707B zDZghXOXAZN{lK*A${8anh2qJ44nm4RP8Lb;+53hFXQ;HgDNK~+Zjq<7_v@lW1p{|* zfyP>7l(ngLxKYvnjUlS@$9ilVNji}H$afo~a}BCYtft~^S{a5C_Jf(|Y#CzIishM% z>v0Y9d838)8f(2$XWNIte;u0XSQ}8pnokR}^nP(Nzex;@`t(Wa3zZaTUOsA6*$M?G z*Ev+2XLiN2y0VWmqOKwHb6XEC=xMYWD7Q8AO;UY`-2zZ1jzRrF@RIGGs|}xdDqe6u zgT}s7dH3aeo1{lVpR)E7=XG*^_53JlIuR62P;Ip$Qri{GNt}FE9fpN52*K{=s$tJ0 zuvhVT*tPAm>ft%`Z%i>_#_X%>lH*qs6;U`WY*ux2QIJU<4Tu{~OpaQcEn5b~KPPo7 zE*$g~9}hvHuU|N&2Z#Th8XxbkMSQaT?6F59Roq&NdMNz{k3HZ1hRZ$>Sbe9Go`xmI znKV?%btWd4^8I*6E?)3LcwysB>1?Oa)gKkEC2*>?@Mu=0!unj(zxA9Cb55%w;cSEf3(8q$*A+42F(a*rOI$OnNqEUn2XC8t52;L zHy3{24c#-HpzvsUue;ztVSypI1scTp^=TWErmg~%##NmRVAn=R@+oAK<9mE23jy!V zTm2tuK({ii&9$5If?GUI;}ls6<0Cd5B){VR-k z=bk=pD{HpV{OCti|9yYMjb|}hFxE_4MIC!KzDtIPibP5Aycv6kQ2NPua5d5}E!AwP zCMspgXQoD=LT&|Bl^{N-<=uA>Gcz$SKE6^y_y_fGkz7K}-&!%Nr+8OyeB~03@8uk1 zHg6ssy>0H^{0H?4H1{0nkYq{jdxMbr6XJ3k6TTboWn^8xU;NUiFv*l@2Z+otQ} zy!y<=+<@0+b$$+KdA+meV_~85R>bKmUj}%RnO+KHqz?8B#B>bO_&R*h%o^M!) zT(HtRrL-9}A4?QD(JWF!Yif;u;SrO8G!&P0Hcs5g)ig9!x4KGmgxtmt20LLLCv(n^ zE=IzEyL?JW7mp~8;S>cRS`c<%lS?W!A{Z%mdkAiT* z5IYvi35w^*TG9Jfsn$s&8tK+#O81xZ51PgzYrRsmYsDalE~w>^;^BE!Yjb90o;L&A zhx81ifs_wYkx^sfgZ*5Qv`9*OG`ibcHdCnsbow*X)(r542MeDzpF%o(Xbl!1CcNYs zyh;(nfos0ynbmU6j~i#ggkQL;u=o%%IeCl3Mqnqtx%Ng0pldW%1_^T!eWv`=&mVfMLlU54SOe)+QZ($~VCH2Pp1VH#&bB$S92! zVD97`K7mAtIg1sh3M8hHjR%*1?Gf+MOo8VT!(d>?dY2?rzRyaUDw;R4pENlVRt=o= z5BKM~B7(<(6VYbnT`a@`S_D~OQk&cMqS4bu+N6^jZBy)K)C?x^(-WVFBIAHU$)%>} z;@6{BqGWVEtt-#~0+?AiX%}}6STkm)d||DG@#i7r2XnY`GJcSQTIQgUQ+Lcl`Bx#y zEl`oneu9eZsBfz1*H+(u$U%*cposTI8fu;7Cq3&qmVK3`_uktnOE*QZ~dgJ-2lh%<%B|;q@V|)rWm| zy3Pkw0|0OiVmC~~NxWOD?O2GK=|;1NYgJ58bdV&gG{l{cDsKr<$QBjX0kx}OF3Lo5 ziSUy(8fcer7l%*r%?yxuq}Lh_DC`(m`Px{v4pf!MYDdXhs4HI{{pO40z4sU11)SIw z`$IY^hxnAbg2tix#B1&IP|@I*tGzBqCg;AAx{MAnq7A`?n-IgUE7Z(;RE>{Ba~W508Q=s9ykDnl?glmK-QF* zpk;EOoz{;eE{+^VJh>x}iCX{LRBccslMP@LEkPu&jQ|t@hzwO=0;Juz2n4(B(q$Lw z=x>~!{WY{LDV#*)ifrl#@Avg86M$Tiiag;(@bXx3@E;XMkc=baz1f$E0*tM}new`S zIE~F%o8J~e*IEXdN|SlGQ2-KeX+r#dp`>M9Ikndm7`DN+jgUR%?iqve9RANF~#6SXlpuTolnc6bW8`PUAH#XT#{7QJMvyfydRjuYw{NveMtN}2W6&o=uN_pD{hRD^LN82w@lzrK#9 zc>z0|gjSaqU_<@kaD%5kE<6S%E^GpXey6W-?f<#99{L7;`~si>;d-E=%Ub)#34@%d znNs4^Yg&kj%2PF}J;!V{wL@OyemK@il7_89e_~|Sz2Zrst_`K$oPQdLbPwtQ6ck_O zGN|kK%vp6nwBM6!nUF@dnuVEafS3V?MRjr1aFBH>pwnuVg}03fS}3#hPW5g@VPevw zTR{07{#a6HxewSnJ4uz#0rf}z0>NiLwmn4;-TXx3TP~Y*Z<`b!C7k*R;TE>vJT^Ag zqn#!{`5x1{*>JiUhToh$DtHUz{I=d(>~4RtDOTM4CT37veSE*UUn#o1P(gvhVJ`N% ztAjfX0D<7)0Bb|TGU!DkgYfW#=&W?hYDm3-$+%Vhq5~oFcIdr7#A(r^h5-Q4=r2|w z1khgAt`mYrn*P?keeXk9)82p4 z&j?Hx)1-K*=eJICVC3&O%tAh6-T1j0zmp^>yE)T~UP}u<|I597M2-2`25b7kKNjT=mJgZO|A!_|9>~RxLD7oBqKwz33BrKN)w)Kjef^{Gq7( zVGA#g6o4SacG$!L0B_#M@i`R=Cy2oadv%x^Tzoa(v@EVt6hCWTlnvlw3G0rjjH;_0 zkg3+QXvDUun^u(~ho>j>r}5ug%bXLRWFV1?CI7kl&_ZY4kk)iE z@rPN_xrav7p>9qD6k7sdYD#2-5P{m;B3(z+zg*h}5%dHh;lC+zPNiS_)`VIgz|Vd) zh*T4X|MqbIH@S`61+m}5;zm+yQLk6`c{8#dPJKZNR&nUq;t6e4<1nL1pJEeT1~?-bFeeXDL}OgU!wmczl`z@Rr;gEyAZ`*U`6 zg{B%FA?2o~m)hQDx${^nHGSQ;z_L}pUZHH^CH;BNWFYbm)qVtk^RSj z<@o!N_o(-(@RO;MGwu5~&->bZO^l9)g4SPBx-Hr}JGq8J**mxQ2$4%<4L4AJ{%0=Pdmy zDU6k%fo$sHJ`d_#-|&~fZcCf-sYfi;Dd5-a0nwI8f1x-`aT&hooN_NntnFAP&ST~g z6K8T@*VxT_nuy=q@RwC|M+S;pQ(s1@rQH#7|B}lfKP%4(3>rl5O&_ZzVpv{QHV+#L zX!z)!hR3&PItQLq;0QUrm8SCzd(XlY7f!G{+FdffsID>E(DVd`Az*Khg1o^>aB{60=ZH_*}7=0>iME1Zg|xg@+&s<4hE(3~gwotaPEX15FnA|z}CWxiGF8}$PkYcS4KCunsvCt+!h)vvMI-%8OmW( zWy(q|{`ZDYd57L5+bm{mxkK3>@PuWiu^EVfDox+z-f)cc(tRQTlY%{O%t%|57y}#h zb=5O|QV9@W=cxtTrXgc6Awl)<%AI#@JLgR7R}6=@OE55#{@!w=1uv7FTyaaNHr!m~ zvbn~H=&GFW$@`hK>beuwG;rg+I?mDATEzN^L|b-9?f(&Lfv-rh5!uP#{VY(`&K3N9 zP`DQCGLPc9yiocB`4_#Eaw8)Thr&w zSF@SYIojWaNaAMED<*o}%PI_{*ky>w3iz5Bk3@hAjW0=>-KGuG_f8=-V8Lv(cF9L^!Ow^E&kw zmNZvxLprw7StP!eYllQo>~WNNZ9wb`!TCqgxFeSt#^TBu@2(G`Q%bv?xTd$|%o2NPE zvYNqQ zN#E1;`#{4g*in;74yQBXn=&Q#x|hbe#?GqUGQsF#r5sp#u_f|doX8xDF$$6ur4_+Q zh5R-tC1g0;ukV<_&A%jTm7JtzVcP+SH<*UDG5d}II%D7yl@`VQpaS&w3g||(A`is8 z5OJ1@4vQFyqa88pd_}tK9^iKTX6@-;N*_&XY_DJGf}qAi28~cIU&o>okx+bbixvKI z@eaEF3jUe_zN%0cENGY%l6$(+vt7(%Eq$r+_CPt|vaY)L`Y7XMR;f+;7uMl}$|+Z$uDB(o{3Tw547Z z6raJh{h<~rOU@YK0NF|QK^~>D$>F@$C`IM0RJ-qgH?JZ&7Y4tm_~b11BdWIu!BpUE zMN5l#)jgl21|ffUsdCW1L~_^@wd)wCxq@m*2B1rOX&>LoTT0dQ$rj!lztqfm1O4uo;+ zw`37IfEesNE{BSk-mmSDhU&gzKigt_sP3PI>br2*>Y`rlqI2F$-X+ti6Q%TCy7D$t z%PB<(63cx=+O&m{1l+jH8++_?Qq;=wyAxbm1a9PE_-=|mRdOreg%5&yZ>JwC3iYx} zNX*LdjfzX)wZCsMu`*~^AZdp`43}deA)dJ$c~yeNuOOto5_6CLCgM1 zh#OhTKKwE2OIM9{Haw}vIP5AvdF@@A+rbvQ1nzqXVJ5VclaTaH<*E2x7~d`8uehDc z4D8IwQ(+PBgvp^Hi*nKTwns(gRs$=V#2G)>(5-ijBpdzgX6mG{j&_a5<~sQZ&pKAS z5H+EFSA!fi@>R!rwIIjh{KR^FH`AXs!N*R=yxUlyl`=eATr7i~EqBfoEg0o{x!y!g zb)07EU4wMlkJe@)^7f9%heg=Khqmc4k^!jlCm9e$dN~$=<;bF*BJ8{$j>JR>1E)=U zYMj~`YdhR=D3ANOgcC)K61Rks3MVd(H5fY@ex(e3O-AnLNiWw(zv)EHwT0TMQXQ4# zs@0w{1wK}wNop!B0BS@Vmydv}Pt3&#Y0uP2Q2C))UI z7dZFSZTOU0=9ji|yo>@qn3#BaETxmfJ}8>W^lV}ii4q2Bhvn*r2VwXx(14vz!vg6D zr0b@6!xHq5RghKp7E<@@Me*_sT-R$IJc}NF*x{Q}^u*eHIQm?y_7N?SkdIb$nt@SF z*IlFWXr8qbHWgO%?yOdTC^Z;M`8_8=Ztb$0cO%skUQdF*omN|h1it%Fh0U7v0uz=o z+z*0e_Hl=0jxHxhA=POgbJx^CtISl;cNP006HI zG>)~Uoovzg*Nh?2_-?kZ);4UT9{IPgh6wsdjRtfRz5=FT^B*f*Bv59{^)08X5rjfmMZObqj0MFxQ?Ll{Sy*hqd~c znFY^`XDfuHG`ZdBI}SDZ3|vDtX1jqy4$!J#)e54@TmYR+Ev?~UrOk?)R=$?&b;XD} z$!+0;q`hK9&x`r1{O**S?$HSMH9YaF39VR z&-z4u3oBZVU?iK5HVmf82@VMlv{4BoBJg854p&YD*$js z@6{Po?A-L2A7(U|2G(~|tLn@``CUa{9~7~y8=4eM|DMxz&Fd$zaV^&u2w9u;YWs ziE0Y&8>DGmy4PYpu$t;)0z%CTBCnJhptTy{1UKn|sm9_WD61|MOH=3>h8o^$cA=T} zMan>w9mh}GpKX=IFy_0K&VtEsicmMafHyQ*wY~v>go+{~0c88`rchb%?A5^651>c{ z_1kC}rYoIl)?{QXc#C0ljKE5iO^A|fjJYJ#!~~YO@Uv$IJn|*5v7nHKtnAylqihGr zZ-fVc-o%;9FN$jUzm;J9G(Km8vP$^&19x0B+eCK+2{KMHbq4vUmz=}m_~mB4awZ~dYvU0kK+f^Y8W_!u~2ZDSvFGh?5OFBA~bDn zP}K{tDT`yK{oMI=Vzr#4jCoZxLU6Pp2x3m9)RXFFM9x<8U-i~Mq;d=-Qym5lNUVOd zx4jD+Yv4==j1#gG0~Fvn*l!}H!2cY2;DT(i zkRT;eHUoRE(f!H3o3nK*Ln6NYkoM0Va0q#_@mjttyV{YEOt^_bhFY8M4^TV|Mg{+&Q-{ z{tIYucF?EZVg{u)zd}453>BWDjUf}!ogr;vUm8Pglyg2~ttR6Yr{(5IhQ-nKcKG)3 zO}Qv`-H>w%)SW4^NPN_hG!uRO3Uw`#jpb%zX-f(wBPCFYqV8ZwBtWF@AKn97bjWX%a*91v33vtZw%}1 zwIhR8ShhbYK-J;lQM}^tLg9q~Y#`u^^YYdp^}uWffLYw80M#W$xFbC_*M>UBhhWFT z-ruqj^A2*kj}6+1TXQ_i_V$=LD29{~-V4j#$UECtriYt723EMcmAgIgE$>=I37h7w zHw^?Aka}C1t1xBlR$9%e7FX|OSH@$`>J**c{eEru+S?sU?XaZgm0!QdbNI*#Iw9Qq zA-fNHKUAK()AV@1QvCJ2{1y4lvYFKmJL|oEO<-47{bk3G( z&iFda2*ZX!7D$fGLKwY;vtUJX$R?r~hmC*%A0pC_?Bu+1#4@F(ksH zfdsI$=>1?=i}FCyIjmG*VFD8w3c;Xzivq5jxCc$VXK+Sk-iK1Q$MDXR-D7Az=$~!tvxD{pR4zZ*Ofsq zA&>gaGAHtNZz+Ho%yQivGI(`oS~)PEYp*4ldF}k?_bY-pQq!ZL6TU+z5yZojWji_0RUThzW2{kFqIy;erFBf3o2t3h!Y4940dx;+&OPspaOxO zZznl9%tVPQankgg@!P3OoMpvoWby)OSOX^$q&~4(5r6B;rT?b}_rDLX`TzUu^SBZ^ zewOboG`^PRWGn-KutjDt0Rq5iCLEZFW24IqsVP|41=0$j{-Wpwb+$oWxo0~+P!^`HpU%ye#48Ov~>lkJ?u0%Nx9;6oK*;E zB!~kDHSN+ooQT$RKipa3Zowle7&SAs1W|)CIX@c*3;|Q$aYKHodp1N)>#F+*i{hmO zfPR5Mj4=$17y)Ix$`^4D% zHi`{(!nv(fOi-I!_j@!ntq^)v(2wo$_x`a`QRrSan6b3#sV)egR-!a4+saCBbXD%N zSq)$KYO&}rbiH|6ZmX4WfoSEs)=#h3)Y@BoI&X5atYieWMwB<)Vvw@rh&rt>TKjr| zb>BT<@Bb+d>dwigTtMyYEk!Z;nbUUMX{(~7%a0xMXuY=LbhshvH-X&^$*qvAP_ z-UD47P{cdBM4wq?3vUdr-Su&^883HMEYqbmCC_ z-m)62_J!T~XvGX&AAfe}z4U$=uKIoE;@G9Cn&M9N&C}s>(%%bSefYt>ELN6MCZ#Ll z)O6u~pF5{tu-5qDVITA=Q&nAqi-J`}Q=C>fBY4RN^F(4L%F7vF0_PSSU)0RpAh|9R zNtEC&(mDy+{vL<8ZOF#e6w#;ZMCje!U;Z}#E)4qpXZ8OKdTLU0>3E1>?YL2*C}@y@ zgM;tG0IDYUvYM#e1hiKbaZ!-9G-1QVY$3N#e<~7~+rhNVI+{1=8u4kUDJ`k6w(mZ)@xy1v znkRMos#GUBD{Eb&@u^p87YoznH05RCwhsTeDXco8TcnCZJ2fYJBv9P!0$99&00{PD zIEMy~kSJ)>iUHmcyn__VVK+&RDhtXc2>Ag1Lo#VT79prCv@Wp(e1bvZFU;Wu6&&** z35XKZ>5C!b@|X85;itgwOmYs=r9{MV_@@;5Wu?NYk6*b~!yF5QY*J!C|* zL&Zwvjm(3?ivy@aO6Lr|-3b$xDJA{9di{PFEK%$y&`yt5lDU6)= zm<)TP4Vv3uvbdflGT3w6r*^s{Q~=GKyShNv>lBuW2VjeZ;q|bZMAgkiKYp!ZJGa^= zNrEqBUwE*M;GRpol!@i#FDI3L^n?WzL%sX?D=!iX*hCDnkiFeJWoKUe_qNS{&<+3B z(^pM1FtM5>C$ogmph;y>>YNjabwtL~MAI=vU#{P!d^wFP7j;T%ng@?L^#wx4GHS1T z8GTv)Z9J;+9LCZ3CPk}1g}9CUEU!KA!=)i^i>zNXLb;sIO9s%7GBx`mk+D=6^dnX^ zt;Z1CI>Ly&MVMV(m;AE}8Nr(zN@UtGTnai%BZ^hN>WsR80gJMblZvAld{>ZT^QgwF zT)e(~4$XZ2Cqp$0jA>0eC-tGEW2jTVqhql2D#chM?(%tlJQ6Kxa9F%25kXQwWRjL( zfOJt1sW|gM!DF#S*{l#nH*#SaqIfx`e!pgsnsgD|yzE-ltYh(aJO^PBf=YeoPN04W zuUvCrpCLlPs05*~@w~%4iHNe;E`EViWBOJz2WJ$eM03Z$)4MW7SJrS#k}=R*GdIIF zV&5{uB$4#7fcbfnfvOmU%_x^7D}w(|a!{l<0ElPn%?ktxJv*4FZig$hm4#ij%Rhv@VcBz7sAh(($7NZ@szc^(+R4`{kz!`9OS>~3>|!mZ%ZbGIn}+cHTUM&khULj3 z;~8HQKl&cIrj9LDl9>TeKkwn-(J3+$!6-DtAmBS>lVRFhz;EDyE>J9vCf;gmG)Zrn zE~u*}N!NDbiVO#Ej~h%1s;Z&n_+Nr>%-BUk8rnJ|wFzk%kxd8-(JThFi*YOc?ugdB*4fn<)roVPVJ zfE7+g8!V!W2bt)Yep`2(?n9_g(*)#4`19c?yor{G8_R?3)e~3u_s;*~dNXjr zvqI$|T-kH4+x~Q{{jKkOFd1ArU#jIjeR8DY&T|*=nHv6|$K$?_QGQoRW6$UA*MA;Q z;76Wx8*a;gm=dN=X$E0Q9g9;Gh91W)RCy!5a?i0vM#u>8H|G=cW7K$_H1& zpsXmsSy594AW&evaEcpRPP436>T+DfY`>k+qLxLo`Payhxr>eli6e-452_UoU~U3w zP5~wx$$BXmC_{XIx#D9uB`fonjcu7*oz}{mi93ZqdFjTYYMNYOE{en(V^@*q0)INk zi;;J$|J09bx4u<+fk0Wuj(3i=@7w;rAeR*K3V=0>Si80d09Fz79A}OInErvz@1F)s@OWb?|=QVN4;&;Fc4-q%2OT_s4Q)&(&x5YcL>&4*8gi- zX+2xAeT3($#7OIym!Z>h{rKbBRgL<^!E2tOIS4dHdeXNs_7H9EQ})qkAD_J?b#d~N zMp+v()Y685hX`Rlm+BFayS9}oHcP^S zI2G)d3?z|8nlRsvQ@O|DI7dB8yE3$c?(yY#Jr#WD>K&|MgP{d)NB7J(caz7QZHdDT z*YU`#vTu{Oqp3-w z01CraM3VTBNW}&NA+|(Eb8R|o=nTqG2AOS0NC;O~ZL?OUjmG(kvMSaa9#&(8BFbj$ z>+~2CQKlQJouCLT=gkq}?T>h_NVC7FD(%g@@*RS`tq?-C#f8f2Zmx*Qj*^vI0j^BH z)crWnw2HPp+3^hNg_wprSl8&i*(IX}QQP{ee5+^w#C^j~GO$QUk36-egFZJHzMUsV z@*KsB2B!f+|C5}fSp^VM*+S2-{` zp6;PX7hB_+)d1MS^9P?dJP9RhMo=2fud7sw4|-KUdtYz`i>`My3VK+g8hW2*O+YKl zNXcG1JVLaf@@u)x(Oro+j06yXFo=Xo!8zFk9)?#NDeD&2sk*-D)Bq=MrD*n;gPOq6 z3Sp>j82*WY%jT*me+ydYPY(At%sEBinPaW5KSls;{RK?~fclrA=m)?h2SiC5JXRDz zjJmF<4Wf|dY30*Ds_p7*pA;mSh`qvg9Dk$@CeKTuB9y+>mtV9|8jiW?f{zhLn!jYZ zuqV-RUb5+<{U z9liN}^X!>H(gJnY{_4|uP6?R${RdQ&m#oo}7PZ4IAtK8@AEQglJI*v=3OMu9wctNMlR=~&h zt58$RA3ExH(DwC9KFHa!*F*#W7Qze;YmNxZ`cn<~13c1YU_i=~4+l^_IHd4JC9yC{ zIx#=B;4h3!3CSg6}psN}v&*#97e3qShyzC~>CxY%NboDwlpjEF>M8-UXg zl7g$Fuvmpjq)*74`qz<8cAKg;ivfaZ#Z8l{UC69EqMi%+Z#!;rthxMnb8j0MiCK<> z2o*Z1xWYISChUKr+|V`vlGA8S9+n#*HS#KKB9(!6l`k`U%sl9xU-Rux6peF=Ii?Wl z`=5BsO!M{<9Yo7iO_2>myB)kM9uTgTcDn8e)05D)oCr>%O}R6Y;YMtO#I zb~RPY7qQPA+r{8u2`Us)0A)B`hDtZe%C&~cnU`gRGLAxazvui~LyN8orQQxyLU7)7 zQg&uqnjxu%zcGKOuav%TDfNBJc z1^jH>Op`uZ6LwaAl|5F|{H^cj9twGq?!MjqCtDWNF=E!j>jn2M-VOrM%hA>^$<6(i zZz0_r31pxqnWCKzpG3_!s1f#@3FqM`V2nk5h0r3+6QvQ(` zD~-pI^b;A5`rM9BTgWI>iP=XsZ{Va&Iepm(Y@2Ptq)ZfqT*gn5FBR?J9&iYx7t9g9 zS6Cb0Xpr3sXs6La)YPj&zjB_$ohye|uGmvgYujYUME~%~sSL9uh z*turhnzoV67KHA;ZW*GRKUtK2z5a?9zh3L1ZSRPlz$N>4r{jiA4RR4j$<${=c-|H$X^dv(H_9D-%0-x_wj17#&0p$=F`@z@If2f+bk47s;e5 zN-wA|3a~I?qvqv-?F9Bon1JPDwLHlQ|7@OH=qv&+Spz3%BYJ^w?<&Qa2Cta)dYW&@ zq!VGyouEpw5mu1?s=OYG6KPPPj>NvUgiqy_KIfuejxVCq>F#TN`)Y#8pTcEwxw>(9 z^I@%H1d&6>0$9aU*x`n{iJsZ5C$a1Tw{^80uUyRw8K)Z}nNk&OR?^%$WcTO8+upaH zCF~^J$`?nQ$j{NzwmJSi7MggexpVTg)9(C(2sh{mvID^>-9=Wckq8W0`cPt~X|;ZOX2NLs7dQA4)I`c8%H% zmE?j}EhvObd^n>IE3P=|w#_Q8aOV&2saX(Wsh292`Ur6`CiWH`ItCeb@lARH^$u;xI2Nu{?O^Ro81>hKF8NY zz8Ux*MOPEuVWM1IRJLb$U^b>R2p#AsbVyOcSGMdww4X1vXuhwa2}8K#U~gt#kvM)d zuj#prU9*SzWTK#mQ@7%BZ>vUU#ds@Oj@rW!V58U3W1_IzrtTFpD+F6hXU7?a`7{wx zGL|j_-u<>>M6tlU3=?jJQ%9OnTQ8-KOwOe zYhTGIfC^s?JaM~yynC^7q16~fh6$=oDZOo2NT13F)z@;0zBOsJ{#QNi|Chb=-*425 z3ZOMmg#Qgw4CHHc7M!pupxg$=44XZY$Yp-*1O(MYmqCH zXaBwVu{+=XD)pLv&|+~b5ONbl23R2iY9|2Iq7&G}EZR}ZS-_BKmv9?b8aUi99MR_1 zB?`sHH_z@$g`46-Doj%TxPcYr5r9WG&%vpVLy$w*KutNO`ae`mob=Q9h%<)Y01$ux z1>a)WY9?EtIO#V$@C$oUbaBQ>hf}{5j14|Ox~3@2jv)AyqrHOEaq4_Z3Mni%moAcp zGY0`~L8y`!ftZ4m;h+{N`BFLkEQG6TjvkILm5=dv!{%|b zslT||>HB{39V&jb1)~vo4C{k4biz#0tSKd>g)(f6n!VlBokxj3?aeYh30wZUWB1Hh z%a*2Xchuv|EP_-Jl8)Gsp%Q5tH48PP9d(sKryJB7=Wq8j5~|w%qy*D=i>12UDjsbg z38u9p%JY*L!;t_;pyJ$7&}p?aOyF<4KHcH}v-*Igv;S#r^Ph3Km(S*dk7=lpMx(Q7 zO)v9g48!?D3g%g@>=|LIA!|Uqr&)2oJfXebTVxP$MT&vuMuu~3(D?S6hQ&3-f2Y;Q zT;w~F%FmUVsgOch>5tdKh<(r-$oTjATDmUOml*Vb5>e^qRg_O678=Y>LIJG%RQ58< zx5AN-J!%*<9>rw_7-zy3a|eX6PzyJBO35$bcr0ojyFayeXnw9t|!mU8*_tq|bN+T^qaTudZEc zvx4*jM2HNd%&+SYYqm{BpM1>KQUm(H96s`;>!j8^D{`wQ zRQ0j(j>vD*cuQF$lX1=YGmY7vznSky)h9g`EMYe`V`%C>p``6vRHi&DChcQwzegyZ z^pl1GqNMDSnC85^F|!p5)FiHx5Rqh1QJUuB*pV&!$u?f}7&ObU;&fi;826xkd4F2% z{>C8uCD2lTR=ZDNxW~N-nAi_W1C+Do> zrW8Jz96a4Tr75EkDVcg{HA;%$mx6AF%-<4_D-%>df`axSY^*~T3Vvp|paS&4`4qbo z2mp$?@|x~>E$5Ot1*5!%bV9nkf--KFKMGz6)0qC!OB3)jzE^aLNyv!5(uJDl$S{Qc zaw1HV9Zsqi3X8gKon7M}6^yB&M2=CjI=+8rRol2KIx&dkT1@t zvz+5`>|k5X`9md(`SD~$swmZW9x`MH(KXJ^rLRp!cKAYR5a)?10N4rP>qSvpG z5YQL^74!P6d>}e9Bo!(L8v9` z=7fI-Kl`FOigx(SvVSpqRA1f>R@B^M?%^gfZ?t*iYmr$=va-B2A58l@_vHSora98q zL!Ib-W#C|N9uE1Czh6=<&be~>&W40 zDZ+@|Z5ccX0;9^!BJy)+;eK!o^8ixx9kl=_gMi?w#8s{chqGC5GixGs3GLhFiClWn z>ohZ7HX3F~ct&-vtTJ);+u_@)S#eStkwY`NIrX7ecKUKiaq!g0-2=5ghG=DTT>)63 z3;;kv3+lh0Amw~b}aHDZ7UXLuKByO$^1`pY{kz2$Qr|yWgfE|%k!*$Q_62x zvtFtSrP-n*Oy>_Fxi^%TofrHxhaP!P#TVaMD)-Hy8eXN=^6dA*e0%wMTWcW|>(Bb? z+pizEOs^hT@Af@LjzTVGopUWLALTb;k>JL2=1Ns~H0aPmp?G?sV@N-DxX@}w>7b#7 zrANYO1~cGHB{&0t*ON4BdWoZ8YN>Youvuq}=`|R5XscEmEgU_$O6U1r*Ijny1gb|JR98yJ@>X}>D`)=3xn(&7_*`oe=KL1^Q&2n% zucPMQQ=_xT?Vxue9J|9LYP*3Ka<4OHdycM8PbB7{wOi? zGJ4z5N^N=WLa@B?A?lXVJNh`Ta+Uh+uez*Krk(whoZQt107}kanb2MYU>D6-TSEXa zn@yB??ghXLG}?Kw-GJeQc6oi!Iv$S;I&H^(i>OX!2(Gz~`fcJHnadPbwfs}r^KGZn zdTbBlmmxDjlo!7KI6m92Dxwh>E`?W#KdU>uHCH`abbQx$7dWrB2cLQyNJIc0xlVIm zzZa=z0*b462jnx^ijP0^W_>Cn6Q(3oRuOGKgi&6TxG-e9Q6Y-*2Cbq~VR%r_pfXcr z+zuehZaFTHLP>Y}+|ic8So9z^Ld%fa_+-)4fu=bKjoH&?Ner@iG%6XaXBxBxazt%$ z6%f-yt+lW42cv{(YzY&>)H9MZYf&{gtaz!=hjB>FJ;}ljovPh+C#Aw56}z&iRc!aC zvo$oEdLbO!Zi!G&u6&9Ld4=U)KA=yBvM{x!6SJDN{UiV;$vjX zHA0+ZmI6vYFt~E9QgrZ)DN_o8tcFaqV!#^0ii5|Bk_4qe)%#{r1LZW!7h25VF)8~9 zND?vF3OE(B!a~HDBaB%7@#T4>9uXL4x%2|9)5UU|Jq*EISWRMKx71_&STI>&?c}Pa z(%OCNke}iDYQGz^FvgEGN?oH7M<=aDcFn<=h}iSn0BwCUB0WCki+&K1u@2qfAJrO@nCys}4x`nNi0#=wY#vozJ zhI)6Z`E$B`ZoeH3CrxZO0!d%`8lvO%V}60YDK|CJ3}y#sd=A z5k{5^CAOr#@>zf39)qDr#QF_SoJ19NLs|)s3&2P?Mr9RCC{fXa=5YJ6jw>FVB7rb% zgJLG5Gd#p54xC`@hz*WG%E=&)lA;hfD}s*CDlld_&B$8j&eN9Kt0ES+q+H!t-%o$- ze*qQZViKXkU?i4^;-LHpG?V+)Vo5G(O9oI%FU8lUr&pW4;>$tT#E3k_5BCDQ!TY3w zgeYSRTqbDw%rc5rq9F@Y;L$doqahR9mCvvb2sHo=8BNSI zO3e_FQk6l!uj>-wd*nD*M%al_ZKuhz6rbMx(~36;ssdrIwYh zqhY%-v+-~&r0}wIVk?Fym69ggEY@Cgqft$vL$A`QtWme*S{@D6kzHG67}rd+%8?@L zmb6hZs?0m6EWtgABx}X}f>N$DsT$MO-_9v^aN0avWfmT){|!S$!~}o^?Rtr3KJY!` ziHj0AXBBu&-#!Z)h?b;;9gVA_J9rcCuK6#@l_J^zAvNvR&0!_kX{5ows!VJKc^92(BIlNU8iTazw31Kf;n-}*t%c@3v*)zPqa zD)Kh`fe>y%8s9={a==qIkrJnf2Mnc&){PPljFHqpQy0i`#bHD65iy$2wqFkKHKFf+HqlHiH5!PyGUctw@UkY`>Gr?@*~Ch6C=~ zKV?>kl+h7+ph`(H_pOKW1luK-*}1&jk|L(k>a~0wchhmLh9@GfkJx`6`Pd@N!zqP-+a_P zGPqL;uS9cX84C{c-P(!993I&h$Iam@=c23zO9io~V0RvUrv^6a_M0dR*7{h9JYesoa#;Mk`~3SRkL`PEJ-Q}D|wKIdO*w~EZ>yb0&7 z?w=1z=5f0PK!mJe)NDm&6}EuSu2Mib=mi_pS<0rrpbM746(|97)K8m99?g_gB*g@1 zo1qkGFI{#I#met3Fryw%p1CJwbMJ7ew$Iu4T#Rg~W~ z;sD<9B=paMTJ1jdr6m(S3;EC|{IN(rKWM|8)=$49nb5>?U+IsKYV>F{&6rOBNZL$fQ$KsmRYFhggb%o7k<1HUMS7_%g_PpHmvxkhb%`Ac`p+|M;{KS&T60mhV?c<_JA@ZqE z*>Su_#gt;oFWSw%SOq+6|1}cvp`1Xe#9?E4Fe4N0#-L-kGVy=|5|fC)mKSCh3=DZg zPFS2soMh5jIY$uS2?mCF!^94jb9=zM9Uw(zv#-)e_g$`a7vn^vz0gV`XlU{Hx0UNy zH}SLDDa}s>waRLy@Mim#Qxi(NQQb9bX)@NL`k3h1zl9OQ`6gPn1wpGJwQ50xxy=*j zr`a(xhb^GBwlb&M-%ht4S8S>Zch@pk*tby5b45R<|d^W7AVbF=_Ts$C3i>On{P>P z{mq7mroupKmIQ#_B7rU@0cJ5$=S81hF$pam9tcK7gkw$vj`oEdRt6m#9)=JJoUD|a z_A41Tf;LI;K5`g>{ra`A8pcVC-=ts4k=Df3G)!m(2`r0JMUz;$ul5aoSE9rzeP!cZ zl$hV&5VHM_g{b!ERG&Heh!h^nChfZ8Lg45Lm!CMOGUd|gJ&Lw|5{yZU!xRx)gH~iKl06~(cjggQ$v|U?y63W^IS!(TsYqfeFJ>Da+X7QD z6(ki-M?zq5p=}Y$G~Lc03b$`^`Qb}EXIPZD3UVfD$IC_u?9nJ5DQrb%EnADD zVZjyDEqBOoa)5u5n>gA6!Zw90f97)FFA8??vlalW@0hmFH2~Q5j0=9Y2EbQpr{Y<3 zn{x@1wUc$d!#|w(g<|$}_J6oNmVMQpoi{K1=`?wXdC{-JHwSRPsBs%!^rHv#<_wuP zI=AM0e=9~_^Y6E>iGuocDb!tUPqq4*| zmcfFU-B(r=6;XyAilngtBZ*ScpqCJWxdDPu>I=JoF6obwAl{}YR5~nJ(gKPzX~~bR zvhI%3TD&BQ9sM%~PRL>on5Xup3EQhw+9@0*^-&5=)IYb_D$pg8BaYN?xXG6W5&;Cc)8o z_(h(0hy))TsBnC~^eJCkn~N&FH0{P*x<(gr;^hQ>r^u4v|9W7?@wJ{PWy^?( z3S-urvC^!mbs`M1Eyz+X7@`l;FWnP3(PAIIshpqA{~tlw&G{_ddHLo2?f;(_u8C{6 z#a9LZ6>4UmH(dY?5DFm5F}<|gU0TJL1q&===Vpa~!_!K@(+~{%L7$Nn{Ua}OI3jbB zQBswuRXUX-m@r9+9x66gDse@djQ3E2)n`O!yX!}x@{f;c|F--W47cxHjP)&^ePJ@6 zplTxZSCI3uCYqOQ3J28!9mWlnh=GbIO!O8{>cRjS&Ca=qxwJK-Qk;n@1q@UUQe05T zBqD>)Kgl6TVgn%o*4rRc6M)jN-qj@z0AttEJVsz~;sb%9Hzg7UCz$6JQO$4OhT;3C zgCSC*!Q!3f{d6q5kAF1u8j*?@m7U#W_?1*LiQd}Vcy>p}YaI%g8sl$I{~7a5PHm4B z1LCK)CcK`t({q9>-f6=g`Bi`3N%qLOY`P|7{>`yot07sAwM+r#j>nU3)7ATcE7D1Q z5dhHkp&L1;3yg8fdPEsT5lio;hpS3;CE02A?U*1-H)evm#pv<5m)bW)pJbVm8>TWUVTc{&uuVj9JAvv13}yetWB! z*U&bis_c8-Rr@sq=}_(*oa$TC#WZ;0ppoiZ+Eh#J509nE` z?wIb%z(RqAp-&8Xa|>7?r0 zFG+eVliuV=V(vIf>x+qu1cgQFvvm`s!Y0-n5#-@u)1ln5)Ue3K^b{P1V9`0A4}^y= z`;JIjv5^iq+KlpvFW6Zxzg`tU{IidN@>|G9nA4j| zDFvT_{5LM=*P#xe$g$Y6M_@ltD|yK=jTFN`_0d=OBn9(g&{c+Hl7!?oD8)@WvUtpft{F%2sRmCsIiYhOl!Hq5&y05;>~YAC zV?z0WA`mI3TFB4kwXR=)OIjo>KvM7MaWt97s;fv#+Zih!@;R=t(M@n&Zh{SE>zMP3 za<=c<4)!zCqk&C}(LY!aZydA07~w*0SVAjfFBL0l10HYA30Yns$V*5$1>g1+v8{hz z1PMa(?D7bXWl45zcXg*@s;z+xiSzf?t*m{V>$z6@47)PxahatldTEGSN!a1KwX%l& zRIzx?6ar0wKperMFBMZ7Sx%Eh;H;XMNr>@dzDtG!ycVXqqOLIHS;|keWHxe9zF@L` zvv_;l0c~-5%nl>{bqQ{Iwr#HYmCR4@$p`^nD!q<-=E`m182JL=^)bXN1 zg8Rw=Fc#?xl6Sfn9GWa z2Sd+PrA)O=U!tzH;%?Q)mTT=QZ|~WK6p>1?rOr1f=$YYccgg5lLmG}%J9>pOhbT=< z9#bC=)Y4SW7ZMMs%%fw(V!QT0Ki>eCWmpLOwoQt z#WDqd)6*f5p?s5uG6K?ywK3Z)gS%6fm^P#(yp=H!LQU=nxxc#-raNNQSxSk7)R8~M zsZs$CotCZYABbbCl_VSMd0_7tR@kvaFh(s)^B8|7e;71>`Xy6n3~{30+~s+r;E z$cvSRNp&RNzZ9Y)buha;YGr(WsqM6KPi|$k_R}Wh75Vh0F|AGh>b!>-S&FB@$IbKD z|FS#(&Y#*kWeRHN)X3^CKSJ=N6Rv0u_GHhJjr~l*p#}7)fN%wS9fVL~&~(gQKsMKM zl0XXKARBs z{O-xpqoprprw|12QKP0!UPDCXAUl-MX;OmqA(!6ikJNgb^?9Qb43+(Qh2elypV`P~ zyG192|8(^`ehvU3hV(!GJt&x%UeNWLk~yheIqKH1G7U!k>vzHaX@O(qkdg0Dne#u1 zOq!KjOPBOz0e}J4n=MEQbYL2#ek3ZIG}u}7YKGEiKoji7FG08&q;#nfKWb+&H~(1s zoUSPi5wrPpA(`^Ga@gM;GZps$t)fdirdDg91vo#x9lyW6cv)N8@n+#9y#&FT^738& z_v*}lcl7^X=VYHiJ5;AX1JNeF0$E5E1poknNdcx5m~O!$Oo;ePyx2;v+qSM}(R@i9 zDYiG6A`&w}M$&H3_4(^MT%}%(lsZ}8_4O#j7kM?`qiZ!#bM*6LT}$*G+uzk3N-_5! zu?(9voY0LL_$L@{EOy+|@6CH`dkep`H{UkMbDJGHBG0D(&dU=wH;o)~UG1(W->y0S zIf^1MB`t4}#~$(C;8qjV@TDtaWNVpt`>TN#X&po>lNO1%ni^Wa=apqBB^YU8B?cgY zl=OJFjC0?(FCR^3&kQM#)^4C+w7Y94aio_MmTh-cWdWFvk!I{!(yA#RC7@(O+Tq3- zL&IyoKNNwCv+vqZ^FbgD59t>cb4IK^^NOSdWkp~)q>(VR3_!(#8YVrSvu)5w(?ootp8iBx&R@NcuK_*L@l?(DtUoILCcouMXyF&2 zm8V+CPA%l}S;(Tz$6RygY3jalPgR$ut>BtZ)5g}f`~7_~`@N--e_+$ZP8*`aM}Ug2 zp_WlTdET5g#`gY;a>`v>Kqv@fEp;9XHyM#x_Ldi<1A0syp;1zftd zO>4Bk@s!BUz=z5pMGVMF!jOV8Jkz$(ZKE1dS8(~X$=SuT+|wiaen;J_@>B_Ronc+2 z_W^o-)oHzuFyMPR+;Uc5^@RcKFaNY-koqEo<)7G}k7<^4&X7bjqq5sYYRusay2Pd+(=@L(Q zhBNUbz*jsZs54w83sg7l!EvIq)V?*e??HFgbExz_H@B8T%b1jfM5?owCr~ z7!yH)mB6(jyPQpx<9i2p={AL>u2unI3Bx%8q`JMP>bkdAkiU*H9137e204X7TOQuW zba{u?*b&LUu>6BoC3Cx}RLuT%>BpL-=3Y~48eQeXXO^!K;|+XjI&0K57>4Ca)>8J3 z+K@Ebe9oWSD9bbs%Fll9e+u=0rmes6KV-&2N`jwP!n+KVcPcf(Fz_;0L0R}Lj=^Aw z(6*GzuFA}Zq$Ewqg%0h}W(f}elU&=v-ykSN!)0_TrsqBw*jEn?2lDl=)K44?$ne+?0ZaTX$+dR`Ko`CtEv)1`OGH3W>ym%K zh*%0A(5;;gR8=AVFSgz?D3T`H0&H|}cXxN!!QI{6eQ<}y-CYMC+}+(7+--1&0S1>| zzPE2B{L+Ho1y)F8a}5e8kL4O^0UoN0q<)7c}Q6VV}uL{fB{4Mj2uR2H&Fdoj0ZIk*`I=J#Ava_ zpt8hF+j1%~@P`WJ4JMvzDIhYeF~kOQ8^noYvoLt_0Jf-rXWW*2qtMA0__4FQ{33V@ z^+BAc_S*5_S|hsNMcOYnPDVE*2ZIAp`v*fIJgxlqR0A5G0!9rA#~Kk4P%^fph_*)^ zD~%x^N2Pa|Sud;j!VWm36a-n2dGyfv2gDTPwiKh|tsVZ5(T0HEw^gU)ip1N0|rITZnDOws>?T&&xBFx0xivK_M}&>a4YYy%ab zZR7c6R~9pnz)1JiyVQY>esgZx0ZsyBXMI7Qm@eGrKyCw$f65A~E^oOdcH#{kw~iME0vJi=J8TWv1txIv+wE*&zJ3R1{?$N2*4!1We`9uBN2VsVY$xF146A5 z8y}FYElt5wxR34MbV+z2P*4NsE*YSNFn%ut^$!UbIjnF+Iwk)yg)3>YVK2c#)d*#- zuf+J4*=SlQ5(n>QrVa}moY6AkuQ+?dmgN(a_HXHjv6(|eE|2bPMehg$xk8p1V9@h2C2gLPLjfEzpdhOx z3?8%hDuN1|2P?8PI$ViEV>R24Gt`Ao-TQWDgw+v41Gl9~T4+(+Kjpj!`n#>K<>c;E zQR6~nu<@?b+r?%jmW9>>9@*_}Xeb+&nXpJ}nJ^C&JPYR!tU_2|?H0TC)7>*t0|h1~i?{}CYbJYYC}_$nnJEw? zuy?1(utRjNB*Nm3q7T=QrP1G8>&B_*gb_cYA|2YCNqC$+$aPPokF{?WnYR8!bBE7R zTlh{jJXcqBkAd!M;`uwmHe_MD{6~*F55_G@9-31ZA)Aes<*duHF;$ zd0(X2&!`%;{rtRM&rZ{PHQc={7%~O`=ss3U`R6UZ^s*Z5yH-KL(42aUi%OOS23369 z0wZO(BhKQSJwV*wOmw#OK(I1D6Ef04Ga>x+$v^ZgBnyzv(?pp}B5BT+H|krQ&j!IuI@S`kOT27=F479nv(( zC)sMJ_>3fDq3`LW1mPbYVZHJh%OT4r%z(}n*s%F|$zmYr|2ghIPMkn5ppXB3_7ahI z=6BKgNZi_H+nlZ+MwyC&)emMS;`I)5;3NlEgDSk*&ILI`85y}h2qD*>u8(b=#z?vl$H59 z6NxuiU9GFkTp#Ltb_$fce|T|f(s^nR;D7n#uiNg~e8$%}F1NYg9SwY#76Pg3>#J`K zJ-z;hDvnY*q8hDp1?~LzDlh*7InMNZ0Nl68Wk)*_K)0Q3^zQ0-wly9R7kxoT2H8V{6JRsvqqU1KMgalJcZIkXl5wNFX`RN1! zrJ`fVJ2;Cl0wbrV`n`7|YQDcbrJ?o|O9#J8Pl=P=>V%T7`%y2IhN$xOaAQW%j<3u) zOvg0kB$VoEA-y@E?J4`^;@n}Z>n^||v#Be9_>^vnH(-n|`uDOOZ_D!o7k~YbW{0c5 zb#+fbhTw^Bu0lD%l8mv%w$p)jTN&+_vBEuGpCxBOBra{ynRY!+R+k6>GST@d8sd

    uV{rUWaVp5;gq!unbF6D9AhRBf_>1JX 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%0DvBp;BZN?TtSjz&+#{FO%YZOpd7^G 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%0A6oUfz8G~kHttDN_%(TLbh~bDm*_8P_sT8V3_>m_ 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 op<0!}>dQz9OLOx($xD7U`H5#EhbI(6;S4xT$F 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ᇂHx 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⪚#){x@}ECN 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
    17DD!t@<(s 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 ?jR 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

    TVLmo?&tSK|lSory)ICkp%YClN#-W53o(=`1AE z$_~#Dv91qge4}~)9s3W6tgC3Rs+;R-Aw2I;5+OcWT(6ODT1xnt-*Zt;mehMKrA5Hf z{LmI9o@A$3TB>nK&lQTFFhj*K)OI^UbwAw@hg;bags|f3w-oE4bcGo?i1lc3yiO6< zC`{8Lly=#@vN>L_AxabXDhv$^Fh|2!F}m){j*R@@tjLz62Pyt*d9KBu%LNxzr|g=F7+uNA=$$g< zxubvnMc+Nfm6o7fSf0;jfj^9)G0l#9@ysCtQ*3;~SrZdTQed?4b)c0=oF8bsIN2b> zFa!n3r>JO(QSfFX$>!nZCDTPiChj}1;M-+%xEjoVj6k>Zvz1Yz)y7FT#`18x08^2J zB_@BPkOwn;gWJE8P1=h^6T^WlpDGIVop7nu_T9ml*>wQfS^%ANdQP%qHNK}> zI%R?mOze{k);65!Poe4QeL~@aRFs(;c6L;lj+T%EsZE&~sfQ$i1^xtGugUkwA4u>VtYb%=ipcv55ixQc{nq{|9WTD3 z9XI%^C-@e8Nj!OlfJ96@usgH{B$>Uhna+fO#RX6d)yTAkly4vaS&YhoeMp~V)z+^(OGh9r zY+{inNx!i6gnDgXt|*VndZ8!UP%8uk^rRq6^+3(Ka8BNJP8 z6W0j;23Py^08dQ@%JOiFpis~#y2o`=1-sUFGmR}j>0eBF8zH8Dpn*3mu!m{Uqd*rIdlu2UhgmwUF9LQ@v+tzycm9Js~6e$W5LS%^NCj9Ze-u9$b7W%D8%(x&*&(AjU4+cgbPNV4BDY*wgrR%P}B8&ZXkoB21F^$7+PF1MhV;;X_t#nUKJIuCgmRs?eXr^W;yVz&( zEaN6{6!78Inb@`kF9y+8$yO?`#YllWPr_4v6MmnR!76;^lkD{mW5bBtAWz4d>MT%py9)X6B#Rk!+3RGJ`!X#hS|M8=>c4s_`l z=#ZKwzHzlX!&_E?12-l^7U)uw!8C(l+Dj96?dL=GFH;m{4$=d&Bx{>crZm}Mq2^<+ zEP0g-p*ESj0?y0hrFwL2ubJ1jjSY!C}p|3GtjdE$sAo7LcyYEnGdn!dy% zP)<*Wb)E*XzM7X)`?JBXAZWAd^la;o@3JoAi?~9~n87+>D{>sq8Ubj5LCH1a24xA@ zS}sP`v4maWb;_9tc$TD6aRm=THLYkKFFasyz(432C2u;Pk9 zAnu~gi#Vb?r}q?S7Y@rM?nS+N^1H+87iA>n&OOg#jtg#>;5CJi^;WZe7Qhr3$Ls~MY!&H>XtH3^W`jtCkrJ>uvWQGVpp zw>pLm3Ugap@|O`)Wy29G+$M6$u>T;pTKOp{Bs0_Tm6up|osuIqv53d0kJYJW_2>^~ zWOxiu0P+L@VDNQ=7&yESN1Yf2?X zoRuIhumIo;3$RbievAO>(qI{=K>(?sM8hPp{B1FYwMAGpnPqMDe|)hZYLp1fMn!De}44 z;zy;@1IA^-&axtgWcXI3xM|o8+1v?9dQ~Jv<{ovNSDoGf+3BbU~o%# zT{gFVYoWp@H(bWeAL+_MK{f6VBZ2mEIUS_0N-&Lywy*IXw7sm&M_Kuo z100FAc3A)zd%blPO9F@+%6{AdkC?I9wF2h6UuaQeklp-$Rpq{Z{>EeDko5Ij6Ycyv zaRPy}&vG&ug$k#oGN_<++Wgth~bK`cq!{f{$_>O)Pydpy-uIHOMBmOk}-k6@9x&M?9O zZexKa`{-qoZWva74HVSy)1}KjURUtiO{{#XZglmuY6pArOF{e2GmzOqWt!_4Vo&PE_J85S;b zxSmyxlN;tC1lGMBEB@IuK#=UITMv*n7PI;56 zOShw$z+sJNU_VHQ?l$db)T{FDw$}!+gu0sO&t4|^25Ged^g=HDalQm%Tb_6_M$Xrt z1l=c?6guzml;tWy=?%x9`MTZ)if;mh%@kLTgu8et)RcejfI!L5UEuFW5CPGKtl}N7elzJSL-|X*4zJfhs;^E(WvU>Cyi%xWaC&nU( zyQT_1TQ$FBUFk+=ieBgnz*IE*CtF7i&i{j)D^Fnn1ed9fqp=aFG}(pYX*U23<){50 z=Gg)HM7o|Zery=@px&mVTOTS}6}E`GpZx3@oi#wiV_VcqcXjjU@4k*uxH6#4gpr<;b z{^0IQ_g8Y!1<5q-?oSDP)(Icvd@z`)!`lbPxLt2;nEwD104bUCxxo7 zLKD#N;{WK({(ltJ|Bpvl-xQDLSF1F@_mJ{rMm`grSaEaOAW3uS_uXw-t?nK`)qQH& z&X8*Z3dAC^Kx3yl?32dw^2g%?3E4%zvSzo7-lkS_2*~nF_5)Oez zFxi?}QWx>{A=a&Afpd$*i0(5G1g4-o>Yl>45K(`vP$`kp>VzKG61n8y_;uJ({|7Y1?% zOh`cy)ML<~2?_Ar#Lzl*6sn0o*iu^PxsL`JQp-J8G4lo!l1&7?OBNTDEMBjtzUQkR zAa1G@Z6|S^)4JB)NA5?9Z0u(HW>OaBFtIC{P|7$GZS{rrQ5t~;xOzE8C$QT&I&&Mv zS-vlh8LHQ_vNa}b;rW|&o_y;+N ztWa~@j`2xxGOFn#ha*0GQR1LSAx%&w*n_N2iOs7Kl z@2-`eRzTv2A476XpzOt9jZ4?-!qgPIa7TLc23m$b6zZzBG{m0<7LucQM zBJjQ!VW{PQBL#%y%TyOzfy-PwnUBSJI)8vt8q*TM&joI#F0vO!V{>~Hq+M5(^dYKP zD1e6}mSxRzl*x6azS~9i3@P2Z&6gmdCrE2mHw-1CH{YU*qLBV$tuVgNXZ^#dwVs0Q zF+wxwob%E51+J59ui5NlIcse=^QU6_=$us5L5tK|5fiC1cJvN|7<(qWd4(hy?JQjT z%f*#E?25fQ1*awtE0QZE>5%lMQtGL6#h{&!BF}Dz25;9IU};Wf)Pra1*_XfE9yt}8 zCTZ|iLpHmG*TYX$nkb#~ZpUVL>nIq$i}AH8&96O3WPUg&g&b~WkHd$%*I}&i*BkTg zFOJ1nWXA`PnCfl(s#>5oSk#=|9X$I`h))XC7sX0WKdEKOxM6VmJpyjA5)Y5-;Jcm- zUS3{)u_%ia7;STcCUGLpf+|47Xv@hkE$c%m(fTvYDWI%0WUYUH({cz6wRlqLbpy{> z>YA0csKk=(%&3OCC=Y+z7hAcNV_0_|#HuQ;whvqBJ9lo(*^fkcp{PR3Xsd`3J7eL^ zOb6F}Vwp$AjMg5No1cm!lVhUo)I89mBO|C*MzGBF7YH-_zf`-qrKnEgaNmt?1Mdvd+pk(M7WV5j0#)dILbz zSuWWs$~oCj=`tBZw4lX)H~rItWP?canN<5!rVk}`z65n1A)tZ($gWjMNpTlx7*(kfA;g#Kf)bwHq{27QfD zw(tm4gr|o(x10h^j5)ypwS<9iU_B*^@snk2s5 z@z+YpWONC*xdl5Eh6R+(u8_C9C z5)%b)UY|WbTX{d4%RXnSfWYILx6>9}VPeTINk&RHdu9d!B^_(2wZcU?D>^>$Dbn$S zyl-9LGa^&H$sp5xkO&C{CQH`p>j7ueW^ikUboYMZTZ|SHd+?IqZka@7*FQZm&H^1_^Ek9R{YbU7DzdXsl2sBFt08Rf7oE>w zcEjm@NtOG%ci3l0?`fCmJ8HC~q8_?m+dSLcMaL$NYJ4a$pHeZ9T3^r$*QiYq=ln+xUHcLk z03NHay4kHFI;uDBb1)4tn-zv*`D( z8*R_GO?Co9;P$Rzn@`_vE8Ej`2|Y3aWt4+MXoNe=f;`8~9PU&PTd~@q%G6)kOp#!w zqXgHO9LtNuB^apDX(&>u1xe%+^N~^G-&T3jv~+fOh2z)Tyu2f%*9uXrb{cy-Cz1{! zpopgk;^o&s=#-0;rquKg4+(R7lTpWv6d>@y$-@1{fmMPf79!8tECPo2J9s~-N@q~8 zoKb>{(c#SRP>DALbdq?n<(5n=4?xyADh$WmkAK@IP|#w}}z>|7m- zmKj10UuW0P6N^{zE96g#CD(L}{LxG1*Oi?H{4R-rZ+_^3i}s}IXB|bVu`6F6H2b0A zqm;eEt?j?nt0$8DqtMw6k~VSqwSZ+3LQ6jGx$sH3HS+9 zYhXf4z460p;c1-@*ENvp-^L1Munhoj(bM*UXZN;>{)%!zhN>@Kx;6YX(#7=EzM*L} zDLhryR{>P`F-3&|;A-ovrkdjl-q)X7!U73A5-w$b+mG^d-5j6MJ5wu#v4~`Ie#0R} zeO9Nb+qS))d@Ib@jkN?m1BG317Mr+Q%7SuOUM97>Ii_NZ=CG+NlRON&9 zB-P#-%GuAWz}?knB}S;IuryM7sj-kCmO?-bR<$!`$kAvpX(oF=Mvwn?n!q7WSWN{4 zwV2dlVMs!Quxv%-6ywU3ksJW~bK?hZZ(M45c|pN-KTKR0V)bUi9&R2u-`n37mKb6w zyDh0G;7Xp<%C4W}AjA0W{fGZ0-xzR`4mi#H=^y{M{G!$Yn-mpJx5U$UxS9Evm~`Ud z_10a9%Xk1qMc*DJ2{dfs3Sq`eOu39Q_WoQukvStX46X5SwURqj`?z6az?~i!C*v~0 zUpUL*;J2i5-AKMd|B%Nxx9GevJjpj(&b2~h@h-RtY4?=H`3hpxu-oRA`*3P9n4yF% zszj|R8d4G$)w=pW#XT-8I(h^EzctYOvQtv>v8~)Tj?hBech#?EVFB@= zW#|b{>Bi=-1mUa3I!S(}VUlW}?c32DF~QHP$}*cIR&Ba1+s75dvC|a#>&fGnj))N? zj#1T^{VqaRrd#^fcK4vRNb_@N7x;M=JW7#ZlnDy+|AZVE8G{fgYPubbupHXb2smk& zsahh+R}n=|nA-(it}W2$c+X2s$&f~hZA2yUHsH@oDizN8W+0VOCa(s1u@3dU>r(c} zRs&6jWBxUBX!nIIFP`ZuaecFnudL6mcc(TV}l91lcs%F14kG zm8q>Vx_)0b3c@LnhCal<4!H4>{rS-jCVUV$d%V*fJ{YocJ3vpn*oWWmh%tu^!F1V1 z-v~aT0iq#7q~+0h<@cN3(04m>%tR0l4%4K7{RyM|0wQ1|I;{Azs35j)=?|B@yH^Eu zG)qOnqC31%Moe&+jdwCDUtmRG;tG#@i_dSSb%`j^`zavsRboK7gLobEOtXRtW4#d7 zT-tiY6NVYH{{-WAMhCjJ4I;w=BC2(c7gnYlESVDvrE!oPptCj-aaWk4EEm-m^~?p{nx zV1dXMcN9j(NMcqd>r$V8mU_i;c=S`MUc$}VqMyZ?`E=BB*7T|1%apr+=?yowhcuB^ z_az-E2uv;0c~@wLF-|`;*CYTkwygy(OeDuY>Tml9-#Q|c^9Pfd3j=TQY`Xd?FK;KV zIsJ$i%s&`r=Lt?&`|58Ngd0PQI-}Mq&jD4!M z!9$sdf>#;{k?1^4)y4b=xk`|H696bQqmDNgkt-#FFe+DMSB@GsCb$)NVH77dj!C`} zppbsx0uF)M95#1D!ji%SJ~XI!GMhG6gL8ycn#;x|txnZBy~C03cqJmFD(!@@H5fS( zN`aA=+aRKx&)`I9AXhCkL~0=o%+v9xf$O!2V`TGC8sBXb&+MqnYF>GGJeNcg(cK*n z<4{kJ!jCeQmqUwEaNsd^kL!f*xH2BnTsLIeLhTC{EG9 zu3rc`F4_*ZU`EQ!lNLc)aqHg}WjB$r`wBwg3_LB0yC(2EE;>c$um%% zh_F}lMM;P>OA85=Sq`;`2{Yx4@XwYyXpuo_aQ^&B6LTqY{Y*-3_G$Z?rF{RP>cBEd zor{llU=c`OU!1X9Xj^E7U?K+Tgq;AXgn<;%|0NLNcT3wuqwB%X24tz{;WCC5aRA-G&OOC%zO>U=}_N4_8Os&dBYJ3W|(Dn<(?10 z`dnVJYk0P9C>oq_a;f~6qhsAq>%J~{9QU6HVpSUc?*y}Oz{lH9=Xl*ipuM23DyglE z=1AhEh(5Hfk#dItBC%L1BIP`_yQK=)^txRi&lMXiDzsK~O?X-I!>JH!q*`Ig1*PL8 z8q2vC-ap9M5q@ z1EQVzMxFOpSkjD>f7~mOkfTQ9@S`gdkA!!ip@XR>w9lsei#CQ zhm|7F+Qnj_)1oQ$+Idk%ph*E=0vY5{;+tlTqGx2RM~i8?fcV^w^sY8re3G>hh^P@bW>_@lMdqm>a1d{vHUM=Hmpo;;5sTFd_)Zx45K4_F%cub*`lP7K zRx~$HhN+DFW3b7}NvJm>jyLK7Hmj7DaHJ*se3pka^CEV&A41INu6zBK$tr!*={($u zT5In@lEm`ig1vDX5<6u{hv_EhI3@X&oGq_g>rcvK4SB$VR{ev7@maKqbCnGFjfBg} z%CxnF`lHLQs)kP4y42jKR?ktb;%y50PYqhbzmtX&clo+;TkprSW8M?LQwOX1uS_M1 zPafs#w%ng>9FtjIFf+h(lF zE{Ch)1@?j;QGOO#GkD*BTR%=~=f*GGCr!3^h2Ig)=)x=eF`gW;{QlTp#(brzElUm+F@6IV@m*p%Fj7T1P=!|A>f&c!)BEa3BaTHGHU!pH|6YZ1M(f z{SK>bBz$r?QXRO({LI|QND)eGc8bz!W5ISxryVg!p5xsHSJZE!*kzQkx*EFecoA!o zQy^;7!1JRvJVWWK24AMH>FR$_Ie#quZAIZ+rL8zhhP7_SEsfCOxb5k{c*Gl@%~tHL zJH^5s{@9m3D}?Tx5z?Ed%up6wr18xmFPrfmo_WXriwgd=lK-yP_sQy=mM=a#(SKfn zz&DTD^H1Ea5G`_K7*7z>TZujJFOg~hwUlh!eqJR~Ooj>ZXCNZHTnm`G*a7VDCe|<< zU6~FOnQ>BqQF1JQ!pN~!B-cO|7wsN3m399g)j%9=M7YSke6Mj*i;K|tV67fBn+r|d z#?ywK5{t$TGle^y<-T9mM?I4}C5h{t=!O+l*o*r$r+p`$mM8-EZtVsdUdLJvc^n2O z&b&fM7cvT-Evde5-Hw~K^g;DwUw*`u;-xB~+<-_@Ts&@FTQ6MAsoE0xTVLhgV++oXjRxS`f+X*< z0wX;Dg-(dr0sWBk1Fe+Gu(KECI6S@H{sU)9(c}gr9a9mEgv114iylz9!Z}97>j}XFi>ITiH^W?ivMb5WkEQ;npA=dJ( zj0hhU(VpjacJm(9k@(piw9_=XTHX~y7};-rR@{e)<7?5?qLp!M=YFpsNLcVVtnodb zoT4HQK``Gv3iE2Z;38VFDNFAAy)4$w1o<>a!pb7Y4>p+{^>>cPm5t&&nM=w^3}(u` zxlCh;soKtTn(LmQPiwS5SZyk)8hHuK8ZMXCgrV+QA?k>^r!L&6v8@5He6ysONr?gC zhyZWZ0Fm~Ss0yhaBSepJKFJLxh749I`m%}lqHr-Ezx9oJ+`eVvKbpXjZCf2gNgU_m z3;VB1LZxK>OgO52eyY+DF?NKkTN_kAd2MPZ zQ#M*JT$OEJ>MmbHXMKW@GxX}G)d0Uzxg75p5^~L046=nr7-%4lGeix^v8{6g)5%Ij z?DW&g`m1pIc!iXn9wkqs)nw}GTQzs(vxF5MHSJmTjaH#K*4-Id*8QWuKM>R+Ygs;R zB*UsMUzB+wb{B-6QfH1?A++kO@j#J1@ls$X4Q%f|C3<4*;MZ8)FjZQt99`lKOXjjL zEc_KsXNNqvB+$Nr_TU281^fUpNHCKtA2%)|4a9|YqXexIs0i&9DJ3!CrE6ZWwVAvo zr&IX1ubx$XnZ0l5t=S@p+$oA(D4LV%qs1ocRRY5oG1ZQO}EO`mi&vCzaXj&qQ4tf6$@EpMZ)M1CdDtT>i_J%t5uxf9kQz@YVV=Np!Kud00d%)F6DuSVq`kQVtSJ zCG9Ki&iJkiNM3T$c$brisWkD!1wS}&elxCiD0cwwntU%b-!$KBTmDJ|U!(eHY4nNn z3!O$32`t$1k^_>>t-aN&1Cktvsk@4Mv7k}SCI{+idJ7bO*GmVUJvDyDH7XqABj0scs0f|yeGw4b(Xzx@_aTC->}K&mR)5D z#Qd(ZBu-5X0No73MfHv+XOdR4(yI><)nOL}>HlvJ>4pe9NE7bWM84O@O!c*%5&_gTo8fRK1Zy-f%#{Mic7YZdo2)WKAsREiuUTUjw-6(fVrIKy%Rq#35_FfH zTT;fCYa;tuBcKt2Bn(_VfE7;2=vO-VZwk`(38yt#0y1Z5;{y9s0KXRr&vRp3YLBNpvF>ISpEH6+IcgVVMIl$ROt=coaIhy?m#A$q9m5+sv zH|>rle4Cqzu-H4hM;61d&*7&opFc`5aZD_Mp6ui>hHwFY_>dbx{UB(@k#phno6%#1 zsfTdjM}@YVR#3PER@LN3$Db&}=0`JzkeVY4Ob>CDAq!_%`~!@G-LG-Q*Eh(#UXDIopZdOIzLB5Bzo+qVo!Vk5Q4)Mwj<1x&C zl4^cDU0!f|aM~vQSgxg9=*A6(4KHy>aE+=DB|irUJO#e(`?w+hXhZt&_ajOkYI_D( zlqmL;q11oQOa97AKdnw(0JL;$ti_!;S<(}XpTOQzYnE0%L@Nl^+6Wk0Ra|Cxy*9|D zGcM^=a6@9`pmkU+`mMs~ zZn?{DC+f;vQCo4F_J$>!rd)o%qQcN;2sWh6BXU%lju|}h)?A?Cgm--lhi=;m@>L}g zP*D9dXn(sLn!`q3;8aX5<#ykUpP0F<=6R=WEg>bBe=4rE<$B3Uzm&y`w%;2%CXgAV zOOmBOTk_tg8m1@3-bE=*9Y1ue%4z$P>Gj2kcCLF#rA6ft<`-WcU?aSArwrPBWALrM44;Rq!_p^qLA%03Hj96vOdnG?^ z>`J6dGtcjq%=PsZVgqsSI0o*eJa6r8HgED58*kBR{jCv5OmmfUC<7(nphoa`)*TFi zr9v7-EC<=Yja78d3;;6}q4jAi1V}3Byq^98z!>ni{0I*KVMV*_t4{#Gkfo}^FH3n! zQ-)vEYd=;TQl?~|(CCH%7j?7+gou>XgXsj?iS4JC(jkXaB+}h7NM6X~W-w+E^rTEn z6IQC{_ULw1#NB)>KC5N_SN8p?{h<@Hv($PS)AZGi{?B!_y`g7))8Th~F&C}0Otbb{ zL#@3404WtBhHv-@Hvl5t1dF*hEF@1)K7ask#cc-)j>b0_79;gnDq>iSm};xvRFo=K zObY!=WbtA0xIYFGntDJd8A|w=F+T2*K!S3^w|eKed-BTbdrOJ4VAcT|PdSCJmOu z?6v2wd|C-QMgu0J{ySs`@`F#0-SWasc9S)Z&)K_n!I%wf`T|K*Gv8ycGP1o}KkGjH zOl`4;v58bqae#+BfsVdHK;2f$6$TrdwHk`0=aSxU)`GR_8$(1wC3R3D88dEqpjC*WS-ZO0g(9~O zD#_AhOewweZA`gna>CN_)KCzuRn8F)OY*p?$wr~Hd6@~h(wtSC2_65H`txFEC;0mF z+JDsLoCK)?AfSxbY~k6JW{u$V$nHL7niZX1@i27T3b@U@39W}J}Y0r@SFZ7(1bcf22=^D zBmfTGjpBuvtuvzO7omH=vPO3mjZnRnCFn>(ZYm|BVS;mSTX?HuVbR3YzL7CpJ_4F~ z%R?UTpMqmYA~`Q+MeF5*_dfrjWgEe~VW1(F1bjFIGnIL~lsRv0pZNq6a(6JEn#uhN zLzs<$_*Rk{s*X&;0ePOI{)0^2&Kt!vl?&FKZ(UVqXWr~9_sw%R8ADsyckHASUJn$~u+7g$cNp%YJD^>cZQ zu;U1Y_Oc``nz4?}X|wq}y7V(Kvn(a$e8sW7 z*a)NA6p+F3Y(Yqmbrt2agvp94#Z&9>`Aw8YDn9#?^(z>pQW^r`reW!z!7&AOlASg) z(ufxL{;kN8Y$7cq7AbeVvcoIz!cs-x$OXH#xvOG4A}CBP#pIaGokP_^^+O$fnh*j^ zXVhh2|HJ|Djg3=fMPva@L*@G4$^e|S%AEemo%u`CwaE`f4?15iQige72C{XF)tBs)$t`v-)O!8$Y zA9kQ1I|v7B%vJf`3Qla3M#_*X_ku!*Cl_~MH%ny5tyn@_J~-5EE;N`w?4KEeC?6=E zC4({ooK!>w-`B|O6DOX`DBv&zPL6Crv#x~h_xll)JlzFTb;d{QhpW6X;1@Cz)04*0 z7Vh`wk7t65&R7r(sd4WQBYH`}k&>4dGy=iwN{(|)Tq_ae)(ckWQIab*lMB0}xD%Iy zv17xMS|`TH?^g!Z@}m*IWKF$C485w43bo#RbxtoFGYixYy%XV}TkAQ1;IrACMLp=k zlbz{P9{%^I?u;Q3*j^iR@EsJ8j~XOS#MHRa$Im|^0ug&;GVQ501l2uP-*G#$>`bwl zBDa1r|AU-yTxtOLl)mN#k~p>5=&ZF2W;P5cd#pQnUv*U zf279s?FELfUMOmQB_)bL4$^%NHg)v`{75S~Bd-0u42R1ATzK^Wz($tKt4JhnBwM6S z*i>$M!G;NyfyxV%u{4esQRFbrhLz|J=ieR)Gz)HMydVQw4%x%@)m<^Eih{q${ae$ZZ$548&E6vQ1?1 zKm9+sfUj~(K2kGHNk`D6qT`|_(7$_AHyV@brP#xyxl7VJBAxGX+UF1%<~1SEyNxaw z4;Bewuejq1zgL(*cMHD?xKYpX&T;t?=@=T850hXgshRP$D4ph;kT-z6X|kR$0UIr| zx%Io3G=RXzl(reuC~ifmfK0RM0BQTVc9GDZjiAbyJX!`(Zm9DRfOL2g$U?ZBLG4kd zDyvupxx{tJ6+t#AF+9&<58XMxX=Zkssxy-r0t1u>giaN@aEh|rkgv@Q(`50xtaSu= zZ1GVj3QKjTTWx)N#KEn7i;fz9#|WhYf3h=YHnPO;;Ulkeiz_@!b3F~TgtY-)NLeaD90o`I zcN6yiW{~{Pe*mCj)TGE@3btbsY7us%U%`G)`FLNAO^j0pwVVVQ*El_dGmT+aRo6*> z#LTC{3}fdU&9)HK9Y+kgIq*(7kZznFRKFR=_Lxj$A92BStE6{_Im(2HKK?b3Ss$1U)VJz;>{^LO%qr&ExN zQ2kR+9-QH`T|__ucmXD8hsRr3!O8_rm#8^z#c>+-(_lLE~R(X7U)e&EgMZ_S4H8BCoy+iGL`!jF%c(c zyC}DHUP>395z}sYpba_jSY3&-srVTGNOCQyH)pKej&5$t69^~^PN-RE*D z1w9o_;}p+B3o^AB=MuG>N2`??x$Fybm! zbTUBW@E>Zo?%LH2Jb`YEbj^2Bdtk>f)4Iy{luWOU`cSeR>e~d# zur1<}m&*!fvY*lF3r076*ThyHI}1C9tbK}auNPnS`%i?R0?l<$Ktmio0ineI6How2 zeR_cMcfYV9YA9V=!VlwNmo9VD#yz9+juI5)!4(@1OoOf3LmDLtOa*EeE%VVBr_6p6 zy>i;=@-Q7K@~jprAT6RjP)wzBigbH-Jj?45TTkp)n{s*UFI^kS&y2lO^4`C?Dke*+ zbR-18D?JsxPKNFji+r@k0S>() zQQ`hTU--#Zj>z~cOM_#H(~RuavEcZB_vqNxe7>seBmLGo4Fsyix?>S7X;JSD_7{#I zL9RFC~E_`Ty1Ki2mUu6{?ys3T*-r(Jz;bev2;kmf=BCpvO`elrK7^z16}{ zo{eawm}S94E*>Y7ihr+L+jKXprqt0I{CprnI(r(^ax_?Fo2?#qbm3a!x13pD( z%x9buSj-BIkjuqG$Bzt>8c}Kb{|xIRPCf#_FZEU~=;fRo=qhWBDSqG-c&XPIUrT$_ zf5}6@?#Eps`Bm}nvsB`rwOmBirZSP~j#(cyX*~5x-m&^2^$Omha^>~1H-F_dJfaPU zg3&fpU{J@wzVuydb(KH;@|ck%-@~wmXj6omCs`1#zftoQcDI~O!C4_lQM#&v#@(WH)<9{!jTpe ztz4#>{XMi^_dRn2MPsIf+w1TB?$NAz`7McbfH)&o=fD?)w0D#(a_9bt(n?-6*pADC4(jYC*A?xeKFlKQs=0V5FjU?>n(42;w zTr+XSRr6>sf3NwHJoZz#VkG+-HUI^kz}M;|FG4z=`wUo+wrWQ5_5sYQDJ)i`CeJ#* z8uV;uWyC^6ERPa4#~3AC&!ixu)p_;5DOEhV86%A6eboy`I`V9(%T?ROllN; z1`z0lg4xS4z~XgxU%rnxhO9 ze?_?`jI%xOm?N(uwL;j28(${$iecxJZ&SrsKN#L08rH)x7@v3gLR5AgLa7FJIE<8 zlU%kk$!b_>Fyx8DLG=9w22?}LEzQC$UhQT;r}abjF!V&_gwepxRw`hfLQS%mV^rG2X8l&5Ru(6je8-Fpt>0d;nZ*l2n6}_h@y^Mm(ZTgU z-P*h>G@W;p;~+x$@k~?b_X@lSfA^K^m<2CPtT|mrR=XQGiAOPe6H0vu5N;twhFh#+ z*gPer{>)75Dp2Jg4=Lpyskqh%Tw8=chFSadW3H$%G~XJTDlv->bGQNVelYTgJSd$n z!&`_IIgV7nxnMXvzg9Yhf>!)Ig_<8ivP!V#IB~u2-pby~g~W1R+aLH@92O6^JL?j* zAt(g+H4ZN&HzUuNn5_}rRKffpo|92L1`Z7}-wJLq11*i$+;4s&mY4`HMXMD_TZ-%} zi_I-^{K(udijhw$kU0X`BUDp}x$=k0q%jbTk#w(K@)pKH=D=7wU{YRYU^NTSi4dVe zPNgFH2$;nh`N1Ck$wFuSNU3Jy;;LTA=oVRA+jg5lFTsSsol-~Z(>$i5vNOC(wZgc= z53O`uxZzop^L{jSfxDyjki1MgUcpkOLcG0L4qim1^9Kdt7!FC0$+cvD!={C0cWoK- zT%3I6kBa-Po!opm>tndeYLrYDE@aj8Kgboz{{?^#=&sot8$r9!@iJ9YgII=u_Xp7rWZ>Uzgp$*CLI|x})+D%*eG{r~$B=q$BW$ocWnVe#GkAv9!I3Q(|Pb&eM)H`1?;$|}q+WP;YP4;gPH z20f9&g1)A-06?-e3hBEcpzpOX!L!sjFYom1Z;as4vB0ic#3;t82xVl2CuAYSO3m7$B9~;9K}M>T&72t@Q;nCLBL_Xxg9<^$ z8#&9yi_y7V!4N9*625ciQ1BK}bgJ|AGpx%sX&c@E-^eC7EcIG>Z0!iwZTWpGl@qHf z&bpefrfVU3mM5(aa8oS|?#hjUmg1-|zlY6fQCB9D5OWay%0)1P7hT4sTHHM#2masqw#6ArUWiFKhtmiXaZ zes-KQY{7&B1t-ObdZrQZdBz3jm22#y@d-bWy(iESirJ)nzv4Od|5fY z8@L6`gZ1yB;F|Rzidq>SU71A4( zQP1FwtOuh0pLi^X5N-;0K`+3X2QSJ3YRjT;ZABFmqtDF%W%CqU&OTjUjq5($PXpf< z^(hD&n~9uV`#u-bDck+Ct0&XZi*rh4vo^QC3)O3*>tn9rd9G1w`|5HUpoTTooXEmk z>LjFp$ye0(jJUM3*PIz09Z_%0clvOmkh{U~@>s&7aF|B2yD%){pn+#%$v<4O z1peTAC{!bwY?he5k3~+%u%s0w?-;JQ)OBo?i$h(tuB4exJA2}J<&RkDD>7+aV2I_l zkj7(a@Qt&75V}W{&R>(Gu20e93Mv+Q&II?wqG zza>yhgjz|Dok`~`uXsgtz7Pmt*S#rBGM{PSY#Y$v8EC8jQV-st+$b5vRMXIb$vQM;;?!E3LU zSWR`WefhiFU-dYNfyr16!)`pj!mQ2QdqFh--BB+9#yIw114I948V*Y z+a${K>2T}5?G~ICAwAhv8(a_Er(C0t7Vkyhnd@l-pVK2jwz^$+g}>Kbr&k@}G%3+A zr87M>fk$q!SDe%gHiUejtsQh1cIK_y`3XLk3qojiD1&CKs3OfS8zbiMB!d=FP}J(6 z(}TH3w`Ryb?BRv9C(D#-(gM-gH?JMP+FCel?Rvpyy3X?P;Wml1ok%f}4W+EOx7L|?@pP(63qE@~N#Qi_KG!uyp{fsB5xGIj% zE5L*%xqUHszC>_hzvjEnbXR>~^veU`Y8iBGb`zz>Ye7!;YEEk8b5{BIXjKijxj{i#P-gj$z1p0uA`)roh(43^qU*nkh(8MOp$lzcFnGNvJ zl$hvFGsUFbB;?4%V)Wg!DBjA#?R3!4E*kX4Bz1vGP+mE*2MESs*j^JSS8=SM(Fz^* z%hDzHdQ6+2>3_PUF4nJ}tte zxu2nt8c`xaR%{Wtrdf;|UR3eDv!-wOU+w1qT9vi79krpy@cr=rwMspG0r{S~*};(@ zBeas1LePj|#>7%zJWy%7IO(MGxYfXVC$@+;)u4b-9STd zhoHgT2@VOajk~+MYY2_IySux)OK^7$9wd<9-ak3_j{m-#s)rt<-m3enRlDb&Yp$k} zmE(KZOyUZ7`(vu&77mcq5fy8?qsXf{P`H8Tc?!UbuClzW?}4#rshqXUsAe@rkVXFM z7lWS2!M$FsPBV5dum0U*cEt+S zWC2lvcFla}%LV`2Tj%S<-`BaJ{m&~zI?Imb+xtC!evrqV>>uCWC7qf`qvkOCmP?^Ox{IrDw$ z$MveJN+}mM93emiM)4FHE4qFr#fGmi6(?)PkqlnSIC4}`MS?N%R}w?#4Js7d3ou?b zgHhmMK8ltbsCOyKOXkLBycT0DRT@g!ipK)6XWS!gCNfD*B!0vv&hc$FS$W3yLycH6 zvF>>idwzWBYGvj%7$i#e-HiH1=cd^{h*NFO3w-sf7%QI!F;3I8Et)t+@?lBE@vPF9 znB&zW+JBtTF4Hiz5@n?==;_2aj>kZB1!n!#oB;ZLmrA^}ac(q6b-pwAxO|d@$Oozn zcSkc69+ z*Gc(E2tVMam0|0C(CYh3pdCMg!7?hoOk*7E!aQ$WE-e<%z3pF}vYzVpM8DIR*g22Z zImpEGMk&=llHZrcvDvPQ&PHEkUoIytWJiUW59L&nF^SI03i%28?6{(B5>l^)8WB;u zWnEW>e5c`7emOf;IrNqWMMBtEn59DDgoJE63E7!rosyI3l-@!0X}4E zshrdQM-VTnF5+xKVzhBqTt*m*R8SZe#qcN84rI%D6q&e8pK@c5{tTgX-9RL9+Lp@P zMPp{2M)|TmJ4p=&es?DrA4z})=G~M6K1OHsH8<+k%1owf=}6(zXB@_f$+e5$i5stu zl$~npoM!)!!|ksJ0RI@R?$Z%D3YsG+7#-4LVWe7AQO@;~rqLfJl{@xRY<4V(W;aZ= zUthMEGt1*jt}I3v0uWbUk_C+B9rx!t?SHq}n11};ZeB49LFS3hm@=!0B`YJ_(b@jM zt1{CbaofQ!_w0hdIr;)IAj!TjbLdfec4L4n9aa3FF8ts73!$5pX`ywT`FJM3vQbz< zW4qy);1~kQ*AVft#$@&;wrQ65^~$pBN=A5nkKIkEPNtJ*_rv9II> z)U|A7z4Ce%&RG!x*DY2w=?JB!oxc2Cozj`1{g{*hW_QGNW5twOB`&L@=)$<|RQ~!R zi*x_kNe8R%RUw+6&Dl6rw>kM@f9SXMuzd$HKeN&zAW*o79s7n13X9iD9qvCBDk|e)MW5GK1VI?7R6rrkW{qGk(^l1Vl3b9?HW@CSA2PWkbiyqE+=o zFVhu*uRxFhM`P-TiT(+WZ6uZXs`^P8O$OJAa*8z{MFWWJl|Tekz$ zpR9mKc&6C>*yD940z)@G_DoXIHWbzM*b#{k`b%`UVw&x15W>04fy0GHkfSbpSe2zFW|}HTb%jg>&nCXS-y17mYSO;J z9Ab?rSO8jAkv8gx*uo5vgnPO#9mwg3{ua_7gyC8|9PVdd3W1;#9}An}{1?dHXPg5K zPobLdMB#`W;b-$rzT(hJOGbQfz)C`7WyNs!FDL^1gqDEbou|YkO^$(KVib}W74}sG z@Fk~gH)^ECp%3|XMic9376jI+8~z~9U#uREdJUA}l<~C2z^LcO@hVmtUtQSDE`FZP zSY%%2m|gG#B{Q|bv8ZQoj!md8+16@w62xTB?yuhApvklAv}#TDu({mni{aqBtbA%D ze)3%*xqs~^{T1S|c=xl2_!HyxSnz@}GzuUTXSDW-7Xzr0Vj>LWI^4eaX|4*LIfX2Z zZ0wd}#&0Xtip1Pu)pE+2%*=T(3GIBe#nU!&EvX77GiqUyxN4qw8p$tpHb+oZz+eJu3+ zzR4|qspD9;RwE%+j`k0nL8dN;+H zDfxLi|3~xY3awN0p(N4tYZK??R-7#sNv%l1$zd|{==+>2eD@dD0h)MXxnM_FdPG`y z_P*j||6Z}8TD9n+htx{BqmMQ4f$jdq?)kj2A1l&o)e^Zy(wzr7HH<%eG*5S(^Q}5J z>Y~6#vhiMlSaCRv5OlM$3)yhF-EA2gMP*#K4J6w!>=h2BBrGwMmU_5;KZa}}g|)hm zDF<0|({433)EZpA?gok_>F96wK03eYOlN`CbZ)B{S*-FG_bYQnV z6p#m#mfQuxrrMBI+TZy`Yjv{6ToE#{f}TJ48Gn(%xlwA`799GiD=*fze*Da-ZgF5Z z+m*S(G67{jg+~K79NEk{JNksgui5$GGJ|9&)k5BA`)qMH4UlDc+~X~GW7^u%5V&kxTm&(d|~QsG}$4$ z(mDT4<|KD|dauEedFmxIx=O)xrTgwVrI@d45GSEH8c>>ngBBi!3&;sZ!!!PcJ zcFwyJuT6=16JniW&uMrON~pOeb^C`L*>?z-a!yC>3=L!)9vLBHcB+qi;-Mtlod|VV zZJC@J!HYuqjA)q3*0kxec0P%G*mV`)wk9R9^GP=Cql?{}-w2hSG@=9M->;3ms9c{& z=xSj&z4Ln-W2L)*DlyL8oP(%We&qJ{vB2XegLg3%PYLwf$O3-|*6F|0yMJ$281!IP zQUH|QR48B)Xv?e!O(<+Egar@NAs-INyYT}R{dBQdB-6=Le;f^ak>*AT3!49P zDjl|2vpa#Xs#{kjX=#VvUH`3R*FXF@P;mxlKsDil+0#4bq9vtS9+uk4R4VPF)dnjl zD^gEOvVuq?)OqO+6e%xhztE07v3;Va@D`Gy>wZ@0Ezmns>2m+^#LAU)Bm~AdIoWg>O zKNC%rBwu54l1-79d_D-@JE#$ytAd>`90;B8|7y+!6&$2ijo9A{6@2$k%tv zxGrJX;Zu@`Dd0fH5w-BmpUW=wV{FE+iY7MxCYijTXlqfRWTAdOhhOt`Yw`l*yV=vT zae$fGoB1DB#1EBjsBU1z@{ur88z}&y5ES0sPVz(c%)X#aVjiaST)g1REyDpT=NO_= zLn{=8Z5!=$MFp3_h<^z;^U!M3h zDSSO)*sS}!H`kDr_FzN>lU=iA{n z;XZt#pu}OqpA<{Fkg~e%snGM)`km4!ZCGwRs>;zNK@)3748(_%Q!pM(*d0UoNsf>= z1|Y@t`xV8eFV%O|>9iX-Mi3?Q5>lPsCU$V}f!}^ahLK5*xWtd(I^p4mbX8F}`yV2~ z`SD(=W`WWEZu@hm*M+-1g^kx#NOjQQv8i*MrKZnX*!ys)Q&U_P3%pMlnAu?h@rFol z?`EA2qktnPpk+u|g++b|E;6*rrw?p-%BS$spfqGx0amlkz{3({!@a@`m`u_*jds$3 zGks9-JT*I6Wb*@FZ<|YMt`R#8PwuqJsmGeUpb#vOE_q?_= zj|tva>nB<1*`s&v7FOoAxWc&RwpRXSv%DIk+(HrXM$#iy8Z}@jAwz(X)L$@B#oTt( z7c?7GsmnE=f5^@Ey#Zi<=&9OB>krs~{_X0g;c)^M+IGnCoT_viV9`;8DJekev9Sp^tUgUhDO~YTbJG z{(9GUZV5O^s`kbDHOI&yIIyk&=%h~PypchF?uI(&5Oa5m2q8Z<$;ZYUQylHRK|s4lMF13? zMkFf-*g+1LEMkD{0wfPg(ZX(_jFBznr!af$V9^6X4PrE;UEZzW0@WrHI={>5ZHwL} zAS+WdTO-WK^qLX#?8ne}ExfYC#9P18akoGopZ3F_1R*E(r)6IW=`IH~023uAxu<=A z_lMHn1fK-iLa<)3P0{5it=Kqd3!SGtND(9CRXfw~?>*i4pD2_6k)w zpE1&t8wQeo%h_9t+imA_7LQARO|K=iQ8dx_yg;&L{c{1C`njIKOePvx`K>Hvv#0TI z+rmt)?=cCa>v+T9Jula+*|Iv=pf5Mkzuc+Of!%9scot!wuCO3NJ{k0mpnxn6(5?@oCvypH>x zYlP%T&7Gz>`TP1MYT?u!C!x@yf7ZF&#En^iQ`P)+Yxxy!>}Ii^SZ4{}vV@mmW#=$qz z5FjvWhyh?=iq*${eyB0Gn#LMXrSw0?w;S;!O|?YA=;*1$qVSP0E`=7S=t`ua9#-n8 z-^4?~ljSnZcKsddXwg-bVy)xoU)ivANIuW?NixJI&DFm+m0^Z~GT9e4{=lPmyL06c za%$siv86e?Uu^;Ta@>VqU4nF8jA*EwiKvM+Ymak|)75KR)nDs?pcrtzynp zZvQ*H_&@42g$D^+$J|G};B0AxVhf=OP#cjx;43}`hX$ig8fs2W%96?s`%8$zAdiJ6 zwDk>vQpDo}cyz(!=1x#HlM5Q}3N$Y1Y6p$CGHhX(N zXJ0m4?#xK8>Z*H^wB?duSxk81diw59@73t(q}@?&I)5o+r31>F3yN8xsB>!nO5k30 zMOGP9X`c`PYl%)QM6YHAH;o7A_5pbel>%j6B7wt(9D{o_nk|VpDuP-1(fg!0Sktfg zak!+YsrDQr)762n2o0Ij?dDl9Y`vIa&4#e6Hgr^v$24FpY(h`Ie$NoiK9puSUg|4S zK`5aVGr*0g>wM>e(-gb8+adbn z(xKCw!KXaQXR6#s=8&|7*Ys0?`&hQuZy^y|)hhcBCNo80UtQ5$$%$%bULjZ3H?OPY zbS#}y?+=gA?!cQ{-nbQqa|J0Zn+ZDx8&BFTdmQrn=u8AkQt1GA!@jgQ8ADXlFRH3> zl;j@^=88~zbXDo47Q3v%{|u#3Xxruou{?__ei={5SIb}QmQ1oyrx6wvX~bms%(5GX zGU+xm@P)}!fMB^Umurg(r_g2ZueP_({EzQsI@L`HcG+U2bfpC;uo3!$4nt792t{66 zFG_cQdvPh}rNuRqTizDC3|kM~p7tbu+6z@vkH~^p9E;d4nAKxue-5gLQVeWj59-4N z<7Ix^!-O1}*)PaCnq0MIi9d(fZGAtS569w3=*4hvyAUTE6Kf#x+j|^8-p3rfe|@lL zD#3C^tK4D90n_X*YyKVCb7UeE_N&!vWyz^_Niz!Zy8n0n({bOAv$0mDu+e6Udcj*J zzyDl$&pl|cjb%*(ARLFSyuC}o?`f-k?@}-h(|dzg2mtUm%CUeJV#RB+s0c73_u z?}-$ZE&qLui=Ee*yV|cmd{{1D%wsS8uB20EouEcT&63q0VRuST9en3AF^p8sY>3L2LK}JrxRNH+iiMqxhHp zm};umbfI)NE7YfW`H7_VNOsCM>v^p!XVprk-|pE&tqXm+Uuz}jEpx8gf7e*%D}|TK znzBnD4lD05h@jX#uG5j9Y0~HjrO_@sgueaOs3+sHfXJH?g5dEJjUJWVgUYdzGRu{K z<5QLH^Y@uUNO$jzA0#qkF~eET#74c!GGKa=7V#54sdYBH2ox4}J0-NmnBt*^^D6S! zWqi41V;PFXD3z4hiHPl?{U{r)@LVn{Jqi~1IoDLNb?L?%vqKq;??NW76NCVL zh}P8fGfD(6;b|;)8;GTq#2~Cg&I$UMRqse*Yp4av8I#@jurHE}kBFTOJv%r^Jy3jg z&hjSdSu)_l_R=F(8rkaoaa;B`slhD>=5^<7Q19eTBUs`6e(9mXN>Cpt^HoP&%Xu8x z(S_pjl+ZCx^H?>B;1iUMPdEl{xg+rj=lg4$a4-sP9bbmLqr450tAOo1SBp{mU$inB z6hD{?gdXxIRsBQmIyM^s`^og5kz^c1jYRwL1FpKx$T2rP;=bR$=AZ zv75GjDe4($ML*sU_|qPz7@yu62%XP*#b)?WG~E%bv}oPQ_)&2)i%}MUY+JYIa0E?G zL4FZnZp(@>D$pVX+{^I-1pBE8GB8ylo)h9f9- zix9T|&Du>bGTEe8Vc|~lapgU7QdEY9niRpJA|)Z6S@r=7{`1+lZwDWcg4rZemIHn& zcDQSov|g*Vt~Wk@LnY3J?Kku+`cr1Y0oQYL{LRfEHW-}IJzI{OJj4(mGmXV$czD~l z!WR^Pmz$ROaX;x1GkPOZJNmP(WHz165uBl|7;9rMdGD~4I%U-C zk60$bFm;|E=lWh36Jd2=IaWToHA44yID$3RdC#oOz79H9edcsq+4^x(+^R9hyx)?y zy?S`KD|2FdR{6W#L1X&uOWIeqgGR!b16n`NV=f16v4u_$(v=>{Apz6b9#li_{G_2! zMx1+it@c|e_aQd~a-eXJ#c2a1-Hitzrc8$hu@UwC63WvQE~lsuV;PSkr#G8V2zfS? zS*F}?IaBPYNQHI63#+yhFS`zuj{PX!TE4EaTCPS0zmqKN-C(yxjP>?k|Bx%390dUD^wr<1oQxR~eYM%4Jr1mgLe&?i{ys)}j@yXxx}^9% zFG}r>3LTrz=^->h2#r-?;BPsk*p^_7Hu*C1UwmvS)s@m9URM`LL0h z3)NN-WasF{lW(cYkXu@S{bPw>DP89%-kh&~6T6x!;`41TY$-;Xdd6Q&V67(mk53fe z@_KwovQfPEoe*B@4zKpG*1o;4H=(L3Ox_(4HlT!uY$`o`6~veQ_K8d1-Qap9_KD82NM*29pfO+RiNtQc{qJ zYKb4_OT}VYQItCs3Dl1KryNp1IMWj1@OL{7yvmzVfr%+0;?^uc1s)2^WwL36kw+M@ z9NF55LVWg9dFwf=X;B$0Mh*R4K}EXY`2o@W!40L2n5Ab73>z+agcv8PGFqsITJbU| z?t`_7XG*;&FCl8cFzb$LJEErog#nCRoMXDg>^b)?Z?3fEd}-YnuEl)a@9LEK1x>S@ zCp-1+`nf1CUE%ZbFoeL{Zq+g5W9zUsiOMAlYC=WXa_5JWXn`PdAQkk;-B+;R2S zOU_K?)EhRfwHA=!OCX4UaS+G0+Mp&4 zKR}5@RK^rTsH)5{cH)TCtSbGbYk{{utlv@~@h8aOYH%r^OR(B&aM?AWSKH;C9-16*0FVvUTD=g&_w6FzxStI<49&clG|NkZFn$pooiU=q?u#_6jlmJt~M}HB9&$q?3fdj{j1=*k>PKHz4mc0#e@}uvCiC2$m zTE;nelkN+JTetT$7h=EZsS^t`^?hm;KH{2LxV_%FEfYc z8Ev@!8qH>q+`R){Gb(c(R+Y`or~;jl6hKw(yDy01%o^G))%1ro>=l*SEE3Ke9OQ&z z>LZP{srseNYCcLrtqcchDo0Pwd@kp4hmLn>uzJ(!t9gu^;MDvHnG_FKjA z9%b34Q+7vh~bw%pN`Kxi}+xuq&U=W=4}>Ww?E(Av**8@cYNDUQcI zyzA@(xCQj|!XMgNQH4uDzMp?CsBb1=;;}ydth6rq;*B_*u%*pnTQnPvc_QCTSr>h~ zg-7Z-&)ym7bhu6~1IpD%ZW6bY_(Qo*!*MX!moOK92K8{N9|Nl%qIYo-T5DNCw4l@X z7aIVE4$=RWP`oWv6tBg^^bfhLrb95WQ)g)bLDx|O#8+(;Dxf773zDPCMu@LIZ4S!* z^+R8o=c{u@!~%!s;o{xVvZETB0ghjj2O(4VL+j%#$(N}&866Rb`Bhl`(dH1f#yH;G z&$h21$dcb%KzQKr$NumKOH|+gztIXWq$vb|*04ioT}3Iw0(?!H zhek)B=AzvFO@R3~1cw%Jw|0C`I5SI#G$_ES&!s>mn!SmsMkc>4Va5B(kq|3Z*vxC% zxGFB_sIK2BpgvN$2BT2Ds$}>}%2=(u+y~#5h`sc@5)!Gqp~dEXavxN35txLSWFnq9 zs8!;69OWtfI1bw*JL7(CcWye>@&a5OyvgKq zcu1&F!{G$t+uF#c^8gXt_vWPHS5ee>WN7p-#D<`BDX0j}5#>DELg+v-m}3A-6zdKt zJM1^9ASlLl``p@;kfBjic7c0W?!|pxHr50lst9Uu$dE{nR`#y<^GMMArbCYGb@JV> zi5qZU%UnYMPPIS)WfMo*>{ykBocwn;(84#NkjiJyBY9BX4bbqgW>^~U{; zlUDp;;X1ybQx41buYF*7i^~)ns)^T0;rF)db72q19`jcrBS3aGVMPy9L^U(v34=yt zNF(}+iibxe6G$2-RE8Xex`>IljJRp&|ASnYX!KEjK>;wWpM;T+!L(2jQX(P-tO}kS z1BQmE50G(4BvdZrK5HxR`f7YvB2KeSQvvPTC1C#@CwIcfic~j}-xwdSIkd3!gfSLz z^pe_xGqW621b)l*3LgKU+FUX{QgXii(m6H6d^w@vQesw&TY$#MsGTR>MuKFSB6C!pZ;C$f$nB-eMrTGu@mOOD& z!S%}DLqg!5+19-+7L;YF+%Am1JMdm8|2VvD-$;H0&0KEP?o6j()lP5u9nT%!nwM5w zWiq(^_CQ+nI*Xgwv3R^|?1!Y9fXAB1$PEFMjw)Bonnw9f}b8zIm+i@NkyX#(i=^EMZsUolH zyjf*b8n#xFHMjEn&M(unq}E^jOzpfS^VD1f2Z+-@ed1IM?Na)?b;C)gXkCDQgMcv}iWacGyPH_2jH{ z&5Wo9dj({^53LIB6%2-k=Fv=x1|9Hd6?NlQufEkCBFkl_&a#5@3o`Ae*I!<>xyos_ zvMpY>ul($`w!WVct^Gr8BNqaO!!S_peot+6XOQu&Dg&4WP{??70bu;=PPpIuyEf2F zPve{VusONic31qGA_^_=rdm^CMtmVJm;LvDa=I)1Alt9v@&-36ZWMo>7Slor1_oHg zpvnaQSN!{LA1|nohL&7p&apAkN9?vYaSTLmXv5^RI7%Dm*wDV=Cf5BSs!2`b3vg8g z5YyD+QzoW_GY@YbWdKEBioZx>X*Xe>v}uYqgx!;_BOzdsl1vyWBoA(KRKz1Jpaf83 zLSryVAWiRpn85%IgDp~?qSzE|*C1PwnVyuYMu8q#-wN%n#5BNwCcoI5!(B9eE@%&z zBsdrGL4T+{%0xl-Ub3>~uk4w2y>#t3-~#ugpv~Ys7jnA=d9HOzS@k^7sJc4Lur!*C zoE+hwX|#CrGkCwrY=PQDC!PuIv;s&gB$<&@eMmVV^!(Zv0{QWFNJe9+X6X^^YB@bd zsE7xoL}A5L9Swm7LW4kq)KS$4{?=p!(T3;3fcGBWJ`6edi3pf-*7OGxfCf_1M`6<7 zb@1K68%4Mi=vmk|tb6=bZflhoV;qniccs>gY36S zA#nX+QqREC$Fbm0j7(^(lj2TQwWPLl1Wwt5;#0=Uh^{=XFWa)rDhbel0hM0oCd*2c z_N4IZlUIg7cTV`TA2hlDF+^bkG1PfJOZewrd`7B6{vwL3B2y(S(BJ$IImVGdFd|;q z>OUpeaIh0?(hz|4XlC&m1crY?vFmLx1iBW*TY2=>z95MrEpc3q^Q$+x5U(|hZ@ByY z4@+-DEhU#0`Zgq~E-e3Z1+o-Xj~qhl1LZTP2#b>E#V4Kt0sa(PE#Ad$Z=cyI<8R z+ed-o_j9gVwyW}4`Mux5{hP93KPHZr)V>xbpco#CGymWm2a}O8)vzNv+c0MsIhpyG zjS|cQfa^;hoPF=ZRvN}bufZox{hGm1bg&Yaj=e4Bw;EKZr#7v{pXdCMFv*B$EIXuh zx7m(@PiFB8jlQISi!S((Usell1E!TWpmE6*M|^pqM)7`@9nqanS+dW z*ygYHu(1hzo4vT#Y)2O*&!cm8kQb6Xq>>0VNo94a)cfxzvvamkWHNa^m>mcs3JUhW zW1B8E3WUOmYI}X26Z!M5w5&XUON4S9zP%T3JFg^=wO>Ny!K$hXj|oW$X&JW|!O^sG zbT-&ycv&T9n0lVgt2g*W##e{42u2G}B5p3?X2^A?UCTH%&PeRYm2mVBZ6`T1gqey} z%jT&jSz(-Mok+9nizEGfw+$WY&NM|8Ok(oHc`Iyb3h%6j7X0c2$@u5$N8%^i44lKR zpjvkm)~J(xdn-0%pg>MCe2$=l{A>9$@Rk zGa6w~(IEVyofy^qttts>*d6ssC0g|HVS`#4QP-rgC_Q$6`iC6nt`z`yslV=m%;71x zuY*R2gpDB=Zx%)AV#I`J;}(>im+kIPL9Fro?Dr&~g2Y)PQA;arX(lcAle9yV*Yr>b zW&-2{P5pVaiILl4+#c4l`C?jt8>2*1vTBZS-Jlg|8d;yILw0sSvr$P;b%mo|rYNpybuF!|hE$sLPf2<6G|LLE{9HP;WsKQ4s}@xix*!%FCSWSX!vSBIIx z37PW0?F#Cj^!%gK*j^S{FK^|I-Y(xtQBH0b7HDIt$slhm$AkZw3|mnFRZSJ0pheeC zPfWX38dz0f*7J)}!N}*5{N?n?dafu2MdQ(I<7O*qCcv3damADpVFV4Cd6P|KEsC~gj+b@6BkW48n3f)TBnDS$EMzy> zIoGNcJ0k^2Ya>NSTa7VE&WM~7ZeO3X!e-|My{OnM#F$1zx>uu%A!hwvgm#MYRazvhk)5)SR!L5tNyYcQV~OaXyP>(? zy)=SVlh_WWuMf zKn4RdDi9V_u2xmujIbCzgXiIcR^D}L02rI`}jP4ZFu+yLMWmx%oDqi=Xw1QAou4}*J@nIZ!C^o$Gdes zt&WU#r-;vcrba^ZPchqjB{=V{Kbx9FHduJ@st3Oe6q({)T-G2JA|IKYOE&IXGXNL{ zfJXpf=%JB0$J7rc!qD#F({_$)eQ4D*hl?7lWY=Te5yf9E^M`8|Hdej*VYg(kP+KhU z89yVp-MV|-+^LEoRnOs-m5s&-^MjC+QrY(bQb!^pL$Fa{XgDHQy_uGW5?l5n(Ieu05G@z#d?R@8f7F*I}_F$*CN9f267tCXTC3LjY=gArCSIS?$IV5sEe z4>L8fZRUtyN^SXABxa02EA5k*&ooDsS-t#qBrf5JXB?M{7)SJr*on}pRoxd+`sLL& z9ep7Ng$iyd5x1~FoRo2~k=J6cPlze?Kjq%O)pt#Vp}OA|9ms%!BDrtlbeE}D@hrLGj%@_|&8A@Ki@)0lW~@VeGtv|$uy zPXblYo0hL*kGX-GOTmb^)o0(EW?^|@82jQ`!sq#K zq{$O#W?8AClayUb9BvCt9d9`+4Bwj1#FDIuYpt##;)Ij^^sF!$mkt+#cjQYPAU;nv z+$=?wq1xf5sO+jUP8|SAZf~h|A%KjW?pK1(vYH!$?B*!zfux2s`Ssu2`U&eL+@NM+ zzL}>{!-3Yo>K1y*_~=orEBL@WIW|#54qQ}t;))E+1RiL3kj$5W1}M@;-?f^7|9#L zOIVlolxcKmv=aF-J7>fM>8gD@7sIFZT@Po@Tktx0MbQRXH!JAy(#KivNHshK2Cr6E4~e(!U; z6WzsposQkAy~2MBtbJdPyxrhqlTT1}v6sguWOHB6?Ej&_<%W9T(bR3R7oJ!p?syP> z5ORu0E8q=DOKXptb&9~M`@<@nT2@{56cDPCXA1yEli|UYLDTU9&C2I!D^F@0DihMj z)q@#;!T+<}W$m8zHEzcou?U1Jt#b>2{uKP~T&l7Rm zIQH|GXJ$L^yFL&|Kbs~${Jwee>cuVOvD^6vdxjG9v4Y8{Q6AJk}vO6-j{3O6z(d(_&kJ%uA{c zMMzO>RF6wKhWXyW2wmck=KQ_8qW!a$&Ol;yxS@6x=F~>F#Jo)?~gM40UJu{#S4-by(p&~Y|b&wi$ z#d@Q(hq{>t!<9|S=M@Ky%2oI1?xej{A5RoX=kDa8dM!p2lDF+w(M-55khkX_&zpY*hn#QgJGL{T>YC9KHTNTP zZ)?|n6)p>3C_G8*mJQ|_A_V|&O8x|-?X)4<(TGWT)tadMCwEEwn=Tj@-BQEB zC=Vbvbeerm3c%6JSE>GD(|3=;@ERIcrsVc#EU*AqRWE3W^AG#q+fCjjfzg1E+Hq-1 zR4y*dMvfjd zY=aJ7mCq4z)I&Cu;Tic}=TsvR$%es}ivxbv&CMPtq$Zlf12xrbm-j@3o z9W+wr2SAJQ%Ne2j7Kp=9TQ`;A8|j;x%Xk-AeX^ohlzS=7u&M^poMlXwTr*{=Z?MdE zTVU>HWNqgh(~ae9o!zuuS`(O?Gb;+`&}%hPp4cbMDe9FwH_<(5TqRSWrw@dsDdA3r zO5-)oKEf*A4`j+=)N)3`NV!>^cDiYhJFUwj^RW&8TnW$d>($tSEQacyE?m5)n0cm; z&-?Vn!6ZC_nV}o?MMk~>>7|2cnmz*BIfBTu+>7Y-y9~!Bpv>}7WhV~?hKJS2uU=FL zb^Ao;(hzU5U=X}kwu^F9p}r^08zdb&Hh%wRV{I08(2^nu*Oe3K^K5W)KchVS`s}ch zS-S>dk#GF#r}I@u|It>y`XhtdLM^k#wky(3%tnG((C?Xzb|7g*4Zrb6^7l{-XrUw# z?ymznl5DJW_$43sFw$-GXIfO(+|~1M)X(g^R*FabA4nG2zP)w|z8bvkKn~J>D+5>o z08Et@ba-@aDi~VoR{_gDaB3*Wayo{;3nGP>d2kkTAM*sE#E7^WqNj(1t*@aa9WEGc)At@;PBRul~ zGaacHTx@6*s{%I9Q`}P}^?V46Q9`XFp>wXO{0^M>+A{cuwy>ZIR6XSR-A{b6^IoVU zY4dBw9i@~u`2y-WmjKjY0HX85sJ4qEaNwhJ60N2X12ALsDvo^#wjO;CkOy?N4&ex` z?4L(Radi@-zfv5(FSJc3tis3<)lp`HcmE(k?sZr6HxIZ03eJTsG;re;hn8*El>VXM zx2&`E1@|(mSm&fdi|jDG6t7~YmSw(iUc92AJgF7(df-wqX`;L)x#Y0Vl0(QCkEW-H~jDK#bUVSS0l9zeDnD;ox&Y zr)%uX?GF{voaary%1PEgoOT2sIH&hj*cWz;;o@=_XBN?x_Z~K12XB8+65NUzjJJxn zY}mpt9f23#@t%)~d%C>3u*r>xp{dB}hy+KWL$N2O7h&{C2~gqXFRP_2ijr_KLC<$u z1O>zGQ=DqaMA0y{(XyNg2?4v$LP3*#D4I58eg?FLYH^ z7(vE*XNb{ez?y z9}tZzaTPaG5Ge}ur&nJ({1k+iUE4F|C5d`bf{7+rclW&ZT1TK)9n;Splx&T4H{rg+?|?A~Yg$n6lyb^5boaP@5C^A_v(;9W7jV|Bmu zEp0iOWa6)`9~$1*344ko%N*JbG1RL0V_9?M} zyDdgPLjA+lxh=&xyM>UYkjp1cz=K7KdEwhR3l|N?;e&DK=h#!A&^Z`7;r?G%BxpoX z?Ao)RG`1%|^d_sLPbv1i>dy|G4z;gp7aeBGCq&vk$JL?-4~#P=l8yl zT0e|zo69%Pcbsw|uTl)YlEcD{;SBW^=U@S~@}K~ba6=(hB4j8Z|83L^C^3cyj-NrI z{-S{qh)R2Ltd!#FtTK#WJZg%)2bZ0}loKX;;uW%%&qy}a1n!@qIM;%1R6)GL*!ka@ zOJ6s^``t>9Ci2xBClh3;W5-Te5W`V0?B^fx6nMFVFwvG-*{PDZ==otyS1YA61X zGHuRzIWjShl6v%+)0T(th*gzP3^h?NZI&>FI5Y|dAwP|JNjSItpcTXTUE_Ak<;2zZ zefO=$Z$0~U#mG>}%tLah1kmY$Qfd;zopsY*Ul%=HAdfQFG@qvhtz0}!T83MPzudwXCKsRSIcI6tB=J?S8Su?dCt ztz=dUtNHiy{oir?Rf%yrXWQ-fMb6IuUTwE~c6MIs0mkql!yZKmH1+}DD2${?-^bP< ze}DlP+dw6!t=W||_NgRDmWLrX*Z}YY_xEHMV5qsc=!w&Kk2w_K!_ku{6&e%D0z%A5 z39uFhtn4SWy*U|lgM_5B1PkR4d&^bGmC|Hs%{Ma9{4O`rn|1P$(l z;O_43?(XjH65QS0-5r9vO9<{x2p%jrb0+Wqt#frQPT$ctvsh29>h8U3SGl8ROuqK? zgVaE;|NXb`Zy)6}sT$zhpgyfwpg{|d6L!)e0NYBUSPwClj;z(o>Y!4l?248MK)l2| z8$yDy-^s-YNpdm(`x@>)A(9g;oW>sWC9`OtWT$9xr^Vrn|OtwSTlY>H#llr@*fD# z8P8XW?hj>=cfRdvkM_Mc)iSqY8b!IIHjwD0w6B~Z|A>3%dldw!yr5mwHLS|Y4A3RP z2%GGL_>noN4Noz-P*`J{{^rXr^50w=+Bz!1EMKn|y+qUb&ncKjG9Ca;W2gf%H-eNF zh3~!K1EBAxn8ud6MnT8X`UjO+MXXDI6-Lc9q)ON>n#vjy$c;afd9bqZrTYA90Vaht z*6k45^fYV?Y4cmz;W)Iwc+nr?Z7D|OWHF^9T_pWCUyz=PW|8aeAxpk=kTIgR+47Ie<&{&8g z#TT(BS#E+Ehl#ml?<$^2Y`wiVkE=Xq*Sh4y$zPV(r4Bu079|q&t|MK$t#9I}&lGss z6n8q&mD-whNxq{~>@>Q$pVSg~un&EUEfUIn?P(KF7SG_F9W^rSlhh&po5ePZwkVbp zqdzHhGfbr0Z97%k!C4Sv%bc?#hB`dW{=>OKIZ|7rk!9Q+TY-frjgD$(A<1$!t>2|um0&-cvfi1YFWq8DYzU=Lkt!F0or}fGX!1V5CMe% z5U!tXJe`eJBBu~tmM_3kvMn|qArs8@2xt9fr~3q@Ma;)*a*wW@{2)CRwdGz^fv!pl zjMxLwbh`A0I~N*NjHh~ZMj5Bs4r@vby?DAo*yFl(LvvaA)TUcQJV{S(dct{bP95wK z2GE#jI)hoO1hcw9Jsr>c@?1(oMhEw(U+Q~}66+WYa|qee-anQ*+MERd*UdLx;lwt0 zLeIY%lgQvGpUB0Q`a{^&p1G%{dBXwF0nu%>&;ws=Bm%$7tGxviU(T5%Zit1!njQ68 zgp6-yP%Zuzr(yzoz4NoK@-kBl}{opRmQst3-yHRK_t!^1kq~dI=GrjiPkd8-&NM zB1g<_)1*m*i{zX61|YxA$hdGd;O3LEO5EJ<8cw6dWL1S-c!?d>l_* zc2q%A13YgEw8TKeU>kPm&qS~+@k6v9)kZ_TPl!zjpAj)cmF)_)={T+Q#pH4FG{&0uIM{sQ{G#fc&xut)8b75iyamadadAGctNc zNKa}OZjZu(PD<1+Q2ZAV5(ZuZp~<2xTel|F6Zknk5Yl+GmO z=bL$=y}twS0Dq+iF;aTyJnGatLnR^7Do04oeCuS}nnGe5t3yFKL;?>cw|2iSKwiFD zu6?)?oSv$X*KV9^TDi09)ed#KVwG%aojDejSh{ZW{v4ZtPnYk@*mlg%^*U<0RnoK{ zqA``F!J&tn9xroaBA?ult>O=xnVJQcsN5`^V^Cw9yE=9?{P9tY0MI}n5CY&ZIACD| zA!ZB;0}~guQR0?k_Iar@qQjVq zRwL&|A-=pK`1F-Q7p>d0Pif-ra_G>3KM2cf*5vl(&x;*%qrecJ+Bqyf_1*U6fAi8{ z0T6gGe8`}f7fO=21>QGE{Sj{Rft8MoJOUib5JObL!PLrEpp-s(11zj9WnPp1RB(9pG&ZJWZbR}7<(@ECm2OPfP&#vi{;8{ehUA^6d*C)lIm zGj~FjCN#u~C;XWGS%}VtN|BPI`SGCj74_}1{GqKzZ@eEiPz)mz5aPH26UwWE!-b*? za_eHGZsuK?BS6#4E$d+0hZW>3OZMmZa)XH249Rwa#;|dn;}=VKis|G! z&!6R`QKW{I#AO}CdumDIaJU$$s?3dtKL_s;FBk+fh$ljFBz>tj1T(aAOMdaC?RKwM zS#*aoZ|vIWi!%H4UT(DYR}A0n1gL!5{ibT*`ei3s|M-2hjk)Wuy}~!RsG#9lt7D{^7N9vx%?LY%{6jGa4aE_ zgN3{G-pa~a{!@#xNvhyQeb6|y=CkZ>p5nqTuqSlRf5Wh0z<#hips6|v7Xq(-wohX_ zD;i(s$391595^*awn8>Z=vhX))8T9!o-G)_8ysir%OfCi#7ojWwtvi20;WQ-fZivh-+C z$4?FK_X}Uw%=>l~YxX%L{L%t6D>x_M@VI=h`KfJt&Go|`Y()1J^pGaE;<^gbc>*6~ z53!&I(4(VQ8xo0hafX#`w11Sxx6L}o*J2~=wSRKCP~F8gv5M+rE4&$m?CQ*Lb3^OGU=NT2bD z7Z?zrE#6 zgbz^uEPoXhLscI#FaILt;oMlf3bjAB@J_F`yb=B9uG-Tcm9v+8WeCZ=R)RC>C!cz) zp5EYmFfSi*Wj^pm&+jYVZr<;F^ajwg3WnMU5N;)^&g)d!G>sKEs72@a3u`A z(7lsPYa5sLQRD4;gUaYE{W2xdRxX}KVPp$$c1x1OgG@vqdHXEN43%?`{8B%0blAS3 zB7fh;+NXcDjtV+umKp|PpQrWgMd7P`(gcC1rGropqJkNj#pL& zZf*wl|8I}4|Npy#-`C(rY^{Oi7W5b$VVJcWnA1TSS$6q=rlNE088o20mYivEg%t}ovM9pmm zD}P%zFugC*?ggHjDujVA5H>2u=&h+1Uhz5{;}Vb=qlD5Y$?6O~KWR+-X99|14Elb+ zSJ2ZuoGR+cP9wuw>}-ry1=Vr~-;Q5kJ@+(*wq$ibRQeBvN$Ts1`zRJ>k|_8TyxMqm zzXqJe+=$spV?B-`;NX6bNMi)D2}tC=pQXatc)Rc)Si`sah?a+2Azt9?9alemy>wvb9q zwsO8CZJxJNSxa(Esh$g%D;GPQshf5KXmH4RvmJEYDggLsuxg9Qu46m~PhlRGiD90j zdr^j7WsphRmO{@aF@y047wgff5=FV);`EkYhI$g(=oxSd3z;l4Pj2wy(Om2GHB63OF5Jl)x z^;ibw8k8ei1|_~WSgtRu9?ZbT1?r+nTlTO@p)%6eLdS<%S}3P1CKY9~6zj424O4Bw z#&zVySJFn;Ag9mo?IKH`$#n${Hc0IscFktg7nf(VN~R?k{}vQYD|fHn7O=>(T@=1v zzwGfLuyK0&!m&{E%a+Y1z@AyhcJ;&7Wt!{x$O~bs&Lxso;ykRQVJ`Po}eX?-!&Rk)S-K>Bjsj zN5gRqI$)VQ&`E?9O9W3orU(vhP$nteF2V!gxbK-tqoSjE&@F)g5KrAYdr0FJ8pf|QtPNHcE-vscO1L2<0CQe^j6=?8$ngJcw?JjXVL*g9#ig-ufW<&=x2L1nirQ4W{qyu!b<3T1>b#MpzfV1vvUiwBuUr>Va$8XW6?Q(0JbJ^Z}T zD0#e7?vgV$w4FQFGo$DJ)$BM$J6_h%YgK1Y73-mv2LMG`XqD;#>5lVKn?9q;@zYxF zqMh*a>28&N2UpUZlQdSey-p%G=` zn!VL)tw zlb$KJ8>GdZ85$l>^O5D1%W|vn>&6bVV{CUin8Jdws#T=JSj!n(2$KT`-o#X*vEB5^ zZoj)_N5dA^QRwm;hpr^|uQ{9*)Xx)V3i#;ce$LsJmFqJ@izQP$j+Sj!?9hn%h@K+7 z`ttsE-h>-ryva3nW}D&8F!v>|Te{8@A(2l8vaY(_H*dz5nWiMOhHxzUaX;Y$U9s(D zLGrIOJGaSiYXmTZ8#O{S1q@>FXvMR)A!r^Vf8`WG?>ztH*Vn94?{2>CJ3 z%c(riWc=AROH}EY*0`vjp_ACTbti3*t>-Eq(^p(q1O{Y3R#mD6F4*g(_m3{+em%Pi zVI)0%k^eGLTFh)*K|yO(fMvk>*?T$o2x}dQEvZ=8ej!X z+hNC_;9RXxo>dY$hy^blk#`pzV6O>{gtRnH1m0`<`)c^XZ45FkjR`!%B1PR;#BSwnV`^;pbPI4g@vO8!3NkqL;m69?|J~kY{z@97kZ$Ym`cy9t@BVM| zs&{R=gDlO(M3JygRE`J+aIZnM_nCAckO&2UCZr`&pgng;FNscIRy^!N1*?uq$4R6S zRTzsn^TGoovPMk@=R-PXfW!UfbFt>cxQj-GO~6AOD1Lx~XhBU=TEH9xK@>P(nf->U z6Tttzjyau_@uExKdUF0Hz-fic<?{URKz} zMAU>*F*AowOHn2gG60E+yr@%qWiy*^*-fcj`B#26Kg{^&c4_jFU__y&h1GmFLTT3; zXSd{uRn+MNeeABQ>NAIO<5zR*>VL_3&308Sf`PzegRKB#BLFXyuHyv;1RAla_XU~j z?<*v_H|$hCL23Ss&#n#Hn4S4WUC0$xwSF%w zP2Z)&^Po_fk}+Per|h*XimuHMiC+xI{bde=k@Dd+`GWj@4nJGb2O&&AT*3 z_Tq$1!A4t3#ia<5IG(s_MiPGAJ6P7ACX!~v(pfzUI~W-yOr3`FO(bJ*j|hfh=(19j ztRdoS(K+bbY6VC0_w z9v7oK%-QEWx9973_C}W4{X1`reg`|d?~bTV{#P3@I>Sobkw!Ke$^p?std9NwbMQ+I znQwcixb4&>nCMSq_1hN*UXKbhG0a3YH8C7=-AG9_wy~+E5zXq`y6j!4AWzW4%S2SZdJ%3MCK7%C-HIi17PpWp5Ro;V6$8lEJh}rfg-6B~6hi$O ziaql=(&#%5peHB2>2>|4Hq=wHO zfe`cQ=K(B#0AqX;&TI(S%z7}&#r&j*mt?YxpN+o@qa5auNx@mu5(Pg4_-!Ct^TzN? z%U)Dagny`dhjADtOXRu^ia4+ol&hqba^WlF5wH-Sl#EY88y8lds`7b9z6?~9e?BTE zT!~kzR((x8GNVHq56e96DJLXj$9p=|ZzqhG{jpQO@w?W};@gY4D7joDgA;Kx1CE1V zV#~t?EIhViS~Ybhxus3`A;}#EmTO!U&IHKjyIj(dQwa%%49ekso!3k~4Z=_yooi0C z;p6`(2<#l#V~Ynme-HS#@&0QqS2f9M?s=GA9RTYk5oQS~gdzTooMBx*IUT3M#WdcD zYVWHMgm?^Rm6%5oB5#ec%IDxi)hq+W@zk8sq}mFhD))lx*nPy%!j*!q`VyaAgxA+i z0?Eq+^-Aj8HJugDh7ZbC(4m9kp=CRH%jP3*x%%{zc(3B^Xwr*77!7zjEyA3u%q%&^ zCeTPF2^vMb*c2^>TBYAuPMa-5x4PRDxoX;Ij5XvS=}pRDkxkczCOpIDl6CI;#29)F zzrW8_H+r|fxopiP!ByTjc^!|nE4!kBo~{zhu37N?x%sZY)jhMnqh>i8;em3$L-=`a z)BRQA$1rGlT2gJ6e)F!$x2E?(Q=)vnRHwsxWS07fF;2cutET35bM4aSE;Z<~YvVWv zQzp8FVqXdM7(EdHIB=na4N28QJ1esuK(qK2C$MAE-m5kjakHTTB=g}~j|@Fu+@I2< z$>eR8gjczSUoZK2+f<UGQ0`8?Fwf0}=N*l0PocB}tRQRV9c zQ?mgdFQYd^k&1g!<5fK4$>E!tV(y5}VEWV{W8C-cZO6j(?p%JEzxA9$hP?VOTalB! z$*@%Lk&2gZSnWqx5NoaqZTOnz21W6HBMDP{m=y8$u{_qZ12(-Zwvm_wYETiCtB5fS zo+?xC_o#CXJWxqOZLV*^8-k{>3*MzQ&L1o2_BxQ{IS7nP)u%crE1Bmgs}pH}oE=Ib z+DX4~kXjRxN)xFi>L|rBtTWSoeTkFCV(5Zhq-*l3$oFas^%MEExi- z&B=3gI*H_izb<)`lm269yx{bNoMaC7bKZhY-B>q;GGEyfj4(LS-b2U2;cPOwSvldb zJ&7H5iW(hV?C1OXwrXj7oVI{^epdON<#OB0xE}vloy0mV-Q^a&S4YoiXjG`dB{(%< z){1Y-Xexf@?$$VBut0zFOAnH3>8u^rc?v}63UBC z{>3(IJ(y48@j9vVY$g7x9`$FXQt%O1l{PG4MiH95TJ%{IBni?H1Qomng7X;7*Yhxw zTJj|Et;sey;l6jCAd(`XDP-y!mjx45VvN`fk|o7Tk0~SI`J))OFrly*yGp6?83ljW zfJ=_Gm6~B|V4nz+P%b{(Dkp=Mu$ub^Ii!j@Fy!>L{jK+4bw_v_YWV=<+^ee3GXN+n zW-1W35J0U*NvibPIfd1uiTV>c3go-ynKpqMU7Rf?5z;ihB8^Ps%vLzW3GdtY-wrp zmF{o<)*4Sd&G)0+mJmP{Ual$OA;oqpQiuWr1pElokt9P&R4qqrq?@W@FHw*| zp&OF;4Nb TFY_`w2Y+;EgwynGR_{8ySy?!V?Mm^)tjb4>;#@jZYivM;^tolB0u& z24s6XwWQXDIQww3wJJq7&S$%XSRy|0q_Y*Qg z1FlMxDu2`_ahWza0R+fSLK*)cS4gM;fHR8J`T)DjS(ilj&-4H=+>@+(!vXV)LHliX5e(eRqxQr3wUS4ET;uO)JLb zxrfvlTyn{c$}uRdoh<<%On{BMM}Z zFNNl=E@N7tum)F-b8P;uW=~z%SDQJ&(eZMe8nDLkG;g($V|DtEZi%c6uQpv|_q=j> zud++8Rz26~*H!TMt1cGM2e6z}*)p?s)!A@vPz|2tWVyD?&xF+I0Jwf?`UH{dubifh z<1Ge^|25^Qo<1i*-xi-L2u1ey2xH0yLTYQ5U~S#`=gqRzNrTN8R}#)Y?hL`+VQB#b z5TdMB;@ryhB&(t*cY^j z2ulnl-QVWYUMs^eJ}R>h*2Bk<)m6DYo#ChZu8w@lNiO$eKo#FVQC8l5rWuvpXu_Rr zYv}qOb2WMFV3nM_^564epn@k5xM;cliYNw7eZadk8WKaZcC~H`3#7V2vi)dO0_3+D zrr3DdUVPuQ4H=6kkfx|2DbpGMtiim(V3ej~v9#Qla9$@QsS^nli@Egw6JeK>-&K2WIo`U(Hu{-Nq zne#pG=WBib_RZ3jFU{fgYxZLwq0gq9e?r}jRizTXrwin`{wt2DHaar^DrUB3SZqo! zkcMdzS#21TK~%1-{=}(Br1)<0=hrq)jpnDp2LZUeLoBby*R}uV87m=rI5V>;sk|}66A~<Zch! zhf@??xz#L}B06qyBaE|XHVRQ>u32NzFJTi)*u0HRYlnu+#`{e zY>6YyFhM##*5abCB78!^%oFqc4+X`bB{aC*Z+q?!gJu#0gejr$Q;D_+U4=ee> zVU3Z~+g-4z6n-}SyV(M51B2EE)Gn&Q+4-Tc6Y`{l>l*Erku) z&rdq^R03f!z$w(-Yt*7yrS7%t($NI98&R|qsFHzvWU@qS?pNUj9pIE#wfW>N`)6gt zI&S1%g+r-(52VONyZD4F67qu?%N}WGSp^X|@zuma9;nfAm#L^LseOa~jC{ z^4s7$^j3VGZsTHavPm+Z;&!L3SeDwTm$M-|#i9w}y~>`#LOT>Nn;KV`!)3COz?s(l z(VHD>XLa^fBhUv|n+#FDaU|`Y|quyOyq*^$-u+8PpX)KFJYpOPPchyjtTCINW ze)azK$nGJ)5In$`#H$3KLsBgas3uDV>fpw}+hLZcm!w8Af39(@p^^Div}z~QJ6KQj zOxOfA9rOMNxx-0c05I5i%a@wqh1+Cm*V;r1L)g>uAtI3ICeBWv(Frh=Qolt@2BS~! zF-_9+7GDE4w)zn(ZH4MwJC^i|*uk(M>oJq<*5s%Cn-DOB!^eoQ!_(?7^z2KuN3*&gVJe)Gdelxm4WtHYS|(8to}O9D4Qc-+ey z4-Oi5E$ze~G89_NPMPgHr?+7wwhEJaBFv)@y$j>1PFGO~2Bn$rxJo zeh(9mU)}T3#KSt|2M?IFfAKc5ZMppougofG9@P3YVlo=je)_A7wP~UU?OLKvoZ`f( zDr}RlX#0ftspYc-d7O*3G{^C*Otq-GIkPTDozClnjfy3bNR{o+YmKVr!X}+>1T~DF zbf$FENfEbHhy4LPkNt1%0q(E=qlWk0JLHo`Z`XkT{q3NMUr?HREQ_;0eFuOx14w~+ z0(u!Qg#?YHnwVV|4#6))J-soOqN=r#Pw-l2pTvy1ya`qzw*M*A%8Z0}1m zm-LX7yQr=uR9x##7ucApLC&T?5aV^_rq+@Fvb+@3;b2V|0shU8hKF}~#A65Dr2q1N zRYGP1;Y=f!HNahcE9f&%a95vlh}5vN2LM5fQq#fI2)Ir$LxTeZy4za7P$Yz-VOWmB zk69f^u(8M~^~{j@^$H28A=A5r2ZdxQIg3N;wwcJGJw)Dq74lTu4v@@5+q8s!Vm$L3 z4qb4$f2{5>aZ8EEAG@W0TB6S82wRBAS|s%{k~)9tH_C)a9=;~PnmL$jb3EbzDRFLF z*(>+?6;*DYplaQrQ3Ls%n}uDnD%st;YM>|N)Ssi~W>5e4+iN z>*et55kZA5;?=R>9%dW$P)S0eMlrTyi3Y(YFRTkjwZ+USs%M5YDQ}FNrqGIl|9v=& z^jWR4ZbRzz9I&zC|E+fg51ahbzr5Y@nnLi{X(>Vj9nAlDAA&JE*t|ZBh{9AovQLhA z*1C=aI*q-(FLFh;x)3SFEO*&YDB_M&j_0%35hT*Ls^J^szp?z#^h?H`-4d(nP+@6m zEYPLm0K~f<2xn|5F$XeOA~=`gYDiEs7EP`_b;ZC);$9*;&-W)OvaGRJ(kP=j&h&Jd z@t>`3z2?jW&I5OvB?-;dJ+s;7h+~$VoDBC1+*5|kWi==XdFyK&=Jcd50h>lPyLow6 za=r!DANdWktZd^&Yl6NMmaO;|_;;+_&oDac4tcHXe|_RCb#>7!YYpuC@MC;yTXQq> zxr#xcu>P@RBu~%OytOh22D)0gOIFGI{0%cQOKmr#e2ocz9P@)393R z$_G^P=K>MA!0O1fwkMnTOMwEOpTzkuXvPGw8mjynOl;LhdNC378uuai_|n@_9V91yU;uZZPpwyz_5 zx^?>tgKY+G^|EKI^7&)!N^6jnMwHFd_lWq%_t9DEUY(aZ`)si}dOO<#_8R!rdUju5 z1Dn;^-Z#VJ>#fyRN4DfyxC;bTo|el+ys@U-mtQLxJ<=~kwb`}GUnw1C+j_2IA(%vo zm`oz+H9u%(iXx)4R>bgxRnohkzTYr&c#U~jQcw?Vpos|$#DgQN8Q%rL?sjz%JUM7m zS=5v534S>o2tXr4xZgy6a0#{0kcc=)8U$~HF%T5YrYJ^046kgraG*n^PM8uxDmznX zhElBE84#uE(s}Nand89_FPaBzxkFBRe)8WY0%1Iv;Uy(`w&_*8lAwLGe~?rCUI~EK zGF$ftmx4t^browdAgFY}EC-g$A)-{D6D9(}pT~pn5zd}CqmwdO#Qdpwh>9YIY50;X z%kArT%HtKdl3v(}k&3e=i)D=JP7Vky<5+kO*|V)gLF&8Lq)ug#nAC|=yfmU7Fb~a^ zn~q`>wTGiP4cMi5zQnICn%}xR1hOzSnFzcG}(vXpfA}sC&G37`U#!v4RS(B zK0Z?1Z^akI+A))ifj_eh(tiqUTX3u=^~0vJ{Nhxf-|S|q4@F||{)$8Y9$rpZf7d^E z2>Nji3iu!OwA{0ky0bQk3f}hqZ|jYMu;u&AvDR`-8jbn@007x25Ah!vNuV>!U(kF$ z;T%r_br$gERpYWeb$PYXEo`@b!)NV)HOj1{z1gqgU6~vbHU)0#xlAO)$~RCllmye*zP-UHCaJ~r zzE!pyuLYupc)zYbZbVmqA=b${XSY^*d1Hj&5qB<0&tq=X#d??SY`$tXyzhE0gFsgg zF?8}`!-B6Pkt7^~BvYb^LQ8fcZNDw?j^wYp>t_Uxx+lJVwbr0yoqcG=wv)RXl4y;Q z(5j(HS|-W#;tOI6kEp{;rs}YFW9DP)d##o(%fIV5Q3MxB8tu68(*VFl!_5F=0DyZ~ zRuSCrLa(zm2RFPXRpP0e!uj{OHUW3LNDbEttQZAdv$A~Vj901ON@d7RlYGZZjen1H zCY^{3pAo9m5YV@+15#y_3rPkQc%~qsP5KnaGjdb}U!NX8Aj}}JtQytIRG3M64q^cp z@@qB4XCoDOXpuKe$ho43hX<3Ih@?!erETwIe7juY?$EvxSxh9|lK1Kq#^%0MxXNBt zA+C~{vS(76%6`kkvVa#5XmyeXN;)qzP3J0#WX#yeW@&XkwUAz%cE%_(s$F~ji<*Hty3=MYSt=?N1CWun~qVxyF@99;bHFGS5uRl}p`k{6!W4 zd)*o?zpcC)6}pzl!VdT1($wswC2dV}maB~B_Zu1hZ7TWSvEUmU^$7 zr8$;)xrxb@7PC0@6EU%|hK3tRY+Vm=i3$jI+JWjI8Thepko&BOC{pE#BFtIBPPa;dmtPGoq1#x zssWE0nyHmUNJP}AeaaJ*t2Pc`6^_6*8eql~RWXILoe!N@HdYHHtuaRcC{gG*`mkiF zs4=x>bmPhv9*{vVuFLy2v)_h`lZ{VlP1`5 z)4rZHz{F2mKDr1A%KsTK?vRkUBt_ zhT0wg4S2rmUsvA*>$IOU5fCS;obJR02p6c~4<>ybcpX&Xu`6N5p~aIQZk^{xKf%Zf z|5c{x6k#sgoJF|a>GS2udC{Xp!yv)|KVFigd7Xg7!6lfVouN3)FubfKud}PM<0FY3 zVehzzm}*NL%2nm|PQ=-WoJMZ;BpvJ~aG0n6KPvj@cp2|Gx$gRZpT~}7(o5#{f=4bh zSDl^!2;A~0qXQU>KHgvvvgANN)jGDppjcF|#JE++{7fTn6ybbmTw<3ouAn`S64Ac< z7%Hnk6P(3Uc`Fe}7y``9NR#cpKT%RmWqrKo&@i3Rfy9INWo`uBW8r|LPvT>x_S#u+Q%P=vn2iJp4*d+0w8P^E?;&veuv0 zj2zJM~AakaoE ziUFoJA>H&D7VC@~v)riZc*aVs#%1-2RtHUc?s4s4ORyV9>z#(@Yo3MWx8HJi+t0kq zCG+D1)3bi4=WKnlv8@rDdfl$J(pt+NUrsuovfGkQ{x;@U6 zbsuwcRy;V4I{LmS*z93DkfOo{miPzr>|#*BI|nUXuY=Y>?+ypCFzVz|;*9G;KukJCF?ML#A&iEk zwxB5``UQs^pH1^JpCC|{|CdMysOFZ^fcSrqyAO;Hgch^Xb>t5ONQC(0U629LF>TFf zz$8Z!XTu(v$HijZN=wr<&T~5z%uiK(UYRfb9{;f$>)FD3*)h^6_7*?ZL@GJF;Krh2 zQQ6w=@F&)$Pd|WqNv-Wn)U=S#Uu3=|?%QuCRAI^_91>frxTk@eTwD|uVBP>(8O!?5 zZ=drzq<*w8Qh`8GS}v(cKqlB28JvA(61KG8)TltS%hs=uqjfA!h_s3=Z9bnqul%Ln z7L+)!`(#tcP@h4}j~MVF3wnmsd-=~v>Hh?v)&D;ioMdifbpumH zSmGU${TwZTib{bVDzO~C(@!vNhai^mhKz#jlTCsYWAyY_@eNosz7n<(gcV$(c^@zB zp^pS6V>4JFHECp&jqY`iU4!iIIF*{^thd8Rw$yLdd=k0kj}`{Biq-R-S$k=ZS1~hJ zv)20x%JBvDI)&N=IJw7^Po^f~lTuU7NWYp5jtTx25e54F*&k51a!dO4GDHk*p!IVk zsd;;cy^Js;n~&K6iJi@({656V=V3ATFMd}@E5{k?Qj8lX2?RPFL1T78)!&) zW{pfNIHGYiHY`c<$SLz2B#S0fGcRRM;VuGUGsQtxK1=!5&P@4Y-8K}}XWu(l#QVky zSW@&AYEQg(;zkszdj#HPl5;($T?VpvPI7zK}L%Xbqs0pi%M+H5)9sF3jlNX2VQ2?3Js{AlIT%*d0Z ztC5Bd;33GPO~2MgJWm+!bm75K+O>icgo4;&IbFWgpHh5eG)%+w=dOZ2U=znbsTRY7 zJ7}aXs+A~IBuo>j3==3sBhc^=kb@dGOxPI2o9g*32!lA46LN!0l_E{k;`vm>Sm^j& zFOhO2U$H`5O`OtTV>4T|m?$%1EM%rN^k2JP9TtTKkT6Ve&*LC|LmbcR; zoH)+=d6yk13;QHyO{Ql}q9O8Yif15*Qt-qGKG-Idml{+g7kQ(LM9Rmgd3q@Ecn*#% zY&1)vZ}qBwqm=YYnY3#D@iy29sNxq?aQyO(i~|H;vqv-JFGy z$_QFe9VP<67$*XV0CaYlJINE@nvD~HzrNVwp}6=!YA1#iL;MUCqo8ER>5)TeVSXYQ zhT21^oZM@nL>LS*YeEO8vnu~F0#4u(b*Lqf0JZKg$QBuig8@n45(8Z_3OvySo!Kz( zjt(_&I@Jz<2pl6Dpf8d~pdgQI9&L9U|4hOL%;^GQhgxBL#{AMr4By&gJ;McQB@hNl zK1c^S=aL7Xn}*aP%OB2%v)O z3su^x29@iT8i9Q)F-j5YzlT?Ag2iCog_NY^;aqoMgFlTDekoJ2L+8R-gDFCzjAFUz zltT(ZKt~HSxr8^ ziw|E=k?1WY6Cc`{!Yvr>6)Kihr@lPeNYSfNm#n@AWS5&vS=i)RApWLREzX8^%Q%0x z2koSRPVmtljGV~$LW3ZQ)~(hBx>eO#k%H5iC)Y-cpwd(1c0RF;@J%9+V&jeg4zXcp z{P0b7K4L`vF66 zm|xcP@YguLzr-6>NZpMO?~ICG_OT3_>PbwiO%0+RM$!Z}tb`$^SKX(a4CxB}wGYP* zbBMg57m^N(Kjlusm^-_zm1sD0j-)4tO5TZ_i9xKfTJ@1 zdF3huXqSVhpBVs{%EyWRgPd47wI|ab08KcM=txM(oO$|7k-P8=a;K6V|rC}+5z0%qp| zr3poqh3(AD1b3F!vw6MM(lE^{Zq8|_;u5C51|8sIy_YQkud+QK)1w10vsT8*tV5 z(!X8^JJY6J{)Eo(#ytC~iwWwWtf^u>oG<>3leEHf!!@{Bb7QcJ$*yY0BhwBJQ7B=$ zmpon~)3o|V>UUMq%dMA-bDzs9skys;!E}mpP1~Lfjdj9QYYiPu_r^un$om_&CI5T% z<(0m-qiEMK0|-RN7N=+YNI{Yy1yQ&^8!QA186-SuXCJwi7t9_v;B=gWTFHNk##idu zfEu2g7F6IaodtW4=z;*H_A~Kem}aExwO_M0&MLzx>xV>guSas=%5Ie}5HpLoFHU|u zh>y;m*Y=t_;?Dm>>Gag^<=yc;pjroc>?0s47>izG%i;Fj|3!t*{t(o6==C~d8}Q-h zA9I^*+Sl~k{TjOI zV6+EmAa-Uk!vw&%OtODZ2LP_(F8dn;f$81TlXXymm9P*1H3jl$5oa=}0WE$q<iF@;di)wyDhp|E{<}RNaf4BNIa`82Bx*f)H;&-xs`a#B} z*k2vD1vPf`13v|IROpG)xNv?!H=yZga32;r%4{7zVa-oWqKdx%EfD#W$qk)@oE009 z_escLNje1$_7t_Vc^uQf(#Ow!5a@?%YR!sYAqpUn2nL63XpV27IXWCAroMPxWWw2^ zf1z@C=6$A&l`y^BuJ-#;x{{7u?4TQhf4W@l?UnlGJBj`m>*ieakWSXal_nsK8tt%BPM+9qL{nIUFoia9aG%*@Qp z%&{#yW@ct)W@ct)CuVjWQ;hnR_j~`^-HWZ-xsXbybfYu$KVW0i;~H*JkU^!5dArfDS$L`A36_EX&w;>i}*Ti#A}+1}~N>nDSn0J-apzqZeUt(hOYYi9wwp-rFs zYWV8S?`T#}DfiM!!F83jT{Aff=owrXxX~e= z11;#kJD08j?MXJN$Ozy}6s_5Dg)LWd6Oc7K?}Xq4aAP4CCdkQp3v^m&&F1aYxU0ZE z;Jx6gQdOMfJ(s?Qj`>Uw-x|dUyES&QPPq{?Q}w;y42Ynvk;r5G19qWsM%2%{y%>Fvs~h z#}V}5$i;^8fBvN0Vzgbo;iX9>C^az?uVXtf=$y-GRvR!|tKeAtMydIs4FZ+)2se>Q z{r-JvakbK#uU@z!!crgtA5|Z*Uo44#&uUo78dEj!{6k08dv#n69z70b9QqVS2(ROh zd3A<`^XyTV36%xaeh)pU(3+; zFF&uyZ;f3xHft#aX&r0XJ8?MU=dTYf&@Uf{$kxn~yS;~OS4}9D&reLHrhdRi0E{vK zQif-X{F=_$vx*RQqKZ}M=ZnM|RaqI1KnYzkWeqBQ7cak}89b6=u5R)uS7E55{EP8N zv;yzVodW2su@i0uqQ^|A^U^An;>xseJD>cMFs_Eot@KFu1~&D1Y8Sn;c$rLS1m!$?{4F|Rh^I_I= zWCw-z6s#*{h*pGSuBS1NZih4jd0CG8NNTI>rJqYF>Onl4fO!ZA2-MmLvFJ)$nM|k=NCf0P z-mgt70$*24@U}Cy3u|=e4m9m=WG!PoTa_Uaqvb#JW;p{*3p&b(PNnv< z*D|&xBVa2O>dvKaJ^c)aT>W>+kmr0`oNh&~Tq?u6PphWg&hV+~^V1G!CnWYAq;b zHt?Br=Z$byxHoiQsXS-P#LvcnU9ykg4EGRVG{p&g;02Kx@tU=sDg8CNm2O;8(8^MkMqqm7HLnu$dyb@wT zJwWRdvDy%ZcF_&0e55Dtaz_z%%%qwnQN=1zj^)&@Nz;mt?OPwg^a+Y43bk@aC^U4r zP8DefHZswiRyj6Tm3_&^v-gQ=4^v_Pq_%Q$h^ovd=mpfkzWW-Ep?ZL|jJXEGZsN_8 z-$^Jy_aDnaQB4D(C(Tv)qQxo9=yd#y>Fh94T;*%2oG03uYz2ZN?d93E5F^kz^<7pJ z3~W)VjG`P81Mm*fFN7s-p|0vncJmXHDPnxg+HqQjndBO&GDa%xxdS`YeYz3}(IBYf?Y-%L8&<7+H0)1`;gw1J>70x5Q5-J;ap8AHF@nJ&38HSf3J`xo%cUy^Ew( zM@-Kv-D>?_*BH&e-P#sGwXRA-nlo?{>AWv9d`w%{t}o(qyH`(fpVW7HYx?e<4x7va z_HNR^3$zbdLRSrLT^if_yVhl+Klu7m<9jc2%_VZpeyf#MrUU2)r(}DUYGIR8GXIQ$ z>SuZpNRX#mI;ZH-eGI=Cus50xr76_X!!)w^B*|u6e@`?hV`4}gDsgPqK&MYnn61q~ zK47H8TPRNu9m7SXCrzCvzi2jxH67*+-3|^zrs`2>Duum+_<3DKd`7Q^GNasgaX(v7 zbM)tS3>+6&b$+EBgly2@e-irEI*np53yM1saeTEt0AKJV0bZd`&xz?()A|`g*3P?c319BTaC9m z7)10?F`R#p8##Fbz@X@;thoOKq*g@|RC5B%7c#^i56a3%B$3~1Gq zP3RUt6L>(r^4A1s>9B4%AtQnYGK)ok5TG+350{qxx!r4w-whEO76{i!PL9G&IgR?m z56wx~cvM)(2_gaG=k8}h%#ph@6jRC~R?%Pz;TRQKx$Qp|)^z^3#?TbScuL~bS?n1C z0v6F`-@l`a2%WD31NwA(htJ%yzC|=P(F$XcKDxKPM9(eWJajB>PERM}|Fwqlo`lE` zhX(9y$;z{FP1lmmPBJ6+AtA3)L_3j3ci<;APd5PiS?|Zx^o(+FImKeJYmhmSNlBt< z;HGb9RYh(Q85{^KE+OsuS(AnFtgB(@w6M_8+oOIl3;~H)-G3cGL>FwQFLDTJ!V!=Y zIeGZ#j*%@vw*r3(%b`eEa%7fi$kH=Z!LkRhEHLqSoHbr*}{i^4#% z3M0dNE0-eGvool5GeYBe2Vl0iaJ9G73-==hg-)I|4q2B^sljA$Fu?ieZtf|cS|9lx zVa-jMi#)KYQq`I|nVefNk%t#|elH+Lh{hmVd-=hnj?)=GW4!LS6hX3LZK0GNZDp5F z_Z}g8K5;<25yEQpzR)^-BAWauwu3ak%FUW2sC&c<6G@( zsZAarJ+3=d7AyE)a`e_KJbY(n-3>aur z38MSB4^Q5rlk={ zT*aei;m1#(6G(Bs(3k|e84*NKIH~fX9ZZ{k3aajE?F}{JDAA#`@+c_Ygw?d>9#{U= zLyUHZ5G099?PBc1v}vs8c#IS*h3ammzOX-S-xFn7@w~am-|e|9CgfXQqY;A0Xka2# zWA}`pZa}^K)b*ve4RqH!SI&L`I^A6O;um)dT7AFB17p7qGzQ*blLfTj130Cr5aF?< z0hq-#Gi()w$)UBtpT>9511Lj9_#*jGp=AAJn1z;SOzBF}tQ6VK>ETu#(M3H}p-s7T zN$97fwrJ`MqHUI`_*1I+S8{z0jyYmsxQ8!;Y9LOWi4v6rcjU*xqH1FLV;CLk@okTM zuq(BZ?4?;*W`m6VMCu=%txQ={68^gxrq&qSMd;s*9DftCasD>f)8js5^zme}a4{h% z$_hu{R$6##=ZY*Hw>j8n#nG9+vtSqo09)#d(0Wbpfs{^%Dl=A^7 z4%CF9Ray&TBo37P++xy-5vmBs<2rcrZsz4FBvA+TR;6MSe+mkQxLJzD>8X|~8H&Uu zx2nKX(^l~EvEwjawFcUH?*q@21!#VI1p)wJh7JIfPTEf(%U35W-L4>`V^4{}LrI4q zLI{fk;{UOnTO&FU*2s88!~Q3vt_4HbSTO+m%vW8%4G8~^Z0nhx55R|y_r>;JTqW{d z`E_a@73oGXjQ*R7Y4rCr&VUq92K}Diqxc)G_!lWHq=?xl1HC5pf|HF^4~B#?Ui0WR z9`q3BMFlO?rN0a8Xc|p)89C>gU#vZ>+-k04opU)Q5vZbH<|q}dywZI0oEhaTR=2Gl zdiQp%f3nMLNYe~Wt@b!QhjOgRJK29yOpZx*$AztvAKPx9sS1dTd$1Q8eX6u70 zzgv$ypxl+s-H>q?Q-VzjLEBF|*Plu8)J2wLx2!)lT=fmXd3Oj&Y8I(YKPkaeX@6~$ zY82c^VQ!>G6=Z{&z$k!4CA9%XUsYdcCovf0Aj(32pdO=TC#pAUQ5efWajw^OlItU$ zHKM`Ht&rhg;lxRn6C+(Rp^arncVX{}i?;l?<-`9A_j{dTdY{_P4V=f)>>a^S%q^4L zB3AY6Uh5ty@<+S#bK=Kq7H`tlfzku5-&s27cn?2|aMsrD?Lgql%w&cwqNSWf;i1|+ zcWdh>0#j=~KyUB80`Iqg%O5&^J^vjudKtpt`9916GhK3|`gY6ro3&F__dVBKXnqAp zn@u%7uxE!Z9Vj4J&W4i~0FX}0P}w#%mJ;4Zgoc9{28KXTVKCYxX$j9G7qBEd2`!GR z9IDZwiP44Ycd|@$^U-<4WZx{LpcsEYjvY7dz6b;^cE)oM$kR}u3BN3dop$e2ADE&` zQYH)3dAa|C+%Gy-01Sq{8eg2KlhOsEy#R%QD!r|IO%KXMa`pM!eacmo)>c82*C_6| z_nhQdv><204lb`f^wHNSQ>uNqOIC?D&*&HYznl8!yqRZXK0NdGD@a0(FvVwtE9Da^ zRhZQ+tw2a1xMK|3-0m}Zvoz*hRxY8j!Tfxf3Ypzt%(zjWIs`I{12acX?xg~Iqg3p@4ud2}aJX7)jZNv3i2q)y5zekeL0osPSNJ024c0(Y_6Mo{c}DU}cx zv3j~##Lcfh1748++G;NvoajZLHXbW7BB^;CnLiLd5noA#b1T)Ox(Zv)y0}KjoE>7E zoDSE0z~AJn40lX%B?7EWoMcF<7OlLs9>uu?Ndj-DV_9UpV9sb>bbSh(HtdfIVq{yZ zmw1(kdmq{*^FGbDP}|y5@C0-O3r4gj{c%=@{4NAgX)`heQt1al0j9L2s1Q@GcyxX- zY_A@m9OHi(K}9!hm>JVymvKv=h2xGaEt{}NwhOW${-xySfOJJwaWu{U;yqDuAE`ih zuv=-}*{kPYi7mOsg++XkEXVW4UXj!Jyn||X^GzSMmM5?70PFzeJtJvc0>a%#REz`B zj-^8J_5)?wT)IrqUrH8epv}Txs)os2p44a48YD5{qPR|k4v|sejJ@d8E|^s2jG4(M z%(1TdsT#nLlhfJJ2SVfNF09xaLHbSc>eS=|hiCZMx^_`=Jd&ydAot9oGO0hqWKz@CUgV2ZJqOpt8eel8 zADFZ1DMT6Ej650-`R6Q3NoD6rSq^`HK1KK&ZNmW}(7fX0RbC+7LDLSZ!gj8rPl~_` zCxazPImkNm4?V1v%^st^UtV(wrK6{ITSlM!7;|f!#q;flVatl-lUSr zMe0G#ALshu((04!32%Q_quU355aI)dX}{!wS72;RmaWXlyBqd)h>~n`&LE+}<+Q2C zS|X}PB@MpK3Kpp!U$GJzswn0akk5m)Y!D0@HIi|y;0?UHs3D*d=kOAYupgSgOs?Yd}M%uudCYkm0l<=reVm~oP0hZ0g^5ymd&duG98ANR#! zYp`tVd^h0y$8w_~m;hKwkF9I4j8)^{Jm;U)mq4IxPbdHa2gSOrJ{};(iH0VZHXQH7 z7!DVa=0knM#1IED@C~-dDK<^9ASEge!=lChrOlHjz9UK+U(+62Up)H&RRdP`@tYz0 z;AR(Ey_Y{|?+D}TG16w7O#vYJF@e@ExrEd?VHn# z?~}pXIYkQEm0cr|;~3QKm&IHikFBPF>5TtlTyL`S%l&-14-Fi+WD>G6V%J515eCyK z0D!2stit8;Ejol%DzhfGifo1`Iz!@k-lq+mc)W2j5v&lA4%Vg@bNLX_A35Osi zNzjt*E$maOcX8~;A4liV? zi5&~d3?(OnrxBuJLVCaRU~Qj5RBo-mFY{rqnuMcxTPToAqTUBQI@p)#b9iMQXEe&t zS3cE++!zE4O6s-p>8rS6E!?x{9rGEq?6ul=*|%)u{dkXVDLMXz+U77lH>I02ui#hH zvgT{sQe!@M(eRA6xsf+xN1~_RzZo&t)!~qZW2po$1ONa5G1UYF7?R_cd+Q$2ZfYJJ z$vQOwE+~X!qtQ+*46|aN1Bn89V=tbI4g3c@<2N6aMRticPJNaZK4w9nZyIm+70&12P28`cR~KHN z?S^j&_t{-H8}A`CnwVcd^e4>14s%FHGBmT-QLuz{`x=jGc{+=0ne}Bfa}d2|{J!p(3sdG7M)6;roU3v+;Qm0^?a^W zI#}5%wxLE0S_~cx4vm3{r{^lLfWgox5d+t;tG2U&=tP}ALmZZ|oL`@M&{AyDC;-_~ zlG&DOKgagI&-rNdwY@)H>Vn$JKz|hv`w!!l;T3}_V**A|I7T(g9Q(h+hIeMh7{`k& zH5it@w(n>UyQRvurhE7_t;|H1?sD23ec%(HyFZ4r-9q*MIjWm#ZC}rf62wzel+9@R zV%cQ!#W&g_%O;oi-X;LF7m{PhnYfmQW$E*>;wnE?*5_68WPf3>4pN!XH3^8hQ0qM@ zsk6VBv16r5@K2wtj-hBY>^mMC6^{+10-(iO z0LT`dR;E1z80}aewlQSr-rH#%0IF6@k~=2ayDKlnMUQJ5oKX^?p_;8t=dNZr1XdBB*=7dy-$@!lH~Lzhh*eK&5D?oRv@ z<{d&+lzrWWaAZaACRq5xsgxwF_A~F_(ami%<_K;Y-V*GJ4Vab=zxJvL7=hbLAJ321 zIB9WzX*>_S{W`OG-|>B6jP&hXgj6Y`uvnOkXus>Dmn1J`*flN};Kd8WMd?BeV=z8W6g)gx>fSZ$P|$0x9+ zu-@+WBpiTn5x(XC7I=w5=~RqT0dUxg?EkSG1TsTgeLuhfns4t0%%IM@g5cMGqxaWe zaAgJDcKJVpuBbF#PP!>=^r7RmA0h~y41f#)fC_K-qk$1^gntuEjl7UP68Advnf%h) zUhLi!*T`$4%VW}q;Vmc1^wIJQ@_v0wQk3!sp8=$pkT*90DXsc70gfKDgANu?DL3DFi9f4-c$F#7_N9Dmb^{W*bzS<*P9eSz^I#pD zI2opZPFR*1%@4%LnXI0x810Or<<{ic+^PbMhzyN7yC%cE_vzi zhSnC|Wip9-GqHWuI4|rG_?S@%sUHTIjPR2OO`iG9hn4ziK>`9ZKDZ*RsA(Qtp*e^Tg|_CEe5rLDDChOO|@zjd|olNS&M z$zt6UflEdBFtf*)f(2`$$o?S&NRAq3^9a^=xo^X$5W!$#{VXPO+#jD`$KuLpDuJ_u z7y?LnO_MD{kXd^dk|o3;Q?cxilM_e;ZRhO9h^N=g`t)RLv|Ngtl-1uZwWPB&KnDmc z;y$LwP3tH$Z-ia%?{zdjuITIUwGu3~xTA_CVK{7`{uFn{s*6n(ryLi;N?$c@sUr(s4z1w-mE?Bn8-n$ zvidb@b1_1D$a;Vlw9EBYFdd^{+}gwx%gPz|ij@X^7@)Lo$(VxkN3}hAz=IFtEYdJW1i)kJ0xB$am^QX+c z8>a%TrvSaHFF>00Vo30R*NS}bHU+AFmc;vUzXJ>9`ZIws;yqc7v(n0;ppuaI^ej{` z@h%f}A*%IB4yv+<#88bT$?Tt5(LUK*)ExQB`z0<}@vC1<@K6xI@4_(9$Nc{wN66I; zfPc2taBw68h>N|G64O$SGUt$b@l z7KCYZf6R*GPQFX5cRw^DKdkGW)oQC8MZRH_vB}EAgz>$}Zt-`%9sa3EN~mpgN?Mg& zp;nROevx&v6y209d%JZLlQ?S^%AhGa#rfQk#{nAy9fUl=wjVhqSK;jDYoy>!^YDQH zkj9fU{wG$2Q$woFn#`mJIaTXv3ty|A*ZanW^4F{G10JP*CB%!`IOO?G$HQ-n#9BD( z+gx-G+-544FS_)_X+!ApHt_UiQibPN2#(E!@P0dRJe2F*8Eqz*kF6=O0rzqbRZ3>nGqB=4RS?NC!NH4$H&qX%lcPJ9 zwe%~UImbFZI;lh0yaZERodGA;kCokfKVaNzc52mJZ6|4 zM^><6QxhW=Vgc&qV<_#hpeR)##E>XNcu%_V)?I~nHZ%?UTeD85I)QWz)l!XOR|XfK z^qm@Kl3IdtYQ<1Ww0l&#x=!ozVlS7`b(%L&S_&X8=x{YOU4bG&JdMcZ3W?oB0yiNV zSL_VG%t+Q;<$CkAAEy5IX(Eq{gT$at%^o9m6HJa`Sx+9Qrnf~y_hFu%DLhp=u~2#p zxeTAqfKx!Sm24n^t)l!&UA+sc4B9jUVQ{lp#LR6Cil$PYQQlZRbI55m-}f9gUp%7i zIrp4#lW(HnY%lk34_oXJOI=Rm`9{tt_S|QA%`H}EYyT#lsmT34lGjqfmEM}X8ryeU z!*krL_ll2?HZFVHleY_R-@AaC(H;9Iu8SL4VWoWT>wO$z&&wENYXCS09JHM#ixy{~ zsITsgH(RUmr!U6>w#T2!SVhL0L(){g@cThT{KNuA`$B0KKZWX%E(S z@g5NDRFeVdLn-y2s{sH|?0@uKKkbP}Pg}>Khga@sEx(Yzd?koQDGWP`ERPG1gB8l? zv=^8Q(2<4fAr6r{*KhxZmnu_G;pV`_=uYAA@)q*|xO(G3VHwR{qq>QrP;%!DHGGJ_ zlv6#RNfmZWJfo^?$+VGm975Jdr&P@MBzjc(qtNB@_cacx_A$LHnZ?84z19-uA?gcm z7IFaSCg8uE0)BgM`0}~#^UVbaiS)l0sSB1XMJXobG25g$ybuEckd<_>|5&DIuGCej+9-NILkh|)OCSV6pzvp=E%1jMIx!+ z(;rG~(sMoHnUCtsSS8b{swJlVRSxACMEPa@K~9#Z3J61BrTZU4LsLTLQz{5-lswBz zR@VW}n5y?5G(?afNp3HgER!Xj>SFl93wz3$PUkOZu_~_4a>ml zS&bJ-Hk(WL0@vZjb1OP2g_I`yF9qr;K0NRuKVnXMue#!N&)c47sw6*GYrk=~;i-66=xwplqjvSUmT&F0-CU%POlsdx(8(uCaYCz_ z0mlO8<%Xa>L-%8FmWV<`2AN&4ym7Z^Ww`|xM?;)NTn_3oqn zEKiKC;!6J2at@rETO>%uDQ3=Vhs1{-Auh5jS~_Fh7&9CQq9WE?DNB-k(*cvGh?nauhy?pRMPAinGay0hi;9g3@Mr* zGE9*ldleJ6o*@e^Xj8pH>D+rzsMJ(eL8QnJe{P=%Y*~S>LOB`qRdC37oAA7_a>rkB1n=O^ivAqALQ0$E`TuJ=Krz!GAZU2s9^=r_)}^= zcLO2ClfYGdAYdeV*Z&~V$G2lfwkb}dMbRYz6!nlQnw0m210Q&7rzGBV!djM*qF*-X z5&3Sz_+$7EU-+w9Tb=tcQ^wzNV-;XDX zj^_cMxxQtm06>x$D@8>jW~c-}Dp;8UJ*YILTc)xCSO6i?J;+MWNWQY!>Cs5A&{%&LlbG)ibFto91R<-N6p0mbiUED%^Bgcedb zi&0{Pdmt6t{>JvuS~F!Tcp9x*!zsMltTn(WDi}V{ENm+w#?gN5>QUso;I1n;<02F{ zH{lS|keFHCl1hc7o4|&Kuoy-+Ee#%?gv3{&{2@&yWgP|;6pT#fq$FQoPJw~akSIONQ)CgM|h#<-x=g6nod{anlNVs3!jxvIx5K<)nGh{vq zcpC9VXSWOI(5Zn|e`UCdsUVs=hF{3XY@}1t@*9@ts*PdmoLA_rgeQpk?KU~32{xR| z)p46NIz*OK$uYQT({s2z2h+^8H+%7tw$%6Bo=p=f+XEcR4GMMPniYAqIc_bxAG3Tm zuusIk-yuyd7aS)!B`ZQiwQoi+hf+$2@hHbVL1>YIS695t@bKUkFUb2gyiFpX&LcyB7?lG$Lnnr4Q$YtVc28Er$@^&KYmb-B<@As(t;jhJy-z3 zRVHLq(Dm~1)q`jAPEbV>l=$|GbeOEpN#x}8TE!?NzB#MRBr(NoQh#pwTcr%BDb#%Y z&)X>#We4vZSeqa0%=(@R5s#Z{Of#NB1{94J54>;&9OhxM)L+|bam3Ole7+UX++-|d zKMNeJy=_-!BpJJ2(9|$?hirS#l*=2(sMuP1~p49AQq24u73o zz1|-H0syWKa*6{UaIcV+LNq2pMeRP9Q=$#U8iclD_;}zxuF_Jzxs0J1mE?wK>&38u zu&PemcZ1!%H?4+mG?t#rvAgSw(vbVgm~f$V1o_5L1&AUhSx`d!Jjchs7n-~YFYt3+ z$!df#MBrPGNAx&J}V;iCWm{c5>xip(h_{6of*e_RaHFUhu=YN7l&hM{>NB45&w`z-D* zD9>MTk7H){NX7d}Zbu_WqWiGdW9QJh^!M3d9o~BN_d)~0R*t^BW`kbcQ$PX`AVsg= zor080j+4h22szuV%k)VHdpHHds;NhJ@p|+ogH7v&z5y4zVh@p3Tk4;PytWs}$$(Yc#THc-a~+zMfkHfU#$lk)foi&}m(^h#|%r{UbCsW+6Yf!N;! zuTBoO2I``lNQ-E(olkd@9ejP;UYFW{WI;dx)#L6nRkS~$M&!OIg|W8)pFVF#{UT_= z`9du>SwaDPe!r2ROq3kZNpIsh)Y#eUp%>-mNB79g3_5(TcmO@#e|)JkgJFWQUIx3= zP`_=BK>WZ8rn5p1a}PnHfJC>7ccr6N!hFC<1;7$0!i*ppAlE`Bi7J%lc&2!=7iy_^ z__(2{z>kQZI-`kbeOIKaB~9$$2{qq)OzE zO?~gNq^@JRC<(hXx%6DDDj6dEdri@Rzm^zXu;n|GXV+ff*|Lnt`IEE|f0qA?Gpz3?wNF`%__z!YgW50kfmIi7~ zj+`cPNDMXR6ilBI^3<#AS0)^)E4f0k%R{tERFp~}F|~?MYm1H>hNlRCtHsq~?r5!9 zWL5l9z6MjemgrcngZs*L-iE?{jhb{I4p_;?=t8E zZ^;d}^Uu*Xw>H`)OHpU{T<}7iQe>$m)zo+v*MEhvnC1!zUprZ!3#bv`OR&vLXpWj} z;ML7^IBK#TF|jF9t8ldppocdTS7*vsIyg5X z1S<>0>nZ4oSZ%~p@$$A~vFbq2izNEt>BamJg=sOd7lA{RN`JIEcKqXCI+!)At7~FC z$h&caTKeAeYSs2gvbXcBzXv-1Ni zsHH~19lN<>u8LSE^)A;?{%=TyO{8Gq@t?ih&Y>R%bK3syQGtF+>CzHlz7@euI92N{I|SUT>oCh!n&?xM_YTHF+dtHzFw|BJ8gu zFtEt*tV+}kEF8+BnVvZ5Nn?>=t~5CnI_Y#yqVdo;=qZJjH|9nCP~gm2pA_x(NFb9; zI#;r_+oHNIWtIDjZwdO4i)=Wm(oGe=4{Ugo`kDq(BKvRFi(jRTzw?ztzkY~U_Baj& zGA8mRYIwCk;o)Lqze2+UnSc!(tw(WsJ+G7Sg~1-$G;?TUrFMnNX(&kga42lTk_8m% z>M7zIb|dL50mwRj5vb1gcjt!dY9eHG!%?E`JRC3>C98$q&~Y=vuUo`pe&Ay%Z|s&a z`(x&JYcmAHo?-7hwtTX3MA&ql1f#7$XQbLp#+nlw=YL(Q|F`iXEjBGE>X57Tp`O#% z57Q48LFw?r(CSw!6*x8GnBe_vQtNRmdC8CGZ%sj(d=q^{3T_Cb;EC)%XG9$Ud{e?= z`#n88AYKY3LX9Cn04prOiHMN4?A2MMl2Js6J}5*y0xV~f8!Y|w3thT8k@pAJxbVHv zm@_oVBK>uhzph6azYqpoYu-_(#)Sc@egv5cdr0Mrtqa}@KJF5Ij_t#Cje(A&pZcQ?_!Io zcxrY69BtH)4-l*_Q$Nvej`Q^FrdJ-1?hzm1{!6-_ zfE8YbQ=vcA*ecQq4H16&+h9YPCWAx#*K;ePk~rN9v5ctx^NF{0Q&aB0p%l9rlgDr-iDJwPX07&1cxVIHQjiay*GnW2uJ z8Xp^!Z@>!W$l^twqxvS{+u*Bctw2aD#J=ExR6PZwUCI;D*5GE8L3JdBk&{3=6MHq# zifG}k?5}rw5H#iOHMU`sBi-zp^9gY}m__^fF?CsXNZ~?Sf77_nB}YMvB*-x_GPyJB z;$hWnLj&y7ObGTMW$UTdC!H7v01{fROio1>E)c~Sz6!!A%dw@ueH5nH)a+7Lw)hH{ zhKs7Lo!i#5dFGQaLaq=f0oN*Kscum zf7deOQz$on+DA#0uv3+T-(V#PEc(pwTU&(P?J{Hn>p~8CNhXq9mhNFy7oN^^(sqXB zI8N^F0BWm5&-x(#Hd2?ET05}?S1&kcZC-aP(Z94@hVD%$L*no*BngGmKEb}bK%VO6Fx|j<0 zP^zDIaF6w5SxeBE5A*1X25j<2Q) zyZ33S3hIn2M)PA77*B{u7uMd9=L7>l6m53u|LZ3IpCMh^p5bBU`c*D1`pv!hga;NobA7?JNQorpR4-M^Vp{NeHwo%8*j^B2k9vr z(vFfl61u!w2!?fKQrt^ZpbN6I48##$)x93USDSETe2%h`ly(EWk!>CIjsC+=4#B%TW&8dk!c!V6!F`65@?go1dJV&w$Cud zHlO}Mj#l#y2;*U;>r2o1+W_1yXG~#-Kayq`&A&2X#$;{vi0~DF3h?G7%>Hc+U&V`J zc)I1Y5#(-tr)e*K@jTTTw;8A5Js*AZ1D}obvW3)+Ken#?Jx!!SndVU9u}+TBH~G*| z?GXej7{B(f6e?Xa`CpLxfAk9Z|G!2a>fx>7NJv%$huee5sN{4?_Q{@%&iXsMg)E&S zS3EU){Lk@wYl0TYtEEGDS*NS3%`?JYIIRJC^xfeH^U z*7A8K^3vHnA^fLZj%N4(0MlTlr^V>HeGiKoEwvVJAdiK(I`Il_w^L#WV_ z3}u(FodgPIZe-`yK=iwE&UB^SfXpGE&l)mQzCEhf zUH+ssDPlhUPi+tW<>xDpLekRB|9e0oM5T(f5DX%bQ^4^^ey{id6J$X~QMJBAjU++0 zaORfn(q-)VOVWxi=g0#WD%4%%B_8P#e^ zu6j&{wU@a^uT<_VHH0;Sye6apzWd5ve1^AG9AnHiC=gm&O&!rmCEd&}6r+^LjZu`S z5CiElpW4l-!-_`dbK-zjwl=$f@%@kImoCy?hv!4<{Z7%cRpw3t4@%3L2i~IQ@g6%_ z`_=8(d9xm9mYF)fzSdpyO5?Gd?;*r@(rJI*07eZeSlD8&plenBl>P~fOb&Y9Y7_+P z?;6ZJ;xboONB)@K#OF3&v7SZP=`PI+92ra2ufix&S8dIf!45)PXwt=C>o5t#wBfVi^)>g2_;N|^d41es|Nx}WgXXq1Mq6GL@kYFBna zUvIx|Hh17Qg|`Sq@H+cx*N@7$q4Fye@RdnRi+1JS$xz;uxxcloP$Yx0#eG%}jlt8q?%AeaBtbC_~szeDaC(iO)e zQww)0h?mpWa@ z@2Hqg5Qarn3&tx5X^u5{S+OSfh1C~=@XZpnzcEu9jh`*vMo-?oYG~prrDMLh{^YR; znbFdYvxzeyNR1Xglw5mbf5i?h=7h89XjO~j?6>{Y-dW?0^{wpJ>CSYEOarO=jxKaz z;{{96dMBot&H7F#Qm47Ormbq_CO%1ppxYx7VUcVZJvrMG>cqD)7eTqM!oPIaeu|mT zJJkiqQ(QsCEBqQW)U!4V9BF7|d6oWx= zb@OmC&$_>;0|kByTGWBdrHZc7Nm3zp^TFjnp01$)LQefsgNpX?mCy4R|M&u7da0xg3N;&mA z!81z03@!|W%-3P9l1k`bYGHnYuZvW`p)(jR_lk0KjNe5Pz-z=4%h*N1NQnJmZth8L zpyhS@J3L%~lyhi8I;=`5Mqg;fp*lo*BL;U7UXHO!qe^GAh9@$%SQ5)ho44?rLXXd0 z^W>_tcMh)N=g3NJg=?ImX6_%_n@tuLtv+cNcU!mD60ayf>e$HzMBUp*$wY(zf#8Kz zE^Vd()@$ltyW9{N2nhSbQR@}Wq|nTK64E#*{Zm7Ru^n~XgdbD+LvY0DC$6?#DA-y7 zKJ?_R=KkbiD=lM_9#d(#kZ7}S4FGRRo*SY50EGdzy`C`jUC5_|^QlHfQT#6)zF*iE zh~0WE+&}@O_lN-?(9_Eg%{Q%4=VwF(*%G@pGIWdrXjO73$RKO8L9v1#R9)*p80OBY zy%f6u6U7lrzpvT(_iw*1FSDJf80hn;=$0?meN2j*)?G$9X0CD~J2xf|DVnlw8e6%d zR>()7=U3enzEGT+sAVT}Y!wnB(R6eaFvPf}8L@QVT2Umoq^dYrt-pp>I=N|PhFjm4 zP%kD`vHM%gr>nDcRw=j-AJgL}a>R9LigOXRBxm(XWApxhbiHG6BwpOM*|BX~9dk0V zZF6GVn%K6JiEZ1qZ9AEG;?4hg_o>~gt?dup)%~fv`a0+Qbl)eMg1cf%UZEFzO@LYI z0V)OTd$EF^Y)B4*mE4i{*f>-L^p+qlM)|4Sx{4O>X@cOGWrmpm7EF??qdL`eNgzd! zH2oYMUM~;#w~|;F&Ugu)g<9J0TvC1MzrJ91)Tve$I(*l!;GvB=`%0V{TLA#W09NQY zD9CK9hc*lHUr8vy2)MQghN1Ms;)Q2%0`J3w(T+OMHB+aHc%k%f!CQ2jC>cDyyk6AG zvRU?_Mcx$QTqmaK!@!!Cl@)9k{+Z?Qq*~Dg^^7VI%0Y)B)VwhlpNySK#+(J+GLQzD zf0tZKMNIhaG}c;zQY#K<(nJ~(%Iqq*>2T6MA@+_ihi(hfm%3DNu?D#sS-f7>UkZo~Ab zDE4v#51`7=pHzEj|7~)c8t;ChE#|8S@G|x~=bl^!q`$P|C)DA)*vFzO&uD_e-7^!; zENlphvk(7ldialtF1q%g#@`ARp+&Gltor22F0K~G?_6qVu?JaSm|DOHRme@h)v|0| z53xPOy&}@HBTY)>%|$d&J%Y=v!9B?Je05s{#B`lvfIt^v{6BHs|E3c1W)H@|SpayX zpdW*U7b-evE;2~5Ao)IT;lU>vICS3Zpk&SV?|tRJ=+&@gd-#Q`mxjs;+t~Pxx{kWt z((=P2eDk8SA}fYe3x&aS&o;kQPm{7nUVRK&gb+p)7VEtdl>^JkfzvX#jvE3pM1P5%r(!KrbX?osfipg0WgA_ca^D%F{e{2X@(e9 zW~z}5T9w;gEf5-Z$@8k`5xq6gAr#>BZ~cTqfSdv+%<{5; zJ^928`d;i1NbSv~mTuNDOZKD(9~>JZgkO=mLhpI2(3GemB-RF!p= zT|w3D#7-jkM`Fr(1M$Fi?AVvM-5*j$|n=J4%9HlN4prvbNrdE8sj74+%@ysQ8uRV#S5zgp# z{xSZ{H-SN>Klti!0o4p?|Yc?z1iCW*?2oV;Dl)=Z!NS3H`2U zAhNSG5<*4-9ieQ(i((~cp#A3TiIGWyE)#ro!xG1!X^noR4Z61b}&Bhu>2Xq0U4=27M845B7B`*5CIB82gXQ4D%B$hHrqDi0? zjAW#LYh$inyLFeh_#>fK!o7~hc0O6tkxzSF2Lnl!m1EfT!&<*O9wjUqEI>!r!bpKc zb1#7l=#8^BcGzf~CT5<3CbUi<6Y)f|9%=YVkZr*&{W+7d@MmJn>oM_bqrvjAG$>AF z?Xs=i-|ejuG#ot(r>rk1*v~XUQM|2Bw+Xm7wsI+%F#f9%F+b8I4W!?c(|dXT{ygyU z!FKc`Atvs%OUmtTerA+C9kfd0j4I^;^Z6%1KDd44&2jOKL+vzBdxY#z8Y<(N%#Q8s z*OfAix5jkuVvQ+h_@p&qQVeR&f{SWxDyG!YTFIUgy?0+cD%XrjOxVam~?;rHS`f za>FtJ^n26R{qJC9Bzy6LqIOd?LXve91=E^hKBmLgEikI=V(ybopgv12boUMjT`&>i zqm%-B<*8?zcZX;`r){A*Z+2lxBpGiLsp!dia}@HziJC`3{W1PW*o9N@!&;h!|MMXs z&rQ0VNa}`E-ERD^X3v*aY)N=B3bp_MHj{Y)vyOUE4Ut8PfpKXPzKkw?Tb> zCIJ~p%;DqVqmdd&{}JNoLNS*Ue6-vK8TDh!6z{#f+@q(h#B3HLij6>_I*SsiqI78a zIA!FEw+D_2GuEPk)G#HfC-lB+xmt;q0z4E`1Dc_wCo?`x8dQHg9Gz64chs{~7Gtq; z6P-AZ>NFHgR;u(c%Y@T1CinqpQ=JF2PwyiM*aFjE3m6sp;@Y-tRE%_M37CjTFf;IP zi&8=2Y6Lv}i_W>u7>T)w>1vqcCfnandEhn!6kBZENH_EH)&FdC9q@BOzJtE$_*D@$ zs*UFm#&)p@u*b@jyg%zTl5#siYz^AOdea=~y>(pEG`6XE>!NO{Vp zkg-1m%70i+Jxf)XhK=s>Q2j|~FOU6o=qPRVEy$z_UdZg*a;JC5EmtpA5wwzQZ5ypN zwB**BZ9WM#!bQ!}7mK-1%z*0cV+ zcT7MRalA%YI@$1IGab5|g0GGk-pw9#XJ&7uy8eielv(bo9rPxBXbH*DDo;T} zOTyuV)fW&zRa7zk4>`8lufP&kr^NwzSx2q!du0p)J@N87l;Jy9dM~4CP9LIju}X~5 z*q->YEz+#=wInl%fQ$^@7VB=g6oir%0zB;iyk{Wj3m=bC=;)H0L_MlMdg|YDWfUET zQ;&7gP4rH}YIY;s>?K)z*YEo%FPF8T4iI14Y?_JHOUnW9006TAxQ?W75DpVa#7In3 zI4pwSaG-4NX`M^P+M>;!Suzeh=l+simgL#+`HT9P$ab|M-x9<8S&)}aBJ&|DI&!^X zQ#QPLp>{;nfRkr6I<#f)yL>*1#Qb}aJwae)1VQ1DN*If1=~wPEItTq#S<>O@ zxO};|N2g76RH`VC$nBkL>?8FlnbfVx&jW51PNexU>^ts+X!CL9Iy}1K&gj325qB5f zs?chU|Gepi(yCQZs^u*XC5FM{++QP{YrCAr%1!4-)rxhBmz@g_>=@6dwzZl}g<7Z= zEnVxbxt9YRyVz{)#4c+has7c>GT$`T%;N{FJEa%)i-MA*iAm`Ohd(y4rnPGz8iIK> zU{*8eZlObCx`~UOu2KChtM_c*p2C_C6=yHI`WlP-vypjm-SWX*RoOJN&P1>Gx^B6* zD`D^xk$n{b26t>3pC$|%Ru=h)sA-;*U?W2n)d=SSx-)|fNy`UxQT1N+DDq+{^t|wX zW!!kfB$|pd{81YAQRNy5YxeXa@HRc2&%W*mDa3N#NaVxXmNwCaQ7fj35Y4&(Cpg@% z^AF=$Dtpl+7!-}G@!H*VRot-jc1X;w4G#Xl7z9i#Fdk;x&I;8;QHc6RqwDcAaCNR2*+i{ODchzm#GTh#X5!*bM_brLv57+ zo0YKzA@i_@cAmvGxGl}CeNP=Xl$H|cs8}QPqvoRgpA|pY*PruU&>#Sa_BwG?EO<6$ zUc3A3-NBw%3QP zZ)8*z6aW&6frHP~01e#>j>!|Gd8e=RT$5ib5owA7!*}lj3rgfkaX_m%Ba)pz-=A;k zKcD zFXROLfS-?xF`tZ1#c#$ywq!?fmdUQ zH5l`(X}CRL^iY}GV!x)EGQ8Dov7h$?DlvX_e0`N%p|S-z3Xvm2$+Hp;)oaxnt}|Wg z42T8Pqu~u>BWFiK9s*jl>B8}H(E}WJl|rLJ5Sh4o&s>DWG6Ogs3Z%0NwDicrFUH78 zC=&nD&ZkOErk)W_sjtgP2Gi>4QE5$slPF|i<8?I(X`|K-&=vBWwd5I-kK&D@q78Y) zAFi#5ISp1mD`{6L#i#s-TyN5iA2q1U0b$z z)URBOCNgt3lCTTJ?5MfojuRe?ggoo>{EK=E7e(VT*!ir23X{XDtKW^z8>9}BlzfZ%mxGv7|yKp5OSVt^mAmaZ7WLr#7aYh1CY`e5p=dYf9p0z^b1Rq1(}j})5U|g zpHCk@Sxe&%%M>P9!5rWt1|v`lg8ac0u1)oSYaCFu`KO{*t=Xy&FvGH@pvoM@D-|e` znuiNgVVJDrzxT>9Q{xxp$I1>Q00z7HaemR|@OBt3qEF{^*EL+^mkSQ<&66A6)x|UY z5&x;8#&2L5sz{PG*KRf}@85LT5YE_z?uEr_F;%IF{@J|Xa+b>P^_-nEVYAx03&N9Ma@-<8;yZ=%A}MmED*Y7dIiNwxN%qMA@SILO&>QTmsWH;`@Ay}TOvt~x z#CnF1Yqj<&Oechi0>AIW%T1KFZv_2r>I^qKN`7abd>5#tay@5WKq`ux|6DoU^RfATpP!Dx98bP(0|`8+RP zYNR@@^&zmqP9S5h#2kNne10RxlYZexmE^H##AtjcoF5U*2*yD$)natT{5-k>5A4i> zo;3q+x(zkdf>GoQTiXwGlz7K`_$gNeNc&FyCaV`Be>&rQPb4TJwnUepQgW5*PLSWl zBMG4#_041MOQJpht0p;44?^@ZoCG5~Sf!{1KzShpKrh6>{n`gTgj8GasiZ1`Bkr@9 zuBFRwQf_o-Bh`Ofau?pz=Hz^@&yw@6Bdo`hbMO$eKv!vF6Xe1}GRR(y?-oj`umnk8 zI*26QEcKp1K(L>m>$iZFzxX9y7ES0&)-kCI^3yuh{ccC^XgH7{+aHh!Nmr+(FfE!6 zB?8Y;eDuO35n0X_{Y=TWX+SMY2T+I4Yol|2OR`11Z~T|0E=9bQZ-}|q?5_`Q0nCxj zM+*p7kwIgMJhO{9{GBg9%;GK?&umz}z8Qe*^oOb)+OM^2@$V2VV}eZZ=@fQ(5qX-W zxj~s}yC5wgXT_$iK7&SfD~;;npmj~DoM-K6v2Ev^Cq*9{McA2e{w;B1c7FPc@h8|J z5?vM*A>?)Q{57hcj%$TvY0!VjkqaLBK{A+XzR}4zvKwCL!R+G`w@qnQ@g|2W5?t~I zr4W<88Gu;C54yla?-3`$nAXO|uI>&G3Gcz&&sSE`6LD$j(gdCo-E7D@UenQIa$ zTTu8FYd^5kWo&iJKYgFH0|xv?!QQfW{N=jR+fR z^op=?g0^-*@_--k| zmZ*wU8-AoYwUn1I|zO zCx4vD2v$6*l&36`l4Cy6b8&4kGxSO1Lb6eUN_vPcLK3^C#j@;4bd@Gi@siDnnd8A( zIa=evW+V2I>g)$*Mv$TtQ>VWfDi#v$6#*fxl5~bY)~V`D{%v`wDuevHOK0dMAH*vg_0}`zl0=5#o(W~(W7UpgHgdY~5==Bb3W(w-*BaQ*E z?25~ErnwIrG^>r$S#W*7W9d{PGhJna*MADl-eIm8j$za(h03k&=e8G)F%ji1(Kb}^ zr=m4p+laQ*7G);QdF!!I;ix11ha9rrE&$TcY}rVj?M_gX8%ZA+K-iS0US)7TCWUwI z{KPR@oU)C4wIrBaN- zVKDn=j!PR^X|XX@q9^`hj!TaU>{}x^m>=MK`XaT1v=MaR@vQF|sIoYG8=Wuf=8|)O zlkxhrGi4M~siVUqcPTy{*B0|8f-!wW@N))8n))P`gd>7>mH!$lm82e-Z| z&E{E3ASs5REHZ^M<|ct3*~sXCrtkQ@p78DMOY@aSO@;370jxFWULE(|Qt7&sOMs4*rj|5r%sdShwnE**Su?El>e6!Ve(+=68AphceS}01{u0>kwO+AKqLPew)!` z^r3ux3yQr$he2N$4J}hXpF{Rx`SJCxzAHvZ=OwWwKj$etiLj+hnm4j3q<@xxUc zjC=4x87v6k5mW`4NSZ>%M5oB)p@ZCF)W-xpH-hg>DRSVfMCT#Nb%8B2smIq2nAekx zFT84F*tH{1qg0l*)=cVXHxa(K>{n-yFm^m_*3GFGgzr0UQ%w^JV+>vua8)l@k2w|+ zS1O{*RXUtDR31m(;!~i`tID4&`42fb@3lZEbW7y{dE-0LBCaiiBRPDFIjPF7AL+h$ z=e()et@cD%2l2-mo7DHLSDZET19T4!hO*7$Wn(%~`~_lg&4fIL#>4TXk{RejNR*ya zY*F`6HfI-^jV7*%VkzesuZq6%Q;nKU?+)zU9lkN{)2p(4^FL}tP+5Tb`T$aQW562V z7~?MwJ_!bD0HUux#^6Nxf^CyJr9Kb>$UCaT& z!Jt7IZKks4(}*E{y~6b*NVV}#GGT{1UUjuw$|&arF?@HWgL*&P)?6O94@l-p6xY8+ zE+I6#=SfXw_OX5ThzyG{jrC6sBd;{HD|D6x1EQ{mx*$>(S6xy=sRQsHm7P+-nJXce z3tVZNZpL$=hI+sj>ejzpdW+Q#NUpW;dn_o}9Uvn46 zhNMjBrfx|}&yu8)q@Mr}9)gD^+t`q=J4ArQ=Q~^NM z(1E_pwE*eHG_7_`EB(P3L?&X;xuiWxi~jtz{5iigYh|cCP&?BgIv@z=c`hZ zRUr|MGbI6p{Hn$L6naYERNCK6*dzWa3$$#i%^H^p1f|X7v*(_<^D`-f6qVJ4UJibg z1Zg4!HnjtY?>MBjH@(a!j|o3D#>@{I;zWLt39?iB=J-s|_5E!L*h1$QluojQj^cXW z8~K>dO71_Z*E|soZ7A-b4=h(t8kl|f<-g@ufW+&Ds4OdvsIZwTGhEpueof@JJ|G;% z&xTpulkj7q^;6TQr%jLjLz>OG%XfZtt*M;)TUj7I*_QWF>4z-D&}!C-7o@@vM;XBm zKVY{Qu3G3(ay5k3m~l)H;RXl6cQg7-2Z#}TQI{vKsW>-a5^cY|H=bn zi%&)$g#nnW7Dh;|!%2{=R7l0BVlfQ_TDw7XW{4lh-z$j>V)g#5!geww;tU9N-m(Y~1 zg96f9o^4SwQG(dN@kB;spIsJ8kVVdO*X>40B;NL96Mt+A-*p?t0il26m9T)t-T678 zJ4EfX7dB}MWsO{F*_38bC^&CUm_Ss8o-mGw=0TWkg<6qwJE6*;oxd6Ir;x~$=|ak) zY_GKm$xQ=HodKT71C^dV#oxgza4>94kwInAUtH0Dg#|< ziroaa7LUBXa`^B6GtT+%v6Qo7<`q1?b&T!%KkvW3Y_^Vn*!VI;$DsqrM3w49O%DA4 z;6=Kt_(7&9)l;;=oS4{#vH@cArTnHv;R0(ehY5*}_N^`q=O^a!=2r6=TC;=}D}!^+WMGF=L_m3NgML>j^K$ zI+$D7qH}E+ET$`6;m&AX{!&Ngb%Kp$a&7Fn$+ECU-XXMYH>^~l7|sRN)qS2^LDThZ zm68Pq6y4L+McfsYs+vI5<(&TGZe@XFhBzh z{ix5k$vW_2>DnE5c~)lA$eTgFh@Zu4d2B(zw}FYlkMv2K`eJTk$?F}^JSH6$T|#Fq z^<@PFUeU8>*vC$aqTEK^`eNU{OZC>~;;aCu1rOx`J7Y(|BCaW3(hz)%Jw>`&uW;~W zTDFHj*jF6gIf#lb6lG2Df%jNZq-UB5Z4d_O$YKOiMrY}4m6QpQk{N3FF(u?^ z=u~4A!6i^8rV;XKz13(1nDRQ0N{vg2n_}Y;>mdw@h6hiKo56~r3?A8#=Zx7DL zk*~MTkd^M(uZ3%kc@%VzD0bLJe?GzZlr#@AV6-yQZifgNss#S67C7ZV6?yv0Q#@M{ zycXs5t(@I3u#@&vSROJO{Gp_wb$7u?GF$;pLF7U7aHGsE^bUthqz@xaZq%e=2)bHf zt$fHlPWo1btj>UonC*16xy_4%q{Mu1$k7y|=-&vnB#LIyahivdc5me#%It->9_|ul zasc9zUkW$1`(bJKAQ}WE5SpEZ-+L&oT~ll<63dWW^cbCn%aa-X{i%EcYDnGv42F*t z&-nzC+5re!?aNw^>h>ItewJo4pY*PuuNWo)k(xA4Rm zi3e$kesmw@uORlb5+x4_W3MB=|4~kVIRpKmgx!@Y?ARTJM5VrsmqM_s@-!>!egbac zDjuN)P9;cIBsFjRY0Dh65&c#j)|SeQQO<#5ETbxA&^jv9rQmY z7l|d6L}uy8*VBF=eh2=&0#58R=!^sHkFeI+DSy(d@3e-7F5Sg=nKGo~bD&BZ0<@6< z%zYqZu3vI0jO)XW1o3lKzfEu_(!4%pxHhj$i}V#$Sc852l%-autEtTiH~7xJKEDpW zb_z}&y!d^epVYNfsd3_p2#dhPw@juXZr$2C|cuT<1kp~>B=Rjk(67*U}Tt^ z;TsIm>zhub28|LV)Ud2Zw^FQ#yv-OSYC%IxEK_6D6X>Exqf0xW*_y_UF1yI9fs+0I zV4$~D^diafEc>+L56zCf?#ndQ#XxX_D=n zUO?bTG2~)ylM~wxjyt1doUtspOj}fKG0~}hmgj(@{KB~5bO>gvKreg(>FQH-Uz6#h!g7&*AR0^_RK95OcTT z9Q_UhUJ%$C(j>r;8HD|$F*QCo6uSS$<(53T{2+gtDi$!xvFKAs>6%0|Vr=E;K8E_y zxMzJ^{U8HY>n!k?#J+EXM2V;ZRU7>`hazG%*}Wbfp$J>WL2QsZ(MTxJWlK@PQXfuV zzn)O#GOx-y%I$puH!yLo@VBdd>yyaL{pf8nofXc*yIq~DuRO9=AG#MBfDsb`3sMM- z%gc?3Z0Ahk%xCOBPaStEs|SErW?#R7NR<)&7-qLsPL4To(L0_CYo7>sZCk0g+}jbH z|ESSkLHSh|xaM>O*3v|+LFD$f_4aj$oHL*7`wC+!*@v*itw=q{E5f9#1)vC9PwCZ3 z7U~*J$-VN{OdthKs#HYVra=*!3@Kk^N;gSZ*_KHhk|}X|Y63euN5f3a`)4O1F$IN_ z!KYHQ$8z%}xrEn zU_uhm6(#NyQ`GQWslp0gsJLhue!nhmOEh+6vILV(u@S%BKI+(-%92EojfTiH%W|iw zT?@naBWM!K&iPH$3cIFNS2X<@zFI1Z+Nah}Gh|2_X}EhHEWchc);Rs?FUo*2bJQI4 zn1OO8f>CZ@q$0!6nAl`!Ow`WP5yYSw`y8_8hm8 zky%M_t@`L<={95sDgNPfv;%7_cxTpr$Y?Akq~FZ~-hGCjdztXIgSYO5svK@C%%o;n zfoW)gGFj{*^@=>lRFR_?h-uZTjLFea|DCJO6k-5q@Ze=zOMTD;(^tBwLjaa$tV7$k zzRNY1){Q6*F!lf^BN91AYF?7FCeT2yGQM}x;KGdbF6 zs4X$M8HSx1CsY8lne&4RF1UY8rQQ0MB$=lDOZ;Od0bRB$k9o1o=9;ZJtBEVV?cmGr z>iUNl7LCvfTHjieZVr-Uvop`=yd})7?Qpydg|MIot@d46Sz{kjV3w9jUpDdKZ;cP2Y(gPtRTd#n z|FL4J&_4HMU5rs(F_^kEd#p}=2(Z~$lKW%XSqAA8?QLheH_>DMY_WE)y{yCOfy*t3 zBllxl=-0ueVuzs4R_3;&ooZ9^B+mdqzjsa?A^VHV-x0y=EzQgvloIebU{#e54HEzL z7Ke6t$sQ{Q?+->PGvZ(rqWQ>ZgErlV>*yF-soBzPWjkqVTago$Ut~?0OLYP(>D@_P ze{wQOXXSP$lqIblSa$vK>+A2hp3wV7SH+k5A%=>J8l{E>g#|!aMDd`}&Y#HxT#yje zM=Gr~E)&Ex+tjfyV-=NLWOWp__Y&nl>$cMKU@~&sVb5x5^CI3jGQ^b934K6k=dbA z-^KbQL1~U7GaV0&0#%|t5+~PNPJXe_f@U&KkUU*HTa{k!G6QXN+3LHSAxW;NTu~M6 zv=DKjogXph*(e<%zQC+qXd(DRk}N_rrHIBOC4pA)^wqZ7nQaCaUG?K#E9q!B9K|u4b5!Hl{{4XQJheYLnoMeNm|8TIEumkhr3_ zb06g@XYs@OmH+Fr=S@F-FFkpRa|}FhoT7Kr0!nL45S|Ei9F}H@l8jqd^s&Syi5LH7 z`q8_yu9OH=NpPN5>{cr7fn%gHP|(TVC9JzXlm?NegtcMfOKL5$SKDNwmTcdqtczcFKX7JJ^mgiyANv}l*J$1PzO>ewmP)8izzpI7OIEi=`^ z0L|Nj%2ptL5;P_45=e^-G5G|~vb28Gr(5-uOFGvmO0T|{d><OcF*|U+M`(@shHTQ7F)7 z_c&66JCBzk=7uT|TWOUJ*`J76)Jy1-{D)i|t)w6MsPW1HJpNyCQJ{@}eh}(Wq}e5% z(;iM_`FD%8G&lax$L<^);=lhJyhDl-5B8xe7BvbGtRhUJxnf3z7&qw{FYfD*3s zbS-4GN>P~n#0FOF!%}m1Js)2mjU*D^`e+E6sP!r0847Jh+Ha4q{bK5i+eNYb(nAF% zDwsD#ChSF71kuDmo4;DF-sGF=nSX6rbN)ka%PAfJzN5clMZ>Nn8w}Jjpa?+=cT=tG zyct8mJ%99zpf0cQ`h)8+6SMqk;))@cGZbX9-wxE$%D|cc2U`K2B@MT9Bb{C60eQ-> zEE3()JySEOSd^s|>JL2bie?*-qX}>%)o8JWZqfU271|2W3c6tUf~ybe4#>01fTt9E zy3dH?eaOy`#K<5W9|Nl9%JIXgTC&V}v(qNsMv=SrLRWF~!BH;CcVsHz(lgt>pE~->UTlWsv3;*xg&;K1T_74yN2LLSOU|Gm8p$Lbfc3n5AF|_83 zYUh*v?3Dh7%^Ncs+v5`4Z>r{qzh&N?G^B8edvQE@PU<0-TZ(Q!&r2heM^M;vAJh$T z5833+O5o>J_Azpb+G=*BmNW+s1wq6cl4TWfg|)Y1jcn6k4^ZO}fvoA6d(sf!Mrvj% zE(SOLo~!YEd@BAaQ^s^W(srO_T*WpUsYR+!WdGg6hrHPcAoj+>RB<@usyb~!>ao2a zG~b6RF6$!5R$7^jZfDJT;!EAAdG)Df3!j*pm<}yla(im{j8Hw5es%^QC6?|~u@C1A z0i$6x&oG1zO=Y$3JA(uzOg{eYN!&t%9VSLBrZ;AOYK){q8SgJc2UU7`KfF**Piw&| zs}unyRuf_;kpV8qL2+tF%LI$LXW94t!d+K z-qi(AJm(d8=%xn^>fuDS;Yfy_`e(mBa+sX$_P1w+_PV{xThBD2M;_?8l3FlFP&OL% zWIbytb0g;{8Yw+vbn_o_N>8H!;ETUht>ozpg^Sj!453so$MR%l4e0xTX_j67giM!= zG`-+Q#Lxf$1HtDyD^_dGbxIzCzKFI=Zf;x71y-d3djacW)!P+@{7(?6bu;ZP46KUz zDCoyRAVo<<#zU%F$=7UaJywSyu;VK=*YA6?1eLTkIi*xF6*uPr7=srIfQ2ZuEQZsS zqlOHU7yV{@9mFD4rVb?B(oZQ=+kT(1yoIydrfmRe|a$ht_u0+8Qg8Gy5 zy;p?8+7m6}$Y|k!Ql-3baF0A9XliP_AZEo5hp(fV1>D8d&=}`a2R}>mgp4IgiVW4G zVF{@Cv*gFbAM48);N$=WfcX1&fV}0-_9Keslcb)h{D^Yy2PVba?O42+jP^5zFE8B; zhLea0#HD=JAt21QG>pyHGC<7|Ho(PQG^kk&Y}gZf{yOT8F-sn{>(6Uh^y{$v^Kt6D zbH;jgv-9=#xwEu0YeUYHhcl8P@uEfgvDNr{l0QjPxl02G?d0N>QT0O4ghgF zE=d47xojf(u$CF_)*$?zAKY(kjfH7(LLA}~0mLxOQ34!uG-IX%HpHJGgMz98qL7Gk z@N+mz;|rq4Snni<0LcH4BL?{jf)vo7zp&=0cbV|SH33GcAH|DZk^c@4sXKG=PhkoX z0HDHs2KgCXPATvxrKa-}8N>%eFwVpz?+?P+XglX^!}NaYPWz|*2r)8ZQiqCA(3jc^ z2pIP#CrqU#DM>FYwL5CD`|9E^e^?#+`nt4^d23INmc}e zn3<@-Cjvk~M#u3N2Eic15Q}q>%{2NV7X^Yy;L`78xyH(02c{yn0!duIK-8{VHO%d; zLpmo}2I_0M)NH6JEkpRRdL8G%PNfe79z-PPN81!`=6iNVC@$7>NFAwblHP7uXWFoW z6BfHwx#j=f+eJ+=#jjY5vQp&z6gIMtY6T|-K%@HnE3l9-si_>4y_PcG_1MDwU1P$T zJ)qJczVIZs#o)zu5;*xd?Ir17iU?UbFbB_uMyT^<{!=f*zbDcsg{jCyiIpIxC*w>0 z>$65h$Mea{)=^9FUSurF?&1;jhJu9YQF#Rs9+qhihcng7i5dPfE#;_kHjh+QOM36>lON`pf$f& zOpSy9m%z8dwcE(DAi5^(f5@RQKE*)XYtANGa}*m)cxveng<&0e3E6b6hsV=?O9~^1 ze+!2bfHCYdP%6omjGHu^yZEUxoj?6ir@1$|b{|&BEYi?Wq`S-5_m;=!Z%blQlcen# zthmh$eSfNQW7a`mV8>rC@4=7VslPtriLgUYY7kv83BEk5RFZ66D2CYbh5 z7dzCS*KoP(!t*20T?~b4ChJi=cmMQ&Q=+7*yJOqC&6NuByf#vl3pH$fEzbo@8HMda z`KT+AY-vhS1V(qJ_pOeY7koz8QJg`q8S^2JOFyZ$R#JKyG z`O3e{%nYWr!vxAmoZH^Wp>=TOE#4nCLdL7R`J6|`R-1(Fuhh>f~9jB~z zU7EFN6#Lr zCLVE*YB%_5&nQHVwc%$r4Lq^WjBt8<3+;|t=fzv}EreTM<8Ns9YXxrq3>I)reP1k zB&Gn2xT6sMVDv}6R=^8_oaqbs=N zn-8M*ZUh2AvpY+}0m`SvHUjkeWrzE@6xfPnXEV zX}SK=XGa@9!XRbepKq`vV|g1J-_(#GQ~P`1D$d1ZzdtriuE7q9gj!D$6LDr*xWSQ! z@q7kPw8F%it~~1ubIfT$7Di{44c5KyW0%VNdY-VQ;5CjK+=Xkr4MY&o7)-}7A`=J# z01}Qi$^FTTt4r&)SRQ8(AplhdgmYb*b3huP@FK;GG-E)a>4XSGmlAcTe0$#!fUJzp1nnw^vs!z6#^6TpC`N%Sp_^E zXwAn!Sv$|EXGB&WZf}thTddgQC1SN&#t!xOiLj^Px(p=^xh?mkt{Mh|?XMHuf5i>a zzW28|*2+p|zKSl0aJt=}jMmpszS$>)?Slwb`)gkpUtbL_kUFn%^a7v&Or6YN=stxh za0~MX_C9Dq8bL0ah9V3dtEX?|WM-cJ0>Cr0XEW)9XA|Heq=aD*mHi_nRYUzib(k%h z>xcoF9QCksgr8-<1IZRJgPH9|ps<=^gKZ1>K{S%MIyP1Cbe<%Wq>=(46% zQSvmva#z9Sz~#wtWrpsWM@$5uK0pzc5zd5ZwpW1@8(f%)33@EI(U}RoSBwq^GSKfB z0A8`T`!iaosM0M+V6ay${}?5F9AW;QHJD)gpESMF5LW2ASM%!L8j)d@p)P34Ebd-% zYt7=HXG{4hVWy4caUxhtNJYl129)6SyykBoZ_lYG@TKjg-(>XgKWtMLq2w78H~L7I zxot-is!&6r^DISO?0}qEO0I&8Wi$p?9Z(@hcdeT*rmOxzW3I=Aq=-Kv+aXi*3dV;n zn?9m@ZhdR`k)AJvV*VkjGgkqbJXCKPOx=IH&Os^$MaGq%yy;I+uh+wtxF-yhu_{hCbo zv>2u)JWn0F^!C#>2*#Nr z|BRW3fu^af!sh{S>g$Xek|BbK2FNhSwj_wG2nN#&NuO#Occ?<$vaP=v_@qCuyw9+_ zXg5HPC$V4pAKo|{QeJH56-H_&xBX5YSU#*=S62IYUHtO_#K!yqF|(QHd(8JyX(!s0 zOwS%xIB|>kKenx_Cg%W{g|J0iCjg+|JOg3M9)QtiWAokB2fRXmclG}Q+#7n}dAw!_ zk9d}q}WW8lZ%s0v$WN-lq87GR3I=Q7OqVa z5l@&vA{Q~DOW8hQQ<;jf8pq-f?<9mig)nlFAsRmx3$3M^o>ykm6iHo5FY`Bxs`1&h z0iEh)QM1WLEP>U<#{0J-t5la;IRHTJ%$RF3{CZJjt0%RBQLD?#*~CU#}Gi&0gtVI^{O~6WCmkRTKX05 z4%uRebX!{Mq$FZEB`V%pYLZbd3&|GPX8l)kjWb6;#;TJDdd>(Cy7uS|HR(1Qfi*B!H^4|owXo2p>-O#v6ihrH z&qS}rfn0TbpA7EURKgEj!kc7WTf|e;jT0-Tj8J*w+2>2o?%DU{>noQ#`q|2+jy(5Q znPXUgKW2FbJ?c2gR74HUqNtLbQ8+@=)7F6>dGN5%bW9RI$`~Gel_U!0PcbO^pMrxC zn4*ha{fUFvC1ULu=I0UY01MLA?)B*JJN4K}%py?X{q*-GI5LVBZB9BB-frZz7*zib67 zxJ5w_#j)byV}I4*uaTjcm?R3T?)ynlq^cc8=zddmUvzzCR9j)!WpF8_c<~08;_mM5?(QzdN^qyRySqE3xVuAf zcPL&olfE|U%wRt`+pG`|9KSwK*a$mL+GLdC4?b+ z&JdW4gc!J(uZ`f)pVOvvBc>tN4c#936 zSxNd99#&(dqt1W+Fg#rl9^2-d9}^oZdn~?xNHriO{wQRmmc&LAwCj|of{{Q5gf;(@ z&uot|IBSEFNY>=TBvVcm&ZvFE!5;I~GWqeTsIrmhnm(1(LqxwzdC4x9tyik5unG6f zWHswYs&Gb&M_N51lH!{S zqRqnn331cMv{nzd-^J01jZQK>oBIh_mf96VNn_&ALy{@VOs%cz2*9>5sToB_;mMn> z^T(l(X$;$(@Oq?*#Y)YQWUo8T#-+vxsJc8@3=oT)g>ulesT8PCIgiAo&WYJ=!g!T& z*IWo4z#>g?HuiH-yNa8228%%9wH;bykv5N}LH^4`>?ej`{ZMl3@w%-DdKfXxLP`i( z)#LB3l3Q^jvxv957>|B#TF^`xbgh-);-usBf-|Tev@INgCE4P$=NbF(L1#(dRy8Z- zd^(ak(!FfG)AWL7tSN?Je~s50tsE#5gBh3iW+E{=(gBnVOw)@g&e)ejP?;-enEXBu zhy$Q1!twlroHx=PAXNO@d}TEIkdY;_rZGi0&ReEtb=~}^GS;cpEiqcATCVb9y-WkI zvQ{Ql4QA2it*O$Bba1nN3T@BkFmE&MWj;3JgJ`4QC%U0Gsd}A;!SNq$lo+ID;YM^8 zkp^d-g5^g^hw+P^EM_PBv;a8QlEqu$U{Ug(JcTR-_a6Vvv5k? zZBfWk!W7qza&9(e%6mf`Y@;dR)?ibl2nKIh!8cKPMT#=tnF_BBvyJA&TS|wG-jlj>mDr@`FuA6Ro!!fhqQ_-S?DnK{ zYd*N!>q{ZX1jNgiBHpqqbYL}-yy&|58PC)GvCRFA9|{vfYP0%np|_i0nYWl}JlxT< zdxygmT=nGn4{{Fd;8+ALs~OB%`5vpPj7VdONL{Z&0fm#3c;}>(x(9r;YzxJ%J@C)h z%2c0-Z%)aJoxxYFIMU={TyamdcV~86`i?W)wrNbeEj)Rq&&{YE-oI|@EqirOe_a8C&yZFvYG-V{x89p= zAHTO~AJn)SPRWonq10X%Exy)g<^eGz+*uAiq{8~sYT_P06ZWplvO^8bE{xJ`NK+mR ztY-;!R!@u*#m}j%rzvo%EZfp6w45H6gxBWl(yKEMO?~0J%+#MXe<*ZZ_P<|-v~=%x z8Qoy;>ViuifDOP^RRHx79@Y-Luhu8jw3f6#rUblLl;YZALV94oGi1_xCqtZAM3vt` z6f>emlVgJAWJYmD4wN84H+r%`b&{ms#>U)*l_AG2OS9~uI{3v_6foEio$gGXQ{jk+ zUywU3jY`RG zS}jLnorR2xw`p_F{htw+zi#4BU)Q!a)WUqifcV^1q-qVBxvUnZw9A*PL;4y_eM1?ply*)2oc70qE;bsx1e{kN`q z@irXFg}q}TvD@uoA>!|j17U3p*hPGF(}qvA7qyMx%`LEf?;tWX6qKIHnQ#oCiaAad z3!Ma?$(R)ehG-TS1pxZ&Bmr-LpsvWN91ko0{bYf|r-^n7bRkBG|B-=Ew*mL#uGewK zwVLm|4rBOY-Th+hT0Wa0O#fiYlLwJn*s++Xa|{A$`c>{m1XOj-o>U2*q17lrl1Z|Z`x^WgU_h%gTfZhkMma(u5J!3>5| z){sa5O3N`IU>Qi!A;bv@RcTvC(qVm;#JY+WNNoB#Amw;~@m#GTaVjcE5v!7-mX`s8 zt1)k{O53`$KS!8%J!$7avD!QL`>smzt=@)4XXc4J&L`A%g~1Z}Br`Xkah=auM;$x~sVWJ1N|5mh zELF$sKJ_0M42|LQT=;5x&GeiTlATH$-Pz0goSS!X#%6i7M*25IO?bvGlJ=_xATBq@ zPgQB~qoYN3m;YM@`0pJ8np3?TEOrU9A?zonUbJH%RslS2x-E(Zf|=0A%y7}h`(*6c ziaaN(LoeR@u76byIX4^tJ8!k>gT(($a$u~=cuxS^FH^UgnO&HHxgzTp2c0n-6(*5V zMYu+DdpdPMO_1$#gU{jIMA}m;iFPIly(^j2iNUc-;)9?6rW{q#^}EEXNJucrt$2Ly zjE|Vu$VlsE>@TX!v+r*U8KMy-9+&unnzhyLeQP;>_h1F$+a>o`>I&-%LuRB2#k0uu z7A(OvxebDoma63nLH~9e5)c4jD(dF?qdzdJgC?fLd+BLV(wE+bk}V z+{xbpMp9$!N-Tp-6m;ek!B3FZ1W9Sy+7fLN|0Doca3cCY%%5_dayCa{N6S z>-6=|{H1ngAL`7ItBRSV`?UOih1Iqj+wSVSLA3BI3?sXIwMgLFa=pfo`e!8DW}mL_ zHaQ3?FcK>PQ}z+v571kVK)~tf9c|$Tu*9bONIo-{?&VT%I zgG7;#WHb##>lM@__t1`FCYp=;uSXd?@SjW}?ejI&#ez;Kc1`xVPi!Aqn_<|(t}+J{msTzv;ef%;bNFtpH|4a&Ca%55dn2CLjPNLl!egX@)6yENu8k6dhZUsS)MC zxkZqX5z8GtNXf^@YbFJin|flt2S71v-D|E+HN7B%RslRvHa1||Y3})K-yIxfez6`e z#9(a-XI3a&IcXXv=C!+m7};)yd=%l9B&h0=iZi#yLL~NwkAlRfPrCshC2>`=*paT` zB%!BBPfMEZlHMeOp8b(r?^#7j=l6d0s{@UIEV;*s75!V;go{Lrpc+KCQkKg@dE}nI9IRTrtI+XY*xA8QKf#R6&3qilAgQ zhpz-lp{-fA9DY7DP_62E*pq~wLV*-9FmogBeyr9w+|SKS+1vsL1r-Yq5%Rc{l~-+G=S6?)H3f`HT+u#9HF-_1 zRb|}CQ6flxQ^TL3R)JXJ^;Wan2O%bW5FY)5jXKgXna^3{8jo!b>)mck+%d9E{)TRE?G}?d-yQCy zKU%L7gt{#s0slUlCS>3izr032STrU4p!38Z*Udk=N;7!%dh#S{F5S&#Y?PJM@MnBd z(5Tw8QI-E$sr9eOO@4iWhQ~FX?{t*CF{|>jYD^$baB0nf?%yTUOPTis&1CEb%bGkyVs{|9CSqPksW_}BX;O3LqJ~kFM6<##pyUo| zm$NA9lPe@e3^whxt>f)TwZ{)B5m4rC!+s7V2`4EOozgM*iuuW4WP(d;uOz;EKhivIOPT*wIaa z!#PrZ)ic)u+q2?~^xclistyx-TGzYa_4kGm7guiGyl0tW1rgT)bC)*z`xI5JA!Z$m zeI!=y&)>=GzZI=_jrfx$-Q7F@FZst2@buBO<&Vdkx;QB#hk&Urocc3EDsM8beW?iw zk7e(coj_WfV?UOehc+c(xXFCY^)A%+7sM5q7|5KReASPW5Vx3B?b zK8LPKZlix;)dey7`TtsNIOv)LFSsfP7m7sJNj;y%A_C@@ZpBb9cXq7?B z+txVJ*SE@LW=E`CnCM!qibUH?A;H@WsK1xxvXtq|y?l!1$mP@rrEQ9Nu9*|z=N3^AoZY#~w znCjN-CY$wEeUWe|Tk3!6Qlz{6LQqXtyX#p$9R_AaSLm8@&CWHi=Sj2v{ny7DJ1>yf zfQmoAL3a>j1Imck;80O^Op}Aw3Lq4xZ|%;opy?P8JZ-&b9Dm6!(nmHnv2Q(jk?}9j zhPW=lZ;)2%|3m-%A6($SHvn@eiy$oe0NmL|w0I0`3BKfkA`)gq?^R8oDt%AC&`N0k zJUr{k@ys#Fvgf|S!Ei6@9g8`wZ1R4L_&+nz)V=%E>eNT#nmlStONUm^sxDm3OmQFwL0|4~P9~z|DkN$x2OW zd0T81Cr5$-ipF-jPtzfCFY4%30lM@}qeV!`QEFDi4Irqrt-2dDEyIOj@WF$GQ@1}a zzg)Ln5{rv+SbO?E`(|Li7eWoCEWdB!A7C!tL554<_j(>DYb!PqAG)OeRxHWB^`KX0 zE2E$ykuuzf6Z~vdDRkSJRZ9?Q(U0nCnXI;jOaG5wyO;T`Ur!^w0#^ zA74IxqA%57-yQ)+%#tlf9 zC?33#b&8x6qJ%HiszZ|`Nagh9RWEO!aN3iudn5odix_dz{5aPmE7P_>fGm%5-{@@X zm?cq^V<{}kc`Ej9jBK*9MeFB4W_16XvMo`}rK6pPrSBT&5^E6Y(LAy#yEI_MKd;P! zGnY(#L-%g+m%YD1oSNrqD?6c_;bz&Jy><1{sljpU*++ZpQ-Q+U3tMv^dfwHPoXUjO z@?~3Aldm4S=jDI(EOX5<7RsGBV=GcQn!V`ID}G2`F?1~ht>lc3RigGgg+P#u%GDJp z)=;#z65$w{@*=C5y7uCEUWbK(yMK^#lLCX_2rO34P}p`&>};xyNh1m3bH(Hj;(NOY z%h6M-oxVJpc#&rR=F4dKazi?QiVL3*2$we|y+Xrs8_y#XC=_g)XV8tNBshy;&6`oC zMro(2SZ+&V@Fjz%fUeI`a4S1z>%gj?2;;rVvD07W0({Js@!uurzg9Z@KVFfUE{!TN zC?YKzLQ1%VEYfiUiUTE$Y9lQoC;gB$h{=n4wn3uRt8xXL7R@bt+{?ANNWTh;CHYvz zW=T|O+BKs1n&zMn-PPb3lw`QU@ ze@PI(RYfb^9G>lOI|QBHkm1Muq40R7yH*6}f|t7A$I%Y$Q!0v8c3;ryb^f-{3ir^a zT;tPAp+K>c7wl3l|gPdh&kBU~)jh!&YiFXgVproI~F zOTn_J&kfs~NoUWQEjqT(M83PdVnX$t!}6x}jchZ1l8|H4C75lvN6x)^cAeSBhT7+Vt5z%lh3dqrYm9_!sY&*$;cGj^?%g71e z>ds^CbEn88;hKJb8;1%z9V)NH`p8gilSx0qu#ztnA;kaFApC4|Cn1ni!?WaDPeI#< zH^_QTO~Vw1re}dD4Post7bHc2o9QY(byfLlmlD%6l{tMYx+%dg6%EY|oh*W?sXug! z>fwk&#{_Izb!aX_K5Kh)G)2onn{md;m&z$}Bf^*fngeAC6j*M>>hO(HL|2+R|3U7k z?-UY3ZoXtoCy{1zu9MAA+JeKJs()VJu>;Dg;=9g8`E^5nOxC=>>;mYAnXy_ss8^NJ z?EUV0D5coUyw;KJP*n5dwy7oPD3kU0O)cD9`a%V6rqf(%)2T38Z-Cy?MxKCSF2e=( z1`PHGPpHGDz^9~8=(}i6v^b#Hc^p^x?0}+Ia5dgowZ>ej3Vwzb6$-&wY3yZCnI!%Y ztxI+PLLoa36-Pcf>Ov_Q1#AP!YAtX`>4BmR}FW7pl{`_*iE+MsQPYr;DlYqqdz(RU66(Ayta6b(B02w9a z%%u~{XrNT6C_Wx6T6mD?9xlqT5G6eoUIZ~LLfj9b9w#7fj&m-C8de_i--ZIRex*SP z5;y&isyXJOA8~C+1b%Hh&t9Yv4`7%C@viDVx~dn+Ff$V>|U_Nq}%a zjU}jk+|%p*c4Ut6KZS0|S~DF{;F7}_1Yrv^q!4*Z@77F?cypu53EZOH`h04B=JFeH zEL#-|boDrx#appZ1FK5xEgG->bzz2|r}Ok%Hu-cQ0UW?1W6T^HC}4SSPW?>}_y;*e zX-Jh5HD7r%5khp0&hV>h0+>~&%0Ep4V03F~yCM63`xS2|UKt)vm($3x(c{;`C1;3{ z>DBeP(KB=(@*gZe&hW%Ok}ss~$yV5P<5@CK<1YTVV(-4h@yi8^KM6jIvx-A9!%Ha5 z)s>T49X^E?#-9-a_7g&ru*FD)p-cn+ApYOz2BCTA8v$;DW5r#04$34tAhqtnyou7}?AsgwKDX?e2AdW*czsLKtl| zka^^yzaR>8a5?l_^rn&@0DbXh`{}Y4&1}QU4p%q169(oS<(uToSTESxN}ZJB1G7^f z-TK$Qe%IucL`1WDv(zLtyIXo|`0;tEmI<44 zloqmIN;yf2q(@6B0Sbf3jk^mGcV0P_G$-LY6DqbmC(WI|h+;&xwgW`+IG>V5^)ix;qiRYsA8A8P@$KJErX{pbZ3!2nIEl+x zUR(5q%`4Yl(kGYpak7-utt-YSrPu0{?fw*(x|w0JVyF3ZcV&ZjLj#5WND*-TPf_qU z+jJ08n1#xvqYz;D9C;cN4}q$QY=y)_g#B!0x{Mz6bTd#z%`OLszDJMf z?G%y5)HGa_Q{F%`1*j4`BX%)KOVP&wn6Ezpu6w9)VcI_g)B6$vn9@M`&+sTjK?xLS zNEo7$@lJ5za0?N}W(xgD@(C(E+W7`t(oq0CV6}9hZ#w+DcsL%drV3dWuZ$UuQwA=% z+So|qI6KuyJ*hJ^As^0Q3J+4=5o*RftMZY1h0P*ObfSu=|>l6N1{kNM`N+Fz}Q6Q2%61PQgFH;~T7d|(2e;%{S7KsbR80LXy zIaU0IkC2@(8ws~uTrbhVERSq#P~k)=U%7(@&#iMa77PDk7xCV_#}9>CqR$+jmH2Hr zYP7`am7*}-hmid6F3;*C1QgNEF8`6r`zHJi9NBNH;eT{k=~6y(b#Q77b)5euE^5W` zbD5uSWM%EXW#wg+h$+=?b(nMXe_xw+Jih@uCAi&tW`2V{009X;04#()jiUoUsC}|s zK$f&Lw}>IV!EmNhcE=o7X!S09TN+oFXO@vl8r?%gHC~rVywZE7nIt&QAb0NmPqzqZ z7$Heu61A(~hxaqL4<&&Qi|UZA^*GwVpR6ni1VBr4$0Vc1attzpJ6(K{)2~NJ3k@e- zH$$qlq0|;dMX%rLTr4?0yQ1!Wom-had+drXXUj<1Y;PD*iX)Jv%C?}aEeyX9{|>+2 z+<}{JSi?&oy}Z<*X+L-*iFN}|yoe0hr8!zh-_1YwxGs4s2=>3}@-V+&TYco-eflzoFkP3A{7o%C9x*eU!Sy)T8p7!08Gm>(TPl} z0LwpoE3?X+;ll}bD&ZMz_*+#LOoYA5iuH;3I8Wk3*g0*xbhTK^Ft-G4ru1?BRa=2^ znZjpYO5e-$bCp|lLa8m*B`J-pSu?Y0got?6nT97_O|Gq{$e5#w=H1*szcs<`v|)I5Ilqgw{{qd8WK=YsQ_rka76APGt)V+?|BEuc7^ z>XZso(sz3)u2JgyjlEeo(2CVif%a`K^25Cf$2{wCbwm))m21}4ZJ63sDLCUd_)ZP% z2sVVoF9?*-h_G|sgYTN=;4$EsiLEdYk$>6DY|uL*`oR7@GjY(b+fsI?qTI~r3o+6xEw#tY^eURJ z@e}3XiV0*Vut0S49HO?aNU^^>lvwKmzf|j*M_jxnsbn7DsgN#uwcj31zxUxs8u1vwYwwV zbA0?ttrvK0yPV0kCw^dAQ*KW?x6W?*=NZK{ov=##hZXR#XP}4Bz`&m#^Z!!`LU=hS z4-g!M+0q%K%$(f8^H09MU@Yr+-702=QHA<52owBw0{klUCmvM=Bo;)zJsHM;!o#K| z^}E_y?CoO+kuvs>W;pi8&J!$Vx|FHW5tE8E8XK|_;%KOkHD+q@>|7KM*3CJ^!72D= zg@^WRG7)nU%2ZNkLvVAP=(qGA7;t9G>Hf0s@z<)ksP$21{8~~&DI9vg*iXn^i@Ksv zX%}G^tkUpZ60kEXa2J>_j_jjjtFLJsJE(VfB-BJ7e5C#9{Zmc|vC>7f2o)9%DL@;@ zt-07@KsJ+*O--g1Ib24EAs;TX_%S;QoY;GNlD;Dm%tTo8#Y-mB$)xE$_vC%a@$`s0 z^)kXA+uokm%Wrjg7V;#VD?MH^v>=wK@3B*!k5gl>1VK+&z3MBPof;IBcKAJb{sns?yyisJ=-c&bpeRs?4`( zgRQd4pbK6y7oG67`NdE1O~wYkM@-TOh72l%2}=l>{apYRpf{o1-YTj5dZ8;7V&fbl z0Bagpljpy7vVBJU4SJ#;DqEZmTprPVZV#sW)he4)eg1qIdv5!c)z1U`8}iJ9XQNud zU>#uZ4(;*w^fSaF;2NBzdvHaUjwTAyf-VnF=+fycQCRHRNW45nXt^q4hMSiuu^^Jg zTDc@{^fH&z5xJDa{K42n>wNTu*{)`l6zbw;7smLkpMny>l7g%Rt^NCQc{$~j{y)e) z1(tzeS4=g}XvA)`s%)+xRInO$qP83}&ZsqWrF&S?Q_fwxD=Uq6-)|JH!YNEtYjxe? z)*@lD7(DpJuq8Xa!LM|>Lk*2YngjEzVIe=A{lpxOZ-VyS^;|_iLWPFd*(8ZqsYy{F ziUBZPH}U~aFD8LQItS*RBY^R`Vt-KB2gD zR3mlb$c`2MFcf>Q*jihDd-DgMEmavSzxcncUB(CYn(6;<>r^X{ST-Q(*bbK{BhNF? z*obX?d%nGck}1ebXxANmcom;GS+1EZt!*YJbn>Emmo052EB4HNMp&%RAj$#9 zPeBC(hhic@1!A!M@n7p!zADYJG#ETGB5lHVWsR44n2(7!PHYNB_>vPZ zIMR&kp$FD@^2Ua%h9A|Vr(aG()4l+1NEyXqGq_GnejV|B+y0CRpVKfFxE3h_f|6uh z@AF3ch@l~R=G7*i{j$2+m&28oce(Qr8@dn!%Q@cl@K?z2wZia-D+<07Z($I_P1m)} z`SJ0+_NBuA#ZUE3(D5L$5aO-8K?J4*Vf=yk)IuvxcZQt#1Msc7THOp=*@zcuc+M0eqN=v;hNrofqZD&)iYeIx5JFXikIT zS*Hp$7J+PTY{o&+oo_rZHj!tM0a!9bK^W8S1Maq}^k6}=GU)Igq9@^hkV~AHgIFO< zmu->68`SJ<-i!|1aA;Ch<+?rvFk;gEyv?AFEQ5+a&_)8lch=r8VK50N9V|`=Mxn_@ z`iNa^!F4#C>SksUsLt9I`ggx8bvtr*H}NO13I{ZE!3efg%vK@ec^qkPm4fpU6T#KO z`2ROQ0+1i5(#Y#YLXjImAvCfApgRo+L6v8K0wXWs0by_j+-?+QR7^(fR{(l)e~a-! zy>cIVNo*!{kEeOnAyl4RD`z}_f<&5r(*#|gOBybeSFea^{-m!FEG#M%n!z>*>s87k z3RT2P_bcpqD3uS9X_7+0f#Nr$c+2loo^xv9#mS*k2tyD2gi`&z%seUt-rHS!L#Ds8 zl^-VU-mK19**_N~*N-fuGpA&aIX3g~hyi}uEUUUT+ZXyqSK*R<$OD9c!Bs;0u<6l= zsCcO_Gdvc>1bBoj%75$qu2z0HW0_dVu;i)urkfgPPuxq8!>MxVHiQ%6OGH07BJ_y8E>3m4-nokQV zp(k}iOS|<;s~_)EI^}Z?s?AM>>mzls>sn*aWtQj`Da(p^f8vvJ$D}NwF7b>$?*sP2!ihjhx{(~GkL|z8ZV5;)LPBTdz1u|ki<-!^K zp;=Y@YqXfTl07(^8F(w;N9p~N8U}S()p+MKca7M{x1>%)T^RYj0~sEYSi~P=ub-Q4 z$$orDI5ydU^GsJ;pHV+Mca<;t1^nPx)E7GscE~+7`HZ0yC8Lg_Ap}r%zeefnBVo*k zoj}7u;ajYS3MlbHr-(ERkIZC?H>zrv-zqkV96qBfx^p~Ql&Cx@TPri_QA?^MFmE_a zwHMVZrqz$d;zcjWFk*Qc)2u*Prp#|E){fO`IM_m$;v=DBky+&`tD5=Qk}d(rq*RU* zYbLorj$k&E7D2R6w7Pw+5D_8u&@mu5G%jGrf2!xvx26#&(p+j~^r>30rphFt`8?gy zo{=n#8Lpd6E@cwnDNm(-jVY13ry3~u(%&4gvj>^=F$!3X$Ac<9?^)fSQ z>-AdVT4Y+EobMJ?l+a{V(8hS~$FT)GxOSN@8*1pgHfyZ0K4ZxN!3A{#{#qemL-6`P zkUeuHu5%!F{=vk5MvU_K|+WCU&ojdPrtwX_!|j6z+_@8pC4(?v3#$? zz@bHiEw+31`+fGE9&z4_xYHP4bt?O;)jM7OALJT_ASB7L`NF)kBa^P3%!M(9nznen z82yg(Y(MiEdq@h&;>$UhhtLGi(Ke%DpGwYgZHs9-y#DWEhq`t!A#cq+Odu|TGrW1) zMO)(W?hj8QJ~3V$itq z9jM9rz^nx2y=c;z)jkq-eNxqiDtN^3@VKHr?ksDu{CMUMc13e3Ms9z)Tni@jI6%=K!tX~LiFa$N7ZG046~{*fj* zS^n*f?z*lfE6IcUE}n4uZQe24`wO^!4<@w8$1vyU{X5yS1^`h|fyEjcQ_M;Uh#`OQ z>o+APaRd|LCmALb2rETF5+J)6?9SSJ;KyJ+-v%DFroNn(WKUT+deUCHZ^oN=uCz#v zy=1$sJ{x`$&w#G|mBoEZ8?)k?RWz$Bf1SI7K(OV;!To;j4+a+oLfWTBJY}KY-UtJexw4|uzr+^F0{U;-vQe{BV4(FfLDc7t)Dr{hn=!Ig4lRVE)lDk`j3EMU z57lD_fA#9UWf@*C$MY{&>izXIDurz}6o*2YF1j^uUcXljTlx!bRCG>f3>D*ineK}% zy}jK6--5lj_EI6mH$xWAVC$V{>(=k;%CG&0pf7l#B%qyN&=iduM%W4RIf%zun30(~ z0SOUPA0fVsif+4SQE~V_YAV$*n@>+&`?5 ztTr6ar0@e68Cx|GU;p&5pYG0~*_^8mQ<9s-XTRuJ>M!sE{PKM$_%agt?94Q_>yEHZ zg91Ld!^TxCn3jx^-8;q8j0q~`_k$)q_QV<{d@#{>3urN1oWUwrb_T6ci|V?gP-9fiFoLU7_#>j+N&?MU&~30bH6FY!li8OJ8#6-7EdD= z8Ib2Gb|}3(0<>W;uJmgiE^GX3F%#t2yB--1R6o8xfNz)I!IyL6yc&x?j<&j!uw4^2 zcDxUM{DUt9a>zz^kOl7HOYgQqfJHfE`$;nZc6_1z&pQwl<&O)&oH|%A_&Vc5Xa`mE z=EnHZO7I)w+0z!}dnq0UUp|w#`n!lM}ug8c;3kK7B?q}gu z80eY2i9Cwsu5qapF@@>IvdLn9yR$z zUX&sqNUEXCjl_l+o-+S2Q9(0gX7QzIqfuQ~$!-;;G8?N3?gG0&EM^8;ZaP*AP~;aR zep@EDmhR2t^`{UgT9kSDg?8_-Av2I74Ud=`?a3S)1LP)>++JJqoJ0oy_uIjjNU$d4 zgTHjYsk2~dq?mD%n*|C}>IaT#$7ug)s~`)po?Q?zHQ&}d8B}j^SBIry=DXG-<Rafr>d-7*?emPFQS5$|v!)>uUo7K| zu2-0tKlioWmlI=dmekP7vq%F}jV&t5S6(hOJ-LlWWg$7hQko^fZvBZ_pKQVw*Pij( z|0luuRK;AaPvuwHT@o&iBPra)4Xe)MyYcH^iYZJTo@wI&3mb zS+&RTdBS-EQ$7P>i!5-8pENsv3NHf*B+*aF&Low6I9a(okjt;D>GG+CHbHfB%Uj{o zPZR8flfBOnQE;8z-flJk_Lt>v9~43-#r?5!6WS*SxuQ|;$ z8k)jBjpM~O-Z5lrrgoepKTTHV`7?ENDQhoq{I4sjUrV$4SbxyBf=&wznDhufklNPc z+OhnBctDjCE_H93`(^T@i^}k+tz2Bc0!V}aYmh0Hu(#}qv;UqICUf~wUzRVPn)BA; z!VH--HpIVHrkVoO*(hPXI4PJX1QMjAi@=JoKB>77m&<(d={zIf%stW*eN>(Y@6>{) zY2i37!h@Ab$|8d4MA*744nPoHD`_KdQ^EqWJ}kBG0{%#D>pQh7n^ltg>IowevflNg z4f7(^S#bSNiKwIcpE(w=&NbDBOF|<&7Lyk(Gb6?vL%Q>p_JcMIUzQNAtqxm6cFvfm z>=wS)zkqpWCx%}5w*<#tUi_a`HXeZ~sZ^?qEbk5v%U;Zy3bAhKdqRL<#8jgdx1sv& z{y&+O=#&1IsO)wtAR7`qd-KWjo+??Sjv^*BRT;RZkC}~d4+k-pzgC}!W;p}+Ca%lj zMXqN4;7HxAj+x^@rx}BrCM!C3JJP{p;5Q){Qpgkz*F28&iFn{cJYAWxK51`ou~?qi z2PTUqntMeXg;Hi~7*qQ%wo2ITn&va2FNzE6{0WO(^xVni_?wL- zEV$g5(7M)gdYQo&w|7}(j=NBxyhsEgqmP9)y20QiGC4p$IS2rNmlMXt23nWcK`kj1 z_!nuZ(ax}89O1MtS(Zg!bjmFj%kCtg1IyBK;^ZugR_NOEMWqpQ+7oFSZ?{2C5djqr zH{y&`0!;s-+$is zD7^iL`5m9$80%|uq{9)d)%M@8I;7(DA`^=4WGfPI;N)3?drIipCTzMI=K;=$5Op%t z7eW_tSf}5Xr6hyGLam<7?(k54o>BU+x#nvO*UpNrvY+iUq->jKI>;(E_=+ROc^e6e zq{(PWQ&~yboePLJ1*Eu~8t6Y0d5L~*;P%Dd-@|I84-<4?i0xM-ubI0nB-25)CFRAw8NEQzSIhWcsMg zgvu>1wI3cUWGcKuZKf5tM<0Cz+QAppJZXi9xZ2K0Bv)|g1^G3y% zjs7hlBnHNI#5JdRi<*hMY3d7MTTw1}FohIGDeZljc{<8~TPj0tr>1z->fz4a(2SV- z{#SYg#H0%z5U9R*1Ph~~=b2TAh$FZsW2s29hYe={gFpdu!5Pq^xB*dl4Ct$pMO(JW zn`d&A+gfP|tax_mo;N$+L$>a>mH3no<_< zKv>B`cS~d$wBBd}%1gh|#xwV_Twz#kBtl`z(DHH%%87=ZiUob4T!sxP`gv9+X}OTI z5(DbbiteeA9EMvP7$;X{MWPy)j}C#AM|0092hQFWz611M-wL+Rh2UW2L1eI|L)yy}= z_ru`!GHc;uqj0)2R4EG)Olf$sc+db5416A55NWcJ0muX%Pv;qp3IP_1%7$X@LkbL? zQ?CMw)U5kFB44{Iq8cskz&fXnLYDoYBRRE}Cr&B}?kBhVgGAieIjv@z(z0f(YxK)` zC*xS2BGBSJ-KRhE0Wf>)8XDzTZ)bIM3LzlLHMZN7XF5Jzm&hznqKM(Qp6{CLfr_%6 z3b*q8%ZIn^I?P@JVKg*!J}BQ-qR9VdrEnq`8z_%vrqq1LXgB{6t+fYcYz@v|3*BSU zyl{~w#U=?Sd$|8sCUr>*%{f z=DX`Iy1ZIeY3f4)GdJT|#Vip#0#-ZJ1ouY)!okNB5lGeg->#?MDXgtq@81dk*S!}P zZgms_{*~|2v2Lz;D6oaSaj@{{9}xp#0N6_SneM2*?k>jAN!br%ox7>m9EiNeX?USQ zI2Oh#Li5xv3@?>3?o$C-u!PJ29b4uP;TBh_T4fI>`m#GGF0-yQwtkBO*D`0+?UvXI zB*}xu1!EOk0XY2!%7dZD`NgNFLMj)-yROapXJ~}hQ`O}D7j4a!Cij*4!^)L&$2=*r zxKn}%TjiDvs*sa)<8<|U>Yglk9{VFw7u7TrvqwSYZsHA^#|9VkKV?K zJrH;YYGAFk(;~DVtBZzEIH22+vrrO#2gw~5SCJbx9M;e$+ee9#BwaD#+ayVRSWDF7 zV;u;Y4z<9=&)=-@fhH&?+wH>HgI5ntW2!qUCld<8XnG3mw&fXj-xb_&-q$gf`Zc{k zWP`J<%27Lg1yNdVJ#00%R)Fms4AXs|Cwzy(3@ctt(QKY2e_^Fek_iWulk6%+bq$su zb=oOX#lX+hf153Evs?&W+~kkGOr1AXd{kRI(>U^{Sel-O@X+8T#0ZAD z(}W8$8mf4H_>9d&?jDLyDgY%W)2zO=6@~_4xWrPM>)D0-Wc!-8QJL9FF@1rke~|O{ zNd>{VTdeyVZv*7Sey^Xi0Wg&j=Z``#k8g`X+yj(=fnm_*Un+qIXQKTF1R z4I1%^h>mK(R(c+yQR?eE#QF^1bN0)e*mcIuy?BAHywKQRXP9=mCT-K^lskgLMANTk zG$3@OL0wvAiwWW(5PGJHthG4g>X0Qtn-`2 z)f0?sSV6_gPXDDd#SW>I`K*;AXanX=&kDbaY`JQ3VDIjOqYmx72e(2dw$J`=?Eg(P z|404{B};DKQXo!=R6q}~!cVJWAq!z-YV)oFrL$&76=)Y1W4ox8p_#+;ymG=NUK11E_*0LN_;@VXHl5??P)$51DkNIv2P91g}THWiU3tny43+ReA-=1?FP{dP&9m zRkupBp}q~7hsv8-4+?BnELwTZlo5+A+&1HR*@m+t^bo+=fSeRlFxLKV#^#f&k6RxkZFVi9hNOeu0c!qaBAX#8vKe zbYCpZ&07;+3u836XW8_E==!=FZut6#yn~c!1ARKN${U$d%ssOPI^RyZD&r)X7@j1o z)_;FB@H5co^vYikQpSoVkIOS(%uka7oK^lkP?(PuW z-QC^Yo#5{7?(P!YA-Dy1hu}^R`RY~8%&U2`f8FZ-)A!tU&)L29+G|s&%8gl)L^WN&x%DtX7MsmA#{ zhv3zuZBaueX5AP&7eRA?lt$77dnjdW&qCb*4Wrk05{bx*6yX&!OGn%3`uY{)=FQ2} zqVD8Z`i*7cBIIG_|n&zU0=Vz!>Kr^^0`}1RvZcr8cBt^;3Aput$`NqiDQkFTnd(%W* zagv@;Hu>~oZQ=${GaPn}ScrTQZux#`{xhxy6xo3fD)2;k@mss#uI2S^s%>3<@e7Bc z+ycQA0fY?*005Yssd-aPwlrl9=@N#&m~GHxutBi!$Czb2{%Qw7;sv_lMifNxU3O~j z$xM}3Gg0ghy6-FSP+7EpkXz;%?Js4hvGxk zyLZ#Aza+hS{;fni4obg9I&W*OYR@LyTu0kZvJykC>lK`WF;J{VUZc}9L8!EuZ&??S zYRkoVAT#Mk`k;Dr11?9s#|yx=D)5lJmZ-_SU1Kpqs0?D*?I|Suwa<(DEzHOp-F7SU-h;xa#mX)2umg$0s&>CWWuKggZ4T>C@eng4l(XI)W;i})PiC5;PrZ;C@FMB#v*VXwXrIBh)g! zzSjAYY5^6`@61Q2;j!Zb_070vD1(ubI9-VPk`2F>mIl~{mynA{jFpkrc3yu*u_c-1 zrE2Rloss+I@y+CnV@h?Cud({V)r0iYUcgUAjMmC~WSUT&3v?FUfb z(#Wd42{u1efgJUQ$2_}(F?=c~ z^i!$MRreY@9&1h~TYcVs9i26K=oB2;PS~!#ri+{~^|<9Ge`C#lY;8B<)*JVzOm1ht zK25q!L~qXa%Gx~s(Yn~}lsTaCtE!~v!#ifwukH6v&jj4s;hE;9o*CTAKE_sxyb$AR_|*IfI3AzIp2fQq1pN>u7xSPV#E0xdv4bQuk@8QlXDz|>bCvrH%HQGT6fq} zTQ(B8fz3DBmB7qr9Y}-y!YFYfc@o7nX2~QYD1iC-j#F80n79D4J?a#pLiMu3h(}uu zS=|Kg=-h?h&e92G_y3U!e_jT?lO0|-ZsND=^!(Qsh0)Sdxoe9g@h7j#Q~-!@#;UG# zOaSUAa)gjwDYCE{!jD1^xMC$?6FA$aYG65j$q2c`3^oFK2o6Ca_=YekR)TdXNjMso z!%Tr^LSz}uM&wbF^T{3V7lM#W=PV@1lL3_9=^b(2GdEo0&tv)JXws8&39;RzHpvTz zSE_$-e7s!Dm+$>vk{{xTx~?fpQ{FAeUBlANtqd)Y{NW+Pc0X$;3=PpyLH=+8Vav9506_35*VUx_r$RH*?mg5Wj3}BK zRM!g-knT3HrKlV3>U~b&eyYE6YrUz{lJ*+H<4r+ZwZd_&(l)f{euV27V!VZBJ}hP)+z{eN4oV4K$xTH?DxmQwkIt_S0J0lFsT?4_{P@aK7F#E6sMC_i~xBjA-_kZ zktD~B{9P@=UVutF`%L&-xI7yH8bkP;%c;Kme!<5#v?P+hnouxDQ3;1#94rnhN9y%m zxH44IFdOvEkAKxh8l%-?YN*gOT#>AF49m~0oo@=Nc-G1ih4VU+NagFdk@MzqsJ-SQ znS5QMX9<&PjKC?kf}}%Es5!!z488gKb%;)LzsP=g=H1W-^i#?lRnoZLLX>jirI0^9 zfZo;Z(Wc*fX7^kkK_D~GI&{<&OhuMz4KX+@QdJ}6ZdCCm9nx{U&Y{Gy3vK~zib=^_ zi^h|kZLrqeY=qVI5q)dK@M_h3)43t1>a??T+&ZMB**b}P`O_P zc90$Ik!7#E_pIT(1S8ByV+|e`_Mg|M#{3$yA3#rJwp15K42P5BR~y#{-zG*HDE=L+ z>G~}IC z(tOmnKalEEn~H(T8*|;V47))ba(S5NQut%)GOf2OjsvS`rKT`&=GM+h^yHQy?G3)e zI19T%L5e@mcntNH&(?qvMA6W_Q=ys4R#=Q1l*FVOJ(#XjPF$7RVMh|P7^+K*&zaig z=ZnRR5#IeSY#h=0uw0ECf&f9|I{yGjo0D?53Shc-^;GvIXzk?U zDDkTJvf#cC$9y?eORrw$3nBrF>2cCh2&@%mb^Jem7BR76FX=j*+cYUDPE%(msv$y@ zghkv_qRAac$$@%K6-ZiM{4VY}IySgYKOqOk${gg(0?YG$ceNC1d@^^Qh!z;m)^#w zH`w^|ljnLo6v4)nfOf$XI67bH5X)7%P9Vl?D|gAT%8aB7sS>+9HKS4R^0BAN*3(q+ zUKDPpmmkP}%^RgCv8S>Kf&4O&NxX9mqvlajVSpGJ79gd0ZLpu9{QLZ# zrUksL!KF|6QBmBUVum3DotMvwmX$=%`5S%+T~wLxrJtNWxL5aFj2uLk~0nJUEJ zc~%yLM5d51eC>$n_SD6Qsp|D(5ZI4qHW!LZUTPaY(3}70)@O_1td&0jvH53FffQjU zk3hd4D##iP(iFg?juD{DlU4@~8OrDnhJ?dzWsYvx7gI<|1x|M%)G8u?(e!<^EJf*= z!hBd#0bE=qp?mlPFN}|V&~kCzlrY5zDo&H9jjWM@m5oPJpK>UHIc>j(J zA2l?Y*ovm&xJ>hF&#t=N z@0W1?D!v#nUx}Z{o*WCt0wK~riEO#WMtjJ{2@#`#_1a;`jClq2>)GV7Wah@&@KW^g z!Qg*HVUU)n;#}fUYAR8OG76sBmjWW7_GRW>u+uZr7M!0|#^ysVC^9in15P1zEYeHG zSH%#%OW@kwp~rq&5iaE}ob+^vG_d5FmAZ5?6HREw66$cx6POm}Xp$i_h!0N$il09(xnJkHvv zuteHAD+Y#uKxkV3-h2i{8O*pgq;^wjbTTk-Bmn$Cwy+U|L4IQxsk%zvB*`A$_^Vvd zraEb8%0y7g(6UyH_C2=6RJ1508NWI~AQ3;)ppx@iP%zGZvw+r)9KWJ#hPH zJ}opiwx6y#n6&wURr!MZKgfY~d{V*jCQ2%n{NNGrn%$pNFcloJ#&Z<_T#%yDk5wLU zCA|ChAkzMQl4)qi=RjtUQ2(3@K1$%5$yP}AV?-rwc*C&gWuuhsKIf2n(pp~zK9p<>HCmRQUtL#88cvcBFmGle||HERIz?e@RY)MMQ`!$;Lkz-H4!ZFpwdButM+-V~10|ebZJ3Hk*er zMH^P2?LkqVku(#vOj*|nkH%emCq&olNAj;^R{3i@(;ON8YWRfpS?+Q==~FSCqNK`9 zy1kRQqPRCJCZDF!gi?GitAXEWO3IE3D$<&I3X4A4D(g!5;|_WY!t}+9mz_R}jF(PX zBRQ6L>8py-vbTt$(I%iTp1Oz_UozLb{WN=@C6J`SGi%+ywC}3|K76B&<36R$h{|ze zoLMcwKm}MX24Mm0+_%eIySMzUX1*7!p{7r*QX^;yQnkPDPniKK6g+saIe+{jjSg32 zOCzv;{5!Y?wbyZBb;Fg39D;^Ck6AEgEjaY`#6QR(R)12#M8;Zv2KoTbqDa>PWz;hMLd>RMlSh#v8RQ#bTm){ zvoNcu;=^XIgS9gxf^*UK*3aWlj}GGKmZTs`quvGlJVsI8gQg!+Gc>n@JjkxrhqJ@; zcM5=3(b?^z_M`hFK-~1v!fy#vCkfR02>K|b13l1!JDL1sBw4fJ3@9f9V2*|P|1>Fv z1d~j-D4fs}#6l)XQZ{pjLcQ^Uvyw_go$LM{*JxUSE4h(xaSAE+$%_}Yy zQ7d^_Q=RhNP7vc-1s{{jHzjF|5p_!$vKlzSThIY03#EYp5R`mZ=0pNI)A+!w1^`KU z@{Sda1_Eof^sUr%yI8LW735$_FL#7urX?Y~BRH!%Hl0}zfU@H~BoxgA?q69Tt4{_+ z4fHbLI|Bd+%3JyS%OFTS7^FeMVg(LB%1E!zCjC0*I;Yff2CM zcp+j#s*6@v%~R!p9cQfZ$la^hy=m8-hEiIhwTjU=RBdhjF@P7JvzA1U&R2y!mun$H zS#rH)DW3$^ag;^40jH8(L8VZBF)cFCNPMyMtWyIi5b!VTvXLn!e@F|-z^FA;*dOH6b z!L+KJZ;AO(u*12$?3R=kX1PC{TzMN&HHaBNbOZuuftc0bCO7Shmph zSq;i58$v4gG(Y#aqebargCemrZ^v>wSJ#r4PtKX7Y^T44X`JI`*sIrSci?gxRY))t zD%zkT&7+L!S4~B1*7#HZgtYoHKJpbCyr)|@BNv3d`Z1pTE{gQH+*&#KEgIu@yI z2cYpvKfTyVLNr5Yx#WAeq#lCv9m!eXB-+{_Gj?Ftl|sF{Y8Ojq=WKWii`N=fxVBZ_ z?<@60Bh2CQB$@!D%Zs^g2Z!kWZnxISX{B16O49UH34!%2nTk>mJhR#SzMwS~=4e=M z!(oU78GnEbG5J5p32lGoa@l6fuk@0;KOj5(zCgheC=~yYIk*+*W~^uqN`CHy<~a}{ z1%Me*MhUK`0y#M~Yfu>uPgmW51s0c94gFPfJgu8Y9gFNCGI!S0*uixN@&};IK7tA+ zKTre}Gf-qEaI*ZdwBF?bG2NkZDi+UcqsBJ(>aBNY_N=wyRqc%eT45kh&k_s@>GSQN z{NYZV=*tuo)rM-tI5dfk3=pQ22z+IM{uTHWU@#a0|D!fp1dc!zPlu!l4XKLCINI{!gMXxxx>MqKF(#@aCHga!x^x!jKQu%q@N`Hj2PZTSdu|$ znhUw@Oh>iRzq^LRy}3J~V{mwCnChS5uw-*(M9|jJ^%Hr{H-=tnOm%o|b>Dv{6dPGI zqkYQAF5X$W39zS$gUtg zJM&qRl54ZmaYVqT27n=F?KEOzP?NrNnRKck69B z`!(nzB7fF;@VWy1pIq*h_$CnQ#CYCH!nWVuTC>{ZbC;V+mQiW-2Ww-bdT7c63vL1f zWBQY0TNjjunr0rD51mAVfSqf5^K4XU`74u~<7u4Ipx!|~ONyLV&#gJUL9Fc3m;!M*1l+(QRXO$52`fm3Y_^GNK)ioBGHXM*y8v1P0FW)M4x@Vk_LKYcd-u#u0GQLwQJ>i67gD#bDG`;i zh(!Wum<;KI_F+t~Zy|pq(03MOp`rCrApj|_U(Djw1i9&)x78^p!W&bwX-gK*MtC|i zgJg+r_^%dZ2?_kMZC$PTFi5_gG5X?`I#f2IUz<*lDyDZX?=3Whd-D-TDH_m+p6ns+ zL(y9;{0)iZdTx@OGM%c>e5{?49;Y6y65V&28RYchN*L}zobHJaWAo_`$$*$4{ zRsKrdZs{n6W|es9^hzHoX(wlMUEdZ@IDSiTMlKdhFT+;pl~2ovD9lZSuVy{wEQ?{w%b7 z9K5~z-M)^q$h!Q82`+WI@`rghS^UQY_l}RpPU!e@GvHAc;5< zvIH3X5*mYzU@xuYESa$m(#uIOKtp)n>6D!5`)?D=whV=wBaf0(?xR_3xqkZ^hsjmn zOIG>=t-!V4r{ha&*6s|2%dL;|QdI($(WGu!Epp-wQ;|oQ0grU-xuJR-%YGFvKR$3$ z_#z*(KvmvX?}DI->#8%H$EVl9Z*Q${mYS;GQsRGV)8V4cB`z%nC|~kG)YX z+kqAvQS~Zl=!uItn6?>#8Pv7!ugX=CVO2MEO{lGyPB8@LSFibj3TxDAtJU;dynV!Z zeoZm6gPWkUcRtV%-$yewrI8F2js*`afB+D<&hJGI|2+y&e8Yea3>6ckc+i&Wj4w5X zc0HHe01y21zXvFC0{&Q_>xdvrIF-(X;D|7W?Lp9A_L*u8V(Xy|q}ab&Up{v7x!^2z zcsVzj9n=KvQ&LJOo}|VLky=o9MaKo~U2DO?VoUU)n89rrwXn=Fo0qhBI&9Wj>DA&{ z+@-bo0|+peKON6n2j|_1QxDWb%Cr?phice|C4*U3&h?{4Q^^LmN+P%lRA!R&3Lr-y zAuh#Cm&+epLGOCcI31vW*0GD-l$W`nq{3dCl`ue(JWAN1B){^4F}|=Ym>?bs%9}8H zpt$f(+c9kll#I%zcPD0!Wz=|+mcq>r8U!p-LSCOhHE+mnO=11R$)_mNfMh3}eLll8 z!G6BLqO)R-W!a67a}0e>>L}IaV%hF0#W&}@5dCAByW9cKSAOF>THD))UD-#C^*Pz+ zA_<72oluS>_U~LR)@}kox*4vV!Sd|NT5FCQK*^$L6~q$NM*Gtx{6u4IW^HNtwBxxT)EF#DYF)amoKp2LC_YmMSVf&nJd`7Cce%G~q1NLw73DYB0zG z0~ir*Kd2CiJ$V28e(wB5BbK8;tRN)+_)Q7(U87X64+Ds7bCK|y+qhi(h*u(X?b&-- zjtnv$SmiQ~q_O>Ggp<{8qq1~XB?s6JT=pVQiegr4@Y==23CA0HR64yk#RP)|;Dlqu zCD(i*OLu&K%$p2Ql*a?A>TZM&Xq07p8alZyI)*^K)i#TruF3KUPN%$bh{MAiA;*oP zjGwB%r$=|*1wM{(#e&6OT=usR{<Ek1wAvuylmM}#F#qJVYyZHoZO~mf`qMu7(pJI8ExFpe(%iDF-;L{K z!Svf!>4yW@7%K`4fpE%DECCdYqA8_L9r5H35S{59EihW( zKs;7D!XUqnB}gnpnL_eUSSS`x!4GPy7ImLj`!?PxUy@nT5#e$$PE5GV4&R5usV5S~ z(|PoB7&J^^ulF%!)g!(}McNFGz;cWxHutUMOUG{h)%^_>$I@#=J`8rGw&S{~MbxnB zC7*VeRpgg=BZq2e{_wa1WB)iwr|tVXk}&cC93TBN1#ujf2Txn$e~{w~y!3~rHdo4& zqqWzr(ws6d(M4s=HK-~^8OyA%C=WsNXdq6O=2}3UxYkVe|Fr*Lvgy9%Hh+bP^q!9* zQDNDLLhqNZ#ZgepF`J#usrI0r6MLnI=VhxHUnu>hNVbulxhMY)|EzTYaxW|E{1E{y zzGeX(54}mW3f>E?>2E?gQ?Rftn356Zcz5Mxlw?;gd_w$~(i~3!F)|!Jp2!*0hhs>S z1sO^*erVnm}ZDD{kMb|6@XC;IDTVv(rt{ySfU>QiwDS0DzYt)?_fA_8)+^pG0J`>?J_*AB8p!hQxR}ZdGK+F=QYhkfstm zMpCL~3i=M_>PcAEP|u;7>o1?Rtj24`_Zx~efr`yVRgD|pJf#Iv!0RWN{Rqh=c~eyU zS{7=Ga{Q^I&rZ$QP2i|OlTmzgzOfk^{nE>WUb-SE_}F_t>0 zjcV#khhaB#-Wdz@tbDn9j<0q{)7|cO%Y_dsH^NF)3RA8dVx5Av%gjb?Y=ab38Dqo{ zNiq{v%fs?${xAUk@8!wTa1?oY#!((faPbc8DQ~iex4ALgrn2Gr@#6m=hv^OShrBjh zK7-ZPx2NdPFfnSus?JnUDfI`NBs{rkm;v;%ATkR&%nnD0`_G~uNy*_Unwo}_1d8)A zfiGxxo53q6b)a=D$l_1J9TP0tc6BvdGMiM4yEHq`ST0PLv$Oq(K5wk5Z2y_I@As4o z+Aii7OmZk&AWY&XSYpOOs%?ZWnrLPufT!Nx0Xzie1qrEemZF2hun;6+nTf%E#Q_fk z5|}$*QA0tVjUhmcjDJnJAn!krg`EBJ8#AyXOaO}DrBjiBf)4Wa@6y3&Q92O%`NSd` zFS(YDoN+L$iGt3fH_bc$_~0orZGz-VI{7)cEmBw>dUPr`?XB5}zLF`DB~>Ik(^0pT z$dvwTkPu^9QXzNKs-J}!XVl}W&xY5n>&ek8R!O;LLP}*TW#l0JQ6s* zt=@&hTfw=_sDJVVxtBiIonwU*8osyddUly5DRoY*?G=qm@WFN48lub2)B5{M!^_<> z_h(=9{~Yffo-T!V|jLeeYqmhl53aWoxU zE$i~~*zQF7)`nx>ig+2x2zCto{qv*=0CDwTLQt3RX$~py{nJr9T&mE2zRepfS*J7k zKn$PIMoor;JO63nPh;n5#zInZG?{{*moz_*V5PJmC?>Er56@qS2)+%Ptsh}asAMB7 zBxwYP2`_*iwjSy~>+aT#s7jF0Z02okF$SI7O;}JDPcca!OiJh&Y^1MlXxv{EMUwi* zO9)uP56s0W8$N#3g(4Ya_|0Dy@eguP4Ilon>^~PTtq8yytj4n^Cjn%;XeQ5D0N8EB zDn4d^Knzwr0yaN?Sdti1qzW)E-h(zCHWA~RbT$D8+CL8ZTM4laIC6YrXq9UD=wTZH zB*|Pjl^SUc`5J2CG+m1Q_DL~Gyt}#}fqY$RplAiPCePoVNXWlZPVr1f2#CqGGMzC& zTyuIO3X`5H@mE%g;WnvI*G2U{UJc4EZrg`-%cQXjsb30GIoq-!*FcVe*oF0~5y|Ue zd~>15c$=8EWGCb2qRml;mZpu@LPly=(<Z=TVW;R`H&TSkAy)iaOYE#jX-U>-?+Q1ylPfD~^vBPR&Hu!EBx^a{W;=7T ztsVV;eY6;}^gF!-EI9!$Iz0z%L*sE9AdawdpuTGn!-h*uhzt%Ft{oUIOIW1bg9VS8 zJGodcRA)80*NfYJa_%aZ&{Mtg5|w)P#ZuR7;wJ77-)!sFD;ljBPcsV*AONaXE+|#uGtt1I^u3^R z3pXRKfGw1b7$*G%bHm@qFJXr5!N&K6S-B;+C1J#@_Ou+F6$`_0szz{)aUeujhSxrsjJiri!q{D#j&ua0*rNFN&0;_YK2ptktvpot#J)qrVh%yP+R`(Y&EniXw*nr*M ztA53XKe^Z%JZa;%r7WxeAh!(C_lH8#T{ScC2j_>-@;mARLn+rWi27`fenhptdqA_k zoGlSwjO{9=%>du=Qr_1|at}0DDs$<~| zoX4m}S>i{K4?%3gJtN;qSu;6QjKbZLoR(@C_W0 zSV;15;BdTgP?KaZbqW2t`SPi-B!w~srY$k^vL1vhSuqJ3Qg@Ex5K5!5SVfAyt0s#Q zS%nFA%f!Ob0)!3UJgilIIc|Af=iP@^>gBq>%)>RN>iRY**j}zT%8I>RElm}ajzAlu zMb)gcCq?A$1jBoj7+V{uj80$r{$c%og2{0*m01=9x?AYt(`<#%!k(rK(U5ir*m5AF{GEuQ{U6N4ND z9Xry6!Pi<-SftUpO!6ot$AhgF+ApP^su53Zm4b4CAeI#f%OgPe!lrwLB8_No;;?wnvzr5w*;1WG`rUKPXAm^;JieF*Ba zimaD+EZ5xAt3BrTKTB?cSi!8=EH`l^>G;d)Vv2$s3EXr00U$C-06^Yo&!Lxw4+TUr z4H8lrt_5o`7N=7j74fFZI$$Lum*B)@xd7D}Y}bf9x^G-0qkky0lpDfTOIR*dJKR7F zsvw{J&^&3cv?yz1sHIePS{z_CO3hFYCuj`zRDbo{+%#n}*pzf`?)}4NnXxUZ|(Qgd63lS5ED^hL<**%d4 zPrHgSu<^pWNZ7dC93^^X^UQeI3c4m<=>B}9b6 z9;s$hD&x?*nCNl)e(TXW)<#KAABRT8%v2x)7iIj?XOJIRI8LLOSoTh^B9PYE`rJ;j zk0zjGaaMAOYT`pV>~Lqj$J8(~DKeQ+vV7FJ1LKvk)it~DDt4v#)Kdz&q$5Se-TA#i zdlVTuzow@d)&->D1jbYq1Yj8%7>|)GaQWpUNA(10YA8v@SCJErLdE~o=9+17k8h-g zoIs28?7DM;ja|5p)k9~c`Ug2mr2_zD?x#W%QSh%RRmB!BcnnH-s>*q~YamknS$9yb zN{^F=v`NpAUxq0X>A7z5H0_{dsS}8?-dNGhYTCb-{%nC z$>DQ(pD%I4KX38Mo13dcedK-86;Re5K*r+NvTy(*31bC@F*O>+gIp=Me zgCLeTtEwxnRQm!1_xpu^u&$a-y`PC=ZB6Q!?ePuP zfVL7bM_yls*+Ij6preB|Er_1m+}hat59ZtJk6SOD9Pk<)YlyEV{;;&{9O$I#1SAGb z^#r1j2m;FGxTw zy9>)WN>&c+qjRg;d%W3VxZB$M{L6F^+&cp?ixUornnuy)0aQW97QN(P7Jq6j#+ez4{bVXHfx>1y-Y)cGT zjh-xQl4^u0Gfro5mumQ=H~(*!lU{@UEIyzcsrVRdgO^2(M^|+LNU6R_wRZ#HWBSTl zS^dE_3Zgd7n?=w0;>T^wDwPE@u{dnsPzDJ#d_)z(z%!r^;9Nr*dPD!d zQ8-O&8`B_nmXZjJ1Alhhbd@z@+U-av?oL=x;v6tpHY<{W`+ZMU$RfY>Y~8y-`u)#K z1X}6s!&IS=qH&!*m|8V%kvwx?TumfdSzq!#*N10p3rhtQ$QU6g!~JFfV~t^oBgKLx zVwqGE9LzLG(Pn^z3O*z=?j;!*gz{&EvQPWWedS?Ek(6Pk_F;f;W>CtQ-Uhy`W@DU~ zlhsOfhJOYWOEm;AC+xi+>ILUHYjSLoa|qI0ib~16K=aQgkpv2jwEHsrx;n*v)3dh}~fI`NSoosSyPg*n#7$ z)PzARt5aH>+0AWA2|d76n!I2QA3bh3$@#0&iOXs}vEIGw7a=fQW-+}mS}gx*VCAt_ zPI>*jRb9nksqmu?ARTPCBpSt3ij`Ibu(hS85YF%aO6jjqE|mhM;a6~Bdk*Yd$fJR^ zB$0;^{D45v4QfFHs?np4XjZnNL4GN%eABsy(N|T6SpWOTv-!uoL8_R!4XJu-Xu`KH`jaZz*Lv1%qlxtX5Zb=z`N1&xI#GUdft!z&NA0Oi$Tq%p%FfKm^1#a|DKN)$O*2;H3$4n{xd z3*T4u*;Ql;-CqSqzNN@A=JZBcK=-2tS20!pFx5Bn`1VTFU!KhMIy&4b_N$2!nW`MG zuEn5*L_OK9l#}jZvC6u7IMQu3VPR6-&z50Dle4Z%@msm03 zoP@FMPYk4k!slHv?+2V$DspAv4BE5%_w_6^n>t!8AG?oAEqBnQjauvs^v7H>xroE= z;5=`+_?MrkrU_|#LzF6G#-Z``9! z6-p#RV1vxu8%#fGHGIH&^DCU^X_L()q0<(=|AX9dx&9=oN4&oPa9}?gm7}f9Qij|vYDiUC5)7buaFBn=!m^!E^T&Fs9lYrfQ~6ic zg(YX-V#0ZwKl%=*7#Ge4kr%kq&P;|D)E3Uyj`tPc&i8oCC@a-H5^yeG9Sqq7V=i%& zqc}!>9fbpFO%tqjA-vHZCUn1TAADx>{)2~y``dLVqMZf-rmp6UR#o0+Z+_73yFysv z@E5h}pK?aP7$M|0{?EcDl~^K0Sdw5rN3wBVVy+}Pcz}g)GP2{HJLGeMCb=Yrv?kj8u@whDAakA>0HB07M2aQWRt*bB@gbFJKG@#*ZD1x^q~D)P}hb>Fn?b zh6#%ltVpDYJ^yMnQNmkFtgC+b zr=8yO=)&u_T~c2GFTyA=#i)Vo%Pu3OJ(H}9rdE@d49c1w+pVr!**KuPc1!TUvz)`- z|A>g*oJQqZ`_4@SpJLWIG-r$Pa)}~18Vqib*oWnJzVJCCPdFit3LMw(;2jPkOC}&S zjWRzy4qfY!2JUNLyst9wi$2R3qx8-YHjTy5KgeA>d_pcuK_$ct05B;&jho~FVDhFL zw0{=7TG3B$8U6yo={!xZ|C(Mj#^ROfn!Y&FpipJE|+R)yG;}BUs0M|iR_MGyck+7;wWywV%RKBkXkq>JsomFm=xO{MnwQNDddGkJ ziFwd6w@2I`78p)bBu|0t&F>g8z>OBm1`ShzA?bBK$u4Wff$V)@%U{_2Pl|yuYfhwf^>twbq-u z{j}{bYB3YAAgyT{CK?0da|d_Fts?ze0@E&5(WsmVixd2Y!HB{P>$uT z;J6;^6^DJQ8Cpe!U%~lbpeAmKpdA>vIDp0PJni&VWeVO}Nhxlxf)^hrVYLbpi``4c z_`_!U0b)vvC&}(ejiH?*&#$2A0Rt8@$Iv78VxL0 ztN9ahDhZYiO*4R9h$BeDw{jk7*&saKVzB1vUh;05{gs|ExgQF(7BY0Y2V(`%rMii<;Ic{mtq~{CMkzoJJuWu zYEHe+<t&CZ+*S>mr@g|=L zU}J#Bzk=SuW)^J80Q>;zzJ56OrpObLUJJ5FH3SGsJh+(BUVpi@<7ui&^?_4z-C<&8 zQxj&0DDc}<8M~R(saUMN31CV^$}PK#)n{RucYhT-k= zt(8coIx;$fts@^>dLYm+(PhusDF~mx)Q$kkeDWwc6Zc`S*mDjx(7?P(0{m zNC(EcNt5J6qU3YWqrwb261#n3c}EXx2UtY0N;ilWNHdgGzi^RND3v+AfVl^Og-Q4? z5{GHR7|3^Uiy_NHAWaOA@S#Tg@g&jh=K_~5$}+QH-_=3&xaA7Mwo++za@b? z03Q>X2%Q=WG|nLopLIxu704n+Vc}0A9fNTE2f6nkflnvDuoYWV0KgY+4RKN$fZ7~w z)t&4Qi~G&mub~c*?lT&INEU2gB`k5Gz^dG_r00mB$L>O5Iws)o)w@U}0@{LPlq8cZ zW8&}-I_M>iMTS`f7{qWw#u}I^P!$jj!d>|lknjEL5Nbep zp+1QuM7m0snL`$V$-$T>i{vw3eoqR7{q@ribZ~pHr=+OE%yg|FN<)H7cFc$%ItoRp z4SFAA0l;30}b{LDN1tUKtOAne4_;%1BUJkd}F{aGUkJk)uok-=I)_@)OaXcww9hGYwsWZyON2 z@Sq42xi-M^B;9{1&kXetEvgHXD?Xn zE0CtGU*(S{g>M!iJoNTp$Z-0+eJu zqpG@D@#kn8o`)2qSwEUN-XiY`mfi=u`;0TP4i)9#knpGMT{EEPY*X&ozZymi~u!p)MNw3Waqv?UDxCR+E>!!k;MCnM8b;2QspyVxhig1!G-8MQjNvp zIVYg`p1w;aY}W7Qorn~iSAo_S|NKeo}$FB zfAw&5rtz(as)R+}Be7N6pFv`qKh@`Xmj+e7<6X6aUbaAg`@xYU^x*;-6$m4Tq72Ex z$NZ7PqKt5MEEFz6D|vpg$`;J*=A?=yT23{PLc?jM~^_2 z;t$o&i<}oxXzEgrEH56@;*(;y5XrIUKcoo&BNvU5vy*;}EWl+6hJcw?Mwa=?WCo83 z+vz&)Mt?JYhU)=k-2GdS9`(cv`iVkG_rONm!EP5tUoR#^l=WBupO}^!IRw0%LL@k{ z!sdY{AX%J-8NNt9cT2HL+yzD8XD9J8J9<-XC5ZFZ@54k?kRdP8f^l^Vq!#I$3p(%v ziE2dF2)6{v=(CvUjSOlOh!SrbOppYH$&af1gIs;L4*&|$LUoT4cZPQeN6&TCySoQ>cXxM(;O+r}2R)bH|IWPKsi~Tp?_Pj}6rVev%*u;9mLFAF3OEAH<*%C_jIU+t>p=gj{~hQ=#W`8dm{e&UD9DXR6w*i0}~ZUlDAS4iYS$z z+9J24C!ANLpTiax@HjCD+un3O4d*uK$&N!YPmVt|Z7bQF88|S&RwG%>25uc+9vGkC zUB`;peaZQS9j{J;X<@o&OGEb(RuV^$+A&1_Nb$H;!V(CbUby3#U(WYE;!aU*}Z# z^%`gXn!`Q7*j@ed%n7bHGg?}_Yt%*|iMiH8WK}f>v$OMW$E*!8Pa}Ji`L|J778+yD z#=={VqmkOUK%MZ|$j9D~Uht(Kco`1R2LOw+IwN% zgTj}G2^11MMhm}QFJKD5`KrmKOHB#e_=P}dsq8RkvLmL;AD7C*kW*_QjJ_*@_i`uk z)V_AiSQ14o5e{b}c`)@5bq$%!c=NDh20yPvjFQ7zBKZ9bI(~1y{)b{!Vn*hlhGw?q z9+XN8`C5I~hwkanrlcX=S|7U=srMEowTIEp%v_6|H#0MqUgY#E9iJWVj{Qd}Wlq>a z&LCLpb4cLlKFCAnn&$`;L#X3n>-idXVc3zqS(Q${kL9UxGnfvSFAFDP>>gU#)_=K5 zfP%PES425DFQlAFj{u3uG#4Qb1_tO4SIDGp7(25^@Id+zlcmi#mlwGW4q=pL{|N?n zk+%Ac!307R5dn05FvF?ANAMW9T0$d2Hu#5vQNK(@uC;ii_eC-rWrQ&H|a0<+^;}%boh`RHgYgbGR|aozTIw_(`t82=SH0q1)F^s~vl zO1jRi6-}g-5wHpCJzq)gJ2ON$^JkI!dWa>7>td_K?eJa}x zw*&mZRC@W?d+~wB>jwrGNpcj^{J$*F{U5jL{!bUlnTjG3=f(IE27*#yM9Qs_`KTms zcDGd9r!`jNts>VvQi;9H5AI=`@e+ukSoBFW9Dmh*8*i(!$`-2Ga9`uTCV3q!W}Syi zDjH{z99+m`kP^q09FBM-5bv>k%Q8{eyNb2rwHWn%=0Q2O6VQ@~+w8~{@p{1HBWtu#Eh|$j*PQvLyz=r*oj~Vi;FK1txlNqr}d?S?Z zFRyPaY>~p42_M;OnlgDRQx3L>$G8QxQt{hxPm}+UTT+|{Kr2~l+AzvWN|;U( z2tem!rsP}vse9R@h^_u!+Ej&h8#ksq1<^PkYfa5MZ8`#LZ!RslSg%;54Es&ZqH!Dx zFid}&9n*EdUw?nohP2PEqwXsW);Uk-BLUbql}h;iId#{KwGi6Q{ajQn`TvWq|BE;k zVW?mgno4z~U4zi%bRsjW8aILI+a3-qRl>xuMU<7)W~GbM4NYay7n)DI+f()Vv_-dKu{0d_yg zVTq2|#DHDO&EJMhY~rf%BGluoIJ?{qICH(_BzG|KN43ZOz&`%|Fm(V}Lc#E_P{!1W zE%aQ2rhfaW_0M<+DiIh{A@laNcNY{nzNs%pRONToe!_bcs$w}% zx+#RwcQbGjv&3EM`d3zoc3Z!Cuji4^R>5b_xnS^-%Ido;c2S2(u+LvcXR$ ztEQN)yKWHW0~|sPWiSFUSk|xC;PqE9_$>tt2KUR_{eM8t7_=tJ>Z^p{EMXo`bPJdcMQYn+<${|y zVt8Qo(`Qz)(^_C`ix=e2ulkLP@HQxpqpAB{rOhyUCSMn)b_w;?MktPjluluRqruY_ zd|ODa6Q0q%{rh0!JX6|jsT&7XhnX-RNeMR$NnMgrZ6>$qKA`F+j|GjxNyR_ES-SV? zg>!*=QU1p%Q%^eu?rw^+J&7fzwBs}*RgQ>JG9j05f|7YY+Q+mQHmF#H!VM%CLXSqk z0s|T7OffXBC^=Cie`_?_0${7p{jB<-1!8EDsxsuzhdWmy1CvXfwTouThWY`78$ zDTYF^OAW-MJ3&E0Z>BOLfPDpsi!79$(isn(SJ^gf5E`8TC*^Gn&)JbBjDbD~g6+w=hdf3b1L~sNB zvQdsyEZE|@M1X{#h?>>_(n-TSJBm@$$Ec`+KBCr!smPl@nKM<|Kw|F#V+|H!aQ--r~jPHpyM-Eh2*GU(EY z=hAZ6>$G$iE&_E+I3yR!t-L->JZXHuoN1JEjIY>*HtyK`p3!Oi)?(XAXVTqrz&@Z% zoJ9Uuic_Oh;XkJ-32%p^KLXSzL5OfG;$5h0`wV@JYDM}eJ#9N(Z%!r&{TfrVS~Mbk zprixO$>e}{ex7A02)wUg~Vc0j(N1{q7&++m6$@%2D-_{0>(-DcVc$xKtbe1c#$Jmr& z#6?<5Vru=k=zcT6n_&ibK|gL-Ffr_CYK2I8Kg2oYbjRrFRSViTcO)s;2YRMTjDqY#`JUYYjJZ z(_2+Zq(C5GwuHM-j*{3-Tv!AHN{dj_7&l-F<}13OJ5ml`DBN=}l2cT=zoAOLvOgsP zrbjRyX#sk$zu>TrU~n`S07F_5G;Sxe?*G`QLnbDOYO}R}Ra#-dZJH;RAd%nfytzY8 z@2+%=W0r#V!%Af$H#lkpXm5F>Wf3CSB1=edhB|tZH95}ZeJLGaa zrsXvKM(|6aWcDwkrY0Md(+(w!!61ft))2{a_VHP#Z)3%LoLI)7gRiD?%>ET{lZ)_1 zGPkLyK&P!x4SG*+cFSvYw|YW%Th^u={isu=_ZvE$J7f(q^g-2}JlFQI=0kd8&=CFr04^LwVmwqhza*1XfO<-Wz6~_) zEkYgy&{R9UwnDNaddd_eTiFoFw6P{5W^e2~?o*N3jdw|Gt5JLHlYjh;XJMhke)Wy? zVKT+`h&z{pY_%7BcjEV8a;|yIQ@!)h72Aw=l_ypg9;m8BeDuumRLA! z+*9PAqM@oIO^F}$H|PHkx#@^!0K#DS%FoZx2S+h&@PDBX`3YA43A`YXZNLqV0DDjT zlc21kOe295!pFK2t3i4bb)+ZX){Z624JrGbjuYOMhcEq6tP{=av&|gMrBpH*%+)5_ z?M72N;vZI;9v#yLonXSHozd;)%zvIMU8|$HSUa=-ZVj}nzSxMz?DuEwcn{I*FK;bu^nP2LcBe3LB@=+7MnLtmXwfOQ17T9C^(3OL`*dGjYUq7Aq2E< zxelW>z4Km)if#d5}}~{+X@h{d8PoC&7z{igSuS%uFFP zVOvwM$FK<4HlU&g19zW<9y=Ljy<8$0z5Lh|j&MVI@Mjz(a@TI?s_Zw?r!%VMV}Dwr zZ8bMK>D#rkJY5{8$W@7$&~aN~qi+Ky_(BMsJouLUTx|YikNKofNIuSw}B^^<2|hW^4(Y(ojlDbnrJ1!5Z}5vIO0_Gl~jbm;wBwIKq}SKZ*$|K%NXXYJXi4&=ANa%a{mxj(}{)8x}T@lV`_zw8OBmV?GO^68T6 zTwrK__13S>EX57R!$nL#kyTC_9XtF04*~+W5sNreDmJH@GZbx*w503TczSar_8V1l zQIMyq0o+3q3tGnK4`njyA^eyv?7f|QyBH~$CnL)ePRR=h#Oi_ks>4_}y40iy4X1rz z(^Qj<3oBYxX|qA_?kj_L z64vY;gwVIAS*)(NT4`BkVx+<|sB6-kW9B99{%_ha)Psrrc1`DD9|gu4mZ;VEQ%rvH zDiSQDOnODXy8G{Ak|@pIUnF>kz3S7^_IstZ-xnY|Ia9#r^c^RiFnv5>tus9w6%9Tv z4VfWBv%ih#E5tmTC|$-e3JD+L7YvvZ9tg8BPFxrDw-ls2vfv-z;10X_C?|n`F5zt~ z<);>YnfiT8${8E<3j8TUOq+vEYrSkH`*WjlUc>sZr+$YjK?!w&IyjUJe*?)=VU(wGj8HMPDdzHz1SaL<1^E~&(lBH3(K%kb^#qu`+iiX4eQy)3hY_9!YjloL_m36ERMucbL5zje^mscw z{eQ?c0Kxv`JLYSznuh0wAuqN@r~LR2#ZvTLtNk(A)L)Y$*CFRth^2`D#WMHU9N(Gc z6g0F>UGv6u(HWvPipNtXJCU|a8k4cUXQT4MEa>!0eoxF>Il`A6-d6IVQz|zW=Vaz8 z>vGq>UB!qx?NN1hs7Ha%3WVvMFIOoO(O?fwSO&kvpDeyNw_BU|Z-_!^3(5=sF`lGE zb49`8R$SCVVS*%{E96c_(qL91WfCwN!7z`u{m1+@IBIJh13g)?M0Zx>Eka1YQZ68X zerzvb$?C`WF1**brl*nbE#&l7k6hB-a!cD8;>+Dw>n{Il9cadWesTTKYzREQGgEFzP;E^*4Y67@XA^{+}w4MMZ7j1b4}*13^AZgqBJs9Iw? zM%j-hl1XwZid4<7!alUt4^7F_dlHJJ@+s1SVXl`__c9|UW`+@MtbJC_#K_W?tC6ML zYK+2yXpJd8&@5+sBT-!G$)KILDk(-@qD4LRg@QT@-%qFPdu29%- zN310DOnJan9sr14Fm-C#v!Y52E&s%w9VfO$Pf*dRHSS#1;q1-tOJXR#nW1xA-E;JI{*F-b#3AF#&FkKmNj_%m&G<;vwI9N z>ts#_{r;L&Yr)DQ3{zgM`7!CxMnGh97Q=-!TQJIAm2fxM{JV>jksg79aTC9US4+7X z2A5&_j^cuqwou@Q&lSsbPvK}(1U@xd^rTvpnXEd(pnKQ3u~(|G8{?16rQ}9Yj!06b z7fTzuqrH9SqRZ(L-htiiW+$v1&ExcM3%dHH3+7v%exV>Dm~c2v>hC}I+CJmf1a}n{ z);S7q1YJ7)?gG(h;%wnNFedfDy{~p3N6}#U&lf(0$Mz13ncMr5UYEKCzjx_Cwu=NP zNti!hg~`8jDINxK@&ftHw~^q^Kp+u52z9N4fSZ1ys=_E*l!s7CUM?nNt8hdR5a*z1 z(?t)PjvXne8eWf7Cpd;GhJVuAx~}f<+Drzk#BJU2=<-=5L;7)vsjVZ^^_A`3RJRfn zbEb86`G5A%CEgePVUs>TAGEv%gvz|X7>+U!tQ9L&A070Q=Kpa^j^Go&bqwH&ZG@na z(oC*kiib(;2=&JuSUMgAy)S9R$jkpWPt)G6YKrmt<^S-im;XJZ65%@AdU?h6X<+G> zr|rPay?C)mi#F4+0-qSxh*^4_hBZ0yzW_aa6xe`m{Z)iJu`j}3RGH8G^chNNnq!)J zDOGDT^d4M2rWcfXK zgAWkTfueBLh78Rj{b5Q$S4IxM+o`4)?%W|&EtTbO81^tzU=#LrX;N$-Hx9b4*_J&g zJ@VE8V!!M(`M@cMo)7~vU-j{P=&O1j)i+8~7OJWfmjp>+lw#67zRnU$64L^wiR|&H zYJJ(SI1xes)JmdeuBe+` z2An7p(o0`tB#Z}cF!YJa4C4c}-GpQ_)xK+vKjbYACXHnH(I;DUs(?OwJrLlzmQL4Y zl_;Am9LW4jLAW-)OFhR@F6}NJ07-=Ts&D4nt#kU`Q&tPk0>8^&cl~)c3`1XYZ2Q#C z!+~FkEHO0&0Z=ZuM}Y`rKLlmv_8i+-RhTAF;5JPMVSz}pJjrcys6KoCLz83TN)BWs z+XKpB6eef9n!-rb8$Z(ks2E6j1^ z$G1c&1j^O_YpjVLLjagz^W_T#Gi8y|%xNPaKfzY6Otn$c*hi*q(?j^bilZlr#NQ%H zf=KjUb(CsagHfRBmLm!7-|r0PYt6Tjn7nH5jdaz~9RbVJW3?N~m1^dlyr&K03_E1X zYd4Cm(u`rw(7Y15J0K;bFzRvd{KVJ3|NLVh>E;_&ozjEB%k;rA!~HX zOwYUJ=nW%&TmQha5q_igHw*FM-^ylql8jg5SNg+Uw9~0D;oV3X>!bsd=o@?`MazSB zf`}CutGRES3ZJjh;CD8RC?jHx46PM?i9g`aiCVQV;5Qrqz}y23BGI*k3lIFF4-8-e zF0qZTg#jRf!jKSC2W>Mwe=5oMQBQ_)QLOLJ=6^|7=J;iwbUwV16>yL$n>HmCZe{Xp z)!k#M#ebUZqew9hp@kF*zb68vUn#hm8pRyUlRphYkfC7+vGH1(4b@3kcO!PM|HBoa zBe8B&)v3}NAAP8la%JQ`zQp3QK}r=Fk*ZHBCzm|#R1?Z_CVeWnI#U_x5GiNoWSi~<54dnNph9ldgx|=i%1v;@2o$mq zj(ykxYfOT{nCM~3DR1*0C&riyAMW-qukm_mIy!589dZWtt-D#5fvNW`oiZ;Srszuz zXS9T6+u~?OXP<5eup|A$?GZ0_fP1RSui2NLu(kYQa~uq`FfnF?riCJJcd=uyDM8Fq z{BXhO$dkyE|D&94pC1N7?-(y#D9GH(P*i}8_W3ct=P1c`w%F{MLeRLQNJo zY4oF*&l7tS%1;$q)EgFT()}wKC6%)+mP_i@`ecZU4i_}CST`{p35%U44uF*OK32}~ z#Tnv;t)2W^PkphKV)5Md&;1BIn=lX{$i&vXG5f`GeOE69JlJ|aZSZN2PE0S(22V3Y zs_2cbL=H5F`K(k&0`EegTL3^>w<(AM(k+68Lg-8S5Oo2<92$VD@n2Z=0kbaC1fmIG zNtel|K)lDy>4#O}5Gg||WQgakQ{HK#Ysllz{i_!~wWX^wjB2H_+e-p;VgfE>^apcx z<+kWRv4pa!;41WF=;3f}a?7@J z^B+-4Ho1?;2JH?H0%;AO*2m*qDH`DFeP0b}y-c$Q>+c3XZD52gir$+7I+U^dK%c4W z(BD^gsRk73mOtvXI)}YVvLDfk13?}WM6D_Fd& z$B^G(8k%~yn(g&j{hD)kw&%G*`Ag=9Oty8}5}s_D z_*knNywZp%y7OO^%lLL22|Z%Ah^HxYtBqt`ZA9sgJDtHZV{|z`#Z=xL7U8)CmuWHvy*v<|Ymi z{Bb!sh`}g44q{&J+PTuazBKEUE4gN7q8DKBo^bp}=<=ryMgyGtTi8$r7^Kd z-k^iA1A_s8NIZu6sysmX@y%Gu1SwlXmF;FVVRW&nfzdQmk&A1`iUt}7%GvJV(4X4e zp?}YhLl*eQ=|OA~IHc_RS=*d1f1b;boKmW@z)B3Vm%iU~-yFchiV%Q{*64UB!GiQ; zFLp>N|Anl!6cuODOArhiQlyy#00N4g@Hd<05-yWCJRhJBdr2HSB9YL2F7J7i!EC1X z2n=9QeYR*N9R2=H6Dd$szZk}8uVA5@NsdoBI>Y%yx!moi~?P~s*N;#*LR?emsazR#~d{N2qx%}G57PLjfVttk%k@2J>%vXb2wq*r_tRJW?ql%Dn#0ubr;E z2Z~BoC6&(-pL%;Q01C|U)>P6<>59#A>4xZG zZ+!-PKCdlh9*jK7l-o<%spmIR{2*tE(6DNcw)r^u_yz`NyJc%v+MoFGon^gStk=%e zxH(5z^9d4RNrZcqdjyMZw9Qjt00D@yYCxvI7KAVIB&3MpnSEt~^_H?lj&vkO{l-8S z90&@zs zk902^gLP5ua}wV!9?cY&rLEAy25A7`%iYlB|B#EP_XHsDg#Z5O zKm>3PUhn-Bc%h?uJG_6k1coFV&R_ljeWTHU97+a&6S;>@s7qWWbKgnkCu_@Al@1l!ER6Tx{e?!v{VL=UY_gksU zW1+!Bst!5{`f2j-XYakqO(>;H2`A-Zd==Cwo@?tqV85>Rt*5m1+RHVs^fLuaUyH@~ zyUr0;VxG|E$*q^(Cgl8*{4MS6wnX9=H}XsoO5hcPu^vOws$#IG%smw>eV^UN4FDAj zPS^=b)vy7fPCW!Oc!7~bkpTvNf{8XPJzl~nG%;0MO0%p^%C!>Cm{4tgVa&&oBm!t| z)8>^exDr=XP_!=k!@ZoxD$DE4ljX!r+-Yv{?NLc_LHj)#J9=)gqO(DLZ6(x6qY()% z1_M-dgM}jTBB;sn2LOzAdBix~)+6k5K{vqp!h-#4IHjov8(CNgq-zCK?=Z$4!M7m{ zqJ?j%%~d#Q?`>~?NeRa=@gjJbKQ_4x|9r&Ml?}a&u$A7W9vrm|WRvTntbp)cA{l>p zZ7DdI_JplFP4_7}PUgGiRIoBlN@2Y5(qa5Ke7>YB9}x*x8_W+3|aUJs*tH`a$;&z!jOQ&Xp}t|WmCMD3x&hj z0&_-p>h19^12cVfq=KF_$(f?E$o*iHK5C>%X{3C#>%Vn5v0-_CD6qxGD?Hna7*ypq zqaaDNEtk(t5~p!ij4Hl|h&Df}Lr9c)xNt!miq;RugJjVVZiRJmBXP(OGe;!RD#)we zM!ouwJp@Jt70(aKequNR!o{CCIMV`|h@T1UrE6oaeqgY~r_pi4)zp;W^0~rNJ+r2NrxE`>``{r6KlQi zfUeLAuC|WdE>A=lU|Tp7IJ1&`ae-F_Z0qaDptmB>3^gfbQBok#7C?Fxu>I)Q>d*)V z-+ktjg+N7^yIVjog5Rfp;4KY;BCQY%rKnLv9TQh;O`{bteL|!vp`>>yR2cjUzix3` ztZj-n!&`)ad%E zk;JXjEJ50S8AGDmwGLn8?2}o%t;}##GOtb*5llQ~d_tfJ1?Ch4rb?Bb4=|x7X8*$u zigtmy+#x6>39e@jqsZs=ib24X(V2rcn^q`~f2KaRKO}e_ zou%(j9!u@G)5%9N7_4!najXV_`HWYfH!;f-VGu@#1uQ~9nIH%bC_1diq>( zJXE(ExAu$cxU)n;>Z{#k-GD`vYR#Jq-Fc;TIW?0KSlIkAbRrdHDXa1a^!!T>x_N(H zo!1M2BN#&I+Efwc$qd2z)uY^Dn^w`k%KND`PWXCT-%F+a?;2b26`LU25Rt2%H56=7P1T{Q*D-X+mKUY)v!l z8aQl03Wy+a1`OZ;1e2sJ83N;+BTcN4A*fk#cQ?=|4@YawFsTNUvB6umYX*{AEtuG_ z@^sS8iPp#Xc1bKOe`azo+g^2o5TBH?oE0cupvGVXE5839a*5SF;n0H?^Na0Tw?x5R4u58)etZ5o0uo2Htzek!#77zZ(hlFdS)k4ZAG$K;6Lg)iB z!NpU5o0CtqJY@sfJXnMVLS7aX8Tzq_d6NP`{vzq=lm7}FIB`d->a)n`I*1h84)d{_ zOCaItS)(KiZIXaF?MoZ>YJjx^LqZQ#HTAS^yW2?fce1IQh-TGttwq%>QhT)2b@n~@ z-g7?{4?T)E-;tckw4?0hrru%RCFBQr4o*VQyYp#d8J zD7rMu!%WwlAAO|#(x@$M!;EicVg&o}H^p~vkV7e{`I7i&IzZvXI*xR5-}hwan@mK{ zB=#u@0ry(x5*IA*KSyWGK{(%<;|@|{l(MIM<&}lA1hA0A3e(>^lzox? z$PZH7SATzif9COI9R7`^?Pnyt>cC*VU_fvm4DpwAP#_IFDg^pJCcFv=C}Xj~zxRl+ z>2>uDc@&A;C4=&EB(IaWhZ+4STwB7sYZZs=VxTK?mn0FP|BxfQ?(ir7{CZG{lUZ<> zIM*;b(#KIs5x=sE8W%~du)I&$Hkr~nrT;ifDUTped6Msz%; zgAC6Az{aR7$VSXR*7Y==I~7W{gYJpBX%mu|$~g=pK?pTUxqU`ypIX5m`|g2_E_3-U zS1e0FhMEuxhfjkFIn`dr{&=29LR)0)uQM{+x)-BRn0iWkmPyvnF_AX!?TgM@=Oc2f zn!t(n$U95ij&&OybN9PDu*{9$Q`r3%m-;_Z9;?bx?@@n!MfUpF*&7PBdln4=!2l^2 zdMzm{-IPQbY7c9x^o4+_iTYAOLZ;+~hE3$AZD=Am<9xz`iZtv>X@>Ah2QkQqM^e%V zTXv0^ijA?#KVlno@gdmvWfQ7e#f>{JpSl=mL!jA+z)lGWl7a%sOb|jinh6rOE}BL? z3D6geS{wXNnnRN9$DcZAJ!xY2T(P5GY7uSK6hh1_bxnvgc+vvRaGcO^iP4dL<3OOG zqO|Km&sn28tvizDngkOYE}JUY=Ml-^`LuyGQ1xrwl|6bA{C~*VXAB^OT$s;ib!gwJ zoqAP#Czr=ON|Tbmq#f5Gp<%nhA|fqn=vc`v^?oY9&wpT-%CIZ z_H^s?Zsp$oC>0aPa$ECHxs5h!d^+Ks_^aHIyrYNnw`tbhMazm6^-~-GtA5xAO?03t zp8Rg@$se;AIKKe<>!}yfMZ_|=wWNFZ1_S-hFtLvIc<8lxS%_Tfso}LM58A;1+$v-1 zb;3*i`K9 z%Y%0FU7aIIBP9-s^84p}5cDLFS`wy$soH6LNTOESBJ?0h%(W2GY52-|EzRGIeKgu0 zd(JC=@mFx~cUE3R;-eXVFp;BAYSm(>4Gl{8QUw|Qmdx14id@G?J9%Zo#U~fUd*Kh1ClFYk&OmHzwLu`nUeerB`5D*Yd zd9j9hDEgL(z<9W-19C=Uh83}ZI~&U%d{wSAigZd8DR2;E#yDTE8J|(-cHAM6d%E`M>0~u~ zc+HBp>po3=Z29h|w013aGFZO7!ZqHQ9&fueN4)UH40Eh_9(eqR97WG+G_LD`|9+sK8G`Qmr0)Q&AhiRbQ5{PDKQ%u=}>}Gd61D? zC8~RH1eAp4YD^lZbL5xzt|0GB|NaiW@fE%F7$KK3La56e@W~6p*dk2Wd`$Jeyx)y| z2l!GXY_aeRmv`q&Wii%-bUvQuaW_`WF;5_ZluivA8u*?b08;Up=;rG;BI*;yfe(cN z3hwy;fzZGLkf|g!8ommfE3~$jKiord9>2Y;FtKpqVE@goph{T~G<@8+?Oq-*K-$o$ z+%xeQNP(NiSjKZvyy6Wsb7@&Dc&Aq(8yl-`LdZ5;>rqNkij8HFgViH@fc|2ff={Ua zm))gh(~mmt<9g_Ld0(NFd27qA`U}+rLhgg)Ru;v@u!j24YuI1#M+Q%|-`nCw^nt-Y zgZ185>mmkG3OVYBmHf|T5Px`#%T9Aj&LrmJltm%O4=m;YGndrSnjuQeG|-j^U*sQ< zV4t)ZN=&)6Or!S{vlR6Dzl1|}z6gPd2;8XIR*ww4+Vft#XL^CP*^?n-lG0SO#4ij- z{J4_8EgcYGdfzIx0f6-OTe>g;m~?Uy!<*mXKo}|31fu!KU;xpsBJd6gar|W!)46sP7h8Sv+1UYv^1g`UI=EY^hp~ZG`OW z_YeZeYkuc$XEJqbj? z9HpXiMHqf_VyTV5UGJM(@7q|qp!C&|d7Gx><1frwT+LvBN*LaM$U%YsAVDvgE#P%Z z|24Pt$}tMk$0A4&w`azcDqud_3PKngQSSo)7^<7`?2k!A>|Ndlzh$8zt9y8CpmQ`+ z4m1-gI@q)7nxCy@U}8}^_`{#yq}^ux3NbkJO&;>JBB2h$Fb{MVeo`pZUMbg@330RV zoa2sV(vVQZRELVG)XxQfl&Cp?!4EXz+RFeChR=h$G5vUS+yDS4Xt0D4hypK*|BZQU zoHjV#5nWK!44D;EGgQdFXpB7UYiE*%IA~It!19$qb$XjnNX6eOA6?vTpZX%lii1vO z-%dP;j)B>I+5sjd>kD)>DMoTCGX`1yh^XO1Hb)@tEJ5gc7|CjnS(%09W?1MU?rB$~ zyzFI6lghU3Xb#Uq!5YU)L&LxKH(a^*Suk=ecz4O0MQ8Jv=P1cw(7c8=w8;%IO!3-T z_0k^-0I=c#mz}{IhH+H4t~DskZ~N;xENeO#g!YK7H#v$D{FB&9ruR6%DXC9fR$g?|MQ;uq_!Wj8tJBy$(<{P%@bIgIh)TPfNLJUOfd1zW7+g*NX}8x9 z1o6`!08PoXlEDJmzmQaM_LxESv7lxqJ+yxA+GY7I5G@E$i1M=e) z*~3T}Apx>vM2?L!Y*W=Z+6x4Yn5aUSg)@5<7EUE1sm84=!AIp{v>wURi+bT&Y14y$ zH^AnA5oreE@V5T^Z9-KfIsv80s4z3yINk~#rvmu(-LjADgw4~+nl#R?>FNpWVO0s` zH&Bkj@Q~%NhdCb%nCrr^dtvG;q?%t_+bnb9kbQWfdnjqTiG(>U)Hli{}|U$d4~O+#T+1cffSxU2hAh} zhl23?Mq?IAp5_m)T*+`dO|q+Vi=H&Wy(I$&gIvgP_t)ILtP9lD z2>jG~qysKpeB474@}L7m#bp7p@rxMJW7%)hm*kPsfBTar z?k1yVrP~V!L`5>fQXg_>O657Z+zOlMOu#f2G$dUL7R?{Lr0gUpC@SjcQ|bW_Djlf4n(Zi)uAgc012 ziwgInaEfWo@LQqs-Lnr zbTgFIS&7&8orW^@Fw9FB$11~5p7WA5vf0Wf@pK>nzbH-$$AY@_%1RVR&72}GR^U6+ z^RZmmhyuU=qu1ru;yI~LY;%wOiqk0Z`O||i?0VRCMv?G)_+|9QA=@(`Ox4E-E3$f9hybu)(kPtg)tKte%`IQ+j?#k_p zK2lRv)nJV2?0t!;l z02Hy|so+<3ysAu`aC%G?DBg_DPfr$D3h3pQmyMcRWr^3N;|ZBTVS-5)I0g{}Eu2)` zFPW$6$jF1^oz<3)w<<27_IX0wgNCJR6|-3~`4F2?2j|G_xn8#3xi2B9?v0h4(|k`K zI}!-M+Nou|T8&riQpBJ>7&v9ThB84Q048R7!I_2)r%3mBG;0tD=fDPB>_24=Y-3UWnjz@qSksk0Kjft^u%Z zhBvEyo4pRIA1gn>9)t`<-Q1`zH4QhK+c`QfIM>ShD0~#%$~Mv2AH@N09n@T6Wr!w! z88y&}2ZF)iCOttwsSo`#cc4EYCZh z*WGd!K`Sz6k44t`17lrf(R+vE(GYzzO`6-LUwk&l^Sf~l?RIX3PrebM`F8ly`BXRQ zk1u#ZB~6TmK=ddeHBpG5A~)0DZ%EMN07%>bF-20Es>%5;aroz{1vOPePeyFSZ{X6BvOJvYP|Vp ziBfA?l)D)pEUR|cw1johEEZXb1jQO=Pzh95~N`d)~ z{@-FIV;mJh@cU-QC^Y-MzTGwO9!rDDLj=PH}fA?ocT1v}n;R{qOGC_kBJj zC%=z5lgV@MojVgPyqjL_i|G~dUGp(P%DL-m!h+-YWSL}#zPgSO<5Oovdaa905ypf2 zO@sOUF1!6K3IGI1-?dI;SpK&TWdQIpkO!r6)@TEWe3~?`k&QFP)-1#WtWfx2FsC8l z-LrfLdf-j++*&5K_bJU>qSYAjct%)18acU%feR*L5XXm#_K*oxe%lv3KwIdNzoBuI zuI?QkC1e+x2>|t8mH_B$tw<7N`1>+V{b3I=Oq;O)(B&VX0NH);FiOb%Qtk2>lN;IE zrbQ0l`Jf6v`YC=j#!MbrD;R~SzmW=gle0*FZ^n0qE}?Kccf`tTV|e1OY1p*GIWi_ zId#VxxPCG-(r9PQ9C*iGkT**$d7{j)s3uWtJYQo=pk{DF6(nbiDkq8%S<#sd>hS?XxVgo23aslMgk|(hN zC&y1^e4%I);*2K-{nX{KHC5WGoXv#Z`31j$8J%MrRnGlK_);3->SVTRQI!Z%s~8x> zF)X9f1zcQUJrEQ=GFoVy61NIAy;};@mtRN9lVMAQsO@lxJ3*||s1*17zk`NQsHIT7 zq>-`+G&2sY!TKX2GmB3ybl(F`J5tK7PJ5p-16NRilJ;+eD}(y4gM44d**{YJT9kzj z0h_*S_K@2)K?_FO!#%-i=WKDl5v@20)vjH)PqVx1YBTY_~b?`ApMlIrHGa_u0 zR>p=MFQD4Y5#GqE$E~(~@22L96UnqWlkC0iLu*=ww~<#YC4ucT$eTDeTs|%TuX4CR zw)A=|^9DHyOBPf%Q}}Kuw|;-p;Ge^U%bA_)=4IYwJi`jfm8Mr!0{13zQ_Y`behe6! zH?AUO-ioVM{+I~&#bp1$`L~yEQU> zYibA3ie%f!t(Z0kFH~3E)V4pY{;gZUm-T`2<$d3xJiv@8y;Ohu?Fs^T&w4@9yY?Tf z+i!+ zfZt);saeut$K7(TC{77z=ACZj0#*kTC~{cJ_dxTY#*^b%{{*EW2C;L#4=15^;)f5R zNQ}n)bI(g*-7RW^)1;5f%(-|e$Y*zr=0l6Y3)o-ovOi}ET=pQmPm7GHXQhzG(J5LM z1=gM(qCN4quSnk}A>-r;*^fU~1g3AU-2C19#DINx3nKsrXx>6P06^pFmfeyz=GT#y z!xAbo{QGz%lhv_EBQ{!rqg*$k&=XUgTp|Gn6aU@XTl@Fvh4I-MWpoP|o_$UoH5z zmFFMiLRYR(;lwOvvoa-r+c7D`n3*^0^?ws{K5!XNX<+aQjeP9!DGTh@9J28CZ##-R zY<&rA2q%xHf_jKni}VHppw`+dtCyiD9cQ%v773oE{we3u5L)>piIq z+=w{$^5u3butkY7@z;m_-%K<~ERdPcmI}_Jf#a0;QaL4*eo@k=RZsX3DcVn$Zf|)j zPqdds?>D|Zx(NV4^UE&uo^A=UmMD652wpfGJT=}N9ki;Xj;Rtf9$*0};s9Q8<=mE!IGVk80aw z@f7vL5?|x3JjX4ZDZ3zw`1?(jnd9(sq#-;0jCNgX3z}(2aTP`_WvEHhpL9KPEC*M@ zCgf%0wR?jP;ugJ!dW>PItWJ3fc4+}6ZI|@YR3&O@_ z8>M-|6cqLWK78s`*^Q;Nom&&!k5`=*LIDn&yYZhXcQ$3SRF{cp*m!qmH~g4i?Cl@4 z&Ua8Ph7OY!6hl-VkxnpfW`jI^3eec8$tl$Y=}b|ze+`pF~isfBCJk5S1c5*LWI8o zf0D!es1F{j1Lm27n-$;`<|)VnLOKy+?Uu#lLtX31gMcXZ2B5{3(5_jf+l`9u$p)8gIu$~5geSVr5a&|p}TcuRL=Y6G_G=*tjYmOzdR8``3=JF9OlR#KQ&j_{+c#! zgX^Wc4Jzer2Gmdh+nypT5zrn4Rl#&kKA3(^`IConH9PyGcKda*g*jYi5K~{KzxsE* zf(!X)U7;K_(9|kiHGOut31bOv&8jIk=~SARWYu-|r=vHda>eU%$eS7D4F_@QeJ-W7 zE|T4k9zE#FHBrAm_y=#mH5!POt_P0*+h+?I(L|o z<46Jo<|r%misY3jwd=Qj6LuKa|@T5tD66LTL$HLrBC4JWFk6@A)P`PMP>Z5tLs zOcri>*_tC&4^3Is9PqtgsfbzcA4b8tG6q2euV+<(-OH=b!=0}m!i&Cxb>l&$Ov>*< z0!oHW`JrZj8%BS80)sTEpAKVTD7uo>4TJ6NlJBAO)Pk}>^~tBgPToX9`RbwkZ=4-b z&42l)Sl!5@F0UM)YaRrB=au2;`^O zF(CfkGoI@RE(3oy9vU?Yb~pi6EXx1~z8ulN3l;$9#uJS5b!hHn)iJ7vuIMzfiwKoe zIn_SoV|>(qCNT5H>a&~t_PbLNE~ z#=Wd}ghAcC@|i%cG#B^W4+dKY!|!TmhKt8&dFoytP|jZ$h`x~`2VF>Ctri%TL7cXq zD+B)$|AQPP@;x*z)Iyc8!|>Y4(cZ~)UUiD>*ZGmNbb`H zidH^qoIOi0J|o@t`A}4xB56nFV)N&lSD6I{el!V1EN?o_kKD($`%s_V!)B89dDbk+ zDM-++e}AV|DF15P;+Z1-Ra2|=q;lnDf{G|sY$Ob+T(DmE6V`1Yc{lUz#g5;=kB>*X^@+a77xfBB;r3hCdlhKOtt9qCT}=5llDN8 z-=xo{s_kbtT-X$?l6HRUsS~#M>I;5F)j}Iu=?ps9b6lmqyr`9Nufx{~k9gQPAAdDj| z?1kl@T+TxM8t}o>>Id;>Q)ov=1K+Z801FGH=6mV`v{gDiFEUH@BRD!cmBFfc^e;{#7W1g<-s6}y^JQ3_GX~R#U})D0#32k7+E%=wOGY_1Tj^cHG z=!jFP?uJdiBYQd@DfJaXb0iX)0L^Ypy}iNe^BDu)v|R^f6JrM!jcj|9%@>YA9RYh@ zb)}DeUVqz<57ss9W)GKdIDwbm=V)j3cYz!>e&+Wcc1`?FTZS9@*)=;hXP4(BlY-5i zLQ|Kw%kJDC=2y&Q$!?~QJn7V+Fe0_3#+7JkI-_xZRnR5nL+H!zebjH0^@}^9lji=B zT#=F$09MD+0P^llEkUXH@tg??vn9gjg32oh4TUKnoNAwH@ReT!X0!U4Jts07_(F*D&kesz$;a7B|Z91 zVk)`BslFRq*%`#%sY9N=Ka??76b%sV?kYc*g0rQ}W8u`X6OKsHufYLV^+fj<=~m;r z(v*9)9?pej1F!$bOarCsKk_yj?ayp2GrYH{`1V-sD00Lr+#J!1-x+%w&JO4d>gavpcp57Xp~1gNiDDP}#Bnp5J-?=GqD{kBmp zPv(i9qTaQ!(5tZBSz9BMv~6r~1&X+GD4edgHtC0fHKNqr#wmu2p7MyusofM`4k)}= zPT%t0qmV}eA+Ffgi2&98h9;bP%z_W(kJ+w$QWC9*C&(p@Tmpj&Ga9Utze%gOWyU{t zv*D3pa8tA684Qa%v%#nCzSkTn(d^AChTJcboq|+5!FKN;fR(5 zTXRy6*`PX@={?OnahttA$YA;i!-K;wwP(Bvmdxm$iq+#3D5j$ZepgZLN$6M8%w2w1 zNf&(`F!j6%y3Txh&u=S&lx;vRv{4_$9BS8Z6jnW_@LOnhxwwc6b~lT^2B{}%6F1N2 zjD`=Ie?3X4$!i`8nwDF0uu9R0HKAA?gx9+-qmcPcEvg~S-Nk)hj!e`CpjZePqaQP;j!A8n(1i=YVNL=6 zgPZ}!4glC}v%J7Wv}0_Im}7Oqf|F6CTx-VIzgJA}6;Z&ah6^OOD}Q9S)JrjU)vb-Q z-Wz_)9nqxg`})DWNT%L$WS%9XG{ z-R+tFANji1eK{%A8C-lMzqNssJKrow@w@%Gco-BN09um6L-chjzKQ)2nU0hWn=b@} z>)E9lsgV##lUn0U4QRmDPc%#cc_F0)p(b~74$2WlI>Dm!@BMZ7j%oI0Ftod? zr`?+`y)VzFBBFQ0y>CwskiAJx+^olkvW-PXNSu-R-EZ2(D4pV4g54g+eQdT_AX;(y zOs@wOgOW2dyAS@ycr$Y2u%8=MD9JTO2_5kBVAL<)<;nf&(LPYwwuifhr;KB;NWru7 z;1u^r!$0t8a}W>7O{+AOO%6oRZc%C}ZNXq#DjZh(;0H%XjEhJ`9gavZVV2C3IIt4p zvD#gq=sRZBIEZ92<_c)hcOV#4M0$DAGz+K{u5{Ae8AN3n3tm-N7iVa0p^io3pZVvU3DrG|c|NqE%Z#~v-*8l%UKmEX%} zD$*=RpBMydYjAH^A&`>f!z%Ml!I)g;AY&?MU z0-J4kd2GK}n51F~kw(g~Ny_hR1xr)BGalaA1#W(Hc1|dFD0!rCVU2($HUvePa&eEr zkvK-v*QSb$_{Vw*fMH7NI!CYzz$cmmLX?xj17j&hsB>Q=7!0=X&fb4Ro)?*=#{IREiqN! zw;Q~@7x_-rW>zk}(p3Ky81hUrELxHO>W%v*NCOIev{TX~^TKjNc5BJr_WSxb>WRF2 zIiJ8cMof4R8ygV_u^kjaV*3~rLu^oCTD*q>mk`wl8zMF?W(hD2CPHfML1T9WQbDWF zo6vK>p%Y@M!9(kF9i*pxQ}%7YDnujz@H=QFlM^a62v5S6;s=8k5u|LQw9syW-Au7C zHni~$;u#7Qj*GzE8_CW5;N{Er{Vr3Bb;x_P4R%hDQ+FB&K>)?xp}r4LsDc`hh-aGBNB-m%35SLM zGw@&@+|oJ@Gj{kZQ&;lC+qwAbxUYE4BEOU*437~EIuNbMhz$pg59~A=(;)kX|Aq7s zJgFE|B}esV0>1gPh8_iS9aYGI+gP>Bfku?kO?TeW=A*_)?|8K2&r$b{?m zHCNu(Weh*fcq&uM0UK$NF44I37%9IR#(PgX+TwhTccb$4(~;5K<6$5~#4I_;$mWPV zYa9N(E{Rs;dZ73bcysMuz;Dw1ciO=O!l%DwBCEu>$LR3Q;_uwiP^`|h{%abxE2#D8 z&%+19qERLr^wP_#fNg^q=(HMuFsINJ+-+D__$82oaHHy%w?d)u)?x5B*1>+5W~6 zWChS)w?HN~RUI_&F#F4bg>7XwRX^8{i*f1}j^Ju`X#ci!WmV(8-i+o2B*RzdFdwBc z^PmX|ns>y0Ghh6(#XTsga@si-3> zj_$Bi32!iU#bAll%(7LWd?qUYd;8CwA=;kiM+o97-exPuPVH*zVP|!5)1t}YDT^38 zx>Z)&>(803cl8ORO9L%O3FtD&elVrQB4p~A8Cop*k??CjMjFMkOfHS zG+E|A`qTVD4yd?-pRM1htmCfIRzS(+%#BIIFeb?`}8IYwuicX-33DX&c_-=fuV-MlXQ+|~Aqx=syW z6~L6;&10wO-K8KIYq2CCIDN(Jkwc#97n)-nQieb8I9qoLftirkbR!%5{?rSpo^kyS zACv}VncM)ixk&tn$Bpw}E<$9dHJ@b4oI>y3u3S{#`R|s26KtR%^X--l>xY*Hash(} z^&FYn7};>64kEO2J?5s*gOCNh(cxQm@A!hc4bC&UF8=90dB|F+d#Cgw?V;SMCRp5)zB2Vo*ohcQ?$++KZiv{IMFbjUIisk z2_(Y$=PH2q7;T!!mhRQ4+$U+pUk*Lf-S4NlYX7(~lcq~RS1k5{;gCNN@mpR&JRSlc zATDc=_j#K^C5G3#x}CQO0R4l-$dsxVS|t<=J!D}Y0HnXJuL@7_5>&iG5#?CU*voW! z3`ES}$d2qbDa4yhQ2L3*Tavo%Jy~W{VWlX4#g*;%{civDL9a9^)PrlYwzaEw8i!qC z*+6(abJJa5XeKop&iooUX}oRX+sZ1AhP_d1}>;kB6+{kd0<>vYXS#=sRN+s5U zI1^?(+AlmP@Q<=}uflj(+i$|_2(PM;w{6I*((IKos{IH6m>yLg%I32;$2KG*nF!F@ z*Jn>ok!^GHbc2L{IxOS3Q=XDkDxk_Y-(UOqT$#T;2zd@j)hb%bo_Us)w1GnL30~uu*Ep`P$7P6D-jHK8^PKQStL1Csaz0<0b{tcT5#yR)7| zBs*#oN^Bm0v!}!fJ4BqjXk>s3=?xPXVS%lf8-8OxUS);*02=Viljt}DS`Hzj%j9r& zPFv=>u{{huqTg%?c@Bz=W~V&34u$%Sgu2Zq@70)TX&dsI_ts$#rxoF)O-%p*C{a>; zkEBI{2KQ%3a^W&YM;sqsx0K?m3=vrLs$5QxP4_016^k{0trYY#zIlb2#HDh!IU^8J za$H<~F(Q`*Df<-wfnI1Yiz3V zO(dchGg!IDIb9}aP;4890T)LLza9*IRG2SZssY0@q!&&;BC@dQeyPfB;%|MhQ+;nj z-9lca7SyiTCf~q-;%crv6*J0NF*x`SPba8QJ`RXzv@KeoM9--pN1dGh+$7Te9V|aAt3m~>sbV=7 z7J>erV;VqK!NAN{5K}R`;FmD*p7%ucq>~Kwu&r#$jZOvFzvU`oL$u7GNrDag2f3%= zO8|9^)#@`c*R{zo0iBsuBhIfPm-BAg{wPfPmT&?PR6agCo;yv4t?iAVqB8e^o39KE zuEF^Zo~#6+IG^^!7`v!ry7jT`qKRj$Aops*^OlKz$D2h!=QW6I)V|})d44I$yP;R^ zRRyx>9rsp`i2Hw@=-U5#fHq&OlI1JOpres*QK5v8nTVW9QkM##BolxJ5@PE6UkDR; z{>BCqkhCI**AKgB>jvnh?j=EY*2zbCg1NE2RM~gM8KcM^yGCkM-{I&YhY(1e zPvPE@l-b7oY4Ydt9%Rggm4)#oDw@9z_mDTIq`hT^6X|?v`>;wFC66Vy6Ssm_uFb_Q zT6Z)A@3^UCH-QlY9oS=)B_UM;6YN^6QH#KYFZaueE6|RUHg|$hSUHJG(xl&Y3;+PY zB2_UV!h4}QWdf;_+tAq2h&|Jk9^1Tc)f4*LG#d?~@@-QyrKu>O&8g?WEt&L^>fdZd zIhlVgC-f})`I-Mc-uI6wX+SBGg*wJWVszt^!7$FS|6zuBx+rp<#8b z%>qCPlVW}++H*7utr$x6nlzu#)%OtZuQ@Rc>rZ0 zBSLSdQFn~=Q=DZm;>E}bcp-Hp-DC}RjyMsaJ1@m0aO1_}66SHjW`4$wtVw8>E%e1) zZ>#6Twy4C-j07CX%cj+hVMuTq|8So@$th2FN>(F!v}8?HU$iB$mj%4h2yfxbH$Re3 z??1-TUy1heS+g>kn8`zKnV(6Bpmy8t*X$MT}+ro0tN!>+le>;@t$a@p(6V zb26g1@K}*)q*GxT2C*V`n|sQz;;>oR$!E}GG^(ttSUbzB;|>x=SqU@K%kPre^eyFa zhX~x> zFNeUg6o&MTtqX_Md*lI1CNR|Ex)ULiE@KG=PCsPuEfX1YsHp_t(L(Y`3DdStt{`4L zQOo)t1m$876dpv4qFy%y#;+l*G5bM0AVW(i}E@_!f!|-QypQpVTh$3 zfyGn*wYsY0V!-O_1xQoT525m|GP08G#H&=;VvZq?6@K8>JEac)0%;mmYxzR=cRokc znO6uRW7Y_6)aQ)KwVHNSZ|EK26xy&G4y)T$w!Fcpx`bPi8k?_Om!BK9$LE9 zP>F@n4Y)bzJY+~@1OCKNWhpqDH}~EM4S`8U8heLOzj__erNMv zcVx&SDa^I#My9j`Fb!oWd5fMjo>-mWQz(z(Cf*ocb4Z8CMj_3Jr~g0X{=x3Q51=1O z9ZyL<>{}!XP@Xqc$%{#mO$;p^vAI{C_H{TxVCr>#Ky<>xIRJ*Zd=K>evxY$kk? z1o{J;zCGiZoi6ODWsZ8i8HRL(-^tn?a zG+(UzQ#J|m?w%S|0yHDd%qd()n$5(>6UQ~h&xk(=rf;L^rKxzWI<^+nK-KnmaibNd zlQ}K4q*-wj8rU4qhS{V7p5tDxUw+FwL{dUwkUtVJ12v-A<>-kw?RLztYL-zyxei_c&TN;@bVcjhT1!eOU;dltn z{*){vtRVy6uu;PFhwL_AaOiZSVpSE5xNrd4yp%aJ4VyG;a{XmD^^+FfFiWDSdY8Li>`NtRTF#HHIxF+!|Vmm!96_g>5FZBcCz+T_y$iZqucJ z1&9>Ruy6MYm;V@odIH_Y?_JzbTB(qW>hkTS%)NjzQ&gvR1Hs{&AD@P_y(X@8PI!zE zU&nWEUp%nGgC*a$v#$K0-&J#&ycihEsRmC`y^ufK5GoenWfSUD_<9rr@lr~-vcr&O zqa#>fSpvOSj0~;aA1XuLONIePH7IqO!*f_Gg`r|q^@{*IgC~B?y~Z02Kv^;!9yd3`Lc^V%+h2gH_lH361WmXmK$dXp}}&q+svnyr%XR1;j!w=15O_-`i^n z3GXkfoK-C!J1HFz^Z==jw`>hydS|5&D9&$O88U2VUA@Y9YCKavov4Wp)j!gN8Y^w; z=%RU3a)gcL$714ZTfJO4GFW~$peYj-{)%}}R$LSjH-%$p_z5Z;PpWw|@JUzm(@^Sq zS89Mclp_(Z^@StR9n_RjM2%ZeN~%d2oFHdN8i!Du17b6kxNb0$k)6Gvv) zEK>+e;e9#6rdemIG**c=J-rTgyrB{9PA@IVOUt`zY+Bb{!Vvtkmw39CQHfW#7&M0( zeSsZ!XZ5#il!t=RW<+I!N9gH!V(iDpoq@&TaDli5IB!NX9J{>HJS{E|5*qJJTMS zXUykU(J7aLkg9j&We1HKU~?#QP;52Q3n1W~7Bp5F*paV3LXqr3O~Zp13PRC~HqC0; z;IoVai!@GuGf}uN+Pzt=X$X@Rs9GkVRh05f+x3kV6-TjYw4!R6$a%;ASBs*ro=BomC|p25KbF$ULPh!x%!15ox-BvKy)>t83D z3a+%TV#eVf{|<~wt2-NT>6~OYCxbchWmq)Eq4_*f!y_rui!^A@TW{@K0;_1x&aeZn zn03Wj-!|(bAj^eh#bQv3`A|^JiK^7f##I_OzE32Py&6e0XS zU-Nv3+^r2d6Ja>5zk6_XYbCf*I_rIiV$kZ$8u_NMh9OhJX>Z~55SU)s?6;mKN|Gch zHN39hty2F6&35(3K#U5NoUO&T4imZf$I-j(ds!+L!kUI;rdLyjOri{dPn;mIkM2<@ zIypn#4i|O`iOoQUPRF-BNmeyaUOYuP*RY?2jSd?gy^2ugZdU&=uQHXAt4^yiH>B#heO1FZKE##Q#0$H$pLNg9;ri{w{;N4%GAU#EQ` zOL%!|yW0@RTQ&L;tfpj2dd!<#i(G9Fd=^RqowS`BymbgFC4x7>GYc>US~DBWT$=wF z^C9FwDoHI`$D;sahCW`e$`nLnx?1J?jT(W}U#VeD!3I7%?s>H?wdluzRnk{>3SXb7 z%BK{ChQ-`-nppeoDK1Y09JZvBtZ%e2btcW5zhfVMj|twpxMif=cdtAZ3d39(y@n#N z=IIj`KYelUuJjiJAijH8V9yVU0{~_r`K|-|t`xtawW=(j#JNg9rGp`6$GVEYZe5Gi zZI=`l(c6t?O;70aGu-_!*=9w!V(CbTKev*|N(g^@!b2?k6G`y)z`SB9xeA1B6Bm8` zNddV7zZbVy@e%;QUc0OmKm|HDRBQwXD-w>4PJj-M4iPS$O+bs*Vzqr2!#8#xU6!Hr z?@J|w@x5(q%1SV#Ly4fX`&m?@GM&_-D&3;up}Z#cDDzggwU(eXwC@OQ+d?63(Ff{t zHr{TLig>efNWrXC>wubim|6Lz40dS&pYN7V;}Z#f6OJZBZ~x`c5*K_oCriIK3v8|a|41yCbc4v_!#a$YO6SrC$Uey|L+Il!g1rTl`KGac=^(uqHtK(Ez=0f>a99Yl3 zaW27w-b=i_)C+OBdpD$kJe^acjCVH-;{&klEaCej)Yy-R+0kbQfHG5f05*(uRFGn` zmAciIv10MGxz@E}QOcIULJ~IN_(*hqEFrRUq-?`Z>;xu?plXm2JuWr4#`Er?a)_e- zR-yFuSl1YE1T`*mZ={%o7WPZu)g;jP9(PTwK=-54K>I4f(PW-R!M@E|OR=s@3BL;c zDN^B?oq>wL)+%=nWn_Uk&kMC|ba?{*cx!TEvWA#eVyT-J6I+ao$O60c$!W*0s*aBj zi|A|gG=s6Ck<&?lXd^n19C~}JT!D-NnPp5e3R(Ql>v!QZ#sJ|rWv`4O2Uz+RS7iStL2kw_m^6AmJau@NB;EgTf3*|ms~0&{Z=Zi-R=&-gQ?pM z4x$B04AOR+=%-XaCfUmbY%c^3-o~ETUX* z8C}zQYsV82AZyIN?dLBoogH86Aoqc9OFAstXU1k}xbF9SVpPdeWTEv-n&y0C@H|J@ zq5UL$ML+=YJ_?6IUuUSb68{aVCvdX`?hS4;tVuE+j0vQ;X``Te(?6ZEMNDaq!&+1r8s?ak_AoOeNGy7k)1B)EM(aC|9h)@X}JR8zM1~ zeN5Gq`viBul00?)A~N}FGUe|+tKRjUzYTq!4|SzJ3Qtp_=FFhypN@M5j^`NuoXIN5 z1uSg~oKpINbwjMwLyiWrX#HqW_x27EHFdSgeWgNSak^Lq>%xy(rP`z|!iv1oSj$I@ zotUZBvKRCEFVE$hJ(8+4UgT?zg-(OT-^NPRJ3g*J9`61*x&QaM@|t>h@AN{Py9w|(OtfeAyzx-}G=Jz6Moe}s6siXfH!w2Yv|#Wj zl1DrMxdivoJ6p{9eP~&Xuej&{i;x5gZ!@LX!D&Xv<&)+bt+)6M6mg5jM3onWi}cHa zVbNQB`9P7>yIi9p-6pyE6*WJIT748p5-)9%B7y0M)_spTK|{s6m%*7J<*WY0n>}-m zKSf%vZ|CdJ-i`}D!o#<_yrw)MUFqe5UxkblPof7av&!1bAO?>2)+I=)?>{kxpOqc~ z2vK0YuMT8@rm~73)5ie(gK?{W0bb0Q3=X;V039kGa;g?oc|BZ-O(|fAn8Vgbjw8Ms zaVMe0u{EgSx$K`yDASS@9fZLxfN9tT%u!f(*W8d3??(Y8?K!h}ouN*Se2+ra1S43a z^et&L>$HXfsn|81pIeu_6y0imWTicS+J#+=`?sf-Vge-IdRRJFbnbpsKj38QwT!rk zm>Dlooc^vU7tTWE&y}m@ac~>jvT+~U)S+$JqL}LtO>_ICQ}4eRadCH0?dN|_i}A>*;)%xV^Lu6^JM)9Z7pB-L10a+EWs z>zDoyV(f8;;bBo22l8~BDXFMJrsh)W_h0{YWACvLEHbG0NWgHTa1^LX3TM%aXhQ|a zcX!|13DO6Z7#IbqGq6T28f__suIso(I1KC~sN4lC;8eA%x=!!{F_9cL9xu$%w5$@e z6q2Iyg{0)V^p&mW7G$?CRorhU(X9^?YpvW84We3mE|fGa;n+$1i==?n<$dF{b&gSf z%;44}J1f<%l}gIWlJ)-ltX(Pn)d8Mnb;S4X_>haCCOJjK_u5;qw~`T~gCM&fbMpnb`2NGjDk=I>|Qr3UuFMbkB*>5&c6UFOhJ{6`cFX3Yc9 zsN3oLAuGAd>_<(TQF{|YWf;b=3k1=kF|>qJ_2Cvbifx*Fjx26DuC^*O2)01uGLc2? zj8|5uRrVpg!Z&ail>buVJh|gZz#uX|Zbk4+T&;RN?sj`AqpNNxq*vowR-qohL#3h7k}9sG%5+ADs*mCsO#6EEx$^TvOZ;$gno>Lg&95VB9P~Tk zsX)EJ%d_jtcaih!PbUQj?-&XU1p$v8V*FG1$X#ay6K+{(HK$bTP^MMt`iRjs=OEl5 zjn6|+d^KWaxyGNPq3JxUP{4G@qj`>{nC6cLxswo`ug{N4A*c`OS{aGNB!Yem>!QtfuboG(;>?Hce0&@)wIyzLEVG44MO&>~e zO_b0}nZ!dpbMJjA7RhooA_qrgrau&j<3aUr@KAU5QjG?MnS%{i$Qc;K6-hS37MMjz zf>eVAXw4ql%3SVy$}DlZ^uym&Rkn1#xY=ge{Z&gUxjn7C$B8VY_p%!>*SMPIr`0Hx zv9T>I5IDpYkbD}&d>u=ZdLwCK2d$IksXN_2tB^UmfShuD2<-J1$?4{KnUKD&C&xws(9P#NWm=mg> z6E%!TqWC;T#q96k(_tT)g+Yw?XUENqEd_p}a@!2lz?%emO}ac1+;34s#zGyns5>NV zzl!x@xpr=12!7~(=}!=Wlfs6^@MVU{kd`SqVa6BeICC8iwV67=G`jkwNe0^Fm6YmCVa*lLK(D_^2W)>;t5f#kD7^K*7e{mL z>N}WP3Y0ae3g60~i&(D!K%kUSqM?J_6$Eo+`1Jlvlo);T6bziX|?^{nFcLTc0mT$wN zmTTV@YrDJugIv6L78t(Udg+DP3RCki{g26oA)!u&L1hPP4=Bc-|ACXoMHudwk1SAh zhP?X#3@%LTCrzb;9h4Jy5u5f_oEGq66?-fpx1R_(s6dT_hl z5op~uY>O%?{T*?%S4_$(^g!fJ0#gu~CO^W-B!-5?0Sdz!l{7sR3f6>5Xg@1c)^FM9 za|u(Lu4aX&sK`~?)Ud%}=2I5NSKc|nR3%fdDeLBVPUw?8$Esqtjf^)RV#t=&-_5H7 zqqj^|^dVRAlA(SIc`Xu)Z%+U696lv5F3&}#w?T=!P$?=< zq3hquBD@Uf!+Hb8cQ``2OwBa7`1X;`O3jdzt+`3*oybn_%o&IUuu7)M#l(VbfXY1B zs(E9^Q76juY^r`|1Uy_$oSb<$ec0DeJ-ioRJS(Z(1|V+Xd}g!k#YcmQ10Xj|8{^;e z5fIpi1R{`PWt;y8x#6oEfTXY0;u(h7wSu|V1iw-}aaf5wngHJjAvV4BP%&5zogdcP zmAV0zG=o`H>Nk2k5?IVG4oU1cLHIljx~W1BuNvhR5Fg0+jBhxyl(2s-wIzL@f!Tz6 zrDXBI{kQyy!k$;f!?X+7_wWe|Une3lo|^dbR#J<57NwCBjag{!7F7xCs{% zPB9&$;^F1E{jM8vtp+9mg``8hD3Y}|@@bF64LF>^!S(y@m|c>1Y6Y54y2~f)D0tlr zY=R642E}--nilVlg~JF(o$rp3XFm00|LCjt?9&r*lV%QiPM_c4K7SWuRJjR&RimG+fv@i`$Jd51DL;3Vo<363l9>Gz6GH0IY zL#IZ9kDM4*BH;wX_*I8gG&;7vktUhyH7_Rf(m_#sV92UL%3ODE=P5H-bw=r^tdnq} zJ+=eW3MXGKueB?xpA#QCe*Tc+ZWbKIEP4aO9P-J-)HL;%c_YLu6dJNk$9 zND*G>_S6@HBB}Ej294?YX~GaOP)vbHOO)z(bGV=2$nZ^Qxt6#i2fpm^4z_Fx54%jA zpAJ@h)HOn{S57+Y%cej0gHB#)HuU;TQ5z??x0`d5X}B_&Ma zE4?%>^r#jbKcLcSsV?UEM#U zXq>sE&XIPp6ALuE3#7N7yt<5XiN*VJ*XaS2@dvcEU(>%<0uhltoC4`Y7KmvEj6`8R zhZrVF&e&f58CNLlqcm)l9<*dx*fwKytPGzWqFb8%t7Am-1`qHHpr=0M@F zf;*O~N=>phEhOGwK&mis1+NA=V)9ZX-M!|#C@ErNK2|w?6RxVQP3{de}d$p={OiC$JBvb!7iQCvc_uhn|vD6X1(|e+d zX4qO_2Gg2S4#X^C2J$%H=>8xvcTdSIK^~`BAw5@l0%@;JZu-rsiD zHs5k$0+n81tA0SY*?LuE3qbz)wm_&q#`i$jJB)l*opxR>nZ{%eg~;a-i`n3`dlLo-CwTJ24{hruL)lLYy6DbnDRH}&W;Yz#Z8)X~iW z`4~B<$LBSr6qMx}gaKRb6>CAC`B}zX-tINP%vCFcqHt}YqBzqmg|u9PzXG~|4TzP? zindxiZ6TuGGYH!h5=h8 zTNqhkJDqqTJqhgA%6u#m>qpt|FY&CY$&*EocmZW(ptBzT4=;?eFHFuAM$4(G_ZuGR zptoz?zPCLff~N6bMDWYtRA6z-FJ)I^nXA{|J9)#0uNnX5xavnJ=cn#s-lDx}eplWe zwVa811oDN#EKge!uu2kQ{^_OUITD7I0i@l4;|`Fe0I98usTRjZ=7EOQ}fV96A#7$GL_xiOaxMMXp>Yz$>|O$|7lVI$9~TV`&Z39 z`62V9C>hdkuu$^pGAv(F4C@c= zg6!&^(?}L*LWNPjz+jj`YAv-NH9ln7NgB?OxSKbi^s@;gb(pO;p8McWfJO6w6i41D8P*soN&q+*nsE* zQHiLeNe9@1h0zDW80H&#>N13FFKncG5nmO)n6f_DRbc4dC$>;;qSn3&t5z*FB$YP; zru&k1mqqGI84@Yh8l~LW-C#!cgqo1TL2t4;c@+mH*eH`SONnnkb3UdrA$2w-Z}*G; zm+*&&VF8p317LrR=TV~gf#GlwIo4_G(4&Xa2%$7Hj3f?)Fme^gHBzfbT8Dz<$<-sD z)3bvPq6w%+DOvdMVOvIv8c7;aBC-*}4X|ku^-#O`8jeqs?FN%kTSIo^&SxjAV+*`a zCf`{3sz4518}w<1xvA3GC4@c0Leghz$L#penmxM14G3FJ6B++95ACD1R+vpq8wj%# z$`#>}K138`GDzTmq<6$@wCi_CGohqO-iH?~2J-Smu_Lq$%H*8$oF8YKSVR{6!;)q~ z1j7Odh{1Gv_C1!172@knK^$etVlvGmsraq%K{HAMRm{8jt~e{YN!k%1aXc}fhVG)O za-5#cAA^FIDKwuSKGOP!DwWk6?K!+#YKkZ~zi|RAN{KL^Q9}_MTgQ+{9&SW!nk*oB znk>+d4uQk4SJ-k~T`f8_ru?^*5i<5z0;P$#6O!kI9x5v_F}E4bkBwl~N@`mV`VhX=yK^ zx<;!<;j~q}rNxV^L;+#M?D1vrB;@&35}kwwl_pEDMCgPD8XEUS9?!uvM@*7)Fsnh+ z<)}g0U&NmzUH*fd%EAR0uF+!7j+rahB(QwSsVx8DK;3i zuNI5On(Q{C%y^8SZ@NA3FL%Oi(ITJ>%S?}9N(=e;JB15*uNI9mAsr#tsGq4sk4=C& z$O6)0bk_xe_&!k*bKiYbFA7O2E$v|PFhIFU2<|5~g=n098&-;O0@y!H{irqYqN&sH zEXp(mZvHAF0h?hpkqpya_hc?V%Y6s;iefqvZ z;)dKY+h|2vz#KL!PA)YjHAOt$vzJX6{+xW1JUGJ9Bo@tJ5yiDw{v&?goxu%thmGRV z+6#F!40~`=JKf{0KS)Egfqf6^IJ>N?v79E$U`FjbW1ld357Khh5-+$h*9J$jD_|r4?G-OeYe_V9J^ia@QzS5S{b`=%1s!|D3m%gSWrt(=iY=_ zBW0F+i6{#GtuKLPykk;=+n?lKfyLHuZ#||P2PDVBJG*+}+_uZItNM=7)%cauIbd9( zyps@kLbD=Kl=L6u7T_RYxGR%|Gd)Q<14KIv6aOfZ?-7EEHdrG+@=lwA@s3SV4|)fF zws!y5)cFt<`=^(ntm58#>z|~{Eg`~?*3m)&y{G9H54lBP9kn{7bb?VGVyzX5oEFE< z4-~3^c;5dApYaz%<_DEqp|9p#Os%ZZ1bk3li&?OP$Of|&KIKI3et$RsAOL{O^+t5A z5uV*o`CBa*lNcV}63Z`TUY(W^TLu^NvK=Xi4DG-ix_2}dun-Ili)j#Sh{y4xK~DGp zO|4%Z8{LHqI<}vmHTf45CePvELw^Pefj~f%tm|(kEt+SN(|OQI+`!2k)xbAFRKHLt zoxjnRy5>fz<=UHv6rHHt^8q;SQLVR<9AEh+J#Gv{IvQ?H!h`}S;#gxk(B@sMA2)r3 z79EIKjqG@*?gt$97s^@>s=JyFGG3fs^-f`^7wjVClH2S$cfG)pu|NQH#a2^{rOPML zIM9GOouruBKMk#{A8IwQDb=;FSrS!wgm5aNdMxbz%2K2R4tN${Egx-;a8Lx0liQI~ zKQ>jc_I%8g?`%t7+KE%t!rh;z-Yl^2W?BgFKkjbRvr7Httr14guTk3oeWkQR(kUSJ zmoz_w+ zh~fdb%XIL{C@SP*Pa+5>KM98yEg$PIg2uWJb zn}K*>Tru4h`u?v;;_h=B2(N2CJNLuO*`8LmN+84#*byb^(D7L&m6Ue;_6y?g+Fj;D z%VKd-v3{t3K!0afebGprux5skH*Ho2) zV_pqKq$X)J)HzQsi_o<1$N88zV$L=u=wT+&%|G6M7`xMn^1p3nC{|SNPv?o*J=6Ox z+?@*Jz9Ap4$yL72eW|rA2LSqhEgnUcV&WCU7b1|P8q=nwg8jyr7})e!p$HQ2$@8t} zi1)0LfZ~17$9(BrK+Mqn8Ehaj(sB%yaIN*~qPu&g>JNeY8^$sni?zo2MM{h2_M$Ts z8K#xIblO}b%d4_)DlnjP=uvnXZg2S%y{h8Dv{@V0dHK9mufT)*A%T9ECCE%&IallR zT|babw4P+(V%4Wi?W*Fb-B(d?rMX7!G=B7xM&#bSL#g#$WIio79$ESc9XD+k81Nw> zpPLP1Jmq9+EYYoBHWhrRJ?1#db$lGGH7R?9%+|{5Fi|Rc82N{=&DkZal0pB+xvg%B zKnQhB*fM;;%c^CR)@Q}9b;W$3_$taRzOFN__h4)^h|`_#%7rvs80BFfX^of9I#830 z9o}3g`WGrH|2N587Scc4R%P+gEdBDldy=>j0q0S2GVxp&gef(4vLt}o`TEEL@OIrp z=_>b%^W=v<+AmBp+z|q#ex0TB?kO~H24drEw}p0u3}c$lQ7Tk9M~kubBU(-C?(@%f z1*C%ZW&+U0@_SAk19lYmA)e_&?@uzn1%rnWh^|F}tW)g+Q-hG#xkhCXC%wMx% zgz960Ql^n61GwjtJGQE&5(B%z&;;B}acuAwxPPTxTG@)$C~z4$tW=i{2h}Ry#el&! zWjk&0&F1@;-?yLdbN;dJ^5D@V7GrFBl_wyRy|=?C0k&OiP$pbA2*+bmW3&(;>P~l% z2p334&Kv-i9A?{0b4(3;1cp=e_ESItJS;hU@O3VeX()>+OF7y{^KEAUzVI3`6>dh9 z{Z7FQ2UjZb2od-Rfk0GGnE(|E5mSY8$+nUCgC`>HW|Gi=%Wp6trF>&KBYfeZA)YF> zG4~+0u~?aX!r|i_`D<<&HhUAMDue981G@|#Pt1E9FUL&uMLdp$ohQt>e@`lLLVhA* z5EhjY)&?(eJT87jTy6wNw$#oLMW3Ga&9ENa7+znusOAle9~V~c(?M7{eoT>5&ve#R zZeDO%xHx8x&5iGpv1%i51q&929UFa#k)Ba2{e^WMHnhPt4WXvb+t60STpS3?d_ zypraKCNPX%XY9BH|7RNKFL((Hzig(6(-wa1RVHg|Lfwnoksxzl3`XW;IdQL_1{gN0 z%9Ndb|HmJW8t!Cp#?2vU+afZVtH#R3$!1}d!3A>p(5wpHxRfx%#NLiMPJ~y+mCr-! z^$QctjxI>^IeSh$phPOo;s6G^f&O6WXR_?A6AS|LWdg6C7|FsBXg?{$iW^5n7N+5i zj@4+ye!+;o5zJ55bCO8(`CB-D7`7M(@KHtF9Mh#2JDvNMBxjB$J4Nbr*@&atHFMcc zzBMkg=_NN(qmLm@Nk zsPm@7b<2km4~0#KF#}Z%IA4#xfh*NW%^PgI<$G$B%HYW zf~Ljs{cqy1NAy8IK(?u}kj-$tE>9IE*0TCF3bj%JV5e%c-C2tX}6+E3rE- z3zvKD$yFOi3IB+?Om)l<;(g+=(zi zLSr%j;H)#p?PrTqR#y4+@zuKhXSAolk-);4Q3RmeeBT_@Jt15-AHKxFZh2|)UXQ{MIA|Jz4v z#d2SEqLz42VOIdx9p$oPK=*BCoyQ%!d$y8^?qMNGr%WzEyp;m`@ztu;AXrBqp>#c> z$z-)LAO;k)Fj{fBH|E?>tUgh~`&!d+Y1p~<>0jA1YS*u^j}v*R_W7cBUinKGOl-~)7023R=otLsmCrz%FJy5COLXDWeJ=2I=lO;GuPQa8 zS@6e3W6BPp<>&F6`&CcAmBCmwrC$M5KW#g9R)Mal1tIwwyYuL1Y4&wlDf}!~^v>Ub zU-O`4skc|Z6o=4!t?swLZ&9$cSodH5Sq8JQv#dX}||S#q*FjwjHT!jDHow{RlNN#7Io zzIzCH)xEr1ZC!r(IG+C=cOxT$il^~~-ki_A|N8^-_I_zcm+ag{GsDh-0w9NF2f+&i zVub+)NYLpb!QfOAq#!`rBVru8xTr_~R0QmR!m#oYaS_X_7B}Or!+I)w)}GWulGf0Qf#Ds$$@f0w4Ic7k6Tfq5qusQCUBFE=MH_OT zbN70rH9AQ&@H0vF^xj5OGxTI~lbVeh>Xe0@5~`0eyqhVNSEKLqXi7t3Q%{f1uy&{= z2yxfOHHg%;DdIoKRV5ODDSw-<9GQTj)dSnA&M5%EkujslI-DMUY}=+_(4%IRq3_Vy z_?Cl>fotPXxp?yTWA+CGA|VPkEz!@aAIcu|X$^Kd?)Y38wPp0tRI(1Y(mooJx{?+A z=l3o4w^L^Sil&JC?Yfqxs)De_fFG zDW3htWHvGC(==Gvc&>F%wm2>M!bE;-WfO652vt>HKyKt8S@Z^djl**xHn`Ob;h|~< z5`+QMuf@=`jC0uOF4FFaXLoPkb7WNbdt7!%yCVezTD7x~BF%dHZmtVotyG8`zx4&p zN3k*T2oQWylbSH_fiAgWC5BtF?);kFrxSIXthw2H>O|fqS;~v9k{4kSNT+RF+Z(W> z4ZoPokzimfL9w!mK`|%c9*FP7d(+rHTv}d*U7@*}!TE_(Ut|3;>uTJB>BHf|GByft_ z_{N?u9e#5H>E9N{Q5pZCo{WTupX~umW>g z4_V+?+8FE>w}kl>zIGKB_(GVrK9o$~!*s0yaB@`GtPzJ|sFA-aI1&e5;p;*;^OWi8 zZ#5SfjTF;E21tPVDzjZoft}L|>@lO%<$Q0#k8|={$vy6%bZQZ8T<>DJ^m~1WD#;FM(M*gb#yL5_Lj9#;E;l`)SOx3QwyqAYt4#jJS? zLHAs7gMRC*)}hg;(5nTz+;1iEO_B+Y9Zk0!X9;m#c5-GL3fRG0A%$rCc>j-?WSgz{ zFlcpltIxQ8e<|`m#7Cb^!!mFK5d*$3pMPhHSBhCfWU*|p{TXjD`UBLl?<_;iX`p8qKed=& zyeWJ=y)f_lqI?Cpc$5E7rT_w<5}S1nzs;1Yl53lZLj@4ygZGO5rphd$YNJWc6Ax@Q zX;G{eiW~$uqV(t_Y{(Rk@>Vw52=a+ll9S2Las_x6eZuU}%BYYc9D@!c-fJ~)v}w?0 zWNxyvKvB)xJ;dSCqDd^NCthD@6;nk({S?X@no0=^0C{zf5OW8Zua4q;~(g8 z=p$2+`;N+xpTEtoZJ_AsqRv`ZOD&GAKfS5NlWLc~eB7iRl^zmhNk|qIrd|g?OhA8qS5%0nt{Af%Z28rCA~GAVTkqe&gC4>e7n| z#D&zEEc(`tP`9Oo;Y{lRc&bH?$YntnwE{`vV`mWHd4M}cuJ#j$_6xrj;m4aFlUDT#hCsyPl+R|6fPuAeFX%9Rv5isl~q+f>=(;vFx>VE&TE_rdO-Z?c@hA91#h| z(KmB#{8Z*|hNHY0BBFYFv}Ww&M-mEVZJvvQzn*qH>H0-+lC1Dnpw@Ydbl1@W05H-{ zH!m z;`JrZt5VFN9nlHFP9B0N-9$3280(Oj$D(9oESTIP zRaV$*SsrXux(yP-=b|FM*HRk{m2;jkRL>B<~LNt(A6JF2LKQu=ML%(hqkng z>R+6ygsdda?zsh$S{M7RPS0Ut>c*M&h&T*;$v&u+R>zpm!tWJY*GY5}v_SRuK}#1R z1xBnLQ9E=jQ8BDRAYcE3Ts5(Gq=cgBT!y@4te&-QlnJ#Xo?ncj1IPf$GTvq)q>koo ztZVV${i@;k9snidc$#Wmbjd+359mE0);-2I9xM}9=Y#6;8||TY@xj6MOxH%kGejYT zkq?`{lK*C@NpQ3XZ4(BbCLX*$`APhkSgH)gGH=DKiZc+(bl`Zl@yXs}S78mlf$y;I zqnS57cZULY&io8tFeyZL;ac8r!H2&qB{Q!8k`y3uxy4;|P~__fCr?Q~Ld%?=Q{6hM z?S2)HF8_KuKXXxh?-Q!hRWHZ3Hj0n#@Nrbk>ak^~%=bWZ1o6qn6wMK)H9k>-oV7K* zX(K9gqOm;u38Jma#3ku_^SGxtR3tLw1vEJ0v6|5ff&u70tuhsmiU&Rdkc14CPn1!)CmAkt&t zke^u~sY)Y_xitmx5nq)+alOqi-0tji8I<(;u{HJ0l&0=)&`3D3IxX&9Sj+** zU3R@<`a|vS1mjBM{CK9l(wnHU$EZX~a^2-I6~ z@K@M6lJ3DOt^^IXT$c}RP^{vsSp1_Is*Xk+89{<{+BcWPW~lB6bWW3I$Cy+1`Vf~V zmt>|L*E8)=Zjnm%jmJ*!vWe*t+O0t`x74*K$=0arKXVB>Ne&jEYD6f`%oe7*m`j_} z))v0Z3esX0Ol2F{kGcEqmbYxF#j0a7yCO~hgV^$g7+h?)D;aPo0J?D5d|AF(Q=5{GotV(=f|=l;w)sQodr~)wHSY)T zn!O2eHCK#tO4Of{R});J!PjBlYj3Z3eLUr48^V9>5BhRjBiJ=6r$<9dpZxqCj&h8# z-Ke_o-Yjne99$p+7v4kvK`zO0I1&!eY%W8NIaZe@z1+ms5Vti>)^yND5sM;Gbrn;51a^4Xw_~sdW{HH_kBKa9gniu_0 z{%TL4detsw^Iu0>RytY|pVQ~K_sDAcV(;&%2|YuQ(Z^GjS9IvY39U8V_E@Y)-;JB% zYO7XqtfQ7{{jlAJ>Jqd;BwFle-h7Y;x{C>lzGqlJ;i^LN8mI>Uqir@CXg3<#mN`Nhv0XGu+?oa;z#8UEAMrSs-X~TKMq9*G@9#= z0%I_dpu(6=qL%?=IvoQ|&#Af0RyGdsi-Sz$lIq>{7SmKwt%AAs*s4K0mw+Y=Zyr>wND*hI~1DcbvU{aQ7 zd`fj%Ya~?LD~2%i5|0YZ~NjWeCpVtl?E*#lUWSU4J@+vKwRjtd|gjV=AU|%6-zj@&c$r zIB3Js2eN~P<{-Foj}8q~AlppU4}EUM$FZx;jv%?zl^@qrg3j}`rf}BIO!~t2m1$J{ zD(mC(yHiAT|Oetk^RX(#2xU4&H3Dwdr=0Vu!#faKwC=~-){*oJAb5=>_uRJ-pwU~`I? zd~085$|fTtyxhwGvJri5=6>YtzPqI=bVkJg~VzT{Cxo=;NZA=f1%w%8E zAArw_jwNcWF5$zltpT$W;D`!V#+?PrJ>koS;nY#Zi~6`0vK^bXM$5953=q>)k6w2? z+;?QQ2vN_lO5`0@xtjO)m$gJ)AM^dIdh=b8A1&V+iK93JLTdgI?#I<$XuaI+Y#C0z zPsD2cS?lT$b1ii_`wwz|d#^}L`(dlIrWXWSI|~sio)ds#aPAcQ z%=<((#CEUO+HG{ONdSP{`T!iz-WMUQ7I3Xnz<2P33DTkj(~gTur$U$KNdRv>3Uk$p zldrpTLv5^Ok)WUh#biQo@G%@jvH9En`ax5|Vj)Te(1WC1af1Du7BeDJRH5hbvS8B> z!b;~F%nsiVo(*VlAmv+5*9%iLhiwUX7T-j1!_RXyfoG1Poog9{B>Y)_{V3>hQ$57^ zM1mrMvvy5QMrp3M7b)W0+bYg=k7}Y8b}Y9qwc~~=!tMarwr>=5tcs=%*?Gsp3U{)m zk#{~j$avg8C}hh>Aw9Gg$RK%wYb>ZlgSU_@or|wJ zJUWh&N(drat1p3w%{`eRSoyZG4nm{~=I`Ga)_mzUh@?noFab97gDTk8>@`v{M0ug4 zB%yqm!!ana$f(laEa^cz-35LPE|@p)GG%-Rp5`HU`u-H_YoteT;}g0dv7s_xWe=R$hOY;7xjX{*c@ z%+_U4UEH0#+*U$w?^Tyhqk%Xu>6b@m^I;@Cr@W7sODf|GzZh&t?jBvTS0Slm8VXS! z81V(kij#ZB@Hp(dC;vgt9p*H0Alht}NLDJ}c3juYH~woawFS#2-5u$A79`@}VU0>jp1r0(yVVaIkRI4K09lz)0+MA!#VugXh^GIyBGO zjCLRMAfVfu`KL|x-HZ)WxcyGv&yN}5nD>j8+<6wW~zA;2>rZlYaH973LIKtoZEg#oiY(i$HYMnd{3VnJfjlXfEc!IoZ6_ zEx@RDFJfPSpm4-^`|8W|PpX~%49RTyD8g|b)CJIxa)+?9P|8VfTe5=qep=M5Gts;6 z&v$;Gb&NhwR-Ob|Z+Lcm>kM7Jw(+2=eC}vr8)8G}Yi(kwrNi^mJb)%U)-ig5JnO)G z&s@ztkd^g%_j%dA*l&TS03@<2G9ZhpTMRlS(q}WdJv3~?Vq}K( zo?MGJ0t_;^bTV8DXjE38xN;mm__&7YI+p_psBf^#4{ z;#>!6moPnkdS35>Qr)GwK2ngst154G?5|CPmJ8RhedTzoPXYZ!*wat|6gZ_`yb{;1 zAKUSW(PR~aU!Gv*A9VkNT%Fi0szk?!|F4(cwSC2@nDIeB9%GcW!w$wsGijMkNYZ0L zoWy~(eW-7Wi<5GT2BNa4k%}@=g$f7_L5SQgGJVkFkJ-_jXVcPJ%k7_;HUc5+s^S+*7jz7M;Y718nxuaepCFR+sTjO@irL!-9LCeRT3u)5zu zkLqeec5uCbMsjfw!^G*HWocne97`@~yAmk^3%4%+S-44ImUG3iO@G!c8bkm9SMpSu zPjb|pe52XQk0L06)Wa0k$u}#Kn6NP4BeN~ zJC-zb?Ofa5Wx|CXx*Vy`{O2X*MUiZW&zc{m;1JC4{@6_MdRaP6ahS&>bw&f)i^}J( zgWnCdWbW}B{)N=9gLdZN+aOR4$@32Pp0_gE?}5$3 zx=0s_(`_nclw}O;_xo|YrnF39C}cQz{?wG-I!-F-)djO%suGrd_E3J}{yFG!UJM}Vp+f`Fg#>kcK#DQ;$mM-i0Vt$S8Ea;X$f_LD*M%b13&7#Ft zf6V?7r7@!^SDI^jaY_!}R~}L7&*^;uZbI?#7yMa#=e|C3-d*xc8E8u@$4{Kr6)7J- zN?oh^uD#IV3pu-A%s)(npoQ86LavS=udDr)(;ur!N8O#=`kN5Qu2_PQ-g|0i?o%21 z;@t+fHkp6RlQ3Wy0ENc2m7<6o1cNA@3koPA?zGvw55b{9?c7TKi4{Wsg}Kr&5KlTv{?9nGzJFZfTxn>p@=f-V5Ue zGdg^X)1$OkGzG0WRK5}lg8@je&@ducfNf#=%XwGRe0p#|^+XxEP{r+kvnhb(T{MCaVe+#Ye&-%ao2f5CY2QZwC*^GnDHgx{DEJ+myfI*R5u5|(c^NFUE{)5#I z{1hdG6l&;FaDj?SBPoNrMrq4uv$^E8@uYel2<^`zGsgTHIRwuHM3Q!c^Gb#l`=XAZ zt3f-?TQ;h+xtxgsQuF+Rh*j0)+{Ys#-e^AB&m+wu5{$fV68J}d#o`rm^bWbX>W)B+ zL(l&m-DOwzILR&KPuqAymZt*M2k4VdrlChwo~DU^gh!C3(3EbZ{C~Oa|A*m*Y!!Ha z3Eil`j`$Mk_`&u3?->a5D^ndXD#Zb>`U|vTNjOjBih&tKz|(=Qyl9`sm#0w)P(8z}sQ+Uu(>i3J?(&vTeB`8@@8%X4u>#qy*z1tQGFjgYJhF2Pqa` zkKVO?&n}g2AukZfLtOpIl%Nh_867U7IGG77^j%Od1zaQxRB;*X9vu`+B3c0Bryc_a zx<^G5`Xpgg=>xtWAj1p-rIO+k#Z(d8aV)i~p-OUz+A5f3G)XnSv@r&(x^+ELPR|g8VqI6MXOlS7BYt!AAN^8m=^!p25^vSQ;1Gv0bqR z=-y^^y5^b%QEJ(;y#CTUR4HA11szoa5df)C?0nFideIvUTzH>CA{)z7*t0o{7yX$` zddMf9?0aPyt`vodAMvXDj`@E3+;TMLlE7nwmgx@bvS{O6&?tv!@~v0w}2wN+I+iv?2~NY$NhN#t925c9;O?l@Ti*|-toD%t$lED9d9XS;p!(%(qn_0NH*%P(x^lXLXQOl= zvMxFK?5x3EFdp0e6`AU+hLHQV=Q4U+g zuN&PMpN$8RX5V0n1Ki`puHS(?T)pB|bb6CLj%Nv4(;wBia3@*_(8X?_6(_9>VNz!& z3mNqyHk*gF+dlL@Lf*2kc(0X7Gtl#7ocfelJZItWPR1O(mt2)N;@6pz#)>Y8(Y+7^ zq9qIqjwfLGFUny@dx9mqnvWDgBmZ$g3W6uY=B(ljhlgD}BJwW>;j1qB31cl% zw1EM@UzSOMf=_B6WFkRrR!pck>;SGZ?d87R9JuXyQ% z{sgeu6EL6>ApB*kR*#J)(NsyAzopdG47hHG=TtQli(F08^iSaO>lW6)04tANsupO1 zLx{PS$M3o#(r;QGD>dZH!Dz}#B)`&E6`HTHvRh5)@>4H$OjN0}B}I1=`bXxihksL( zt@;)1?uyf;OgJ9dTYUe{U0#&;oD2`7Qe!SG`pU2bSvupQ?Z|-;y$V1sAuE^wI3iaT z9L;@yu5MOh@%-bo09xg=)r{ zVcOmJ8_PVDnA82XDcbs`OHnqa0F#a5HT{n&_U43vASmGXoub*nVd83Zou`MM%|BYs zV7|n8$$yLNl|hhI)muBue)z@Jq6Y+H=5sppBdVR)Tm=_u$w~g z%N3~f$MFI{D*tMXp_Q2ztm*PGVZ2d;ii?`p&%QP&q;p*GDL(m={m}Fcv|Fs^ppSU- z_HV6A{U-iv=$rn?wH8ba9Rs0=Cd{|5s9I!Y zk)Bb7k(`BmDU8^b+d|Vw_+g@x$p?!TYPwdYq;8^P? zAZ}_j&U_1??#53cjgx6@(T6H9=trLkj_$kwSeQ&}%fgl^`I2~bk+az9AJ>f8(VQ=n zJW>X&TFLl-=55v#)Q?4MezdfLBqyDO@*$eCdd1G$Ksd4=oZO3zU5*bIJT_O5UdRFj zQnCDhm%}*!Kk4EB->+YaD**Ab-ElveFwZV8Eaeyvy`ccp@Sre!qT&D0^_D?#1zo%L z0E4@GaCf)h?(XjH4#C}myA#}<;O-KFJHg#8=p6FaQ{VHQbLz~WUAyPcOxLx0uU@^@ zeV=dOnOD}v^&8UM@U3Pm=2ZTvGP({b6duzfkrXj%Zdkh&uhyJr$t@OnC2t)RLmXOm ziO0Z)^^|pPfYbcmrXx8zHXyETa8pgg_Sg+xP>*ti+X<8@XPO342$$5pWu*G+?^)lL9W*^zb z6Zhr`yLVxg^QrbGdpBVqPW_~+_!jgu`@nTB)<=nPuJUBgx3K-v9NGrroA}h~Up;Pu zBW{pqhE0rGCLD9al~FE0Ou>~xBydI!q=lwOZ^`>^e_%P2^QM&kqi^Ed#@T?1B*)gU zV#pE%HR7er0^VA;1BESpQ`_#PCPS@man0S)_9G@83Lh*R?R}h`Z5xftQsea?Nx>q9 zj4xvUu7b@d!WW~#QbI*ehAir8duLLHfI34vnkg7EoYAL=G*?I}OEhLGJer9kM$9zr zBWCb_$oa(&1p)_kwQP~uZdFEXRLoBmk`skZ|224h#kJ*6tSArF2?PM$l|fG~itIO* zVBo8=_apR)$wgm(UYnyagfYILUP*VWB;Ig>|~miFNJVW?sFa5l=M8AS4ukm-8kzV3dYT&lIP zwKeTKjf?4Rqn}z+M;4>499`yMdJdaz$4FA^UJtbbH>lLB#$4X5$d?QR3q#39EkOi#vclv;lwH$w+6XIh{WszJ#IVPuvN@*T4qbSZO zMA~LOL;=)`H-iWLyyK3f00|;9^)ozn7n=$j8*>|fYHXXCR5N|E@*=sOBLyT$6THSV%CHTIIg-u?p7AV9|vIC-w~a^z*@3Nc;~t z7&ma#ltSw56mZhM6Zp60nAtHNSV~*FpGzsgpUwkIRAV&6;3XmGJPC8@83^e2QUG!? zIgv98*TXCBO1EDoGQiUMbtL~>Y_)|48>b?AhkK?9qGMZnV#HTV7p%K1lIb+XVyv{l@B1EOo}uW+7A| z7tzbt@<_lZc>pjLp8;i{UNTA4{f>gd(G-_=^LkMYf&@;*Swi)^WZ_%`5~v-M&RRg5 z9tMfLjS3P1Eg&8o#>ej#Qjbc&;-@ra-eMCr+e+(0$4^H^zpphQP^qR^PbdV+0CpalTHyIfv`!RB2CM(y^^qL_d|;|P&{ zi3dm1E3Lt$OBQ!4va?TVxG|0{9&)`Bwd-FvXjJ-h6LRkh&roboy3J!&9h6A%(Tuo6 z=Sp(WzNhE4fI8CD6bCTAPnug|3u#rLBQllP&zwLU=$F*kZjX*3w_`xSOIa{!D(q

    X8ns)y!a<-Z; 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%0D+&=e1(37P#;TlzrlCmk**p@=@#=Wdh8EA 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 >r^kF`sf?GbIVFS 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%0D==WB_Pp-Zc6W6aRIz_~mX>2WTt zIK}X3yQ(~n_sw()(nOc{zrFgu0C#|2p&IB3!jKr0sxTnq(m{ZL6yl#ykLm_>%0DXs zd0~L`B&Z-blZ_?{)I5$uLsYjcT88BHSjGO@qYnwata7t%S-XDmm>CD%L#uBy=BxFKTy`AH?mFjorEc3Q8*b-d+TZQ22_q1?~cU+WW)7%`t#4{krOV zL$>7sWKi~Uk3o7wMx`DTdN?B#g^45hQwNJm?oTZN`dKmypDk%5s^5uq2*nteqUIn?gU*k-5`#vMVA?iXJKFzdy^4rDno_N@CT^4<#;WYFf@c zko<#O9QY6be86b+9fn{*5n5Zoki-K;%~`*O9Cf^x-r6@L_te(qKz`iInKhF2fTf^9 z&?1KbmMkGkoDA*)7FeREnZ>7IN4!_H?ggZ@MUQRo`8jQ`zdK)5R%XTM;^wOTX&TR? zw5kRg#AVresc`eO`_>be&b7GK1wUjXa5fe=CjV6^X=L3zJtJ!5))DcVONkw~ygtK@2U2sJQvlgCCXc zoR2w20)bKRQ0VeoX>0@Uqrr#DC^&YH?QJZ$*UGJhiht z-@H;OG}*eTRLsTU5d;e$4jBLgMJ}N#g8^psqYyc|e12YR$E~hWpDWlfC%|ehByTEb zD(plPtLvQMuw}(2rv6Idj<3jVw4YYoF-^f&FzyHrd(%1&u3}|MM`H6tPu7$A^woLX zAoqN>h8g8Z6$;ByX^RsdK{}f278)sz-yS#l1M!?&%Gvw<*wM*W(^g8-qGL-4esdV{ z^R{j*d&a_md*ELbtIJWfj=fo3o^7_JG~m$yjC(oW>m}R)v~(l&k;KLf{h}`LSHTaicj! z`FeCje;%Ka2O-0`Z+UcpZ;q%EBMvoaa6$EV&1fcKdxa?t7IQl`K zG8Z(G?&WqMK>RYJ>m1B>*ZFIfZ-KA_SCzYsp5-WT)iK;TQ9YN4W^y0UsA$0O)cJ$z zlXd$GanB_J zeMSuni4Bk;k*y=vl5z2QG!*2I5HNojcd7L)rv{SQ5@pNFcY)a9Ab_hgBv{Kxo!kl^5G6%k83yYBeZaf+({9eGV#NIe_UNX|MqEBx*nz>CT4U|N!4-6 z^2c}6>7uFgXy!w1cIam4^RWI%DYE7`-}a)O^z;bZyLu)|vQdR$DIx`*(g_C8!9j?qtTA7Iz?3BqJo(k1+5Pp@JXxp?p~-4TSX0izU!0jda+f?YVW<1qIrN0 z5Z{wN(N&)9Ul?-|a z{nOE|M)ncTHIhdxL5@I>*b-&AM**hOB5CE({+pqNo>@GTFxMge(a?<&(x9_)EnURtw9$jHEE$a=Ty}cG?PP8pxk6D#wQ|jF zmPc5XxyEQ7)j0yT$6>xI!)1f^l&%`QUwEkLwxgxy)Oh6Tj;KMpm{4NJ1qliQAXDMh zlzs*52hIKX&+HP?%xeHdrRK5>qpX7oB+Zo}ogEIlihOGg0H(X}oS|V3P`U0+;s1MH zLS8{2H?4qs@Rmg)Arv*RVlO}BF!>wQe1>d_4nq_=SDEugp>Ca2vaLkjncg{>_WYXaj_vo6+Ibc4FNjVW z5YpdH)V1L^Vz_OGH@yp&sn+P823eqy2@%?Gh@d1tUR>4Y z<|2&Q@rjHITG8|1V3>q7_gv4`dVb{qD%??_V(9LetMs_IR3)Qo6eNpq6o?Nk;Niyp z2(P;+QvLpInlvE-d3tVHy!F;d869&Viie(eF3Yeg?)MkKqC%K9X+NR$p^fT+*lLN_ z8S@v3qO;6@gHt`~gEmmW{QfBa)0cgVlM=Y?x4dhwG0KbS>7Uj34t!_VM33gSRd`Fk zUj0|)(u`jKFp;5)GuA|)Q;}J-(P~OH49*u&oX5nywPcyR)51bHh~=*6PDv12 zO$!+^PNb@2DN&HoMT6ArSV&11lxuS1ML(ktUl~eqPM0C(B`p-$x0Dw5c1%-KynItF zjI>!rZGwZ6U5+u!>N~fN$i61WV6cmdAlA8IN|Y@O&Il8>RF^Qurr=b}6#prwXHBT2 z(QK>Gjg!`c9OBdiizWikk_N-`qin)M+(o^-l@&K)x>=#Zo4$3DU7iH@2krG}hWjcl zLDUf`#-~D2z#V#`)~^(UNhu3f-(6S#vX55(xB1sYgfIWy{A@`|4vRKY+b&hFHN_BG zr!dJ#1pKNs;(V4b!{II%rxmHB7+G4F*g9Pn9OGSHl@% zEcGFcHYzWd%-o#hngz-m=%IvR#I7 zYI111dlO3F%lh^^m4?)@sfytDjcEBFn@VAS$YKirO!IVHBpjAWy&~iKQaM)yIgx7% zZ;dA-sDDUpD=-VRFBbX(Up`-szmMWO;?^Pq-+>OGkB@nN*KInZ#zKm>a3oBTVc1L= zL?igzD|_a8mMLaQ^~pi_@=D5+QDF*RJ35x|iE>M_Ls4?SoYYj)ZBhx%F*#qNBB(J#ZJG_nnBY_0pHec@!m zA|>@T`}z-ZoiPgl@LFw+E7Jf_O=$0LHBOI2+~;df=}!#xNf@V?09_zMl_-96P(ZX(+UYLc zcSPfaf@@GKVS;lj@i+CG*}jI$ZMrh;FT+g#|GqN5mQVLGy6faitI^f||8Cy@AHu#d zx{|Q#^2WAp+wRylZfvXLjytw(+eQZ+Cmov|JL$N?JL&futeG{l=KQEtRsX7L*EtW) z-h0hZtC-UuVkI|CzaJp8#(fCc5d;<#Xv_*tgp6B-r^#MLeg3l=>A*ZqTedl>nve?@ z5f2LgxsCfs#@K6q74i10*4Q{LBT@{!aM9b*PCmdvaBm>29Qa+ktL4Bo!%qhTu16v-lxX~ z1oGkscJO0kn*Iz94f^vg$LR(Gt{QyL8&0Xf>l2TL>#dQPly*#Z&l4n1*pT2h6}1SX zlOhIam~}&4^V%;DA8+NZUthAcwORA(TrSeZ%w-0>SuV^p3j!6DR(K$hT9OO0@fn0l zb959Kb*je@a)mNh1JO*ASSd7u$?Daapvg-xS<$I9NxyL#T8qy7q;KFEW6cWA$Uig! zPr4B|2PcE2{Ruv6!T;(`-vS}0j5a_fpZci9a@QA>0QBAfvlv#F0rvC@zc4K0Zc;LGJcbcXW*si6 zI01Hv#9Xk>`40ZC6rqTO9x9`c_-Ra*Eh8nP z$a~G7QU}&CCpnzZ-jpS=mM3y4S5&Ric;1@qbG9*Si6N2+>K91Sgvr=4<8m}()2f-F z1J<(8c}VPTR*6@`BXiWa{c443b=Bx?TX@0+Z^s{?zxyY4wep&MFaFnmi-g7gPp;45 z0%M}P1@Hi^$WlmLRD!e9@O1r#a|DmGB2(Tup8w`piXaS9WIRD-u2*r;U8Nvj*WZSA ze=ZTM+*_Z_f_5tqTAiJ{e$a6&pT4O`$P z0^TtW9|_&!J81#6^K*VoaRFr}EZTquCq*W3k-JzuevHOKjG~BzRoHWm(Z!;QjGw9c z0sS3xBzE`(DEna$yC}DL1r7~M|V4OUKTu)7-Y@7a48hmNTMyU z=V*Caxte}Pu&r_BO`5_*+}dr^_}W96%5i;E#kF?6uaExI=By>oZjtamJ;7mcO@WZQ z+H0S6RYYkh8$~o!2fa1f?1FVh7OC)3@D6J=)g^Z_tUT*nqoNVgB>k&JW7AbW`_}25J3oZjKUso5#b zxOLG&mqBFr@Ur?tv$;idg~9R+ExnQkS3>|OKrqax8!qb&0xNTZ%ls~;s*HNK?UpUh z^NPjN&&ZFskYdPa#l(aa2ZZfhxT2D#DMT@dSsKpPl$S&MP3ObCx_}ll0cg3u?MZB1 zq!D)!fxo#diaPODOCp<<7v#uoB+($c@~;1o3ucY8;6VL25K$awZ-{DXP3ae5hkQ;W zrAGge)JvdSEiSJC$H2(BnbMglFq!Gp%jSwV@ZxWPcZp))fJ5o&(wO|PqH&;b)yqHm z*gPi>+@&=}LQ&i~}G0PXAw*`% zW3!BmKt0lfCMAObH z!`);9Wt9|aOv$SgO~Ii5qM$6g@M)y7LoP7}M73oTJ2dIu{#hTc z%4a5%+TB08t|zBZp!2K(u(Pn9oT{a_cQb5zEt9mlS`c<{@;G6?O;^{S=USbATfR%V zV)xDU%*S=nDZoW|6YQ;U`nA*S%MQoU_kF3`u; zl7R{Z3BThJpj!N>y?29Uiwi0z8>05E9Y$YxhfZV^<{g5CRiv=}6Xb3XMR_;n%sniO|tsO3h| zjfT<%M*Ri*ZHb!>#uDok9M$nhnUkMzE68Q+z1G7bu)(fmtcQEAP2;QkY;j!e2|A%5 z_Lm7`9KUd}iUQc0ErKQ9hrJE9h%ZZjmyXwa&vcYDPs{K)OBZ7lH~VfQh_#{^mt7gQ z-rn>a0l_p@yLfAZWOjH}$hQpdqx#J&*q%6#dd#g z$dmBOLt7CHaV&~4Z>>@*^JTX}HfV7XmtZ`+`HaBPbnDAo>fm5O2`r}HT+%cdYW4{T z)X_BXn(T*2Iwj-R#Ihw(~Ik@{aRQ6#7xdz#U6btA5hsek=7p`t;RKT}1gIqV#U3{NrC9pJui2 zd0Cd2$C|~eFgD0}`Mns$+&&Mk`-V-!3mzO-qOs!j$(4{di|(KCNl&rEIq=q8qrr4U zh`+N^=BF+fCc2IC-zKyeV%P zF1SYp$KOg!K5ZtqVA1ZV81Pu5F#>0Bgrc+RPbtPpiYfi=%q8|3ozA1Z4MUd=QLm^!&0t&z&O@>L zH1(p>Y*as2uE;Pqn-utty^_mNi-&A(XD8J%ID|ZUG~CNY;**B`&f{|otj(y*a)f4s z+oYO;Yt>=9aja`jH9c1$9f;0gv&&x3Olo-OS^#eL{amgNZ;xi2wW`>~>&ka8=`xZ^6 zYCQfuvK&Fb)!C6$9zh=Afwfpd0HpDe>?wuwE$!FQI+qT}*W6NvjdU{6O3syqr~>dz zEU|#qy~gTNb4}MZu>(A3tqtK&^HQ0F)kqeWt{Z807%$WC=!*X!SL$X4fMT#(HG?B^ zmZT;KFro59&(yVwphAOyr3WSNi^6>592XE;Y%YnnGf!( z#40%5@Pnlxa`A2+S8z6BZsbrq$~QHw7wTjTHG*v-ni{5duSvwu$)ux?@yWY5wMM^~ zdgv~%(N6VkzkB=Ll2L@snCHJv259{H)_HyPF%zGOAqyd)02kMi0EtZ=(IMfJ>h$^& z0lNfc6IxPa=WC)#7(rNM2v~9myz92ltr!@T`DmnpZy|QZOL(+!!KWVyH@ITSzv?wY zKrZ@WRkj^DE7AA*`Co1Yd>*vo9d#y$Z5dmI5*e#v2k{Xsa=OIJR8o=PGuy|JaI@67 zLMRtHb5tT%z4LtQ@=vOO1%vWWRWklZh3`wxuUcEWzB42SdUY20>+`aHjzL{2%dWQL z;BR-Cozri^(n;~9?s%nqUiPu>Sbb;JrnO@&>$$i33?J>I+nyyo^x|0#gZ%N0-ggm} z>ju$`Jvgqj2l_I>;?0`{s8k-QqDZ_u>gb(RxW9(N0`nVvxXe0M*_uOtbbdq_Fw@;fsiRyI{VPX zW9k*(NCeAs(20tTVyG}gsR}Qi!>}0pRD>&QNA!9u{3YaJyUec2j`od?GwUpi{H0mk z54H;V#@J~_^bZ%+E2d7oRlmO(pP+MTTYPsg-FY^UTH4mM+$TVzTE#FH6za`VYowz+ zOUb>E+km19?Qu;TB8|=?R>srgyw%>mBE{w66 z_hI)*_n!BMI%fa0srnP$PHs_A{gaTQx5kCm9|KU)#ABy_t}>VP?#t=CCF!ThT49$b ztG9ecP~p^U@`ELX(=@8~r<{nJZdfY#3i;p)dn>x^4{37xK`K#>QcY9Rw(HD&rZt^{ z@DwRG&Ok_Fzp<_fASE2#k5xROzd5D#ZP3HgN(tPHyK`CgRKu-ek)mopmRODBhe#WG z?ESKn_!-zGrEeoupE{kA7*Xy+=U=78$8EA7-~1-(vGE5Bf@TwzoAIPSJ4M!hJzApi zNt6DLfc&UR89+{*QvhV8xg^44E*F|Mn4l%{Ls9yI(^*j_Vx&w%LMqU$E|Ps@1ec!S z-yNrB+}itbIi$~VAvS6`Lv5ZIJiE-ag(n5zu0&{NYa{A~_ldeX4GV!+FOtLI;qVYw z>Ekhur0tBVFD_+wy^Dv5p6nMD#&p#G?c1FIy+418wX;HE{iQUQ$!N_3LsTo?WS~9c zl}U``c2x-m_X&BS32olP`Se`*Vy%jA&oxeUVM2wnYsQq)sg>oAqI&rDTxX$rx>X~wi*-q?hk%MOWqjA&J0B`7Cq^K?TpeqcCIf< zzkvYXlR|&Ccw-@aS8BE7guLj!RR(jPa>1W8B7EVC8h^@j)Szx@Vh>HX@^p(q(d05AOWJspz)dJqkW&S6+a+dI%Tjda&uoQ25GEP z0yw{=4Ut`D)%UA9$8ckCi%>ReQp?o_7ZC{PA0(2P9#xgNXng4xlOh=@6t;21`hTqX z+EDrZCTZ-nu+xWr?wwj_6{^H%_^t`mPT+cuCU?E8oXkX}dpc=nEo?a*pJ(}PW)hk8}#bsxF`)h=%Fqe;lg9ZH~ArI z+t-lL=N3Jo6^vf0Sk2->dY03Sehi}}B}hw8NgtvgL-3OZb$k<}d=x1aTd`Em?Qc!} zi#a?v*_N8ern_4ILbAZGa}Q=lA+A51{~*Wjat(kyFw%TQ0UCcrkee|H_riY82Y$|2 zMUy^v^}|zrTa@NvE`dxeVWGr1^e-88Y&I>+8`3jLroYeRMC+7e_b0CTi9hz@8x@KG z9lK}sv3+VCB>2$an!-OW`|dP}rrX&8fldTgAfs(&{JQ@O=WtrmbQ_Rk{D=?qjbJ4wna<#CaI-l{D z!avi`2X#HMk+Ei8y4{-`Cf){CU{?s-5FU}pbpt&D{ECfWUa#FSS?q>&^ZBOTnYFT} zKiswTCn-7JIlE z>js(AVR(G!9`l9oJn5v9rdBnB_NV^jEMhvHnNZrLhDD?;gkx0TJI$!kpp7SzeFrL8 z_-cVq1L^fj#=yg1*dyBCeQU-Hie8-&LpuCA&2xnbynh7?dKqQKrBm9qg&LZ?l5wOn zvP{QIHO_AFt7J-Xtmbcgs`H4I!`#m|oKu`Ono8r=q;FuFeC|e7cAKi+>6VGR6Rn0? zTYCtjvNh|x*w}xqeVe3X0#EAnGs$ zef%Z_!*Fi@-Wf&*CWS-M1z{2bRxkspn4C&P!_hk8t5shgSx% zfU?Q^AexCEJCi)8q7yYvB5EQ3|19^v^4)*V6j}ETLYkV^$O6}>LW%%Y;B47huojU* zn2ac7jvl{5W~zGO7rv|h1%n;*w&8Vbc`A}I7$Zfig{S16$M5nkEx+2sNM3hf@Z)SA zKhRL#-1|b6V(5Od9O(_xoE+T$Xj8EscAh0;3C_WrXSpB zvk$H?( z+;sMoM&(KX*}WMozSO?|)xX+M-t{zomWF6LD$dflE>rUu8f22Kp6FEu5_>&hE<;$h zhy`Ja*zKk_77>UgjR$aM%nFK5JIYV~hi%i{dK?G^uv*z?1pd`Ig1;0Boy9RJ){W_n z7cH)-<_gdCeX}=1f3ZcVHDabcXr*=QsVm$c7&QrG$z*BsyUg5)&ADB}(3thXuh`|7 zjOprb-xJVqQ{*x_yO&lEc*og1MVWpL(01yky`%EiWi0x?WV!zXWdFIWC^>g-A#mkg zQIJUXATz_6s-TovY6geamqAWtSN}EVO+WxSnW$NBB4408t_dGBluC~d<1*+(n)mU4n<|Td(?2F`;p!>Grng^P358pO}nyt}J z;9t@QFi7%+*wH-6N)i!FrqxVRV8x|iFnJg`9BTL=DzF;=hkL43-tqco?yqD-P0@qw z)YST~h$nozZ1?zQxQC<*FtO9YT{+kzR#~^be768ygAn1DwMlL~G;LS+JN=$7{JOEm z38b@#q==%20~5`XU4jH%3fbi_8b&Q%zqM#r)%T_wrFl-k{{|Hc;LRau@ENF)@0x0w z%e>faLXWh=OD8(n{+Nk9ZTi|JgZ8`PDxw&APf9`APFzdj)gDhcR%@kFUesi!ENC{4p5efDI2I52 zpHm3T#ZIor$Eb}6uGK<8aQiP1-j{+$he)(0^I( zocjU*MQ^=w{<(;wH-i7m#KI7JE7l}6J&>%2(Dt#B6fmNS#a@WwikmWwi&BW671Pm; z3wbs!I+&^OvK0>2mB4HP!FjxFKu={szP8BGU3HSj%u;K^Wl8;H^}<-%1uqnE4^C3K zh5{FXmukBJ0N|s3s)8VWXLY*M@#Pwauv200+V|yUPx;9N%ZdI|01qB2!&|j51`JZ6 z0(K;J;U1CI?m|(|D^idYlMt=dn_dz!Dw7xrpWVh4-K2sk<(tU_ak4mo;VY}<_|+^V zAO$>X!VCu-J>x9YiH~-0Dy5`GOR7fpPjOPIshWd#Wrt#@G9$sK6(4oiWk1ufg*+}| zE?i?;@N#c92WOfo6I_*^I}U&3*lwCSlwf_b>8BLO9i_GM_aEcN9qPj<3fy%=g1>gt zvHH`0Cc>IryX-vfGCJsd6Arg<$yl^x;enRTkw&_*tv3ZcQ=hH-f$B_nTG14!sctKTJM8?51kcQsg( z5&!^a3vBFYXVd`^000_3P-}=RRSh4&1Xl+5+mAUOhpN|!@FB8rgH8dsmO*^1F zl*8PQt0!3Iknymbf`Dz2O`v~3hL}RLvj+g)SySD|Lkd7OH4QyAG#&>Ny$e=l zxRFf)PZt^cY+xUu#04P1qOlI3djcx1;<;cDvfzKiO0G(hLkI?^g2UMl&)w*xe9EE6 zGGGQ=7yUr22mGCQH4vJ|imRqdK03qkR0A!&g6@U-dnOKVRtoD~?$Qhh?qk)pTCcDB;jj z=VkGBGk>_sXGcKUur2Jn2e(BsP)5MQ$}x)QCYh=xnh`?CE*mp)Po|m~ATXmUwCPey zk0%8FydbE;8Dg3>4?cou#o9x}M&*$i_yJaCkH@0JhcxMDb5et}883y@pCf%(R@N9+_Jq==oCnVNE0YYu!9ou8$Jw_4ZH;;dQEVJS1+VTh|0>>{Z8_U1XUIxmb#qml%!@)%;>M1 zC5GanHFbs!&B7YAIy;pbHWWt<8E8oH+t;jxa{ZmfpmV5;?YY*7IC@UW?YcE0VyDdv z#^qvt2?>KXh~w-{&y7Cc+nbh$dnuUh=GSY2%^j_*$N&1!TkQ~hQ*rRkFA@V*6|Hnd z%|n%qc=+tDdH_0ZAl%qD1qd*SLfY+5CoRMP(W0S#Q`7;I2PCuL5jlWypsZX$IssCI z^4^%O<02cou6!bkx3in6P`qS77!qkgRqVWp#B4W%Co(~3nk^rFEF(7ljMS zm(a&miC6j9N7`Mt-JK(Q1bUGkDR6l@Fpd~A@>G#pspi5ZrWc-xr9c%|u^u%MhjMzW z=$F-ob9BaXR-B4?8r2PqH1W2m{uzOtuk@`cN-epF-@Z2M(j)~kUavo*h- zg!tQDW?duAHy?HPsm4Ye)#m(6A-lLI|BP7QGj4`YnTK7mr0h`8^RH_CW4)EF((hGb zX0jb?=wgHMtj#=CXn0uqr_^3YfCorS5isiN`7;iPWNq;%EWmw`W2#YPXM1P&l#~ny zap%Qabt*U$b(VJ+!D_wy?94mJ@cV&LudUPD*MPp~YXjJVtVAl2 z^rR}vguDGJVhmv`#^6k;iyD;rYV@ntD<0o8i%xS>>H7VT;L|cBe;S)x2{~fsINQ9` z2F^_Mh@fIG6WS(c_v98Nfp(&U5_>%B-fC>Ee~<&eVE{lbnP~4LayE&YRSOGI$)R)k z8O3}OyaLG1*urzYvXrV`QrtxK+{O)8&z^3(J?%?-&A!Ufd?^D0`>Y1px7)9;_H;=tTFhhJHgWFKMVRvei#NB0{77Om{tHt9*Ie^QNUGjJ4HqKO1$V-kW; z+)sklgVOYVF5Y)})X+Vw^vxbU9dOG|IM7b`N$5(L_sRR*O{B^_>M$yG>qiH$SO$Eh z;aV18%k-BRXpWfX6Dgr(6dL+7HZVYk%BGUiK;H+Fqlb<}0|4q8`t>ww0^uCPrk!!) zFSsvKX~%Pad>yiDH-uUY;R_`l5=1w=EpJ5&BcwO|U_a_vLdfTMrH5mc;2Mv*L|;7-vZA_eVNU43IWXsJmby4(bhA z^gWDQx}(2(!!yb4y=ZWoly+KAwtVPMUeoUqzb}e-6JHBp-&uSKu-~Eo(9=Xb)D6-L zmjq@=SBO$8A1+b#Zn%7Cc}mC53MP*K&;tWqy7Lw1;Ks!*9urj+JZy}B+y|K*2SI!wZ2X!NC-z|a- z(Of)DYFKAPEh(zsLsFgJfAl%&-GKEy^?AM;vGa5P4h=Ho4FKgnYTc7*c1!5WRMuy* zxS$!3n?y{7Fwd4O1x1%v2@adf;eU)yRI+}N`^F>goleS9TOHran}#6u&NkQbRh=-G z+0*@5=4p_r4qZ>Us~1~99yMirxuZ=%xFnb4(e9EU&j|!#VY_Nw1F48mgQ!wbKD0pF zwqJ!mdTpExo*VV_G*Z~f;<%KNBhB+h(iBT7eWjvOJ^BEvhNLxnityco|2ow*3u&qM4N+gQuKxQT1pxPX0(N|QwEC+);qit(CzqnSRXFNL8Y6Tioi(M|C zm%LiMdq1<4PaKuWm%Hop$-%;jx~|ULX_sfYXQZdKS?5C!A`?yYsxc1SB_CcMiEET# z2v|OV)(RVR-Qb}#kn9)JxqnjuKrP5!e!e1ump}URa>v z#}s}~Kf(7&&$CQHMC9G1vtytvmCH&lzyWAt1-6(tbee@hz4*r^869$-92yY@ zmaSxpmm?v99&!>rsDC6ZD1-B}h_L}=jKh;k6qSx|f)ImPgEf$5<%7Yr&_^a<%|OU_tEO})AJ`i_H#n;pO|9# zi}k%!oG`s3%J^2Hx#Kq+AoNTSya}yFoHe7vkqSKMpuiHqii3h$1Vb7Ho&t&UTSpU> zNZp(U0xHNbPS;}AAxp+@h?D9yw7WD# z37s}DM8sx8mfw`>B~G2uj4zjr*ZV^J*&%Qv7`QAMd(~@sS$s>7Q-H zKY)_=JnSu&5kAxbc<5bpNjmeC=r%Opoia*Fh8J{k@aRdw#dyGvYf{GZQ>c*`&0h-R z&a}0Je>ZZU1aX-%Lb(`xSz#EXS!~AJbZS`Enae(nY|jFDH^R>~>W}T?WljiaXuERr zncSX!HVS!-v=xcDehY6TZu|8_m1)?}VWqcmIT((uXeaR9Pmhssq_(+gB+ak+%XgZn zU5m6MzbmVH=AP+?H2Cjd1Y_*sS8D(43!7LrJFe#s#zsj5wKJ?g$3uI1ghpsbN0J3x z9(0a_rN*Gsya?EyrJ_A7jX$O#g4`nQWuU)<50igns+N748(N(@y+0G}d`ygSk|+I* zQ_8a{52uBlKmp|9#}|LZ4-3BpJiYhY{^2wi6P1~?4g?#DbEdbnu8@JR5&Qj9?I24E)vMMcK4biN#F4;BHJ-SD| zVu=|VN$+y3gshg4h!)b))@QIUsJeYnzq*o4yeU{|+@^_6y}WL;3kE)v@GUnj@&KpU zmdtqKP-)u-l2f9R;|vG6 zeoKCWVue97oe&H1^9Q}INPEP;B!gZKo_{%$S4lu)YL+QBMt4Uvu<9_HaA(ugik6D% zms+IM{8{R^Y?n#0kd+$S|5VjuV{{-RU4xsDqZi^7ih>2&%6*d}vHcQ0>w4MZXn)Il zw|W_l7ja%DU0c0N?0TReedI`S<=UCaIMeCw(0C>%Kh#`o5F54h7M{NiHnO}#RFPw- zs+gk3KICEJ{i`QbRKrlx2WtBV#~*Gh27WCAoR!ub41(3|2#G!T zl=O~UM9k!%!Yy`kZr1016`2u{CCxn3=Nu-8!%Jabm6e9Y1&OGvl)I2wai&IbV#TNI z2SJe3;vl;sN+Fu0r}+Yenzs3aFIugO1g3(6Z@bnZ+SsT zMsPY?v13<$Z`JF;hX*-(gRiD9kL=akjSAJ@XL`wQUekldts0*;DUL(0^6A98>;xk) zW+I?)>eu$hc^h2NbCrBZ-oe!-tXDCIGmfWJbp@9;wRKhA{<`#{xIw296+ zNt5=s6PIlpjA@`=0ze%D?3B%w88K!R&lY8CS&sg@_zH*zr`dHPo|;hm@|?^ z3w6ct7+7gf!YyPWAg|NONjq>csX}-w1lZX!?%593PB5icsM&D^x0Nvsv8U(Ew{MiWm1w`q!q zops+}n+{orG>;-Wt}ui`MHjDA@NjBzt-RV(COx1^6BIU57Nl!Nzd**#$rWR!Ic`RY zGl%#SR8j<=9NvzVa>-_-7+%UAo8qO+NC}|Ty$>| zX!a7f#?PsHED22*%#G5XR7uk-tEkH#rtf;m9NtFqc4+9ODF_Dvi1IMJZAXNIcq0)X?srX3BC&Hig_+JdcWBPeh3qwKp^d!o8Q5WjroeE8RD| z5vvso^mEJ3w$H->4_S{x@&Srgn8R$*+V-ih!+jr+Nbexf$fsf$XywlJh-5<6Hy6y# z9E>hsbtnTm>gSNER7ZLfRZNCDT~V(AHW1$>Qu^n2=PP~{Hw*{L2zD&&{(C)lNW}Eu zuPdbDVWZXy-^1jcy<>R7^|T@vzzvE#R-d?9zO!r~RTqPY<{WdQ8@Wy7YxHFsIs1UP z-fNq`HtygoN0+tO@;cr4`YpAY%*IL%Y6}u50=0xD)wtVbD_7xo!iiWOBq()KLJGNH z2vUN$qiI|2dPR;h`@>M>d`GV49>L@4kKFilR=B96&{3%+v?$}H z!F=cUDx%OVw7NS|c+XTOh0v}+nln46JY4@E=g;c_fUGlHnlUj3H>rr4xu6AL_!X;v za`i>?YR-jHBE9-RX9`35ilCc~kY-dJ-Lr`AF8|`Mm##)R9tn4#=juWG z9@V}T!jw^BaeH#x?Ny6vG zl(0N89cWcGj2(5ZOLKnZ3A7f` z2YO!1%J&rbvXLq_4ig8(?%rF;Jj4dH2dJy*!$pqRVL~_FpuUk#1Ju-MX|!5$V^zdk zGzrxc<1G&-ZP<0TbEwT%rfsyiv9%o>Ff|EC3wthSQ@!U)m*^sHcAcK7YGA#N8R|0dYcFgO{Nm3+k=$(vnL?1)hSU~2$CN>H){A%clyM4aS*K3YI zd8feIqvIctA)=qa6B>hsh``ja-X`!tfqiPXHQ6^9<^!P64E|&KpdUtGTV4R5`az)h zTmyjrU^?sL2n16jwa7}KkhN3mRa85jlXd|V&iT}rl8RPOmbn(fu6DZ-hoxR~d7Y~&N!H`6%GtUa#84tv~T`2a5TV>ZhE8I_K>X< zeZMdJDBGbe+hH*Vy@4J=bar=^y%|Xq!q$Ku*^9#1z9LYiNVnv~IWV{|NC7ZFipB+l z@56`SKq4ttSbZAaI;_qD-@)9(3zjgJ;!mh|5d>U_9k5Q~s+pe?hZHoe6Y#%bK2FS{ z#}>(I`lZ#FAKf3(mxjQiuVX=!GfW+@z@qZvp!9SnZsY#YFky#>gm}Rq8Ar)S|GOZq-VS z`?lm$Z@d&)Pp;f7;syOBy|y~NYLCO3Yu&8rK8`-ELxosYWEsH1PQQdw3^QN;$aiZ- zN*S=VjSHUYhpKFsPbFE7(V$LxSZ0;e?m>$Fno>h)ilo)pFV;SpX(>bBSY;`-?s~?8 z&5%Q;+6)eUbRkptT5~iCRdXBY2@+Zn<=z8L5&PauiG-fcg{MjF^gyz2XJ1Mt2uMJ= zppWKjh4cM)ClDw#bW|Ah(8~&S4={`9kEC-1Q@%)`~a^F_0RG$1C<`+D)rq)Md( z^MaUEs+3q&LuC=H#&I7wH-^-Mb{VrxT8}$f^i_+~_ zO-HjQcMJusqUX@;g!D$qboAyseX+ zMPj+lY`{AN4CxV;-q#(x*JTcH;>#+t4X0Oe5W3?{|5T_60lvL`{r=G@^^uw5A*_{m(NnELV!XI9OTvu zqAVcexJM=rEI@ma+9U5o#6qU+(c@PI3{O^QxQUsll|w>X7m(+Pjw~)U35@&<>*1qD zg?hKBRa=_v5Hyx*e&NuvK6R}w*|yl&i%hKWUV(m|E(O}tezZQGoqaujfp1=VE#387 z|0=-HDTGm;e;8GNM|6E2mAyyuepl`C%W7V$_xf9HLxQMo5IAJb@l+7>aQQ)_U2;JB zQfp3`NM_?gbS*NsYX?kqhN!_WyOtV>&Yz~VKCk637z@IiGaIUveITcgqb=l{MrS?S zdFS8ZAhn(QsshL?O43@`0;x)vu^K$ngqE250@JKp!lJlm*0@y6aUHb!*|_h9`Q)T* zRvXllc7xV66!s@Ldpo?t^KtY{4K|wNth;W^ss|JC93uOwp|FRG z_Jy7QAotSF27qj|S~g=8_$_U1dnst^hH;p0P}9f;MuKzk9@NUa=m+f$C$pczXh+Am z3sy_y8eZvUr*KGr-pi!f$J7W-r$zs$_JW;hMd)r??$Qd8@~G?hp+vdO zN#_93shP;c&-dY!cUsOgP5P+{70K?`$~mVnV@S zIZBb_eQC!+_ErGF5N9<@nl$G2ID=-6lu<}fWuk%iy90Ha>G$%opXqSB%RWcI}! z$K_{P{s%eADR%%QpW(^^98MMfjdtHkQKDaRh!DnXh@Mm zjf2H#YONu5Wg>JmmZYS*xIqblJkTyxhSLeQP@K+MZHHOMu7%~&rNq6 ze>q|3KDT6;XiXg(0!z5!Hh`kkO#Qehz zV+lnlr7{d9D*4DBEFNKWp95XMGeFLQj1TV zg540)MWEDQwI*MSWdcqb%LI{owDcGRj1h*o1y{8oiRGjOm&_Vsnh4KSAfoNWN$7ZH z4vQ&>s>hL#1j*w#o-?B%e5d+z5JpGPE=(L@2$Tyd>r*NndyB1^Gz@P_^5HP7X(9?c ztlO-EiBtjRBuWCk7Ici`IL-+JwkkZxIKV`eIh9gZJZ%cs=`Lt~(O~yYtE~ zN+FULJ1;c`u<;gK+QHWCk(IP&a+Psz@H+HFrnIgibKr$r2>+`L|1+Ma6_w;JO>*kH z8uS1A&FR^VKIH9Arp%IYR@jVu!^k264&iq&fNCH)yVPSLD%`;dAY2KuS{2fk8XO+q zu`pwhA_O%7DmV7zwd!7UL5*j-PHD)doU;3r$U+IBU_7s_93zJ7#4QZ|KmNbNd6NKm zrtp=2t`A{Ua{mmxFl1dE-a`Vx$dK%X8yWzOSwkg-7N#Dhb4j(vDa^WU_D)BAe?CXB zcOX!8z?o5ahQB*oWa_m}$}5rnb@|o9@y>Q%EzwpHnJQ!Be`D;Oq9l#FWzj6NyKLKb zb=kIU+qTtZb#>XcZQC}x+-2mg{?FZak8#I7XPou$W#;#k4>8u7bH$8^VvtEY>N`_FA-tAj}XsoYnPZ&Rze>vnM~4@Z#Map)}Ha}M3w4NaY>|| zC|f~o+WEt;vJT`>Y1sWx$)wm33LGk!`n18)hD0m+unzJj^%~c^yS(dXwPkT&&hVB) z4?h8U1+`-jm0e%xCk3^2LC>H!2x|#%RSbG4#LV+V#lxR3xpfy16=_SZX)2 z%q?giwz-6?a1-E`ki$MhkultLY9Hd+? z`F!r+tvdH*x#d=NR3LH7&D~_DO&V@t$8;-4E$6 z{F-)8dwGu(Kd~@rk@c^7|NJ=m=5F0IRy2);BKx;rOEdqTh|oputcYd#(oP_u;hdI9 z?Hsn_Ne9b^?!ia_YrXU}3JI#Eq!1DcR0;M&VXyQ1%So8{jdkQZBd}Wq?Ogz336+O=E99 zY5zF@nW))tQq3_d{`-ZcOY$z9MlD^Hx*zVUVn}Hw#jobWo+nt6hGkO%O9m7Bdh+10XZxRo=7lEfm~7X26-P^EI;)Uw%+_=CI`SE_3WgdP}Yrv_=K zSZiD{cG%ryX{ZsjWkI9*3!xk%k4&P3BiX|=IUt7RJ_f<^{w#J~}19|J0ekB%~ ztS_QKt_Zs>|?&Vy1aokI2s&m;zj_`U|O8wa27EFxURtaJo zFQmI10-&vC<5%xr;g@adB&B5lCSnQ~ zv`^aXFj^(359e3tiWyn@WQt{}wx(*DL1-8mPBK}M^|NQj1kH=(bZ%pgWZd{Ka|B+qT9twYGwNxUzX8Xtilz-$POEb5RQk7Z-fvthDN8|@ z;YDdj86SG8uj^}5OGnhL2eTZ%oHQ~=$IBE+8&Czx!uEghqMjA%wfB8M3{L7Co33e? zb^t4I(fWtI$HeT~DL{AAYdD(*35_bsl!}~k5{3kp^^vQUcs-iIBqO7-N@z5y*y|MR zNHtn%bD#6p@jo?h1H#AjMD!Vt=$>d3g{<()S9o4K4{9D*->AZwS_mOwq0{twW@^0r z6EK+89^%i$*WIM`#Nh%-$Y&)9j}arlB!!HH)J*~aU*_G261#t8SO_eXNkk5rst5z3 zbk_}dT+)nCN5>Gwi1lo1%L@736)Fx`*PnX*rCDxgIWpKo>|;8_dxa|f>)HAa)PsRWfxrEdZpEuIdvD|WtVD9S2OBNs=Q7fr#1J^ z74%j#0mQF3E!24WPgEBb9-r}Zr=YO|$7ACbKd-sve8wGfV1xcgi+n4tgg8sVM$ZE< z+l!%Ck(I({Nf|>@RD@Ak>c`xl+EQ*4F(^=&+Rar*!qb#^gF_$TlP4!AA;SJ#J9}jo zAq>zAq1p;AgoyQ03w_PlpYM{` zEf1Z;KVt?Q?6#_6tub3RrIyn|KO27j_J1HCcz?E*!3MtDzn@&~0Pj0}{6Cmqq`!^$ z?3Brp%N7Q9JxYhKY+EbK-R7%ffQlY^b{n`0otgy>}z?3uIBU=1PmSZ-6159KO zs0b2{;|5JM9LIkucpu~8nA>V&srVI~09SWDid39|_WDRO??dmOBVEgdz?+1#=|cek z)T{()vLt0#xb=_`Bm@^RfJ{y^>9@f|4O@_ME;cx~;cqF0!J$}YKn&=8qKc-&X^6Uo zSszXR85nrngrI9HkswXL0UVk1!T0hkN*s7=#C}fn)%K(KKI-K=brva9VMD<|-RpeT z?sKE^Dp%ElsrSRsPd_z$Y^$it5odzo`uWWtjq@?N?3~A=#P-}JrgpE$>)wJsB#gL+ z5YQ_0GG0z}(hTk;TjEtUjiZnR<_JS-DVTmo(XXI^*-)>z&EX=y>YStr(zN2fc+flF zf4dyj=~w8wg?UP<>~HUhwuKbPiVxE1=IYXA_?01QGz5C8xX8WA26WC9dgM%W|t z+lWdgiRc#(mi^9Ml$FuUgXSkcMrDDOR%AI- z5s`6L=*e3}hDYhJ!7H}+7!b{ z0JNre&QLahWiZXcqfAw?URt#qB-0>fNFY-hHyqgsu`nA`CPM=obR;PM=u+7oZ#jNq ztMaS=0-uZ{%q%4I(8HkWOy%+9y%K)H_1%kXZMZueDY)cavs74^0cAly1rF<%qBBWT zL=Tc1v%XC8IZ?ODh?`_KZ}8JE=6(7bt~iNp=BOKCSA82ZD~czT%M?Y89XBsT%1|-= zNKaXqpt_VcE11_X0(UEHtY15A0MdpTp1#{@Ax0A&_pDluYP7ukr@d(nBz7vxN+s?iEH0T4k+t{cP>y+i;IJae!LGP;`>iENX% zS{Xg9r7QD4k@F9h89$xF$cHV^(~IqF8kE?KG3m`fA#JSuP>{Gueqw;ei^h+QmZkof zB9}WRPh!t1PrcYl_sdZS0zbsNlL+0y)KxUhP4(?IY(IBCLUA*QA&~_}a}k?foz*d! zhoLE z(b|;BtvoAFusA2KFj2$xD0j!PK?gc%^KrCpF0QFPHK)uv=*(r%TzU~Ii4HWxVMX=@ z;)VVOQj#*@rxp;r-u?sf($#<MX&y)=fd@#Gq*P-g;s+&iTOCj z#Z(U=ImZQ(fPNre11V)B&NMBySmyXQFoQ1goYjzq??z}~RJ}k-w5f{}s`2dvPGJS7 zOd8U`I)zIm62UEe6^4XDup)5gV+06pwtAA#)zcH?9}7-QpA&7HJM3Rw(JoI8?WKL` zSeKZHK0d+7_Qyv9$7>+Q(qDghI89GphEKLMI>_ja87VtFcUbc_95mp)>X)+?@ID}K z1bl&vb2k|jGu{p`7gZ>7Zbj}DEUDoW`G?G^-^>k?U23F&HXo2pfrrH-H0DRS!CWZdm za)70^>@;8$XCveE21pO=xiB~oYf+q2* zeU1a47JyzhJrCI(;XM?uo89a!7oTrCzE1;U2M$OQ8iWx;`FB<1wRK3yA~TwxDXbYS zri7*lW)NsfCDeN`KFNfop8nb)8X5_)CsBgFW%ty-V}CPO(|=_|pg47@J(P?5depA2 zYnfEk7xTuRA2Sojn5r|9dl+w!dW6_DUT5EtrpT_}zjO)p*7BI2m+!DkAIcvre!xKd zFyGWZ+2IWTy}rHtJnY_~kF{kjz27=?>5t=l?7e*VB3Y_Z+ov>ueoHzI9FqO@0~j$C zrAHnSWwtL?IXlx82Obbu3qiK{2fQk>VATX07FJ~5(S7d7nj_<2+oZ!)=8&5UN(CE6 z0x1d}k=W{kk6*Ps1@kjz-I3x9lM~9LpOS>e;5--CIss3qOhNJ8)k9 zz2H3xOx86`S4>MQfw|MkfD(i88m*JhpcCX+Yg&m4IwpL29cYi%`6Yd*wV``K0YH+P zs!e~f4`$HR6_dCCl%`-+yf4ThCDQiPDu7Rn9vRb@WJJl{1&UXEhfo3xi`6txswQkE zy9lL(?!#J^IW8xSyNNWw>FRd+(>Ywx6{j_H`t;7Ajcwt{M$Nl<$SSvvn8fV9nz}$e zO&e|<(`lM+pIM-XN;tYpE4xI7yM=zoZET#cnn-V$uVrF+ZjSV*JB&qM{H4CrbrM;n zjkEmZD;woy=QZKWzj(_d;k-SEsl#UsY&z(9Ap{2t=!Irx1wauxoJr(3u*gC?JSA@( z3%h^0zL23~SPnXf*cl!U^&5Dh!Gr{dlL>n4c6P+2DCUKTDC`PIe$~LxS_=2BuT3pJMCms4^tGf95eS0#Xvq{pfKFz`!lQq4BJOB_l8bOvoH! zrH)o@sIp3D+eI_b=X`L~^Y3YX*cMr+NfjGrRR8!>-=;YsO>3u;3TZ4np=V~la(j_s zHrcwp_u*0ha?9)9+QXFb-hT7&yJIA})bpX)5&e_kdFTH9#H*zE`r-);Nbq5g`RhtY zR`y^9Yz2Yo8fS0mZs;VmYFVDADKxXsATIJKu#vbf7nz1}uxG?bhtvg;yn)8BextDg z^~L^K-PzTJD_O)}Yh*4ZEC|k=K#@plT@;s1pL1{cWyvKxcaJ4 z-QX`44lfEMxp8N(JL7LE^Yu|>S`C?(oUYDoZV$gy%t8_~3I_YJwb}n|awp-;0pK$x zYhPAh(7dF-3NUGA5ze+ifjD(98{2Ks~4?$I$*ORn+wYR>Wp7%W0M1f*#tQ@L! z9)WZVyNf|$KFL<1mMXg1au?)$6LO>f_(Baebh2FOXw~orgB&F<_xFH2@G6(rP&_lM z{N_RtPsrTA-UX%mVQ06=GVhR@-)Ct9N_15h6uZ_9gVD&I!VkhvRc9M z=ARMn(aEz0an4C7W~J}XdBw#(fjLSdl)DBj48w|nY6ucEkYoVMDOw`Rn9v8|$f3Mv zS%6b2-lvAi6BGzJ+&ZEQ7kR@Dr7{#zbaU{j@)$4(EUFhk+dS+VFWBxPa$zw(3(r;>L=9G6wQU{XfWsM*6 zPu%cj&!%>0I=LmwJa1z9e{5AFM<^{VNt`e~vk9DtMx3bEb~W(UeJxLZs}(-+#p!Gg zc2j?F&(IFN}oCAMJ;Y+u6X`+@I~vqyc=5g z^d*bq_(FeQk~1YBBm#76S)GKAbM1SpZd}Udl2TSp5OxZevIH$VTe)f1t(9io@3w7I zQ?bHy2}jv)Zp)Nd>Qjfju`rfq5;pIfbLB&zwA>>_I1l%dMY%;G*aCuZqA}}KoB1y@ z>Yp{rh(PtHd=@hEbTct?^YF(LV%frPq_mPMAfs?mAb2Rfxv9I*QXn#oB3b5yfxBu)$9shxvY19vUU(NIJY8gRj@0@_{~))DN)rIp zW1{W%)jgO5w_koytf(;F=3OBHFzA>x9JLC7dP?MS*VJa#23X&{XJ5jx&YNuAP3IDO z&B~Xq#q)vpJ$~kgE~gGhzwD^Vn;!AF%^dMem}YkfJk9+9e$?5v*)@=CH*$}3-}Rg( z!3>Erb+&4teT6OKvd=sZ-cWw?YJd9=$7hNNsRZy+#e1HS4Eowgo~<82McE|QdOM;U zZs*G*AkGqUJKd84Hav-@SJFMf;K4-^IrcZZ5t#U_@BnhzU1mH>M?wKdLR`nOR=d#h zooVEWGNEF}ZSQgLiR31^BZt4kn~Q&(iFXYz78*4qld{l2zG)am$Zqxi!Wx$%nQ`)q zNil)%y{QPGs5B*p_sWpHY6@ORbt`!T-uZ9m)EQj(RdXJg0*DfX5~2VQhR9HHqsR#= z$VlMQp{W8^SmfbSV7{jUhW$knGv%wS@s(!eL&@oRT;+XXS|UOH6`Y}$v@>ZNRzev& z$(@+oA)U%jnl9Q>NXShIvD~+>3+o?}2YQ^pMY$d*zV#re|Jpf%RqG^h^?!XX?C=Qo z^QtoE*1R}ouUYcjyx@4QfJr@&aKX4xJ74qKNudS;M^51|BLDyaBkfviUustafj?A9 zQVB|0DNc`d{aW<($p>Lh5=LQLiNvn`jhr9YOCO)Ve|?l6e7>moU%zQ*%fF%`=Vbj| zA`B5T3l&+kh_5H&(l`iiLd=T1nHS`iMK@$8Bu9W?;5J)Ik0g3FRRE1#RunR(&rG0= zF9UND$ybuCO#L$J6R9fhM{RH<$V3%Ed7S6x&Xlur)_7U|N!D`3vPZSR_8)y$Gk`Gw zeAZuTp4xQC-Fy51vS>YTB_!vMSvGo zbd%J!-H42{aCL-7>!MNV5=T2;(}XFP;`b)!M5~}-QvVA8ld?-NJ<&{evA)Xbbdq_$am44xeSs=^V zWrk$aq^bQe7vl2dl2U_lh_b0ye#m-MEY0H;1B}h3Wg+;eamr0v#Yd!`zAPUl{ZeF0 zk!5VO&mBVkb|OaHR;A5eDd&QE5>_(3iG)M0f^g*8H>{sQP&yu zFY5&cuqdTk%>`$Je%crf`!b_HfiKe(HJt{T(X>1Q%0Qt02YgGAQ77I>u|Jghvdtg=XAW;D=-d&guvWnG;;(g8Z-e-LjBKBu-;7| z06bV@#njXQR1VB5vXTctC3qo>H5mXZm}}MZ)v(Io!h&E0=BXkw5t{S@ZhL2|B51Yx zoA>$-Voww!zKul_7eEkGN~I$(8bPiI{>hCuRE@(!)ETT$?F*w03a5dUqN*@gDSCh) z)+|C*9DtyHb+CO<w-tVP1@r3YieD~*-zNm^^W2A%}t%c`YGS!Lyw znhKRFUbbz81zrM!>eblHprx$cc<*MvQDv6ao>!KN;_lRC)a32ZU|*{CBX%Uq}PM zp){3h40Az)FT8yJ&;k(0j8!XnF2@0MrDtKVoRBMO7o3{$L#V~1k~mVa={#tOu`b%i z$Y&fhGS7FBM5Lu#pbF&Zb%O=%A@gYFR$LJ4r)x+)8_k>6YjjT=DEwX&@K>6)pA`GR z*O%^UI=-u8n6)Qg-xVNmhTne%A@j5CSgEI>NSIu@F4DXREM{I8+ES87k`iulejyW5 zgjAYb2Q{v)DL>y))lafg8APNDNpl)0%Oa0DUoJF$v{i}zhs#jS>+Nf~=iSK7ZPj5$ z!g1yk*`F~X+G-|-5$T4GQ?i2oqeNA-Z{qEu5l(AvCeq~}{k`w56&3c|Ni02`Po!=| zb*1NC;e8|?(NDJzz-0j4*YrBk=$U^I?aESQ2*qEO19m=6E-!G^A=X30M`N7w_nNp6 zjy>LT=5^jWFqn#Mf`hN9y6do}E}62_qV=lJ2S50q6v`y$ZP|)~LFSbOd=B ztG;u|oJgzKgGHzbV^Q(rt$#%8Z(ZZL;JOcct{S6cuPC-8BcJa@+>gat$@A))xWoOgu z3f&tNPibjh|O5nI;r^wxfC=T zQ1En(1?#WOINJ*D9z&x{m7zS9OC}}|`|@&^zmc_zh_*g*6Q#y!SF)(K3=0{jXK&PI z;@$mVCL8KaUHlK|&Ml48=%%Hos4!!QSbR{BiNtw(y^5@@!jzEtzFiU|Da-MKmKa7} z={UKlJGo+`?m|k`p$Kb3BZcB9=mz@Gr1>MEG#8_&O_6R3oKyJuw?YiESuEjy>=e#O z&R&MqHw=3|U|*eV9{QnP2uhsf-)7uM%?k!%)~HZeBcA?-pCDibMlmcgr%57oA$*Z) z59&2#G;@<(HZD0Om(f4%;ee?>cYa~$*0oK?ZYuzU%Yp!eWi6z{FQ8OZ&UK?$>i8vy zQ>-XOoUR~oG&}R;yFT!OJHu<4V}Bb4Pq%Fme>_mpsdgaU1a^##>3eQN7uW)A5k8m8 zT?M3AUN?ZUkMo6G!$+GWI#HGh^tOaaPIBX6>=w?lxQdFUdbLozeyfFi=hvs)!YzLL=6AJ~HkvEkfNvge7_cK# zOolHZ2LZRgKaU~B+j#eDsX-Bk$Zv29DE{gBY9@c~_4n4ad3C{(I13g)+Z%R6uTTmY z(mW=D!PkkqUL7Tvpsn)(5h42)9Slomayzb1pyQ4GD;XxFtu8S<5_*fJptY4Z>>uRZ zVG;n~Ef(q*Fg!OBB2ilg;vOh-d8SQa0fbLcwtTe#;Le7-G8~kN5?DliFIc=6!{h$g*$7DM$v!r1Pi9 zBJw2|I)JR<2n1x(l2=Ts_X%M}liZ;kLm0S&t*ZBFpoK2h#iwX|DSl=dS1g!qVNxE>&|2z>grXDtgjJV281`&Y z>Wf)oiAtzuX}+v)?g}g}W!xQ3awJ@Tt4y{Ir=>_#@~FMwfuvvhj=m)r^m0hav{&}6 z<1_5G=d|#PlL6o&5jQG14=?Qxnv}Xl=8bs|6&tR%Hz^AHr7ow0Am%5-R|;*oS0YBn z(-?`C)(;ffB7xLrqnw?{mE1L)tG2-$r2d@Q7k8}j-8g;SDmm_wfMkq`F=Z{E9c5B_ z;2r{_qz-q{!t!E_XvPwP7vQvVFrkfC_#9jyF*ajBCOe``OUJ`4 zV*7;>fvnSRa00((fgwLrN5y%9Il5%_#8!p^r82mt`A}V~nNphLu9$U!%gdH0_>lDv za??s{0Z?jYYFA$!t7Z=dGo6;do)EmcVARdRw)2`K{sDYf9{KQp(*(YD8+A4PH_5O1Z-wq4LX;N>C5X3%AwV-r2@Hn#PsRl1 zQ5OarBSKJSTa|AYy$+WISM%8Z(N1pq!?%29BW|EmTJK}b^!*&aho90crF?q{A9)_I zUt2g4<+DWA>EOlWL{2Psx|aI$-qURazwgF$qeEqlUFr9i2;Hd@(bi0}2- zFMfb*DYW4TI70+@k`aVfBHBUA1n8LN7)o2D9k@87lMMtw1jH<0fh%y8h zS?aG1rbjn8O=WT(X2LElxPIdfmhX4WB=pVe@52heeP4C(&DvE?rKQV1{ZA?U@4bF& z|Jd?BZvp}zaeE$oV;@l%L1aYDRD|WFmshD&jU*{u1tSCe`yU%g=7&`@kg5fu13!?l zxuan5??n-v%P%D+@J?PKHL$+FIoDHt`98nQou|Sp^PiA0``;c(iW}K3_N<{}r!$UMk!MrG4`-R9&Sq-V7n6&Bt4%-$ZZtQEsvaXl;H9 zF?h#?OJ2m2i;1V%bVj!nzs_d<1iec)>Zj=PuVh2LmzjC7&`Bjb0UK>0d$#~JwXxPC3J~t7&`cj7R(D< zsR*F5Xo(1;q;~_$I78l8 z7M2p%WmZL3OKhHVC%C^RsVk)~u3X!1y*Bw$NX&Imk>N9QL{5eZcdU3Os-`RR zRk%cpWI8Z&;^PN|#?QsW6lAgXHX&l-+erXs!c+oE4g_SCnyfhudWqp3f+2A!K`}!G z6_)E=9kQw^M=uTE>5^-S*vgBc9T~^rVagDLpxJn_u^ln25aF5B>vV3ARx!7=x?@xm?@-T-FW)kbGIoNhHBlqgk z3Yx{^Cg_W=HzXT zKCt|vKj+8JW6SV|tFMvOV5bJ#%uK zj<=`klOYHV*cYb`YU|dzNLD`FGgzr|a#BK&@2mx|k>4f_P|#La@(t<+laq`7xK{H| z5r-{I{ccKVmh~-)v#*g}+?lcU8;yW;6G>i-=> z73Kn3ep6`h^- z8zNt}PzH?V(60o<{6q=aL%6DoLzUsM0b1sjdeCYyhV6S5&yLFe)7VsTyDwtd^aTUf z3{slsq9Iyr0PP)dk6ixw)5_T?rMM0d2w50`W_(XAvo|BN?N3tki&h%mti*z}nhv1- zul6??jnv{Y)KjmERVs{!?N)KQpB_E4BAMgoea>)L8> zRHiY*uYYiS)cbO0m)gJh`vdR!foBW;uLPGtOXQg@_gjs&q!MzohoW^yJ>AqJ(}1Ut`>zZnl`9g!y4{N zVdNh8{;=KidB5}K^U;DJqFeSqBEdLWh)4={ygpqL3h-L2Ir0rt*NZk4j6TfBpifmy zCs)YO%1DHMJ@Bsts+442NZ9w3aR(7$Ek_74yqpr)Z52+|L@LteS%=w(DyyIrC<8Lm z!gS|}*!pa8Yk3`g!KIM1Q1Zk=XiG79CboRivD>z)EZMbWgu#d3d*{VQvhiox<2F6r zt`+7Ty|1!oQd}f4%IJ1124|%1kVlCb)mNz{@(U@7Lbk#U+(8?3=lt zd!+cibKX@>;6u=n4XH~b974$_>~4Xv+Q@w>nVC|57$dMJEQs0^XkjD8n5@js$2q&B zke%^66yxlVw9SOqr*~f4{2zep!ob%qFT;x;Mhe9VfLeu)-5)Od)TT`F{Ugd#nBdJL zfg>utn2u?DA(AP?{9oWZ!!XGgbk942nE2G$EU_8eVI|3v)o!+%(Rc>WjByjBB2+5 z_q`$U*}G_gSFTUI+fCzBw9Gc=?BOug^DlR|qdgwsdWGO)7&AkIn*J00jJSlWuY&VP zjQt&XS(#IX^14_pqXG!LK;qC^+&9&1LWcDP+Fy*il%~_2Zt9O@SqjL7t`U{J9|6M%3S}&Ij{{!bkn{jHMX-@;WV_@>^xO`Kasz( zVz~4Zzr>(STYIzRn0bYT^w_?etZb%GQfw?G%oQ3~UxH_IfsRwCrL~wJ6&O~9 z#jr$x3>L3r@?$|UmD5I_y0CsMp!=AS)xK)~;3zJA zTTz~W3iuf|l*$&f&~{mYm#QWumY?{#tY^IsmhG3pLC<)CfNwid!)M^Njo)c^|1scD zGB9O))SogiCHWRgcmMc|bXmxuvqO_(AA#~7u z19h9y0$|{fX+G--0rsEzy3cG4D?9qh!C=&gk+Yd@Rz(K$hA8l%vetjVXg)*{<`p-O zs=M1Wup;O}vjQ_)b`-zg;$X_VX^osyT>H5ZCAj1Ge*!VZ9{BBSaqSoms?m@{Zr#%#@)lPa1XY6kFP%pD9IXroiR;Z<2OT(d67YwKEt z36gtjzNn1*P3iT~!-g9wRcwDNtU9YV;tvHs9`KNE{)%>-hOmwz}EY${Ev5 zkT5^8_efbgv))taiz~sNXeHckQMnkUj2(R5gHC0(>*Yq|^idiN6#MMCR)))~QanxN zp0m<)Sz&H_I}x85l4bv^*_F~bni-)Mr(3L>Ny$ZY13N<;Wi*rv2XjcQ2W zP{v+UN@n-q8dt`S8IXrX1@k#UZpNUR$wk1Qe~>hBY}rsu0G&+C*e< ziUI{GFF&d>p>>J2VhiWWJO7W`2BPE3DL6IapTO&@L8Gpj6ab)-McaO)1OVRQX@FnK zX&%cj4-|Zf4WASddXFKBHj6V7<#=IsO9I!*y1zfKjbO6tU6&fHqjNY2-0f|quQXNC z+8n>FP+0l%|I-f7Wa~OEEbY_AMI?41PN11A-4HdI?h9-&`5{X6* z3fu7@dfi9G)X0X@B+jzF>*%_6N41uybmpmO4Trf@BfzjGfm%A}5Gl)SOY13_7xrxt+qSgTX+E^%RGJ z8#RbMRgRlU?HJLIH4azaLse*mnpE$WticzC6Lzj5H+c8WrZ6fk&a>&Yqg=2d__82% zu^=$^c8Z#^LO&S1CjUcdGBxr{Nd;m!!zu+Nh!{OXp-|e zQfHA>?JF(ZN5u}U3PmG6KI&W~TYZbX9B(tyi~csERdC=ItdgTrXH>+%@y8V<8Frq- zVoGzv4seEM0eJS&^W-RIl$apYRA)PbUrQF2OJ|iHpirBuv@%+$AW?u|czjH&_%-v$ zqgFV7t6yv_^QlgqJmmeAgVmI{GPtNmM+OiUgM1)cD1NG&!jjU@Ro z@dDjv^+}YShJ-IJn_P_8b5H`Ro6Ma@+ov6KW(GUy{jP}DY_BzON*p_yyMsynMYb%F z*s7gP_@Gcp*vYC&G&@GQqCQlj;c##_(>j0gWUUw_Rl!fwkag8v~{7UXDFh(pzxQdV#!fZO!ziR!Is^a9WBYdG(f(cuk#$YdJc0Cs)tgW zQj=?nfx(oMzC6F1&NY2_>`{$1GZ5;gb^7ijVRLIqoKj&gZmlcJ*91>4EwWWThVv-> z(s6|Ki!?baErWRbD?6AAe{8vIv?w$)0IT#^kv!>1GpQ!!-Zt$Pfq#+Sjbn(un9GAu zL7teb6g-|V02;<_GZcq)O3j(jR0(v6?bM3?c5__Nk`xA!=B1WTR$}Jv}88lAV|hh8YKhr8v;&k6#T7X?}%V8j>(yifPA06>ID zl8_Mh)79X>#WdNf4xL$782r!Qj|{u}xgnMsNL$YdgDmCSiUV;?q3CfF-;g9MSu90) zbUV^s?Y;u2YW$7S3Q5dm_#@{tMvT@01K_nd-|)82uT*WC}*P1ri2xGb~)8 zmr8|_dY8XJrhk5(?Lq{pxe-yLCFDD$`uT( zcly>=u?GD%Xhq@5m33%>zpKuDlT!%?0PWF3v!bY{c5s)o$@vf5jq`F!ca>8HkK1p# z!$7$uY;|e8dXl-jre8@9`W&AtmcTVPvf0r+F@%N+%`XFoC;27ZDQC*q8DClCEr0_6 z0J9B}8eSQ%Bgvv*h{CAKt!af_qjIBB1yWhBc9@{JViq>|LxOJ98Qv3d|A7UGTa|^+ zPB=|5Gix_XW?*6KOT2B@+ zpGPJ*v6}i>u82SVW_hnjgoxRypizY-152v!p68|OimL@t$Mu~OW3 z0|07_Nyj9UWcFmx_IknlEeprO9gt&POfa@SKNK43JCZ_eh=fJn6=9(gsY*z~+9EjQ z@RvgIaLfjRbR?w~JgQ9HD3sRpbTv~GAc#I7I(mo>RVAja!@j&E%}V(_QmX0wEp?vH zbQ)>Jrvy*ld`>Lw357+ESGo4oifK{#DU=Yw z8YW*V#6f9*K%-;;4E^?U@C=BRL4a-ITPgq@uR-5w15t;>;<1jeB|Sqc!Bl~99Xr?p zO$Cyz2;FFcbbhjOKx?qfB|DQu%0_5@kFV^8uvH0cYI@}2msqo*KdkROqg;)Pe`ueU+{N@I`ao@lK%wY9~LfGWo?^DG}p^tEo+@)NzLN`xw4&V9>M?1$^F zL`CqFwk%wY?uf6;mZX0Bs8f71ojS?5hMw+@KnLIB(7S8-8kjWu1C(~?oroQr>6AdgydbLr*Z`SB%6 z(*mBHyy+1g;$palEtE5LV+k2%?68rl`VS`E+AAS+7wdyaLC%1_iy{>^%`06<60#t!BtzaVXXu@M3;V1xV@2g4u%^lzP% zoDHS5M^)dAauaEybolX-{HOe<*2Q$0lEJ+)F!4i_{hMgQZLCP248%+kz(q+ zOm(i3tA$`(g$WyZc=e)>$>3r5HeB^=we`HfRiVv|Zx7`E`j0FAz|#VknAE=v2yM76 zT?_8|UoYc2z89a5Km%wecYUMKn*(>$)+%=} z`z(K81F0-MxO}2qC13Jd-;>i~r#nRT2q8rKGlSzm%Vann74}DwK>*Nyaz!~o0k9#e z)TGN;%;zdrY*uX5A4gh9v@;o881FdCmc~E$uflv-&k9mn5|=*78?HXI!~D;l!Ae>w zx6;^STTtttLN&d}}4wTQ`R9cV}h5Gs(W`hy8T zNtrOL#B}XLhP7h#Da8Ep+AuZLlQ1iETC1qdD> zFyG|e_ubm6-R(a!{Z!45slLzY?tAY!N3)=nw^w~_<7C~$Vx@<_Ts<+P#rMbah`8bu zIRF5OMD8)T6+9+xhiN$&kA{sMp#*qMh4pdq@aR6vf`1m9x$OLGJVP1UQo6GCp6=2qX@NNl``*W1vf~lTeD$S%At%E)WF;7s6##%Y0NUlsYT;GzxBtz(T3pbR6bOOI)!fvrGJ>%2?6H`_`c)Sc3Uc@9lQN3L zyCFj&%web9@f2QSN%n%XCT1?rH}^p=r$N_O4jm}!&{p1ZUQzNM&$jhCjFFbV(qy`o zrG?>PmuBecM_{B-kry!7k;UOBp%l?%l990i9g@=G6i~G4-HhoI&?E4O2sm;WA;c`Y z@$8llO2=*_rmM)5oDADmVIe@X0jI)MZvej}gsWVfG-ol|{jQV{mN8NTmi9dYa2lhY z#t@ikTqC8j&7sTs=}#dyR4%ua2|syYoq;oZ5BT;7^JKYVsSycl-6 zE^Myp@GH}odzz3X2^s=Bo^>A^E!3Dg+2*$SOS2ZGN%30|BKP0GGKw;2+TYIGqAC08 zbOm%~?U!mh9Z%gVHNK&6bY}ZdXq(@DI~HK{5$N@q3%va)0LF;_jAxKZ-$_;w*?*^R z`wGnMy>E?QN?ifavp@DEut`FPf4G8ATzDj*5pt#I?3=F22P07e>d{4z@DP2l^X%3r z;@=H4Vf@605CF*#Z4j~2@)(em1cNA;;>^Ls+6jmUtq1_tk>oJBg``FZ)MewDA7zSkoRd7rrIYkvm3k}AwEyd##4uUsne#v9 z^Aq!K`SED%{*&YX4Ak%Y5*$Nh#_+{CZ~k0dG&Y`o(4Z5WCNOaUKVM#w1G!{J;t9ec zwb9M4qEy7#Ri%ZGOm+_O+2?7S*#MDsC&pP7~; z!#Pw{X*RQ|hH|7)WpjNm=UNK;Q1`1mP0D_OP6#ePQn9U~K6}3L0w9C|$22VDa^wJE z5lkF2a9D)eCQ?i;2jdE=>kwB*wsd+NP>LS!K1NJYo@Uq&e$MsRLr*H{@h{rX%wz9q zsBhbD_;!Citp`#i6SHFbawEq%a&>>t($n*vm&akT%w<2n{WxFPkY(LtVCd4m>th&M z?R8z|*S#sv_SDon%^`TRh4^!s_663d(`z#~V3(iEW`$9b4m%IiK^I0#w`1p$EIqWJxJkOE;H%=OegH!H~4;CW*ked2^}k zn)!9b{pF-td&a7+K=zC(#c+$xM7AqqCFPQ zIjBsHQj!x>76X-PCgICZZ6}u<;vWZfedn&q&ikk5cH>=j)iJkkV75%t{^u3=3MZnN zsqKZK%BV@`y($2Ey)W9Gyj6Qt{ilzquCilFAA@!0Lo+VU`^@86;clgX#o3SfDF57} z!1cY+p9r;|c*}#e+hv~ngQzD<=xR%9(T*1u^wtn*C zON~EdsEQKuq2g=VvXG~N;XSnvTX);Sv~nQrzK=JKadVkFjG zXo!fja3O{m{no$=p%=f0Ijv>&U!@4mQVv3H47yV+caOf;_6?0TE;-kMjVGNoHeLxk zEORG*GnI*>yJneuO-s(H-m`|UV<$art92fv&-r`8^DNF;XRgiO6`&h2wsoc(6ocvf zaTFJm8Q<+NTvmE2+iHcO1CzVMrznY}`(kLlWljp#ttf9OAU~!$KpcRMj10+<4M10C zr~i^}Yf8QufqI}$4(Nv@hd}sY4KWg71&vj*Jd0kz-Yq``^Ls#to!*)-*)A4VJgUU} z=~$z@t@9jhK~H_UKsM*T@@!&DQG7ZWXn?e;UHm*|ADO$&9zm0@{RevOL9;JQ1@*>If zC%(|m!A-2xOD24xwqI3PD7GnNDQ-S|+&i>!q4^hb(Vv(Aa8OZOf#9mX-%r7!S!Dq3 zRi4#*R4@W&g8g$#FksEdBa%c1xo7Vt;4nA-{T{mEx=HXgXD6j+BCG!<;Hzpy@0~*R z#?qU2?RIn!UyO=yg{W!sPu;0Ve4n26m!M34P0mnVlwMz~pc|8*%hi~}BCzu=5$(?~ zOs~l8n%}!{11kpNa{)KEYPU@ZLI3vAkL5#d`mWW=Ij{f|c>F0`X}Cf9#49ZxiYJwd zJUF2R3r=7F035F5-1H=jFfMS+@JXzy3^}L^59J-|=VDk!g@JUhbc{&}|HFArjOb~cystaCviQr5HjCVH z6EvdzNQ^)<4Zks{;m=$Y&ppax|GBYJ)zAb(Uzq8GT_4Ovq!9bWXgIO@ z#tpq9g5hsb97Vyz>3(MF8MQ8zAdOm4Z}}0^nWb;F)~`not@D`^m)C`>-Heq-6$nm| z*3iGtxpm_T!ZkUk=pN??Jv+_`5b!y+s3+qR6c^bOQLxo!Eyixg19~@uX8`W8nt!u28M6EY^h3jO9F8n>{n8eg_?* zm9Agsv*|-C7RqPyyp1)7BW@(F_*bg0pCs?wvHB`jcvpqfmLCZfHr4ty1Yi48_Gh14 zYi(xOoC+N}$;_QPIX8j0B_4&(6|xO3D#o)h{+b@0T5oTjN(ZaNCT<)gZw`6yhEA|Q zfU4q1EU2)yQqo^L7o=Wlq3L3|djN9m`W`!Tc|3R^!V0MZkC<3wmx?dSw3x*4xSCNQ zll?`|83??*e{-RytrEM8TliDH%3Cle+YL=+`=mBnVRlD#Fn+U4wF`Bi^dy`fl7`Gh zgf@c@F+-q`$b<E6D?q+HmYxM7G2;;$kFH%cC6AuXaliIM#~Z$_cBs{snbmH6qPp?N zS*)>Zk25|cG2?x-P~LB}pKq1(XG&QUDCp&x63IY=7N?iqAj5NwfXJg_hbQN}h7bMC zJ1tVkwNi>CQl~6q>pFgaegGgU_l3(N?%C^{4onenKX*)@y7{Z1vOi;}cJtu_dM_xu zm_lN0ncAU;!bkj7?rAw@HXBDlKzg!w*TQSRSg?VhUC>T|>0t4b*K; zIyY95l8ay97|Z(UU^%?=SnqjSlAKIzfou(Lyd{fBq8$~7g%$s~p&TXIZGGTQDtS(N zlbX7~WWhK|dN7oAS-y?3EE88c-#2q(W9`~!tuNVK~DmyC$BPt}|Pkff$;!%*c?&U|As!Ma^gm-H6cCQ6%@w9D|^^`N?o zNAq*7a(cV0;>mwccV4)yAlJ~aB%n)c4o2^0zAB5o*VCgKkz3s;hv7#9Vi#RC<;bEI z6D30mLOQ1Q$6_!QHkC7CbsSqCMmYO}rY$j@prRRD&0aF=3Qb`~#7*DF{xSHSVUxY} z2K_X7?;~tny1J6&Ss$N#+WvMdjzfqjol6KuBdESLg%2zZ-B;ZpsTH|<5@8AM-ZEqD zou^rC`MhV-6Vo6}?uVEEC4Ngt0&ULN-nQ}VlX|y7F~SOd&V~~~#8C?$^f0pPbAt7)X=lnu^|Fjvapa|_I;>wl{iJ5*=bIDWiJl-K z*ZXiiG1?6beQh`mle&`C@pfp72)nE`3ygMxApb(RX)nKXj!{C*tr&j5SzMzDCBTyI zc{aK$_tN8ym;0tPYTq5uY3R@GIn2t)| z;FQ?VC2+ytW;;9vXQ=0w@Rw`T(lW@RAmpdEna1bNPINtt%cq^DdKe-xy04G6XYR@) z`NP$_qZJTBcFngw`^RNwKoivU+wlgg;URre`AI}C&B%Any`t25_De)RXxT~aT?}OY z-dzww<_SR%50w}fP#`uQ1PUlHSpEO3(*HjS_W!?M>(;JQCJv=>2nZGv;}&vDR~;!K zldyQlWk|Jgynpmew@a(w(96>rssH#LB26zt15Pnds(hWQ;UzWpT2moB%UqHtkPfg- z_f${ti`@3;z*T5in`{ZEi!i-h9Z|BFc4(f9`Znyg-qAkiHd&sB;9qdzxP|gjgg|%0 zTQ_7ItI0xNlA)-sn4CJwpoFug5Zi?wP{71bk>8G>l_J4=?esw~`a z8lTrII>G0Gn}zVj6FA-n@p3LIf`X;!9?4ETW+P~SV%r&YeW?hZNJK;di!$^eyA#gX)L;g2h!4VFWjR@;xF;*;39^5yra%#$W&4 zyQ}77+KC0din2dw#Y3a_^#NbjHeahi`k-~9(PrhF&o8UbCTbsizuzw3tQYIo4Lc?F zxM)9JYAP7&PA6Cx^ig5q!k@h_fbS{Hzm67*TWHHETk+y^r1wV+pZ9(IYclsF#58tv zbiUU2X(u$q`Ctj#EUAR5NiObGCmi^SX{JNG%d6 z<=~fH%#YE_M2P+Mf1jv>e!~XYt6a+lM}6$3|L{<&;^7nS6~w|AhWR(pZKxp z!LO_sQT%|KF+?B2Fshe_mZW}ATH#h-3DnWiN@mhyJ!XqW$o}rwonmUK zhFH^iKO-``O{cHQ{%6_n!dyRlA^N_pitVbnywpW4LbuvD8(W916Lr!vZk4-nMv%7(O_OmhC`WDgW z&Afuyx0YcJIHs$r?YYpRgS)AVeEgcn7EGjtZO*W6rJQGee(+!d0{%agdsYM2SmUhp z0>EcE3u{99dUilnD3w`PJ^(_#*x{Mf74ZG48*|OysP^UpP6g(L!u^Wp<*ZEHH+6N_ zb%T_(6~^1_M99b3WFLHn0~=5LcjP>4GY7f;y!>DB>ipP~ySbZHO?eKuHweMT5V{!t zElmN7@M==S#=V2nj8suW`s7b;L8|_m@vv+rf1oiz)N~=H(douG|0h-b-3TsRIiZF3 z0Wa`59CZ3z^d=ZU_hGt2dA;AW`5N^9hQ>Dg_^b%02D{|^vbwBAe@z+$at*vm>flM9 zk_R~khqj@7gCC-R^`!4rw$~kr8>W6)L{w64${animzw-El)n0@6&jB2c?WO;Dm5yk zT|Am2T1M+2^!EWV_swUIyN$N% zJi1a|QUk!?*W#X-DfsN&M^Do~@Q?uLQ158?0yQ$#5JE-GWm6HG1nO=J)>lWEOqAGu z*dUiMQtTO=H28az?5KQ=&!B%~IGjVjBKVG091XE6LI7$!MlnZ-r8z} z+U?<$T7(iZ+o>_+p;2r7tCe_c;AH=X}3yRL)}^Vb7boK^ke^2 z*DG$W%*zsA&Coo(oKPD~RrCu(2baA;XKE`_{QTbD@#*5h>OZ*vl!G(`7`gx~h_C1J zr|9s9S@y6#J391HgyT%7Sk-^2;4tx>Nl*?xlBAA5TfdOezL!tu0XL7XoVPLtu=+;q zxH?xNKw~^uj;x(TpUaJJFh21JSPy9LwPr8e7!Iu-{&`8d6)^+e81~oYpZcz~=M1!6 zZKR2Lty-@*N$+tvelhRZ>KG8si+&9l&4osG5R75vW5(x6=)3fK$s}enBbTuSeYr-*^wFp77&t5iHC_fW5#}%1k_>(YsP&e*V?!34W z44ZY5r*b$Ai}HGRhDZueLDd74^4*w;jk#{1M4~&riOHJIePy{S9#TjlLJ-4|R!UZ3 zueTUd)+D^n{H<@4R?(3YOS$%T`SI?=M8+mI&s5M_NWy;X7FqB~5+v znns}u`E=?_LyZ~Imzw!lRX@c4h1@U?80CJstiFTuayHb6E?`L#dQK{}7cjx=qs(@I zFBy=7=ae;Z!s0A~qDZ)6EkzK2u~z1uoxV%!R)e$I%WyH{k;Zc|u{*t4Q}*pn$f2*Z z%6r$Fd|fEx%B;|+t7qNmf5^w`{oeaFxBkz%=s)9^SfbP|S%JV?LTijj?GS4kTJHy(xzPi#Aw46wCApcPj&Kl(991rTPZ_<>sm zNlRKG69S|qG~uDw%EX3<%TRkEUS1?c%cY;FS1tvo5cYKw zkqcNoonY25#$Y^=|0eHxoWSbg;Xkw)zbxvqjTf@Z=Wb#Usjs6Ba$x~pKePD^%-+BC zI=Be#p5B0-_bx%teE$Fbgf`#DHvOI0_xMUp1Kpniw&O9@peq9vT14tW0Gu2lZWu(h z^4DaDV2p*M5CF1-1uga@2QS4C`7T{RcCaXRtud8&Jo!OEA*7}h?yi8IddkYG;=zNX z#q{EcRa_zUDbLgrFCT!DE=5J({VeLp$#+3r-W^IaIyAC&&ASOM`9qc75ULQE7bTJ8O! z<*!AP%66-rJfA{Y+`^P|WtF1d`;=P0W%pbJBl~stvJ4fm<;^K`?%TDw{L z8w5IeSa<)|p-JhV20+-3&<_N=J^+uV_GgX(T4pvj?-9WWEQt)Q;DXmcgc4W*u=&5g zd*2?rVX;fE1yp})Am^nXc3b+Flm#H7I$;qfPVEiaD-LsNx*>-%e@6E}+Ol~f)r=}p z=K6Smeno^N@2h{?jCy6i`80KMecJs<E_MG~`C$%q>5Poku{ zpEC+lwIt$iXp_&m8PlCS^Bzc<8aGyCJ1I+JXyf*|-*0X9n|sNBU2!Dsqpf)^`whfp z2=v&`wKl{gy~^NN*FHN(5TALupGQ2_!12ze@hDN#EM^F!?fW=gza|iYK(&JiBLDzI z5iHMlNR!SK0iyFV{IPH<9Hug4Q9Yd^pTO@UmOD%8>k@$#5x~auOVyN>7svDG>bI-t zn?n-0s+t+i+ybx_%7@jTwq0oXd{Yu=TGVW4gv=fsbo`ia*haX6J2yNuI%t}B7xL&D)i-cep$x0ft}l{uMVfPR#*cZat}=)pBllX zN7#QL*RSsfpaFR3Y$J1}f?>kgjKvQ}WdxQ2kM-~<8dJQF&HNK#%-s}8^x72#ECqRm%IHwbOK#t+NkUeVyWiLF}ZIkgTs-NI7#&9`z{>mPli|0j#ZB-&w(Hped8%d!-C09 zMmPR^RtD^f)+jFSJK#tdkK{cCfxi92qM8Z<^&BKB`pOUh$r2VHhC4eLA~*@(j)Q&L z77sCOOlwpaLxWL56$-s}utX*@X*R%`k9YTvB2VSSmR3fu6T0mFIDt@cXj*M^$TtgG zbD*<~P7bsf_BGY@5o_cDX~@>!7H||3-peh)Wm)y3B^EaS51&2paG0Bp+T6E-&BO)c88Kv~% zdn^vdXRtWtD}70CR)Qkz_&NuN1;Y1m)JDe6Ol?gV-j`?H0runuURzmb^Dr3vmszOnj?Qd~#)> z@1K7halvT`ROl_B3uMDm!i&R?g|lU+9w);CmPa8FA<-bbp-ZNq5BwlZy)j!zrI0xc z@XU9-38g&WP+Q!k7UUI@`D8rD6jMFB7PK4Ys4h!)VlYw%!Rq-x5A#n1(-AxmL++Y$ zMC_X*1)+&#o=%jQS!r(Dkc|5mIq<9t&gq`v& zFnDk$v&o>5Ou5bIX*AMKcw8xXq6vfJdCBcx*i%!qPDs7@_Q8b9cUxd{8uWTY#-H>K z`qObsw&yXj?zned19AwaoVOqXlp4nHmTJ(aDWpb=mmxv{mcrD(JWH5CRN=kwEHVH% zhiFqP*pX!MOB+PKm-l2qs@CDlLd2hCHqeD6icZ%SpsZi%-1s5ouHpNfS{2rG=zD+)D zw-vXR3c|W=eXU7*l3}DmGoyvs^Ly3vg!R5~!2kqs ziUJZ5jPK&GR@inTqsi1TERu`jMFx?2-WczRR@Ge_+75#1NywJ3 zCx7qhQWdwl1bxG{AXR##UnFHdr_K(zT=q@=xVXFgv^jI@cK#S`g1w$CaTSoAaYC&B zVI^#Gx?1Xm>z8a4&0~>R9yW%pyh;DaenLE^f(jU#mgN2;5zBcsg%jP6X4-}1x~JAa z01t$i2`8>c3?0j&QDzLkBW)A_COX;(HV6iOalgow8E3556!v_(PBHNUB&z750W`Hx$33}SJF2s2>a`_w7Ev_pL803$Zw6-@T z;6;MLmW&lZfy6e_23l9D3N#?&VQwKOkixrB_ZlY!30T{J$eA9CG>Aue$K0h7aQtq*AsVtJP=BZtPW(J{tN^EB86r6aEW1NI47u zOnijFHP~|6b%L;9h8ch#&~EV#-dOLE9YA2&RyP{cRLJto%*0#lAEjC`8^X52x%9o1 z4sgl|8}K1#A}FxYlv{RZ0tiD(*q!|Qj{0}{p<~h=U2~l@9J6C;cEZURUW{0sv9=?9yC&mts|M0&n4u~p15n*0yd z|F2J7-Uw4Fc1S5Z@p|QI{75(m2!O&0i=Uw$azBDS%Mt{FbTSDw6q@P;Z$nBiok}mZ zI7ZmZZ?a|__)&{K^>S7ONv1?1Zgpi}R^@k=p{G-R@gdIjeY?(tU7M7x6N|U%KMnn2 zoVdIiV66)9SToUGexj*_)}Y8pUgC`b6hwt&(!)0cAvksDi&qmO;Y2DLGf{JAc`6cF zVpfIBKL6|pv&Iu_cU#=sl}6{kIuxzhwVnQn!f!J-Zlgcmc7n=u-HP@FjaEC?e576C zMcmfKIn#ETM=Ip4%VkF3DBW=RMlQJ~l#Yq@`)uLr+0MIcmm%C_mZ5V;T?tmb{gl>| z&cSA>#c8A?_mK^(wcI2w1HT}dv0!xVs-E464Z}{y_A+Y^7U$trOMcrrZQ*0AHb1+3 z(U{{%^eAHv2ciPR>1*PoZE`MN%Depz3e+q^meCF0)2M7DWRtP7wTh?C15t(TXh6~X zs)@xz*&|5DZ9wd5y~Dq+Tc3$O^o;mtrfZvRWJKsV3L$=I1zXxf@FMz*S9Ev0$YGL< zZoAOof#Nz9H7QmLY%(ImnD2qCd39AdRZXK-K{no(pTuDq|3Nv=d0GGr6}aBTK>UL( z#DR?nk_x*b3S946oM?|`I!lA!pa{L*j@#!kl;TRz`eJ`x8HplDps98yFT}V^4v{eI z5p7MR_j@I@9&)0#BoYU1U^`++7XNM!V_VurS^ZmCu8|ad^h`%dg0VYRbg5-;NL#K5 zWI4m(@EHtrWo>y#2+&QwvU$*4!}~`ea&WoQ2@bkWa(^R(u>~WCQ_$;2+zq&u!$KRh zf~9b=RGU+i5)&ozNgWciYq@-2)-AcX6q0b*0tMpl*F`Jrdx;WBE?VeOjk0K`s}ghN zRKz8j@MA>+*^n{PalbojE=`5X*rc+u9(>X~BqkUukI)2h5f(l}>k`@_*-Slv|Ard?ty z0UpqPzvJxVaSOA_9({59BieJVlISya!Bnj3q6#p`EUK$?Wz@b&XR1A@YC7=UQCb7^ z5&N!)pbLOrgerfm@<0n4&($!kW;*v9TPQWJm7}oeigWw5Z6zI|O+cr|2eXM)mVy!6 znnvqJ2q{y;fG)X7cV3d0QeoY?MYCQpL0%@$93qhIjd@ZEc)x7IDX8o`QPo!yZ2=FgACFMtdSP*W!3HgfDRUE;DW_5dSjwR4hzM$Sb?ejNp1j}aZ^&>w9xp6NbahjLQ9G7 zEvVpy>M5d`dN%9}ciD&o%p!+1XzcX;V z3rg6}vMY#V^o4=@(0vpr@$I=EGRW^bIgh_RcWl^N2_L`PTmzl0*}_tBm!+mCMlxkA zHw=W^B(EmU7baIayWDRGWeeB+I>QqYI2^JZw=le(e zw$wc68dUS^tv%f_r4ft2#Ne^U6cR-w4_|g7fbWCi;67h>tC3|_Nt3#a2%%x1r1gAsG%PQhom!OT3KXh4prpzvTAEy9y^6-7gKC1 zjINkl!`pS{=J>1?=w1Y8+*Mi&YnV2j@~P$BoZV&1CjH2^=d7Hy)$}jL$*GaS#{`HP zyeYs4MleUA1;vB_B`X?*m>fr)i;yKegGe+G^LVuxFczyAOroU~fOz(p(z$EUu-zS~ zT>~V%$8462mqPPFQ-~TM6qkAps$IK7s!csq{)#T2<&J|CKasp#%Ge5zI;yl)oOG$9 zvZbAfi4!{b!s$#=*VZzdMUY9)7oWee$t2{2)e*^4BZr6@-V!kXLeAo18bIA+xq6Ar z^+Ox%lP+xKjiphbR4+U`bW~q;5Q!^b9NbLH8Bj85XrRQbfiSWBP^^Ia_O($_+VW_Y zN{oTbfVu{_I_@0z`!6B0cbJA9xogD4ue;~fAt#4^;I#(!gO+*h`)<$k$<}J%2xv$F zrc#b#^p}hrp)Ow^$aM%U3oLV+y7Cs+6TVtPo<iAP~)F6lbNOzQbSv7Y8X&5Tvd2` zkGb@@ZnvUIiiE|S*{Ezfal5b~sa@A)j$G;KY-q`W0-6*}&Tbdw;P^R!jvsObB29SlgOj!9MzAHhHgAF(;9;V3qpG9O-yPry&7s9*pn z6B5Lwq3;D~6tmwkj-lg=hig-$ ziE54rTitL$sd>x(LcvX*-AKkI%&5cotIT_S+j0G3wb}YfLMZaP5#Fo0wcb)84^yaV zwBgLehJXLCZk|#iKkEHF@^tzx9A0_AR)HJg+fv(+`;`gDXpE+Ub}~e>W8i3r;OLopuHIeP;~TvsEN6M zhVF^&F7O13I~nMknY8>oQznv3uYWQjDvR7v&=Or{AUi$y6C<8PeRbx2V;Xgl=QkfT zr*tr}v)x7h?UxMiwNxe*`lu4RXX`O0>NNF=XDY$pfq$o{|9iar@#sDc%K6{?J?HJu z_CS%%)y3{t0MssxGA<$te3-=nJ?kL5KD#NG0MF@Iiadg?wp2Wiqvi4y(h2Az?5d8J5mV;t*mW+CMWC&EFDnQ==Rp)PoSGIqe zQrOd)NafqQE!E@-J`P=e94p82t}2$NwrCgL``l6@k>@)f*gaxV0&e32>iU+W>FVDkXYv2le5lf(467zcTXAt_X}?!qWo>;MZSNIG@K z&D@xD_bFuyV=nGBcy@Uls^WAn2c=(nV-x!7)ie@F6U_b!;jLP~P2^GFnLkH(CL>j_ zB_rxl6H7)lS<5bx)7-7#<|fqi1W%_6e4D0BdYgLdWyeMW&_Kot{StY!ca}=-)s`sh ziFb$d$+s?mn5wj7>dF^#%IQoHzrxsXM9Juq-|DGdGLY^kC=G5Lt@w>2?^SPps136$TaJwAvA#3=DH({g9m$6@s$SS?3u{8lJUfnQUu%$YXPt!dr zeFLalIX7#_)1{{x3Z0bbb7w|D1SqchBaE7j1H1790(|SohXE%RPlnyocO>K7MJeku ziq?`8evE}CigYDjUTG9Y`9BYEeq~#ZX`86NW0L2iWci-nx!t$f34}}d?9{H1sKBAG zj*%Sw9d|L8O%oEx-*pZjuT-uMXNS0(KI~fLuFk4}LpSGW@Vx=_q3w3_HsCj7t4M|@0>nyIbzJg{-9kpX@evtyUQY;ULS6)pb?cFdghl0Ry zW|>!c?R;&X^_P>()P*8*s07}y1b+UrgCsI0Wm)}bTE)rBQ#|5o>Lqz`UW@+Y31fsj zNOhA6XI_tjbg8@9`ySl7#>C}3r>g~!Srw-X4n$55;D?J{7Rwsd1n2ks(`qx9>|)GWU8wrcwKl~a8rQHyz< zPGCcQr?J2Tp?BA7`jjV$bESZ)uXDS-h~96Aukd%#;*pBeF3)wfZItq%(db`SpQ4bY z>%&WJ31TyZvq#T=nKugO=H$F8J(9tQ7vGbA!=v9#F>S^enc{nO>YGmlt%E+4Msu5o z1e|k?d2_F>*0vopjVJ{Tp(yafU5T=X#3P2KQhp5nN4C}NI1m7RY^ZBxRSXb4QtYeB z2T(TW82|IO5zS)qAx#Ewtwh0~z(LU9kVlQyz^Tb_8>73zQQ=#ZruN zP9dzLx6Deb&~94Bta)Cz<#x)(?dBJx^bzsvS@mAAVooh<3W`b7btwFaP_%CPamx%r z+udypJ@jgo`UX5`qOG?AS$o{iV(P|!?3Uw4x8)h>59YqNVaP3=RIg00BTt*ZXO5QC zM57*UqDpXl+cEbJ)b*Za)zZpnX>hK9*ecjbug;T^->g4KcX1b_wNXo= z)dn;Q($PmjlkAU+uIYkZpVwbZ1Y+Jtx@@&FsO9VvdKle>j8f%@V!qRt2LsA0UM(iG zjBtWyp>Ve(mDiMbN@U;(QYuc2h80swfD|KkG=ESDGf+!v(C}qptt$s*DD^&*;Nrmt zB{7}}cfLuEI+5N-&c1{0ND^MuYy-UrIq5ev3 zc8Xca?u3VmulP^Bs&lUi{Z2PIXw&!8={CyR-tWDxhJPq`z#I-hAPUoQ2G_eZpupZX z>;UwTIG_ml=>WwUUdsYx(0{kJcPFdf)_t(G`G3c?HJBd3+?To3aJHyY4CZ5`3qdRV zh)O|aPBuN4WOt8TD~g}%OR(}3SvA@27^@5NH|yN2_R(4qWM&D)7Iv#qz;1x(iuY9i z-bAjfj{3;J40;F9xKk;&wzzLeLl)SPC=DmFBKw-~t8X)S84+g50@!8cEg`eX;Ivu1 z`HLMt?n$CVGXoE%A` zY$M*;Od?yiz^M#rZLZ~X&$MhcWd7z@BS4t)+S8=l`SebW((uu+O*S0_dh}#;l3;Tp zr^?()nUaCT4wGa?(GjYK4clOR3dSX+oxt~Oq{81ZO_{_qu%-KrP-Xf<3Xw9^i^Vy$vM%QN|77;bh{W=+yH}~Xk)<1l2$oW%%5zrZXDFo z=D*Vp14XlTP`)(M)iFOO+iMO9M=cJ>OI^YMq!!mp2xy=j0Idx6R=rA;-~UGCt}q+~ z(^i;A5xeWuFHuC<^~T**(QQwK%JN~(FPcmosW{R$G!U8#`J32v6qRTweL8(XtmE12#L>i?tRiSDDpM{hn(`;nKuCHQFYk?f!Q?(G1tkACQ&^BO%AMw zjtJj!AzBy=aUCgv`ZU5}mbOgu_oLwEa_a{mbcY(CpfZ{Q(GwCO3!|9q_(S@cCt7je z`c^hG-{~jKq-M$&A8eJG^oQBse9q+k{k= zQg-&rmzol9M&z785DzoyhDlhBCtqLIW(Uo zrBq*ndhRc_g?g@VH;vIcQr{}lZ8#~VHne9!70_&m`(>N&o&Wr>xbtYjh4l9+@2@2> z-NR$vg~RDvw>{{6Pc+DYyz<)n+r@RA-KWF94k+3HIP^4RQ%!jGYEE=`cmM?1K7>Y6 z@2JO@6b4-qz^NWBCfm%%^_OKo7l=~ zRNpsp?BLV;^?J&uvVd&fIoL>Q?)n0SWWAf_vTUnnJ_SlQhR#WBss2>RDIK3WEb|($ z{Tco#xGyfX{V{v?*KY2W{DzqrlG45c=IT^oK(N*34>FrIobKOTA`yIaI`30dw6*K> zOrm>kuNL2lEb38Yh&LX->1m1R;7lYXQhLa*XIN#vaW;WY#r_9F;CAZWbxA`$`r)3e zz@rzw|33e9k~T?JNd%|P`48nbV{!oqi_xor7UTfqYQ}-_K>!v@hzq!?4|tCU(^%O7 z>y^Y=zu${SI+OtaaR59Y ziK1QSOt|38D-I(Y;dPdA)9mR>tfE(lydx5-(YolXJU)((;EnMvDDc?@>`%ISyxc7D zL-e}6hyPdFwvloKOsKKIp!U%;pBDDxUiO%~~bR{JoG>+@vFvJ}?a5;}l?R&YA`-7IF84|y;o8#A2(jcdwJq@EM2kGmMq0&sEL z#yo97WkemBI#Lrd0;iI(^=mFdwASF_=-LD7K5tTZsOUCZ2l=}M`j$lkdZ}v!2KlG` z8^t`y%Mbl>kL|?W-5zx3e<6pE9SwjEwb^n2OMQX;k$r@}E8;i>8D@YtO4VXf3&mU(!{X8BJTF;Dqc2qe;H_i%Xjc*!&lz^)Ru|eA!4i1Ws!mAzQ=q; zfmiu|7<DM3Zh)%HcLz1a$1=C@ORc)I5^Q@} zl3h>R()+H2d4R^dg4w>na;$CtWTk$4 zDrlGk8-$i(hGYW!W5^P6g3}sgVkrQt5@#+BB@TCnsR5aur*{BLhlUK%LRIH^MYYb;$Vr`bq8MMJ5Y^2kM|t5RJ4G2JaEWCXNN#MHc9(_8XDa zG>SjB{5E;)_rewe$+@V|Jnc)!7Mi}Sd4>)8=-E-&ozZu1Tkf47XXjM$$tp&lYaLM~ z&PLQy)-;h#2X)M&kMVduXO<)iao(%nH-F8`%*d=My;8$)QIFfN-7~=nlV?(!A3w@Z zI4Sn9+7RwM<_Y}|Ewz33Jns(i`wvO|ol=zrCKBAIaEl-WLsLTbKte!&EC&*1rt?wm z4dWMD@)yG-Wc#5XaCj&ur^iJyfgE`^UWjuEn>0-$Pg)Bn7!k^vo*r4e5v!{W3mb0F zP4%ly54=EtKLj;W#sC5z=|9NH-H!Of4~H&)nDqe?P`bZ9F1)BfIA$M@4{+d^N*>l) z0IDSuEdD1X^WgSR?4L|wLm}~O^ZXYz8p+{W!~7Fzdv2VhH?TK3u?&taFNq#4W3bYQ zq@(~FiOH3mLtYze>t6#lQVJvNgtQrh{O#AV^H?{boyCc>O*znT8)XN=`|C>fytFqg z$v<~|%M2G+xyz)MJ5C?wlt@jEU&5mmaZPlPh~#zLI^+Rpii0TS!gPINpCvJO}gciWQ+Dc!ue}VU?XW2Oaip zTQ8O*Kcuyhl#vwXWnDNx^hGG6rSPNM-G=^7YpWXjRXC*iJ>@@I<~iVE+LZ=JgY)Fn zf0l(t=&fyib_f#M3TS;pFLjAb`mrdmXwtIg8__ghMkr+QT)xvD_%!c!%F=xnl7BvG zRwVfOjobD^Ez}a1SJohNCRN_W0y@)74zh5wwU5pr8MzC zB@A74Zbv{m{2uW=$`zl_=Rc)Pau3L+E_|z zn=ZVxQ7s~--9NdU&!#s3`j__lKT)t?fo{zO8~~#&$E31$TI4ninN}JQFk;9WsBPNyEss< zw--GYJxyD_6sGn))%|N0C8-EBb|Ix`Y2Atm%XYb*>9wLUu#W3mM^5c>jZ!;1;p=UsD>UW%O=*6bfw!SafI=ctgl^_KjHL%A&29{v1uY z=T#X#e2GV}RK^E3M(O^)3#7tZiO_@xq%*QIv&dnq0 z4THToAIj7AHMHHWtX#DW9vryvtR-m<22LR>LZ-!zKuo@yQ0p zL$EA6^R9kSx7+%&9-oF3Fz-Cw7^m|>Lpoux)1h{v$fo{JBiUbfdLUiqiT;UN`I3&U zye;Q#anH-(M}+1_fmiP+0QyXSiFq) zxEYr6Xz@aN~4ZOgaM(u&S2msQ_fsC_Lm+Lys3(-l^lk4;tQY3-9Py2luLnhSQ8 zjft<8?GXm1McT`lN-1iMBM=|WvGC;LnvSV&68cI9MLjqPrE8#HD!oD9gVrxG6lzd6 z1#YpwYj&S)b+o&I>0|Q@s~1j-+OoH$&Fj#y#|h92hEgd2@{NCir$I~lW!a*<8Wt2C zoJGh_ojzfpffRa=$Hu5gJO-VRiB)MyuS~r1mjg;mLv7~+#^zHHZknD!pwm-IYl|zE zEzB%ydDLL{^%y)Wy8mkUSe*Yl0up%0lI7tsq>xC~oc*fyFP*O;A%Dj=5j&Z<{+%8@ zi+#g?kXvwV0>B6weURJ^fQO9#`Zx%HAsKH~$?DV#7en8bf>}DtmeHCDS;5aHwdkAa z!v!!Uml^=D20Buea$qaG;e3=A2*I@>g^v+)IeG5RevJvGFH(6EdLIGM_pM4gtj=5A zyIs>azGB$JEmgifs=bZDx42c4XV8^i#xyF1<6oe#wV}ZK=I;-{k)b6C{tPi-zy}f| z+Qb||?n6-ja&E@A_ZS0a^i6W1aQG$g=diH$T(fRah{jZRV8$BNh)t!xy{4GyGLes4 zA|A8deKC)Bm(3IGd=fL9+WMJeufP)>R?E_1xV}XHdd^*BTV=Lv^f}W7iofeOzK__3 z_o$=e9an92(^ES8LkbeT!TP8>%8Yi7GJLz;Rr&De4NX@koVh zJV&$TQ|&A3{P-&SafGUPoLa9Umd6n;0irvuf~GQrNadbxF>>~|25H|SxxJc+<^_#} z{;Lg#;mOg}enF$pZzWee;`sjTX)pEZndqZoAR|%!zd#*}r21#cWk`UV%|}m0V_H<+ zy%jhAKggM>zXM?Uth7E@4q*5pm#bt1(3(;hd^jH<(&9i*9}3Nbp7>RJfd$K7&Z`Q6 z^-td=A?4@}oLe_GR~!tlr<;nMo8nS(P|m+ab|Y?1xZ;X`v2XkPG50M0=K&cU%Cq@& zv+ZZ}U&GLCJDo!KQ}L9uyzp&D590Jp6J@k!D=F-P73f8<7OO<`HaSl<6_MEEV3y(3 z6-ngt#m%0;gqHG#Nw=MgTb&IFvulX#t}JoTWYUd&pVCBAEP{Y14+FFdSyWC)hjUjz zz&(bHv27`4rvS(7p|E(D(MGwnnp?4}yqP3qE?P{$hC-?~Gk5Na-onEqhStlJ4U!?7 z4=?=Gr^XTu(Ulbq#Na>8#cb`fEesZjWP%MW3N3^rUe}^;Bz524OdR@c?9ZBgy~Kk4 zDiQ!)tF{_B+pm89%4Tn>I=ke^Xr5A7@`C?abJ1;m{t8~qlrB}|5SHsWH*Q!Ky7+7N zlPE<9oQt!V6?z?#R+~4 zlEA>^&-<33QyiZ0CwsU+MHnExo`&+*ZZmvHF3Im})(syU?`cPV!NhNS1`VCk(g^z^ zV}EiJ#R$ciYBI?<#khh$w2~@tBDkE8jokR-mIkHjZ8`E;nN@?5@r>3vYA1@EPTioI zuO7>dZ+Y_`WGW7rN{d@Zs;2iMcO!<2ET?wg1EPU;Oj=LTB7sg8_MQ+`@^Paozw z-4{cGA@8HQuw8-sq2;;zis!mX8yU@W>SvV&`-!>r=5OZmLj9AIQn@XV&2R z!ogmGOQZc+TZ>(Sp3pdA@Oo~~&p*Gd5~z55r51G6+$LK(B_Aq=ju}Owjn4lnD-JJO zPERl4+1r|7+x<+i>~=owTOI zc56YEfHKdcLt@a@Fo6xHN*RHEST)<$RD&ophwfIYi%Jh=_(CYjF#EpF$iD}9E&$bBJ0&85GQFbH zjxrNENg)ABOoa7MP+YjKFM$WZv{>dwo7H`WCs$RCU1f)hV-RVK=O%>BB#J)dvmh*e zYsd(IW60D?p9Q@}lMFD8D*&0FOPZ9%&uvF(Y>;0(*o8(tgViocgNUDZ6@V{b;xU@< zF?abVgfLyrH1JZU1+O454Qq8B^Qu#9^QrgfM?(YEck(OZoKy!(B8NI_bjs5nrN3qE zLsaPvX%)9fF@5d}>IDlaA;qRi^qfq={IVgl;nhvfwKpRm6)Xu73ZE z-QK5MHm2QM+)_5CNdAlO%GbsPZn`SEK9o8DEH@8vPIBoA000KDoI_M3PXRSS{0I}S zQI)JXE#6rXx^F(+3HFa_r-Io_C8@g;MsX`SzF0OiKoV+-7f{Ls0bh!OhPv|uLXsyd zc9-zXGPGTmHSBwY!Yv3hX3gl0?TG17$i#Z~yetk`^= zO|1;8_^0~6-3uRy7OMC^*7yyo2XFM@4fKuS0+qUS)kNhfK}fxXMBnx`lWNjjGrTyu zQHw8eYxBRRQtMs`otI)#Os%&@*1)>;n=0BCg_F0b zWNWC`3BKRzzP^WE(vDK%V01Uq)ZP;Y34ni9K|PsbHbUpVEa^|^- z0EG0grFUCWfKUPc<%bR()5*f-BkBwAj8NY4(;r|J^(*neFmff#_M&~C6Wf>|&0|^f zUvCb9^nEMjY0k$j&2O(}gjO=dA%FDz)9wSHyegK5zH;@$lJ4}QC>LTx60W8s3wD`F zX78o@X^wea`#QOOxE8_t37EIx$cRdQ)yO~-)#$?LLJ>vOX2tl>HNd;XpuNBru)sYBo*U#Cvt*TKDM9fq>goV)CyN+R7w zFkh9uBg+%mMeHSL7tj%wN)Fx1nfp*015`W?7p^Li5g}C)4M^5opc~9%tTG)O_IBYE zSRT(*Wr5)B>#=T_=r4Xh{?vOB?Zm%T{+)f2%PzAbw+{o{4SptG+=}qG3>0JMUa-hd zKPebsY)uw77MbOXgcV5ADKEe-HhK$Su^iy&n8-%4^0wc4@KX9E5b)QQcS^DyAM9!M z*rw(YiOxo*q%(nr+PV0Wv-{UmS)um_xpWU9$P4x=@zV4nb^ZDJ_8fwe(Z0QsrRxX|+Mpe3#st zwBOde?`QV667-T(kx)^35q}s{2nnD0)YbW7RP@AC5Iu&moXtPTrPKQPLtk2Jzru6P zNSo=#nvlz3?2cA#R55AbP?m>$Z_7<$*u5GiYdFwp|k)La9H&%}3@8`*2f%(djzpXJ!Sja@Ug%*Zl! z0IUFjLipNvYDu8D@4 z`P}K1a-!9H4p^(DG{mgMt^B{^PX6yzO*^otA|jXp;z*pQz%+_iOhgpm!L~?JQz}gq zZgC4igL1R}=qTfHOUw7oAuPg$H>q8+J#9?vk8-JbO#7dE7_)1isFwcfa97eb8l`O0j48!ti_CtM*FnH~>K! zk|(Eddg?~8K4-}9fq$*p&&mk=8_XG~gx+st(MOHrtcUBq1MpH!+M7G}c4ZdxH9m+me34nEJhhfS2{De&9$^ZFeF zQHSF{$eEaw`$HewFY3uM^|3+`5OD=!VUlHQ*ikO^%!Quc4@XVNd zhtk=}(|fLoG!t!-g#d@lp)pN60O5_cQ@VSzxX&#ybcfTLgQ+qG$Ql=F_61KWRllxH z@4kS?{k9+Y7mUF5|8vnlmK#7$Yi>q&3ao`-7Y~OfQ#pyl0l{tg)8b$tQ$r@P;Ye<{ zYar=F;KAi!rVai{f|N$rq{b(2WBLL!2RJBc>@coJKmNOv(KlL0P9T%6d#Bp%yuyB# zWWJm@%SAg}9;U_Zfp8MBtT}N>Ct)!*$Uhb=v8D;Em(%Pl8_+A#sMeGo(4zxNq7=B% z&FKd9n@0CLYyH|EY=Vr3zx)m1Z-m#wjkq}o3-Lv5LoBtu8C3waov@9u8ThlFuC&6* z&OySc`RGh`0G^7iGzmcDBPR)=(AG`k{Dl-qjW%-YRiD|(L-9r$dn>%dCPlZZJ0|+5 z`q0I?)r87;PoE>)-SYVObm6E>z4h}K3AjF&6i`5iVx>e3+=Iw10-%Mc;}4@}NMH$* z9sKdc%-e8QC3~^g^(!r3a?e68Z)cdK)-l=)*Y==|IjK@eC{Oi&;y38bk0feyC4leh zUU(f!B>*)Yh2qCxnNBjFA^G-4|3;ub-BFBHv`kdv{xjwKl)b+%d@htW*WSEx4D`95m)@fN#{7O8 zH9!77bp<+o-Sj1y|JZNMWkkif*ehiSF_44($4Xt*xt)+chG*1V%CxZjz$mi?j|tKl z^X{I2ncOsE40$|L>z&i$j7D07X;tcnNF2Kc8;4q$dsRM-r82+(Nl>CV%n1m%CApHE zL?c7oW_x?x9#erNBU7lcWPfqlBJz*WY|1LLag$aV;QM| z^K8{uAmSeb1bz3Ai}5x^y4;Y%#ZyQ5e9K){DN+{#<;WCOE(&K4a*~qVh$+2Ag*_ZS z8~yT4YPN8P8P#HKHFu_07;>1<4d|d(%3Ey=@7&b>vC37W`EM(;RQ&noTgzd9^!qhZaP4{A=oPcB?#vRe=^$%jD%F1vu4zk28T;Uth zW>lBq2oqD858es@n$U^OTlQ^hP*LkQ&1A|T?&GLR|2D0b1^QJ6y;c?@cI}&vl6ug)f*8I<`tkA(34QbVFZs6-Ld4 zmo!pR+}yn{$k6x5A^XL&`lfkz^2(CdAjDTX$UrIz8_RY(&TMLd~GF;>MI*%h%Jg`%Bm4WPuQN}gcJT8g6`Yw>gIAm=mPS2 zO=hlf7Y_v4KGHQzO-F@?8eG&I?O|#5Ev8u=74{8!=QgKd?P?4~G2;a62P4UNi?D1h z+np-@AJ^n^o1-e~K-=C6ksy`Gz`XBFk7n)t{~%{5{}E`oZ?F!wFou-a*UkP2!9hRG zbi8178M#BE?+S!Rz2-W@0jFo`eO5m{rtHU1IQ{4;D)xnclEvlIlCXDQla@BRi?!g& z%w0<_vp>wh(Sajvy$L)#h)tcpGI__3Djj3U3v~opgJ_%}9Z1Mc7{#%vGHK3+u2i5&|g-F8t24w;^2*M#vQmzg!9l zi~3yo4#yH&XjYTfLI zovhE#E*zklS0}b1z>qA(`bj=pLjmTmu@`H*ev8eta>gBFJZ-cl3}-%)(jgYSB_7We zN~8#$up6LGY5+Y;uX2*DLdlhIex&Cv%}e9hefLsKNEX-YY?H*=K!Zrd)h98PxFU># zITb-Q`G6@T$g(h zFBk9-ch0u7d_2n4tFFHs*~m~@+8XK5vMHq{8+{aqE3aayI^bv+_ZRb{L$M0BBi!>c zM9+lr&fl36+WOY`QtznQ!;{SxNDSSa@4P1^94|}ummd=S^JCYzM`2%ivXE;&Wu`s7 z>V;=N)Z7EcBVVJS-!5`(rJy@5d-xY0hVvTm>OaUesg?kso3!=3;ki`!#1OKD$vM%T zyqzuz=fjRd&+aF}X3mY;7i=J#f6uiF{nV0Gg#4vCyqFNAmI)w*klfy(iZX>qstM%k z<~}`i(x>r>UMyEFOA+q66lSZbe4j4ZUfb643Tbf^1N|wf(!0Jm{l8D}7y;rEltyuY zR{k9V!dakE0>Ld*$iZbJ` z4f?x*GMfd9rtw^Mz<3P@+v5X)Wj3tp^7@-Mn+(CJHXJCb+;!Gi9I7ZYYN>JwGt{lY-iEBa#3{#PMe}QuH&(KLxJ4v%MaaEu7 z&5s(o1^a*mOz&%qX2&sbG|6xxUZUd7>HR|_aCnHUB8$+tB%7zRg6^e$o6MvS?=s50rtY@%+TH(#AJQy=3DsC5-ji3zk7^cCwl2 zALKTat{`CfthMewn}5}{;rBJ6lEaHG(L)kU9JzsJ=*mJOJXhB8b9ScPUie6T;nsck z7C`&9moFg&0LVF4QFN*psQP#uu1EX^OwY4^mVgYDfY8`aVSgfXFOI!`aKAiX&6jS$ zZSR^WDDU=r$=?2N#Qh(`F#q=t;#*upy`l>#X^7%mFoe?jev9Lq(W5i8N6r>$GN3C9 zeKoZl-^0exbxIS3o0wrx7CLESxngda_*!8Bvy6eo7G^^^GdmjJb4qoEu86y0Slv*g zZ8O3>7bneW{?%hoiUo8Ks^n9pOrvy02ZXUxgh1$ zNP%g{;JiDbj5K1&E>Wi=xS-{fzF|MgxgqkyDi36&8LH*1BqqAIc$wr7m6@xcsILLn z9%r>pVmd~P*`G!-^_lEba3Vh|AY5Nwk1sM&3Scvuz@z;lLm>-W>9n-Z9Ab@S)sRZT~2c62|Q;^C3)>(%&&r+*F400C+krw(dFcR#fPk@oeE zUdkM00r?&%=e4lF+!M}&0iFZD+PQTUgF@{CN zN04VC7>L`XR>DtF3$sTV3BFkqOECP)dlS`A(QRf<4!610f+^btv z!Xldd1p(0;gUlf|Jl3@?^?ou8+W-{tHcEQsE|evGj1&#?W_`d^817s7H9%^4{gwL$6p07sU$crUgqsPHXUqwtm4mZ( z*XThqZWwi$9|N+N0R^%dQdP28kJHk;dS`&4w6AuXu6pOP^!h) z{z>Vd_ObVJ0iU1;5Smh>nQT78nznnhazrQy5t-p1@H}LlG55XOWAp#Yu zYf!3NtVJOd;&APTXjyBGMQPZeje(&%GIR+PUwE})wA(Xa7z!K|4g?p>67ZX##|xNv zfjWc~H%XLaC}vM7sYy|Z%v`MWy6T-j4S=(&fZ)Z~LoDqr?pe_X)vjR3ky+{W2Ba@m zu!%{w%Bj>2kR7jPgJVqu44A)BiiGLr+Qb;XhBxb3_NP{ubCwQc)NIvhNAGr@?CdwD zY0ype7X~-zr3B|Ob5lmvu^gn(G%#>GsU*G{i@-uc$}i0RgIv7(r9aiW^}08UJgZ?O zJ-G>$VX8)v)dlN(uPWK8^&Pwi!HLd9bGsLI!!B_ao^2Y~S+xzv z0#aN>%0DGZA%Fn4zP-#yBtp0FSo=hy_ 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�)6)`HU`j&NiqsE- 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ⅅ3|JgjE1i`NecPyoB8>*j5gner znbJo9P*$8%9D;t!N)CqYms~FgbvX_~g1EYE+69gAt~t&8h%?r@5?%47&keQ>J?{FX zPO`br#IPOVT=CXBVea)6?g+Y$kpB@1n~svAedhr@UCG_2=T1*OJd{6iwm^g-n_x)q zo`*0gKY?75NqBz*u_xyX#bTnhwEyT(t~EIfdKhK6ux;VI8K0@H?l;yU(Wq5ZF%$TS zj~_o&>5dz|i!-1-752w5hpHAoi<)29noKYQF`6UJ_P>aIElV8&sStfnh@hN!?*9q6 z8j$vu_1eo>!|TWYJ9h3C;+G|hi(9s0gN}H^5P(F2u5%FcmEXp}c*+hVrq2wt@v-3% z%m4Sgu9k@L!<{ddO2e@f{42)w$qv;2S>xnZ$hW$jsl0e`o>@31mzm4(kQ zzHWY?>?fUKOk7qM<>yP>eqUS_rQx_|$iq*ry3^uw{Qk!P8KbNp(Rq;8^LY2_t;+K6 zqo0wAiW7$uKCx6W(;k&Gg5+w5T;oWoYe(MLCG4pp>AUDjaWC*5q>F zmmpk_tF?A4A4K7lfJ9is81~728y$*>w&@MPjW(a>Q*w%El1~7taD#=*Yb_LN20CSeexv9O;n0=gj}EqP4SyKfYYANFx&*8u(};80VotK z48ZmYS^nM^J7+EeOHC><&-X*|dRPl;TP+}c=#u3waEm--Vo;P%l8Jf4l3r{DJH8}0 zl9MV{n(n>rfQ}(>uDG-~xGasjhF1Yh@DmpaSl6v>jx*qL<#@x*VD5DR-N!zH%f*OV znwIb&9mOsLX55eqm=Q>*QL8@Nc0_~Iz%jgjoElkWDoMUJ7C90QTr8tdR?C|Ro)3vL zL<{1|aGV*qJd`-!Nq|&;=c3d#o6v_wFWPRAR~Ui9bvZF0wl9EHk?& z%yD1NsJp4PoZdP%ORvJoFsp2Uz7*U|Y)U01@%#b^4*qPi4VUCk^AeVUB#B{*%EObSNIK7T7y8xh-fdVo10tXNriKL8lj@*=-A#@#j^6^bazKST zm&uT@7VhF44K@U1a2(7%{bCFS{B{pvFa26XS>d|=voOvC1Zoo5aPw=M#3n4(8D;d0jYSJgLb%l?~kR)-HDsO?YA2)z+oz?pBH z>Cso+AP0fC9k-ypPrKabCK$qk=vNg#OlQRfwRLAw?Nl#<-bA5|FKZ-{n;f?CzQV4V zmcM}TKYGOXI{3fc3W9sEq5nkk7<@aDv{#J9j;;RDJW{JsXEb8Z}i$(GO@tt2S6j}ihGMQTvrPw0q};fki_}) z<`zL>^|rdf`P_R$y)G!hy|ebAsxoo4?GEaLa)XW&<|qzGgbR{;$jn>9On4)fc0tuW zv0G19&T+Y0U^b`ww;3pr$s6b}Kd@}36Rq+=Ci9F$WQS?V=!Df1C`@MoDu4Mvq513epDXcq zojyJ=UXXzL;utvuVYCzV%(JbAhigxKE#q+rsi)&}&x`z7##3F8)9bRQKlpwi(KIZ? zB!x?M=`%(RfG9vmAjQB7a1ny&Kygr&7?5UXqe5$LSmdr;HQW)U01%w>t+S!?jXH|L z0hx-%SFy}v5n$SB1Bzp~sTP8O6&CUk48jf8y{D4io(4#8H7e0=fJi7TZerVZjoohI zQH70HMJK2I%7Hy8m6k_XrN{cOYeau>_Z=FEvC9~A-zf2WpU8}!MK6geZ8WTiITE@@ z@%(X+Vw*gu8)~n{5h@QV_?VW z0>&qyb-z=M3WSjrj)wFh>pgp@o+N*`H9L-Lmp?SvIO(WB_oqr?1 zOL;omw$7JcG?g}x+|o!)QI%6WXF}7x$gb((>|mDME0*n#1HA`ZiRf97--f3Vt$%;c zdf?+-7W=KT7<(f!0=Cx~I~S3(#23Jit1We1Bx}$P-bEMyqh^9THBiYOCWg$?x{qrH z?MB-S$%v2kFyJuEQwl4glg}w>Z40aThozWTz`X6(qgH;V3o_!59govxp%?VE`d%eG z$w~5SfCLJAFgtthbx$ywy+}#XTgkQ^iQc=E6;~ve!ae2>GM@^42E5e8(KIb~DQFnv5z+Yj<;Z6zulv9Hl&XfZF_A0rU3@^# zMVoI@HMJZ?h5~&Ak5Cq6`yQprqT8N9#UGQ1o z#?Gl1qo11I8y7@;xm+XFli+-=BBF?0Bg%ggf@%!P@1tfQgCO+OlonHQDxsoq+|nbgW?LP9l=jz_Zgxnf>TRJt(G>JDgiQOcNs0{sH1dqoBF4)`tm2LSLFsdaMN&z5~i$eS!mr^9o zlOE-pWimSmk)4>bY?yjpp@bQ>UbMv$yszY86)(K_JH3hvpc;5(> z!irlb_$)Ea`qkamMt#j+>lDIQx5AX*hQIYs!&v0KbS*S>y$4@^_ldm!b36e@@oOm% zz7{Dy9;WZ#SW1=NEA(p29gZ>Pjaj2pERYd|4lh(hbp@n z(}N`K0~fJ4X5oG*76$IrB2|m#Ov71<@MIo5|BB)8T-~_6WF(!&_yd?Xtxr}Sxzb$B|Y~9|K`WwstDA>_?r4HFu*VW}mPvO6s6GhL{1pt|kbSrt& zhqtBstfYEDdb*JQ?|n<0onyzThP)+x=}9VB2YQj z8cw5s$uWgU=$|?ggJ~kK>4_BH-7jpD{l?6b8#y>CtOEDQ(XGpkzP!*WO4`gpfuL!* z$21k{QKRk1nQOLG+ZKN1&lEykst?#})Ng35`O69m7oU(OKJy7_Os?sy>c)AI_3p7i zk8WYJW(L$eT;l3U*NJ4bMy;4g1dKqaJf4nym~sOpfAf6g6`!s4Bg89+#VROL3VH2kMah|lMFryx3licvTridpu#7}yu_FLA)m(`@ ze78Fs+?z>Iqi`I)#6j~}L;W}s2ePP3(%-)}<;d#+>LvayMOoUz{MbDO!&h9LI_OsCh~BusdW)x9tC7ulSZTwKmeaQOM@U=;VK z#f`x|-Fib&{wgJOhDP`z&IY8P(Z7zQqtg;?kdMoeky2RyPjZMHMD$!d$fDvR zHSyrMT6B1ha7E4r3Ymz`h48M6!lVSwDM~wA~H%uQS6EDMHhV zxjTqE&kTlpgKpJ7|`omM5ltuOBO>!l&NClM;L>g5| zzQate!*h1H+3G|UKz=Xu<{Q*S0Uz| zeLbH!wi{nL>Kbi}z;+fjl%-OVhvEMDC6(oWw|Of_3#_wWEG~#!-x$&+T8F-=ENOq8 z*XwA}Ue2w1KWSZ6d9Kr5P}u$Q`G!*G^->ZlwM>)5V1*0dVgumVr2&vY*o?#VNJyZ` z;OvTq;gUxGdAgUDF@mNxJVeFYesyZFt#GkkD|Nd5fR0nUDLBAPRtSZcRWMc3H9-ao zx$H5xXwLo?0)qNVd$X0k;7cR!fz0)F$$;O%?X&q+Yp>+f%XcyH9r)suZaQZMm88iM z1EJ_sJkO-3(BS^uHT^Z6r!<_b^G;X;V)Gk4_wNJ?@DlFcEpll63?{bX0 z(Px!$rZJ9KrcNTvzX_t@SU%soaB>jF#Ll|L62pPd+q|5Uq~BeslOa5p%qdQ>HWl?3 z5meU%tWapP&BwFVDY)bkg8D{BDcCNq3)r!!s@Lq!znrdW4eSPgwT7Y#0`;<)@Hd11 zqhp$3!AXjV18KmSvelAB44_!F_CpModPG>PrYQ=J8i&M`2NFF60p_)Cq#<(+OQhuW zx9;goe_9&&+me2lnQe|ed0V>ZJcZSVazP;sGvr`nQldk)@E!`EYruX<6s5rbxw)skr zkWU&Ir3c=+JO<7TO?sX^`Jp6ogIyzJsa4kYlO3w&GsxsAn#h1(-aSylRpCQ@24aBi z;qVoI@ezK-2H#~UWDc1r$v02GH<2^K6w-ms1(LF+R*g5`uHB!@xP@RX{tmx=&;1JeM$n zI5^8^57_q4Zm0b4X>ghc2~O3)%0K6v*Ltt^_E$)gohYeCkf{EXoI2|p0IKD`C5eJ_ z3}VNO>6sG-pNq=55aPIeE&Y3XZDPWK9X>XdBD?hZwLgt3g2;|W>t7W#^PfMwb)J)%fBWR< z?au>OZ|+=hDV43VMsHCZgBL^dm+8h;%#!y)Tz=x;>vMSdT^7{1BZGlr-)whY+m2GX z=t5JifC%9Ea%SmZcD&EGLnu3+Y&!}i2F=a`X^{o5^<)`6JDfVi3cU6|-c|R|MjoKV zN;^VvjlqMPAWBm)vk_?Gcp(<>=J6(DB~kyzpJ|M#d!@A*nUNJ==YNJ@!=w+WQ`a++ z?_TE|6qb1h6k6F-1$l^Z$&v|LVgX3{WB`DjQiygOiWLmO5}Vor9&{9ejd&)UIJG!? z`XNDhq&)ApvU!xevj&HuAh#$<;wKWNhcXg;@7{g&FV`FdGygnbV>@o}lPVLfIt#lD zNz5e(8a@r>tpC2=e+LA3$F6nx5WK)LiAq|) zT%9&(3dI^iH?o=zk{X}tkVX91@0|jkRPj=$0>5ehcd+`heqsvCjTS${`p%!P`ahju zS+v`I#Ah-D1K2yPo$SFDwejA~BI#(GGs_`2g1+ZK zUL=m+HkIjEXg!M#XD;-&T9?Xw^!-?~bBhAtVPuvk$!BAN#xEF~>&3YE#yr$f(Kxzj zvG#|e0JL%w3qai86|`WtVKa~}SHC|8BMmuAC2a^0ok22Nu)I4AI@5#R!Q&or=%k-Oi`<#U7n>g`X;&AbD+w2wjo zDt(Cc#5dzbF*3>!#=;K$D2gE}4BL7SPM*H6t+hr|c7PRBS5NpS8i#vW6@k7gPK8t{ z@qR;d6nmbCMsLt$XO=Y_m2AFCqpbQBVn(eRkhlj^xKX0dQsQV%8OK9l@|PwW3gJ3m zc|MPlG0-wJGL6aj(tqZBiI5jXVk>k^-_-c@3D-0X^&^Hce4rnQ8WGK=7nrDVdJ(0z ziN6Ok2rrIy7xvpvCzlT=9tXRUd?b_j_4_s}c?x%oG3!#g>4Xz8+FipzC4o z0hcG`*Zo&|%bWejG_zsX=^$3z=j z!mpwGIO%=HSPQwBPkyHtR)lR`HgTamZyvoQICcC|vFsXe7X~M9{z@s@42(a>ouR+_ zc~`#V5{Vd0ZT^@!NC_>nvX<$G_tWE=S)C%Jt8rd59y~7k+F|hY!zy+sCTSNUXe{OD zGy%$P>L@7gKRT-@m7%8%1teoYIYL_oE)P|6-# zbZPJ(Jp=Lldb^M)t?TzXy&^Mf2W9*d&c46(sv4ZrEjJs_zXVE{s7K!1NQmR>Fyx0O z0oy1@eytFEf=^4^u8xD^_id__Vsvz3XsM>5Ih3Rt2T0fde!tJ)Y9O|*BPIkee}n)B z*vbJ^upcE5+!2~?0M2js#bK9#j4p`MpaNDyBBU@3d=AGjQc_}`Z#B^LkJ>U&T~pHq zY*A9$cNLS;U3U$<>XFo~8DY3zR0ybn^}j?EdoKeRpL@Q#u0P3XYYF%M3#RI4?i5w! z^OvoVjyg7PQA~oPSXh5HkTEKc9vn@^8juLXbDz_N)ghuqXa`EC;Aj?Wx4x%lEo3aw z0c5HKv8%h*nStqQnLib3rwUtc)JS6HZzIh^&)i_X0(z^bHPz^G@tWKX@5VN7r+vCi z*TU_xO%_fnrV`l)u=LiOPC?^YR?sWmV1x%rQArsx1d~ula z2>?uh0!|NILsSNu)nqk_QCM?E`4lx%8mDU%;XJnK|Lx_t@;~o#U3#B)ImzB|MEyWZ z%Sv^0C#_G(^)u8Q^Ofbc`81ahw5{TE6}vl)rkrnou+oZ-jp}Bx-lj4)A%+u(2Cm#NzE4k_@s$^g6pgg zVHgS2$sEnmyHpE#@I|LYV#`?&gL{L6%NH4dHayz405&!QR8|^hh5}2+NUEg9qYb{4 zHYCiBRthGczZR9JM4MrWcIUnM7LjJE@I`uN#ffBoCZ-fmzIG1?&6%+tyO+YS6C&4! zCs=PMp-!)zrmlXFs;ACLq8TySor!%2h~Vn9Ij$F_nW>*SGWe;GL0IVj4j0mNKE^YD zZh*nvS?N`E531sZVcuXP=}7qcxSbMA6}gX*kM0zJ?&n8m<&`7~&-+f{%*5@To^17E z*TyvG42xv2SUr#L)OP9j+p%<{+zfzKEA6&NYm$ANfeMFM&{RgV~XX50!Q zsDgzX8$0zdjPZ%zme2g+YRzEDWD>)Amaj9KSJaU@rzBQa8PD+?(7BK}L+n5A%O0#& zw@$UtKC4!+oT1<#h<_D;(B*T`F^K#EmFYkCR=TBaQDlOGng+Bs^%(EuRyw0q2y$GJ zN?)+>qTkRHvdtYDTQqvob*na7+G|q-na$3G+u`)jp$N2&rc5q)rO3NA=lQ=T(!XDs zPIMU3p^6b?w}t3e-7E0&2X0=J{Jt!tyCjA&h&%cTPE~7l9lx?hQ5FbX96;&%or-RU z66~X2o=ZF;c8!bsSPwBPiUy6-6&Oa0C`=^Ep9pc`B>msPssZ&G@S-wOc8gcek7e{l zvNZdn!S1B?nYIyoU_S9kuc$|>^nqU9VV*+*TZGy+HJ*7>!z*fE4nEIlh9P*(W{{F1 z1~M0toEeHyn)Pvgd&O%%B+j~{A}K$6BqOo$R!#c37Q*P)NU`MQ#9w(*W&CnWTYSi` zhL>e&r#6L)$?rucL`1>%hmu$c#NM%6PoNXPKt+f7LKVkL7vx;7{>$AR7g~mtF5Uji zEL<#u1=`#8H-rsIiK#B>N0+W|=7ddGHP~uh(Ff9((%2s>10%FG>ng^ng0NHBfuk)R zp0LP)5i8;gPw~VPsCUt~c`43Cd$3g*uHcFI_DhkYpveX`=j5CLnWfh#B5|D3Y?3ED z$P|2e1mGC>L!8ofAea#9ubAWlyU+zbB{LbJ#^y;&&Ki@{>1Y#`t31QOWR}s^)mP8c z-k&UiqhiAKBXvX;)}%Nwl(f}m4(X(Ls&d`os5lWYqFQJ*%AZXwG3UN1Ij$SY3Ap7u zW$jS8dSKp1dDklg6Ws!|2J7%EARi$?5qR z>z0WM|2&F8h$7?YG53i4^r0KLjSg2=0GqY#VwG@Y`^_i+o~9Qa|3|lGt{(al~fO& z_t|&-d!o7Ry_TgTBo(`RVSRu<%w);M%#75|) znH;2u(9(lUJ{fGEt&-6e!(?(?ONd-h*!@l<73O zt5gF^ierW+NnEzs7+Xqxzps&g=DSh+R?3porcRHx^py$}2|$ZHRM7e|t`n(R-wTOq zN9wNTL;J4fE!`;Qg{=85B*~Z5WRsoYv~{{p>^1^6Ft{1r&2#r8XU@~lmL;FhRF`3t zr3)IKM@UfKdMr z@rZuf2y+o^t0ayrut!hqS>$1Ke}_rCs7n9321{P% zX>&e8T?8`_5>X0PV!ecPz9(>W>5@UDIotC0?r$qG(Gs0K$sl$ySrRNN!GiF>A7pBd zArJ`b0sU%c? z)BCTrnZg8j#? z()V^JT1UiN(LBHRpOJsX*I$88I)&b+K75*!**jO?SBu+*yGgeL;L(}uzmWKvZU7+R zTqUG|%HS#tq;DX%j8xEkmnvQ(G>fSEpYPAM;uR#kO?7hmx3r%QO+| smc!_O8R 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

    -qT_v@>tKwDxuL0v9*?aFw@& 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®>9$$s-sSma{1OAZf^6j&lj1q`k0lF_&lz-x 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 {Oi6A?}^ftt0}A#|>s>q?NWIGxHHT)GN2s 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

    Fp-&`IaOm(xhkof4=)E%c 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�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

    ugTHRE#GF*E5B3=7V+i9wDYat6F$MzHQ}cT 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

    #^r~ll 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

    ~aJ;?OA%QgkDB}tPRN2;dW=JKzl$eH$-x!xdwZr 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 z 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�e&ug^_;tBts3$XuB}P{} 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 + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/models/alien.js b/models/alien.js new file mode 100644 index 0000000..1f2e9e4 --- /dev/null +++ b/models/alien.js @@ -0,0 +1,89 @@ +class Alien extends Particle { + constructor() { + super(); + + if (random(0, 1) > 0.5) { + this.pos = createVector(0, random(50, 500)); + this.vel = createVector(2, 0); + } else { + this.pos = createVector(width - 1, random(50, 500)); + this.vel = createVector(-2, 0); + } + + this.w = 50; + this.h = 40; + this.rw = 70; + this.rh = 15; + this.p = 100; //points + } + + main(idx) { + this.display(); + + // destroy ship if collides with alien + if (int(dist(ship.pos.x, ship.pos.y, alien[idx].pos.x, alien[idx].pos.y)) <= 35){ + if (ship.shield !== true){ + explode(ship.pos.x, ship.pos.y, 50); + ship.die(); + } + } + + // alien shoots on time interval + if (frameCount % (175 - level * 5) === 0) { + this.fire(); + } + + // pop alien if it goes off screen + if (this.pos.x >= width){ + alien.shift(alien[idx]); + frameCount = 0; + } + }; + + display() { + this.show(); + this.update(); + }; + + fire() { + //aim at the ship + var dir = p5.Vector.sub(ship.pos, this.pos); + dir.normalize(); + //create pew + alienPew.push(new Flame(this.pos.x, this.pos.y, dir)); + } + + getShot(entity, idx) { + if (int(dist(entity.pos.x, entity.pos.y, this.pos.x, this.pos.y)) <= 50) { + handlePoints(this.p); + explode(this.pos.x, this.pos.y, 100); + generatePowerup(idx); + pew.shift(entity); + alien.shift(alien[idx]); + } + }; + + show() { + push(); + noStroke(); + + fill(128, 128, 128); + rectMode(CENTER); + rect(this.pos.x, this.pos.y+8, this.rw, this.rh, 20); + noFill(); + stroke(77.6, 88.6, 89); + strokeWeight(3); + fill(77.6, 88.6, 89); + arc(this.pos.x, this.pos.y, this.w, this.h, PI, TWO_PI); + + strokeWeight(0); + fill(random(255), random(255), random(255)); + ellipse(this.pos.x, this.pos.y+8, 7, 7); + fill(random(255), random(255), random(255)); + ellipse(this.pos.x+20, this.pos.y+8, 7, 7); + fill(random(255), random(255), random(255)); + ellipse(this.pos.x-20, this.pos.y+8, 7, 7); + + pop(); + } +} diff --git a/models/asteroid.js b/models/asteroid.js new file mode 100644 index 0000000..08d30d2 --- /dev/null +++ b/models/asteroid.js @@ -0,0 +1,82 @@ +class Asteroid extends Particle { + constructor(x, y, size) { + super(x, y); + this.size = size; + this.vel = p5.Vector.random2D(); + this.vel.mult(2); + + this.tmpvel = createVector(); + this.shipOffset = 7; // offset distance between ship for collision calc + + + //change sides, size, and velocity depending on the size of the rock + if (this.size === 'full'){ + this.r = 50; + this.s = 7; + this.vel.mult(1); + this.p = 20; + } else if (this.size === 'small'){ + this.r = 30; + this.s = 13; + this.vel.mult(1.25); + this.p = 30; + } if (this.size === 'tiny'){ + this.r = 13; + this.s = 6; + this.vel.mult(1.5); + this.p = 50; + } + + } + + display() { + this.show(); + this.update(); + this.edges(); + }; + + + //double and shrink when rock is hit... destroy if size is 'tiny' + break() { + if (this.size === 'full') { + return [ + rock.push(new Asteroid(this.pos.x, this.pos.y, 'small')), + rock.push(new Asteroid(this.pos.x, this.pos.y, 'small')) + ]; + } else if (this.size === 'small') { + return [ + rock.push(new Asteroid(this.pos.x, this.pos.y, 'tiny')), + rock.push(new Asteroid(this.pos.x, this.pos.y, 'tiny')) + ]; + } + if (this.size === 'tiny') { + return []; + } + }; + + getShot(entity, idx) { + if (int(dist(entity.pos.x, entity.pos.y, this.pos.x, this.pos.y)) <= this.r) { + handlePoints(this.p); + explode(this.pos.x, this.pos.y, 40); + this.break(); + pew.shift(entity); + rock.splice(idx, 1); + } + } + + show() { + push(); + stroke(255); + noFill(); + translate(this.pos.x, this.pos.y); + polygon(0, 0, this.r, this.s); + pop(); + } + + update(){ + this.vel.limit(limiter); + this.pos.add(this.vel); + } +} + + diff --git a/models/dust.js b/models/dust.js new file mode 100644 index 0000000..31c5964 --- /dev/null +++ b/models/dust.js @@ -0,0 +1,40 @@ +class Dust extends Particle { + constructor(x, y) { + super(x, y); + this.vel = createVector(random(), random()); + this.vel.limit(4); + this.r = 3; + this.acc = createVector(); + } + + display(ship) { + this.update(); + this.show(); + if (ship.shield !== true) { + this.repulsion(ship.pos) + } + }; + + show() { + fill(random(255), random(255), random(255)); + ellipse(this.pos.x, this.pos.y, this.r, this.r); + }; + + repulsion(target) { + var force = p5.Vector.sub(target, this.pos); + var d = force.mag(); + var strength = 0.5 / (d*d); + force.setMag(strength); + force.mult(-1); + force.limit(8); + this.acc.add(force); + } + + update(){ + this.vel.add(this.acc); + this.vel.mult(1); + this.pos.add(this.vel); + } + +} + diff --git a/models/flame.js b/models/flame.js new file mode 100644 index 0000000..b4723e7 --- /dev/null +++ b/models/flame.js @@ -0,0 +1,39 @@ +class Flame extends Particle{ + constructor(x, y, dir){ + super(x, y); + this.vel.add(dir).mult(7); + this.r = 5; + } + + display(pew_array, idx, isAlienPew=false) { + this.show(); + this.update(); + + if (isAlienPew) { + if (int(dist(this.pos.x, this.pos.y, ship.pos.x, ship.pos.y)) <= ship.r && alienPew.length > 0){ + if (ship.shield !== true){ + explode(ship.pos.x, ship.pos.y, 25); + ship.die(); + } + } + } + + if (this.edges() === true){ + pew_array.splice(idx, 1); + } + } + + edges() { + if (this.pos.x > width || this.pos.x < 0 || this.pos.y > height || this.pos.y < 0) { + return true + } + }; + + show(){ + push(); + fill(220, 0, 0); + ellipse(this.pos.x, this.pos.y, this.r, this.r); + pop(); + }; + +} diff --git a/models/particle.js b/models/particle.js new file mode 100644 index 0000000..09c338f --- /dev/null +++ b/models/particle.js @@ -0,0 +1,36 @@ +class Particle { + constructor(x, y){ + this.pos = createVector(x, y); + this.vel = createVector(0, 0); + this.r = 0 + } + + update(){ + this.pos.add(this.vel); + } + + edges() { + if (this.pos.x > width) { + this.pos.x = 0; + } else if (this.pos.x < 0) { + this.pos.x = width; + } else if (this.pos.y > height){ + this.pos.y = 0; + } else if (this.pos.y < 0){ + this.pos.y = height; + } + } + +} + +//polygon function from p5.js +function polygon(x, y, radius, npoints) { + let angle = TWO_PI / npoints; + beginShape(); + for (let a = 0; a < TWO_PI; a += angle) { + let sx = x + cos(a) * radius; + let sy = y + sin(a) * radius; + vertex(sx, sy); + } + endShape(CLOSE); +} \ No newline at end of file diff --git a/models/powerup.js b/models/powerup.js new file mode 100644 index 0000000..875a4bc --- /dev/null +++ b/models/powerup.js @@ -0,0 +1,106 @@ +class Powerup extends Particle{ + constructor(x, y) { + super(x, y); + this.r = 20; + this.vel = createVector(0, 0.5); + + this.typeMap = { + 'triShot': { + 'function': this.triShot, + 'color': function() { fill(255, 0, 0); }, + 'shape': function(_this) { circle(_this.pos.x, _this.pos.y, _this.r); } + }, + 'freeze': { + 'function': this.freeze, + 'color': function() { fill(165, 242, 243); }, + 'shape': function(_this) { circle(_this.pos.x, _this.pos.y, _this.r); } + }, + 'shield': { + 'function': this.shield, + 'color': function() { fill(0, 255, 0); }, + 'shape': function(_this) { circle(_this.pos.x, _this.pos.y, _this.r); } + }, + 'bomb': { + 'function': this.bomb, + 'color': function() { fill(117, 0, 142); }, + 'shape': function(_this) { circle(_this.pos.x, _this.pos.y, _this.r); } + }, + null: null + }; + + this.type = Object.keys(this.typeMap)[Math.floor(Math.random() * Object.keys(this.typeMap).length)] ; + } + + display(idx){ + this.show(); + this.update(); + this.grab(idx); + }; + + grab(u){ + if (int(dist(this.pos.x, this.pos.y, ship.pos.x, ship.pos.y)) <= ship.r + this.r > 0){ + return [ + powerup.pop(powerup[u]), + ship.powerup = this + ]; + } + } + + show(){ + this.typeMap[this.type]['color'](); + this.typeMap[this.type]['shape'](this); + } + + update(){ + super.update(); + } + + triShot() { + textSize(20); + fill(255); + + text("Tri-Shot Activated!", width/2, height - 50); + + setTimeout(function(){ + ship.powerup = null; + }, 10000); + } + + + bomb() { + ship.powerup = null; + for (var i = rock.length - 1; i >= 0; i--){ + handlePoints(rock[i].p); + explode(rock[i].pos.x, rock[i].pos.y, 40); + rock[i].break(); + rock.splice(i, 1); + } + } + + shield() { + ship.shield = true; + ship.specShield = true; + setTimeout(function(){ + ship.shield = false; + ship.specShield = false; + }, 7500); + } + + freeze() { + limiter = 0.3; + setTimeout(function(){ + limiter = 4; + console.log('!'); + for (var b = rock.length - 1; b >= 0; b--){ + rock[b].vel.add(0.7); + rock[b].vel.mult(2); + if (rock[b].size === 'small'){ + rock[b].vel.mult(1.25); + } if (rock[b].size === 'tiny'){ + rock[b].vel.mult(1.5); + } + } + }, 5000); + } + +} \ No newline at end of file diff --git a/models/ship.js b/models/ship.js new file mode 100644 index 0000000..c83a082 --- /dev/null +++ b/models/ship.js @@ -0,0 +1,112 @@ +class Ship extends Particle { + constructor() { + super(); + this.pos = createVector(width/2, height/2); + this.vel = createVector(); + this.r = 10; + this.angle = PI/-2; + + this.lives = 4; + this.lifelock = false; + this.dead = true; + this.shield = false; + this.specShield = false; + + this.powerup = null; + + this.animationDegree = 0; + } + + main(lives) { + if (lives.length === 0){ + this.dead = true; + } + if (this.dead !== true) { + this.display(); + this.handleControls(); + } + } + + display() { + this.show(); + this.update(); + this.edges(); + }; + + handleCollision(entity) { + if (int(dist(this.pos.x, this.pos.y, entity.pos.x, entity.pos.y)) <= entity.r + entity.shipOffset) { + if (this.shield !== true){ + explode(this.pos.x, this.pos.y, 50); + this.die(); + } + } + }; + + handleControls() { + if (keyIsDown(RIGHT_ARROW)){ + this.rotate(0.1); + } else if (keyIsDown(LEFT_ARROW)){ + this.rotate(-0.1); + } + if (keyIsDown(UP_ARROW)){ + this.move(); + } + } + + move() { + var force = p5.Vector.fromAngle(this.angle); + this.vel.add(force); + } + + rotate(degree){ + this.angle += degree; + } + + die(){ + if (ship.shield !== true){ + ship.pos = createVector(width/2, height/2); + this.vel.mult(0); + this.lives--; + + if (ship.lives === 0){ + ship.dead = true; + } + + this.shield = true; + this.powerup = null; + setTimeout(function(){ship.shield = false}, 3000); + return lives.pop(); + } + } + + show(){ + push(); + noFill(); + translate(this.pos.x, this.pos.y); + strokeWeight(2); + + //make ship flash when shield is on + if (this.shield === true && this.specShield === false){ + if (frameCount % 60 >= 30){ + stroke(22) + } else { + stroke(0,128,128); + } + } else if (this.specShield === true && this.shield === true){ + stroke(0, random(255), random(255)); + } else { + stroke(0,128,128); + } + + rotate(this.angle + PI/2); + triangle(-this.r, this.r, this.r, this.r, 0, -this.r); + pop(); + } + + update(){ + super.update(); + this.vel.mult(0.99); + this.vel.limit(4); + } +} + diff --git a/p5/.DS_Store b/p5/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..67cdbc842404605404e831131426870f18995ceb GIT binary patch literal 6148 zcmeHKOHRWu5S@Vnk=S&}f`zZp8$?w&K`sDlq_Sw@3Mgyuxd_K$fjAFuK1ifQtSSU( zCbFMB;~B?KiYG%vyxesQqB#*&Xo4(*2@&BtwK09j)UbiY|I+Ewni6M=rCO5XjH zZm7ePY5)Dt-d^_YeQug=_pl;*y?lDsBaQs~+={y5=Hdt4vZfGB_z6F;0G9Z2VHY8dH?_b literal 0 HcmV?d00001 diff --git a/p5/addons/.DS_Store b/p5/addons/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..5008ddfcf53c02e82d7eee2e57c38e5672ef89f6 GIT binary patch literal 6148 zcmeH~Jr2S!425mzP>H1@V-^m;4Wg<&0T*E43hX&L&p$$qDprKhvt+--jT7}7np#A3 zem<@ulZcFPQ@L2!n>{z**++&mCkOWA81W14cNZlEfg7;MkzE(HCqgga^y>{tEnwC%0;vJ&^%eQ zLs35+`xjp>T0The 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 library. + * + * @module p5.dom + * @submodule p5.dom + * @for p5 + * @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|p5.Element|HTMLElement} [container] id, p5.Element, or + * HTML element to search within + * @return {p5.Element|null} p5.Element containing node found + * @example + *

    + * function setup() { + * createCanvas(100, 100); + * //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, e; + * if (b) { + * c = select('#foo', b); + * } + * var d = document.getElementById('beep'); + * if (d) { + * e = select('p', d); + * } + * [a, b, c, d, e]; // unused + *
    + * + */ + p5.prototype.select = function(e, p) { + p5._validateParameters('select', arguments); + 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 this._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 {p5.Element[]} 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'); + * a = selectAll('div'); + * a = selectAll('button', '#myContainer'); + * + * var d = select('#container'); + * a = selectAll('p', d); + * + * var f = document.getElementById('beep'); + * a = select('.blah', f); + * + * a; // unused + *
    + * + */ + p5.prototype.selectAll = function(e, p) { + p5._validateParameters('selectAll', arguments); + 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 = this._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. + */ + p5.prototype._wrapElement = function(elt) { + var children = Array.prototype.slice.call(elt.children); + if (elt.tagName === 'INPUT' && elt.type === 'checkbox') { + var converted = new p5.Element(elt, this); + converted.checked = function() { + if (arguments.length === 0) { + return this.elt.checked; + } else if (arguments[0]) { + this.elt.checked = true; + } else { + this.elt.checked = false; + } + return this; + }; + return converted; + } else if (elt.tagName === 'VIDEO' || elt.tagName === 'AUDIO') { + return new p5.MediaElement(elt, this); + } else if (elt.tagName === 'SELECT') { + return this.createSelect(new p5.Element(elt, this)); + } else if ( + children.length > 0 && + children.every(function(c) { + return c.tagName === 'INPUT' || c.tagName === 'LABEL'; + }) + ) { + return this.createRadio(new p5.Element(elt, this)); + } else { + return new p5.Element(elt, this); + } + }; + + /** + * Removes all elements created by p5, except any canvas / graphics + * elements created by createCanvas or createGraphics. + * 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) { + p5._validateParameters('removeElements', arguments); + for (var i = 0; i < this._elements.length; i++) { + if (!(this._elements[i].elt instanceof HTMLCanvasElement)) { + this._elements[i].remove(); + } + } + }; + + /** + * The .changed() function is called when the value of an + * element changes. + * This can be used to attach an element specific event listener. + * + * @method changed + * @param {Function|Boolean} fxn function to be fired when the value of + * an element changes. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @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) { + p5.Element._adjustListener('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|Boolean} fxn function to be fired when any user input is + * detected within the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @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) { + p5.Element._adjustListener('input', fxn, this); + return this; + }; + + /** + * Helpers for create methods. + */ + function addElement(elt, pInst, media) { + var node = pInst._userNode ? pInst._userNode : document.body; + node.appendChild(elt); + var c = media + ? new p5.MediaElement(elt, pInst) + : new p5.Element(elt, pInst); + pInst._elements.push(c); + return c; + } + + /** + * Creates a <div></div> element in the DOM with given inner HTML. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createDiv + * @param {String} [html] inner HTML for element created + * @return {p5.Element} pointer to p5.Element holding created node + * @example + *
    + * 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 {p5.Element} pointer to p5.Element holding created node + * @example + *
    + * 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 {p5.Element} pointer to p5.Element holding created node + * @example + *
    + * 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 {p5.Element} pointer to p5.Element holding created node + * @example + *
    + * createImg('http://p5js.org/img/asterisk-01.png'); + *
    + */ + /** + * @method createImg + * @param {String} src + * @param {Function} successCallback + * @return {Object|p5.Element} + */ + p5.prototype.createImg = function() { + p5._validateParameters('createImg', arguments); + var elt = document.createElement('img'); + elt.crossOrigin = 'Anonymous'; + 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 {p5.Element} pointer to p5.Element holding created node + * @example + *
    + * createA('http://p5js.org/', 'this is a link'); + *
    + */ + p5.prototype.createA = function(href, html, target) { + p5._validateParameters('createA', arguments); + 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 {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) { + p5._validateParameters('createSlider', arguments); + var elt = document.createElement('input'); + elt.type = 'range'; + elt.min = min; + elt.max = max; + if (step === 0) { + elt.step = 0.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 {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) { + p5._validateParameters('createButton', arguments); + var elt = document.createElement('button'); + elt.innerHTML = label; + 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 + * @return {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() { + p5._validateParameters('createCheckbox', arguments); + 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. + * It also helps to assign select-box methods to p5.Element when selecting existing select box + * @method createSelect + * @param {boolean} [multiple] true if dropdown should support multiple selections + * @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 is a ' + item + '!', 50, 50); + * } + *
    + */ + /** + * @method createSelect + * @param {Object} existing DOM select element + * @return {p5.Element} + */ + + p5.prototype.createSelect = function() { + p5._validateParameters('createSelect', arguments); + var elt, self; + var arg = arguments[0]; + if (typeof arg === 'object' && arg.elt.nodeName === 'SELECT') { + self = arg; + elt = this.elt = arg.elt; + } else { + elt = document.createElement('select'); + if (arg && typeof arg === 'boolean') { + elt.setAttribute('multiple', 'true'); + } + self = addElement(elt, this); + } + self.option = function(name, value) { + var index; + //see if there is already an option with this name + for (var i = 0; i < this.elt.length; i++) { + if (this.elt[i].innerHTML === name) { + index = i; + break; + } + } + //if there is an option with this name we will modify it + if (index !== undefined) { + //if the user passed in false then delete that option + if (value === false) { + this.elt.remove(index); + } else { + //otherwise if the name and value are the same then change both + if (this.elt[index].innerHTML === this.elt[index].value) { + this.elt[index].innerHTML = this.elt[index].value = value; + //otherwise just change the value + } else { + this.elt[index].value = value; + } + } + } else { + //if it doesn't exist make it + 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 = [], + i; + if (arguments.length > 0) { + for (i = 0; i < this.elt.length; i++) { + if (value.toString() === this.elt[i].value) { + this.elt.selectedIndex = i; + } + } + return this; + } else { + if (this.elt.getAttribute('multiple')) { + for (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 {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(existing_radios) { + p5._validateParameters('createRadio', arguments); + // do some prep by counting number of radios on page + 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; + } + // see if we got an existing set of radios from callee + var elt, self; + if (typeof existing_radios === 'object') { + // use existing elements + self = existing_radios; + elt = this.elt = existing_radios.elt; + } else { + // create a set of radio buttons + elt = document.createElement('div'); + self = addElement(elt, this); + } + // setup member functions + self._getInputChildrenArray = function() { + return Array.prototype.slice.call(this.elt.children).filter(function(c) { + return c.tagName === 'INPUT'; + }); + }; + + var times = -1; + self.option = function(name, value) { + var opt = document.createElement('input'); + opt.type = 'radio'; + opt.innerHTML = name; + if (value) opt.value = value; + else opt.value = name; + opt.setAttribute('name', 'defaultradio' + count); + elt.appendChild(opt); + if (name) { + times++; + 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(value) { + var i; + var inputChildren = self._getInputChildrenArray(); + if (value) { + for (i = 0; i < inputChildren.length; i++) { + if (inputChildren[i].value === value) inputChildren[i].checked = true; + } + return this; + } else { + for (i = 0; i < inputChildren.length; i++) { + if (inputChildren[i].checked === true) return inputChildren[i].value; + } + } + }; + self.value = function(value) { + var i; + var inputChildren = self._getInputChildrenArray(); + if (value) { + for (i = 0; i < inputChildren.length; i++) { + if (inputChildren[i].value === value) inputChildren[i].checked = true; + } + return this; + } else { + for (i = 0; i < inputChildren.length; i++) { + if (inputChildren[i].checked === true) return inputChildren[i].value; + } + return ''; + } + }; + return self; + }; + + /** + * Creates a colorPicker element in the DOM for color input. + * The .value() method will return a hex string (#rrggbb) of the color. + * The .color() method will return a p5.Color object with the current chosen color. + * + * @method createColorPicker + * @param {String|p5.Color} [value] default color of element + * @return {p5.Element} pointer to p5.Element holding created node + * @example + *
    + * + * var inp1, inp2; + * function setup() { + * createCanvas(100, 100); + * background('grey'); + * inp1 = createColorPicker('#ff0000'); + * inp2 = createColorPicker(color('yellow')); + * inp1.input(setShade1); + * inp2.input(setShade2); + * setMidShade(); + * } + * + * function setMidShade() { + * // Finding a shade between the two + * var commonShade = lerpColor(inp1.color(), inp2.color(), 0.5); + * fill(commonShade); + * rect(20, 20, 60, 60); + * } + * + * function setShade1() { + * setMidShade(); + * console.log('You are choosing shade 1 to be : ', this.value()); + * } + * function setShade2() { + * setMidShade(); + * console.log('You are choosing shade 2 to be : ', this.value()); + * } + * + *
    + */ + p5.prototype.createColorPicker = function(value) { + p5._validateParameters('createColorPicker', arguments); + var elt = document.createElement('input'); + var self; + elt.type = 'color'; + if (value) { + if (value instanceof p5.Color) { + elt.value = value.toString('#rrggbb'); + } else { + p5.prototype._colorMode = 'rgb'; + p5.prototype._colorMaxes = { + rgb: [255, 255, 255, 255], + hsb: [360, 100, 100, 1], + hsl: [360, 100, 100, 1] + }; + elt.value = p5.prototype.color(value).toString('#rrggbb'); + } + } else { + elt.value = '#000000'; + } + self = addElement(elt, this); + // Method to return a p5.Color object for the given color. + self.color = function() { + if (value.mode) { + p5.prototype._colorMode = value.mode; + } + if (value.maxes) { + p5.prototype._colorMaxes = value.maxes; + } + return p5.prototype.color(this.elt.value); + }; + return self; + }; + + /** + * 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 {String} [value] default value of the input box + * @param {String} [type] type of text, ie text, password etc. Defaults to text + * @return {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) { + p5._validateParameters('createInput', arguments); + 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 {p5.Element} pointer to p5.Element holding created DOM element + * @example + *
    + * let input; + * let img; + * + * function setup() { + * input = createFileInput(handleFile); + * input.position(0, 0); + * } + * + * function draw() { + * background(255); + * if (img) { + * image(img, 0, 0, width, height); + * } + * } + * + * function handleFile(file) { + * print(file); + * if (file.type === 'image') { + * img = createImg(file.data); + * img.hide(); + * } else { + * img = null; + * } + * } + *
    + */ + p5.prototype.createFileInput = function(callback, multiple) { + p5._validateParameters('createFileInput', arguments); + // 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]; + p5.File._load(f, callback); + } + } + // 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'; + } + + // 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 + src = src || ''; + if (typeof src === 'string') { + src = [src]; + } + for (var i = 0; i < src.length; i++) { + var source = document.createElement('source'); + source.src = src[i]; + elt.appendChild(source); + } + if (typeof callback !== 'undefined') { + var callbackHandler = function() { + callback(); + elt.removeEventListener('canplaythrough', callbackHandler); + }; + elt.addEventListener('canplaythrough', callbackHandler); + } + + var c = addElement(elt, pInst, true); + c.loadedmetadata = false; + // set width and height onload metadata + elt.addEventListener('loadedmetadata', function() { + c.width = elt.videoWidth; + c.height = elt.videoHeight; + //c.elt.playbackRate = s; + // set elt width and height if not set + if (c.elt.width === 0) c.elt.width = elt.videoWidth; + if (c.elt.height === 0) c.elt.height = elt.videoHeight; + if (c.presetPlaybackRate) { + c.elt.playbackRate = c.presetPlaybackRate; + delete c.presetPlaybackRate; + } + c.loadedmetadata = true; + }); + + return c; + } + /** + * Creates an HTML5 <video> element in the DOM for simple playback + * of audio/video. Shown by default, can be hidden with .hide() + * and drawn into canvas using video(). Appends to the container + * node if one is specified, otherwise appends to body. The first parameter + * can be either a single string path to a video file, or an array of string + * paths to different formats of the same video. This is useful for ensuring + * that your video can play across different browsers, as each supports + * different formats. See this + * page for further information about supported formats. + * + * @method createVideo + * @param {String|String[]} src path to a video file, or array of paths for + * supporting different browsers + * @param {Function} [callback] callback function to be called upon + * 'canplaythrough' event fire, that is, when the + * browser can play the media, and estimates that + * enough data has been loaded to play the media + * up to its end without having to stop for + * further buffering of content + * @return {p5.MediaElement} pointer to video p5.Element + * @example + *
    + * var vid; + * function setup() { + * noCanvas(); + * + * vid = createVideo( + * ['assets/small.mp4', 'assets/small.ogv', 'assets/small.webm'], + * vidLoad + * ); + * + * vid.size(100, 100); + * } + * + * // This function is called when the video loads + * function vidLoad() { + * vid.loop(); + * vid.volume(0); + * } + *
    + */ + p5.prototype.createVideo = function(src, callback) { + p5._validateParameters('createVideo', arguments); + return createMedia(this, 'video', src, callback); + }; + + /** AUDIO STUFF **/ + + /** + * Creates a hidden HTML5 <audio> element in the DOM for simple audio + * playback. Appends to the container node if one is specified, + * otherwise appends to body. The first parameter + * can be either a single string path to a audio file, or an array of string + * paths to different formats of the same audio. This is useful for ensuring + * that your audio can play across different browsers, as each supports + * different formats. See this + * page for further information about supported formats. + * + * @method createAudio + * @param {String|String[]} [src] path to an audio file, or array of paths + * for supporting different browsers + * @param {Function} [callback] callback function to be called upon + * 'canplaythrough' event fire, that is, when the + * browser can play the media, and estimates that + * enough data has been loaded to play the media + * up to its end without having to stop for + * further buffering of content + * @return {p5.MediaElement} pointer to audio p5.Element + * @example + *
    + * var ele; + * function setup() { + * ele = createAudio('assets/beat.mp3'); + * + * // here we set the element to autoplay + * // The element will play as soon + * // as it is able to do so. + * ele.autoplay(true); + * } + *
    + */ + p5.prototype.createAudio = function(src, callback) { + p5._validateParameters('createAudio', arguments); + return createMedia(this, 'audio', src, callback); + }; + + /** CAMERA STUFF **/ + + /** + * @property {String} VIDEO + * @final + * @category Constants + */ + p5.prototype.VIDEO = 'video'; + /** + * @property {String} AUDIO + * @final + * @category Constants + */ + p5.prototype.AUDIO = 'audio'; + + // from: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia + // Older browsers might not implement mediaDevices at all, so we set an empty object first + if (navigator.mediaDevices === undefined) { + navigator.mediaDevices = {}; + } + + // Some browsers partially implement mediaDevices. We can't just assign an object + // with getUserMedia as it would overwrite existing properties. + // Here, we will just add the getUserMedia property if it's missing. + if (navigator.mediaDevices.getUserMedia === undefined) { + navigator.mediaDevices.getUserMedia = function(constraints) { + // First get ahold of the legacy getUserMedia, if present + var getUserMedia = + navigator.webkitGetUserMedia || navigator.mozGetUserMedia; + + // Some browsers just don't implement it - return a rejected promise with an error + // to keep a consistent interface + if (!getUserMedia) { + return Promise.reject( + new Error('getUserMedia is not implemented in this browser') + ); + } + + // Otherwise, wrap the call to the old navigator.getUserMedia with a Promise + return new Promise(function(resolve, reject) { + getUserMedia.call(navigator, constraints, resolve, reject); + }); + }; + } + + /** + *

    Creates a new HTML5 <video> element that contains the audio/video + * feed from a webcam. The element is separate from the canvas and is + * displayed by default. The element can be hidden using .hide(). The feed + * can be drawn onto the canvas using image(). The loadedmetadata property can + * be used to detect when the element has fully loaded (see second example).

    + *

    More specific properties of the feed can be passing in a Constraints object. + * See the + * W3C + * spec for possible properties. Note that not all of these are supported + * by all browsers.

    + *

    Security note: A new browser security specification requires that getUserMedia, + * which is behind createCapture(), only works when you're running the code locally, + * or on HTTPS. Learn more here + * and here.

    + * + * @method createCapture + * @param {String|Constant|Object} type type of capture, either VIDEO or + * AUDIO if none specified, default both, + * or a Constraints object + * @param {Function} [callback] function to be called once + * stream has loaded + * @return {p5.Element} capture video p5.Element + * @example + *
    + * var capture; + * + * function setup() { + * createCanvas(480, 480); + * capture = createCapture(VIDEO); + * capture.hide(); + * } + * + * function draw() { + * image(capture, 0, 0, width, width * capture.height / capture.width); + * filter(INVERT); + * } + *
    + *
    + * function setup() { + * createCanvas(480, 120); + * var constraints = { + * video: { + * mandatory: { + * minWidth: 1280, + * minHeight: 720 + * }, + * optional: [{ maxFrameRate: 10 }] + * }, + * audio: true + * }; + * createCapture(constraints, function(stream) { + * console.log(stream); + * }); + * } + *
    + *
    + * var capture; + * + * function setup() { + * createCanvas(640, 480); + * capture = createCapture(VIDEO); + * } + * function draw() { + * background(0); + * if (capture.loadedmetadata) { + * var c = capture.get(0, 0, 100, 100); + * image(c, 0, 0); + * } + * } + *
    + */ + p5.prototype.createCapture = function() { + p5._validateParameters('createCapture', arguments); + var useVideo = true; + var useAudio = true; + var constraints; + var cb; + for (var i = 0; i < arguments.length; i++) { + if (arguments[i] === p5.prototype.VIDEO) { + useAudio = false; + } else if (arguments[i] === p5.prototype.AUDIO) { + useVideo = false; + } else if (typeof arguments[i] === 'object') { + constraints = arguments[i]; + } else if (typeof arguments[i] === 'function') { + cb = arguments[i]; + } + } + if (navigator.mediaDevices && navigator.mediaDevices.getUserMedia) { + var elt = document.createElement('video'); + // required to work in iOS 11 & up: + elt.setAttribute('playsinline', ''); + + if (!constraints) { + constraints = { video: useVideo, audio: useAudio }; + } + + navigator.mediaDevices.getUserMedia(constraints).then( + function(stream) { + try { + if ('srcObject' in elt) { + elt.srcObject = stream; + } else { + elt.src = window.URL.createObjectURL(stream); + } + } catch (err) { + elt.src = stream; + } + if (cb) { + cb(stream); + } + }, + function(e) { + console.log(e); + } + ); + } else { + throw 'getUserMedia not supported in this browser'; + } + var c = addElement(elt, this, true); + c.loadedmetadata = false; + // set width and height onload metadata + elt.addEventListener('loadedmetadata', function() { + elt.play(); + if (elt.width) { + c.width = elt.videoWidth = elt.width; + c.height = elt.videoHeight = elt.height; + } else { + c.width = c.elt.width = elt.videoWidth; + c.height = c.elt.height = elt.videoHeight; + } + c.loadedmetadata = true; + }); + return c; + }; + + /** + * Creates element with given tag in the DOM with given content. + * Appends to the container node if one is specified, otherwise + * appends to body. + * + * @method createElement + * @param {String} tag tag for the new element + * @param {String} [content] html content to be inserted into the element + * @return {p5.Element} pointer to p5.Element holding created node + * @example + *
    + * createElement('h2', 'im an h2 p5.element!'); + *
    + */ + p5.prototype.createElement = function(tag, content) { + p5._validateParameters('createElement', arguments); + var elt = document.createElement(tag); + if (typeof content !== 'undefined') { + elt.innerHTML = content; + } + return addElement(elt, this); + }; + + // ============================================================================= + // p5.Element additions + // ============================================================================= + /** + * + * Adds specified class to the element. + * + * @for p5.Element + * @method addClass + * @param {String} class name of class to add + * @chainable + * @example + *
    + * var div = createDiv('div'); + * div.addClass('myClass'); + *
    + */ + p5.Element.prototype.addClass = function(c) { + if (this.elt.className) { + if (!this.hasClass(c)) { + this.elt.className = this.elt.className + ' ' + c; + } + } else { + this.elt.className = c; + } + return this; + }; + + /** + * + * Removes specified class from the element. + * + * @method removeClass + * @param {String} class name of class to remove + * @chainable + * @example + *
    + * // In this example, a class is set when the div is created + * // and removed when mouse is pressed. This could link up + * // with a CSS style rule to toggle style properties. + * + * var div; + * + * function setup() { + * div = createDiv('div'); + * div.addClass('myClass'); + * } + * + * function mousePressed() { + * div.removeClass('myClass'); + * } + *
    + */ + p5.Element.prototype.removeClass = function(c) { + // Note: Removing a class that does not exist does NOT throw an error in classList.remove method + this.elt.classList.remove(c); + return this; + }; + + /** + * + * Checks if specified class already set to element + * + * @method hasClass + * @returns {boolean} a boolean value if element has specified class + * @param c {String} class name of class to check + * @example + *
    + * var div; + * + * function setup() { + * div = createDiv('div'); + * div.addClass('show'); + * } + * + * function mousePressed() { + * if (div.hasClass('show')) { + * div.addClass('show'); + * } else { + * div.removeClass('show'); + * } + * } + *
    + */ + p5.Element.prototype.hasClass = function(c) { + return this.elt.classList.contains(c); + }; + + /** + * + * Toggles element class + * + * @method toggleClass + * @param c {String} class name to toggle + * @chainable + * @example + *
    + * var div; + * + * function setup() { + * div = createDiv('div'); + * div.addClass('show'); + * } + * + * function mousePressed() { + * div.toggleClass('show'); + * } + *
    + */ + p5.Element.prototype.toggleClass = function(c) { + // classList also has a toggle() method, but we cannot use that yet as support is unclear. + // See https://github.com/processing/p5.js/issues/3631 + // this.elt.classList.toggle(c); + if (this.elt.classList.contains(c)) { + this.elt.classList.remove(c); + } else { + this.elt.classList.add(c); + } + return this; + }; + + /** + * + * Attaches the element as a child to the parent specified. + * Accepts either a string ID, DOM node, or p5.Element. + * If no argument is specified, an array of children DOM nodes is returned. + * + * @method child + * @returns {Node[]} an array of child nodes + * @example + *
    + * var div0 = createDiv('this is the parent'); + * var div1 = createDiv('this is the child'); + * div0.child(div1); // use p5.Element + *
    + *
    + * var div0 = createDiv('this is the parent'); + * var div1 = createDiv('this is the child'); + * div1.id('apples'); + * div0.child('apples'); // use id + *
    + *
    + * // this example assumes there is a div already on the page + * // with id "myChildDiv" + * var div0 = createDiv('this is the parent'); + * var elt = document.getElementById('myChildDiv'); + * div0.child(elt); // use element from page + *
    + */ + /** + * @method child + * @param {String|p5.Element} [child] the ID, DOM node, or p5.Element + * to add to the current element + * @chainable + */ + p5.Element.prototype.child = function(c) { + if (typeof c === 'undefined') { + return this.elt.childNodes; + } + if (typeof c === 'string') { + if (c[0] === '#') { + c = c.substring(1); + } + c = document.getElementById(c); + } else if (c instanceof p5.Element) { + c = c.elt; + } + this.elt.appendChild(c); + return this; + }; + + /** + * Centers a p5 Element either vertically, horizontally, + * or both, relative to its parent or according to + * the body if the Element has no parent. If no argument is passed + * the Element is aligned both vertically and horizontally. + * + * @method center + * @param {String} [align] passing 'vertical', 'horizontal' aligns element accordingly + * @chainable + * + * @example + *
    + * function setup() { + * var div = createDiv('').size(10, 10); + * div.style('background-color', 'orange'); + * div.center(); + * } + *
    + */ + p5.Element.prototype.center = function(align) { + var style = this.elt.style.display; + var hidden = this.elt.style.display === 'none'; + var parentHidden = this.parent().style.display === 'none'; + var pos = { x: this.elt.offsetLeft, y: this.elt.offsetTop }; + + if (hidden) this.show(); + + this.elt.style.display = 'block'; + this.position(0, 0); + + if (parentHidden) this.parent().style.display = 'block'; + + var wOffset = Math.abs(this.parent().offsetWidth - this.elt.offsetWidth); + var hOffset = Math.abs(this.parent().offsetHeight - this.elt.offsetHeight); + var y = pos.y; + var x = pos.x; + + if (align === 'both' || align === undefined) { + this.position(wOffset / 2, hOffset / 2); + } else if (align === 'horizontal') { + this.position(wOffset / 2, y); + } else if (align === 'vertical') { + this.position(x, hOffset / 2); + } + + this.style('display', style); + + if (hidden) this.hide(); + + if (parentHidden) this.parent().style.display = 'none'; + + return this; + }; + + /** + * + * If an argument is given, sets the inner HTML of the element, + * replacing any existing html. If true is included as a second + * argument, html is appended instead of replacing existing html. + * If no arguments are given, returns + * the inner HTML of the element. + * + * @for p5.Element + * @method html + * @returns {String} the inner HTML of the element + * @example + *
    + * var div = createDiv('').size(100, 100); + * div.html('hi'); + *
    + *
    + * var div = createDiv('Hello ').size(100, 100); + * div.html('World', true); + *
    + */ + /** + * @method html + * @param {String} [html] the HTML to be placed inside the element + * @param {boolean} [append] whether to append HTML to existing + * @chainable + */ + p5.Element.prototype.html = function() { + if (arguments.length === 0) { + return this.elt.innerHTML; + } else if (arguments[1]) { + this.elt.innerHTML += arguments[0]; + return this; + } else { + this.elt.innerHTML = arguments[0]; + return this; + } + }; + + /** + * + * Sets the position of the element relative to (0, 0) of the + * window. Essentially, sets position:absolute and left and top + * properties of style. If no arguments given returns the x and y position + * of the element in an object. + * + * @method position + * @returns {Object} the x and y position of the element in an object + * @example + *
    + * function setup() { + * var cnv = createCanvas(100, 100); + * // positions canvas 50px to the right and 100px + * // below upper left corner of the window + * cnv.position(50, 100); + * } + *
    + */ + /** + * @method position + * @param {Number} [x] x-position relative to upper left of window + * @param {Number} [y] y-position relative to upper left of window + * @chainable + */ + p5.Element.prototype.position = function() { + if (arguments.length === 0) { + return { x: this.elt.offsetLeft, y: this.elt.offsetTop }; + } else { + this.elt.style.position = 'absolute'; + this.elt.style.left = arguments[0] + 'px'; + this.elt.style.top = arguments[1] + 'px'; + this.x = arguments[0]; + this.y = arguments[1]; + return this; + } + }; + + /* Helper method called by p5.Element.style() */ + p5.Element.prototype._translate = function() { + this.elt.style.position = 'absolute'; + // save out initial non-translate transform styling + var transform = ''; + if (this.elt.style.transform) { + transform = this.elt.style.transform.replace(/translate3d\(.*\)/g, ''); + transform = transform.replace(/translate[X-Z]?\(.*\)/g, ''); + } + if (arguments.length === 2) { + this.elt.style.transform = + 'translate(' + arguments[0] + 'px, ' + arguments[1] + 'px)'; + } else if (arguments.length > 2) { + this.elt.style.transform = + 'translate3d(' + + arguments[0] + + 'px,' + + arguments[1] + + 'px,' + + arguments[2] + + 'px)'; + if (arguments.length === 3) { + this.elt.parentElement.style.perspective = '1000px'; + } else { + this.elt.parentElement.style.perspective = arguments[3] + 'px'; + } + } + // add any extra transform styling back on end + this.elt.style.transform += transform; + return this; + }; + + /* Helper method called by p5.Element.style() */ + p5.Element.prototype._rotate = function() { + // save out initial non-rotate transform styling + var transform = ''; + if (this.elt.style.transform) { + transform = this.elt.style.transform.replace(/rotate3d\(.*\)/g, ''); + transform = transform.replace(/rotate[X-Z]?\(.*\)/g, ''); + } + + if (arguments.length === 1) { + this.elt.style.transform = 'rotate(' + arguments[0] + 'deg)'; + } else if (arguments.length === 2) { + this.elt.style.transform = + 'rotate(' + arguments[0] + 'deg, ' + arguments[1] + 'deg)'; + } else if (arguments.length === 3) { + this.elt.style.transform = 'rotateX(' + arguments[0] + 'deg)'; + this.elt.style.transform += 'rotateY(' + arguments[1] + 'deg)'; + this.elt.style.transform += 'rotateZ(' + arguments[2] + 'deg)'; + } + // add remaining transform back on + this.elt.style.transform += transform; + return this; + }; + + /** + * Sets the given style (css) property (1st arg) of the element with the + * given value (2nd arg). If a single argument is given, .style() + * returns the value of the given property; however, if the single argument + * is given in css syntax ('text-align:center'), .style() sets the css + * appropriately. + * + * @method style + * @param {String} property property to be set + * @returns {String} value of property + * @example + *
    + * var myDiv = createDiv('I like pandas.'); + * myDiv.style('font-size', '18px'); + * myDiv.style('color', '#ff0000'); + *
    + *
    + * var col = color(25, 23, 200, 50); + * var button = createButton('button'); + * button.style('background-color', col); + * button.position(10, 10); + *
    + *
    + * var myDiv; + * function setup() { + * background(200); + * myDiv = createDiv('I like gray.'); + * myDiv.position(20, 20); + * } + * + * function draw() { + * myDiv.style('font-size', mouseX + 'px'); + * } + *
    + */ + /** + * @method style + * @param {String} property + * @param {String|Number|p5.Color} value value to assign to property + * @return {String} current value of property, if no value is given as second argument + * @chainable + */ + p5.Element.prototype.style = function(prop, val) { + var self = this; + + if (val instanceof p5.Color) { + val = + 'rgba(' + + val.levels[0] + + ',' + + val.levels[1] + + ',' + + val.levels[2] + + ',' + + val.levels[3] / 255 + + ')'; + } + + if (typeof val === 'undefined') { + // input provided as single line string + if (prop.indexOf(':') === -1) { + var styles = window.getComputedStyle(self.elt); + var style = styles.getPropertyValue(prop); + return style; + } else { + var attrs = prop.split(';'); + for (var i = 0; i < attrs.length; i++) { + var parts = attrs[i].split(':'); + if (parts[0] && parts[1]) { + this.elt.style[parts[0].trim()] = parts[1].trim(); + } + } + } + } else { + // input provided as key,val pair + this.elt.style[prop] = val; + if ( + prop === 'width' || + prop === 'height' || + prop === 'left' || + prop === 'top' + ) { + var numVal = val.replace(/\D+/g, ''); + this[prop] = parseInt(numVal, 10); + } + } + return this; + }; + + /** + * + * Adds a new attribute or changes the value of an existing attribute + * on the specified element. If no value is specified, returns the + * value of the given attribute, or null if attribute is not set. + * + * @method attribute + * @return {String} value of attribute + * + * @example + *
    + * var myDiv = createDiv('I like pandas.'); + * myDiv.attribute('align', 'center'); + *
    + */ + /** + * @method attribute + * @param {String} attr attribute to set + * @param {String} value value to assign to attribute + * @chainable + */ + p5.Element.prototype.attribute = function(attr, value) { + //handling for checkboxes and radios to ensure options get + //attributes not divs + if ( + this.elt.firstChild != null && + (this.elt.firstChild.type === 'checkbox' || + this.elt.firstChild.type === 'radio') + ) { + if (typeof value === 'undefined') { + return this.elt.firstChild.getAttribute(attr); + } else { + for (var i = 0; i < this.elt.childNodes.length; i++) { + this.elt.childNodes[i].setAttribute(attr, value); + } + } + } else if (typeof value === 'undefined') { + return this.elt.getAttribute(attr); + } else { + this.elt.setAttribute(attr, value); + return this; + } + }; + + /** + * + * Removes an attribute on the specified element. + * + * @method removeAttribute + * @param {String} attr attribute to remove + * @chainable + * + * @example + *
    + * var button; + * var checkbox; + * + * function setup() { + * checkbox = createCheckbox('enable', true); + * checkbox.changed(enableButton); + * button = createButton('button'); + * button.position(10, 10); + * } + * + * function enableButton() { + * if (this.checked()) { + * // Re-enable the button + * button.removeAttribute('disabled'); + * } else { + * // Disable the button + * button.attribute('disabled', ''); + * } + * } + *
    + */ + p5.Element.prototype.removeAttribute = function(attr) { + if ( + this.elt.firstChild != null && + (this.elt.firstChild.type === 'checkbox' || + this.elt.firstChild.type === 'radio') + ) { + for (var i = 0; i < this.elt.childNodes.length; i++) { + this.elt.childNodes[i].removeAttribute(attr); + } + } + this.elt.removeAttribute(attr); + return this; + }; + + /** + * Either returns the value of the element if no arguments + * given, or sets the value of the element. + * + * @method value + * @return {String|Number} value of the element + * @example + *
    + * // gets the value + * var inp; + * function setup() { + * inp = createInput(''); + * } + * + * function mousePressed() { + * print(inp.value()); + * } + *
    + *
    + * // sets the value + * var inp; + * function setup() { + * inp = createInput('myValue'); + * } + * + * function mousePressed() { + * inp.value('myValue'); + * } + *
    + */ + /** + * @method value + * @param {String|Number} value + * @chainable + */ + p5.Element.prototype.value = function() { + if (arguments.length > 0) { + this.elt.value = arguments[0]; + return this; + } else { + if (this.elt.type === 'range') { + return parseFloat(this.elt.value); + } else return this.elt.value; + } + }; + + /** + * + * Shows the current element. Essentially, setting display:block for the style. + * + * @method show + * @chainable + * @example + *
    + * var div = createDiv('div'); + * div.style('display', 'none'); + * div.show(); // turns display to block + *
    + */ + p5.Element.prototype.show = function() { + this.elt.style.display = 'block'; + return this; + }; + + /** + * Hides the current element. Essentially, setting display:none for the style. + * + * @method hide + * @chainable + * @example + *
    + * var div = createDiv('this is a div'); + * div.hide(); + *
    + */ + p5.Element.prototype.hide = function() { + this.elt.style.display = 'none'; + return this; + }; + + /** + * + * Sets the width and height of the element. AUTO can be used to + * only adjust one dimension at a time. If no arguments are given, it + * returns the width and height of the element in an object. In case of + * elements which need to be loaded, such as images, it is recommended + * to call the function after the element has finished loading. + * + * @method size + * @return {Object} the width and height of the element in an object + * @example + *
    + * let div = createDiv('this is a div'); + * div.size(100, 100); + * let img = createImg('assets/laDefense.jpg', () => { + * img.size(10, AUTO); + * }); + *
    + */ + /** + * @method size + * @param {Number|Constant} w width of the element, either AUTO, or a number + * @param {Number|Constant} [h] height of the element, either AUTO, or a number + * @chainable + */ + p5.Element.prototype.size = function(w, h) { + if (arguments.length === 0) { + return { width: this.elt.offsetWidth, height: this.elt.offsetHeight }; + } else { + var aW = w; + var aH = h; + var AUTO = p5.prototype.AUTO; + if (aW !== AUTO || aH !== AUTO) { + if (aW === AUTO) { + aW = h * this.width / this.height; + } else if (aH === AUTO) { + aH = w * this.height / this.width; + } + // set diff for cnv vs normal div + if (this.elt instanceof HTMLCanvasElement) { + var j = {}; + var k = this.elt.getContext('2d'); + var prop; + for (prop in k) { + j[prop] = k[prop]; + } + this.elt.setAttribute('width', aW * this._pInst._pixelDensity); + this.elt.setAttribute('height', aH * this._pInst._pixelDensity); + this.elt.style.width = aW + 'px'; + this.elt.style.height = aH + 'px'; + this._pInst.scale( + this._pInst._pixelDensity, + this._pInst._pixelDensity + ); + for (prop in j) { + this.elt.getContext('2d')[prop] = j[prop]; + } + } else { + this.elt.style.width = aW + 'px'; + this.elt.style.height = aH + 'px'; + this.elt.width = aW; + this.elt.height = aH; + } + + this.width = this.elt.offsetWidth; + this.height = this.elt.offsetHeight; + + if (this._pInst && this._pInst._curElement) { + // main canvas associated with p5 instance + if (this._pInst._curElement.elt === this.elt) { + this._pInst._setProperty('width', this.elt.offsetWidth); + this._pInst._setProperty('height', this.elt.offsetHeight); + } + } + } + return this; + } + }; + + /** + * Removes the element and deregisters all listeners. + * @method remove + * @example + *
    + * var myDiv = createDiv('this is some text'); + * myDiv.remove(); + *
    + */ + p5.Element.prototype.remove = function() { + // deregister events + for (var ev in this._events) { + this.elt.removeEventListener(ev, this._events[ev]); + } + if (this.elt.parentNode) { + this.elt.parentNode.removeChild(this.elt); + } + delete this; + }; + + /** + * Registers a callback that gets called every time a file that is + * dropped on the element has been loaded. + * p5 will load every dropped file into memory and pass it as a p5.File object to the callback. + * Multiple files dropped at the same time will result in multiple calls to the callback. + * + * You can optionally pass a second callback which will be registered to the raw + * drop event. + * The callback will thus be provided the original + * DragEvent. + * Dropping multiple files at the same time will trigger the second callback once per drop, + * whereas the first callback will trigger for each loaded file. + * + * @method drop + * @param {Function} callback callback to receive loaded file, called for each file dropped. + * @param {Function} [fxn] callback triggered once when files are dropped with the drop event. + * @chainable + * @example + *
    + * function setup() { + * var c = createCanvas(100, 100); + * background(200); + * textAlign(CENTER); + * text('drop file', width / 2, height / 2); + * c.drop(gotFile); + * } + * + * function gotFile(file) { + * background(200); + * text('received file:', width / 2, height / 2); + * text(file.name, width / 2, height / 2 + 50); + * } + *
    + * + *
    + * var img; + * + * function setup() { + * var c = createCanvas(100, 100); + * background(200); + * textAlign(CENTER); + * text('drop image', width / 2, height / 2); + * c.drop(gotFile); + * } + * + * function draw() { + * if (img) { + * image(img, 0, 0, width, height); + * } + * } + * + * function gotFile(file) { + * img = createImg(file.data).hide(); + * } + *
    + * + * @alt + * Canvas turns into whatever image is dragged/dropped onto it. + */ + p5.Element.prototype.drop = function(callback, fxn) { + // Is the file stuff supported? + if (window.File && window.FileReader && window.FileList && window.Blob) { + if (!this._dragDisabled) { + this._dragDisabled = true; + + var preventDefault = function(evt) { + evt.preventDefault(); + }; + + // If you want to be able to drop you've got to turn off + // a lot of default behavior. + // avoid `attachListener` here, since it overrides other handlers. + this.elt.addEventListener('dragover', preventDefault); + + // If this is a drag area we need to turn off the default behavior + this.elt.addEventListener('dragleave', preventDefault); + } + + // Deal with the files + p5.Element._attachListener( + 'drop', + function(evt) { + evt.preventDefault(); + // Call the second argument as a callback that receives the raw drop event + if (typeof fxn === 'function') { + fxn.call(this, evt); + } + // 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]; + p5.File._load(f, callback); + } + }, + this + ); + } else { + console.log('The File APIs are not fully supported in this browser.'); + } + + return this; + }; + + // ============================================================================= + // p5.MediaElement additions + // ============================================================================= + + /** + * Extends p5.Element to handle audio and video. In addition to the methods + * of p5.Element, it also contains methods for controlling media. It is not + * called directly, but p5.MediaElements are created by calling createVideo, + * createAudio, and createCapture. + * + * @class p5.MediaElement + * @constructor + * @param {String} elt DOM node that is wrapped + */ + p5.MediaElement = function(elt, pInst) { + p5.Element.call(this, elt, pInst); + + var self = this; + this.elt.crossOrigin = 'anonymous'; + + this._prevTime = 0; + this._cueIDCounter = 0; + this._cues = []; + this._pixelsState = this; + this._pixelDensity = 1; + this._modified = false; + this._pixelsDirty = true; + this._pixelsTime = -1; // the time at which we last updated 'pixels' + + /** + * Path to the media element source. + * + * @property src + * @return {String} src + * @example + *
    + * var ele; + * + * function setup() { + * background(250); + * + * //p5.MediaElement objects are usually created + * //by calling the createAudio(), createVideo(), + * //and createCapture() functions. + * + * //In this example we create + * //a new p5.MediaElement via createAudio(). + * ele = createAudio('assets/beat.mp3'); + * + * //We'll set up our example so that + * //when you click on the text, + * //an alert box displays the MediaElement's + * //src field. + * textAlign(CENTER); + * text('Click Me!', width / 2, height / 2); + * } + * + * function mouseClicked() { + * //here we test if the mouse is over the + * //canvas element when it's clicked + * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) { + * //Show our p5.MediaElement's src field + * alert(ele.src); + * } + * } + *
    + */ + Object.defineProperty(self, 'src', { + get: function() { + var firstChildSrc = self.elt.children[0].src; + var srcVal = self.elt.src === window.location.href ? '' : self.elt.src; + var ret = + firstChildSrc === window.location.href ? srcVal : firstChildSrc; + return ret; + }, + set: function(newValue) { + for (var i = 0; i < self.elt.children.length; i++) { + self.elt.removeChild(self.elt.children[i]); + } + var source = document.createElement('source'); + source.src = newValue; + elt.appendChild(source); + self.elt.src = newValue; + self.modified = true; + } + }); + + // private _onended callback, set by the method: onended(callback) + self._onended = function() {}; + self.elt.onended = function() { + self._onended(self); + }; + }; + p5.MediaElement.prototype = Object.create(p5.Element.prototype); + + /** + * Play an HTML5 media element. + * + * @method play + * @chainable + * @example + *
    + * var ele; + * + * function setup() { + * //p5.MediaElement objects are usually created + * //by calling the createAudio(), createVideo(), + * //and createCapture() functions. + * + * //In this example we create + * //a new p5.MediaElement via createAudio(). + * ele = createAudio('assets/beat.mp3'); + * + * background(250); + * textAlign(CENTER); + * text('Click to Play!', width / 2, height / 2); + * } + * + * function mouseClicked() { + * //here we test if the mouse is over the + * //canvas element when it's clicked + * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) { + * //Here we call the play() function on + * //the p5.MediaElement we created above. + * //This will start the audio sample. + * ele.play(); + * + * background(200); + * text('You clicked Play!', width / 2, height / 2); + * } + * } + *
    + */ + p5.MediaElement.prototype.play = function() { + if (this.elt.currentTime === this.elt.duration) { + this.elt.currentTime = 0; + } + var promise; + if (this.elt.readyState > 1) { + promise = this.elt.play(); + } else { + // in Chrome, playback cannot resume after being stopped and must reload + this.elt.load(); + promise = this.elt.play(); + } + if (promise && promise.catch) { + promise.catch(function(e) { + console.log( + 'WARN: Element play method raised an error asynchronously', + e + ); + }); + } + return this; + }; + + /** + * Stops an HTML5 media element (sets current time to zero). + * + * @method stop + * @chainable + * @example + *
    + * //This example both starts + * //and stops a sound sample + * //when the user clicks the canvas + * + * //We will store the p5.MediaElement + * //object in here + * var ele; + * + * //while our audio is playing, + * //this will be set to true + * var sampleIsPlaying = false; + * + * function setup() { + * //Here we create a p5.MediaElement object + * //using the createAudio() function. + * ele = createAudio('assets/beat.mp3'); + * background(200); + * textAlign(CENTER); + * text('Click to play!', width / 2, height / 2); + * } + * + * function mouseClicked() { + * //here we test if the mouse is over the + * //canvas element when it's clicked + * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) { + * background(200); + * + * if (sampleIsPlaying) { + * //if the sample is currently playing + * //calling the stop() function on + * //our p5.MediaElement will stop + * //it and reset its current + * //time to 0 (i.e. it will start + * //at the beginning the next time + * //you play it) + * ele.stop(); + * + * sampleIsPlaying = false; + * text('Click to play!', width / 2, height / 2); + * } else { + * //loop our sound element until we + * //call ele.stop() on it. + * ele.loop(); + * + * sampleIsPlaying = true; + * text('Click to stop!', width / 2, height / 2); + * } + * } + * } + *
    + */ + p5.MediaElement.prototype.stop = function() { + this.elt.pause(); + this.elt.currentTime = 0; + return this; + }; + + /** + * Pauses an HTML5 media element. + * + * @method pause + * @chainable + * @example + *
    + * //This example both starts + * //and pauses a sound sample + * //when the user clicks the canvas + * + * //We will store the p5.MediaElement + * //object in here + * var ele; + * + * //while our audio is playing, + * //this will be set to true + * var sampleIsPlaying = false; + * + * function setup() { + * //Here we create a p5.MediaElement object + * //using the createAudio() function. + * ele = createAudio('assets/lucky_dragons.mp3'); + * background(200); + * textAlign(CENTER); + * text('Click to play!', width / 2, height / 2); + * } + * + * function mouseClicked() { + * //here we test if the mouse is over the + * //canvas element when it's clicked + * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) { + * background(200); + * + * if (sampleIsPlaying) { + * //Calling pause() on our + * //p5.MediaElement will stop it + * //playing, but when we call the + * //loop() or play() functions + * //the sample will start from + * //where we paused it. + * ele.pause(); + * + * sampleIsPlaying = false; + * text('Click to resume!', width / 2, height / 2); + * } else { + * //loop our sound element until we + * //call ele.pause() on it. + * ele.loop(); + * + * sampleIsPlaying = true; + * text('Click to pause!', width / 2, height / 2); + * } + * } + * } + *
    + */ + p5.MediaElement.prototype.pause = function() { + this.elt.pause(); + return this; + }; + + /** + * Set 'loop' to true for an HTML5 media element, and starts playing. + * + * @method loop + * @chainable + * @example + *
    + * //Clicking the canvas will loop + * //the audio sample until the user + * //clicks again to stop it + * + * //We will store the p5.MediaElement + * //object in here + * var ele; + * + * //while our audio is playing, + * //this will be set to true + * var sampleIsLooping = false; + * + * function setup() { + * //Here we create a p5.MediaElement object + * //using the createAudio() function. + * ele = createAudio('assets/lucky_dragons.mp3'); + * background(200); + * textAlign(CENTER); + * text('Click to loop!', width / 2, height / 2); + * } + * + * function mouseClicked() { + * //here we test if the mouse is over the + * //canvas element when it's clicked + * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) { + * background(200); + * + * if (!sampleIsLooping) { + * //loop our sound element until we + * //call ele.stop() on it. + * ele.loop(); + * + * sampleIsLooping = true; + * text('Click to stop!', width / 2, height / 2); + * } else { + * ele.stop(); + * + * sampleIsLooping = false; + * text('Click to loop!', width / 2, height / 2); + * } + * } + * } + *
    + */ + p5.MediaElement.prototype.loop = function() { + this.elt.setAttribute('loop', true); + this.play(); + return this; + }; + /** + * Set 'loop' to false for an HTML5 media element. Element will stop + * when it reaches the end. + * + * @method noLoop + * @chainable + * @example + *
    + * //This example both starts + * //and stops loop of sound sample + * //when the user clicks the canvas + * + * //We will store the p5.MediaElement + * //object in here + * var ele; + * //while our audio is playing, + * //this will be set to true + * var sampleIsPlaying = false; + * + * function setup() { + * //Here we create a p5.MediaElement object + * //using the createAudio() function. + * ele = createAudio('assets/beat.mp3'); + * background(200); + * textAlign(CENTER); + * text('Click to play!', width / 2, height / 2); + * } + * + * function mouseClicked() { + * //here we test if the mouse is over the + * //canvas element when it's clicked + * if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) { + * background(200); + * + * if (sampleIsPlaying) { + * ele.noLoop(); + * text('No more Loops!', width / 2, height / 2); + * } else { + * ele.loop(); + * sampleIsPlaying = true; + * text('Click to stop looping!', width / 2, height / 2); + * } + * } + * } + *
    + * + */ + p5.MediaElement.prototype.noLoop = function() { + this.elt.setAttribute('loop', false); + return this; + }; + + /** + * Set HTML5 media element to autoplay or not. + * + * @method autoplay + * @param {Boolean} autoplay whether the element should autoplay + * @chainable + */ + p5.MediaElement.prototype.autoplay = function(val) { + this.elt.setAttribute('autoplay', val); + return this; + }; + + /** + * Sets volume for this HTML5 media element. If no argument is given, + * returns the current volume. + * + * @method volume + * @return {Number} current volume + * + * @example + *
    + * var ele; + * function setup() { + * // p5.MediaElement objects are usually created + * // by calling the createAudio(), createVideo(), + * // and createCapture() functions. + * // In this example we create + * // a new p5.MediaElement via createAudio(). + * ele = createAudio('assets/lucky_dragons.mp3'); + * background(250); + * textAlign(CENTER); + * text('Click to Play!', width / 2, height / 2); + * } + * function mouseClicked() { + * // Here we call the volume() function + * // on the sound element to set its volume + * // Volume must be between 0.0 and 1.0 + * ele.volume(0.2); + * ele.play(); + * background(200); + * text('You clicked Play!', width / 2, height / 2); + * } + *
    + *
    + * var audio; + * var counter = 0; + * + * function loaded() { + * audio.play(); + * } + * + * function setup() { + * audio = createAudio('assets/lucky_dragons.mp3', loaded); + * textAlign(CENTER); + * } + * + * function draw() { + * if (counter === 0) { + * background(0, 255, 0); + * text('volume(0.9)', width / 2, height / 2); + * } else if (counter === 1) { + * background(255, 255, 0); + * text('volume(0.5)', width / 2, height / 2); + * } else if (counter === 2) { + * background(255, 0, 0); + * text('volume(0.1)', width / 2, height / 2); + * } + * } + * + * function mousePressed() { + * counter++; + * if (counter === 0) { + * audio.volume(0.9); + * } else if (counter === 1) { + * audio.volume(0.5); + * } else if (counter === 2) { + * audio.volume(0.1); + * } else { + * counter = 0; + * audio.volume(0.9); + * } + * } + * + *
    + */ + /** + * @method volume + * @param {Number} val volume between 0.0 and 1.0 + * @chainable + */ + p5.MediaElement.prototype.volume = function(val) { + if (typeof val === 'undefined') { + return this.elt.volume; + } else { + this.elt.volume = val; + } + }; + + /** + * If no arguments are given, returns the current playback speed of the + * element. The speed parameter sets the speed where 2.0 will play the + * element twice as fast, 0.5 will play at half the speed, and -1 will play + * the element in normal speed in reverse.(Note that not all browsers support + * backward playback and even if they do, playback might not be smooth.) + * + * @method speed + * @return {Number} current playback speed of the element + * + * @example + *
    + * //Clicking the canvas will loop + * //the audio sample until the user + * //clicks again to stop it + * + * //We will store the p5.MediaElement + * //object in here + * var ele; + * var button; + * + * function setup() { + * createCanvas(710, 400); + * //Here we create a p5.MediaElement object + * //using the createAudio() function. + * ele = createAudio('assets/beat.mp3'); + * ele.loop(); + * background(200); + * + * button = createButton('2x speed'); + * button.position(100, 68); + * button.mousePressed(twice_speed); + * + * button = createButton('half speed'); + * button.position(200, 68); + * button.mousePressed(half_speed); + * + * button = createButton('reverse play'); + * button.position(300, 68); + * button.mousePressed(reverse_speed); + * + * button = createButton('STOP'); + * button.position(400, 68); + * button.mousePressed(stop_song); + * + * button = createButton('PLAY!'); + * button.position(500, 68); + * button.mousePressed(play_speed); + * } + * + * function twice_speed() { + * ele.speed(2); + * } + * + * function half_speed() { + * ele.speed(0.5); + * } + * + * function reverse_speed() { + * ele.speed(-1); + * } + * + * function stop_song() { + * ele.stop(); + * } + * + * function play_speed() { + * ele.play(); + * } + *
    + */ + /** + * @method speed + * @param {Number} speed speed multiplier for element playback + * @chainable + */ + p5.MediaElement.prototype.speed = function(val) { + if (typeof val === 'undefined') { + return this.presetPlaybackRate || this.elt.playbackRate; + } else { + if (this.loadedmetadata) { + this.elt.playbackRate = val; + } else { + this.presetPlaybackRate = val; + } + } + }; + + /** + * If no arguments are given, returns the current time of the element. + * If an argument is given the current time of the element is set to it. + * + * @method time + * @return {Number} current time (in seconds) + * + * @example + *
    + * var ele; + * var beginning = true; + * function setup() { + * //p5.MediaElement objects are usually created + * //by calling the createAudio(), createVideo(), + * //and createCapture() functions. + * + * //In this example we create + * //a new p5.MediaElement via createAudio(). + * ele = createAudio('assets/lucky_dragons.mp3'); + * background(250); + * textAlign(CENTER); + * text('start at beginning', width / 2, height / 2); + * } + * + * // this function fires with click anywhere + * function mousePressed() { + * if (beginning === true) { + * // here we start the sound at the beginning + * // time(0) is not necessary here + * // as this produces the same result as + * // play() + * ele.play().time(0); + * background(200); + * text('jump 2 sec in', width / 2, height / 2); + * beginning = false; + * } else { + * // here we jump 2 seconds into the sound + * ele.play().time(2); + * background(250); + * text('start at beginning', width / 2, height / 2); + * beginning = true; + * } + * } + *
    + */ + /** + * @method time + * @param {Number} time time to jump to (in seconds) + * @chainable + */ + p5.MediaElement.prototype.time = function(val) { + if (typeof val === 'undefined') { + return this.elt.currentTime; + } else { + this.elt.currentTime = val; + return this; + } + }; + + /** + * Returns the duration of the HTML5 media element. + * + * @method duration + * @return {Number} duration + * + * @example + *
    + * var ele; + * function setup() { + * //p5.MediaElement objects are usually created + * //by calling the createAudio(), createVideo(), + * //and createCapture() functions. + * //In this example we create + * //a new p5.MediaElement via createAudio(). + * ele = createAudio('assets/doorbell.mp3'); + * background(250); + * textAlign(CENTER); + * text('Click to know the duration!', 10, 25, 70, 80); + * } + * function mouseClicked() { + * ele.play(); + * background(200); + * //ele.duration dislpays the duration + * text(ele.duration() + ' seconds', width / 2, height / 2); + * } + *
    + */ + p5.MediaElement.prototype.duration = function() { + return this.elt.duration; + }; + p5.MediaElement.prototype.pixels = []; + p5.MediaElement.prototype._ensureCanvas = function() { + if (!this.canvas) this.loadPixels(); + }; + p5.MediaElement.prototype.loadPixels = function() { + if (!this.canvas) { + this.canvas = document.createElement('canvas'); + this.drawingContext = this.canvas.getContext('2d'); + } + if (this.loadedmetadata) { + // wait for metadata for w/h + if (this.canvas.width !== this.elt.width) { + this.canvas.width = this.elt.width; + this.canvas.height = this.elt.height; + this.width = this.canvas.width; + this.height = this.canvas.height; + this._pixelsDirty = true; + } + + var currentTime = this.elt.currentTime; + if (this._pixelsDirty || this._pixelsTime !== currentTime) { + // only update the pixels array if it's dirty, or + // if the video time has changed. + this._pixelsTime = currentTime; + this._pixelsDirty = true; + + this.drawingContext.drawImage( + this.elt, + 0, + 0, + this.canvas.width, + this.canvas.height + ); + p5.Renderer2D.prototype.loadPixels.call(this); + } + } + this.setModified(true); + return this; + }; + p5.MediaElement.prototype.updatePixels = function(x, y, w, h) { + if (this.loadedmetadata) { + // wait for metadata + this._ensureCanvas(); + p5.Renderer2D.prototype.updatePixels.call(this, x, y, w, h); + } + this.setModified(true); + return this; + }; + p5.MediaElement.prototype.get = function() { + this._ensureCanvas(); + return p5.Renderer2D.prototype.get.apply(this, arguments); + }; + p5.MediaElement.prototype._getPixel = function() { + if (this.loadedmetadata) { + // wait for metadata + var currentTime = this.elt.currentTime; + if (this._pixelsTime !== currentTime) { + this.loadPixels(); + } else { + this._ensureCanvas(); + } + } + return p5.Renderer2D.prototype._getPixel.apply(this, arguments); + }; + + p5.MediaElement.prototype.set = function(x, y, imgOrCol) { + if (this.loadedmetadata) { + // wait for metadata + this._ensureCanvas(); + p5.Renderer2D.prototype.set.call(this, x, y, imgOrCol); + this.setModified(true); + } + }; + p5.MediaElement.prototype.copy = function() { + this._ensureCanvas(); + p5.Renderer2D.prototype.copy.apply(this, arguments); + }; + p5.MediaElement.prototype.mask = function() { + this.loadPixels(); + this.setModified(true); + p5.Image.prototype.mask.apply(this, arguments); + }; + /** + * helper method for web GL mode to figure out if the element + * has been modified and might need to be re-uploaded to texture + * memory between frames. + * @method isModified + * @private + * @return {boolean} a boolean indicating whether or not the + * image has been updated or modified since last texture upload. + */ + p5.MediaElement.prototype.isModified = function() { + return this._modified; + }; + /** + * helper method for web GL mode to indicate that an element has been + * changed or unchanged since last upload. gl texture upload will + * set this value to false after uploading the texture; or might set + * it to true if metadata has become available but there is no actual + * texture data available yet.. + * @method setModified + * @param {boolean} val sets whether or not the element has been + * modified. + * @private + */ + p5.MediaElement.prototype.setModified = function(value) { + this._modified = value; + }; + /** + * Schedule an event to be called when the audio or video + * element reaches the end. If the element is looping, + * this will not be called. The element is passed in + * as the argument to the onended callback. + * + * @method onended + * @param {Function} callback function to call when the + * soundfile has ended. The + * media element will be passed + * in as the argument to the + * callback. + * @chainable + * @example + *
    + * function setup() { + * var audioEl = createAudio('assets/beat.mp3'); + * audioEl.showControls(); + * audioEl.onended(sayDone); + * } + * + * function sayDone(elt) { + * alert('done playing ' + elt.src); + * } + *
    + */ + p5.MediaElement.prototype.onended = function(callback) { + this._onended = callback; + return this; + }; + + /*** CONNECT TO WEB AUDIO API / p5.sound.js ***/ + + /** + * Send the audio output of this element to a specified audioNode or + * p5.sound object. If no element is provided, connects to p5's master + * output. That connection is established when this method is first called. + * All connections are removed by the .disconnect() method. + * + * This method is meant to be used with the p5.sound.js addon library. + * + * @method connect + * @param {AudioNode|Object} audioNode AudioNode from the Web Audio API, + * or an object from the p5.sound library + */ + p5.MediaElement.prototype.connect = function(obj) { + var audioContext, masterOutput; + + // if p5.sound exists, same audio context + if (typeof p5.prototype.getAudioContext === 'function') { + audioContext = p5.prototype.getAudioContext(); + masterOutput = p5.soundOut.input; + } else { + try { + audioContext = obj.context; + masterOutput = audioContext.destination; + } catch (e) { + throw 'connect() is meant to be used with Web Audio API or p5.sound.js'; + } + } + + // create a Web Audio MediaElementAudioSourceNode if none already exists + if (!this.audioSourceNode) { + this.audioSourceNode = audioContext.createMediaElementSource(this.elt); + + // connect to master output when this method is first called + this.audioSourceNode.connect(masterOutput); + } + + // connect to object if provided + if (obj) { + if (obj.input) { + this.audioSourceNode.connect(obj.input); + } else { + this.audioSourceNode.connect(obj); + } + } else { + // otherwise connect to master output of p5.sound / AudioContext + this.audioSourceNode.connect(masterOutput); + } + }; + + /** + * Disconnect all Web Audio routing, including to master output. + * This is useful if you want to re-route the output through + * audio effects, for example. + * + * @method disconnect + */ + p5.MediaElement.prototype.disconnect = function() { + if (this.audioSourceNode) { + this.audioSourceNode.disconnect(); + } else { + throw 'nothing to disconnect'; + } + }; + + /*** SHOW / HIDE CONTROLS ***/ + + /** + * Show the default MediaElement controls, as determined by the web browser. + * + * @method showControls + * @example + *
    + * var ele; + * function setup() { + * //p5.MediaElement objects are usually created + * //by calling the createAudio(), createVideo(), + * //and createCapture() functions. + * //In this example we create + * //a new p5.MediaElement via createAudio() + * ele = createAudio('assets/lucky_dragons.mp3'); + * background(200); + * textAlign(CENTER); + * text('Click to Show Controls!', 10, 25, 70, 80); + * } + * function mousePressed() { + * ele.showControls(); + * background(200); + * text('Controls Shown', width / 2, height / 2); + * } + *
    + */ + p5.MediaElement.prototype.showControls = function() { + // must set style for the element to show on the page + this.elt.style['text-align'] = 'inherit'; + this.elt.controls = true; + }; + + /** + * Hide the default mediaElement controls. + * @method hideControls + * @example + *
    + * var ele; + * function setup() { + * //p5.MediaElement objects are usually created + * //by calling the createAudio(), createVideo(), + * //and createCapture() functions. + * //In this example we create + * //a new p5.MediaElement via createAudio() + * ele = createAudio('assets/lucky_dragons.mp3'); + * ele.showControls(); + * background(200); + * textAlign(CENTER); + * text('Click to hide Controls!', 10, 25, 70, 80); + * } + * function mousePressed() { + * ele.hideControls(); + * background(200); + * text('Controls hidden', width / 2, height / 2); + * } + *
    + */ + p5.MediaElement.prototype.hideControls = function() { + this.elt.controls = false; + }; + + /*** SCHEDULE EVENTS ***/ + + // Cue inspired by JavaScript setTimeout, and the + // Tone.js Transport Timeline Event, MIT License Yotam Mann 2015 tonejs.org + var Cue = function(callback, time, id, val) { + this.callback = callback; + this.time = time; + this.id = id; + this.val = val; + }; + + /** + * Schedule events to trigger every time a MediaElement + * (audio/video) reaches a playback cue point. + * + * 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() { + * noCanvas(); + * + * var audioEl = createAudio('assets/beat.mp3'); + * audioEl.showControls(); + * + * // schedule three calls to changeBackground + * audioEl.addCue(0.5, changeBackground, color(255, 0, 0)); + * audioEl.addCue(1.0, changeBackground, color(0, 255, 0)); + * audioEl.addCue(2.5, changeBackground, color(0, 0, 255)); + * audioEl.addCue(3.0, changeBackground, color(0, 255, 255)); + * audioEl.addCue(4.2, changeBackground, color(255, 255, 0)); + * audioEl.addCue(5.0, changeBackground, color(255, 255, 0)); + * } + * + * function changeBackground(val) { + * background(val); + * } + *
    + */ + p5.MediaElement.prototype.addCue = function(time, callback, val) { + var id = this._cueIDCounter++; + + 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 + * @example + *
    + * var audioEl, id1, id2; + * function setup() { + * background(255, 255, 255); + * audioEl = createAudio('assets/beat.mp3'); + * audioEl.showControls(); + * // schedule five calls to changeBackground + * id1 = audioEl.addCue(0.5, changeBackground, color(255, 0, 0)); + * audioEl.addCue(1.0, changeBackground, color(0, 255, 0)); + * audioEl.addCue(2.5, changeBackground, color(0, 0, 255)); + * audioEl.addCue(3.0, changeBackground, color(0, 255, 255)); + * id2 = audioEl.addCue(4.2, changeBackground, color(255, 255, 0)); + * text('Click to remove first and last Cue!', 10, 25, 70, 80); + * } + * function mousePressed() { + * audioEl.removeCue(id1); + * audioEl.removeCue(id2); + * } + * function changeBackground(val) { + * background(val); + * } + *
    + */ + p5.MediaElement.prototype.removeCue = function(id) { + for (var i = 0; i < this._cues.length; i++) { + if (this._cues[i].id === id) { + console.log(id); + this._cues.splice(i, 1); + } + } + + if (this._cues.length === 0) { + this.elt.ontimeupdate = null; + } + }; + + /** + * Remove all of the callbacks that had originally been scheduled + * via the addCue method. + * @method clearCues + * @param {Number} id ID of the cue, as returned by addCue + * @example + *
    + * var audioEl; + * function setup() { + * background(255, 255, 255); + * audioEl = createAudio('assets/beat.mp3'); + * //Show the default MediaElement controls, as determined by the web browser + * audioEl.showControls(); + * // schedule calls to changeBackground + * background(200); + * text('Click to change Cue!', 10, 25, 70, 80); + * audioEl.addCue(0.5, changeBackground, color(255, 0, 0)); + * audioEl.addCue(1.0, changeBackground, color(0, 255, 0)); + * audioEl.addCue(2.5, changeBackground, color(0, 0, 255)); + * audioEl.addCue(3.0, changeBackground, color(0, 255, 255)); + * audioEl.addCue(4.2, changeBackground, color(255, 255, 0)); + * } + * function mousePressed() { + * // here we clear the scheduled callbacks + * audioEl.clearCues(); + * // then we add some more callbacks + * audioEl.addCue(1, changeBackground, color(2, 2, 2)); + * audioEl.addCue(3, changeBackground, color(255, 255, 0)); + * } + * function changeBackground(val) { + * background(val); + * } + *
    + */ + p5.MediaElement.prototype.clearCues = function() { + this._cues = []; + this.elt.ontimeupdate = null; + }; + + // private method that checks for cues to be fired if events + // have been scheduled using addCue(callback, time). + p5.MediaElement.prototype._onTimeUpdate = function() { + var playbackTime = this.time(); + + for (var i = 0; i < this._cues.length; i++) { + var callbackTime = this._cues[i].time; + var val = this._cues[i].val; + + if (this._prevTime < callbackTime && callbackTime <= playbackTime) { + // pass the scheduled callbackTime as parameter to the callback + this._cues[i].callback(val); + } + } + + this._prevTime = playbackTime; + }; + + /** + * Base class for a file. + * Used for Element.drop and createFileInput. + * + * @class p5.File + * @constructor + * @param {File} file File that is wrapped + */ + p5.File = function(file, pInst) { + /** + * Underlying File object. All normal File methods can be called on this. + * + * @property file + */ + this.file = file; + + this._pInst = pInst; + + // Splitting out the file type into two components + // This makes determining if image or text etc simpler + var typeList = file.type.split('/'); + /** + * File type (image, text, etc.) + * + * @property type + */ + this.type = typeList[0]; + /** + * File subtype (usually the file extension jpg, png, xml, etc.) + * + * @property subtype + */ + this.subtype = typeList[1]; + /** + * File name + * + * @property name + */ + this.name = file.name; + /** + * File size + * + * @property size + */ + this.size = file.size; + + /** + * URL string containing image data. + * + * @property data + */ + this.data = undefined; + }; + + p5.File._createLoader = function(theFile, callback) { + var reader = new FileReader(); + reader.onload = function(e) { + var p5file = new p5.File(theFile); + p5file.data = e.target.result; + callback(p5file); + }; + return reader; + }; + + p5.File._load = function(f, callback) { + // Text or data? + // This should likely be improved + if (/^text\//.test(f.type)) { + p5.File._createLoader(f, callback).readAsText(f); + } else if (!/^(video|audio)\//.test(f.type)) { + p5.File._createLoader(f, callback).readAsDataURL(f); + } else { + var file = new p5.File(f); + file.data = URL.createObjectURL(f); + callback(file); + } + }; +}); diff --git a/p5/addons/p5.dom.min.js b/p5/addons/p5.dom.min.js new file mode 100644 index 0000000..27d2e53 --- /dev/null +++ b/p5/addons/p5.dom.min.js @@ -0,0 +1,3 @@ +/*! p5.js v0.8.0 April 08, 2019 */ + +!function(t,e){"function"==typeof define&&define.amd?define("p5.dom",["p5"],function(t){e(t)}):"object"==typeof exports?e(require("../p5")):e(t.p5)}(this,function(d){function l(t){var e=document;return"string"==typeof t&&"#"===t[0]?(t=t.slice(1),e=document.getElementById(t)||document):t instanceof d.Element?e=t.elt:t instanceof HTMLElement&&(e=t),e}function c(t, e, i){(e._userNode?e._userNode:document.body).appendChild(t);var n=i?new d.MediaElement(t,e):new d.Element(t,e);return e._elements.push(n),n}d.prototype.select=function(t, e){d._validateParameters("select",arguments);var i=null,n=l(e);return(i="."===t[0]?(t=t.slice(1),(i=n.getElementsByClassName(t)).length?i[0]:null):"#"===t[0]?(t=t.slice(1),n.getElementById(t)):(i=n.getElementsByTagName(t)).length?i[0]:null)?this._wrapElement(i):null},d.prototype.selectAll=function(t,e){d._validateParameters("selectAll",arguments);var i,n=[],r=l(e);if(i="."===t[0]?(t=t.slice(1),r.getElementsByClassName(t)):r.getElementsByTagName(t))for(var o=0;oWeb 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.Envelope: 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 + * https://p5js.org/reference/#/libraries/p5.sound + * + * From the Processing Foundation and contributors + * https://github.com/processing/p5.js-sound/graphs/contributors + * + * MIT License (MIT) + * https://github.com/processing/p5.js-sound/blob/master/LICENSE + * + * Some of the many audio libraries & resources that inspire p5.sound: + * - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js + * - buzz.js (c) Jay Salvat. 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/ + */ + +(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) { + +var shims; +'use strict'; /** + * This module has shims + */ +shims = function () { + /* 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 () { + 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 = window.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.createJavaScriptNode; + 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 = window.webkitOfflineAudioContext; + } + }(window)); + // <-- end MonkeyPatch. + // 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': + case 'm4a': + case 'mp4': + return isAACSupported(); + case 'aif': + case 'aiff': + return isAIFSupported(); + default: + return false; + } + }; +}(); +var StartAudioContext; +(function (root, factory) { + if (true) { + StartAudioContext = function () { + return factory(); + }(); + } else if (typeof module === 'object' && module.exports) { + module.exports = factory(); + } else { + root.StartAudioContext = factory(); + } +}(this, function () { + var TapListener = function (element, context) { + this._dragged = false; + this._element = element; + this._bindedMove = this._moved.bind(this); + this._bindedEnd = this._ended.bind(this, context); + element.addEventListener('touchstart', this._bindedEnd); + element.addEventListener('touchmove', this._bindedMove); + element.addEventListener('touchend', this._bindedEnd); + element.addEventListener('mouseup', this._bindedEnd); + }; + TapListener.prototype._moved = function (e) { + this._dragged = true; + }; + TapListener.prototype._ended = function (context) { + if (!this._dragged) { + startContext(context); + } + this._dragged = false; + }; + TapListener.prototype.dispose = function () { + this._element.removeEventListener('touchstart', this._bindedEnd); + this._element.removeEventListener('touchmove', this._bindedMove); + this._element.removeEventListener('touchend', this._bindedEnd); + this._element.removeEventListener('mouseup', this._bindedEnd); + this._bindedMove = null; + this._bindedEnd = null; + this._element = null; + }; + function startContext(context) { + var buffer = context.createBuffer(1, 1, context.sampleRate); + var source = context.createBufferSource(); + source.buffer = buffer; + source.connect(context.destination); + source.start(0); + if (context.resume) { + context.resume(); + } + } + function isStarted(context) { + return context.state === 'running'; + } + function onStarted(context, callback) { + function checkLoop() { + if (isStarted(context)) { + callback(); + } else { + requestAnimationFrame(checkLoop); + if (context.resume) { + context.resume(); + } + } + } + if (isStarted(context)) { + callback(); + } else { + checkLoop(); + } + } + function bindTapListener(element, tapListeners, context) { + if (Array.isArray(element) || NodeList && element instanceof NodeList) { + for (var i = 0; i < element.length; i++) { + bindTapListener(element[i], tapListeners, context); + } + } else if (typeof element === 'string') { + bindTapListener(document.querySelectorAll(element), tapListeners, context); + } else if (element.jquery && typeof element.toArray === 'function') { + bindTapListener(element.toArray(), tapListeners, context); + } else if (Element && element instanceof Element) { + var tap = new TapListener(element, context); + tapListeners.push(tap); + } + } + function StartAudioContext(context, elements, callback) { + var promise = new Promise(function (success) { + onStarted(context, success); + }); + var tapListeners = []; + if (!elements) { + elements = document.body; + } + bindTapListener(elements, tapListeners, context); + promise.then(function () { + for (var i = 0; i < tapListeners.length; i++) { + tapListeners[i].dispose(); + } + tapListeners = null; + if (callback) { + callback(); + } + }); + return promise; + } + return StartAudioContext; +})); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Tone; +Tone_core_Tone = function () { + 'use strict'; + var Tone = function (inputs, outputs) { + if (this.isUndef(inputs) || inputs === 1) { + this.input = this.context.createGain(); + } else if (inputs > 1) { + this.input = new Array(inputs); + } + if (this.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; + } + paramLoop: + 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]]; + if (parent instanceof Tone) { + attrSplit.splice(0, i + 1); + var innerParam = attrSplit.join('.'); + parent.set(innerParam, value); + continue paramLoop; + } + } + attr = attrSplit[attrSplit.length - 1]; + } + var param = parent[attr]; + if (this.isUndef(param)) { + continue; + } + if (Tone.Signal && param instanceof Tone.Signal || Tone.Param && param instanceof Tone.Param) { + if (param.value !== value) { + if (this.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 (this.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 (!this.isFunction(param) && !this.isUndef(param)) { + subRet[attr] = param; + } + } + return ret; + }; + Tone.prototype._collectDefaults = function (constr) { + var ret = []; + if (!this.isUndef(constr.defaults)) { + ret = Object.keys(constr.defaults); + } + if (!this.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 (this.isFunction(Tone[className]) && isLetter && sameConstructor) { + return className; + } + } + return 'Tone'; + }; + Object.defineProperty(Tone.prototype, 'numberOfInputs', { + get: function () { + if (this.input) { + if (this.isArray(this.input)) { + return this.input.length; + } else { + return 1; + } + } else { + return 0; + } + } + }); + Object.defineProperty(Tone.prototype, 'numberOfOutputs', { + get: function () { + if (this.output) { + if (this.isArray(this.output)) { + return this.output.length; + } else { + return 1; + } + } else { + return 0; + } + } + }); + 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; + }; + 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 (destination, outputNum, inputNum) { + if (this.isArray(this.output)) { + if (this.isNumber(destination)) { + this.output[destination].disconnect(); + } else { + outputNum = this.defaultArg(outputNum, 0); + this.output[outputNum].disconnect(destination, 0, inputNum); + } + } else { + this.output.disconnect.apply(this.output, arguments); + } + }; + 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.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 this.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 = function (val) { + return typeof val === 'undefined'; + }; + Tone.prototype.isFunction = function (val) { + return typeof val === 'function'; + }; + 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.intervalToFrequencyRatio = function (interval) { + return Math.pow(2, interval / 12); + }; + Tone.prototype.now = function () { + return Tone.context.now(); + }; + Tone.now = function () { + return Tone.context.now(); + }; + Tone.extend = function (child, parent) { + if (Tone.prototype.isUndef(parent)) { + parent = Tone; + } + function TempConstructor() { + } + TempConstructor.prototype = parent.prototype; + child.prototype = new TempConstructor(); + child.prototype.constructor = child; + child._super = parent; + }; + var audioContext; + Object.defineProperty(Tone, 'context', { + get: function () { + return audioContext; + }, + set: function (context) { + if (Tone.Context && context instanceof Tone.Context) { + audioContext = context; + } else { + audioContext = new Tone.Context(context); + } + if (Tone.Context) { + Tone.Context.emit('init', audioContext); + } + } + }); + Object.defineProperty(Tone.prototype, 'context', { + get: function () { + return Tone.context; + } + }); + Tone.setContext = function (ctx) { + Tone.context = ctx; + }; + Object.defineProperty(Tone.prototype, 'blockTime', { + get: function () { + return 128 / this.context.sampleRate; + } + }); + Object.defineProperty(Tone.prototype, 'sampleTime', { + get: function () { + return 1 / this.context.sampleRate; + } + }); + Object.defineProperty(Tone, 'supported', { + get: function () { + var hasAudioContext = window.hasOwnProperty('AudioContext') || window.hasOwnProperty('webkitAudioContext'); + var hasPromises = window.hasOwnProperty('Promise'); + var hasWorkers = window.hasOwnProperty('Worker'); + return hasAudioContext && hasPromises && hasWorkers; + } + }); + Tone.version = 'r10'; + if (!window.TONE_SILENCE_VERSION_LOGGING) { + } + return Tone; +}(); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Emitter; +Tone_core_Emitter = function (Tone) { + 'use strict'; + Tone.Emitter = function () { + this._events = {}; + }; + Tone.extend(Tone.Emitter); + Tone.Emitter.prototype.on = function (event, callback) { + var events = event.split(/\W+/); + for (var i = 0; i < events.length; i++) { + var eventName = events[i]; + if (!this._events.hasOwnProperty(eventName)) { + this._events[eventName] = []; + } + this._events[eventName].push(callback); + } + return this; + }; + Tone.Emitter.prototype.off = function (event, callback) { + var events = event.split(/\W+/); + for (var ev = 0; ev < events.length; ev++) { + event = events[ev]; + if (this._events.hasOwnProperty(event)) { + if (Tone.prototype.isUndef(callback)) { + this._events[event] = []; + } else { + var eventList = this._events[event]; + for (var i = 0; i < eventList.length; i++) { + if (eventList[i] === callback) { + eventList.splice(i, 1); + } + } + } + } + } + return this; + }; + Tone.Emitter.prototype.emit = function (event) { + if (this._events) { + var args = Array.apply(null, arguments).slice(1); + if (this._events.hasOwnProperty(event)) { + var eventList = this._events[event]; + for (var i = 0, len = eventList.length; i < len; i++) { + eventList[i].apply(this, args); + } + } + } + return this; + }; + Tone.Emitter.mixin = function (object) { + var functions = [ + 'on', + 'off', + 'emit' + ]; + object._events = {}; + for (var i = 0; i < functions.length; i++) { + var func = functions[i]; + var emitterFunc = Tone.Emitter.prototype[func]; + object[func] = emitterFunc; + } + }; + Tone.Emitter.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._events = null; + return this; + }; + return Tone.Emitter; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_core_Context; +Tone_core_Context = function (Tone) { + if (!window.hasOwnProperty('AudioContext') && window.hasOwnProperty('webkitAudioContext')) { + window.AudioContext = window.webkitAudioContext; + } + Tone.Context = function (context) { + Tone.Emitter.call(this); + if (!context) { + context = new window.AudioContext(); + } + this._context = context; + for (var prop in this._context) { + this._defineProperty(this._context, prop); + } + this._latencyHint = 'interactive'; + this._lookAhead = 0.1; + this._updateInterval = this._lookAhead / 3; + this._computedUpdateInterval = 0; + this._worker = this._createWorker(); + this._constants = {}; + }; + Tone.extend(Tone.Context, Tone.Emitter); + Tone.Emitter.mixin(Tone.Context); + Tone.Context.prototype._defineProperty = function (context, prop) { + if (this.isUndef(this[prop])) { + Object.defineProperty(this, prop, { + get: function () { + if (typeof context[prop] === 'function') { + return context[prop].bind(context); + } else { + return context[prop]; + } + }, + set: function (val) { + context[prop] = val; + } + }); + } + }; + Tone.Context.prototype.now = function () { + return this._context.currentTime; + }; + Tone.Context.prototype._createWorker = function () { + window.URL = window.URL || window.webkitURL; + var blob = new Blob(['var timeoutTime = ' + (this._updateInterval * 1000).toFixed(1) + ';' + 'self.onmessage = function(msg){' + '\ttimeoutTime = parseInt(msg.data);' + '};' + 'function tick(){' + '\tsetTimeout(tick, timeoutTime);' + '\tself.postMessage(\'tick\');' + '}' + 'tick();']); + var blobUrl = URL.createObjectURL(blob); + var worker = new Worker(blobUrl); + worker.addEventListener('message', function () { + this.emit('tick'); + }.bind(this)); + worker.addEventListener('message', function () { + var now = this.now(); + if (this.isNumber(this._lastUpdate)) { + var diff = now - this._lastUpdate; + this._computedUpdateInterval = Math.max(diff, this._computedUpdateInterval * 0.97); + } + this._lastUpdate = now; + }.bind(this)); + return worker; + }; + Tone.Context.prototype.getConstant = function (val) { + if (this._constants[val]) { + return this._constants[val]; + } else { + var buffer = this._context.createBuffer(1, 128, this._context.sampleRate); + var arr = buffer.getChannelData(0); + for (var i = 0; i < arr.length; i++) { + arr[i] = val; + } + var constant = this._context.createBufferSource(); + constant.channelCount = 1; + constant.channelCountMode = 'explicit'; + constant.buffer = buffer; + constant.loop = true; + constant.start(0); + this._constants[val] = constant; + return constant; + } + }; + Object.defineProperty(Tone.Context.prototype, 'lag', { + get: function () { + var diff = this._computedUpdateInterval - this._updateInterval; + diff = Math.max(diff, 0); + return diff; + } + }); + Object.defineProperty(Tone.Context.prototype, 'lookAhead', { + get: function () { + return this._lookAhead; + }, + set: function (lA) { + this._lookAhead = lA; + } + }); + Object.defineProperty(Tone.Context.prototype, 'updateInterval', { + get: function () { + return this._updateInterval; + }, + set: function (interval) { + this._updateInterval = Math.max(interval, Tone.prototype.blockTime); + this._worker.postMessage(Math.max(interval * 1000, 1)); + } + }); + Object.defineProperty(Tone.Context.prototype, 'latencyHint', { + get: function () { + return this._latencyHint; + }, + set: function (hint) { + var lookAhead = hint; + this._latencyHint = hint; + if (this.isString(hint)) { + switch (hint) { + case 'interactive': + lookAhead = 0.1; + this._context.latencyHint = hint; + break; + case 'playback': + lookAhead = 0.8; + this._context.latencyHint = hint; + break; + case 'balanced': + lookAhead = 0.25; + this._context.latencyHint = hint; + break; + case 'fastest': + lookAhead = 0.01; + break; + } + } + this.lookAhead = lookAhead; + this.updateInterval = lookAhead / 3; + } + }); + function shimConnect() { + var nativeConnect = AudioNode.prototype.connect; + var nativeDisconnect = AudioNode.prototype.disconnect; + function toneConnect(B, outNum, inNum) { + if (B.input) { + if (Array.isArray(B.input)) { + if (Tone.prototype.isUndef(inNum)) { + inNum = 0; + } + this.connect(B.input[inNum]); + } else { + this.connect(B.input, outNum, inNum); + } + } else { + try { + if (B instanceof AudioNode) { + nativeConnect.call(this, B, outNum, inNum); + } else { + nativeConnect.call(this, B, outNum); + } + } catch (e) { + throw new Error('error connecting to node: ' + B + '\n' + e); + } + } + } + function toneDisconnect(B, outNum, inNum) { + if (B && B.input && Array.isArray(B.input)) { + if (Tone.prototype.isUndef(inNum)) { + inNum = 0; + } + this.disconnect(B.input[inNum], outNum, inNum); + } else if (B && B.input) { + this.disconnect(B.input, outNum, inNum); + } else { + try { + nativeDisconnect.apply(this, arguments); + } catch (e) { + throw new Error('error disconnecting node: ' + B + '\n' + e); + } + } + } + if (AudioNode.prototype.connect !== toneConnect) { + AudioNode.prototype.connect = toneConnect; + AudioNode.prototype.disconnect = toneDisconnect; + } + } + if (Tone.supported) { + shimConnect(); + Tone.context = new Tone.Context(); + } else { + console.warn('This browser does not support Tone.js'); + } + return Tone.Context; +}(Tone_core_Tone); +var audiocontext; +'use strict'; +audiocontext = function (StartAudioContext, Context, Tone) { + // Create the Audio Context + const audiocontext = new window.AudioContext(); + Tone.context.dispose(); + Tone.setContext(audiocontext); + /** + *

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

    + * + *

    Some browsers require users to startAudioContext + * with a user gesture, such as touchStarted in the example below.

    + * + * @method getAudioContext + * @return {Object} AudioContext for this sketch + * @example + *
    + * function draw() { + * background(255); + * textAlign(CENTER); + * + * if (getAudioContext().state !== 'running') { + * text('click to start audio', width/2, height/2); + * } else { + * text('audio is enabled', width/2, height/2); + * } + * } + * + * function touchStarted() { + * if (getAudioContext().state !== 'running') { + * getAudioContext().resume(); + * } + * var synth = new p5.MonoSynth(); + * synth.play('A4', 0.5, 0, 0.2); + * } + * + *
    + */ + p5.prototype.getAudioContext = function () { + return audiocontext; + }; + /** + *

    It is a good practice to give users control over starting audio playback. + * This practice is enforced by Google Chrome's autoplay policy as of r70 + * (info), iOS Safari, and other browsers. + *

    + * + *

    + * userStartAudio() starts the Audio Context on a user gesture. It utilizes + * the StartAudioContext library by + * Yotam Mann (MIT Licence, 2016). Read more at https://github.com/tambien/StartAudioContext. + *

    + * + *

    Starting the audio context on a user gesture can be as simple as userStartAudio(). + * Optional parameters let you decide on a specific element that will start the audio context, + * and/or call a function once the audio context is started.

    + * @param {Element|Array} [element(s)] This argument can be an Element, + * Selector String, NodeList, p5.Element, + * jQuery Element, or an Array of any of those. + * @param {Function} [callback] Callback to invoke when the AudioContext has started + * @return {Promise} Returns a Promise which is resolved when + * the AudioContext state is 'running' + * @method userStartAudio + * @example + *
    + * function setup() { + * var myDiv = createDiv('click to start audio'); + * myDiv.position(0, 0); + * + * var mySynth = new p5.MonoSynth(); + * + * // This won't play until the context has started + * mySynth.play('A6'); + * + * // Start the audio context on a click/touch event + * userStartAudio().then(function() { + * myDiv.remove(); + * }); + * } + *
    + */ + p5.prototype.userStartAudio = function (elements, callback) { + var elt = elements; + if (elements instanceof p5.Element) { + elt = elements.elt; + } else if (elements instanceof Array && elements[0] instanceof p5.Element) { + elt = elements.map(function (e) { + return e.elt; + }); + } + return StartAudioContext(audiocontext, elt, callback); + }; + return audiocontext; +}(StartAudioContext, Tone_core_Context, Tone_core_Tone); +var master; +'use strict'; +master = function (audiocontext) { + /** + * Master contains AudioContext and the master sound output. + */ + var Master = function () { + this.input = audiocontext.createGain(); + this.output = audiocontext.createGain(); + //put a hard limiter on the output + this.limiter = audiocontext.createDynamicsCompressor(); + this.limiter.threshold.value = -3; + this.limiter.ratio.value = 20; + this.limiter.knee.value = 1; + this.audiocontext = audiocontext; + this.output.disconnect(); + // 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 Envelope 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 {Object} soundOut + */ + 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; +}(audiocontext); +var helpers; +'use strict'; +helpers = function () { + var p5sound = master; + /** + * @for p5 + */ + /** + * 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. + * + * @method freqToMidi + * @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) + 69; + 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; + * } + * } + *
    + */ + var midiToFreq = p5.prototype.midiToFreq = function (m) { + return 440 * Math.pow(2, (m - 69) / 12); + }; + // This method converts ANSI notes specified as a string "C4", "Eb3" to a frequency + var noteToFreq = function (note) { + if (typeof note !== 'string') { + return note; + } + var wholeNotes = { + A: 21, + B: 23, + C: 24, + D: 26, + E: 28, + F: 29, + G: 31 + }; + var value = wholeNotes[note[0].toUpperCase()]; + var octave = ~~note.slice(-1); + value += 12 * (octave - 1); + switch (note[1]) { + case '#': + value += 1; + break; + case 'b': + value -= 1; + break; + default: + break; + } + return midiToFreq(value); + }; + /** + * 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('assets/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) { + if (p5.prototype.isFileSupported(extTest)) { + 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 Envelope 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; + }; + // helper methods to convert audio file as .wav format, + // will use as saving .wav file and saving blob object + // Thank you to Matt Diamond's RecorderJS (MIT License) + // https://github.com/mattdiamond/Recorderjs + function convertToWav(audioBuffer) { + var leftChannel, rightChannel; + leftChannel = audioBuffer.getChannelData(0); + // handle mono files + if (audioBuffer.numberOfChannels > 1) { + rightChannel = audioBuffer.getChannelData(1); + } else { + rightChannel = leftChannel; + } + var interleaved = interleave(leftChannel, rightChannel); + // create the buffer and view to create the .WAV file + var buffer = new window.ArrayBuffer(44 + interleaved.length * 2); + var view = new window.DataView(buffer); + // write the WAV container, + // check spec at: https://web.archive.org/web/20171215131933/http://tiny.systems/software/soundProgrammer/WavFormatDocs.pdf + // 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, p5sound.audiocontext.sampleRate, true); + view.setUint32(28, p5sound.audiocontext.sampleRate * 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; + } + return view; + } + // 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)); + } + } + return { + convertToWav: convertToWav, + midiToFreq: midiToFreq, + noteToFreq: noteToFreq + }; +}(master); +var errorHandler; +'use strict'; +errorHandler = function () { + /* + 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 + @class customError + @constructor + @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; +'use strict'; +panner = function () { + 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) { + 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); + }; + //not implemented because stereopanner + //node does not require this and will automatically + //convert single channel or multichannel to stereo. + //tested with single and stereo, not with (>2) multichannel + p5.Panner.prototype.inputChannels = function () { + }; + p5.Panner.prototype.connect = function (obj) { + this.stereoPanner.connect(obj); + }; + p5.Panner.prototype.disconnect = function () { + if (this.stereoPanner) { + 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 () { + if (this.output) { + this.output.disconnect(); + } + }; + } +}(master); +var soundfile; +'use strict'; +soundfile = function () { + var CustomError = errorHandler; + var p5sound = master; + var ac = p5sound.audiocontext; + var midiToFreq = helpers.midiToFreq; + var convertToWav = helpers.convertToWav; + /** + *

    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. + * + * @example + *
    + * + * function preload() { + * soundFormats('mp3', 'ogg'); + * 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 = []; + this._cueIDCounter = 0; + // position of the most recently played sample + this._lastPos = 0; + this._counterNode = null; + this._scopeNode = null; + // array of sources so that they can all be stopped! + this.bufferSourceNodes = []; + // current source + this.bufferSourceNode = null; + this.buffer = null; + this.playbackRate = 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 () { + }; + } + this._onAudioProcess = _onAudioProcess.bind(this); + this._clearOnEnd = _clearOnEnd.bind(this); + }; + // 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') { + window.alert('This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS'); + } + var self = this; + var s = new p5.SoundFile(path, function () { + if (typeof callback === 'function') { + callback.apply(self, arguments); + } + if (typeof self._decrementPreload === 'function') { + self._decrementPreload(); + } + }, 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 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: + if (!self.panner) + return; + ac.decodeAudioData(request.response, // success decoding buffer: + function (buff) { + if (!self.panner) + return; + self.buffer = buff; + self.panner.inputChannels(buff.numberOfChannels); + if (callback) { + callback(self); + } + }, // error decoding buffer. "e" is undefined in Chrome 11/22/2015 + function () { + if (!self.panner) + return; + 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 { + if (!self.panner) + return; + 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 () { + 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(); + reader.onload = function () { + if (!self.panner) + return; + ac.decodeAudioData(reader.result, function (buff) { + if (!self.panner) + return; + self.buffer = buff; + self.panner.inputChannels(buff.numberOfChannels); + if (callback) { + callback(self); + } + }); + }; + reader.onerror = function (e) { + if (!self.panner) + return; + 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 (startTime, rate, amp, _cueStart, duration) { + if (!this.output) { + console.warn('SoundFile.play() called after dispose'); + return; + } + var self = this; + var now = p5sound.audiocontext.currentTime; + var cueStart, cueEnd; + var time = startTime || 0; + if (time < 0) { + time = 0; + } + time = time + now; + if (typeof rate !== 'undefined') { + this.rate(rate); + } + if (typeof amp !== 'undefined') { + this.setVolume(amp); + } + // 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) { + this.bufferSourceNode.stop(time); + this._counterNode.stop(time); + } + //dont create another instance if already playing + if (this.mode === 'untildone' && this.isPlaying()) { + return; + } + // 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 + delete this._counterNode; + 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; + } + // 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; + this.bufferSourceNode.addEventListener('ended', this._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) { + cueEnd = duration ? duration : cueStart - 1e-15; + 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. With untilDone, a sound will play only if it's + * not already playing. Sustain is the default mode. + * + * @method playMode + * @param {String} str 'restart' or 'sustain' or 'untilDone' + * @example + *
    + * var mySound; + * function preload(){ + * 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' || s === 'untildone') { + 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 (startTime) { + var now = p5sound.audiocontext.currentTime; + var time = startTime || 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. + * + * @method setLoop + * @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. + * + * @method isLooping + * @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.mode === 'untildone') { + 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 in this.bufferSourceNodes) { + const bufferSourceNode = this.bufferSourceNodes[i]; + if (!!bufferSourceNode) { + try { + bufferSourceNode.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 Envelope 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 preload() { + * 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) + * + * @method getPan + * @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) { + var reverse = false; + if (typeof playbackRate === 'undefined') { + return this.playbackRate; + } + this.playbackRate = playbackRate; + if (playbackRate === 0) { + playbackRate = 1e-13; + } else if (playbackRate < 0 && !this.reversed) { + playbackRate = Math.abs(playbackRate); + reverse = true; + } else if (playbackRate > 0 && this.reversed) { + reverse = true; + } + if (this.bufferSourceNode) { + var now = p5sound.audiocontext.currentTime; + this.bufferSourceNode.playbackRate.cancelScheduledValues(now); + this.bufferSourceNode.playbackRate.linearRampToValueAtTime(Math.abs(playbackRate), now); + this._counterNode.playbackRate.cancelScheduledValues(now); + this._counterNode.playbackRate.linearRampToValueAtTime(Math.abs(playbackRate), now); + } + if (reverse) { + this.reverseBuffer(); + } + return this.playbackRate; + }; + // 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. + * Time is relative to the normal buffer direction, so if `reverseBuffer` + * has been called, currentTime will count backwards. + * + * @method currentTime + * @return {Number} currentTime of the soundFile in seconds. + */ + p5.SoundFile.prototype.currentTime = function () { + return this.reversed ? Math.abs(this._lastPos - this.buffer.length) / ac.sampleRate : this._lastPos / ac.sampleRate; + }; + /** + * Move the playhead of the song to a position, in seconds. Start timing + * and playback duration. 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 dur = duration || undefined; + if (this.isPlaying()) { + this.stop(0); + } + this.play(0, this.playbackRate, this.output.gain.value, cTime, dur); + }; + /** + * 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 () { + if (this.buffer) { + var currentPos = this._lastPos / ac.sampleRate; + var curVol = this.getVolume(); + this.setVolume(0, 0.001); + const numChannels = this.buffer.numberOfChannels; + for (var i = 0; i < numChannels; i++) { + this.buffer.getChannelData(i).reverse(); + } + // set reversed flag + this.reversed = !this.reversed; + if (currentPos) { + this.jump(this.duration() - currentPos); + } + this.setVolume(curVol, 0.001); + } else { + throw 'SoundFile is not done loading'; + } + }; + /** + * 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) { + console.warning('no buffer source node to dispose'); + } + 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 () { + if (this.panner) { + this.panner.disconnect(); + } + }; + /** + */ + p5.SoundFile.prototype.getLevel = function () { + 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. + * + * @method setBuffer + * @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 + //////////////////////////////////////////////////////////////////////////////////// + var _createCounterBuffer = function (buffer) { + const len = buffer.length; + const audioBuf = ac.createBuffer(1, buffer.length, ac.sampleRate); + const arrayBuffer = audioBuf.getChannelData(0); + for (var index = 0; index < len; index++) { + arrayBuffer[index] = index; + } + return audioBuf; + }; + // 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.removeEventListener('audioprocess', self._onAudioProcess); + delete self._scopeNode; + } + 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.addEventListener('audioprocess', self._onAudioProcess); + return cNode; + }; + // initialize sourceNode, set its initial buffer and playbackRate + p5.SoundFile.prototype._initSourceNode = function () { + var bufferSourceNode = ac.createBufferSource(); + bufferSourceNode.buffer = this.buffer; + bufferSourceNode.playbackRate.value = this.playbackRate; + bufferSourceNode.connect(this.output); + return bufferSourceNode; + }; + /** + * 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 allPeaks = []; + var initialThreshold = _initThreshold || 0.9, threshold = initialThreshold, minThreshold = _minThreshold || 0.22, minPeaks = _minPeaks || 200; + // Create offline context + var offlineContext = new window.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) { + if (!self.panner) + return; + 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 = []; + }; + // 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 startPeak in the allPeaks array + if (interval > 0) { + startPeak.intervals.push(interval); + } + // tally the intervals and return interval counts + var foundInterval = intervalCounts.some(function (intervalCount) { + 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) { + 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); + if (Math.abs(intervalBPM - tempo) < bpmVariance) { + // convert sampleIndex to seconds + peaksAtTopTempo.push(peak.sampleIndex / sampleRate); + } + } + } + // 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 ***/ + // Cue inspired by JavaScript setTimeout, and the + // Tone.js Transport Timeline Event, MIT License Yotam Mann 2015 tonejs.org + var Cue = function (callback, time, id, val) { + this.callback = callback; + this.time = time; + this.id = id; + this.val = val; + }; + /** + * Schedule events to trigger every time a MediaElement + * (audio/video) reaches a playback cue point. + * + * 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 + *
    + * var mySound; + * function preload() { + * mySound = loadSound('assets/beat.mp3'); + * } + * + * function setup() { + * background(0); + * noStroke(); + * fill(255); + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * + * // 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); + break; + } + } + 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; + }; + /** + * Save a p5.SoundFile as a .wav file. The browser will prompt the user + * to download the file to their device. To upload a file to a server, see + * getBlob + * + * @method save + * @param {String} [fileName] name of the resulting .wav file. + * @example + *
    + * var inp, button, mySound; + * var fileName = 'cool'; + * function preload() { + * mySound = loadSound('assets/doorbell.mp3'); + * } + * function setup() { + * btn = createButton('click to save file'); + * btn.position(0, 0); + * btn.mouseClicked(handleMouseClick); + * } + * + * function handleMouseClick() { + * mySound.save(fileName); + * } + *
    + */ + p5.SoundFile.prototype.save = function (fileName) { + const dataView = convertToWav(this.buffer); + p5.prototype.saveSound([dataView], fileName, 'wav'); + }; + /** + * This method is useful for sending a SoundFile to a server. It returns the + * .wav-encoded audio data as a "Blob". + * A Blob is a file-like data object that can be uploaded to a server + * with an http request. We'll + * use the `httpDo` options object to send a POST request with some + * specific options: we encode the request as `multipart/form-data`, + * and attach the blob as one of the form values using `FormData`. + * + * + * @method getBlob + * @returns {Blob} A file-like data object + * @example + *
    + * + * function preload() { + * mySound = loadSound('assets/doorbell.mp3'); + * } + * + * function setup() { + * noCanvas(); + * var soundBlob = mySound.getBlob(); + * + * // Now we can send the blob to a server... + * var serverUrl = 'https://jsonplaceholder.typicode.com/posts'; + * var httpRequestOptions = { + * method: 'POST', + * body: new FormData().append('soundBlob', soundBlob), + * headers: new Headers({ + * 'Content-Type': 'multipart/form-data' + * }) + * }; + * httpDo(serverUrl, httpRequestOptions); + * + * // We can also create an `ObjectURL` pointing to the Blob + * var blobUrl = URL.createObjectURL(soundBlob); + * + * // The `
    + */ + p5.SoundFile.prototype.getBlob = function () { + const dataView = convertToWav(this.buffer); + return new Blob([dataView], { type: 'audio/wav' }); + }; + // event handler to keep track of current position + function _onAudioProcess(processEvent) { + var inputBuffer = processEvent.inputBuffer.getChannelData(0); + this._lastPos = inputBuffer[inputBuffer.length - 1] || 0; + // do any callbacks that have been scheduled + this._onTimeUpdate(self._lastPos); + } + // event handler to remove references to the bufferSourceNode when it is done playing + function _clearOnEnd(e) { + const thisBufferSourceNode = e.target; + const soundFile = this; + // delete this.bufferSourceNode from the sources array when it is done playing: + thisBufferSourceNode._playing = false; + thisBufferSourceNode.removeEventListener('ended', soundFile._clearOnEnd); + // call the onended callback + soundFile._onended(soundFile); + soundFile.bufferSourceNodes.forEach(function (n, i) { + if (n._playing === false) { + soundFile.bufferSourceNodes.splice(i); + } + }); + if (soundFile.bufferSourceNodes.length === 0) { + soundFile._playing = false; + } + } +}(errorHandler, master, helpers, helpers); +var amplitude; +'use strict'; +amplitude = function () { + 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) + * @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 () { + if (this.output) { + 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); + if (this.input) { + this.input.disconnect(); + delete this.input; + } + if (this.output) { + this.output.disconnect(); + delete this.output; + } + delete this.processor; + }; +}(master); +var fft; +'use strict'; +fft = function () { + 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. + * @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.input = this.analyser = p5sound.audiocontext.createAnalyser(); + Object.defineProperties(this, { + bins: { + get: function () { + return this.analyser.fftSize / 2; + }, + set: function (b) { + this.analyser.fftSize = b * 2; + }, + configurable: true, + enumerable: true + }, + smoothing: { + get: function () { + return this.analyser.smoothingTimeConstant; + }, + set: function (s) { + this.analyser.smoothingTimeConstant = s; + }, + configurable: true, + enumerable: true + } + }); + // set default smoothing and bins + this.smooth(smoothing); + this.bins = bins || 1024; + // default connections to p5sound fftMeter + p5sound.fftMeter.connect(this.analyser); + this.freqDomain = new Uint8Array(this.analyser.frequencyBinCount); + this.timeDomain = new Uint8Array(this.analyser.frequencyBinCount); + // predefined frequency ranges, 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 j = 0; j < this.timeDomain.length; j++) { + var scaled = p5.prototype.map(this.timeDomain[j], 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 mode; + for (var i = 0; i < arguments.length; i++) { + if (typeof arguments[i] === 'number') { + 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) { + // if only one parameter: + var index = Math.round(frequency1 / nyquist * this.freqDomain.length); + return this.freqDomain[index]; + } else if (frequency1 && frequency2) { + // if two parameters: + // 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(100,100); + * 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 + * text("centroid: ", 10, 20); + * text(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 (typeof s !== 'undefined') { + this.smoothing = s; + } + return this.smoothing; + }; + p5.FFT.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + if (this.analyser) { + this.analyser.disconnect(); + delete this.analyser; + } + }; + /** + * 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_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 - 1) * 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 RangeError('Tone.WaveShaper: oversampling must be either \'none\', \'2x\', or \'4x\''); + } + } + }); + 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_type_TimeBase; +Tone_type_TimeBase = function (Tone) { + Tone.TimeBase = function (val, units) { + if (this instanceof Tone.TimeBase) { + this._expr = this._noOp; + if (val instanceof Tone.TimeBase) { + this.copy(val); + } else if (!this.isUndef(units) || this.isNumber(val)) { + units = this.defaultArg(units, this._defaultUnits); + var method = this._primaryExpressions[units].method; + this._expr = method.bind(this, val); + } else if (this.isString(val)) { + this.set(val); + } else if (this.isUndef(val)) { + this._expr = this._defaultExpr(); + } + } else { + return new Tone.TimeBase(val, units); + } + }; + Tone.extend(Tone.TimeBase); + Tone.TimeBase.prototype.set = function (exprString) { + this._expr = this._parseExprString(exprString); + return this; + }; + Tone.TimeBase.prototype.clone = function () { + var instance = new this.constructor(); + instance.copy(this); + return instance; + }; + Tone.TimeBase.prototype.copy = function (time) { + var val = time._expr(); + return this.set(val); + }; + Tone.TimeBase.prototype._primaryExpressions = { + 'n': { + regexp: /^(\d+)n/i, + method: function (value) { + value = parseInt(value); + if (value === 1) { + return this._beatsToUnits(this._timeSignature()); + } else { + return this._beatsToUnits(4 / value); + } + } + }, + 't': { + regexp: /^(\d+)t/i, + method: function (value) { + value = parseInt(value); + return this._beatsToUnits(8 / (parseInt(value) * 3)); + } + }, + 'm': { + regexp: /^(\d+)m/i, + method: function (value) { + return this._beatsToUnits(parseInt(value) * this._timeSignature()); + } + }, + 'i': { + regexp: /^(\d+)i/i, + method: function (value) { + return this._ticksToUnits(parseInt(value)); + } + }, + 'hz': { + regexp: /^(\d+(?:\.\d+)?)hz/i, + method: function (value) { + return this._frequencyToUnits(parseFloat(value)); + } + }, + 'tr': { + regexp: /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?/, + method: function (m, q, s) { + var total = 0; + if (m && m !== '0') { + total += this._beatsToUnits(this._timeSignature() * parseFloat(m)); + } + if (q && q !== '0') { + total += this._beatsToUnits(parseFloat(q)); + } + if (s && s !== '0') { + total += this._beatsToUnits(parseFloat(s) / 4); + } + return total; + } + }, + 's': { + regexp: /^(\d+(?:\.\d+)?s)/, + method: function (value) { + return this._secondsToUnits(parseFloat(value)); + } + }, + 'samples': { + regexp: /^(\d+)samples/, + method: function (value) { + return parseInt(value) / this.context.sampleRate; + } + }, + 'default': { + regexp: /^(\d+(?:\.\d+)?)/, + method: function (value) { + return this._primaryExpressions[this._defaultUnits].method.call(this, value); + } + } + }; + Tone.TimeBase.prototype._binaryExpressions = { + '+': { + regexp: /^\+/, + precedence: 2, + method: function (lh, rh) { + return lh() + rh(); + } + }, + '-': { + regexp: /^\-/, + precedence: 2, + method: function (lh, rh) { + return lh() - rh(); + } + }, + '*': { + regexp: /^\*/, + precedence: 1, + method: function (lh, rh) { + return lh() * rh(); + } + }, + '/': { + regexp: /^\//, + precedence: 1, + method: function (lh, rh) { + return lh() / rh(); + } + } + }; + Tone.TimeBase.prototype._unaryExpressions = { + 'neg': { + regexp: /^\-/, + method: function (lh) { + return -lh(); + } + } + }; + Tone.TimeBase.prototype._syntaxGlue = { + '(': { regexp: /^\(/ }, + ')': { regexp: /^\)/ } + }; + Tone.TimeBase.prototype._tokenize = function (expr) { + var position = -1; + var tokens = []; + while (expr.length > 0) { + expr = expr.trim(); + var token = getNextToken(expr, this); + tokens.push(token); + expr = expr.substr(token.value.length); + } + function getNextToken(expr, context) { + var expressions = [ + '_binaryExpressions', + '_unaryExpressions', + '_primaryExpressions', + '_syntaxGlue' + ]; + for (var i = 0; i < expressions.length; i++) { + var group = context[expressions[i]]; + for (var opName in group) { + var op = group[opName]; + var reg = op.regexp; + var match = expr.match(reg); + if (match !== null) { + return { + method: op.method, + precedence: op.precedence, + regexp: op.regexp, + value: match[0] + }; + } + } + } + throw new SyntaxError('Tone.TimeBase: Unexpected token ' + expr); + } + return { + next: function () { + return tokens[++position]; + }, + peek: function () { + return tokens[position + 1]; + } + }; + }; + Tone.TimeBase.prototype._matchGroup = function (token, group, prec) { + var ret = false; + if (!this.isUndef(token)) { + for (var opName in group) { + var op = group[opName]; + if (op.regexp.test(token.value)) { + if (!this.isUndef(prec)) { + if (op.precedence === prec) { + return op; + } + } else { + return op; + } + } + } + } + return ret; + }; + Tone.TimeBase.prototype._parseBinary = function (lexer, precedence) { + if (this.isUndef(precedence)) { + precedence = 2; + } + var expr; + if (precedence < 0) { + expr = this._parseUnary(lexer); + } else { + expr = this._parseBinary(lexer, precedence - 1); + } + var token = lexer.peek(); + while (token && this._matchGroup(token, this._binaryExpressions, precedence)) { + token = lexer.next(); + expr = token.method.bind(this, expr, this._parseBinary(lexer, precedence - 1)); + token = lexer.peek(); + } + return expr; + }; + Tone.TimeBase.prototype._parseUnary = function (lexer) { + var token, expr; + token = lexer.peek(); + var op = this._matchGroup(token, this._unaryExpressions); + if (op) { + token = lexer.next(); + expr = this._parseUnary(lexer); + return op.method.bind(this, expr); + } + return this._parsePrimary(lexer); + }; + Tone.TimeBase.prototype._parsePrimary = function (lexer) { + var token, expr; + token = lexer.peek(); + if (this.isUndef(token)) { + throw new SyntaxError('Tone.TimeBase: Unexpected end of expression'); + } + if (this._matchGroup(token, this._primaryExpressions)) { + token = lexer.next(); + var matching = token.value.match(token.regexp); + return token.method.bind(this, matching[1], matching[2], matching[3]); + } + if (token && token.value === '(') { + lexer.next(); + expr = this._parseBinary(lexer); + token = lexer.next(); + if (!(token && token.value === ')')) { + throw new SyntaxError('Expected )'); + } + return expr; + } + throw new SyntaxError('Tone.TimeBase: Cannot process token ' + token.value); + }; + Tone.TimeBase.prototype._parseExprString = function (exprString) { + if (!this.isString(exprString)) { + exprString = exprString.toString(); + } + var lexer = this._tokenize(exprString); + var tree = this._parseBinary(lexer); + return tree; + }; + Tone.TimeBase.prototype._noOp = function () { + return 0; + }; + Tone.TimeBase.prototype._defaultExpr = function () { + return this._noOp; + }; + Tone.TimeBase.prototype._defaultUnits = 's'; + Tone.TimeBase.prototype._frequencyToUnits = function (freq) { + return 1 / freq; + }; + Tone.TimeBase.prototype._beatsToUnits = function (beats) { + return 60 / Tone.Transport.bpm.value * beats; + }; + Tone.TimeBase.prototype._secondsToUnits = function (seconds) { + return seconds; + }; + Tone.TimeBase.prototype._ticksToUnits = function (ticks) { + return ticks * (this._beatsToUnits(1) / Tone.Transport.PPQ); + }; + Tone.TimeBase.prototype._timeSignature = function () { + return Tone.Transport.timeSignature; + }; + Tone.TimeBase.prototype._pushExpr = function (val, name, units) { + if (!(val instanceof Tone.TimeBase)) { + val = new this.constructor(val, units); + } + this._expr = this._binaryExpressions[name].method.bind(this, this._expr, val._expr); + return this; + }; + Tone.TimeBase.prototype.add = function (val, units) { + return this._pushExpr(val, '+', units); + }; + Tone.TimeBase.prototype.sub = function (val, units) { + return this._pushExpr(val, '-', units); + }; + Tone.TimeBase.prototype.mult = function (val, units) { + return this._pushExpr(val, '*', units); + }; + Tone.TimeBase.prototype.div = function (val, units) { + return this._pushExpr(val, '/', units); + }; + Tone.TimeBase.prototype.valueOf = function () { + return this._expr(); + }; + Tone.TimeBase.prototype.dispose = function () { + this._expr = null; + }; + return Tone.TimeBase; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_type_Time; +Tone_type_Time = function (Tone) { + Tone.Time = function (val, units) { + if (this instanceof Tone.Time) { + this._plusNow = false; + Tone.TimeBase.call(this, val, units); + } else { + return new Tone.Time(val, units); + } + }; + Tone.extend(Tone.Time, Tone.TimeBase); + Tone.Time.prototype._unaryExpressions = Object.create(Tone.TimeBase.prototype._unaryExpressions); + Tone.Time.prototype._unaryExpressions.quantize = { + regexp: /^@/, + method: function (rh) { + return Tone.Transport.nextSubdivision(rh()); + } + }; + Tone.Time.prototype._unaryExpressions.now = { + regexp: /^\+/, + method: function (lh) { + this._plusNow = true; + return lh(); + } + }; + Tone.Time.prototype.quantize = function (subdiv, percent) { + percent = this.defaultArg(percent, 1); + this._expr = function (expr, subdivision, percent) { + expr = expr(); + subdivision = subdivision.toSeconds(); + var multiple = Math.round(expr / subdivision); + var ideal = multiple * subdivision; + var diff = ideal - expr; + return expr + diff * percent; + }.bind(this, this._expr, new this.constructor(subdiv), percent); + return this; + }; + Tone.Time.prototype.addNow = function () { + this._plusNow = true; + return this; + }; + Tone.Time.prototype._defaultExpr = function () { + this._plusNow = true; + return this._noOp; + }; + Tone.Time.prototype.copy = function (time) { + Tone.TimeBase.prototype.copy.call(this, time); + this._plusNow = time._plusNow; + return this; + }; + Tone.Time.prototype.toNotation = function () { + var time = this.toSeconds(); + var testNotations = [ + '1m', + '2n', + '4n', + '8n', + '16n', + '32n', + '64n', + '128n' + ]; + var retNotation = this._toNotationHelper(time, testNotations); + var testTripletNotations = [ + '1m', + '2n', + '2t', + '4n', + '4t', + '8n', + '8t', + '16n', + '16t', + '32n', + '32t', + '64n', + '64t', + '128n' + ]; + var retTripletNotation = this._toNotationHelper(time, testTripletNotations); + if (retTripletNotation.split('+').length < retNotation.split('+').length) { + return retTripletNotation; + } else { + return retNotation; + } + }; + Tone.Time.prototype._toNotationHelper = function (units, testNotations) { + var threshold = this._notationToUnits(testNotations[testNotations.length - 1]); + var retNotation = ''; + for (var i = 0; i < testNotations.length; i++) { + var notationTime = this._notationToUnits(testNotations[i]); + var multiple = units / 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]; + } + units -= multiple * notationTime; + if (units < threshold) { + break; + } else { + retNotation += ' + '; + } + } + } + if (retNotation === '') { + retNotation = '0'; + } + return retNotation; + }; + Tone.Time.prototype._notationToUnits = function (notation) { + var primaryExprs = this._primaryExpressions; + var notationExprs = [ + primaryExprs.n, + primaryExprs.t, + primaryExprs.m + ]; + for (var i = 0; i < notationExprs.length; i++) { + var expr = notationExprs[i]; + var match = notation.match(expr.regexp); + if (match) { + return expr.method.call(this, match[1]); + } + } + }; + Tone.Time.prototype.toBarsBeatsSixteenths = function () { + var quarterTime = this._beatsToUnits(1); + var quarters = this.toSeconds() / quarterTime; + var measures = Math.floor(quarters / this._timeSignature()); + var sixteenths = quarters % 1 * 4; + quarters = Math.floor(quarters) % this._timeSignature(); + sixteenths = sixteenths.toString(); + if (sixteenths.length > 3) { + sixteenths = parseFloat(sixteenths).toFixed(3); + } + var progress = [ + measures, + quarters, + sixteenths + ]; + return progress.join(':'); + }; + Tone.Time.prototype.toTicks = function () { + var quarterTime = this._beatsToUnits(1); + var quarters = this.valueOf() / quarterTime; + return Math.floor(quarters * Tone.Transport.PPQ); + }; + Tone.Time.prototype.toSamples = function () { + return this.toSeconds() * this.context.sampleRate; + }; + Tone.Time.prototype.toFrequency = function () { + return 1 / this.toSeconds(); + }; + Tone.Time.prototype.toSeconds = function () { + return this.valueOf(); + }; + Tone.Time.prototype.toMilliseconds = function () { + return this.toSeconds() * 1000; + }; + Tone.Time.prototype.valueOf = function () { + var val = this._expr(); + return val + (this._plusNow ? this.now() : 0); + }; + return Tone.Time; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_type_Frequency; +Tone_type_Frequency = function (Tone) { + Tone.Frequency = function (val, units) { + if (this instanceof Tone.Frequency) { + Tone.TimeBase.call(this, val, units); + } else { + return new Tone.Frequency(val, units); + } + }; + Tone.extend(Tone.Frequency, Tone.TimeBase); + Tone.Frequency.prototype._primaryExpressions = Object.create(Tone.TimeBase.prototype._primaryExpressions); + Tone.Frequency.prototype._primaryExpressions.midi = { + regexp: /^(\d+(?:\.\d+)?midi)/, + method: function (value) { + return this.midiToFrequency(value); + } + }; + Tone.Frequency.prototype._primaryExpressions.note = { + regexp: /^([a-g]{1}(?:b|#|x|bb)?)(-?[0-9]+)/i, + method: function (pitch, octave) { + var index = noteToScaleIndex[pitch.toLowerCase()]; + var noteNumber = index + (parseInt(octave) + 1) * 12; + return this.midiToFrequency(noteNumber); + } + }; + Tone.Frequency.prototype._primaryExpressions.tr = { + regexp: /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?/, + method: function (m, q, s) { + var total = 1; + if (m && m !== '0') { + total *= this._beatsToUnits(this._timeSignature() * parseFloat(m)); + } + if (q && q !== '0') { + total *= this._beatsToUnits(parseFloat(q)); + } + if (s && s !== '0') { + total *= this._beatsToUnits(parseFloat(s) / 4); + } + return total; + } + }; + Tone.Frequency.prototype.transpose = function (interval) { + this._expr = function (expr, interval) { + var val = expr(); + return val * this.intervalToFrequencyRatio(interval); + }.bind(this, this._expr, interval); + return this; + }; + Tone.Frequency.prototype.harmonize = function (intervals) { + this._expr = function (expr, intervals) { + var val = expr(); + var ret = []; + for (var i = 0; i < intervals.length; i++) { + ret[i] = val * this.intervalToFrequencyRatio(intervals[i]); + } + return ret; + }.bind(this, this._expr, intervals); + return this; + }; + Tone.Frequency.prototype.toMidi = function () { + return this.frequencyToMidi(this.valueOf()); + }; + Tone.Frequency.prototype.toNote = function () { + var freq = this.valueOf(); + var log = Math.log(freq / Tone.Frequency.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.Frequency.prototype.toSeconds = function () { + return 1 / this.valueOf(); + }; + Tone.Frequency.prototype.toFrequency = function () { + return this.valueOf(); + }; + Tone.Frequency.prototype.toTicks = function () { + var quarterTime = this._beatsToUnits(1); + var quarters = this.valueOf() / quarterTime; + return Math.floor(quarters * Tone.Transport.PPQ); + }; + Tone.Frequency.prototype._frequencyToUnits = function (freq) { + return freq; + }; + Tone.Frequency.prototype._ticksToUnits = function (ticks) { + return 1 / (ticks * 60 / (Tone.Transport.bpm.value * Tone.Transport.PPQ)); + }; + Tone.Frequency.prototype._beatsToUnits = function (beats) { + return 1 / Tone.TimeBase.prototype._beatsToUnits.call(this, beats); + }; + Tone.Frequency.prototype._secondsToUnits = function (seconds) { + return 1 / seconds; + }; + Tone.Frequency.prototype._defaultUnits = 'hz'; + 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.Frequency.A4 = 440; + Tone.Frequency.prototype.midiToFrequency = function (midi) { + return Tone.Frequency.A4 * Math.pow(2, (midi - 69) / 12); + }; + Tone.Frequency.prototype.frequencyToMidi = function (frequency) { + return 69 + 12 * Math.log(frequency / Tone.Frequency.A4) / Math.LN2; + }; + return Tone.Frequency; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_type_TransportTime; +Tone_type_TransportTime = function (Tone) { + Tone.TransportTime = function (val, units) { + if (this instanceof Tone.TransportTime) { + Tone.Time.call(this, val, units); + } else { + return new Tone.TransportTime(val, units); + } + }; + Tone.extend(Tone.TransportTime, Tone.Time); + Tone.TransportTime.prototype._unaryExpressions = Object.create(Tone.Time.prototype._unaryExpressions); + Tone.TransportTime.prototype._unaryExpressions.quantize = { + regexp: /^@/, + method: function (rh) { + var subdivision = this._secondsToTicks(rh()); + var multiple = Math.ceil(Tone.Transport.ticks / subdivision); + return this._ticksToUnits(multiple * subdivision); + } + }; + Tone.TransportTime.prototype._secondsToTicks = function (seconds) { + var quarterTime = this._beatsToUnits(1); + var quarters = seconds / quarterTime; + return Math.round(quarters * Tone.Transport.PPQ); + }; + Tone.TransportTime.prototype.valueOf = function () { + var val = this._secondsToTicks(this._expr()); + return val + (this._plusNow ? Tone.Transport.ticks : 0); + }; + Tone.TransportTime.prototype.toTicks = function () { + return this.valueOf(); + }; + Tone.TransportTime.prototype.toSeconds = function () { + var val = this._expr(); + return val + (this._plusNow ? Tone.Transport.seconds : 0); + }; + Tone.TransportTime.prototype.toFrequency = function () { + return 1 / this.toSeconds(); + }; + return Tone.TransportTime; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_type_Type; +Tone_type_Type = function (Tone) { + Tone.Type = { + Default: 'number', + Time: 'time', + Frequency: 'frequency', + TransportTime: 'transportTime', + Ticks: 'ticks', + NormalRange: 'normalRange', + AudioRange: 'audioRange', + Decibels: 'db', + Interval: 'interval', + BPM: 'bpm', + Positive: 'positive', + Cents: 'cents', + Degrees: 'degrees', + MIDI: 'midi', + BarsBeatsSixteenths: 'barsBeatsSixteenths', + Samples: 'samples', + Hertz: 'hertz', + Note: 'note', + Milliseconds: 'milliseconds', + Seconds: 'seconds', + Notation: 'notation' + }; + Tone.prototype.toSeconds = function (time) { + if (this.isNumber(time)) { + return time; + } else if (this.isUndef(time)) { + return this.now(); + } else if (this.isString(time)) { + return new Tone.Time(time).toSeconds(); + } else if (time instanceof Tone.TimeBase) { + return time.toSeconds(); + } + }; + Tone.prototype.toFrequency = function (freq) { + if (this.isNumber(freq)) { + return freq; + } else if (this.isString(freq) || this.isUndef(freq)) { + return new Tone.Frequency(freq).valueOf(); + } else if (freq instanceof Tone.TimeBase) { + return freq.toFrequency(); + } + }; + Tone.prototype.toTicks = function (time) { + if (this.isNumber(time) || this.isString(time)) { + return new Tone.TransportTime(time).toTicks(); + } else if (this.isUndef(time)) { + return Tone.Transport.ticks; + } else if (time instanceof Tone.TimeBase) { + return time.toTicks(); + } + }; + return Tone; +}(Tone_core_Tone, Tone_type_Time, Tone_type_Frequency, Tone_type_TransportTime); +/** 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; + this._lfo = null; + if (this.isObject(options.lfo)) { + this.value = options.lfo; + } else 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) { + if (this.isObject(value)) { + if (this.isUndef(Tone.LFO)) { + throw new Error('Include \'Tone.LFO\' to use an LFO as a Param value.'); + } + if (this._lfo) { + this._lfo.dispose(); + } + this._lfo = new Tone.LFO(value).start(); + this._lfo.connect(this.input); + } else { + var convertedVal = this._fromUnits(value); + this._param.cancelScheduledValues(0); + 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); + time = this.toSeconds(time); + if (time <= this.now() + this.blockTime) { + this._param.value = value; + } else { + this._param.setValueAtTime(value, time); + } + return this; + }; + Tone.Param.prototype.setRampPoint = function (now) { + now = this.defaultArg(now, this.now()); + var currentVal = this._param.value; + if (currentVal === 0) { + currentVal = this._minOutput; + } + 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, startTime) { + startTime = this.toSeconds(startTime); + this.setRampPoint(startTime); + this.exponentialRampToValueAtTime(value, startTime + this.toSeconds(rampTime)); + return this; + }; + Tone.Param.prototype.linearRampToValue = function (value, rampTime, startTime) { + startTime = this.toSeconds(startTime); + this.setRampPoint(startTime); + this.linearRampToValueAtTime(value, startTime + 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, startTime) { + rampTime = this.defaultArg(rampTime, 0); + if (this.units === Tone.Type.Frequency || this.units === Tone.Type.BPM || this.units === Tone.Type.Decibels) { + this.exponentialRampToValue(value, rampTime, startTime); + } else { + this.linearRampToValue(value, rampTime, startTime); + } + return this; + }; + Object.defineProperty(Tone.Param.prototype, 'lfo', { + get: function () { + return this._lfo; + } + }); + Tone.Param.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._param = null; + if (this._lfo) { + this._lfo.dispose(); + this._lfo = 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'; + if (window.GainNode && !AudioContext.prototype.createGain) { + AudioContext.prototype.createGain = AudioContext.prototype.createGainNode; + } + 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; + }; + Tone.prototype.createInsOuts = function (inputs, outputs) { + if (inputs === 1) { + this.input = new Tone.Gain(); + } else if (inputs > 1) { + this.input = new Array(inputs); + } + if (outputs === 1) { + this.output = new Tone.Gain(); + } else if (outputs > 1) { + this.output = new Array(inputs); + } + }; + 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; + this.context.getConstant(1).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; + }; + return Tone.Signal; +}(Tone_core_Tone, Tone_signal_WaveShaper, Tone_type_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) { + this.createInsOuts(2, 0); + this._sum = this.input[0] = this.input[1] = this.output = new Tone.Gain(); + 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.dispose(); + this._sum = null; + this._param.dispose(); + this._param = null; + return this; + }; + return Tone.Add; +}(Tone_core_Tone, Tone_signal_Signal); +/** 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) { + this.createInsOuts(2, 0); + this._mult = this.input[0] = this.output = new Tone.Gain(); + 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.dispose(); + this._mult = null; + this._param = null; + return this; + }; + return Tone.Multiply; +}(Tone_core_Tone, Tone_signal_Signal); +/** 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; +'use strict'; +signal = function () { + // 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; + /** + *

    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. + * + * @method setInput + * @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.Signal} 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 {p5.Signal} 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.Signal} 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); +var oscillator; +'use strict'; +oscillator = function () { + var p5sound = master; + 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 instantiating a + * specific oscillator: p5.SinOsc, p5.TriOsc, p5.SqrOsc, or p5.SawOsc. + *

    + * + * @class p5.Oscillator + * @constructor + * @param {Number} [freq] frequency defaults to 440Hz + * @param {String} [type] type of oscillator. Options: + * 'sine' (default), 'triangle', + * 'sawtooth', 'square' + * @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.05 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); + // 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(); + delete this.oscillator; + } + // var detune = this.oscillator.frequency.value; + this.oscillator = p5sound.audiocontext.createOscillator(); + this.oscillator.frequency.value = Math.abs(freq); + 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; + 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 t = now + tFromNow + rampTime; + // var currentFreq = this.oscillator.frequency.value; + // this.oscillator.frequency.cancelScheduledValues(now); + if (rampTime === 0) { + 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 () { + if (this.output) { + this.output.disconnect(); + } + if (this.panner) { + this.panner.disconnect(); + if (this.output) { + 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. + * + * @class p5.SinOsc + * @constructor + * @extends p5.Oscillator + * @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. + * + * @class p5.TriOsc + * @constructor + * @extends p5.Oscillator + * @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. + * + * @class p5.SawOsc + * @constructor + * @extends p5.Oscillator + * @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. + * + * @class p5.SqrOsc + * @constructor + * @extends p5.Oscillator + * @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_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.add = function (event) { + if (this.isUndef(event.time)) { + throw new Error('Tone.Timeline: events must have a time attribute'); + } + 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.remove = 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.get = function (time) { + var index = this._search(time); + if (index !== -1) { + return this._timeline[index]; + } else { + return null; + } + }; + Tone.Timeline.prototype.peek = function () { + return this._timeline[0]; + }; + Tone.Timeline.prototype.shift = function () { + return this._timeline.shift(); + }; + Tone.Timeline.prototype.getAfter = function (time) { + var index = this._search(time); + if (index + 1 < this._timeline.length) { + return this._timeline[index + 1]; + } else { + return null; + } + }; + Tone.Timeline.prototype.getBefore = function (time) { + var len = this._timeline.length; + if (len > 0 && this._timeline[len - 1].time < time) { + return this._timeline[len - 1]; + } + 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) { + var index = this._search(after); + if (index >= 0) { + if (this._timeline[index].time === after) { + for (var i = index; i >= 0; i--) { + if (this._timeline[i].time === after) { + index = i; + } else { + break; + } + } + this._timeline = this._timeline.slice(0, index); + } else { + this._timeline = this._timeline.slice(0, index + 1); + } + } 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) { + 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; + if (len > 0 && this._timeline[len - 1].time <= time) { + return len - 1; + } + while (beginning < end) { + var midPoint = Math.floor(beginning + (end - beginning) / 2); + var event = this._timeline[midPoint]; + var nextEvent = this._timeline[midPoint + 1]; + 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 && nextEvent.time > time) { + return midPoint; + } else if (event.time > time) { + end = midPoint; + } else if (event.time < time) { + beginning = midPoint + 1; + } + } + return -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) { + var upperBound = this._search(time); + if (upperBound !== -1) { + this._iterate(callback, 0, upperBound); + } + return this; + }; + Tone.Timeline.prototype.forEachAfter = function (time, callback) { + var lowerBound = this._search(time); + this._iterate(callback, lowerBound + 1); + return this; + }; + Tone.Timeline.prototype.forEachFrom = function (time, callback) { + 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) { + 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); + this._events = new Tone.Timeline(10); + Tone.Signal.apply(this, options); + options.param = this._param; + Tone.Param.call(this, options); + this._initial = this._fromUnits(this._param.value); + }; + Tone.extend(Tone.TimelineSignal, Tone.Param); + Tone.TimelineSignal.Type = { + Linear: 'linear', + Exponential: 'exponential', + Target: 'target', + Curve: 'curve', + Set: 'set' + }; + Object.defineProperty(Tone.TimelineSignal.prototype, 'value', { + get: function () { + var now = this.now(); + var val = this.getValueAtTime(now); + return this._toUnits(val); + }, + set: function (value) { + var convertedVal = this._fromUnits(value); + this._initial = convertedVal; + this.cancelScheduledValues(); + this._param.value = convertedVal; + } + }); + Tone.TimelineSignal.prototype.setValueAtTime = function (value, startTime) { + value = this._fromUnits(value); + startTime = this.toSeconds(startTime); + this._events.add({ + '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.add({ + 'type': Tone.TimelineSignal.Type.Linear, + 'value': value, + 'time': endTime + }); + this._param.linearRampToValueAtTime(value, endTime); + return this; + }; + Tone.TimelineSignal.prototype.exponentialRampToValueAtTime = function (value, endTime) { + endTime = this.toSeconds(endTime); + var beforeEvent = this._searchBefore(endTime); + if (beforeEvent && beforeEvent.value === 0) { + this.setValueAtTime(this._minOutput, beforeEvent.time); + } + value = this._fromUnits(value); + var setValue = Math.max(value, this._minOutput); + this._events.add({ + 'type': Tone.TimelineSignal.Type.Exponential, + 'value': setValue, + 'time': endTime + }); + if (value < this._minOutput) { + this._param.exponentialRampToValueAtTime(this._minOutput, endTime - this.sampleTime); + this.setValueAtTime(0, endTime); + } else { + 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.add({ + 'type': Tone.TimelineSignal.Type.Target, + 'value': value, + 'time': startTime, + 'constant': timeConstant + }); + this._param.setTargetAtTime(value, startTime, timeConstant); + return this; + }; + Tone.TimelineSignal.prototype.setValueCurveAtTime = function (values, startTime, duration, scaling) { + scaling = this.defaultArg(scaling, 1); + var floats = new Array(values.length); + for (var i = 0; i < floats.length; i++) { + floats[i] = this._fromUnits(values[i]) * scaling; + } + startTime = this.toSeconds(startTime); + duration = this.toSeconds(duration); + this._events.add({ + 'type': Tone.TimelineSignal.Type.Curve, + 'value': floats, + 'time': startTime, + 'duration': duration + }); + this._param.setValueAtTime(floats[0], startTime); + for (var j = 1; j < floats.length; j++) { + var segmentTime = startTime + j / (floats.length - 1) * duration; + this._param.linearRampToValueAtTime(floats[j], segmentTime); + } + return this; + }; + Tone.TimelineSignal.prototype.cancelScheduledValues = function (after) { + after = this.toSeconds(after); + this._events.cancel(after); + this._param.cancelScheduledValues(after); + return this; + }; + Tone.TimelineSignal.prototype.setRampPoint = function (time) { + time = this.toSeconds(time); + var val = this._toUnits(this.getValueAtTime(time)); + var before = this._searchBefore(time); + if (before && before.time === time) { + this.cancelScheduledValues(time + this.sampleTime); + } else if (before && before.type === Tone.TimelineSignal.Type.Curve && before.time + before.duration > time) { + this.cancelScheduledValues(time); + this.linearRampToValueAtTime(val, time); + } else { + 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.get(time); + }; + Tone.TimelineSignal.prototype._searchAfter = function (time) { + return this._events.getAfter(time); + }; + Tone.TimelineSignal.prototype.getValueAtTime = function (time) { + time = this.toSeconds(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.getBefore(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 (before.type === Tone.TimelineSignal.Type.Curve) { + value = this._curveInterpolate(before.time, before.value, before.duration, 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._curveInterpolate = function (start, curve, duration, time) { + var len = curve.length; + if (time >= start + duration) { + return curve[len - 1]; + } else if (time <= start) { + return curve[0]; + } else { + var progress = (time - start) / duration; + var lowerIndex = Math.floor((len - 1) * progress); + var upperIndex = Math.ceil((len - 1) * progress); + var lowerVal = curve[lowerIndex]; + var upperVal = curve[upperIndex]; + if (upperIndex === lowerIndex) { + return lowerVal; + } else { + return this._linearInterpolate(lowerIndex, lowerVal, upperIndex, upperVal, progress * (len - 1)); + } + } + }; + 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 envelope; +'use strict'; +envelope = function () { + var p5sound = master; + var Add = Tone_signal_Add; + var Mult = Tone_signal_Multiply; + var Scale = Tone_signal_Scale; + var TimelineSignal = Tone_signal_TimelineSignal; + /** + *

    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.Envelope 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.Envelope + * @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.Envelope(); + * 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.Envelope = function (t1, l1, t2, l2, t3, l3) { + /** + * 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.Envelope.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 = 0.5; // 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.Envelope(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.Envelope.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.Envelope(); + * 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.Envelope.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.Envelope(); + * 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.Envelope.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.Envelope.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.Envelope.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.Envelope will control its + * output gain. If multiple inputs are provided, the env will + * control all of them. + * + * @method setInput + * @param {Object} [...inputs] A p5.sound object or + * Web Audio Param. + */ + p5.Envelope.prototype.setInput = function () { + 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.Envelope.prototype.setExp = function (isExp) { + this.isExponential = isExp; + }; + //helper method to protect against zero values being sent to exponential functions + p5.Envelope.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 Envelope 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.Envelope(); + * 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.Envelope.prototype.play = function (unit, secondsFromNow, susTime) { + 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.Envelope(); + * 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.Envelope.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); + 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.Envelope(); + * 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.Envelope.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); + 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.Envelope(); + * 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.Envelope.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.Envelope.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.Envelope.prototype.disconnect = function () { + if (this.output) { + 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.Envelope} Envelope Returns this envelope + * with scaled output + */ + p5.Envelope.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.Envelope'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.Envelope} Envelope Returns this envelope + * with scaled output + */ + p5.Envelope.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.Envelope} Envelope Returns this envelope + * with scaled output + */ + p5.Envelope.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.Envelope.prototype.dispose = function () { + // remove reference from soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.disconnect(); + if (this.control) { + this.control.dispose(); + this.control = null; + } + for (var i = 1; i < this.mathOps.length; i++) { + this.mathOps[i].dispose(); + } + }; + // Different name for backwards compatibility, replicates p5.Envelope class + p5.Env = function (t1, l1, t2, l2, t3, l3) { + console.warn('WARNING: p5.Env is now deprecated and may be removed in future versions. ' + 'Please use the new p5.Envelope instead.'); + p5.Envelope.call(this, t1, l1, t2, l2, t3, l3); + }; + p5.Env.prototype = Object.create(p5.Envelope.prototype); +}(master, Tone_signal_Add, Tone_signal_Multiply, Tone_signal_Scale, Tone_signal_TimelineSignal); +var pulse; +'use strict'; +pulse = function () { + 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 + * @extends p5.Oscillator + * @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); + if (this.osc2.oscillator) { + 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; +'use strict'; +noise = function () { + var p5sound = master; + /** + * Noise is a type of oscillator that generates a buffer with random values. + * + * @class p5.Noise + * @extends p5.Oscillator + * @constructor + * @param {String} type Type of noise can be 'white' (default), + * 'brown' or 'pink'. + */ + 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; + }; + 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; + }; + p5.Noise.prototype.stop = function () { + var now = p5sound.audiocontext.currentTime; + if (this.noise) { + this.noise.stop(now); + this.started = false; + } + }; + 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; +'use strict'; +audioin = function () { + var p5sound = master; + // an array of input sources + p5sound.inputSources = []; + /** + *

    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. + * @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 + /** + * @property {GainNode} input + */ + this.input = p5sound.audiocontext.createGain(); + /** + * @property {GainNode} output + */ + this.output = p5sound.audiocontext.createGain(); + /** + * @property {MediaStream|null} stream + */ + this.stream = null; + /** + * @property {MediaStreamAudioSourceNode|null} mediaStream + */ + this.mediaStream = null; + /** + * @property {Number|null} currentSource + */ + this.currentSource = null; + /** + * 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; + /** + * Input amplitude, connect to it by default but not to master out + * + * @property {p5.Amplitude} amplitude + */ + this.amplitude = new p5.Amplitude(); + this.output.connect(this.amplitude.input); + if (!window.MediaStreamTrack || !window.navigator.mediaDevices || !window.navigator.mediaDevices.getUserMedia) { + errorCallback ? errorCallback() : window.alert('This browser does not support MediaStreamTrack and mediaDevices'); + } + // 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 (this.stream) { + this.stop(); + } + // set the audio source + var audioSource = p5sound.inputSources[self.currentSource]; + var constraints = { + audio: { + sampleRate: p5sound.audiocontext.sampleRate, + echoCancellation: false + } + }; + // if developers determine which source to use + if (p5sound.inputSources[this.currentSource]) { + constraints.audio.deviceId = audioSource.deviceId; + } + window.navigator.mediaDevices.getUserMedia(constraints).then(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(); + }).catch(function (err) { + if (errorCallback) + errorCallback(err); + else + console.error(err); + }); + }; + /** + * 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) { + this.stream.getTracks().forEach(function (track) { + track.stop(); + }); + this.mediaStream.disconnect(); + delete this.mediaStream; + delete this.stream; + } + }; + /** + * 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 () { + if (this.output) { + 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(); + }; + /** + * 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); + } + }; + /** + * Returns a list of available input sources. This is a wrapper + * for and it returns a Promise. + * + * @method getSources + * @param {Function} [successCallback] This callback function handles the sources when they + * have been enumerated. The callback function + * receives the deviceList array as its only argument + * @param {Function} [errorCallback] This optional callback receives the error + * message as its argument. + * @returns {Promise} Returns a Promise that can be used in place of the callbacks, similar + * to the enumerateDevices() method + * @example + *
    + * var audiograb; + * + * function setup(){ + * //new audioIn + * audioGrab = new p5.AudioIn(); + * + * audioGrab.getSources(function(deviceList) { + * //print out the array of available sources + * console.log(deviceList); + * //set the source to the first item in the deviceList array + * audioGrab.setSource(0); + * }); + * } + *
    + */ + p5.AudioIn.prototype.getSources = function (onSuccess, onError) { + return new Promise(function (resolve, reject) { + window.navigator.mediaDevices.enumerateDevices().then(function (devices) { + p5sound.inputSources = devices.filter(function (device) { + return device.kind === 'audioinput'; + }); + resolve(p5sound.inputSources); + if (onSuccess) { + onSuccess(p5sound.inputSources); + } + }).catch(function (error) { + reject(error); + if (onError) { + onError(error); + } else { + console.error('This browser does not support MediaStreamTrack.getSources()'); + } + }); + }); + }; + /** + * Set the input source. Accepts a number representing a + * position in the array returned by getSources(). + * This is only available in browsers that support + *     navigator.mediaDevices.enumerateDevices().
    + * + * @method setSource + * @param {number} num position of input source in the array + */ + p5.AudioIn.prototype.setSource = function (num) { + if (p5sound.inputSources.length > 0 && num < p5sound.inputSources.length) { + // set the current source + this.currentSource = num; + console.log('set source to ', p5sound.inputSources[this.currentSource]); + } else { + console.log('unable to set input source'); + } + // restart stream if currently active + if (this.stream && this.stream.active) { + this.start(); + } + }; + // 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(); + } + delete this.amplitude; + delete this.output; + }; +}(master); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Negate; +Tone_signal_Negate = function (Tone) { + 'use strict'; + Tone.Negate = function () { + this._multiply = this.input = this.output = new Tone.Multiply(-1); + }; + Tone.extend(Tone.Negate, Tone.SignalBase); + Tone.Negate.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._multiply.dispose(); + this._multiply = null; + return this; + }; + return Tone.Negate; +}(Tone_core_Tone, Tone_signal_Multiply); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Subtract; +Tone_signal_Subtract = function (Tone) { + 'use strict'; + Tone.Subtract = function (value) { + this.createInsOuts(2, 0); + this._sum = this.input[0] = this.output = new Tone.Gain(); + this._neg = new Tone.Negate(); + this._param = this.input[1] = new Tone.Signal(value); + this._param.chain(this._neg, this._sum); + }; + Tone.extend(Tone.Subtract, Tone.Signal); + Tone.Subtract.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._neg.dispose(); + this._neg = null; + this._sum.disconnect(); + this._sum = null; + this._param.dispose(); + this._param = null; + return this; + }; + return Tone.Subtract; +}(Tone_core_Tone, Tone_signal_Add, Tone_signal_Negate, Tone_signal_Signal); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_GreaterThanZero; +Tone_signal_GreaterThanZero = function (Tone) { + 'use strict'; + Tone.GreaterThanZero = function () { + this._thresh = this.output = new Tone.WaveShaper(function (val) { + if (val <= 0) { + return 0; + } else { + return 1; + } + }, 127); + this._scale = this.input = new Tone.Multiply(10000); + this._scale.connect(this._thresh); + }; + Tone.extend(Tone.GreaterThanZero, Tone.SignalBase); + Tone.GreaterThanZero.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._scale.dispose(); + this._scale = null; + this._thresh.dispose(); + this._thresh = null; + return this; + }; + return Tone.GreaterThanZero; +}(Tone_core_Tone, Tone_signal_Signal, Tone_signal_Multiply); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_GreaterThan; +Tone_signal_GreaterThan = function (Tone) { + 'use strict'; + Tone.GreaterThan = function (value) { + this.createInsOuts(2, 0); + this._param = this.input[0] = new Tone.Subtract(value); + this.input[1] = this._param.input[1]; + this._gtz = this.output = new Tone.GreaterThanZero(); + this._param.connect(this._gtz); + }; + Tone.extend(Tone.GreaterThan, Tone.Signal); + Tone.GreaterThan.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._param.dispose(); + this._param = null; + this._gtz.dispose(); + this._gtz = null; + return this; + }; + return Tone.GreaterThan; +}(Tone_core_Tone, Tone_signal_GreaterThanZero, Tone_signal_Subtract); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Abs; +Tone_signal_Abs = function (Tone) { + 'use strict'; + Tone.Abs = function () { + this._abs = this.input = this.output = new Tone.WaveShaper(function (val) { + if (val === 0) { + return 0; + } else { + return Math.abs(val); + } + }, 127); + }; + Tone.extend(Tone.Abs, Tone.SignalBase); + Tone.Abs.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._abs.dispose(); + this._abs = null; + return this; + }; + return Tone.Abs; +}(Tone_core_Tone, Tone_signal_WaveShaper); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Modulo; +Tone_signal_Modulo = function (Tone) { + 'use strict'; + Tone.Modulo = function (modulus) { + this.createInsOuts(1, 0); + this._shaper = new Tone.WaveShaper(Math.pow(2, 16)); + this._multiply = new Tone.Multiply(); + this._subtract = this.output = new Tone.Subtract(); + this._modSignal = new Tone.Signal(modulus); + this.input.fan(this._shaper, this._subtract); + this._modSignal.connect(this._multiply, 0, 0); + this._shaper.connect(this._multiply, 0, 1); + this._multiply.connect(this._subtract, 0, 1); + this._setWaveShaper(modulus); + }; + Tone.extend(Tone.Modulo, Tone.SignalBase); + Tone.Modulo.prototype._setWaveShaper = function (mod) { + this._shaper.setMap(function (val) { + var multiple = Math.floor((val + 0.0001) / mod); + return multiple; + }); + }; + Object.defineProperty(Tone.Modulo.prototype, 'value', { + get: function () { + return this._modSignal.value; + }, + set: function (mod) { + this._modSignal.value = mod; + this._setWaveShaper(mod); + } + }); + Tone.Modulo.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._shaper.dispose(); + this._shaper = null; + this._multiply.dispose(); + this._multiply = null; + this._subtract.dispose(); + this._subtract = null; + this._modSignal.dispose(); + this._modSignal = null; + return this; + }; + return Tone.Modulo; +}(Tone_core_Tone, Tone_signal_WaveShaper, Tone_signal_Multiply); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Pow; +Tone_signal_Pow = function (Tone) { + 'use strict'; + Tone.Pow = function (exp) { + this._exp = this.defaultArg(exp, 1); + this._expScaler = this.input = this.output = new Tone.WaveShaper(this._expFunc(this._exp), 8192); + }; + Tone.extend(Tone.Pow, Tone.SignalBase); + Object.defineProperty(Tone.Pow.prototype, 'value', { + get: function () { + return this._exp; + }, + set: function (exp) { + this._exp = exp; + this._expScaler.setMap(this._expFunc(this._exp)); + } + }); + Tone.Pow.prototype._expFunc = function (exp) { + return function (val) { + return Math.pow(Math.abs(val), exp); + }; + }; + Tone.Pow.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._expScaler.dispose(); + this._expScaler = null; + return this; + }; + return Tone.Pow; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_AudioToGain; +Tone_signal_AudioToGain = function (Tone) { + 'use strict'; + Tone.AudioToGain = function () { + this._norm = this.input = this.output = new Tone.WaveShaper(function (x) { + return (x + 1) / 2; + }); + }; + Tone.extend(Tone.AudioToGain, Tone.SignalBase); + Tone.AudioToGain.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._norm.dispose(); + this._norm = null; + return this; + }; + return Tone.AudioToGain; +}(Tone_core_Tone, Tone_signal_WaveShaper); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_Expr; +Tone_signal_Expr = function (Tone) { + 'use strict'; + Tone.Expr = function () { + var expr = this._replacements(Array.prototype.slice.call(arguments)); + var inputCount = this._parseInputs(expr); + this._nodes = []; + this.input = new Array(inputCount); + for (var i = 0; i < inputCount; i++) { + this.input[i] = this.context.createGain(); + } + var tree = this._parseTree(expr); + var result; + try { + result = this._eval(tree); + } catch (e) { + this._disposeNodes(); + throw new Error('Tone.Expr: Could evaluate expression: ' + expr); + } + this.output = result; + }; + Tone.extend(Tone.Expr, Tone.SignalBase); + function applyBinary(Constructor, args, self) { + var op = new Constructor(); + self._eval(args[0]).connect(op, 0, 0); + self._eval(args[1]).connect(op, 0, 1); + return op; + } + function applyUnary(Constructor, args, self) { + var op = new Constructor(); + self._eval(args[0]).connect(op, 0, 0); + return op; + } + function getNumber(arg) { + return arg ? parseFloat(arg) : undefined; + } + function literalNumber(arg) { + return arg && arg.args ? parseFloat(arg.args) : undefined; + } + Tone.Expr._Expressions = { + 'value': { + 'signal': { + regexp: /^\d+\.\d+|^\d+/, + method: function (arg) { + var sig = new Tone.Signal(getNumber(arg)); + return sig; + } + }, + 'input': { + regexp: /^\$\d/, + method: function (arg, self) { + return self.input[getNumber(arg.substr(1))]; + } + } + }, + 'glue': { + '(': { regexp: /^\(/ }, + ')': { regexp: /^\)/ }, + ',': { regexp: /^,/ } + }, + 'func': { + 'abs': { + regexp: /^abs/, + method: applyUnary.bind(this, Tone.Abs) + }, + 'mod': { + regexp: /^mod/, + method: function (args, self) { + var modulus = literalNumber(args[1]); + var op = new Tone.Modulo(modulus); + self._eval(args[0]).connect(op); + return op; + } + }, + 'pow': { + regexp: /^pow/, + method: function (args, self) { + var exp = literalNumber(args[1]); + var op = new Tone.Pow(exp); + self._eval(args[0]).connect(op); + return op; + } + }, + 'a2g': { + regexp: /^a2g/, + method: function (args, self) { + var op = new Tone.AudioToGain(); + self._eval(args[0]).connect(op); + return op; + } + } + }, + 'binary': { + '+': { + regexp: /^\+/, + precedence: 1, + method: applyBinary.bind(this, Tone.Add) + }, + '-': { + regexp: /^\-/, + precedence: 1, + method: function (args, self) { + if (args.length === 1) { + return applyUnary(Tone.Negate, args, self); + } else { + return applyBinary(Tone.Subtract, args, self); + } + } + }, + '*': { + regexp: /^\*/, + precedence: 0, + method: applyBinary.bind(this, Tone.Multiply) + } + }, + 'unary': { + '-': { + regexp: /^\-/, + method: applyUnary.bind(this, Tone.Negate) + }, + '!': { + regexp: /^\!/, + method: applyUnary.bind(this, Tone.NOT) + } + } + }; + Tone.Expr.prototype._parseInputs = function (expr) { + var inputArray = expr.match(/\$\d/g); + var inputMax = 0; + if (inputArray !== null) { + for (var i = 0; i < inputArray.length; i++) { + var inputNum = parseInt(inputArray[i].substr(1)) + 1; + inputMax = Math.max(inputMax, inputNum); + } + } + return inputMax; + }; + Tone.Expr.prototype._replacements = function (args) { + var expr = args.shift(); + for (var i = 0; i < args.length; i++) { + expr = expr.replace(/\%/i, args[i]); + } + return expr; + }; + Tone.Expr.prototype._tokenize = function (expr) { + var position = -1; + var tokens = []; + while (expr.length > 0) { + expr = expr.trim(); + var token = getNextToken(expr); + tokens.push(token); + expr = expr.substr(token.value.length); + } + function getNextToken(expr) { + for (var type in Tone.Expr._Expressions) { + var group = Tone.Expr._Expressions[type]; + for (var opName in group) { + var op = group[opName]; + var reg = op.regexp; + var match = expr.match(reg); + if (match !== null) { + return { + type: type, + value: match[0], + method: op.method + }; + } + } + } + throw new SyntaxError('Tone.Expr: Unexpected token ' + expr); + } + return { + next: function () { + return tokens[++position]; + }, + peek: function () { + return tokens[position + 1]; + } + }; + }; + Tone.Expr.prototype._parseTree = function (expr) { + var lexer = this._tokenize(expr); + var isUndef = this.isUndef.bind(this); + function matchSyntax(token, syn) { + return !isUndef(token) && token.type === 'glue' && token.value === syn; + } + function matchGroup(token, groupName, prec) { + var ret = false; + var group = Tone.Expr._Expressions[groupName]; + if (!isUndef(token)) { + for (var opName in group) { + var op = group[opName]; + if (op.regexp.test(token.value)) { + if (!isUndef(prec)) { + if (op.precedence === prec) { + return true; + } + } else { + return true; + } + } + } + } + return ret; + } + function parseExpression(precedence) { + if (isUndef(precedence)) { + precedence = 5; + } + var expr; + if (precedence < 0) { + expr = parseUnary(); + } else { + expr = parseExpression(precedence - 1); + } + var token = lexer.peek(); + while (matchGroup(token, 'binary', precedence)) { + token = lexer.next(); + expr = { + operator: token.value, + method: token.method, + args: [ + expr, + parseExpression(precedence - 1) + ] + }; + token = lexer.peek(); + } + return expr; + } + function parseUnary() { + var token, expr; + token = lexer.peek(); + if (matchGroup(token, 'unary')) { + token = lexer.next(); + expr = parseUnary(); + return { + operator: token.value, + method: token.method, + args: [expr] + }; + } + return parsePrimary(); + } + function parsePrimary() { + var token, expr; + token = lexer.peek(); + if (isUndef(token)) { + throw new SyntaxError('Tone.Expr: Unexpected termination of expression'); + } + if (token.type === 'func') { + token = lexer.next(); + return parseFunctionCall(token); + } + if (token.type === 'value') { + token = lexer.next(); + return { + method: token.method, + args: token.value + }; + } + if (matchSyntax(token, '(')) { + lexer.next(); + expr = parseExpression(); + token = lexer.next(); + if (!matchSyntax(token, ')')) { + throw new SyntaxError('Expected )'); + } + return expr; + } + throw new SyntaxError('Tone.Expr: Parse error, cannot process token ' + token.value); + } + function parseFunctionCall(func) { + var token, args = []; + token = lexer.next(); + if (!matchSyntax(token, '(')) { + throw new SyntaxError('Tone.Expr: Expected ( in a function call "' + func.value + '"'); + } + token = lexer.peek(); + if (!matchSyntax(token, ')')) { + args = parseArgumentList(); + } + token = lexer.next(); + if (!matchSyntax(token, ')')) { + throw new SyntaxError('Tone.Expr: Expected ) in a function call "' + func.value + '"'); + } + return { + method: func.method, + args: args, + name: name + }; + } + function parseArgumentList() { + var token, expr, args = []; + while (true) { + expr = parseExpression(); + if (isUndef(expr)) { + break; + } + args.push(expr); + token = lexer.peek(); + if (!matchSyntax(token, ',')) { + break; + } + lexer.next(); + } + return args; + } + return parseExpression(); + }; + Tone.Expr.prototype._eval = function (tree) { + if (!this.isUndef(tree)) { + var node = tree.method(tree.args, this); + this._nodes.push(node); + return node; + } + }; + Tone.Expr.prototype._disposeNodes = function () { + for (var i = 0; i < this._nodes.length; i++) { + var node = this._nodes[i]; + if (this.isFunction(node.dispose)) { + node.dispose(); + } else if (this.isFunction(node.disconnect)) { + node.disconnect(); + } + node = null; + this._nodes[i] = null; + } + this._nodes = null; + }; + Tone.Expr.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._disposeNodes(); + }; + return Tone.Expr; +}(Tone_core_Tone, Tone_signal_Add, Tone_signal_Subtract, Tone_signal_Multiply, Tone_signal_GreaterThan, Tone_signal_GreaterThanZero, Tone_signal_Abs, Tone_signal_Negate, Tone_signal_Modulo, Tone_signal_Pow); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_signal_EqualPowerGain; +Tone_signal_EqualPowerGain = function (Tone) { + 'use strict'; + Tone.EqualPowerGain = function () { + this._eqPower = this.input = this.output = new Tone.WaveShaper(function (val) { + if (Math.abs(val) < 0.001) { + return 0; + } else { + return this.equalPowerScale(val); + } + }.bind(this), 4096); + }; + Tone.extend(Tone.EqualPowerGain, Tone.SignalBase); + Tone.EqualPowerGain.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._eqPower.dispose(); + this._eqPower = null; + return this; + }; + return Tone.EqualPowerGain; +}(Tone_core_Tone); +/** Tone.js module by Yotam Mann, MIT License 2016 http://opensource.org/licenses/MIT **/ +var Tone_component_CrossFade; +Tone_component_CrossFade = function (Tone) { + 'use strict'; + Tone.CrossFade = function (initialFade) { + this.createInsOuts(2, 1); + this.a = this.input[0] = new Tone.Gain(); + this.b = this.input[1] = new Tone.Gain(); + this.fade = new Tone.Signal(this.defaultArg(initialFade, 0.5), Tone.Type.NormalRange); + this._equalPowerA = new Tone.EqualPowerGain(); + this._equalPowerB = new Tone.EqualPowerGain(); + this._invert = new Tone.Expr('1 - $0'); + this.a.connect(this.output); + this.b.connect(this.output); + this.fade.chain(this._equalPowerB, this.b.gain); + this.fade.chain(this._invert, this._equalPowerA, this.a.gain); + this._readOnly('fade'); + }; + Tone.extend(Tone.CrossFade); + Tone.CrossFade.prototype.dispose = function () { + Tone.prototype.dispose.call(this); + this._writable('fade'); + this._equalPowerA.dispose(); + this._equalPowerA = null; + this._equalPowerB.dispose(); + this._equalPowerB = null; + this.fade.dispose(); + this.fade = null; + this._invert.dispose(); + this._invert = null; + this.a.dispose(); + this.a = null; + this.b.dispose(); + this.b = null; + return this; + }; + return Tone.CrossFade; +}(Tone_core_Tone, Tone_signal_Signal, Tone_signal_Expr, Tone_signal_EqualPowerGain); +var effect; +'use strict'; +effect = function () { + var p5sound = master; + var CrossFade = Tone_component_CrossFade; + /** + * Effect is a base class for audio effects in p5.
    + * This module handles the nodes and methods that are + * common and useful for current and future effects. + * + * + * This class is extended by p5.Distortion, + * p5.Compressor, + * p5.Delay, + * p5.Filter, + * p5.Reverb. + * + * @class p5.Effect + * @constructor + * + * @param {Object} [ac] Reference to the audio context of the p5 object + * @param {AudioNode} [input] Gain Node effect wrapper + * @param {AudioNode} [output] Gain Node effect wrapper + * @param {Object} [_drywet] Tone.JS CrossFade node (defaults to value: 1) + * @param {AudioNode} [wet] Effects that extend this class should connect + * to the wet signal to this gain node, so that dry and wet + * signals are mixed properly. + */ + p5.Effect = function () { + this.ac = p5sound.audiocontext; + this.input = this.ac.createGain(); + this.output = this.ac.createGain(); + /** + * The p5.Effect class is built + * using Tone.js CrossFade + * @private + */ + this._drywet = new CrossFade(1); + /** + * In classes that extend + * p5.Effect, connect effect nodes + * to the wet parameter + */ + this.wet = this.ac.createGain(); + this.input.connect(this._drywet.a); + this.wet.connect(this._drywet.b); + this._drywet.connect(this.output); + this.connect(); + //Add to the soundArray + p5sound.soundArray.push(this); + }; + /** + * Set the output volume of the filter. + * + * @method amp + * @param {Number} [vol] amplitude between 0 and 1.0 + * @param {Number} [rampTime] create a fade that lasts until rampTime + * @param {Number} [tFromNow] schedule this event to happen in tFromNow seconds + */ + p5.Effect.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); + }; + /** + * Link effects together in a chain + * Example usage: filter.chain(reverb, delay, panner); + * May be used with an open-ended number of arguments + * + * @method chain + * @param {Object} [arguments] Chain together multiple sound objects + */ + p5.Effect.prototype.chain = function () { + if (arguments.length > 0) { + this.connect(arguments[0]); + for (var i = 1; i < arguments.length; i += 1) { + arguments[i - 1].connect(arguments[i]); + } + } + return this; + }; + /** + * Adjust the dry/wet value. + * + * @method drywet + * @param {Number} [fade] The desired drywet value (0 - 1.0) + */ + p5.Effect.prototype.drywet = function (fade) { + if (typeof fade !== 'undefined') { + this._drywet.fade.value = fade; + } + return this._drywet.fade.value; + }; + /** + * Send output to a p5.js-sound, Web Audio Node, or use signal to + * control an AudioParam + * + * @method connect + * @param {Object} unit + */ + p5.Effect.prototype.connect = function (unit) { + var u = unit || p5.soundOut.input; + this.output.connect(u.input ? u.input : u); + }; + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Effect.prototype.disconnect = function () { + if (this.output) { + this.output.disconnect(); + } + }; + p5.Effect.prototype.dispose = function () { + // remove refernce form soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + if (this.input) { + this.input.disconnect(); + delete this.input; + } + if (this.output) { + this.output.disconnect(); + delete this.output; + } + if (this._drywet) { + this._drywet.disconnect(); + delete this._drywet; + } + if (this.wet) { + this.wet.disconnect(); + delete this.wet; + } + this.ac = undefined; + }; + return p5.Effect; +}(master, Tone_component_CrossFade); +var filter; +'use strict'; +filter = function () { + var p5sound = master; + var Effect = effect; + /** + *

    A p5.Filter uses a Web Audio Biquad Filter to filter + * the frequency response of an input source. Subclasses + * 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. + * + * This class extends p5.Effect. + * Methods amp(), chain(), + * drywet(), connect(), and + * disconnect() are available. + * + * @class p5.Filter + * @extends p5.Effect + * @constructor + * @param {String} [type] 'lowpass' (default), 'highpass', 'bandpass' + * @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); + * } + * } + *
    + */ + //constructor with inheritance + p5.Filter = function (type) { + Effect.call(this); + //add extend Effect by adding a Biquad Filter + /** + * The p5.Filter is built with a + * + * Web Audio BiquadFilter Node. + * + * @property {DelayNode} biquadFilter + */ + this.biquad = this.ac.createBiquadFilter(); + this.input.connect(this.biquad); + this.biquad.connect(this.wet); + if (type) { + this.setType(type); + } + //Properties useful for the toggle method. + this._on = true; + this._untoggledType = this.biquad.type; + }; + p5.Filter.prototype = Object.create(Effect.prototype); + /** + * 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, time) { + src.connect(this.input); + this.set(freq, res, time); + }; + /** + * 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 t = time || 0; + if (freq <= 0) { + freq = 1; + } + if (typeof freq === 'number') { + this.biquad.frequency.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.biquad.frequency.exponentialRampToValueAtTime(freq, this.ac.currentTime + 0.02 + t); + } else if (freq) { + freq.connect(this.biquad.frequency); + } + return this.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 t = time || 0; + if (typeof res === 'number') { + this.biquad.Q.value = res; + this.biquad.Q.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.biquad.Q.linearRampToValueAtTime(res, this.ac.currentTime + 0.02 + t); + } else if (res) { + res.connect(this.biquad.Q); + } + return this.biquad.Q.value; + }; + /** + * Controls the gain attribute of a Biquad Filter. + * This is distinctly different from .amp() which is inherited from p5.Effect + * .amp() controls the volume via the output gain node + * p5.Filter.gain() controls the gain parameter of a Biquad Filter node. + * + * @method gain + * @param {Number} gain + * @return {Number} Returns the current or updated gain value + */ + p5.Filter.prototype.gain = function (gain, time) { + var t = time || 0; + if (typeof gain === 'number') { + this.biquad.gain.value = gain; + this.biquad.gain.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.biquad.gain.linearRampToValueAtTime(gain, this.ac.currentTime + 0.02 + t); + } else if (gain) { + gain.connect(this.biquad.gain); + } + return this.biquad.gain.value; + }; + /** + * Toggle function. Switches between the specified type and allpass + * + * @method toggle + * @return {boolean} [Toggle value] + */ + p5.Filter.prototype.toggle = function () { + this._on = !this._on; + if (this._on === true) { + this.biquad.type = this._untoggledType; + } else if (this._on === false) { + this.biquad.type = 'allpass'; + } + return this._on; + }; + /** + * Set the type of a p5.Filter. Possible types include: + * "lowpass" (default), "highpass", "bandpass", + * "lowshelf", "highshelf", "peaking", "notch", + * "allpass". + * + * @method setType + * @param {String} t + */ + p5.Filter.prototype.setType = function (t) { + this.biquad.type = t; + this._untoggledType = this.biquad.type; + }; + p5.Filter.prototype.dispose = function () { + // remove reference from soundArray + Effect.prototype.dispose.apply(this); + if (this.biquad) { + this.biquad.disconnect(); + delete this.biquad; + } + }; + /** + * 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. + * + * @class p5.LowPass + * @constructor + * @extends p5.Filter + */ + 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. + * + * @class p5.HighPass + * @constructor + * @extends p5.Filter + */ + 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. + * + * @class p5.BandPass + * @constructor + * @extends p5.Filter + */ + p5.BandPass = function () { + p5.Filter.call(this, 'bandpass'); + }; + p5.BandPass.prototype = Object.create(p5.Filter.prototype); + return p5.Filter; +}(master, effect); +var src_eqFilter; +'use strict'; +src_eqFilter = function () { + var Filter = filter; + var p5sound = master; + /** + * EQFilter extends p5.Filter with constraints + * necessary for the p5.EQ + * + * @private + */ + var EQFilter = function (freq, res) { + Filter.call(this, 'peaking'); + this.disconnect(); + this.set(freq, res); + this.biquad.gain.value = 0; + delete this.input; + delete this.output; + delete this._drywet; + delete this.wet; + }; + EQFilter.prototype = Object.create(Filter.prototype); + EQFilter.prototype.amp = function () { + console.warn('`amp()` is not available for p5.EQ bands. Use `.gain()`'); + }; + EQFilter.prototype.drywet = function () { + console.warn('`drywet()` is not available for p5.EQ bands.'); + }; + EQFilter.prototype.connect = function (unit) { + var u = unit || p5.soundOut.input; + if (this.biquad) { + this.biquad.connect(u.input ? u.input : u); + } else { + this.output.connect(u.input ? u.input : u); + } + }; + EQFilter.prototype.disconnect = function () { + if (this.biquad) { + this.biquad.disconnect(); + } + }; + EQFilter.prototype.dispose = function () { + // remove reference form soundArray + var index = p5sound.soundArray.indexOf(this); + p5sound.soundArray.splice(index, 1); + this.disconnect(); + delete this.biquad; + }; + return EQFilter; +}(filter, master); +var eq; +'use strict'; +eq = function () { + var Effect = effect; + var EQFilter = src_eqFilter; + /** + * p5.EQ is an audio effect that performs the function of a multiband + * audio equalizer. Equalization is used to adjust the balance of + * frequency compoenents of an audio signal. This process is commonly used + * in sound production and recording to change the waveform before it reaches + * a sound output device. EQ can also be used as an audio effect to create + * interesting distortions by filtering out parts of the spectrum. p5.EQ is + * built using a chain of Web Audio Biquad Filter Nodes and can be + * instantiated with 3 or 8 bands. Bands can be added or removed from + * the EQ by directly modifying p5.EQ.bands (the array that stores filters). + * + * This class extends p5.Effect. + * Methods amp(), chain(), + * drywet(), connect(), and + * disconnect() are available. + * + * @class p5.EQ + * @constructor + * @extends p5.Effect + * @param {Number} [_eqsize] Constructor will accept 3 or 8, defaults to 3 + * @return {Object} p5.EQ object + * + * @example + *
    + * var eq; + * var band_names; + * var band_index; + * + * var soundFile, play; + * + * function preload() { + * soundFormats('mp3', 'ogg'); + * soundFile = loadSound('assets/beat'); + * } + * + * function setup() { + * eq = new p5.EQ(3); + * soundFile.disconnect(); + * eq.process(soundFile); + * + * band_names = ['lows','mids','highs']; + * band_index = 0; + * play = false; + * textAlign(CENTER); + * } + * + * function draw() { + * background(30); + * noStroke(); + * fill(255); + * text('click to kill',50,25); + * + * fill(255, 40, 255); + * textSize(26); + * text(band_names[band_index],50,55); + * + * fill(255); + * textSize(9); + * text('space = play/pause',50,80); + * } + * + * //If mouse is over canvas, cycle to the next band and kill the frequency + * function mouseClicked() { + * for (var i = 0; i < eq.bands.length; i++) { + * eq.bands[i].gain(0); + * } + * eq.bands[band_index].gain(-40); + * if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) { + * band_index === 2 ? band_index = 0 : band_index++; + * } + * } + * + * //use space bar to trigger play / pause + * function keyPressed() { + * if (key===' ') { + * play = !play + * play ? soundFile.loop() : soundFile.pause(); + * } + * } + *
    + */ + p5.EQ = function (_eqsize) { + Effect.call(this); + //p5.EQ can be of size (3) or (8), defaults to 3 + _eqsize = _eqsize === 3 || _eqsize === 8 ? _eqsize : 3; + var factor; + _eqsize === 3 ? factor = Math.pow(2, 3) : factor = 2; + /** + * The p5.EQ is built with abstracted p5.Filter objects. + * To modify any bands, use methods of the + * p5.Filter API, especially `gain` and `freq`. + * Bands are stored in an array, with indices 0 - 3, or 0 - 7 + * @property {Array} bands + * + */ + this.bands = []; + var freq, res; + for (var i = 0; i < _eqsize; i++) { + if (i === _eqsize - 1) { + freq = 21000; + res = 0.01; + } else if (i === 0) { + freq = 100; + res = 0.1; + } else if (i === 1) { + freq = _eqsize === 3 ? 360 * factor : 360; + res = 1; + } else { + freq = this.bands[i - 1].freq() * factor; + res = 1; + } + this.bands[i] = this._newBand(freq, res); + if (i > 0) { + this.bands[i - 1].connect(this.bands[i].biquad); + } else { + this.input.connect(this.bands[i].biquad); + } + } + this.bands[_eqsize - 1].connect(this.output); + }; + p5.EQ.prototype = Object.create(Effect.prototype); + /** + * Process an input by connecting it to the EQ + * @method process + * @param {Object} src Audio source + */ + p5.EQ.prototype.process = function (src) { + src.connect(this.input); + }; + // /** + // * Set the frequency and gain of each band in the EQ. This method should be + // * called with 3 or 8 frequency and gain pairs, depending on the size of the EQ. + // * ex. eq.set(freq0, gain0, freq1, gain1, freq2, gain2); + // * + // * @method set + // * @param {Number} [freq0] Frequency value for band with index 0 + // * @param {Number} [gain0] Gain value for band with index 0 + // * @param {Number} [freq1] Frequency value for band with index 1 + // * @param {Number} [gain1] Gain value for band with index 1 + // * @param {Number} [freq2] Frequency value for band with index 2 + // * @param {Number} [gain2] Gain value for band with index 2 + // * @param {Number} [freq3] Frequency value for band with index 3 + // * @param {Number} [gain3] Gain value for band with index 3 + // * @param {Number} [freq4] Frequency value for band with index 4 + // * @param {Number} [gain4] Gain value for band with index 4 + // * @param {Number} [freq5] Frequency value for band with index 5 + // * @param {Number} [gain5] Gain value for band with index 5 + // * @param {Number} [freq6] Frequency value for band with index 6 + // * @param {Number} [gain6] Gain value for band with index 6 + // * @param {Number} [freq7] Frequency value for band with index 7 + // * @param {Number} [gain7] Gain value for band with index 7 + // */ + p5.EQ.prototype.set = function () { + if (arguments.length === this.bands.length * 2) { + for (var i = 0; i < arguments.length; i += 2) { + this.bands[i / 2].freq(arguments[i]); + this.bands[i / 2].gain(arguments[i + 1]); + } + } else { + console.error('Argument mismatch. .set() should be called with ' + this.bands.length * 2 + ' arguments. (one frequency and gain value pair for each band of the eq)'); + } + }; + /** + * Add a new band. Creates a p5.Filter and strips away everything but + * the raw biquad filter. This method returns an abstracted p5.Filter, + * which can be added to p5.EQ.bands, in order to create new EQ bands. + * @private + * @method _newBand + * @param {Number} freq + * @param {Number} res + * @return {Object} Abstracted Filter + */ + p5.EQ.prototype._newBand = function (freq, res) { + return new EQFilter(freq, res); + }; + p5.EQ.prototype.dispose = function () { + Effect.prototype.dispose.apply(this); + if (this.bands) { + while (this.bands.length > 0) { + delete this.bands.pop().dispose(); + } + delete this.bands; + } + }; + return p5.EQ; +}(effect, src_eqFilter); +var panner3d; +'use strict'; +panner3d = function () { + var p5sound = master; + var Effect = effect; + /** + * Panner3D is based on the + * Web Audio Spatial Panner Node. + * This panner is a spatial processing node that allows audio to be positioned + * and oriented in 3D space. + * + * The position is relative to an + * Audio Context Listener, which can be accessed + * by p5.soundOut.audiocontext.listener + * + * + * @class p5.Panner3D + * @constructor + */ + p5.Panner3D = function () { + Effect.call(this); + /** + * + * Web Audio Spatial Panner Node + * + * Properties include + * - panningModel: "equal power" or "HRTF" + * - distanceModel: "linear", "inverse", or "exponential" + * + * @property {AudioNode} panner + * + */ + this.panner = this.ac.createPanner(); + this.panner.panningModel = 'HRTF'; + this.panner.distanceModel = 'linear'; + this.panner.connect(this.output); + this.input.connect(this.panner); + }; + p5.Panner3D.prototype = Object.create(Effect.prototype); + /** + * Connect an audio sorce + * + * @method process + * @param {Object} src Input source + */ + p5.Panner3D.prototype.process = function (src) { + src.connect(this.input); + }; + /** + * Set the X,Y,Z position of the Panner + * @method set + * @param {Number} xVal + * @param {Number} yVal + * @param {Number} zVal + * @param {Number} time + * @return {Array} Updated x, y, z values as an array + */ + p5.Panner3D.prototype.set = function (xVal, yVal, zVal, time) { + this.positionX(xVal, time); + this.positionY(yVal, time); + this.positionZ(zVal, time); + return [ + this.panner.positionX.value, + this.panner.positionY.value, + this.panner.positionZ.value + ]; + }; + /** + * Getter and setter methods for position coordinates + * @method positionX + * @return {Number} updated coordinate value + */ + /** + * Getter and setter methods for position coordinates + * @method positionY + * @return {Number} updated coordinate value + */ + /** + * Getter and setter methods for position coordinates + * @method positionZ + * @return {Number} updated coordinate value + */ + p5.Panner3D.prototype.positionX = function (xVal, time) { + var t = time || 0; + if (typeof xVal === 'number') { + this.panner.positionX.value = xVal; + this.panner.positionX.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.panner.positionX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t); + } else if (xVal) { + xVal.connect(this.panner.positionX); + } + return this.panner.positionX.value; + }; + p5.Panner3D.prototype.positionY = function (yVal, time) { + var t = time || 0; + if (typeof yVal === 'number') { + this.panner.positionY.value = yVal; + this.panner.positionY.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.panner.positionY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t); + } else if (yVal) { + yVal.connect(this.panner.positionY); + } + return this.panner.positionY.value; + }; + p5.Panner3D.prototype.positionZ = function (zVal, time) { + var t = time || 0; + if (typeof zVal === 'number') { + this.panner.positionZ.value = zVal; + this.panner.positionZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.panner.positionZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t); + } else if (zVal) { + zVal.connect(this.panner.positionZ); + } + return this.panner.positionZ.value; + }; + /** + * Set the X,Y,Z position of the Panner + * @method orient + * @param {Number} xVal + * @param {Number} yVal + * @param {Number} zVal + * @param {Number} time + * @return {Array} Updated x, y, z values as an array + */ + p5.Panner3D.prototype.orient = function (xVal, yVal, zVal, time) { + this.orientX(xVal, time); + this.orientY(yVal, time); + this.orientZ(zVal, time); + return [ + this.panner.orientationX.value, + this.panner.orientationY.value, + this.panner.orientationZ.value + ]; + }; + /** + * Getter and setter methods for orient coordinates + * @method orientX + * @return {Number} updated coordinate value + */ + /** + * Getter and setter methods for orient coordinates + * @method orientY + * @return {Number} updated coordinate value + */ + /** + * Getter and setter methods for orient coordinates + * @method orientZ + * @return {Number} updated coordinate value + */ + p5.Panner3D.prototype.orientX = function (xVal, time) { + var t = time || 0; + if (typeof xVal === 'number') { + this.panner.orientationX.value = xVal; + this.panner.orientationX.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.panner.orientationX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t); + } else if (xVal) { + xVal.connect(this.panner.orientationX); + } + return this.panner.orientationX.value; + }; + p5.Panner3D.prototype.orientY = function (yVal, time) { + var t = time || 0; + if (typeof yVal === 'number') { + this.panner.orientationY.value = yVal; + this.panner.orientationY.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.panner.orientationY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t); + } else if (yVal) { + yVal.connect(this.panner.orientationY); + } + return this.panner.orientationY.value; + }; + p5.Panner3D.prototype.orientZ = function (zVal, time) { + var t = time || 0; + if (typeof zVal === 'number') { + this.panner.orientationZ.value = zVal; + this.panner.orientationZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.panner.orientationZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t); + } else if (zVal) { + zVal.connect(this.panner.orientationZ); + } + return this.panner.orientationZ.value; + }; + /** + * Set the rolloff factor and max distance + * @method setFalloff + * @param {Number} [maxDistance] + * @param {Number} [rolloffFactor] + */ + p5.Panner3D.prototype.setFalloff = function (maxDistance, rolloffFactor) { + this.maxDist(maxDistance); + this.rolloff(rolloffFactor); + }; + /** + * Maxium distance between the source and the listener + * @method maxDist + * @param {Number} maxDistance + * @return {Number} updated value + */ + p5.Panner3D.prototype.maxDist = function (maxDistance) { + if (typeof maxDistance === 'number') { + this.panner.maxDistance = maxDistance; + } + return this.panner.maxDistance; + }; + /** + * How quickly the volume is reduced as the source moves away from the listener + * @method rollof + * @param {Number} rolloffFactor + * @return {Number} updated value + */ + p5.Panner3D.prototype.rolloff = function (rolloffFactor) { + if (typeof rolloffFactor === 'number') { + this.panner.rolloffFactor = rolloffFactor; + } + return this.panner.rolloffFactor; + }; + p5.Panner3D.dispose = function () { + Effect.prototype.dispose.apply(this); + if (this.panner) { + this.panner.disconnect(); + delete this.panner; + } + }; + return p5.Panner3D; +}(master, effect); +var listener3d; +'use strict'; +listener3d = function () { + var p5sound = master; + var Effect = effect; + // /** + // * listener is a class that can construct both a Spatial Panner + // * and a Spatial Listener. The panner is based on the + // * Web Audio Spatial Panner Node + // * https://www.w3.org/TR/webaudio/#the-listenernode-interface + // * This panner is a spatial processing node that allows audio to be positioned + // * and oriented in 3D space. + // * + // * The Listener modifies the properties of the Audio Context Listener. + // * Both objects types use the same methods. The default is a spatial panner. + // * + // * p5.Panner3D - Constructs a Spatial Panner
    + // * p5.Listener3D - Constructs a Spatial Listener
    + // * + // * @class listener + // * @constructor + // * @return {Object} p5.Listener3D Object + // * + // * @param {Web Audio Node} listener Web Audio Spatial Panning Node + // * @param {AudioParam} listener.panningModel "equal power" or "HRTF" + // * @param {AudioParam} listener.distanceModel "linear", "inverse", or "exponential" + // * @param {String} [type] [Specify construction of a spatial panner or listener] + // */ + p5.Listener3D = function (type) { + this.ac = p5sound.audiocontext; + this.listener = this.ac.listener; + }; + // /** + // * Connect an audio sorce + // * @param {Object} src Input source + // */ + p5.Listener3D.prototype.process = function (src) { + src.connect(this.input); + }; + // /** + // * Set the X,Y,Z position of the Panner + // * @param {[Number]} xVal + // * @param {[Number]} yVal + // * @param {[Number]} zVal + // * @param {[Number]} time + // * @return {[Array]} [Updated x, y, z values as an array] + // */ + p5.Listener3D.prototype.position = function (xVal, yVal, zVal, time) { + this.positionX(xVal, time); + this.positionY(yVal, time); + this.positionZ(zVal, time); + return [ + this.listener.positionX.value, + this.listener.positionY.value, + this.listener.positionZ.value + ]; + }; + // /** + // * Getter and setter methods for position coordinates + // * @return {Number} [updated coordinate value] + // */ + p5.Listener3D.prototype.positionX = function (xVal, time) { + var t = time || 0; + if (typeof xVal === 'number') { + this.listener.positionX.value = xVal; + this.listener.positionX.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.positionX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t); + } else if (xVal) { + xVal.connect(this.listener.positionX); + } + return this.listener.positionX.value; + }; + p5.Listener3D.prototype.positionY = function (yVal, time) { + var t = time || 0; + if (typeof yVal === 'number') { + this.listener.positionY.value = yVal; + this.listener.positionY.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.positionY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t); + } else if (yVal) { + yVal.connect(this.listener.positionY); + } + return this.listener.positionY.value; + }; + p5.Listener3D.prototype.positionZ = function (zVal, time) { + var t = time || 0; + if (typeof zVal === 'number') { + this.listener.positionZ.value = zVal; + this.listener.positionZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.positionZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t); + } else if (zVal) { + zVal.connect(this.listener.positionZ); + } + return this.listener.positionZ.value; + }; + // cannot define method when class definition is commented + // /** + // * Overrides the listener orient() method because Listener has slightly + // * different params. In human terms, Forward vectors are the direction the + // * nose is pointing. Up vectors are the direction of the top of the head. + // * + // * @method orient + // * @param {Number} xValF Forward vector X direction + // * @param {Number} yValF Forward vector Y direction + // * @param {Number} zValF Forward vector Z direction + // * @param {Number} xValU Up vector X direction + // * @param {Number} yValU Up vector Y direction + // * @param {Number} zValU Up vector Z direction + // * @param {Number} time + // * @return {Array} All orienation params + // */ + p5.Listener3D.prototype.orient = function (xValF, yValF, zValF, xValU, yValU, zValU, time) { + if (arguments.length === 3 || arguments.length === 4) { + time = arguments[3]; + this.orientForward(xValF, yValF, zValF, time); + } else if (arguments.length === 6 || arguments === 7) { + this.orientForward(xValF, yValF, zValF); + this.orientUp(xValU, yValU, zValU, time); + } + return [ + this.listener.forwardX.value, + this.listener.forwardY.value, + this.listener.forwardZ.value, + this.listener.upX.value, + this.listener.upY.value, + this.listener.upZ.value + ]; + }; + p5.Listener3D.prototype.orientForward = function (xValF, yValF, zValF, time) { + this.forwardX(xValF, time); + this.forwardY(yValF, time); + this.forwardZ(zValF, time); + return [ + this.listener.forwardX, + this.listener.forwardY, + this.listener.forwardZ + ]; + }; + p5.Listener3D.prototype.orientUp = function (xValU, yValU, zValU, time) { + this.upX(xValU, time); + this.upY(yValU, time); + this.upZ(zValU, time); + return [ + this.listener.upX, + this.listener.upY, + this.listener.upZ + ]; + }; + // /** + // * Getter and setter methods for orient coordinates + // * @return {Number} [updated coordinate value] + // */ + p5.Listener3D.prototype.forwardX = function (xVal, time) { + var t = time || 0; + if (typeof xVal === 'number') { + this.listener.forwardX.value = xVal; + this.listener.forwardX.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.forwardX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t); + } else if (xVal) { + xVal.connect(this.listener.forwardX); + } + return this.listener.forwardX.value; + }; + p5.Listener3D.prototype.forwardY = function (yVal, time) { + var t = time || 0; + if (typeof yVal === 'number') { + this.listener.forwardY.value = yVal; + this.listener.forwardY.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.forwardY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t); + } else if (yVal) { + yVal.connect(this.listener.forwardY); + } + return this.listener.forwardY.value; + }; + p5.Listener3D.prototype.forwardZ = function (zVal, time) { + var t = time || 0; + if (typeof zVal === 'number') { + this.listener.forwardZ.value = zVal; + this.listener.forwardZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.forwardZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t); + } else if (zVal) { + zVal.connect(this.listener.forwardZ); + } + return this.listener.forwardZ.value; + }; + p5.Listener3D.prototype.upX = function (xVal, time) { + var t = time || 0; + if (typeof xVal === 'number') { + this.listener.upX.value = xVal; + this.listener.upX.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.upX.linearRampToValueAtTime(xVal, this.ac.currentTime + 0.02 + t); + } else if (xVal) { + xVal.connect(this.listener.upX); + } + return this.listener.upX.value; + }; + p5.Listener3D.prototype.upY = function (yVal, time) { + var t = time || 0; + if (typeof yVal === 'number') { + this.listener.upY.value = yVal; + this.listener.upY.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.upY.linearRampToValueAtTime(yVal, this.ac.currentTime + 0.02 + t); + } else if (yVal) { + yVal.connect(this.listener.upY); + } + return this.listener.upY.value; + }; + p5.Listener3D.prototype.upZ = function (zVal, time) { + var t = time || 0; + if (typeof zVal === 'number') { + this.listener.upZ.value = zVal; + this.listener.upZ.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.listener.upZ.linearRampToValueAtTime(zVal, this.ac.currentTime + 0.02 + t); + } else if (zVal) { + zVal.connect(this.listener.upZ); + } + return this.listener.upZ.value; + }; + return p5.Listener3D; +}(master, effect); +var delay; +'use strict'; +delay = function () { + var Filter = filter; + var Effect = effect; + /** + * 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 (the + * defaul value) 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. + * + * + * This class extends p5.Effect. + * Methods amp(), chain(), + * drywet(), connect(), and + * disconnect() are available. + * @class p5.Delay + * @extends p5.Effect + * @constructor + * @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.Envelope(.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 () { + Effect.call(this); + 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 {DelayNode} leftDelay + */ + this.leftDelay = this.ac.createDelay(); + /** + * The p5.Delay is built with two + * + * Web Audio Delay Nodes, one for each stereo channel. + * + * @property {DelayNode} rightDelay + */ + this.rightDelay = this.ac.createDelay(); + this._leftFilter = new Filter(); + this._rightFilter = new 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.wet); + 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; + // set initial feedback to 0.5 + this.feedback(0.5); + }; + p5.Delay.prototype = Object.create(Effect.prototype); + /** + * 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.value = feedback; + this._rightGain.gain.value = feedback; + 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. The default value is 0.5 + * + * @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 + * @returns {Number} Feedback value + * + */ + p5.Delay.prototype.feedback = function (f) { + // if f is an audio node... + if (f && 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 if (typeof f === 'number') { + this._leftGain.gain.value = f; + this._rightGain.gain.value = f; + } + // return value of feedback + return this._leftGain.gain.value; + }; + /** + * 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._rightFilter.output.connect(this._merge, 0, 1); + this._leftFilter.output.connect(this.leftDelay); + this._rightFilter.output.connect(this.rightDelay); + } + }; + // DocBlocks for methods inherited from p5.Effect + /** + * 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 + */ + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + /** + * Disconnect all output. + * + * @method disconnect + */ + p5.Delay.prototype.dispose = function () { + Effect.prototype.dispose.apply(this); + this._split.disconnect(); + this._leftFilter.dispose(); + this._rightFilter.dispose(); + this._merge.disconnect(); + this._leftGain.disconnect(); + this._rightGain.disconnect(); + this.leftDelay.disconnect(); + this.rightDelay.disconnect(); + this._split = undefined; + this._leftFilter = undefined; + this._rightFilter = undefined; + this._merge = undefined; + this._leftGain = undefined; + this._rightGain = undefined; + this.leftDelay = undefined; + this.rightDelay = undefined; + }; +}(filter, effect); +var reverb; +'use strict'; +reverb = function () { + var CustomError = errorHandler; + var Effect = effect; + /** + * 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. + * + * This class extends p5.Effect. + * Methods amp(), chain(), + * drywet(), connect(), and + * disconnect() are available. + * + * @class p5.Reverb + * @extends p5.Effect + * @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 () { + Effect.call(this); + this._initConvolverNode(); + // otherwise, Safari distorts + this.input.gain.value = 0.5; + // default params + this._seconds = 3; + this._decay = 2; + this._reverse = false; + this._buildImpulse(); + }; + p5.Reverb.prototype = Object.create(Effect.prototype); + p5.Reverb.prototype._initConvolverNode = function () { + this.convolverNode = this.ac.createConvolver(); + this.input.connect(this.convolverNode); + this.convolverNode.connect(this.wet); + }; + p5.Reverb.prototype._teardownConvolverNode = function () { + if (this.convolverNode) { + this.convolverNode.disconnect(); + delete this.convolverNode; + } + }; + p5.Reverb.prototype._setBuffer = function (audioBuffer) { + this._teardownConvolverNode(); + this._initConvolverNode(); + this.convolverNode.buffer = audioBuffer; + }; + /** + * 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(); + } + }; + // DocBlocks for methods inherited from p5.Effect + /** + * Set the output level of the reverb 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 + */ + /** + * Send output to a p5.sound or web audio object + * + * @method connect + * @param {Object} unit + */ + /** + * Disconnect all output. + * + * @method 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._setBuffer(impulse); + }; + p5.Reverb.prototype.dispose = function () { + Effect.prototype.dispose.apply(this); + this._teardownConvolverNode(); + }; + // ======================================================================= + // *** 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 + * @extends p5.Effect + * @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) { + p5.Reverb.call(this); + /** + * Internally, the p5.Convolver uses the a + * + * Web Audio Convolver Node. + * + * @property {ConvolverNode} convolverNode + */ + this._initConvolverNode(); + // otherwise, Safari distorts + this.input.gain.value = 0.5; + if (path) { + this.impulses = []; + this._loadBuffer(path, callback, errorCallback); + } else { + // parameters + this._seconds = 3; + this._decay = 2; + this._reverse = false; + this._buildImpulse(); + } + }; + 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 self = this; + var cReverb = new p5.Convolver(path, function (buffer) { + if (typeof callback === 'function') { + callback(buffer); + } + if (typeof self._decrementPreload === 'function') { + self._decrementPreload(); + } + }, 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._setBuffer(buffer.audioBuffer); + if (callback) { + callback(buffer); + } + }, // error decoding buffer. "e" is undefined in Chrome 11/22/2015 + function () { + 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 () { + 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 {Array} impulses + */ + 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._setBuffer(this.impulses[id].audioBuffer); + } + if (typeof id === 'string') { + for (var i = 0; i < this.impulses.length; i++) { + if (this.impulses[i].name === id) { + this._setBuffer(this.impulses[i].audioBuffer); + break; + } + } + } + }; + p5.Convolver.prototype.dispose = function () { + p5.Reverb.prototype.dispose.apply(this); + // remove all the Impulse Response buffers + for (var i in this.impulses) { + if (this.impulses[i]) { + this.impulses[i] = null; + } + } + }; +}(errorHandler, effect); +/** 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.getValueAtTime = function (time) { + var event = this.get(time); + if (event !== null) { + return event.state; + } else { + return this._initial; + } + }; + Tone.TimelineState.prototype.setStateAtTime = function (state, time) { + this.add({ + 'state': state, + 'time': 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 () { + Tone.Emitter.call(this); + var options = this.optionsObject(arguments, [ + 'callback', + 'frequency' + ], Tone.Clock.defaults); + this.callback = options.callback; + this._nextTick = 0; + this._lastState = Tone.State.Stopped; + this.frequency = new Tone.TimelineSignal(options.frequency, Tone.Type.Frequency); + this._readOnly('frequency'); + this.ticks = 0; + this._state = new Tone.TimelineState(Tone.State.Stopped); + this._boundLoop = this._loop.bind(this); + this.context.on('tick', this._boundLoop); + }; + Tone.extend(Tone.Clock, Tone.Emitter); + Tone.Clock.defaults = { + 'callback': Tone.noOp, + 'frequency': 1, + 'lookAhead': 'auto' + }; + Object.defineProperty(Tone.Clock.prototype, 'state', { + get: function () { + return this._state.getValueAtTime(this.now()); + } + }); + Tone.Clock.prototype.start = function (time, offset) { + time = this.toSeconds(time); + if (this._state.getValueAtTime(time) !== Tone.State.Started) { + this._state.add({ + 'state': Tone.State.Started, + 'time': time, + 'offset': offset + }); + } + return this; + }; + Tone.Clock.prototype.stop = function (time) { + time = this.toSeconds(time); + this._state.cancel(time); + this._state.setStateAtTime(Tone.State.Stopped, time); + return this; + }; + Tone.Clock.prototype.pause = function (time) { + time = this.toSeconds(time); + if (this._state.getValueAtTime(time) === Tone.State.Started) { + this._state.setStateAtTime(Tone.State.Paused, time); + } + return this; + }; + Tone.Clock.prototype._loop = function () { + var now = this.now(); + var lookAhead = this.context.lookAhead; + var updateInterval = this.context.updateInterval; + var lagCompensation = this.context.lag * 2; + var loopInterval = now + lookAhead + updateInterval + lagCompensation; + while (loopInterval > this._nextTick && this._state) { + var currentState = this._state.getValueAtTime(this._nextTick); + if (currentState !== this._lastState) { + this._lastState = currentState; + var event = this._state.get(this._nextTick); + if (currentState === Tone.State.Started) { + this._nextTick = event.time; + if (!this.isUndef(event.offset)) { + this.ticks = event.offset; + } + this.emit('start', event.time, this.ticks); + } else if (currentState === Tone.State.Stopped) { + this.ticks = 0; + this.emit('stop', event.time); + } else if (currentState === Tone.State.Paused) { + this.emit('pause', event.time); + } + } + var tickTime = this._nextTick; + if (this.frequency) { + this._nextTick += 1 / this.frequency.getValueAtTime(this._nextTick); + if (currentState === Tone.State.Started) { + this.callback(tickTime); + this.ticks++; + } + } + } + }; + Tone.Clock.prototype.getStateAtTime = function (time) { + time = this.toSeconds(time); + return this._state.getValueAtTime(time); + }; + Tone.Clock.prototype.dispose = function () { + Tone.Emitter.prototype.dispose.call(this); + this.context.off('tick', this._boundLoop); + this._writable('frequency'); + this.frequency.dispose(); + this.frequency = null; + this._boundLoop = null; + this._nextTick = Infinity; + this.callback = null; + this._state.dispose(); + this._state = null; + }; + return Tone.Clock; +}(Tone_core_Tone, Tone_signal_TimelineSignal, Tone_core_TimelineState, Tone_core_Emitter); +var metro; +'use strict'; +metro = function () { + 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; + 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.prevTick = 0; + this.tatumTime = 0; + this.tickCallback = function () { + }; + }; + p5.Metro.prototype.ontick = function (tickTime) { + var elapsedTime = tickTime - this.prevTick; + var secondsFromNow = tickTime - p5sound.audiocontext.currentTime; + if (elapsedTime - this.tatumTime <= -0.02) { + return; + } else { + // console.log('ok', this.syncedParts[0].phrases[0].name); + this.prevTick = tickTime; + // for all of the active things on the metro: + var self = this; + this.syncedParts.forEach(function (thisPart) { + if (!thisPart.isPlaying) + return; + thisPart.incrementStep(secondsFromNow); + // each synced source keeps track of its own beat number + thisPart.phrases.forEach(function (thisPhrase) { + var phraseArray = thisPhrase.sequence; + var bNum = self.metroTicks % phraseArray.length; + if (phraseArray[bNum] !== 0 && (self.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; + this.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 () { + 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; + this.clock.stop(now + t); + }; + p5.Metro.prototype.beatLength = function (tatums) { + this.tatums = 1 / tatums / 4; + }; +}(master, Tone_core_Clock); +var looper; +'use strict'; +looper = function () { + 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. + * + * @method setBPM + * @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) { + if (p5sound.parts[i]) { + 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 {Array} sequence + */ + 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 a 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, e.g. use 1/4, or 0.25 for a quater note (default is 1/16, a sixteenth 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 tempo, in Beats Per Minute, of this 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. Playback will resume from the begining of the Part when it is played again. + * + * @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]; + } + } + }; + /** + * Find all sequences with the specified name, and replace their patterns with the specified 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(); + } + } + }; + /** + * Set the function that will be called at every step. This will clear the previous function. + * + * @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} [...parts] One or multiple parts, to be played in sequence. + */ + p5.Score = function () { + // for all of the arguments + this.parts = []; + this.currentPart = 0; + var thisScore = this; + for (var i in arguments) { + if (arguments[i] && this.parts[i]) { + 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 () { + var self = this; + this.parts.forEach(function (part) { + self.resetParts[part]; + }); + }; + p5.Score.prototype.resetPart = function (i) { + this.parts[i].stop(); + this.parts[i].partStep = 0; + for (var p in this.parts[i].phrases) { + if (this.parts[i]) { + this.parts[i].phrases[p].phraseStep = 0; + } + } + }; + /** + * Set the tempo for all parts in the score + * + * @method setBPM + * @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) { + if (this.parts[i]) { + 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 soundloop; +'use strict'; +soundloop = function () { + var p5sound = master; + var Clock = Tone_core_Clock; + /** + * SoundLoop + * + * @class p5.SoundLoop + * @constructor + * + * @param {Function} callback this function will be called on each iteration of theloop + * @param {Number|String} [interval] amount of time or beats for each iteration of the loop + * defaults to 1 + * + * @example + *
    + * var click; + * var looper1; + * + * function preload() { + * click = loadSound('assets/drum.mp3'); + * } + * + * function setup() { + * //the looper's callback is passed the timeFromNow + * //this value should be used as a reference point from + * //which to schedule sounds + * looper1 = new p5.SoundLoop(function(timeFromNow){ + * click.play(timeFromNow); + * background(255 * (looper1.iterations % 2)); + * }, 2); + * + * //stop after 10 iteratios; + * looper1.maxIterations = 10; + * //start the loop + * looper1.start(); + * } + *
    + */ + p5.SoundLoop = function (callback, interval) { + this.callback = callback; + /** + * musicalTimeMode uses Tone.Time convention + * true if string, false if number + * @property {Boolean} musicalTimeMode + */ + this.musicalTimeMode = typeof this._interval === 'number' ? false : true; + this._interval = interval || 1; + /** + * musicalTimeMode variables + * modify these only when the interval is specified in musicalTime format as a string + */ + this._timeSignature = 4; + this._bpm = 60; + this.isPlaying = false; + /** + * Set a limit to the number of loops to play. defaults to Infinity + * @property {Number} maxIterations + */ + this.maxIterations = Infinity; + var self = this; + this.clock = new Clock({ + 'callback': function (time) { + var timeFromNow = time - p5sound.audiocontext.currentTime; + /** + * Do not initiate the callback if timeFromNow is < 0 + * This ususually occurs for a few milliseconds when the page + * is not fully loaded + * + * The callback should only be called until maxIterations is reached + */ + if (timeFromNow > 0 && self.iterations <= self.maxIterations) { + self.callback(timeFromNow); + } + }, + 'frequency': this._calcFreq() + }); + }; + /** + * Start the loop + * @method start + * @param {Number} [timeFromNow] schedule a starting time + */ + p5.SoundLoop.prototype.start = function (timeFromNow) { + var t = timeFromNow || 0; + var now = p5sound.audiocontext.currentTime; + if (!this.isPlaying) { + this.clock.start(now + t); + this.isPlaying = true; + } + }; + /** + * Stop the loop + * @method stop + * @param {Number} [timeFromNow] schedule a stopping time + */ + p5.SoundLoop.prototype.stop = function (timeFromNow) { + var t = timeFromNow || 0; + var now = p5sound.audiocontext.currentTime; + if (this.isPlaying) { + this.clock.stop(now + t); + this.isPlaying = false; + } + }; + /** + * Pause the loop + * @method pause + * @param {Number} [timeFromNow] schedule a pausing time + */ + p5.SoundLoop.prototype.pause = function (timeFromNow) { + var t = timeFromNow || 0; + var now = p5sound.audiocontext.currentTime; + if (this.isPlaying) { + this.clock.pause(now + t); + this.isPlaying = false; + } + }; + /** + * Synchronize loops. Use this method to start two more more loops in synchronization + * or to start a loop in synchronization with a loop that is already playing + * This method will schedule the implicit loop in sync with the explicit master loop + * i.e. loopToStart.syncedStart(loopToSyncWith) + * + * @method syncedStart + * @param {Object} otherLoop a p5.SoundLoop to sync with + * @param {Number} [timeFromNow] Start the loops in sync after timeFromNow seconds + */ + p5.SoundLoop.prototype.syncedStart = function (otherLoop, timeFromNow) { + var t = timeFromNow || 0; + var now = p5sound.audiocontext.currentTime; + if (!otherLoop.isPlaying) { + otherLoop.clock.start(now + t); + otherLoop.isPlaying = true; + this.clock.start(now + t); + this.isPlaying = true; + } else if (otherLoop.isPlaying) { + var time = otherLoop.clock._nextTick - p5sound.audiocontext.currentTime; + this.clock.start(now + time); + this.isPlaying = true; + } + }; + /** + * Updates frequency value, reflected in next callback + * @private + * @method _update + */ + p5.SoundLoop.prototype._update = function () { + this.clock.frequency.value = this._calcFreq(); + }; + /** + * Calculate the frequency of the clock's callback based on bpm, interval, and timesignature + * @private + * @method _calcFreq + * @return {Number} new clock frequency value + */ + p5.SoundLoop.prototype._calcFreq = function () { + //Seconds mode, bpm / timesignature has no effect + if (typeof this._interval === 'number') { + this.musicalTimeMode = false; + return 1 / this._interval; + } else if (typeof this._interval === 'string') { + this.musicalTimeMode = true; + return this._bpm / 60 / this._convertNotation(this._interval) * (this._timeSignature / 4); + } + }; + /** + * Convert notation from musical time format to seconds + * Uses Tone.Time convention + * @private + * @method _convertNotation + * @param {String} value value to be converted + * @return {Number} converted value in seconds + */ + p5.SoundLoop.prototype._convertNotation = function (value) { + var type = value.slice(-1); + value = Number(value.slice(0, -1)); + switch (type) { + case 'm': + return this._measure(value); + case 'n': + return this._note(value); + default: + console.warn('Specified interval is not formatted correctly. See Tone.js ' + 'timing reference for more info: https://github.com/Tonejs/Tone.js/wiki/Time'); + } + }; + /** + * Helper conversion methods of measure and note + * @private + * @method _measure + * @private + * @method _note + */ + p5.SoundLoop.prototype._measure = function (value) { + return value * this._timeSignature; + }; + p5.SoundLoop.prototype._note = function (value) { + return this._timeSignature / value; + }; + /** + * Getters and Setters, setting any paramter will result in a change in the clock's + * frequency, that will be reflected after the next callback + * beats per minute (defaults to 60) + * @property {Number} bpm + */ + Object.defineProperty(p5.SoundLoop.prototype, 'bpm', { + get: function () { + return this._bpm; + }, + set: function (bpm) { + if (!this.musicalTimeMode) { + console.warn('Changing the BPM in "seconds" mode has no effect. ' + 'BPM is only relevant in musicalTimeMode ' + 'when the interval is specified as a string ' + '("2n", "4n", "1m"...etc)'); + } + this._bpm = bpm; + this._update(); + } + }); + /** + * number of quarter notes in a measure (defaults to 4) + * @property {Number} timeSignature + */ + Object.defineProperty(p5.SoundLoop.prototype, 'timeSignature', { + get: function () { + return this._timeSignature; + }, + set: function (timeSig) { + if (!this.musicalTimeMode) { + console.warn('Changing the timeSignature in "seconds" mode has no effect. ' + 'BPM is only relevant in musicalTimeMode ' + 'when the interval is specified as a string ' + '("2n", "4n", "1m"...etc)'); + } + this._timeSignature = timeSig; + this._update(); + } + }); + /** + * length of the loops interval + * @property {Number|String} interval + */ + Object.defineProperty(p5.SoundLoop.prototype, 'interval', { + get: function () { + return this._interval; + }, + set: function (interval) { + this.musicalTimeMode = typeof interval === 'Number' ? false : true; + this._interval = interval; + this._update(); + } + }); + /** + * how many times the callback has been called so far + * @property {Number} iterations + * @readonly + */ + Object.defineProperty(p5.SoundLoop.prototype, 'iterations', { + get: function () { + return this.clock.ticks; + } + }); + return p5.SoundLoop; +}(master, Tone_core_Clock); +var compressor; +compressor = function () { + 'use strict'; + var p5sound = master; + var Effect = effect; + var CustomError = errorHandler; + /** + * Compressor is an audio effect class that performs dynamics compression + * on an audio input source. This is a very commonly used technique in music + * and sound production. Compression creates an overall louder, richer, + * and fuller sound by lowering the volume of louds and raising that of softs. + * Compression can be used to avoid clipping (sound distortion due to + * peaks in volume) and is especially useful when many sounds are played + * at once. Compression can be used on indivudal sound sources in addition + * to the master output. + * + * This class extends p5.Effect. + * Methods amp(), chain(), + * drywet(), connect(), and + * disconnect() are available. + * + * @class p5.Compressor + * @constructor + * @extends p5.Effect + * + * + */ + p5.Compressor = function () { + Effect.call(this); + /** + * The p5.Compressor is built with a Web Audio Dynamics Compressor Node + * + * @property {AudioNode} compressor + */ + this.compressor = this.ac.createDynamicsCompressor(); + this.input.connect(this.compressor); + this.compressor.connect(this.wet); + }; + p5.Compressor.prototype = Object.create(Effect.prototype); + /** + * Performs the same function as .connect, but also accepts + * optional parameters to set compressor's audioParams + * @method process + * + * @param {Object} src Sound source to be connected + * + * @param {Number} [attack] The amount of time (in seconds) to reduce the gain by 10dB, + * default = .003, range 0 - 1 + * @param {Number} [knee] A decibel value representing the range above the + * threshold where the curve smoothly transitions to the "ratio" portion. + * default = 30, range 0 - 40 + * @param {Number} [ratio] The amount of dB change in input for a 1 dB change in output + * default = 12, range 1 - 20 + * @param {Number} [threshold] The decibel value above which the compression will start taking effect + * default = -24, range -100 - 0 + * @param {Number} [release] The amount of time (in seconds) to increase the gain by 10dB + * default = .25, range 0 - 1 + */ + p5.Compressor.prototype.process = function (src, attack, knee, ratio, threshold, release) { + src.connect(this.input); + this.set(attack, knee, ratio, threshold, release); + }; + /** + * Set the paramters of a compressor. + * @method set + * @param {Number} attack The amount of time (in seconds) to reduce the gain by 10dB, + * default = .003, range 0 - 1 + * @param {Number} knee A decibel value representing the range above the + * threshold where the curve smoothly transitions to the "ratio" portion. + * default = 30, range 0 - 40 + * @param {Number} ratio The amount of dB change in input for a 1 dB change in output + * default = 12, range 1 - 20 + * @param {Number} threshold The decibel value above which the compression will start taking effect + * default = -24, range -100 - 0 + * @param {Number} release The amount of time (in seconds) to increase the gain by 10dB + * default = .25, range 0 - 1 + */ + p5.Compressor.prototype.set = function (attack, knee, ratio, threshold, release) { + if (typeof attack !== 'undefined') { + this.attack(attack); + } + if (typeof knee !== 'undefined') { + this.knee(knee); + } + if (typeof ratio !== 'undefined') { + this.ratio(ratio); + } + if (typeof threshold !== 'undefined') { + this.threshold(threshold); + } + if (typeof release !== 'undefined') { + this.release(release); + } + }; + /** + * Get current attack or set value w/ time ramp + * + * + * @method attack + * @param {Number} [attack] Attack is the amount of time (in seconds) to reduce the gain by 10dB, + * default = .003, range 0 - 1 + * @param {Number} [time] Assign time value to schedule the change in value + */ + p5.Compressor.prototype.attack = function (attack, time) { + var t = time || 0; + if (typeof attack == 'number') { + this.compressor.attack.value = attack; + this.compressor.attack.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.compressor.attack.linearRampToValueAtTime(attack, this.ac.currentTime + 0.02 + t); + } else if (typeof attack !== 'undefined') { + attack.connect(this.compressor.attack); + } + return this.compressor.attack.value; + }; + /** + * Get current knee or set value w/ time ramp + * + * @method knee + * @param {Number} [knee] A decibel value representing the range above the + * threshold where the curve smoothly transitions to the "ratio" portion. + * default = 30, range 0 - 40 + * @param {Number} [time] Assign time value to schedule the change in value + */ + p5.Compressor.prototype.knee = function (knee, time) { + var t = time || 0; + if (typeof knee == 'number') { + this.compressor.knee.value = knee; + this.compressor.knee.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.compressor.knee.linearRampToValueAtTime(knee, this.ac.currentTime + 0.02 + t); + } else if (typeof knee !== 'undefined') { + knee.connect(this.compressor.knee); + } + return this.compressor.knee.value; + }; + /** + * Get current ratio or set value w/ time ramp + * @method ratio + * + * @param {Number} [ratio] The amount of dB change in input for a 1 dB change in output + * default = 12, range 1 - 20 + * @param {Number} [time] Assign time value to schedule the change in value + */ + p5.Compressor.prototype.ratio = function (ratio, time) { + var t = time || 0; + if (typeof ratio == 'number') { + this.compressor.ratio.value = ratio; + this.compressor.ratio.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.compressor.ratio.linearRampToValueAtTime(ratio, this.ac.currentTime + 0.02 + t); + } else if (typeof ratio !== 'undefined') { + ratio.connect(this.compressor.ratio); + } + return this.compressor.ratio.value; + }; + /** + * Get current threshold or set value w/ time ramp + * @method threshold + * + * @param {Number} threshold The decibel value above which the compression will start taking effect + * default = -24, range -100 - 0 + * @param {Number} [time] Assign time value to schedule the change in value + */ + p5.Compressor.prototype.threshold = function (threshold, time) { + var t = time || 0; + if (typeof threshold == 'number') { + this.compressor.threshold.value = threshold; + this.compressor.threshold.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.compressor.threshold.linearRampToValueAtTime(threshold, this.ac.currentTime + 0.02 + t); + } else if (typeof threshold !== 'undefined') { + threshold.connect(this.compressor.threshold); + } + return this.compressor.threshold.value; + }; + /** + * Get current release or set value w/ time ramp + * @method release + * + * @param {Number} release The amount of time (in seconds) to increase the gain by 10dB + * default = .25, range 0 - 1 + * + * @param {Number} [time] Assign time value to schedule the change in value + */ + p5.Compressor.prototype.release = function (release, time) { + var t = time || 0; + if (typeof release == 'number') { + this.compressor.release.value = release; + this.compressor.release.cancelScheduledValues(this.ac.currentTime + 0.01 + t); + this.compressor.release.linearRampToValueAtTime(release, this.ac.currentTime + 0.02 + t); + } else if (typeof number !== 'undefined') { + release.connect(this.compressor.release); + } + return this.compressor.release.value; + }; + /** + * Return the current reduction value + * + * @method reduction + * @return {Number} Value of the amount of gain reduction that is applied to the signal + */ + p5.Compressor.prototype.reduction = function () { + return this.compressor.reduction.value; + }; + p5.Compressor.prototype.dispose = function () { + Effect.prototype.dispose.apply(this); + if (this.compressor) { + this.compressor.disconnect(); + delete this.compressor; + } + }; + return p5.Compressor; +}(master, effect, errorHandler); +var soundRecorder; +'use strict'; +soundRecorder = function () { + // inspiration: recorder.js, Tone.js & typedarray.org + var p5sound = master; + var convertToWav = helpers.convertToWav; + 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 file. The browser will prompt the user + * to download the file to their device. + * For uploading audio to a server, use + * `p5.SoundFile.saveBlob`. + * + * @for p5 + * @method saveSound + * @param {p5.SoundFile} soundFile p5.SoundFile that you wish to save + * @param {String} fileName name of the resulting .wav file. + */ + // add to p5.prototype as this is used by the p5 `save()` method. + p5.prototype.saveSound = function (soundFile, fileName) { + const dataView = convertToWav(soundFile.buffer); + p5.prototype.writeFile([dataView], fileName, 'wav'); + }; +}(master, helpers); +var peakdetect; +'use strict'; +peakdetect = function () { + /** + *

    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 preload() { + * soundFile = loadSound('assets/beat.mp3'); + * } + * + * function setup() { + * background(0); + * noStroke(); + * fill(255); + * textAlign(CENTER); + * + * // 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) { + // 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 {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 preload() { + * soundFile = loadSound('assets/beat.mp3'); + * } + * + * function setup() { + * cnv = createCanvas(100,100); + * textAlign(CENTER); + * + * 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); + }; + }; +}(); +var gain; +'use strict'; +gain = function () { + 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('assets/Damscray_-_Dancing_Tiger_01'); + * sound2 = loadSound('assets/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 () { + if (this.output) { + 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); + if (this.output) { + this.output.disconnect(); + delete this.output; + } + if (this.input) { + this.input.disconnect(); + delete this.input; + } + }; +}(master); +var audioVoice; +'use strict'; +audioVoice = function () { + var p5sound = master; + /** + * Base class for monophonic synthesizers. Any extensions of this class + * should follow the API and implement the methods below in order to + * remain compatible with p5.PolySynth(); + * + * @class p5.AudioVoice + * @constructor + */ + p5.AudioVoice = function () { + this.ac = p5sound.audiocontext; + this.output = this.ac.createGain(); + this.connect(); + p5sound.soundArray.push(this); + }; + p5.AudioVoice.prototype.play = function (note, velocity, secondsFromNow, sustime) { + }; + p5.AudioVoice.prototype.triggerAttack = function (note, velocity, secondsFromNow) { + }; + p5.AudioVoice.prototype.triggerRelease = function (secondsFromNow) { + }; + p5.AudioVoice.prototype.amp = function (vol, rampTime) { + }; + /** + * Connect to p5 objects or Web Audio Nodes + * @method connect + * @param {Object} unit + */ + p5.AudioVoice.prototype.connect = function (unit) { + var u = unit || p5sound.input; + this.output.connect(u.input ? u.input : u); + }; + /** + * Disconnect from soundOut + * @method disconnect + */ + p5.AudioVoice.prototype.disconnect = function () { + this.output.disconnect(); + }; + p5.AudioVoice.prototype.dispose = function () { + if (this.output) { + this.output.disconnect(); + delete this.output; + } + }; + return p5.AudioVoice; +}(master); +var monosynth; +'use strict'; +monosynth = function () { + var p5sound = master; + var AudioVoice = audioVoice; + var noteToFreq = helpers.noteToFreq; + var DEFAULT_SUSTAIN = 0.15; + /** + * A MonoSynth is used as a single voice for sound synthesis. + * This is a class to be used in conjunction with the PolySynth + * class. Custom synthetisers should be built inheriting from + * this class. + * + * @class p5.MonoSynth + * @constructor + * @example + *
    + * var monoSynth; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * cnv.mousePressed(playSynth); + * + * monoSynth = new p5.MonoSynth(); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * } + * + * function playSynth() { + * // time from now (in seconds) + * var time = 0; + * // note duration (in seconds) + * var dur = 0.25; + * // velocity (volume, from 0 to 1) + * var v = 0.2; + * + * monoSynth.play("G3", v, time, dur); + * monoSynth.play("C4", v, time += dur, dur); + * + * background(random(255), random(255), 255); + * text('click to play', width/2, height/2); + * } + *
    + **/ + p5.MonoSynth = function () { + AudioVoice.call(this); + this.oscillator = new p5.Oscillator(); + this.env = new p5.Envelope(); + this.env.setRange(1, 0); + this.env.setExp(true); + //set params + this.setADSR(0.02, 0.25, 0.05, 0.35); + // oscillator --> env --> this.output (gain) --> p5.soundOut + this.oscillator.disconnect(); + this.oscillator.connect(this.output); + this.env.disconnect(); + this.env.setInput(this.output.gain); + // reset oscillator gain to 1.0 + this.oscillator.output.gain.value = 1; + this.oscillator.start(); + this.connect(); + p5sound.soundArray.push(this); + }; + p5.MonoSynth.prototype = Object.create(p5.AudioVoice.prototype); + /** + * Play tells the MonoSynth to start playing a note. This method schedules + * the calling of .triggerAttack and .triggerRelease. + * + * @method play + * @param {String | Number} note the note you want to play, specified as a + * frequency in Hertz (Number) or as a midi + * value in Note/Octave format ("C4", "Eb3"...etc") + * See + * Tone. Defaults to 440 hz. + * @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1) + * @param {Number} [secondsFromNow] time from now (in seconds) at which to play + * @param {Number} [sustainTime] time to sustain before releasing the envelope + * @example + *
    + * var monoSynth; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * cnv.mousePressed(playSynth); + * + * monoSynth = new p5.MonoSynth(); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * } + * + * function playSynth() { + * // time from now (in seconds) + * var time = 0; + * // note duration (in seconds) + * var dur = 1/6; + * // note velocity (volume, from 0 to 1) + * var v = random(); + * + * monoSynth.play("Fb3", v, 0, dur); + * monoSynth.play("Gb3", v, time += dur, dur); + * + * background(random(255), random(255), 255); + * text('click to play', width/2, height/2); + * } + *
    + * + */ + p5.MonoSynth.prototype.play = function (note, velocity, secondsFromNow, susTime) { + this.triggerAttack(note, velocity, ~~secondsFromNow); + this.triggerRelease(~~secondsFromNow + (susTime || DEFAULT_SUSTAIN)); + }; + /** + * 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. + * + * @param {String | Number} note the note you want to play, specified as a + * frequency in Hertz (Number) or as a midi + * value in Note/Octave format ("C4", "Eb3"...etc") + * See + * Tone. Defaults to 440 hz + * @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1) + * @param {Number} [secondsFromNow] time from now (in seconds) at which to play + * @method triggerAttack + * @example + *
    + * var monoSynth = new p5.MonoSynth(); + * + * function mousePressed() { + * monoSynth.triggerAttack("E3"); + * } + * + * function mouseReleased() { + * monoSynth.triggerRelease(); + * } + *
    + */ + p5.MonoSynth.prototype.triggerAttack = function (note, velocity, secondsFromNow) { + var secondsFromNow = ~~secondsFromNow; + var freq = noteToFreq(note); + var vel = velocity || 0.1; + this.oscillator.freq(freq, 0, secondsFromNow); + this.env.ramp(this.output.gain, secondsFromNow, vel); + }; + /** + * 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. + * + * @param {Number} secondsFromNow time to trigger the release + * @method triggerRelease + * @example + *
    + * var monoSynth = new p5.MonoSynth(); + * + * function mousePressed() { + * monoSynth.triggerAttack("E3"); + * } + * + * function mouseReleased() { + * monoSynth.triggerRelease(); + * } + *
    + */ + p5.MonoSynth.prototype.triggerRelease = function (secondsFromNow) { + var secondsFromNow = secondsFromNow || 0; + this.env.ramp(this.output.gain, secondsFromNow, 0); + }; + /** + * 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) + */ + p5.MonoSynth.prototype.setADSR = function (attack, decay, sustain, release) { + this.env.setADSR(attack, decay, sustain, release); + }; + /** + * Getters and Setters + * @property {Number} attack + */ + /** + * @property {Number} decay + */ + /** + * @property {Number} sustain + */ + /** + * @property {Number} release + */ + Object.defineProperties(p5.MonoSynth.prototype, { + 'attack': { + get: function () { + return this.env.aTime; + }, + set: function (attack) { + this.env.setADSR(attack, this.env.dTime, this.env.sPercent, this.env.rTime); + } + }, + 'decay': { + get: function () { + return this.env.dTime; + }, + set: function (decay) { + this.env.setADSR(this.env.aTime, decay, this.env.sPercent, this.env.rTime); + } + }, + 'sustain': { + get: function () { + return this.env.sPercent; + }, + set: function (sustain) { + this.env.setADSR(this.env.aTime, this.env.dTime, sustain, this.env.rTime); + } + }, + 'release': { + get: function () { + return this.env.rTime; + }, + set: function (release) { + this.env.setADSR(this.env.aTime, this.env.dTime, this.env.sPercent, release); + } + } + }); + /** + * MonoSynth amp + * @method amp + * @param {Number} vol desired volume + * @param {Number} [rampTime] Time to reach new volume + * @return {Number} new volume value + */ + p5.MonoSynth.prototype.amp = function (vol, rampTime) { + var t = rampTime || 0; + if (typeof vol !== 'undefined') { + this.oscillator.amp(vol, t); + } + return this.oscillator.amp().value; + }; + /** + * Connect to a p5.sound / Web Audio object. + * + * @method connect + * @param {Object} unit A p5.sound or Web Audio object + */ + p5.MonoSynth.prototype.connect = function (unit) { + var u = unit || p5sound.input; + this.output.connect(u.input ? u.input : u); + }; + /** + * Disconnect all outputs + * + * @method disconnect + */ + p5.MonoSynth.prototype.disconnect = function () { + if (this.output) { + this.output.disconnect(); + } + }; + /** + * Get rid of the MonoSynth and free up its resources / memory. + * + * @method dispose + */ + p5.MonoSynth.prototype.dispose = function () { + AudioVoice.prototype.dispose.apply(this); + if (this.env) { + this.env.dispose(); + } + if (this.oscillator) { + this.oscillator.dispose(); + } + }; +}(master, audioVoice, helpers); +var polysynth; +'use strict'; +polysynth = function () { + var p5sound = master; + var TimelineSignal = Tone_signal_TimelineSignal; + var noteToFreq = helpers.noteToFreq; + /** + * An AudioVoice is used as a single voice for sound synthesis. + * The PolySynth class holds an array of AudioVoice, and deals + * with voices allocations, with setting notes to be played, and + * parameters to be set. + * + * @class p5.PolySynth + * @constructor + * + * @param {Number} [synthVoice] A monophonic synth voice inheriting + * the AudioVoice class. Defaults to p5.MonoSynth + * @param {Number} [maxVoices] Number of voices, defaults to 8; + * @example + *
    + * var polySynth; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * cnv.mousePressed(playSynth); + * + * polySynth = new p5.PolySynth(); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * } + * + * function playSynth() { + * // note duration (in seconds) + * var dur = 1.5; + * + * // time from now (in seconds) + * var time = 0; + * + * // velocity (volume, from 0 to 1) + * var vel = 0.1; + * + * // notes can overlap with each other + * polySynth.play("G2", vel, 0, dur); + * polySynth.play("C3", vel, time += 1/3, dur); + * polySynth.play("G3", vel, time += 1/3, dur); + * + * background(random(255), random(255), 255); + * text('click to play', width/2, height/2); + * } + *
    + **/ + p5.PolySynth = function (audioVoice, maxVoices) { + //audiovoices will contain maxVoices many monophonic synths + this.audiovoices = []; + /** + * An object that holds information about which notes have been played and + * which notes are currently being played. New notes are added as keys + * on the fly. While a note has been attacked, but not released, the value of the + * key is the audiovoice which is generating that note. When notes are released, + * the value of the key becomes undefined. + * @property notes + */ + this.notes = {}; + //indices of the most recently used, and least recently used audiovoice + this._newest = 0; + this._oldest = 0; + /** + * A PolySynth must have at least 1 voice, defaults to 8 + * @property polyvalue + */ + this.maxVoices = maxVoices || 8; + /** + * Monosynth that generates the sound for each note that is triggered. The + * p5.PolySynth defaults to using the p5.MonoSynth as its voice. + * @property AudioVoice + */ + this.AudioVoice = audioVoice === undefined ? p5.MonoSynth : audioVoice; + /** + * This value must only change as a note is attacked or released. Due to delay + * and sustain times, Tone.TimelineSignal is required to schedule the change in value. + * @private + * @property {Tone.TimelineSignal} _voicesInUse + */ + this._voicesInUse = new TimelineSignal(0); + this.output = p5sound.audiocontext.createGain(); + this.connect(); + //Construct the appropriate number of audiovoices + this._allocateVoices(); + p5sound.soundArray.push(this); + }; + /** + * Construct the appropriate number of audiovoices + * @private + * @method _allocateVoices + */ + p5.PolySynth.prototype._allocateVoices = function () { + for (var i = 0; i < this.maxVoices; i++) { + this.audiovoices.push(new this.AudioVoice()); + this.audiovoices[i].disconnect(); + this.audiovoices[i].connect(this.output); + } + }; + /** + * Play a note by triggering noteAttack and noteRelease with sustain time + * + * @method play + * @param {Number} [note] midi note to play (ranging from 0 to 127 - 60 being a middle C) + * @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1) + * @param {Number} [secondsFromNow] time from now (in seconds) at which to play + * @param {Number} [sustainTime] time to sustain before releasing the envelope + * @example + *
    + * var polySynth; + * + * function setup() { + * var cnv = createCanvas(100, 100); + * cnv.mousePressed(playSynth); + * + * polySynth = new p5.PolySynth(); + * + * textAlign(CENTER); + * text('click to play', width/2, height/2); + * } + * + * function playSynth() { + * // note duration (in seconds) + * var dur = 0.1; + * + * // time from now (in seconds) + * var time = 0; + * + * // velocity (volume, from 0 to 1) + * var vel = 0.1; + * + * polySynth.play("G2", vel, 0, dur); + * polySynth.play("C3", vel, 0, dur); + * polySynth.play("G3", vel, 0, dur); + * + * background(random(255), random(255), 255); + * text('click to play', width/2, height/2); + * } + *
    + */ + p5.PolySynth.prototype.play = function (note, velocity, secondsFromNow, susTime) { + var susTime = susTime || 1; + this.noteAttack(note, velocity, secondsFromNow); + this.noteRelease(note, secondsFromNow + susTime); + }; + /** + * noteADSR sets the envelope for a specific note that has just been triggered. + * Using this method modifies the envelope of whichever audiovoice is being used + * to play the desired note. The envelope should be reset before noteRelease is called + * in order to prevent the modified envelope from being used on other notes. + * + * @method noteADSR + * @param {Number} [note] Midi note on which ADSR should be set. + * @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) + **/ + p5.PolySynth.prototype.noteADSR = function (note, a, d, s, r, timeFromNow) { + var now = p5sound.audiocontext.currentTime; + var timeFromNow = timeFromNow || 0; + var t = now + timeFromNow; + this.audiovoices[this.notes[note].getValueAtTime(t)].setADSR(a, d, s, r); + }; + /** + * Set the PolySynths global envelope. This method modifies the envelopes of each + * monosynth so that all notes are played with this 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) + **/ + p5.PolySynth.prototype.setADSR = function (a, d, s, r) { + this.audiovoices.forEach(function (voice) { + voice.setADSR(a, d, s, r); + }); + }; + /** + * Trigger the Attack, and Decay portion of a MonoSynth. + * Similar to holding down a key on a piano, but it will + * hold the sustain level until you let go. + * + * @method noteAttack + * @param {Number} [note] midi note on which attack should be triggered. + * @param {Number} [velocity] velocity of the note to play (ranging from 0 to 1)/ + * @param {Number} [secondsFromNow] time from now (in seconds) + * @example + *
    + * var polySynth = new p5.PolySynth(); + * var pitches = ["G", "D", "G", "C"]; + * var octaves = [2, 3, 4]; + * + * function mousePressed() { + * // play a chord: multiple notes at the same time + * for (var i = 0; i < 4; i++) { + * var note = random(pitches) + random(octaves); + * polySynth.noteAttack(note, 0.1); + * } + * } + * + * function mouseReleased() { + * // release all voices + * polySynth.noteRelease(); + * } + *
    + */ + p5.PolySynth.prototype.noteAttack = function (_note, _velocity, secondsFromNow) { + //this value goes to the audiovoices which handle their own scheduling + var secondsFromNow = ~~secondsFromNow; + //this value is used by this._voicesInUse + var acTime = p5sound.audiocontext.currentTime + secondsFromNow; + //Convert note to frequency if necessary. This is because entries into this.notes + //should be based on frequency for the sake of consistency. + var note = noteToFreq(_note); + var velocity = _velocity || 0.1; + var currentVoice; + //Release the note if it is already playing + if (this.notes[note] && this.notes[note].getValueAtTime(acTime) !== null) { + this.noteRelease(note, 0); + } + //Check to see how many voices are in use at the time the note will start + if (this._voicesInUse.getValueAtTime(acTime) < this.maxVoices) { + currentVoice = Math.max(~~this._voicesInUse.getValueAtTime(acTime), 0); + } else { + currentVoice = this._oldest; + var oldestNote = p5.prototype.freqToMidi(this.audiovoices[this._oldest].oscillator.freq().value); + this.noteRelease(oldestNote); + this._oldest = (this._oldest + 1) % (this.maxVoices - 1); + } + //Overrite the entry in the notes object. A note (frequency value) + //corresponds to the index of the audiovoice that is playing it + this.notes[note] = new TimelineSignal(); + this.notes[note].setValueAtTime(currentVoice, acTime); + //Find the scheduled change in this._voicesInUse that will be previous to this new note + //Add 1 and schedule this value at time 't', when this note will start playing + var previousVal = this._voicesInUse._searchBefore(acTime) === null ? 0 : this._voicesInUse._searchBefore(acTime).value; + this._voicesInUse.setValueAtTime(previousVal + 1, acTime); + //Then update all scheduled values that follow to increase by 1 + this._updateAfter(acTime, 1); + this._newest = currentVoice; + //The audiovoice handles the actual scheduling of the note + if (typeof velocity === 'number') { + var maxRange = 1 / this._voicesInUse.getValueAtTime(acTime) * 2; + velocity = velocity > maxRange ? maxRange : velocity; + } + this.audiovoices[currentVoice].triggerAttack(note, velocity, secondsFromNow); + }; + /** + * Private method to ensure accurate values of this._voicesInUse + * Any time a new value is scheduled, it is necessary to increment all subsequent + * scheduledValues after attack, and decrement all subsequent + * scheduledValues after release + * + * @private + * @param {[type]} time [description] + * @param {[type]} value [description] + * @return {[type]} [description] + */ + p5.PolySynth.prototype._updateAfter = function (time, value) { + if (this._voicesInUse._searchAfter(time) === null) { + return; + } else { + this._voicesInUse._searchAfter(time).value += value; + var nextTime = this._voicesInUse._searchAfter(time).time; + this._updateAfter(nextTime, value); + } + }; + /** + * Trigger the Release of an AudioVoice note. This is similar to releasing + * the key on a piano and letting the sound fade according to the + * release level and release time. + * + * @method noteRelease + * @param {Number} [note] midi note on which attack should be triggered. + * If no value is provided, all notes will be released. + * @param {Number} [secondsFromNow] time to trigger the release + * @example + *
    + * var pitches = ["G", "D", "G", "C"]; + * var octaves = [2, 3, 4]; + * var polySynth = new p5.PolySynth(); + * + * function mousePressed() { + * // play a chord: multiple notes at the same time + * for (var i = 0; i < 4; i++) { + * var note = random(pitches) + random(octaves); + * polySynth.noteAttack(note, 0.1); + * } + * } + * + * function mouseReleased() { + * // release all voices + * polySynth.noteRelease(); + * } + *
    + * + */ + p5.PolySynth.prototype.noteRelease = function (_note, secondsFromNow) { + var now = p5sound.audiocontext.currentTime; + var tFromNow = secondsFromNow || 0; + var t = now + tFromNow; + // if a note value is not provided, release all voices + if (!_note) { + this.audiovoices.forEach(function (voice) { + voice.triggerRelease(tFromNow); + }); + this._voicesInUse.setValueAtTime(0, t); + for (var n in this.notes) { + this.notes[n].dispose(); + delete this.notes[n]; + } + return; + } + //Make sure note is in frequency inorder to query the this.notes object + var note = noteToFreq(_note); + if (!this.notes[note] || this.notes[note].getValueAtTime(t) === null) { + console.warn('Cannot release a note that is not already playing'); + } else { + //Find the scheduled change in this._voicesInUse that will be previous to this new note + //subtract 1 and schedule this value at time 't', when this note will stop playing + var previousVal = Math.max(~~this._voicesInUse.getValueAtTime(t).value, 1); + this._voicesInUse.setValueAtTime(previousVal - 1, t); + //Then update all scheduled values that follow to decrease by 1 but never go below 0 + if (previousVal > 0) { + this._updateAfter(t, -1); + } + this.audiovoices[this.notes[note].getValueAtTime(t)].triggerRelease(tFromNow); + this.notes[note].dispose(); + delete this.notes[note]; + this._newest = this._newest === 0 ? 0 : (this._newest - 1) % (this.maxVoices - 1); + } + }; + /** + * Connect to a p5.sound / Web Audio object. + * + * @method connect + * @param {Object} unit A p5.sound or Web Audio object + */ + p5.PolySynth.prototype.connect = function (unit) { + var u = unit || p5sound.input; + this.output.connect(u.input ? u.input : u); + }; + /** + * Disconnect all outputs + * + * @method disconnect + */ + p5.PolySynth.prototype.disconnect = function () { + if (this.output) { + this.output.disconnect(); + } + }; + /** + * Get rid of the MonoSynth and free up its resources / memory. + * + * @method dispose + */ + p5.PolySynth.prototype.dispose = function () { + this.audiovoices.forEach(function (voice) { + voice.dispose(); + }); + if (this.output) { + this.output.disconnect(); + delete this.output; + } + }; +}(master, Tone_signal_TimelineSignal, helpers); +var distortion; +'use strict'; +distortion = function () { + var Effect = effect; + /* + * 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 numSamples = 44100; + var curve = new Float32Array(numSamples); + var deg = Math.PI / 180; + var i = 0; + var x; + for (; i < numSamples; ++i) { + x = i * 2 / numSamples - 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) + * + * This class extends p5.Effect. + * Methods amp(), chain(), + * drywet(), connect(), and + * disconnect() are available. + * + * @class p5.Distortion + * @extends p5.Effect + * @constructor + * @param {Number} [amount=0.25] Unbounded distortion amount. + * Normal values range from 0-1. + * @param {String} [oversample='none'] 'none', '2x', or '4x'. + * + */ + p5.Distortion = function (amount, oversample) { + Effect.call(this); + 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); + /** + * The p5.Distortion is built with a + * + * Web Audio WaveShaper Node. + * + * @property {AudioNode} WaveShaperNode + */ + 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.wet); + }; + p5.Distortion.prototype = Object.create(Effect.prototype); + /** + * Process a sound source, optionally specify amount and oversample values. + * + * @method process + * @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.process = function (src, amount, oversample) { + src.connect(this.input); + this.set(amount, oversample); + }; + /** + * Set the amount and oversample of the waveshaper distortion. + * + * @method set + * @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. + * + * @method getOversample + * + * @return {String} Oversample can either be 'none', '2x', or '4x'. + */ + p5.Distortion.prototype.getOversample = function () { + return this.waveShaperNode.oversample; + }; + p5.Distortion.prototype.dispose = function () { + Effect.prototype.dispose.apply(this); + if (this.waveShaperNode) { + this.waveShaperNode.disconnect(); + this.waveShaperNode = null; + } + }; +}(effect); +var src_app; +'use strict'; +src_app = function () { + var p5SOUND = master; + return p5SOUND; +}(shims, audiocontext, master, helpers, errorHandler, panner, soundfile, amplitude, fft, signal, oscillator, envelope, pulse, noise, audioin, filter, eq, panner3d, listener3d, delay, reverb, metro, looper, soundloop, compressor, soundRecorder, peakdetect, gain, monosynth, polysynth, distortion, audioVoice, monosynth, polysynth); +})); \ No newline at end of file diff --git a/p5/addons/p5.sound.min.js b/p5/addons/p5.sound.min.js new file mode 100644 index 0000000..899f447 --- /dev/null +++ b/p5/addons/p5.sound.min.js @@ -0,0 +1,28 @@ +/*! p5.sound.min.js v0.3.11 2019-03-14 */ + +/** + * p5.sound + * https://p5js.org/reference/#/libraries/p5.sound + * + * From the Processing Foundation and contributors + * https://github.com/processing/p5.js-sound/graphs/contributors + * + * MIT License (MIT) + * https://github.com/processing/p5.js-sound/blob/master/LICENSE + * + * Some of the many audio libraries & resources that inspire p5.sound: + * - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js + * - buzz.js (c) Jay Salvat. 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/ + */ + +!function(t,e){"function"==typeof define&&define.amd?define("p5.sound",["p5"],function(t){e(t)}):e("object"==typeof exports?require("../p5"):t.p5)}(this,function(t){var e;e=function(){!function(){function t(t){t&&(t.setTargetAtTime||(t.setTargetAtTime=t.setTargetValueAtTime))}window.hasOwnProperty("webkitAudioContext")&&!window.hasOwnProperty("AudioContext")&&(window.AudioContext=window.webkitAudioContext,"function"!=typeof AudioContext.prototype.createGain&&(AudioContext.prototype.createGain=AudioContext.prototype.createGainNode),"function"!=typeof AudioContext.prototype.createDelay&&(AudioContext.prototype.createDelay=AudioContext.prototype.createDelayNode),"function"!=typeof AudioContext.prototype.createScriptProcessor&&(AudioContext.prototype.createScriptProcessor=AudioContext.prototype.createJavaScriptNode),"function"!=typeof AudioContext.prototype.createPeriodicWave&&(AudioContext.prototype.createPeriodicWave=AudioContext.prototype.createWaveTable),AudioContext.prototype.internal_createGain=AudioContext.prototype.createGain,AudioContext.prototype.createGain=function(){var e=this.internal_createGain();return t(e.gain),e},AudioContext.prototype.internal_createDelay=AudioContext.prototype.createDelay,AudioContext.prototype.createDelay=function(e){var i=e?this.internal_createDelay(e):this.internal_createDelay();return t(i.delayTime),i},AudioContext.prototype.internal_createBufferSource=AudioContext.prototype.createBufferSource,AudioContext.prototype.createBufferSource=function(){var e=this.internal_createBufferSource();return e.start?(e.internal_start=e.start,e.start=function(t,i,n){"undefined"!=typeof n?e.internal_start(t||0,i,n):e.internal_start(t||0,i||0)}):e.start=function(t,e,i){e||i?this.noteGrainOn(t||0,e,i):this.noteOn(t||0)},e.stop?(e.internal_stop=e.stop,e.stop=function(t){e.internal_stop(t||0)}):e.stop=function(t){this.noteOff(t||0)},t(e.playbackRate),e},AudioContext.prototype.internal_createDynamicsCompressor=AudioContext.prototype.createDynamicsCompressor,AudioContext.prototype.createDynamicsCompressor=function(){var e=this.internal_createDynamicsCompressor();return t(e.threshold),t(e.knee),t(e.ratio),t(e.reduction),t(e.attack),t(e.release),e},AudioContext.prototype.internal_createBiquadFilter=AudioContext.prototype.createBiquadFilter,AudioContext.prototype.createBiquadFilter=function(){var e=this.internal_createBiquadFilter();return t(e.frequency),t(e.detune),t(e.Q),t(e.gain),e},"function"!=typeof AudioContext.prototype.createOscillator&&(AudioContext.prototype.internal_createOscillator=AudioContext.prototype.createOscillator,AudioContext.prototype.createOscillator=function(){var e=this.internal_createOscillator();return e.start?(e.internal_start=e.start,e.start=function(t){e.internal_start(t||0)}):e.start=function(t){this.noteOn(t||0)},e.stop?(e.internal_stop=e.stop,e.stop=function(t){e.internal_stop(t||0)}):e.stop=function(t){this.noteOff(t||0)},e.setPeriodicWave||(e.setPeriodicWave=e.setWaveTable),t(e.frequency),t(e.detune),e})),window.hasOwnProperty("webkitOfflineAudioContext")&&!window.hasOwnProperty("OfflineAudioContext")&&(window.OfflineAudioContext=window.webkitOfflineAudioContext)}(window),navigator.getUserMedia=navigator.getUserMedia||navigator.webkitGetUserMedia||navigator.mozGetUserMedia||navigator.msGetUserMedia;var e=document.createElement("audio");t.prototype.isSupported=function(){return!!e.canPlayType};var i=function(){return!!e.canPlayType&&e.canPlayType('audio/ogg; codecs="vorbis"')},n=function(){return!!e.canPlayType&&e.canPlayType("audio/mpeg;")},o=function(){return!!e.canPlayType&&e.canPlayType('audio/wav; codecs="1"')},r=function(){return!!e.canPlayType&&(e.canPlayType("audio/x-m4a;")||e.canPlayType("audio/aac;"))},s=function(){return!!e.canPlayType&&e.canPlayType("audio/x-aiff;")};t.prototype.isFileSupported=function(t){switch(t.toLowerCase()){case"mp3":return n();case"wav":return o();case"ogg":return i();case"aac":case"m4a":case"mp4":return r();case"aif":case"aiff":return s();default:return!1}}}();var i;!function(t,e){i=function(){return e()}()}(this,function(){function t(t){var e=t.createBuffer(1,1,t.sampleRate),i=t.createBufferSource();i.buffer=e,i.connect(t.destination),i.start(0),t.resume&&t.resume()}function e(t){return"running"===t.state}function i(t,i){function n(){e(t)?i():(requestAnimationFrame(n),t.resume&&t.resume())}e(t)?i():n()}function n(t,e,i){if(Array.isArray(t)||NodeList&&t instanceof NodeList)for(var o=0;o1&&(this.input=new Array(t)),this.isUndef(e)||1===e?this.output=this.context.createGain():e>1&&(this.output=new Array(t))};t.prototype.set=function(e,i,n){if(this.isObject(e))n=i;else if(this.isString(e)){var o={};o[e]=i,e=o}t:for(var r in e){i=e[r];var s=this;if(-1!==r.indexOf(".")){for(var a=r.split("."),u=0;u1)for(var t=arguments[0],e=1;e0)for(var t=this,e=0;e0)for(var t=0;tn;n++)i[n].apply(this,e)}return this},t.Emitter.mixin=function(e){var i=["on","off","emit"];e._events={};for(var n=0;n1?t.getChannelData(1):e;var s=i(e,r),a=new window.ArrayBuffer(44+2*s.length),u=new window.DataView(a);n(u,0,"RIFF"),u.setUint32(4,36+2*s.length,!0),n(u,8,"WAVE"),n(u,12,"fmt "),u.setUint32(16,16,!0),u.setUint16(20,1,!0),u.setUint16(22,2,!0),u.setUint32(24,o.audiocontext.sampleRate,!0),u.setUint32(28,4*o.audiocontext.sampleRate,!0),u.setUint16(32,4,!0),u.setUint16(34,16,!0),n(u,36,"data"),u.setUint32(40,2*s.length,!0);for(var c=s.length,p=44,h=1,l=0;c>l;l++)u.setInt16(p,s[l]*(32767*h),!0),p+=2;return u}function i(t,e){for(var i=t.length+e.length,n=new Float32Array(i),o=0,r=0;i>r;)n[r++]=t[o],n[r++]=e[o],o++;return n}function n(t,e,i){for(var n=i.length,o=0;n>o;o++)t.setUint8(e+o,i.charCodeAt(o))}var o=a;t.prototype.sampleRate=function(){return o.audiocontext.sampleRate},t.prototype.freqToMidi=function(t){var e=Math.log(t/440)/Math.log(2),i=Math.round(12*e)+69;return i};var r=t.prototype.midiToFreq=function(t){return 440*Math.pow(2,(t-69)/12)},s=function(t){if("string"!=typeof t)return t;var e={A:21,B:23,C:24,D:26,E:28,F:29,G:31},i=e[t[0].toUpperCase()],n=~~t.slice(-1);switch(i+=12*(n-1),t[1]){case"#":i+=1;break;case"b":i-=1}return r(i)};return t.prototype.soundFormats=function(){o.extensions=[];for(var t=0;t-1))throw arguments[t]+" is not a valid sound format!";o.extensions.push(arguments[t])}},t.prototype.disposeSound=function(){for(var t=0;t-1)if(t.prototype.isFileSupported(n))i=i;else for(var r=i.split("."),s=r[r.length-1],a=0;a1?(this.splitter=i.createChannelSplitter(2),this.input.connect(this.splitter),this.splitter.connect(this.left,1),this.splitter.connect(this.right,0)):(this.input.connect(this.left),this.input.connect(this.right)),this.output=i.createChannelMerger(2),this.left.connect(this.output,0,1),this.right.connect(this.output,0,0),this.output.connect(e)},t.Panner.prototype.pan=function(t,e){var n=e||0,o=i.currentTime+n,r=(t+1)/2,s=Math.cos(r*Math.PI/2),a=Math.sin(r*Math.PI/2);this.left.gain.linearRampToValueAtTime(a,o),this.right.gain.linearRampToValueAtTime(s,o)},t.Panner.prototype.inputChannels=function(t){1===t?(this.input.disconnect(),this.input.connect(this.left),this.input.connect(this.right)):2===t&&(this.splitter=i.createChannelSplitter(2),this.input.disconnect(),this.input.connect(this.splitter),this.splitter.connect(this.left,1),this.splitter.connect(this.right,0))},t.Panner.prototype.connect=function(t){this.output.connect(t)},t.Panner.prototype.disconnect=function(){this.output&&this.output.disconnect()})}(a);var h;h=function(){function e(t,e){for(var i={},n=t.length,o=0;n>o;o++){if(t[o]>e){var r=t[o],s=new v(r,o);i[o]=s,o+=6e3}o++}return i}function i(t){for(var e=[],i=Object.keys(t).sort(),n=0;no;o++){var r=t[i[n]],s=t[i[n+o]];if(r&&s){var a=r.sampleIndex,u=s.sampleIndex,c=u-a;c>0&&r.intervals.push(c);var p=e.some(function(t){return t.interval===c?(t.count++,t):void 0});p||e.push({interval:c,count:1})}}return e}function n(t,e){var i=[];return t.forEach(function(t){try{var n=Math.abs(60/(t.interval/e));n=r(n);var o=i.some(function(e){return e.tempo===n?e.count+=t.count:void 0});if(!o){if(isNaN(n))return;i.push({tempo:Math.round(n),count:t.count})}}catch(s){throw s}}),i}function o(t,e,i,n){for(var o=[],s=Object.keys(t).sort(),a=0;a.01?!0:void 0})}function r(t){if(isFinite(t)&&0!==t){for(;90>t;)t*=2;for(;t>180&&t>90;)t/=2;return t}}function s(t){var e=t.inputBuffer.getChannelData(0);this._lastPos=e[e.length-1]||0,this._onTimeUpdate(self._lastPos)}function p(t){const e=t.target,i=this;e._playing=!1,e.removeEventListener("ended",i._clearOnEnd),i._onended(i),i.bufferSourceNodes.forEach(function(t,e){t._playing===!1&&i.bufferSourceNodes.splice(e)}),0===i.bufferSourceNodes.length&&(i._playing=!1)}var h=c,l=a,f=l.audiocontext,d=u.midiToFreq,m=u.convertToWav;t.SoundFile=function(e,i,n,o){if("undefined"!=typeof e){if("string"==typeof e||"string"==typeof e[0]){var r=t.prototype._checkFileFormats(e);this.url=r}else if("object"==typeof e&&!(window.File&&window.FileReader&&window.FileList&&window.Blob))throw"Unable to load file because the File API is not supported";e.file&&(e=e.file),this.file=e}this._onended=function(){},this._looping=!1,this._playing=!1,this._paused=!1,this._pauseTime=0,this._cues=[],this._cueIDCounter=0,this._lastPos=0,this._counterNode=null,this._scopeNode=null,this.bufferSourceNodes=[],this.bufferSourceNode=null,this.buffer=null,this.playbackRate=1,this.input=l.audiocontext.createGain(),this.output=l.audiocontext.createGain(),this.reversed=!1,this.startTime=0,this.endTime=null,this.pauseTime=0,this.mode="sustain",this.startMillis=null,this.panPosition=0,this.panner=new t.Panner(this.output,l.input,2),(this.url||this.file)&&this.load(i,n),l.soundArray.push(this),"function"==typeof o?this._whileLoading=o:this._whileLoading=function(){},this._onAudioProcess=s.bind(this),this._clearOnEnd=p.bind(this)},t.prototype.registerPreloadMethod("loadSound",t.prototype),t.prototype.loadSound=function(e,i,n,o){window.location.origin.indexOf("file://")>-1&&"undefined"===window.cordova&&window.alert("This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS");var r=this,s=new t.SoundFile(e,function(){"function"==typeof i&&i.apply(r,arguments),"function"==typeof r._decrementPreload&&r._decrementPreload()},n,o);return s},t.SoundFile.prototype.load=function(t,e){var i=this,n=(new Error).stack;if(void 0!==this.url&&""!==this.url){var o=new XMLHttpRequest;o.addEventListener("progress",function(t){i._updateProgress(t)},!1),o.open("GET",this.url,!0),o.responseType="arraybuffer",o.onload=function(){if(200===o.status){if(!i.panner)return;f.decodeAudioData(o.response,function(e){i.panner&&(i.buffer=e,i.panner.inputChannels(e.numberOfChannels),t&&t(i))},function(){if(i.panner){var t=new h("decodeAudioData",n,i.url),o="AudioContext error at decodeAudioData for "+i.url;e?(t.msg=o,e(t)):console.error(o+"\n The error stack trace includes: \n"+t.stack)}})}else{if(!i.panner)return;var r=new h("loadSound",n,i.url),s="Unable to load "+i.url+". The request status was: "+o.status+" ("+o.statusText+")";e?(r.message=s,e(r)):console.error(s+"\n The error stack trace includes: \n"+r.stack)}},o.onerror=function(){var t=new h("loadSound",n,i.url),o="There was no response from the server at "+i.url+". Check the url and internet connectivity.";e?(t.message=o,e(t)):console.error(o+"\n The error stack trace includes: \n"+t.stack)},o.send()}else if(void 0!==this.file){var r=new FileReader;r.onload=function(){i.panner&&f.decodeAudioData(r.result,function(e){i.panner&&(i.buffer=e,i.panner.inputChannels(e.numberOfChannels),t&&t(i))})},r.onerror=function(t){i.panner&&onerror&&onerror(t)},r.readAsArrayBuffer(this.file)}},t.SoundFile.prototype._updateProgress=function(t){if(t.lengthComputable){var e=t.loaded/t.total*.99;this._whileLoading(e,t)}else this._whileLoading("size unknown")},t.SoundFile.prototype.isLoaded=function(){return this.buffer?!0:!1},t.SoundFile.prototype.play=function(t,e,i,n,o){if(!this.output)return void console.warn("SoundFile.play() called after dispose");var r,s,a=l.audiocontext.currentTime,u=t||0;if(0>u&&(u=0),u+=a,"undefined"!=typeof e&&this.rate(e),"undefined"!=typeof i&&this.setVolume(i),!this.buffer)throw"not ready to play file, buffer has yet to load. Try preload()";if(this._pauseTime=0,"restart"===this.mode&&this.buffer&&this.bufferSourceNode&&(this.bufferSourceNode.stop(u),this._counterNode.stop(u)),"untildone"!==this.mode||!this.isPlaying()){if(this.bufferSourceNode=this._initSourceNode(),delete this._counterNode,this._counterNode=this._initCounterNode(),n){if(!(n>=0&&nt&&!this.reversed?(t=Math.abs(t),e=!0):t>0&&this.reversed&&(e=!0),this.bufferSourceNode){var i=l.audiocontext.currentTime;this.bufferSourceNode.playbackRate.cancelScheduledValues(i),this.bufferSourceNode.playbackRate.linearRampToValueAtTime(Math.abs(t),i),this._counterNode.playbackRate.cancelScheduledValues(i),this._counterNode.playbackRate.linearRampToValueAtTime(Math.abs(t),i)}return e&&this.reverseBuffer(),this.playbackRate},t.SoundFile.prototype.setPitch=function(t){var e=d(t)/d(60);this.rate(e)},t.SoundFile.prototype.getPlaybackRate=function(){return this.playbackRate},t.SoundFile.prototype.duration=function(){return this.buffer?this.buffer.duration:0},t.SoundFile.prototype.currentTime=function(){return this.reversed?Math.abs(this._lastPos-this.buffer.length)/f.sampleRate:this._lastPos/f.sampleRate},t.SoundFile.prototype.jump=function(t,e){if(0>t||t>this.buffer.duration)throw"jump time out of range";if(e>this.buffer.duration-t)throw"end time out of range";var i=t||0,n=e||void 0;this.isPlaying()&&this.stop(0),this.play(0,this.playbackRate,this.output.gain.value,i,n); +},t.SoundFile.prototype.channels=function(){return this.buffer.numberOfChannels},t.SoundFile.prototype.sampleRate=function(){return this.buffer.sampleRate},t.SoundFile.prototype.frames=function(){return this.buffer.length},t.SoundFile.prototype.getPeaks=function(t){if(!this.buffer)throw"Cannot load peaks yet, buffer is not loaded";if(t||(t=5*window.width),this.buffer){for(var e=this.buffer,i=e.length/t,n=~~(i/10)||1,o=e.numberOfChannels,r=new Float32Array(Math.round(t)),s=0;o>s;s++)for(var a=e.getChannelData(s),u=0;t>u;u++){for(var c=~~(u*i),p=~~(c+i),h=0,l=c;p>l;l+=n){var f=a[l];f>h?h=f:-f>h&&(h=f)}(0===s||Math.abs(h)>r[u])&&(r[u]=h)}return r}},t.SoundFile.prototype.reverseBuffer=function(){if(!this.buffer)throw"SoundFile is not done loading";var t=this._lastPos/f.sampleRate,e=this.getVolume();this.setVolume(0,.001);const i=this.buffer.numberOfChannels;for(var n=0;i>n;n++)this.buffer.getChannelData(n).reverse();this.reversed=!this.reversed,t&&this.jump(this.duration()-t),this.setVolume(e,.001)},t.SoundFile.prototype.onended=function(t){return this._onended=t,this},t.SoundFile.prototype.add=function(){},t.SoundFile.prototype.dispose=function(){var t=l.audiocontext.currentTime,e=l.soundArray.indexOf(this);if(l.soundArray.splice(e,1),this.stop(t),this.buffer&&this.bufferSourceNode){for(var i=0;io;o++){var r=n.getChannelData(o);r.set(t[o])}this.buffer=n,this.panner.inputChannels(e)};var y=function(t){const e=t.length,i=f.createBuffer(1,t.length,f.sampleRate),n=i.getChannelData(0);for(var o=0;e>o;o++)n[o]=o;return i};t.SoundFile.prototype._initCounterNode=function(){var e=this,i=f.currentTime,n=f.createBufferSource();return e._scopeNode&&(e._scopeNode.disconnect(),e._scopeNode.removeEventListener("audioprocess",e._onAudioProcess),delete e._scopeNode),e._scopeNode=f.createScriptProcessor(256,1,1),n.buffer=y(e.buffer),n.playbackRate.setValueAtTime(e.playbackRate,i),n.connect(e._scopeNode),e._scopeNode.connect(t.soundOut._silentNode),e._scopeNode.addEventListener("audioprocess",e._onAudioProcess),n},t.SoundFile.prototype._initSourceNode=function(){var t=f.createBufferSource();return t.buffer=this.buffer,t.playbackRate.value=this.playbackRate,t.connect(this.output),t},t.SoundFile.prototype.processPeaks=function(t,r,s,a){var u=this.buffer.length,c=this.buffer.sampleRate,p=this.buffer,h=[],l=r||.9,f=l,d=s||.22,m=a||200,y=new window.OfflineAudioContext(1,u,c),v=y.createBufferSource();v.buffer=p;var g=y.createBiquadFilter();g.type="lowpass",v.connect(g),g.connect(y.destination),v.start(0),y.startRendering(),y.oncomplete=function(r){if(self.panner){var s=r.renderedBuffer,a=s.getChannelData(0);do h=e(a,f),f-=.005;while(Object.keys(h).length=d);var u=i(h),c=n(u,s.sampleRate),p=c.sort(function(t,e){return e.count-t.count}).splice(0,5);this.tempo=p[0].tempo;var l=5,y=o(h,p[0].tempo,s.sampleRate,l);t(y)}}};var v=function(t,e){this.sampleIndex=e,this.amplitude=t,this.tempos=[],this.intervals=[]},g=function(t,e,i,n){this.callback=t,this.time=e,this.id=i,this.val=n};t.SoundFile.prototype.addCue=function(t,e,i){var n=this._cueIDCounter++,o=new g(e,t,n,i);return this._cues.push(o),n},t.SoundFile.prototype.removeCue=function(t){for(var e=this._cues.length,i=0;e>i;i++){var n=this._cues[i];if(n.id===t){this._cues.splice(i,1);break}}0===this._cues.length},t.SoundFile.prototype.clearCues=function(){this._cues=[]},t.SoundFile.prototype._onTimeUpdate=function(t){for(var e=t/this.buffer.sampleRate,i=this._cues.length,n=0;i>n;n++){var o=this._cues[n],r=o.time,s=o.val;this._prevTime=r&&o.callback(s)}this._prevTime=e},t.SoundFile.prototype.save=function(e){const i=m(this.buffer);t.prototype.saveSound([i],e,"wav")},t.SoundFile.prototype.getBlob=function(){const t=m(this.buffer);return new Blob([t],{type:"audio/wav"})}}(c,a,u,u);var l;l=function(){var e=a;t.Amplitude=function(t){this.bufferSize=2048,this.audiocontext=e.audiocontext,this.processor=this.audiocontext.createScriptProcessor(this.bufferSize,2,1),this.input=this.processor,this.output=this.audiocontext.createGain(),this.smoothing=t||0,this.volume=0,this.average=0,this.stereoVol=[0,0],this.stereoAvg=[0,0],this.stereoVolNorm=[0,0],this.volMax=.001,this.normalize=!1,this.processor.onaudioprocess=this._audioProcess.bind(this),this.processor.connect(this.output),this.output.gain.value=0,this.output.connect(this.audiocontext.destination),e.meter.connect(this.processor),e.soundArray.push(this)},t.Amplitude.prototype.setInput=function(i,n){e.meter.disconnect(),n&&(this.smoothing=n),null==i?(console.log("Amplitude input source is not ready! Connecting to master output instead"),e.meter.connect(this.processor)):i instanceof t.Signal?i.output.connect(this.processor):i?(i.connect(this.processor),this.processor.disconnect(),this.processor.connect(this.output)):e.meter.connect(this.processor)},t.Amplitude.prototype.connect=function(t){t?t.hasOwnProperty("input")?this.output.connect(t.input):this.output.connect(t):this.output.connect(this.panner.connect(e.input))},t.Amplitude.prototype.disconnect=function(){this.output&&this.output.disconnect()},t.Amplitude.prototype._audioProcess=function(t){for(var e=0;ea;a++)i=n[a],this.normalize?(r+=Math.max(Math.min(i/this.volMax,1),-1),s+=Math.max(Math.min(i/this.volMax,1),-1)*Math.max(Math.min(i/this.volMax,1),-1)):(r+=i,s+=i*i);var u=r/o,c=Math.sqrt(s/o);this.stereoVol[e]=Math.max(c,this.stereoVol[e]*this.smoothing),this.stereoAvg[e]=Math.max(u,this.stereoVol[e]*this.smoothing),this.volMax=Math.max(this.stereoVol[e],this.volMax)}var p=this,h=this.stereoVol.reduce(function(t,e,i){return p.stereoVolNorm[i-1]=Math.max(Math.min(p.stereoVol[i-1]/p.volMax,1),0),p.stereoVolNorm[i]=Math.max(Math.min(p.stereoVol[i]/p.volMax,1),0),t+e});this.volume=h/this.stereoVol.length,this.volNorm=Math.max(Math.min(this.volume/this.volMax,1),0)},t.Amplitude.prototype.getLevel=function(t){return"undefined"!=typeof t?this.normalize?this.stereoVolNorm[t]:this.stereoVol[t]:this.normalize?this.volNorm:this.volume},t.Amplitude.prototype.toggleNormalize=function(t){"boolean"==typeof t?this.normalize=t:this.normalize=!this.normalize},t.Amplitude.prototype.smooth=function(t){t>=0&&1>t?this.smoothing=t:console.log("Error: smoothing must be between 0 and 1")},t.Amplitude.prototype.dispose=function(){var t=e.soundArray.indexOf(this);e.soundArray.splice(t,1),this.input&&(this.input.disconnect(),delete this.input),this.output&&(this.output.disconnect(),delete this.output),delete this.processor}}(a);var f;f=function(){var e=a;t.FFT=function(t,i){this.input=this.analyser=e.audiocontext.createAnalyser(),Object.defineProperties(this,{bins:{get:function(){return this.analyser.fftSize/2},set:function(t){this.analyser.fftSize=2*t},configurable:!0,enumerable:!0},smoothing:{get:function(){return this.analyser.smoothingTimeConstant},set:function(t){this.analyser.smoothingTimeConstant=t},configurable:!0,enumerable:!0}}),this.smooth(t),this.bins=i||1024,e.fftMeter.connect(this.analyser),this.freqDomain=new Uint8Array(this.analyser.frequencyBinCount),this.timeDomain=new Uint8Array(this.analyser.frequencyBinCount),this.bass=[20,140],this.lowMid=[140,400],this.mid=[400,2600],this.highMid=[2600,5200],this.treble=[5200,14e3],e.soundArray.push(this)},t.FFT.prototype.setInput=function(t){t?(t.output?t.output.connect(this.analyser):t.connect&&t.connect(this.analyser),e.fftMeter.disconnect()):e.fftMeter.connect(this.analyser)},t.FFT.prototype.waveform=function(){for(var e,i,n,s=0;si){var o=i;i=t,t=o}for(var r=Math.round(t/n*this.freqDomain.length),s=Math.round(i/n*this.freqDomain.length),a=0,u=0,c=r;s>=c;c++)a+=this.freqDomain[c],u+=1;var p=a/u;return p}throw"invalid input for getEnergy()"}var h=Math.round(t/n*this.freqDomain.length);return this.freqDomain[h]},t.FFT.prototype.getFreq=function(t,e){console.log("getFreq() is deprecated. Please use getEnergy() instead.");var i=this.getEnergy(t,e);return i},t.FFT.prototype.getCentroid=function(){for(var t=e.audiocontext.sampleRate/2,i=0,n=0,o=0;os;s++)o[r]=void 0!==o[r]?(o[r]+e[s])/2:e[s],s%n===n-1&&r++;return o},t.FFT.prototype.logAverages=function(t){for(var i=e.audiocontext.sampleRate/2,n=this.freqDomain,o=n.length,r=new Array(t.length),s=0,a=0;o>a;a++){var u=Math.round(a*i/this.freqDomain.length);u>t[s].hi&&s++,r[s]=void 0!==r[s]?(r[s]+n[a])/2:n[a]}return r},t.FFT.prototype.getOctaveBands=function(t,i){var t=t||3,i=i||15.625,n=[],o={lo:i/Math.pow(2,1/(2*t)),ctr:i,hi:i*Math.pow(2,1/(2*t))};n.push(o);for(var r=e.audiocontext.sampleRate/2;o.hie;e++){var n=e/(i-1)*2-1;this._curve[e]=t(n,e)}return this._shaper.curve=this._curve,this},Object.defineProperty(t.WaveShaper.prototype,"curve",{get:function(){return this._shaper.curve},set:function(t){this._curve=new Float32Array(t),this._shaper.curve=this._curve}}),Object.defineProperty(t.WaveShaper.prototype,"oversample",{get:function(){return this._shaper.oversample},set:function(t){if(-1===["none","2x","4x"].indexOf(t))throw new RangeError("Tone.WaveShaper: oversampling must be either 'none', '2x', or '4x'");this._shaper.oversample=t}}),t.WaveShaper.prototype.dispose=function(){return t.prototype.dispose.call(this),this._shaper.disconnect(),this._shaper=null,this._curve=null,this},t.WaveShaper}(n);var y;y=function(t){return t.TimeBase=function(e,i){if(!(this instanceof t.TimeBase))return new t.TimeBase(e,i);if(this._expr=this._noOp,e instanceof t.TimeBase)this.copy(e);else if(!this.isUndef(i)||this.isNumber(e)){i=this.defaultArg(i,this._defaultUnits);var n=this._primaryExpressions[i].method;this._expr=n.bind(this,e)}else this.isString(e)?this.set(e):this.isUndef(e)&&(this._expr=this._defaultExpr())},t.extend(t.TimeBase),t.TimeBase.prototype.set=function(t){return this._expr=this._parseExprString(t),this},t.TimeBase.prototype.clone=function(){var t=new this.constructor;return t.copy(this),t},t.TimeBase.prototype.copy=function(t){var e=t._expr();return this.set(e)},t.TimeBase.prototype._primaryExpressions={n:{regexp:/^(\d+)n/i,method:function(t){return t=parseInt(t),1===t?this._beatsToUnits(this._timeSignature()):this._beatsToUnits(4/t)}},t:{regexp:/^(\d+)t/i,method:function(t){return t=parseInt(t),this._beatsToUnits(8/(3*parseInt(t)))}},m:{regexp:/^(\d+)m/i,method:function(t){return this._beatsToUnits(parseInt(t)*this._timeSignature())}},i:{regexp:/^(\d+)i/i,method:function(t){return this._ticksToUnits(parseInt(t))}},hz:{regexp:/^(\d+(?:\.\d+)?)hz/i,method:function(t){return this._frequencyToUnits(parseFloat(t))}},tr:{regexp:/^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?/,method:function(t,e,i){var n=0;return t&&"0"!==t&&(n+=this._beatsToUnits(this._timeSignature()*parseFloat(t))),e&&"0"!==e&&(n+=this._beatsToUnits(parseFloat(e))),i&&"0"!==i&&(n+=this._beatsToUnits(parseFloat(i)/4)),n}},s:{regexp:/^(\d+(?:\.\d+)?s)/,method:function(t){return this._secondsToUnits(parseFloat(t))}},samples:{regexp:/^(\d+)samples/,method:function(t){return parseInt(t)/this.context.sampleRate}},"default":{regexp:/^(\d+(?:\.\d+)?)/,method:function(t){return this._primaryExpressions[this._defaultUnits].method.call(this,t)}}},t.TimeBase.prototype._binaryExpressions={"+":{regexp:/^\+/,precedence:2,method:function(t,e){return t()+e()}},"-":{regexp:/^\-/,precedence:2,method:function(t,e){return t()-e()}},"*":{regexp:/^\*/,precedence:1,method:function(t,e){return t()*e()}},"/":{regexp:/^\//,precedence:1,method:function(t,e){return t()/e()}}},t.TimeBase.prototype._unaryExpressions={neg:{regexp:/^\-/,method:function(t){return-t()}}},t.TimeBase.prototype._syntaxGlue={"(":{regexp:/^\(/},")":{regexp:/^\)/}},t.TimeBase.prototype._tokenize=function(t){function e(t,e){for(var i=["_binaryExpressions","_unaryExpressions","_primaryExpressions","_syntaxGlue"],n=0;n0;){t=t.trim();var o=e(t,this);n.push(o),t=t.substr(o.value.length)}return{next:function(){return n[++i]},peek:function(){return n[i+1]}}},t.TimeBase.prototype._matchGroup=function(t,e,i){var n=!1;if(!this.isUndef(t))for(var o in e){var r=e[o];if(r.regexp.test(t.value)){if(this.isUndef(i))return r;if(r.precedence===i)return r}}return n},t.TimeBase.prototype._parseBinary=function(t,e){this.isUndef(e)&&(e=2);var i;i=0>e?this._parseUnary(t):this._parseBinary(t,e-1);for(var n=t.peek();n&&this._matchGroup(n,this._binaryExpressions,e);)n=t.next(),i=n.method.bind(this,i,this._parseBinary(t,e-1)),n=t.peek();return i},t.TimeBase.prototype._parseUnary=function(t){var e,i;e=t.peek();var n=this._matchGroup(e,this._unaryExpressions);return n?(e=t.next(),i=this._parseUnary(t),n.method.bind(this,i)):this._parsePrimary(t)},t.TimeBase.prototype._parsePrimary=function(t){var e,i;if(e=t.peek(),this.isUndef(e))throw new SyntaxError("Tone.TimeBase: Unexpected end of expression");if(this._matchGroup(e,this._primaryExpressions)){e=t.next();var n=e.value.match(e.regexp);return e.method.bind(this,n[1],n[2],n[3])}if(e&&"("===e.value){if(t.next(),i=this._parseBinary(t),e=t.next(),!e||")"!==e.value)throw new SyntaxError("Expected )");return i}throw new SyntaxError("Tone.TimeBase: Cannot process token "+e.value)},t.TimeBase.prototype._parseExprString=function(t){this.isString(t)||(t=t.toString());var e=this._tokenize(t),i=this._parseBinary(e);return i},t.TimeBase.prototype._noOp=function(){return 0},t.TimeBase.prototype._defaultExpr=function(){return this._noOp},t.TimeBase.prototype._defaultUnits="s",t.TimeBase.prototype._frequencyToUnits=function(t){return 1/t},t.TimeBase.prototype._beatsToUnits=function(e){return 60/t.Transport.bpm.value*e},t.TimeBase.prototype._secondsToUnits=function(t){return t},t.TimeBase.prototype._ticksToUnits=function(e){return e*(this._beatsToUnits(1)/t.Transport.PPQ)},t.TimeBase.prototype._timeSignature=function(){return t.Transport.timeSignature},t.TimeBase.prototype._pushExpr=function(e,i,n){return e instanceof t.TimeBase||(e=new this.constructor(e,n)),this._expr=this._binaryExpressions[i].method.bind(this,this._expr,e._expr),this},t.TimeBase.prototype.add=function(t,e){return this._pushExpr(t,"+",e)},t.TimeBase.prototype.sub=function(t,e){return this._pushExpr(t,"-",e)},t.TimeBase.prototype.mult=function(t,e){return this._pushExpr(t,"*",e)},t.TimeBase.prototype.div=function(t,e){return this._pushExpr(t,"/",e)},t.TimeBase.prototype.valueOf=function(){return this._expr()},t.TimeBase.prototype.dispose=function(){this._expr=null},t.TimeBase}(n);var v;v=function(t){return t.Time=function(e,i){return this instanceof t.Time?(this._plusNow=!1,void t.TimeBase.call(this,e,i)):new t.Time(e,i)},t.extend(t.Time,t.TimeBase),t.Time.prototype._unaryExpressions=Object.create(t.TimeBase.prototype._unaryExpressions),t.Time.prototype._unaryExpressions.quantize={regexp:/^@/,method:function(e){return t.Transport.nextSubdivision(e())}},t.Time.prototype._unaryExpressions.now={regexp:/^\+/,method:function(t){return this._plusNow=!0,t()}},t.Time.prototype.quantize=function(t,e){return e=this.defaultArg(e,1),this._expr=function(t,e,i){t=t(),e=e.toSeconds();var n=Math.round(t/e),o=n*e,r=o-t;return t+r*i}.bind(this,this._expr,new this.constructor(t),e),this},t.Time.prototype.addNow=function(){return this._plusNow=!0,this},t.Time.prototype._defaultExpr=function(){return this._plusNow=!0,this._noOp},t.Time.prototype.copy=function(e){return t.TimeBase.prototype.copy.call(this,e),this._plusNow=e._plusNow,this},t.Time.prototype.toNotation=function(){var t=this.toSeconds(),e=["1m","2n","4n","8n","16n","32n","64n","128n"],i=this._toNotationHelper(t,e),n=["1m","2n","2t","4n","4t","8n","8t","16n","16t","32n","32t","64n","64t","128n"],o=this._toNotationHelper(t,n);return o.split("+").length1-s%1&&(s+=a),s=Math.floor(s),s>0){if(n+=1===s?e[o]:s.toString()+"*"+e[o],t-=s*r,i>t)break;n+=" + "}}return""===n&&(n="0"),n},t.Time.prototype._notationToUnits=function(t){for(var e=this._primaryExpressions,i=[e.n,e.t,e.m],n=0;n3&&(n=parseFloat(n).toFixed(3));var o=[i,e,n];return o.join(":")},t.Time.prototype.toTicks=function(){var e=this._beatsToUnits(1),i=this.valueOf()/e;return Math.floor(i*t.Transport.PPQ)},t.Time.prototype.toSamples=function(){return this.toSeconds()*this.context.sampleRate},t.Time.prototype.toFrequency=function(){return 1/this.toSeconds()},t.Time.prototype.toSeconds=function(){return this.valueOf()},t.Time.prototype.toMilliseconds=function(){return 1e3*this.toSeconds()},t.Time.prototype.valueOf=function(){var t=this._expr();return t+(this._plusNow?this.now():0)},t.Time}(n);var g;g=function(t){t.Frequency=function(e,i){return this instanceof t.Frequency?void t.TimeBase.call(this,e,i):new t.Frequency(e,i)},t.extend(t.Frequency,t.TimeBase),t.Frequency.prototype._primaryExpressions=Object.create(t.TimeBase.prototype._primaryExpressions),t.Frequency.prototype._primaryExpressions.midi={regexp:/^(\d+(?:\.\d+)?midi)/,method:function(t){return this.midiToFrequency(t)}},t.Frequency.prototype._primaryExpressions.note={regexp:/^([a-g]{1}(?:b|#|x|bb)?)(-?[0-9]+)/i,method:function(t,i){var n=e[t.toLowerCase()],o=n+12*(parseInt(i)+1);return this.midiToFrequency(o)}},t.Frequency.prototype._primaryExpressions.tr={regexp:/^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?/,method:function(t,e,i){var n=1;return t&&"0"!==t&&(n*=this._beatsToUnits(this._timeSignature()*parseFloat(t))),e&&"0"!==e&&(n*=this._beatsToUnits(parseFloat(e))),i&&"0"!==i&&(n*=this._beatsToUnits(parseFloat(i)/4)),n}},t.Frequency.prototype.transpose=function(t){return this._expr=function(t,e){var i=t();return i*this.intervalToFrequencyRatio(e)}.bind(this,this._expr,t),this},t.Frequency.prototype.harmonize=function(t){return this._expr=function(t,e){for(var i=t(),n=[],o=0;or&&(o+=-12*r);var s=i[o%12];return s+r.toString()},t.Frequency.prototype.toSeconds=function(){return 1/this.valueOf()},t.Frequency.prototype.toFrequency=function(){return this.valueOf()},t.Frequency.prototype.toTicks=function(){var e=this._beatsToUnits(1),i=this.valueOf()/e;return Math.floor(i*t.Transport.PPQ)},t.Frequency.prototype._frequencyToUnits=function(t){return t},t.Frequency.prototype._ticksToUnits=function(e){return 1/(60*e/(t.Transport.bpm.value*t.Transport.PPQ))},t.Frequency.prototype._beatsToUnits=function(e){return 1/t.TimeBase.prototype._beatsToUnits.call(this,e)},t.Frequency.prototype._secondsToUnits=function(t){return 1/t},t.Frequency.prototype._defaultUnits="hz";var e={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},i=["C","C#","D","D#","E","F","F#","G","G#","A","A#","B"];return t.Frequency.A4=440,t.Frequency.prototype.midiToFrequency=function(e){return t.Frequency.A4*Math.pow(2,(e-69)/12)},t.Frequency.prototype.frequencyToMidi=function(e){return 69+12*Math.log(e/t.Frequency.A4)/Math.LN2},t.Frequency}(n);var _;_=function(t){return t.TransportTime=function(e,i){return this instanceof t.TransportTime?void t.Time.call(this,e,i):new t.TransportTime(e,i)},t.extend(t.TransportTime,t.Time),t.TransportTime.prototype._unaryExpressions=Object.create(t.Time.prototype._unaryExpressions),t.TransportTime.prototype._unaryExpressions.quantize={regexp:/^@/,method:function(e){var i=this._secondsToTicks(e()),n=Math.ceil(t.Transport.ticks/i);return this._ticksToUnits(n*i)}},t.TransportTime.prototype._secondsToTicks=function(e){var i=this._beatsToUnits(1),n=e/i;return Math.round(n*t.Transport.PPQ)},t.TransportTime.prototype.valueOf=function(){var e=this._secondsToTicks(this._expr());return e+(this._plusNow?t.Transport.ticks:0)},t.TransportTime.prototype.toTicks=function(){return this.valueOf()},t.TransportTime.prototype.toSeconds=function(){var e=this._expr();return e+(this._plusNow?t.Transport.seconds:0)},t.TransportTime.prototype.toFrequency=function(){return 1/this.toSeconds()},t.TransportTime}(n);var T;T=function(t){return t.Type={Default:"number",Time:"time",Frequency:"frequency",TransportTime:"transportTime",Ticks:"ticks",NormalRange:"normalRange",AudioRange:"audioRange",Decibels:"db",Interval:"interval",BPM:"bpm",Positive:"positive",Cents:"cents",Degrees:"degrees",MIDI:"midi",BarsBeatsSixteenths:"barsBeatsSixteenths",Samples:"samples",Hertz:"hertz",Note:"note",Milliseconds:"milliseconds",Seconds:"seconds",Notation:"notation"},t.prototype.toSeconds=function(e){return this.isNumber(e)?e:this.isUndef(e)?this.now():this.isString(e)?new t.Time(e).toSeconds():e instanceof t.TimeBase?e.toSeconds():void 0},t.prototype.toFrequency=function(e){return this.isNumber(e)?e:this.isString(e)||this.isUndef(e)?new t.Frequency(e).valueOf():e instanceof t.TimeBase?e.toFrequency():void 0},t.prototype.toTicks=function(e){return this.isNumber(e)||this.isString(e)?new t.TransportTime(e).toTicks():this.isUndef(e)?t.Transport.ticks:e instanceof t.TimeBase?e.toTicks():void 0},t}(n,v,g,_);var b;b=function(t){"use strict";return t.Param=function(){var e=this.optionsObject(arguments,["param","units","convert"],t.Param.defaults);this._param=this.input=e.param,this.units=e.units,this.convert=e.convert,this.overridden=!1,this._lfo=null,this.isObject(e.lfo)?this.value=e.lfo:this.isUndef(e.value)||(this.value=e.value)},t.extend(t.Param),t.Param.defaults={units:t.Type.Default,convert:!0,param:void 0},Object.defineProperty(t.Param.prototype,"value",{get:function(){return this._toUnits(this._param.value)},set:function(e){if(this.isObject(e)){if(this.isUndef(t.LFO))throw new Error("Include 'Tone.LFO' to use an LFO as a Param value.");this._lfo&&this._lfo.dispose(),this._lfo=new t.LFO(e).start(),this._lfo.connect(this.input)}else{var i=this._fromUnits(e);this._param.cancelScheduledValues(0),this._param.value=i}}}),t.Param.prototype._fromUnits=function(e){if(!this.convert&&!this.isUndef(this.convert))return e;switch(this.units){case t.Type.Time:return this.toSeconds(e);case t.Type.Frequency:return this.toFrequency(e);case t.Type.Decibels:return this.dbToGain(e);case t.Type.NormalRange:return Math.min(Math.max(e,0),1);case t.Type.AudioRange:return Math.min(Math.max(e,-1),1);case t.Type.Positive:return Math.max(e,0);default:return e}},t.Param.prototype._toUnits=function(e){if(!this.convert&&!this.isUndef(this.convert))return e;switch(this.units){case t.Type.Decibels:return this.gainToDb(e);default:return e}},t.Param.prototype._minOutput=1e-5,t.Param.prototype.setValueAtTime=function(t,e){return t=this._fromUnits(t),e=this.toSeconds(e),e<=this.now()+this.blockTime?this._param.value=t:this._param.setValueAtTime(t,e),this},t.Param.prototype.setRampPoint=function(t){t=this.defaultArg(t,this.now());var e=this._param.value;return 0===e&&(e=this._minOutput),this._param.setValueAtTime(e,t),this},t.Param.prototype.linearRampToValueAtTime=function(t,e){return t=this._fromUnits(t),this._param.linearRampToValueAtTime(t,this.toSeconds(e)),this},t.Param.prototype.exponentialRampToValueAtTime=function(t,e){return t=this._fromUnits(t),t=Math.max(this._minOutput,t),this._param.exponentialRampToValueAtTime(t,this.toSeconds(e)),this},t.Param.prototype.exponentialRampToValue=function(t,e,i){return i=this.toSeconds(i),this.setRampPoint(i),this.exponentialRampToValueAtTime(t,i+this.toSeconds(e)),this},t.Param.prototype.linearRampToValue=function(t,e,i){return i=this.toSeconds(i),this.setRampPoint(i),this.linearRampToValueAtTime(t,i+this.toSeconds(e)),this},t.Param.prototype.setTargetAtTime=function(t,e,i){return t=this._fromUnits(t),t=Math.max(this._minOutput,t),i=Math.max(this._minOutput,i),this._param.setTargetAtTime(t,this.toSeconds(e),i),this},t.Param.prototype.setValueCurveAtTime=function(t,e,i){for(var n=0;n1&&(this.input=new Array(e)),1===i?this.output=new t.Gain:i>1&&(this.output=new Array(e))},t.Gain}(n,b);var S;S=function(t){"use strict";return t.Signal=function(){var e=this.optionsObject(arguments,["value","units"],t.Signal.defaults);this.output=this._gain=this.context.createGain(),e.param=this._gain.gain,t.Param.call(this,e),this.input=this._param=this._gain.gain,this.context.getConstant(1).chain(this._gain)},t.extend(t.Signal,t.Param),t.Signal.defaults={value:0,units:t.Type.Default,convert:!0},t.Signal.prototype.connect=t.SignalBase.prototype.connect,t.Signal.prototype.dispose=function(){return t.Param.prototype.dispose.call(this),this._param=null,this._gain.disconnect(),this._gain=null,this},t.Signal}(n,m,T,b);var w;w=function(t){"use strict";return t.Add=function(e){this.createInsOuts(2,0),this._sum=this.input[0]=this.input[1]=this.output=new t.Gain,this._param=this.input[1]=new t.Signal(e),this._param.connect(this._sum)},t.extend(t.Add,t.Signal),t.Add.prototype.dispose=function(){return t.prototype.dispose.call(this),this._sum.dispose(),this._sum=null,this._param.dispose(),this._param=null,this},t.Add}(n,S);var A;A=function(t){"use strict";return t.Multiply=function(e){this.createInsOuts(2,0),this._mult=this.input[0]=this.output=new t.Gain,this._param=this.input[1]=this.output.gain,this._param.value=this.defaultArg(e,0)},t.extend(t.Multiply,t.Signal),t.Multiply.prototype.dispose=function(){return t.prototype.dispose.call(this),this._mult.dispose(),this._mult=null, +this._param=null,this},t.Multiply}(n,S);var P;P=function(t){"use strict";return t.Scale=function(e,i){this._outputMin=this.defaultArg(e,0),this._outputMax=this.defaultArg(i,1),this._scale=this.input=new t.Multiply(1),this._add=this.output=new t.Add(0),this._scale.connect(this._add),this._setRange()},t.extend(t.Scale,t.SignalBase),Object.defineProperty(t.Scale.prototype,"min",{get:function(){return this._outputMin},set:function(t){this._outputMin=t,this._setRange()}}),Object.defineProperty(t.Scale.prototype,"max",{get:function(){return this._outputMax},set:function(t){this._outputMax=t,this._setRange()}}),t.Scale.prototype._setRange=function(){this._add.value=this._outputMin,this._scale.value=this._outputMax-this._outputMin},t.Scale.prototype.dispose=function(){return t.prototype.dispose.call(this),this._add.dispose(),this._add=null,this._scale.dispose(),this._scale=null,this},t.Scale}(n,w,A);var k;k=function(){var e=S,i=w,n=A,o=P;t.Signal=function(t){var i=new e(t);return i},e.prototype.fade=e.prototype.linearRampToValueAtTime,n.prototype.fade=e.prototype.fade,i.prototype.fade=e.prototype.fade,o.prototype.fade=e.prototype.fade,e.prototype.setInput=function(t){t.connect(this)},n.prototype.setInput=e.prototype.setInput,i.prototype.setInput=e.prototype.setInput,o.prototype.setInput=e.prototype.setInput,e.prototype.add=function(t){var e=new i(t);return this.connect(e),e},n.prototype.add=e.prototype.add,i.prototype.add=e.prototype.add,o.prototype.add=e.prototype.add,e.prototype.mult=function(t){var e=new n(t);return this.connect(e),e},n.prototype.mult=e.prototype.mult,i.prototype.mult=e.prototype.mult,o.prototype.mult=e.prototype.mult,e.prototype.scale=function(e,i,n,r){var s,a;4===arguments.length?(s=t.prototype.map(n,e,i,0,1)-.5,a=t.prototype.map(r,e,i,0,1)-.5):(s=arguments[0],a=arguments[1]);var u=new o(s,a);return this.connect(u),u},n.prototype.scale=e.prototype.scale,i.prototype.scale=e.prototype.scale,o.prototype.scale=e.prototype.scale}(S,w,A,P);var O;O=function(){var e=a,i=w,n=A,o=P;t.Oscillator=function(i,n){if("string"==typeof i){var o=n;n=i,i=o}if("number"==typeof n){var o=n;n=i,i=o}this.started=!1,this.phaseAmount=void 0,this.oscillator=e.audiocontext.createOscillator(),this.f=i||440,this.oscillator.type=n||"sine",this.oscillator.frequency.setValueAtTime(this.f,e.audiocontext.currentTime),this.output=e.audiocontext.createGain(),this._freqMods=[],this.output.gain.value=.5,this.output.gain.setValueAtTime(.5,e.audiocontext.currentTime),this.oscillator.connect(this.output),this.panPosition=0,this.connection=e.input,this.panner=new t.Panner(this.output,this.connection,1),this.mathOps=[this.output],e.soundArray.push(this)},t.Oscillator.prototype.start=function(t,i){if(this.started){var n=e.audiocontext.currentTime;this.stop(n)}if(!this.started){var o=i||this.f,r=this.oscillator.type;this.oscillator&&(this.oscillator.disconnect(),delete this.oscillator),this.oscillator=e.audiocontext.createOscillator(),this.oscillator.frequency.value=Math.abs(o),this.oscillator.type=r,this.oscillator.connect(this.output),t=t||0,this.oscillator.start(t+e.audiocontext.currentTime),this.freqNode=this.oscillator.frequency;for(var s in this._freqMods)"undefined"!=typeof this._freqMods[s].connect&&this._freqMods[s].connect(this.oscillator.frequency);this.started=!0}},t.Oscillator.prototype.stop=function(t){if(this.started){var i=t||0,n=e.audiocontext.currentTime;this.oscillator.stop(i+n),this.started=!1}},t.Oscillator.prototype.amp=function(t,i,n){var o=this;if("number"==typeof t){var i=i||0,n=n||0,r=e.audiocontext.currentTime;this.output.gain.linearRampToValueAtTime(t,r+n+i)}else{if(!t)return this.output.gain;t.connect(o.output.gain)}},t.Oscillator.prototype.fade=t.Oscillator.prototype.amp,t.Oscillator.prototype.getAmp=function(){return this.output.gain.value},t.Oscillator.prototype.freq=function(t,i,n){if("number"!=typeof t||isNaN(t)){if(!t)return this.oscillator.frequency;t.output&&(t=t.output),t.connect(this.oscillator.frequency),this._freqMods.push(t)}else{this.f=t;var o=e.audiocontext.currentTime,i=i||0,n=n||0;0===i?this.oscillator.frequency.setValueAtTime(t,n+o):t>0?this.oscillator.frequency.exponentialRampToValueAtTime(t,n+i+o):this.oscillator.frequency.linearRampToValueAtTime(t,n+i+o),this.phaseAmount&&this.phase(this.phaseAmount)}},t.Oscillator.prototype.getFreq=function(){return this.oscillator.frequency.value},t.Oscillator.prototype.setType=function(t){this.oscillator.type=t},t.Oscillator.prototype.getType=function(){return this.oscillator.type},t.Oscillator.prototype.connect=function(t){t?t.hasOwnProperty("input")?(this.panner.connect(t.input),this.connection=t.input):(this.panner.connect(t),this.connection=t):this.panner.connect(e.input)},t.Oscillator.prototype.disconnect=function(){this.output&&this.output.disconnect(),this.panner&&(this.panner.disconnect(),this.output&&this.output.connect(this.panner)),this.oscMods=[]},t.Oscillator.prototype.pan=function(t,e){this.panPosition=t,this.panner.pan(t,e)},t.Oscillator.prototype.getPan=function(){return this.panPosition},t.Oscillator.prototype.dispose=function(){var t=e.soundArray.indexOf(this);if(e.soundArray.splice(t,1),this.oscillator){var i=e.audiocontext.currentTime;this.stop(i),this.disconnect(),this.panner=null,this.oscillator=null}this.osc2&&this.osc2.dispose()},t.Oscillator.prototype.phase=function(i){var n=t.prototype.map(i,0,1,0,1/this.f),o=e.audiocontext.currentTime;this.phaseAmount=i,this.dNode||(this.dNode=e.audiocontext.createDelay(),this.oscillator.disconnect(),this.oscillator.connect(this.dNode),this.dNode.connect(this.output)),this.dNode.delayTime.setValueAtTime(n,o)};var r=function(t,e,i,n,o){var r=t.oscillator;for(var s in t.mathOps)t.mathOps[s]instanceof o&&(r.disconnect(),t.mathOps[s].dispose(),i=s,i0&&(r=t.mathOps[s-1]),r.disconnect(),r.connect(e),e.connect(n),t.mathOps[i]=e,t};t.Oscillator.prototype.add=function(t){var e=new i(t),n=this.mathOps.length-1,o=this.output;return r(this,e,n,o,i)},t.Oscillator.prototype.mult=function(t){var e=new n(t),i=this.mathOps.length-1,o=this.output;return r(this,e,i,o,n)},t.Oscillator.prototype.scale=function(e,i,n,s){var a,u;4===arguments.length?(a=t.prototype.map(n,e,i,0,1)-.5,u=t.prototype.map(s,e,i,0,1)-.5):(a=arguments[0],u=arguments[1]);var c=new o(a,u),p=this.mathOps.length-1,h=this.output;return r(this,c,p,h,o)},t.SinOsc=function(e){t.Oscillator.call(this,e,"sine")},t.SinOsc.prototype=Object.create(t.Oscillator.prototype),t.TriOsc=function(e){t.Oscillator.call(this,e,"triangle")},t.TriOsc.prototype=Object.create(t.Oscillator.prototype),t.SawOsc=function(e){t.Oscillator.call(this,e,"sawtooth")},t.SawOsc.prototype=Object.create(t.Oscillator.prototype),t.SqrOsc=function(e){t.Oscillator.call(this,e,"square")},t.SqrOsc.prototype=Object.create(t.Oscillator.prototype)}(a,w,A,P);var F;F=function(t){"use strict";return t.Timeline=function(){var e=this.optionsObject(arguments,["memory"],t.Timeline.defaults);this._timeline=[],this._toRemove=[],this._iterating=!1,this.memory=e.memory},t.extend(t.Timeline),t.Timeline.defaults={memory:1/0},Object.defineProperty(t.Timeline.prototype,"length",{get:function(){return this._timeline.length}}),t.Timeline.prototype.add=function(t){if(this.isUndef(t.time))throw new Error("Tone.Timeline: events must have a time attribute");if(this._timeline.length){var e=this._search(t.time);this._timeline.splice(e+1,0,t)}else this._timeline.push(t);if(this.length>this.memory){var i=this.length-this.memory;this._timeline.splice(0,i)}return this},t.Timeline.prototype.remove=function(t){if(this._iterating)this._toRemove.push(t);else{var e=this._timeline.indexOf(t);-1!==e&&this._timeline.splice(e,1)}return this},t.Timeline.prototype.get=function(t){var e=this._search(t);return-1!==e?this._timeline[e]:null},t.Timeline.prototype.peek=function(){return this._timeline[0]},t.Timeline.prototype.shift=function(){return this._timeline.shift()},t.Timeline.prototype.getAfter=function(t){var e=this._search(t);return e+10&&this._timeline[e-1].time=0?this._timeline[i-1]:null},t.Timeline.prototype.cancel=function(t){if(this._timeline.length>1){var e=this._search(t);if(e>=0)if(this._timeline[e].time===t){for(var i=e;i>=0&&this._timeline[i].time===t;i--)e=i;this._timeline=this._timeline.slice(0,e)}else this._timeline=this._timeline.slice(0,e+1);else this._timeline=[]}else 1===this._timeline.length&&this._timeline[0].time>=t&&(this._timeline=[]);return this},t.Timeline.prototype.cancelBefore=function(t){if(this._timeline.length){var e=this._search(t);e>=0&&(this._timeline=this._timeline.slice(e+1))}return this},t.Timeline.prototype._search=function(t){var e=0,i=this._timeline.length,n=i;if(i>0&&this._timeline[i-1].time<=t)return i-1;for(;n>e;){var o=Math.floor(e+(n-e)/2),r=this._timeline[o],s=this._timeline[o+1];if(r.time===t){for(var a=o;at)return o;r.time>t?n=o:r.time=n;n++)t(this._timeline[n]);if(this._iterating=!1,this._toRemove.length>0){for(var o=0;o=0&&this._timeline[i].time>=t;)i--;return this._iterate(e,i+1),this},t.Timeline.prototype.forEachAtTime=function(t,e){var i=this._search(t);return-1!==i&&this._iterate(function(i){i.time===t&&e(i)},0,i),this},t.Timeline.prototype.dispose=function(){t.prototype.dispose.call(this),this._timeline=null,this._toRemove=null},t.Timeline}(n);var q;q=function(t){"use strict";return t.TimelineSignal=function(){var e=this.optionsObject(arguments,["value","units"],t.Signal.defaults);this._events=new t.Timeline(10),t.Signal.apply(this,e),e.param=this._param,t.Param.call(this,e),this._initial=this._fromUnits(this._param.value)},t.extend(t.TimelineSignal,t.Param),t.TimelineSignal.Type={Linear:"linear",Exponential:"exponential",Target:"target",Curve:"curve",Set:"set"},Object.defineProperty(t.TimelineSignal.prototype,"value",{get:function(){var t=this.now(),e=this.getValueAtTime(t);return this._toUnits(e)},set:function(t){var e=this._fromUnits(t);this._initial=e,this.cancelScheduledValues(),this._param.value=e}}),t.TimelineSignal.prototype.setValueAtTime=function(e,i){return e=this._fromUnits(e),i=this.toSeconds(i),this._events.add({type:t.TimelineSignal.Type.Set,value:e,time:i}),this._param.setValueAtTime(e,i),this},t.TimelineSignal.prototype.linearRampToValueAtTime=function(e,i){return e=this._fromUnits(e),i=this.toSeconds(i),this._events.add({type:t.TimelineSignal.Type.Linear,value:e,time:i}),this._param.linearRampToValueAtTime(e,i),this},t.TimelineSignal.prototype.exponentialRampToValueAtTime=function(e,i){i=this.toSeconds(i);var n=this._searchBefore(i);n&&0===n.value&&this.setValueAtTime(this._minOutput,n.time),e=this._fromUnits(e);var o=Math.max(e,this._minOutput);return this._events.add({type:t.TimelineSignal.Type.Exponential,value:o,time:i}),ee)this.cancelScheduledValues(e),this.linearRampToValueAtTime(i,e);else{var o=this._searchAfter(e);o&&(this.cancelScheduledValues(e),o.type===t.TimelineSignal.Type.Linear?this.linearRampToValueAtTime(i,e):o.type===t.TimelineSignal.Type.Exponential&&this.exponentialRampToValueAtTime(i,e)),this.setValueAtTime(i,e)}return this},t.TimelineSignal.prototype.linearRampToValueBetween=function(t,e,i){return this.setRampPoint(e),this.linearRampToValueAtTime(t,i),this},t.TimelineSignal.prototype.exponentialRampToValueBetween=function(t,e,i){return this.setRampPoint(e),this.exponentialRampToValueAtTime(t,i),this},t.TimelineSignal.prototype._searchBefore=function(t){return this._events.get(t)},t.TimelineSignal.prototype._searchAfter=function(t){return this._events.getAfter(t)},t.TimelineSignal.prototype.getValueAtTime=function(e){e=this.toSeconds(e);var i=this._searchAfter(e),n=this._searchBefore(e),o=this._initial;if(null===n)o=this._initial;else if(n.type===t.TimelineSignal.Type.Target){var r,s=this._events.getBefore(n.time);r=null===s?this._initial:s.value,o=this._exponentialApproach(n.time,r,n.value,n.constant,e)}else o=n.type===t.TimelineSignal.Type.Curve?this._curveInterpolate(n.time,n.value,n.duration,e):null===i?n.value:i.type===t.TimelineSignal.Type.Linear?this._linearInterpolate(n.time,n.value,i.time,i.value,e):i.type===t.TimelineSignal.Type.Exponential?this._exponentialInterpolate(n.time,n.value,i.time,i.value,e):n.value;return o},t.TimelineSignal.prototype.connect=t.SignalBase.prototype.connect,t.TimelineSignal.prototype._exponentialApproach=function(t,e,i,n,o){return i+(e-i)*Math.exp(-(o-t)/n)},t.TimelineSignal.prototype._linearInterpolate=function(t,e,i,n,o){return e+(n-e)*((o-t)/(i-t))},t.TimelineSignal.prototype._exponentialInterpolate=function(t,e,i,n,o){return e=Math.max(this._minOutput,e),e*Math.pow(n/e,(o-t)/(i-t))},t.TimelineSignal.prototype._curveInterpolate=function(t,e,i,n){var o=e.length;if(n>=t+i)return e[o-1];if(t>=n)return e[0];var r=(n-t)/i,s=Math.floor((o-1)*r),a=Math.ceil((o-1)*r),u=e[s],c=e[a];return a===s?u:this._linearInterpolate(s,u,a,c,r*(o-1))},t.TimelineSignal.prototype.dispose=function(){t.Signal.prototype.dispose.call(this),t.Param.prototype.dispose.call(this),this._events.dispose(),this._events=null},t.TimelineSignal}(n,S);var M;M=function(){var e=a,i=w,n=A,o=P,r=q;t.Envelope=function(t,i,n,o,s,a){this.aTime=t||.1,this.aLevel=i||1,this.dTime=n||.5,this.dLevel=o||0,this.rTime=s||0,this.rLevel=a||0,this._rampHighPercentage=.98,this._rampLowPercentage=.02,this.output=e.audiocontext.createGain(),this.control=new r,this._init(),this.control.connect(this.output),this.connection=null,this.mathOps=[this.control],this.isExponential=!1,this.sourceToClear=null,this.wasTriggered=!1,e.soundArray.push(this)},t.Envelope.prototype._init=function(){var t=e.audiocontext.currentTime,i=t;this.control.setTargetAtTime(1e-5,i,.001),this._setRampAD(this.aTime,this.dTime)},t.Envelope.prototype.set=function(t,e,i,n,o,r){this.aTime=t,this.aLevel=e,this.dTime=i||0,this.dLevel=n||0,this.rTime=o||0,this.rLevel=r||0,this._setRampAD(t,i)},t.Envelope.prototype.setADSR=function(t,e,i,n){this.aTime=t,this.dTime=e||0,this.sPercent=i||0,this.dLevel="undefined"!=typeof i?i*(this.aLevel-this.rLevel)+this.rLevel:0,this.rTime=n||0,this._setRampAD(t,e)},t.Envelope.prototype.setRange=function(t,e){this.aLevel=t||1,this.rLevel=e||0},t.Envelope.prototype._setRampAD=function(t,e){this._rampAttackTime=this.checkExpInput(t),this._rampDecayTime=this.checkExpInput(e);var i=1;i=Math.log(1/this.checkExpInput(1-this._rampHighPercentage)),this._rampAttackTC=t/this.checkExpInput(i),i=Math.log(1/this._rampLowPercentage),this._rampDecayTC=e/this.checkExpInput(i)},t.Envelope.prototype.setRampPercentages=function(t,e){this._rampHighPercentage=this.checkExpInput(t),this._rampLowPercentage=this.checkExpInput(e);var i=1;i=Math.log(1/this.checkExpInput(1-this._rampHighPercentage)),this._rampAttackTC=this._rampAttackTime/this.checkExpInput(i),i=Math.log(1/this._rampLowPercentage),this._rampDecayTC=this._rampDecayTime/this.checkExpInput(i)},t.Envelope.prototype.setInput=function(){for(var t=0;t=t&&(t=1e-8),t},t.Envelope.prototype.play=function(t,e,i){var n=e||0,i=i||0;t&&this.connection!==t&&this.connect(t),this.triggerAttack(t,n),this.triggerRelease(t,n+this.aTime+this.dTime+i)},t.Envelope.prototype.triggerAttack=function(t,i){var n=e.audiocontext.currentTime,o=i||0,r=n+o;this.lastAttack=r,this.wasTriggered=!0,t&&this.connection!==t&&this.connect(t);var s=this.control.getValueAtTime(r);this.isExponential===!0?this.control.exponentialRampToValueAtTime(this.checkExpInput(s),r):this.control.linearRampToValueAtTime(s,r),r+=this.aTime,this.isExponential===!0?(this.control.exponentialRampToValueAtTime(this.checkExpInput(this.aLevel),r),s=this.checkExpInput(this.control.getValueAtTime(r)),this.control.cancelScheduledValues(r),this.control.exponentialRampToValueAtTime(s,r)):(this.control.linearRampToValueAtTime(this.aLevel,r),s=this.control.getValueAtTime(r),this.control.cancelScheduledValues(r),this.control.linearRampToValueAtTime(s,r)),r+=this.dTime,this.isExponential===!0?(this.control.exponentialRampToValueAtTime(this.checkExpInput(this.dLevel),r),s=this.checkExpInput(this.control.getValueAtTime(r)),this.control.cancelScheduledValues(r),this.control.exponentialRampToValueAtTime(s,r)):(this.control.linearRampToValueAtTime(this.dLevel,r),s=this.control.getValueAtTime(r),this.control.cancelScheduledValues(r),this.control.linearRampToValueAtTime(s,r))},t.Envelope.prototype.triggerRelease=function(t,i){if(this.wasTriggered){var n=e.audiocontext.currentTime,o=i||0,r=n+o;t&&this.connection!==t&&this.connect(t);var s=this.control.getValueAtTime(r);this.isExponential===!0?this.control.exponentialRampToValueAtTime(this.checkExpInput(s),r):this.control.linearRampToValueAtTime(s,r),r+=this.rTime,this.isExponential===!0?(this.control.exponentialRampToValueAtTime(this.checkExpInput(this.rLevel),r),s=this.checkExpInput(this.control.getValueAtTime(r)),this.control.cancelScheduledValues(r),this.control.exponentialRampToValueAtTime(s,r)):(this.control.linearRampToValueAtTime(this.rLevel,r),s=this.control.getValueAtTime(r),this.control.cancelScheduledValues(r),this.control.linearRampToValueAtTime(s,r)),this.wasTriggered=!1}},t.Envelope.prototype.ramp=function(t,i,n,o){var r=e.audiocontext.currentTime,s=i||0,a=r+s,u=this.checkExpInput(n),c="undefined"!=typeof o?this.checkExpInput(o):void 0;t&&this.connection!==t&&this.connect(t);var p=this.checkExpInput(this.control.getValueAtTime(a));u>p?(this.control.setTargetAtTime(u,a,this._rampAttackTC),a+=this._rampAttackTime):p>u&&(this.control.setTargetAtTime(u,a,this._rampDecayTC),a+=this._rampDecayTime),void 0!==c&&(c>u?this.control.setTargetAtTime(c,a,this._rampAttackTC):u>c&&this.control.setTargetAtTime(c,a,this._rampDecayTC))},t.Envelope.prototype.connect=function(i){this.connection=i,(i instanceof t.Oscillator||i instanceof t.SoundFile||i instanceof t.AudioIn||i instanceof t.Reverb||i instanceof t.Noise||i instanceof t.Filter||i instanceof t.Delay)&&(i=i.output.gain),i instanceof AudioParam&&i.setValueAtTime(0,e.audiocontext.currentTime),i instanceof t.Signal&&i.setValue(0),this.output.connect(i)},t.Envelope.prototype.disconnect=function(){this.output&&this.output.disconnect()},t.Envelope.prototype.add=function(e){var n=new i(e),o=this.mathOps.length,r=this.output;return t.prototype._mathChain(this,n,o,r,i)},t.Envelope.prototype.mult=function(e){var i=new n(e),o=this.mathOps.length,r=this.output;return t.prototype._mathChain(this,i,o,r,n)},t.Envelope.prototype.scale=function(e,i,n,r){var s=new o(e,i,n,r),a=this.mathOps.length,u=this.output;return t.prototype._mathChain(this,s,a,u,o)},t.Envelope.prototype.dispose=function(){var t=e.soundArray.indexOf(this);e.soundArray.splice(t,1),this.disconnect(),this.control&&(this.control.dispose(),this.control=null);for(var i=1;io;o++)n[o]=1;var r=t.createBufferSource();return r.buffer=e,r.loop=!0,r}var i=a;t.Pulse=function(n,o){t.Oscillator.call(this,n,"sawtooth"),this.w=o||0,this.osc2=new t.SawOsc(n),this.dNode=i.audiocontext.createDelay(),this.dcOffset=e(),this.dcGain=i.audiocontext.createGain(),this.dcOffset.connect(this.dcGain),this.dcGain.connect(this.output),this.f=n||440;var r=this.w/this.oscillator.frequency.value;this.dNode.delayTime.value=r,this.dcGain.gain.value=1.7*(.5-this.w),this.osc2.disconnect(),this.osc2.panner.disconnect(),this.osc2.amp(-1),this.osc2.output.connect(this.dNode),this.dNode.connect(this.output),this.output.gain.value=1,this.output.connect(this.panner)},t.Pulse.prototype=Object.create(t.Oscillator.prototype),t.Pulse.prototype.width=function(e){if("number"==typeof e){if(1>=e&&e>=0){this.w=e;var i=this.w/this.oscillator.frequency.value;this.dNode.delayTime.value=i}this.dcGain.gain.value=1.7*(.5-this.w)}else{e.connect(this.dNode.delayTime);var n=new t.SignalAdd(-.5);n.setInput(e),n=n.mult(-1),n=n.mult(1.7),n.connect(this.dcGain.gain)}},t.Pulse.prototype.start=function(t,n){var o=i.audiocontext.currentTime,r=n||0;if(!this.started){var s=t||this.f,a=this.oscillator.type;this.oscillator=i.audiocontext.createOscillator(),this.oscillator.frequency.setValueAtTime(s,o),this.oscillator.type=a,this.oscillator.connect(this.output),this.oscillator.start(r+o),this.osc2.oscillator=i.audiocontext.createOscillator(),this.osc2.oscillator.frequency.setValueAtTime(s,r+o),this.osc2.oscillator.type=a,this.osc2.oscillator.connect(this.osc2.output),this.osc2.start(r+o),this.freqNode=[this.oscillator.frequency,this.osc2.oscillator.frequency],this.dcOffset=e(),this.dcOffset.connect(this.dcGain),this.dcOffset.start(r+o),void 0!==this.mods&&void 0!==this.mods.frequency&&(this.mods.frequency.connect(this.freqNode[0]),this.mods.frequency.connect(this.freqNode[1])),this.started=!0,this.osc2.started=!0}},t.Pulse.prototype.stop=function(t){if(this.started){var e=t||0,n=i.audiocontext.currentTime;this.oscillator.stop(e+n),this.osc2.oscillator&&this.osc2.oscillator.stop(e+n),this.dcOffset.stop(e+n),this.started=!1,this.osc2.started=!1}},t.Pulse.prototype.freq=function(t,e,n){if("number"==typeof t){this.f=t;var o=i.audiocontext.currentTime,e=e||0,n=n||0,r=this.oscillator.frequency.value;this.oscillator.frequency.cancelScheduledValues(o),this.oscillator.frequency.setValueAtTime(r,o+n),this.oscillator.frequency.exponentialRampToValueAtTime(t,n+e+o),this.osc2.oscillator.frequency.cancelScheduledValues(o),this.osc2.oscillator.frequency.setValueAtTime(r,o+n),this.osc2.oscillator.frequency.exponentialRampToValueAtTime(t,n+e+o),this.freqMod&&(this.freqMod.output.disconnect(),this.freqMod=null)}else t.output&&(t.output.disconnect(),t.output.connect(this.oscillator.frequency),t.output.connect(this.osc2.oscillator.frequency),this.freqMod=t)}}(a,O);var V;V=function(){var e=a;t.Noise=function(e){var r;t.Oscillator.call(this),delete this.f,delete this.freq,delete this.oscillator,r="brown"===e?o:"pink"===e?n:i,this.buffer=r},t.Noise.prototype=Object.create(t.Oscillator.prototype);var i=function(){for(var t=2*e.audiocontext.sampleRate,i=e.audiocontext.createBuffer(1,t,e.audiocontext.sampleRate),n=i.getChannelData(0),o=0;t>o;o++)n[o]=2*Math.random()-1;return i.type="white",i}(),n=function(){var t,i,n,o,r,s,a,u=2*e.audiocontext.sampleRate,c=e.audiocontext.createBuffer(1,u,e.audiocontext.sampleRate),p=c.getChannelData(0);t=i=n=o=r=s=a=0;for(var h=0;u>h;h++){var l=2*Math.random()-1;t=.99886*t+.0555179*l,i=.99332*i+.0750759*l,n=.969*n+.153852*l,o=.8665*o+.3104856*l,r=.55*r+.5329522*l,s=-.7616*s-.016898*l,p[h]=t+i+n+o+r+s+a+.5362*l,p[h]*=.11,a=.115926*l}return c.type="pink",c}(),o=function(){for(var t=2*e.audiocontext.sampleRate,i=e.audiocontext.createBuffer(1,t,e.audiocontext.sampleRate),n=i.getChannelData(0),o=0,r=0;t>r;r++){var s=2*Math.random()-1;n[r]=(o+.02*s)/1.02,o=n[r],n[r]*=3.5}return i.type="brown",i}();t.Noise.prototype.setType=function(t){switch(t){case"white":this.buffer=i;break;case"pink":this.buffer=n;break;case"brown":this.buffer=o;break;default:this.buffer=i}if(this.started){var r=e.audiocontext.currentTime;this.stop(r),this.start(r+.01)}},t.Noise.prototype.getType=function(){return this.buffer.type},t.Noise.prototype.start=function(){this.started&&this.stop(),this.noise=e.audiocontext.createBufferSource(),this.noise.buffer=this.buffer,this.noise.loop=!0,this.noise.connect(this.output);var t=e.audiocontext.currentTime;this.noise.start(t),this.started=!0},t.Noise.prototype.stop=function(){var t=e.audiocontext.currentTime;this.noise&&(this.noise.stop(t),this.started=!1)},t.Noise.prototype.dispose=function(){var t=e.audiocontext.currentTime,i=e.soundArray.indexOf(this);e.soundArray.splice(i,1),this.noise&&(this.noise.disconnect(),this.stop(t)),this.output&&this.output.disconnect(),this.panner&&this.panner.disconnect(),this.output=null,this.panner=null,this.buffer=null,this.noise=null}}(a);var R;R=function(){var e=a;e.inputSources=[],t.AudioIn=function(i){this.input=e.audiocontext.createGain(),this.output=e.audiocontext.createGain(),this.stream=null,this.mediaStream=null,this.currentSource=null,this.enabled=!1,this.amplitude=new t.Amplitude,this.output.connect(this.amplitude.input),window.MediaStreamTrack&&window.navigator.mediaDevices&&window.navigator.mediaDevices.getUserMedia||(i?i():window.alert("This browser does not support MediaStreamTrack and mediaDevices")),e.soundArray.push(this)},t.AudioIn.prototype.start=function(t,i){var n=this;this.stream&&this.stop();var o=e.inputSources[n.currentSource],r={audio:{sampleRate:e.audiocontext.sampleRate,echoCancellation:!1}};e.inputSources[this.currentSource]&&(r.audio.deviceId=o.deviceId),window.navigator.mediaDevices.getUserMedia(r).then(function(i){n.stream=i,n.enabled=!0,n.mediaStream=e.audiocontext.createMediaStreamSource(i),n.mediaStream.connect(n.output),n.amplitude.setInput(n.output),t&&t()})["catch"](function(t){i?i(t):console.error(t)})},t.AudioIn.prototype.stop=function(){this.stream&&(this.stream.getTracks().forEach(function(t){t.stop()}),this.mediaStream.disconnect(),delete this.mediaStream,delete this.stream)},t.AudioIn.prototype.connect=function(t){t?t.hasOwnProperty("input")?this.output.connect(t.input):t.hasOwnProperty("analyser")?this.output.connect(t.analyser):this.output.connect(t):this.output.connect(e.input)},t.AudioIn.prototype.disconnect=function(){this.output&&(this.output.disconnect(),this.output.connect(this.amplitude.input))},t.AudioIn.prototype.getLevel=function(t){return t&&(this.amplitude.smoothing=t),this.amplitude.getLevel()},t.AudioIn.prototype.amp=function(t,i){if(i){var n=i||0,o=this.output.gain.value;this.output.gain.cancelScheduledValues(e.audiocontext.currentTime),this.output.gain.setValueAtTime(o,e.audiocontext.currentTime),this.output.gain.linearRampToValueAtTime(t,n+e.audiocontext.currentTime)}else this.output.gain.cancelScheduledValues(e.audiocontext.currentTime),this.output.gain.setValueAtTime(t,e.audiocontext.currentTime)},t.AudioIn.prototype.getSources=function(t,i){return new Promise(function(n,o){window.navigator.mediaDevices.enumerateDevices().then(function(i){e.inputSources=i.filter(function(t){return"audioinput"===t.kind}),n(e.inputSources),t&&t(e.inputSources)})["catch"](function(t){o(t),i?i(t):console.error("This browser does not support MediaStreamTrack.getSources()")})})},t.AudioIn.prototype.setSource=function(t){e.inputSources.length>0&&t=t?0:1},127),this._scale=this.input=new t.Multiply(1e4),this._scale.connect(this._thresh)},t.extend(t.GreaterThanZero,t.SignalBase),t.GreaterThanZero.prototype.dispose=function(){return t.prototype.dispose.call(this),this._scale.dispose(),this._scale=null,this._thresh.dispose(),this._thresh=null,this},t.GreaterThanZero}(n,S,A);var B;B=function(t){"use strict";return t.GreaterThan=function(e){this.createInsOuts(2,0),this._param=this.input[0]=new t.Subtract(e),this.input[1]=this._param.input[1],this._gtz=this.output=new t.GreaterThanZero,this._param.connect(this._gtz)},t.extend(t.GreaterThan,t.Signal),t.GreaterThan.prototype.dispose=function(){return t.prototype.dispose.call(this),this._param.dispose(),this._param=null,this._gtz.dispose(),this._gtz=null,this},t.GreaterThan}(n,N,D);var U;U=function(t){"use strict";return t.Abs=function(){this._abs=this.input=this.output=new t.WaveShaper(function(t){return 0===t?0:Math.abs(t)},127)},t.extend(t.Abs,t.SignalBase),t.Abs.prototype.dispose=function(){return t.prototype.dispose.call(this),this._abs.dispose(),this._abs=null,this},t.Abs}(n,m);var I;I=function(t){"use strict";return t.Modulo=function(e){this.createInsOuts(1,0),this._shaper=new t.WaveShaper(Math.pow(2,16)),this._multiply=new t.Multiply,this._subtract=this.output=new t.Subtract,this._modSignal=new t.Signal(e),this.input.fan(this._shaper,this._subtract),this._modSignal.connect(this._multiply,0,0),this._shaper.connect(this._multiply,0,1),this._multiply.connect(this._subtract,0,1),this._setWaveShaper(e)},t.extend(t.Modulo,t.SignalBase),t.Modulo.prototype._setWaveShaper=function(t){this._shaper.setMap(function(e){var i=Math.floor((e+1e-4)/t);return i; +})},Object.defineProperty(t.Modulo.prototype,"value",{get:function(){return this._modSignal.value},set:function(t){this._modSignal.value=t,this._setWaveShaper(t)}}),t.Modulo.prototype.dispose=function(){return t.prototype.dispose.call(this),this._shaper.dispose(),this._shaper=null,this._multiply.dispose(),this._multiply=null,this._subtract.dispose(),this._subtract=null,this._modSignal.dispose(),this._modSignal=null,this},t.Modulo}(n,m,A);var G;G=function(t){"use strict";return t.Pow=function(e){this._exp=this.defaultArg(e,1),this._expScaler=this.input=this.output=new t.WaveShaper(this._expFunc(this._exp),8192)},t.extend(t.Pow,t.SignalBase),Object.defineProperty(t.Pow.prototype,"value",{get:function(){return this._exp},set:function(t){this._exp=t,this._expScaler.setMap(this._expFunc(this._exp))}}),t.Pow.prototype._expFunc=function(t){return function(e){return Math.pow(Math.abs(e),t)}},t.Pow.prototype.dispose=function(){return t.prototype.dispose.call(this),this._expScaler.dispose(),this._expScaler=null,this},t.Pow}(n);var L;L=function(t){"use strict";return t.AudioToGain=function(){this._norm=this.input=this.output=new t.WaveShaper(function(t){return(t+1)/2})},t.extend(t.AudioToGain,t.SignalBase),t.AudioToGain.prototype.dispose=function(){return t.prototype.dispose.call(this),this._norm.dispose(),this._norm=null,this},t.AudioToGain}(n,m);var j;j=function(t){"use strict";function e(t,e,i){var n=new t;return i._eval(e[0]).connect(n,0,0),i._eval(e[1]).connect(n,0,1),n}function i(t,e,i){var n=new t;return i._eval(e[0]).connect(n,0,0),n}function n(t){return t?parseFloat(t):void 0}function o(t){return t&&t.args?parseFloat(t.args):void 0}return t.Expr=function(){var t=this._replacements(Array.prototype.slice.call(arguments)),e=this._parseInputs(t);this._nodes=[],this.input=new Array(e);for(var i=0;e>i;i++)this.input[i]=this.context.createGain();var n,o=this._parseTree(t);try{n=this._eval(o)}catch(r){throw this._disposeNodes(),new Error("Tone.Expr: Could evaluate expression: "+t)}this.output=n},t.extend(t.Expr,t.SignalBase),t.Expr._Expressions={value:{signal:{regexp:/^\d+\.\d+|^\d+/,method:function(e){var i=new t.Signal(n(e));return i}},input:{regexp:/^\$\d/,method:function(t,e){return e.input[n(t.substr(1))]}}},glue:{"(":{regexp:/^\(/},")":{regexp:/^\)/},",":{regexp:/^,/}},func:{abs:{regexp:/^abs/,method:i.bind(this,t.Abs)},mod:{regexp:/^mod/,method:function(e,i){var n=o(e[1]),r=new t.Modulo(n);return i._eval(e[0]).connect(r),r}},pow:{regexp:/^pow/,method:function(e,i){var n=o(e[1]),r=new t.Pow(n);return i._eval(e[0]).connect(r),r}},a2g:{regexp:/^a2g/,method:function(e,i){var n=new t.AudioToGain;return i._eval(e[0]).connect(n),n}}},binary:{"+":{regexp:/^\+/,precedence:1,method:e.bind(this,t.Add)},"-":{regexp:/^\-/,precedence:1,method:function(n,o){return 1===n.length?i(t.Negate,n,o):e(t.Subtract,n,o)}},"*":{regexp:/^\*/,precedence:0,method:e.bind(this,t.Multiply)}},unary:{"-":{regexp:/^\-/,method:i.bind(this,t.Negate)},"!":{regexp:/^\!/,method:i.bind(this,t.NOT)}}},t.Expr.prototype._parseInputs=function(t){var e=t.match(/\$\d/g),i=0;if(null!==e)for(var n=0;n0;){e=e.trim();var r=i(e);o.push(r),e=e.substr(r.value.length)}return{next:function(){return o[++n]},peek:function(){return o[n+1]}}},t.Expr.prototype._parseTree=function(e){function i(t,e){return!p(t)&&"glue"===t.type&&t.value===e}function n(e,i,n){var o=!1,r=t.Expr._Expressions[i];if(!p(e))for(var s in r){var a=r[s];if(a.regexp.test(e.value)){if(p(n))return!0;if(a.precedence===n)return!0}}return o}function o(t){p(t)&&(t=5);var e;e=0>t?r():o(t-1);for(var i=c.peek();n(i,"binary",t);)i=c.next(),e={operator:i.value,method:i.method,args:[e,o(t-1)]},i=c.peek();return e}function r(){var t,e;return t=c.peek(),n(t,"unary")?(t=c.next(),e=r(),{operator:t.value,method:t.method,args:[e]}):s()}function s(){var t,e;if(t=c.peek(),p(t))throw new SyntaxError("Tone.Expr: Unexpected termination of expression");if("func"===t.type)return t=c.next(),a(t);if("value"===t.type)return t=c.next(),{method:t.method,args:t.value};if(i(t,"(")){if(c.next(),e=o(),t=c.next(),!i(t,")"))throw new SyntaxError("Expected )");return e}throw new SyntaxError("Tone.Expr: Parse error, cannot process token "+t.value)}function a(t){var e,n=[];if(e=c.next(),!i(e,"("))throw new SyntaxError('Tone.Expr: Expected ( in a function call "'+t.value+'"');if(e=c.peek(),i(e,")")||(n=u()),e=c.next(),!i(e,")"))throw new SyntaxError('Tone.Expr: Expected ) in a function call "'+t.value+'"');return{method:t.method,args:n,name:name}}function u(){for(var t,e,n=[];;){if(e=o(),p(e))break;if(n.push(e),t=c.peek(),!i(t,","))break;c.next()}return n}var c=this._tokenize(e),p=this.isUndef.bind(this);return o()},t.Expr.prototype._eval=function(t){if(!this.isUndef(t)){var e=t.method(t.args,this);return this._nodes.push(e),e}},t.Expr.prototype._disposeNodes=function(){for(var t=0;t0){this.connect(arguments[0]);for(var t=1;t=t&&(t=1),"number"==typeof t?(this.biquad.frequency.cancelScheduledValues(this.ac.currentTime+.01+i),this.biquad.frequency.exponentialRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.biquad.frequency),this.biquad.frequency.value},t.Filter.prototype.res=function(t,e){var i=e||0;return"number"==typeof t?(this.biquad.Q.value=t,this.biquad.Q.cancelScheduledValues(this.ac.currentTime+.01+i),this.biquad.Q.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.biquad.Q),this.biquad.Q.value},t.Filter.prototype.gain=function(t,e){var i=e||0;return"number"==typeof t?(this.biquad.gain.value=t,this.biquad.gain.cancelScheduledValues(this.ac.currentTime+.01+i),this.biquad.gain.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.biquad.gain),this.biquad.gain.value},t.Filter.prototype.toggle=function(){return this._on=!this._on,this._on===!0?this.biquad.type=this._untoggledType:this._on===!1&&(this.biquad.type="allpass"),this._on},t.Filter.prototype.setType=function(t){this.biquad.type=t,this._untoggledType=this.biquad.type},t.Filter.prototype.dispose=function(){e.prototype.dispose.apply(this),this.biquad&&(this.biquad.disconnect(),delete this.biquad)},t.LowPass=function(){t.Filter.call(this,"lowpass")},t.LowPass.prototype=Object.create(t.Filter.prototype),t.HighPass=function(){t.Filter.call(this,"highpass")},t.HighPass.prototype=Object.create(t.Filter.prototype),t.BandPass=function(){t.Filter.call(this,"bandpass")},t.BandPass.prototype=Object.create(t.Filter.prototype),t.Filter}(a,Y);var W;W=function(){var e=z,i=a,n=function(t,i){e.call(this,"peaking"),this.disconnect(),this.set(t,i),this.biquad.gain.value=0,delete this.input,delete this.output,delete this._drywet,delete this.wet};return n.prototype=Object.create(e.prototype),n.prototype.amp=function(){console.warn("`amp()` is not available for p5.EQ bands. Use `.gain()`")},n.prototype.drywet=function(){console.warn("`drywet()` is not available for p5.EQ bands.")},n.prototype.connect=function(e){var i=e||t.soundOut.input;this.biquad?this.biquad.connect(i.input?i.input:i):this.output.connect(i.input?i.input:i)},n.prototype.disconnect=function(){this.biquad&&this.biquad.disconnect()},n.prototype.dispose=function(){var t=i.soundArray.indexOf(this);i.soundArray.splice(t,1),this.disconnect(),delete this.biquad},n}(z,a);var Q;Q=function(){var e=Y,i=W;return t.EQ=function(t){e.call(this),t=3===t||8===t?t:3;var i;i=3===t?Math.pow(2,3):2,this.bands=[];for(var n,o,r=0;t>r;r++)r===t-1?(n=21e3,o=.01):0===r?(n=100,o=.1):1===r?(n=3===t?360*i:360,o=1):(n=this.bands[r-1].freq()*i,o=1),this.bands[r]=this._newBand(n,o),r>0?this.bands[r-1].connect(this.bands[r].biquad):this.input.connect(this.bands[r].biquad);this.bands[t-1].connect(this.output)},t.EQ.prototype=Object.create(e.prototype),t.EQ.prototype.process=function(t){t.connect(this.input)},t.EQ.prototype.set=function(){if(arguments.length===2*this.bands.length)for(var t=0;t0;)delete this.bands.pop().dispose();delete this.bands}},t.EQ}(Y,W);var H;H=function(){var e=Y;return t.Panner3D=function(){e.call(this),this.panner=this.ac.createPanner(),this.panner.panningModel="HRTF",this.panner.distanceModel="linear",this.panner.connect(this.output),this.input.connect(this.panner)},t.Panner3D.prototype=Object.create(e.prototype),t.Panner3D.prototype.process=function(t){t.connect(this.input)},t.Panner3D.prototype.set=function(t,e,i,n){return this.positionX(t,n),this.positionY(e,n),this.positionZ(i,n),[this.panner.positionX.value,this.panner.positionY.value,this.panner.positionZ.value]},t.Panner3D.prototype.positionX=function(t,e){var i=e||0;return"number"==typeof t?(this.panner.positionX.value=t,this.panner.positionX.cancelScheduledValues(this.ac.currentTime+.01+i),this.panner.positionX.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.panner.positionX),this.panner.positionX.value},t.Panner3D.prototype.positionY=function(t,e){var i=e||0;return"number"==typeof t?(this.panner.positionY.value=t,this.panner.positionY.cancelScheduledValues(this.ac.currentTime+.01+i),this.panner.positionY.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.panner.positionY),this.panner.positionY.value},t.Panner3D.prototype.positionZ=function(t,e){var i=e||0;return"number"==typeof t?(this.panner.positionZ.value=t,this.panner.positionZ.cancelScheduledValues(this.ac.currentTime+.01+i),this.panner.positionZ.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.panner.positionZ),this.panner.positionZ.value},t.Panner3D.prototype.orient=function(t,e,i,n){return this.orientX(t,n),this.orientY(e,n),this.orientZ(i,n),[this.panner.orientationX.value,this.panner.orientationY.value,this.panner.orientationZ.value]},t.Panner3D.prototype.orientX=function(t,e){var i=e||0;return"number"==typeof t?(this.panner.orientationX.value=t,this.panner.orientationX.cancelScheduledValues(this.ac.currentTime+.01+i),this.panner.orientationX.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.panner.orientationX),this.panner.orientationX.value},t.Panner3D.prototype.orientY=function(t,e){var i=e||0;return"number"==typeof t?(this.panner.orientationY.value=t,this.panner.orientationY.cancelScheduledValues(this.ac.currentTime+.01+i),this.panner.orientationY.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.panner.orientationY),this.panner.orientationY.value},t.Panner3D.prototype.orientZ=function(t,e){var i=e||0;return"number"==typeof t?(this.panner.orientationZ.value=t,this.panner.orientationZ.cancelScheduledValues(this.ac.currentTime+.01+i),this.panner.orientationZ.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.panner.orientationZ),this.panner.orientationZ.value},t.Panner3D.prototype.setFalloff=function(t,e){this.maxDist(t),this.rolloff(e)},t.Panner3D.prototype.maxDist=function(t){return"number"==typeof t&&(this.panner.maxDistance=t),this.panner.maxDistance},t.Panner3D.prototype.rolloff=function(t){return"number"==typeof t&&(this.panner.rolloffFactor=t),this.panner.rolloffFactor},t.Panner3D.dispose=function(){e.prototype.dispose.apply(this),this.panner&&(this.panner.disconnect(),delete this.panner)},t.Panner3D}(a,Y);var $;$=function(){var e=a;return t.Listener3D=function(t){this.ac=e.audiocontext,this.listener=this.ac.listener},t.Listener3D.prototype.process=function(t){t.connect(this.input)},t.Listener3D.prototype.position=function(t,e,i,n){return this.positionX(t,n),this.positionY(e,n),this.positionZ(i,n),[this.listener.positionX.value,this.listener.positionY.value,this.listener.positionZ.value]},t.Listener3D.prototype.positionX=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.positionX.value=t,this.listener.positionX.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.positionX.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.positionX),this.listener.positionX.value},t.Listener3D.prototype.positionY=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.positionY.value=t,this.listener.positionY.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.positionY.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.positionY),this.listener.positionY.value},t.Listener3D.prototype.positionZ=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.positionZ.value=t,this.listener.positionZ.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.positionZ.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.positionZ),this.listener.positionZ.value},t.Listener3D.prototype.orient=function(t,e,i,n,o,r,s){return 3===arguments.length||4===arguments.length?(s=arguments[3],this.orientForward(t,e,i,s)):(6===arguments.length||7===arguments)&&(this.orientForward(t,e,i),this.orientUp(n,o,r,s)),[this.listener.forwardX.value,this.listener.forwardY.value,this.listener.forwardZ.value,this.listener.upX.value,this.listener.upY.value,this.listener.upZ.value]},t.Listener3D.prototype.orientForward=function(t,e,i,n){return this.forwardX(t,n),this.forwardY(e,n),this.forwardZ(i,n),[this.listener.forwardX,this.listener.forwardY,this.listener.forwardZ]},t.Listener3D.prototype.orientUp=function(t,e,i,n){return this.upX(t,n),this.upY(e,n),this.upZ(i,n),[this.listener.upX,this.listener.upY,this.listener.upZ]},t.Listener3D.prototype.forwardX=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.forwardX.value=t,this.listener.forwardX.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.forwardX.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.forwardX),this.listener.forwardX.value},t.Listener3D.prototype.forwardY=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.forwardY.value=t,this.listener.forwardY.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.forwardY.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.forwardY),this.listener.forwardY.value},t.Listener3D.prototype.forwardZ=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.forwardZ.value=t,this.listener.forwardZ.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.forwardZ.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.forwardZ),this.listener.forwardZ.value},t.Listener3D.prototype.upX=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.upX.value=t,this.listener.upX.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.upX.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.upX),this.listener.upX.value},t.Listener3D.prototype.upY=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.upY.value=t,this.listener.upY.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.upY.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.upY),this.listener.upY.value},t.Listener3D.prototype.upZ=function(t,e){var i=e||0;return"number"==typeof t?(this.listener.upZ.value=t,this.listener.upZ.cancelScheduledValues(this.ac.currentTime+.01+i),this.listener.upZ.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):t&&t.connect(this.listener.upZ),this.listener.upZ.value},t.Listener3D}(a,Y);var J;J=function(){var e=z,i=Y;t.Delay=function(){i.call(this),this._split=this.ac.createChannelSplitter(2),this._merge=this.ac.createChannelMerger(2),this._leftGain=this.ac.createGain(),this._rightGain=this.ac.createGain(),this.leftDelay=this.ac.createDelay(),this.rightDelay=this.ac.createDelay(),this._leftFilter=new e,this._rightFilter=new e,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(.3,this.ac.currentTime),this._rightFilter.biquad.Q.setValueAtTime(.3,this.ac.currentTime),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.wet),this._leftFilter.biquad.gain.setValueAtTime(1,this.ac.currentTime),this._rightFilter.biquad.gain.setValueAtTime(1,this.ac.currentTime),this.setType(0),this._maxDelay=this.leftDelay.delayTime.maxValue,this.feedback(.5)},t.Delay.prototype=Object.create(i.prototype),t.Delay.prototype.process=function(t,e,i,n){var o=i||0,r=e||0;if(o>=1)throw new Error("Feedback value will force a positive feedback loop.");if(r>=this._maxDelay)throw new Error("Delay Time exceeds maximum delay time of "+this._maxDelay+" second.");t.connect(this.input),this.leftDelay.delayTime.setValueAtTime(r,this.ac.currentTime),this.rightDelay.delayTime.setValueAtTime(r,this.ac.currentTime),this._leftGain.gain.value=o,this._rightGain.gain.value=o,n&&(this._leftFilter.freq(n),this._rightFilter.freq(n))},t.Delay.prototype.delayTime=function(t){"number"!=typeof t?(t.connect(this.leftDelay.delayTime),t.connect(this.rightDelay.delayTime)):(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))},t.Delay.prototype.feedback=function(t){if(t&&"number"!=typeof t)t.connect(this._leftGain.gain),t.connect(this._rightGain.gain);else{if(t>=1)throw new Error("Feedback value will force a positive feedback loop.");"number"==typeof t&&(this._leftGain.gain.value=t,this._rightGain.gain.value=t)}return this._leftGain.gain.value},t.Delay.prototype.filter=function(t,e){this._leftFilter.set(t,e),this._rightFilter.set(t,e)},t.Delay.prototype.setType=function(t){switch(1===t&&(t="pingPong"),this._split.disconnect(),this._leftFilter.disconnect(),this._rightFilter.disconnect(),this._split.connect(this.leftDelay,0),this._split.connect(this.rightDelay,1),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._rightFilter.output.connect(this._merge,0,1),this._leftFilter.output.connect(this.leftDelay),this._rightFilter.output.connect(this.rightDelay)}},t.Delay.prototype.dispose=function(){i.prototype.dispose.apply(this),this._split.disconnect(),this._leftFilter.dispose(),this._rightFilter.dispose(),this._merge.disconnect(),this._leftGain.disconnect(),this._rightGain.disconnect(),this.leftDelay.disconnect(),this.rightDelay.disconnect(),this._split=void 0,this._leftFilter=void 0,this._rightFilter=void 0,this._merge=void 0,this._leftGain=void 0,this._rightGain=void 0,this.leftDelay=void 0,this.rightDelay=void 0}}(z,Y);var K;K=function(){var e=c,i=Y;t.Reverb=function(){i.call(this),this._initConvolverNode(),this.input.gain.value=.5,this._seconds=3,this._decay=2,this._reverse=!1,this._buildImpulse()},t.Reverb.prototype=Object.create(i.prototype),t.Reverb.prototype._initConvolverNode=function(){this.convolverNode=this.ac.createConvolver(),this.input.connect(this.convolverNode),this.convolverNode.connect(this.wet)},t.Reverb.prototype._teardownConvolverNode=function(){this.convolverNode&&(this.convolverNode.disconnect(),delete this.convolverNode)},t.Reverb.prototype._setBuffer=function(t){this._teardownConvolverNode(),this._initConvolverNode(),this.convolverNode.buffer=t},t.Reverb.prototype.process=function(t,e,i,n){t.connect(this.input);var o=!1;e&&(this._seconds=e,o=!0),i&&(this._decay=i),n&&(this._reverse=n),o&&this._buildImpulse()},t.Reverb.prototype.set=function(t,e,i){var n=!1;t&&(this._seconds=t,n=!0),e&&(this._decay=e),i&&(this._reverse=i),n&&this._buildImpulse()},t.Reverb.prototype._buildImpulse=function(){var t,e,i=this.ac.sampleRate,n=i*this._seconds,o=this._decay,r=this.ac.createBuffer(2,n,i),s=r.getChannelData(0),a=r.getChannelData(1);for(e=0;n>e;e++)t=this._reverse?n-e:e,s[e]=(2*Math.random()-1)*Math.pow(1-t/n,o),a[e]=(2*Math.random()-1)*Math.pow(1-t/n,o);this._setBuffer(r)},t.Reverb.prototype.dispose=function(){i.prototype.dispose.apply(this),this._teardownConvolverNode()},t.Convolver=function(e,i,n){t.Reverb.call(this),this._initConvolverNode(),this.input.gain.value=.5,e?(this.impulses=[],this._loadBuffer(e,i,n)):(this._seconds=3,this._decay=2,this._reverse=!1,this._buildImpulse())},t.Convolver.prototype=Object.create(t.Reverb.prototype),t.prototype.registerPreloadMethod("createConvolver",t.prototype),t.prototype.createConvolver=function(e,i,n){window.location.origin.indexOf("file://")>-1&&"undefined"===window.cordova&&alert("This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS");var o=this,r=new t.Convolver(e,function(t){"function"==typeof i&&i(t),"function"==typeof o._decrementPreload&&o._decrementPreload()},n);return r.impulses=[],r},t.Convolver.prototype._loadBuffer=function(i,n,o){var i=t.prototype._checkFileFormats(i),r=this,s=(new Error).stack,a=t.prototype.getAudioContext(),u=new XMLHttpRequest;u.open("GET",i,!0),u.responseType="arraybuffer",u.onload=function(){if(200===u.status)a.decodeAudioData(u.response,function(t){var e={},o=i.split("/");e.name=o[o.length-1],e.audioBuffer=t,r.impulses.push(e),r._setBuffer(e.audioBuffer),n&&n(e)},function(){var t=new e("decodeAudioData",s,r.url),i="AudioContext error at decodeAudioData for "+r.url;o?(t.msg=i,o(t)):console.error(i+"\n The error stack trace includes: \n"+t.stack)});else{var t=new e("loadConvolver",s,r.url),c="Unable to load "+r.url+". The request status was: "+u.status+" ("+u.statusText+")";o?(t.message=c,o(t)):console.error(c+"\n The error stack trace includes: \n"+t.stack)}},u.onerror=function(){var t=new e("loadConvolver",s,r.url),i="There was no response from the server at "+r.url+". Check the url and internet connectivity.";o?(t.message=i,o(t)):console.error(i+"\n The error stack trace includes: \n"+t.stack)},u.send()},t.Convolver.prototype.set=null,t.Convolver.prototype.process=function(t){t.connect(this.input)},t.Convolver.prototype.impulses=[],t.Convolver.prototype.addImpulse=function(t,e,i){window.location.origin.indexOf("file://")>-1&&"undefined"===window.cordova&&alert("This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS"),this._loadBuffer(t,e,i)},t.Convolver.prototype.resetImpulse=function(t,e,i){window.location.origin.indexOf("file://")>-1&&"undefined"===window.cordova&&alert("This sketch may require a server to load external files. Please see http://bit.ly/1qcInwS"),this.impulses=[],this._loadBuffer(t,e,i)},t.Convolver.prototype.toggleImpulse=function(t){if("number"==typeof t&&tthis._nextTick&&this._state;){var s=this._state.getValueAtTime(this._nextTick);if(s!==this._lastState){this._lastState=s;var a=this._state.get(this._nextTick);s===t.State.Started?(this._nextTick=a.time,this.isUndef(a.offset)||(this.ticks=a.offset),this.emit("start",a.time,this.ticks)):s===t.State.Stopped?(this.ticks=0,this.emit("stop",a.time)):s===t.State.Paused&&this.emit("pause",a.time)}var u=this._nextTick;this.frequency&&(this._nextTick+=1/this.frequency.getValueAtTime(this._nextTick),s===t.State.Started&&(this.callback(u),this.ticks++))}},t.Clock.prototype.getStateAtTime=function(t){return t=this.toSeconds(t),this._state.getValueAtTime(t)},t.Clock.prototype.dispose=function(){t.Emitter.prototype.dispose.call(this),this.context.off("tick",this._boundLoop),this._writable("frequency"),this.frequency.dispose(),this.frequency=null,this._boundLoop=null,this._nextTick=1/0,this.callback=null,this._state.dispose(),this._state=null},t.Clock}(n,q,tt,o);var it;it=function(){var e=a,i=et;t.Metro=function(){this.clock=new i({callback:this.ontick.bind(this)}),this.syncedParts=[],this.bpm=120,this._init(),this.prevTick=0,this.tatumTime=0,this.tickCallback=function(){}},t.Metro.prototype.ontick=function(t){var i=t-this.prevTick,n=t-e.audiocontext.currentTime;if(!(i-this.tatumTime<=-.02)){this.prevTick=t;var o=this;this.syncedParts.forEach(function(t){t.isPlaying&&(t.incrementStep(n),t.phrases.forEach(function(t){var e=t.sequence,i=o.metroTicks%e.length;0!==e[i]&&(o.metroTicks=t.parts.length?(t.scoreStep=0,t.onended()):(t.scoreStep=0,t.parts[t.currentPart-1].stop(),t.parts[t.currentPart].start())}var i=a,n=120;t.prototype.setBPM=function(t,e){n=t;for(var o in i.parts)i.parts[o]&&i.parts[o].setBPM(t,e)},t.Phrase=function(t,e,i){this.phraseStep=0,this.name=t,this.callback=e,this.sequence=i},t.Part=function(e,o){this.length=e||0,this.partStep=0, +this.phrases=[],this.isPlaying=!1,this.noLoop(),this.tatums=o||.0625,this.metro=new t.Metro,this.metro._init(),this.metro.beatLength(this.tatums),this.metro.setBPM(n),i.parts.push(this),this.callback=function(){}},t.Part.prototype.setBPM=function(t,e){this.metro.setBPM(t,e)},t.Part.prototype.getBPM=function(){return this.metro.getBPM()},t.Part.prototype.start=function(t){if(!this.isPlaying){this.isPlaying=!0,this.metro.resetSync(this);var e=t||0;this.metro.start(e)}},t.Part.prototype.loop=function(t){this.looping=!0,this.onended=function(){this.partStep=0};var e=t||0;this.start(e)},t.Part.prototype.noLoop=function(){this.looping=!1,this.onended=function(){this.stop()}},t.Part.prototype.stop=function(t){this.partStep=0,this.pause(t)},t.Part.prototype.pause=function(t){this.isPlaying=!1;var e=t||0;this.metro.stop(e)},t.Part.prototype.addPhrase=function(e,i,n){var o;if(3===arguments.length)o=new t.Phrase(e,i,n);else{if(!(arguments[0]instanceof t.Phrase))throw"invalid input. addPhrase accepts name, callback, array or a p5.Phrase";o=arguments[0]}this.phrases.push(o),o.sequence.length>this.length&&(this.length=o.sequence.length)},t.Part.prototype.removePhrase=function(t){for(var e in this.phrases)this.phrases[e].name===t&&this.phrases.splice(e,1)},t.Part.prototype.getPhrase=function(t){for(var e in this.phrases)if(this.phrases[e].name===t)return this.phrases[e]},t.Part.prototype.replaceSequence=function(t,e){for(var i in this.phrases)this.phrases[i].name===t&&(this.phrases[i].sequence=e)},t.Part.prototype.incrementStep=function(t){this.partStep0&&o.iterations<=o.maxIterations&&o.callback(i)},frequency:this._calcFreq()})},t.SoundLoop.prototype.start=function(t){var i=t||0,n=e.audiocontext.currentTime;this.isPlaying||(this.clock.start(n+i),this.isPlaying=!0)},t.SoundLoop.prototype.stop=function(t){var i=t||0,n=e.audiocontext.currentTime;this.isPlaying&&(this.clock.stop(n+i),this.isPlaying=!1)},t.SoundLoop.prototype.pause=function(t){var i=t||0,n=e.audiocontext.currentTime;this.isPlaying&&(this.clock.pause(n+i),this.isPlaying=!1)},t.SoundLoop.prototype.syncedStart=function(t,i){var n=i||0,o=e.audiocontext.currentTime;if(t.isPlaying){if(t.isPlaying){var r=t.clock._nextTick-e.audiocontext.currentTime;this.clock.start(o+r),this.isPlaying=!0}}else t.clock.start(o+n),t.isPlaying=!0,this.clock.start(o+n),this.isPlaying=!0},t.SoundLoop.prototype._update=function(){this.clock.frequency.value=this._calcFreq()},t.SoundLoop.prototype._calcFreq=function(){return"number"==typeof this._interval?(this.musicalTimeMode=!1,1/this._interval):"string"==typeof this._interval?(this.musicalTimeMode=!0,this._bpm/60/this._convertNotation(this._interval)*(this._timeSignature/4)):void 0},t.SoundLoop.prototype._convertNotation=function(t){var e=t.slice(-1);switch(t=Number(t.slice(0,-1)),e){case"m":return this._measure(t);case"n":return this._note(t);default:console.warn("Specified interval is not formatted correctly. See Tone.js timing reference for more info: https://github.com/Tonejs/Tone.js/wiki/Time")}},t.SoundLoop.prototype._measure=function(t){return t*this._timeSignature},t.SoundLoop.prototype._note=function(t){return this._timeSignature/t},Object.defineProperty(t.SoundLoop.prototype,"bpm",{get:function(){return this._bpm},set:function(t){this.musicalTimeMode||console.warn('Changing the BPM in "seconds" mode has no effect. BPM is only relevant in musicalTimeMode when the interval is specified as a string ("2n", "4n", "1m"...etc)'),this._bpm=t,this._update()}}),Object.defineProperty(t.SoundLoop.prototype,"timeSignature",{get:function(){return this._timeSignature},set:function(t){this.musicalTimeMode||console.warn('Changing the timeSignature in "seconds" mode has no effect. BPM is only relevant in musicalTimeMode when the interval is specified as a string ("2n", "4n", "1m"...etc)'),this._timeSignature=t,this._update()}}),Object.defineProperty(t.SoundLoop.prototype,"interval",{get:function(){return this._interval},set:function(t){this.musicalTimeMode="Number"==typeof t?!1:!0,this._interval=t,this._update()}}),Object.defineProperty(t.SoundLoop.prototype,"iterations",{get:function(){return this.clock.ticks}}),t.SoundLoop}(a,et);var rt;rt=function(){"use strict";var e=Y;return t.Compressor=function(){e.call(this),this.compressor=this.ac.createDynamicsCompressor(),this.input.connect(this.compressor),this.compressor.connect(this.wet)},t.Compressor.prototype=Object.create(e.prototype),t.Compressor.prototype.process=function(t,e,i,n,o,r){t.connect(this.input),this.set(e,i,n,o,r)},t.Compressor.prototype.set=function(t,e,i,n,o){"undefined"!=typeof t&&this.attack(t),"undefined"!=typeof e&&this.knee(e),"undefined"!=typeof i&&this.ratio(i),"undefined"!=typeof n&&this.threshold(n),"undefined"!=typeof o&&this.release(o)},t.Compressor.prototype.attack=function(t,e){var i=e||0;return"number"==typeof t?(this.compressor.attack.value=t,this.compressor.attack.cancelScheduledValues(this.ac.currentTime+.01+i),this.compressor.attack.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):"undefined"!=typeof t&&t.connect(this.compressor.attack),this.compressor.attack.value},t.Compressor.prototype.knee=function(t,e){var i=e||0;return"number"==typeof t?(this.compressor.knee.value=t,this.compressor.knee.cancelScheduledValues(this.ac.currentTime+.01+i),this.compressor.knee.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):"undefined"!=typeof t&&t.connect(this.compressor.knee),this.compressor.knee.value},t.Compressor.prototype.ratio=function(t,e){var i=e||0;return"number"==typeof t?(this.compressor.ratio.value=t,this.compressor.ratio.cancelScheduledValues(this.ac.currentTime+.01+i),this.compressor.ratio.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):"undefined"!=typeof t&&t.connect(this.compressor.ratio),this.compressor.ratio.value},t.Compressor.prototype.threshold=function(t,e){var i=e||0;return"number"==typeof t?(this.compressor.threshold.value=t,this.compressor.threshold.cancelScheduledValues(this.ac.currentTime+.01+i),this.compressor.threshold.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):"undefined"!=typeof t&&t.connect(this.compressor.threshold),this.compressor.threshold.value},t.Compressor.prototype.release=function(t,e){var i=e||0;return"number"==typeof t?(this.compressor.release.value=t,this.compressor.release.cancelScheduledValues(this.ac.currentTime+.01+i),this.compressor.release.linearRampToValueAtTime(t,this.ac.currentTime+.02+i)):"undefined"!=typeof number&&t.connect(this.compressor.release),this.compressor.release.value},t.Compressor.prototype.reduction=function(){return this.compressor.reduction.value},t.Compressor.prototype.dispose=function(){e.prototype.dispose.apply(this),this.compressor&&(this.compressor.disconnect(),delete this.compressor)},t.Compressor}(a,Y,c);var st;st=function(){var e=a,i=u.convertToWav,n=e.audiocontext;t.SoundRecorder=function(){this.input=n.createGain(),this.output=n.createGain(),this.recording=!1,this.bufferSize=1024,this._channels=2,this._clear(),this._jsNode=n.createScriptProcessor(this.bufferSize,this._channels,2),this._jsNode.onaudioprocess=this._audioprocess.bind(this),this._callback=function(){},this._jsNode.connect(t.soundOut._silentNode),this.setInput(),e.soundArray.push(this)},t.SoundRecorder.prototype.setInput=function(e){this.input.disconnect(),this.input=null,this.input=n.createGain(),this.input.connect(this._jsNode),this.input.connect(this.output),e?e.connect(this.input):t.soundOut.output.connect(this.input)},t.SoundRecorder.prototype.record=function(t,e,i){this.recording=!0,e&&(this.sampleLimit=Math.round(e*n.sampleRate)),t&&i?this._callback=function(){this.buffer=this._getBuffer(),t.setBuffer(this.buffer),i()}:t&&(this._callback=function(){this.buffer=this._getBuffer(),t.setBuffer(this.buffer)})},t.SoundRecorder.prototype.stop=function(){this.recording=!1,this._callback(),this._clear()},t.SoundRecorder.prototype._clear=function(){this._leftBuffers=[],this._rightBuffers=[],this.recordedSamples=0,this.sampleLimit=null},t.SoundRecorder.prototype._audioprocess=function(t){if(this.recording!==!1&&this.recording===!0)if(this.sampleLimit&&this.recordedSamples>=this.sampleLimit)this.stop();else{var e=t.inputBuffer.getChannelData(0),i=t.inputBuffer.getChannelData(1);this._leftBuffers.push(new Float32Array(e)),this._rightBuffers.push(new Float32Array(i)),this.recordedSamples+=this.bufferSize}},t.SoundRecorder.prototype._getBuffer=function(){var t=[];return t.push(this._mergeBuffers(this._leftBuffers)),t.push(this._mergeBuffers(this._rightBuffers)),t},t.SoundRecorder.prototype._mergeBuffers=function(t){for(var e=new Float32Array(this.recordedSamples),i=0,n=t.length,o=0;n>o;o++){var r=t[o];e.set(r,i),i+=r.length}return e},t.SoundRecorder.prototype.dispose=function(){this._clear();var t=e.soundArray.indexOf(this);e.soundArray.splice(t,1),this._callback=function(){},this.input&&this.input.disconnect(),this.input=null,this._jsNode=null},t.prototype.saveSound=function(e,n){const o=i(e.buffer);t.prototype.writeFile([o],n,"wav")}}(a,u);var at;at=function(){t.PeakDetect=function(t,e,i,n){this.framesPerPeak=n||20,this.framesSinceLastPeak=0,this.decayRate=.95,this.threshold=i||.35,this.cutoff=0,this.cutoffMult=1.5,this.energy=0,this.penergy=0,this.currentValue=0,this.isDetected=!1,this.f1=t||40,this.f2=e||2e4,this._onPeak=function(){}},t.PeakDetect.prototype.update=function(t){var e=this.energy=t.getEnergy(this.f1,this.f2)/255;e>this.cutoff&&e>this.threshold&&e-this.penergy>0?(this._onPeak(),this.isDetected=!0,this.cutoff=e*this.cutoffMult,this.framesSinceLastPeak=0):(this.isDetected=!1,this.framesSinceLastPeak<=this.framesPerPeak?this.framesSinceLastPeak++:(this.cutoff*=this.decayRate,this.cutoff=Math.max(this.cutoff,this.threshold))),this.currentValue=e,this.penergy=e},t.PeakDetect.prototype.onPeak=function(t,e){var i=this;i._onPeak=function(){t(i.energy,e)}}}();var ut;ut=function(){var e=a;t.Gain=function(){this.ac=e.audiocontext,this.input=this.ac.createGain(),this.output=this.ac.createGain(),this.input.gain.value=.5,this.input.connect(this.output),e.soundArray.push(this)},t.Gain.prototype.setInput=function(t){t.connect(this.input)},t.Gain.prototype.connect=function(e){var i=e||t.soundOut.input;this.output.connect(i.input?i.input:i)},t.Gain.prototype.disconnect=function(){this.output&&this.output.disconnect()},t.Gain.prototype.amp=function(t,i,n){var i=i||0,n=n||0,o=e.audiocontext.currentTime,r=this.output.gain.value;this.output.gain.cancelScheduledValues(o),this.output.gain.linearRampToValueAtTime(r,o+n),this.output.gain.linearRampToValueAtTime(t,o+n+i)},t.Gain.prototype.dispose=function(){var t=e.soundArray.indexOf(this);e.soundArray.splice(t,1),this.output&&(this.output.disconnect(),delete this.output),this.input&&(this.input.disconnect(),delete this.input)}}(a);var ct;ct=function(){var e=a;return t.AudioVoice=function(){this.ac=e.audiocontext,this.output=this.ac.createGain(),this.connect(),e.soundArray.push(this)},t.AudioVoice.prototype.play=function(t,e,i,n){},t.AudioVoice.prototype.triggerAttack=function(t,e,i){},t.AudioVoice.prototype.triggerRelease=function(t){},t.AudioVoice.prototype.amp=function(t,e){},t.AudioVoice.prototype.connect=function(t){var i=t||e.input;this.output.connect(i.input?i.input:i)},t.AudioVoice.prototype.disconnect=function(){this.output.disconnect()},t.AudioVoice.prototype.dispose=function(){this.output&&(this.output.disconnect(),delete this.output)},t.AudioVoice}(a);var pt;pt=function(){var e=a,i=ct,n=u.noteToFreq,o=.15;t.MonoSynth=function(){i.call(this),this.oscillator=new t.Oscillator,this.env=new t.Envelope,this.env.setRange(1,0),this.env.setExp(!0),this.setADSR(.02,.25,.05,.35),this.oscillator.disconnect(),this.oscillator.connect(this.output),this.env.disconnect(),this.env.setInput(this.output.gain),this.oscillator.output.gain.value=1,this.oscillator.start(),this.connect(),e.soundArray.push(this)},t.MonoSynth.prototype=Object.create(t.AudioVoice.prototype),t.MonoSynth.prototype.play=function(t,e,i,n){this.triggerAttack(t,e,~~i),this.triggerRelease(~~i+(n||o))},t.MonoSynth.prototype.triggerAttack=function(t,e,i){var i=~~i,o=n(t),r=e||.1;this.oscillator.freq(o,0,i),this.env.ramp(this.output.gain,i,r)},t.MonoSynth.prototype.triggerRelease=function(t){var t=t||0;this.env.ramp(this.output.gain,t,0)},t.MonoSynth.prototype.setADSR=function(t,e,i,n){this.env.setADSR(t,e,i,n)},Object.defineProperties(t.MonoSynth.prototype,{attack:{get:function(){return this.env.aTime},set:function(t){this.env.setADSR(t,this.env.dTime,this.env.sPercent,this.env.rTime)}},decay:{get:function(){return this.env.dTime},set:function(t){this.env.setADSR(this.env.aTime,t,this.env.sPercent,this.env.rTime)}},sustain:{get:function(){return this.env.sPercent},set:function(t){this.env.setADSR(this.env.aTime,this.env.dTime,t,this.env.rTime)}},release:{get:function(){return this.env.rTime},set:function(t){this.env.setADSR(this.env.aTime,this.env.dTime,this.env.sPercent,t)}}}),t.MonoSynth.prototype.amp=function(t,e){var i=e||0;return"undefined"!=typeof t&&this.oscillator.amp(t,i),this.oscillator.amp().value},t.MonoSynth.prototype.connect=function(t){var i=t||e.input;this.output.connect(i.input?i.input:i)},t.MonoSynth.prototype.disconnect=function(){this.output&&this.output.disconnect()},t.MonoSynth.prototype.dispose=function(){i.prototype.dispose.apply(this),this.env&&this.env.dispose(),this.oscillator&&this.oscillator.dispose()}}(a,ct,u);var ht;ht=function(){var e=a,i=q,n=u.noteToFreq;t.PolySynth=function(n,o){this.audiovoices=[],this.notes={},this._newest=0,this._oldest=0,this.maxVoices=o||8,this.AudioVoice=void 0===n?t.MonoSynth:n,this._voicesInUse=new i(0),this.output=e.audiocontext.createGain(),this.connect(),this._allocateVoices(),e.soundArray.push(this)},t.PolySynth.prototype._allocateVoices=function(){for(var t=0;tf?f:p}this.audiovoices[a].triggerAttack(c,p,s)},t.PolySynth.prototype._updateAfter=function(t,e){if(null!==this._voicesInUse._searchAfter(t)){this._voicesInUse._searchAfter(t).value+=e;var i=this._voicesInUse._searchAfter(t).time;this._updateAfter(i,e)}},t.PolySynth.prototype.noteRelease=function(t,i){var o=e.audiocontext.currentTime,r=i||0,s=o+r;if(t){var a=n(t);if(this.notes[a]&&null!==this.notes[a].getValueAtTime(s)){var u=Math.max(~~this._voicesInUse.getValueAtTime(s).value,1);this._voicesInUse.setValueAtTime(u-1,s),u>0&&this._updateAfter(s,-1),this.audiovoices[this.notes[a].getValueAtTime(s)].triggerRelease(r),this.notes[a].dispose(),delete this.notes[a],this._newest=0===this._newest?0:(this._newest-1)%(this.maxVoices-1)}else console.warn("Cannot release a note that is not already playing")}else{this.audiovoices.forEach(function(t){t.triggerRelease(r)}),this._voicesInUse.setValueAtTime(0,s);for(var c in this.notes)this.notes[c].dispose(),delete this.notes[c]}},t.PolySynth.prototype.connect=function(t){var i=t||e.input;this.output.connect(i.input?i.input:i)},t.PolySynth.prototype.disconnect=function(){this.output&&this.output.disconnect()},t.PolySynth.prototype.dispose=function(){this.audiovoices.forEach(function(t){t.dispose()}),this.output&&(this.output.disconnect(),delete this.output)}}(a,q,u);var lt;lt=function(){function e(t){for(var e,i="number"==typeof t?t:50,n=44100,o=new Float32Array(n),r=Math.PI/180,s=0;n>s;++s)e=2*s/n-1,o[s]=(3+i)*e*20*r/(Math.PI+i*Math.abs(e));return o}var i=Y;t.Distortion=function(n,o){if(i.call(this),"undefined"==typeof n&&(n=.25),"number"!=typeof n)throw new Error("amount must be a number");if("undefined"==typeof o&&(o="2x"),"string"!=typeof o)throw new Error("oversample must be a String");var r=t.prototype.map(n,0,1,0,2e3);this.waveShaperNode=this.ac.createWaveShaper(),this.amount=r,this.waveShaperNode.curve=e(r),this.waveShaperNode.oversample=o,this.input.connect(this.waveShaperNode),this.waveShaperNode.connect(this.wet)},t.Distortion.prototype=Object.create(i.prototype),t.Distortion.prototype.process=function(t,e,i){t.connect(this.input),this.set(e,i)},t.Distortion.prototype.set=function(i,n){if(i){var o=t.prototype.map(i,0,1,0,2e3);this.amount=o,this.waveShaperNode.curve=e(o)}n&&(this.waveShaperNode.oversample=n)},t.Distortion.prototype.getAmount=function(){return this.amount},t.Distortion.prototype.getOversample=function(){return this.waveShaperNode.oversample},t.Distortion.prototype.dispose=function(){i.prototype.dispose.apply(this),this.waveShaperNode&&(this.waveShaperNode.disconnect(),this.waveShaperNode=null)}}(Y);var ft;ft=function(){var t=a;return t}(e,s,a,u,c,p,h,l,f,k,O,M,E,V,R,z,Q,H,$,J,K,it,nt,ot,rt,st,at,ut,pt,ht,lt,ct,pt,ht)}); \ No newline at end of file diff --git a/p5/empty-example/index.html b/p5/empty-example/index.html new file mode 100644 index 0000000..6242686 --- /dev/null +++ b/p5/empty-example/index.html @@ -0,0 +1,15 @@ + + + + + + p5.js example + + + + + + + + + diff --git a/p5/empty-example/sketch.js b/p5/empty-example/sketch.js new file mode 100644 index 0000000..de6c862 --- /dev/null +++ b/p5/empty-example/sketch.js @@ -0,0 +1,7 @@ +function setup() { + // put setup code here +} + +function draw() { + // put drawing code here +} \ No newline at end of file diff --git a/p5/p5.js b/p5/p5.js new file mode 100644 index 0000000..6e9769c --- /dev/null +++ b/p5/p5.js @@ -0,0 +1,83507 @@ +/*! p5.js v0.8.0 April 08, 2019 */ +(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}g.p5 = f()}})(function(){var define,module,exports;return (function(){function r(e,n,t){function o(i,f){if(!n[i]){if(!e[i]){var c="function"==typeof require&&require;if(!f&&c)return c(i,!0);if(u)return u(i,!0);var a=new Error("Cannot find module '"+i+"'");throw a.code="MODULE_NOT_FOUND",a}var p=n[i]={exports:{}};e[i][0].call(p.exports,function(r){var n=e[i][1][r];return o(n||r)},p,p.exports,r,e,n,t)}return n[i].exports}for(var u="function"==typeof require&&require,i=0;iEach color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.

    \n

    Internally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.

    \n

    We also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.

    \n" + }, + "Setting": { + "name": "Setting", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Color", + "namespace": "", + "file": "src/color/setting.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Shape": { + "name": "Shape", + "submodules": { + "2D Primitives": 1, + "Curves": 1, + "Vertex": 1, + "3D Primitives": 1, + "3D Models": 1 + }, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "namespaces": {} + }, + "2D Primitives": { + "name": "2D Primitives", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Shape", + "namespace": "", + "file": "src/core/shape/2d_primitives.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Attributes": { + "name": "Attributes", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Typography", + "namespace": "", + "file": "src/core/shape/attributes.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Curves": { + "name": "Curves", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Shape", + "namespace": "", + "file": "src/core/shape/curves.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Vertex": { + "name": "Vertex", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Shape", + "namespace": "", + "file": "src/core/shape/vertex.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Constants": { + "name": "Constants", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "module": "Constants", + "file": "src/core/constants.js", + "line": 1 + }, + "Environment": { + "name": "Environment", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "module": "Environment", + "file": "src/core/environment.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Structure": { + "name": "Structure", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "module": "IO", + "file": "src/core/main.js", + "line": 1, + "requires": [ + "constants" + ] + }, + "DOM": { + "name": "DOM", + "submodules": {}, + "elements": {}, + "classes": { + "p5.Element": 1 + }, + "fors": { + "p5.Element": 1 + }, + "namespaces": {}, + "module": "DOM", + "file": "src/core/p5.Element.js", + "line": 11, + "description": "

    Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.

    \n" + }, + "Rendering": { + "name": "Rendering", + "submodules": { + "undefined": 1 + }, + "elements": {}, + "classes": { + "p5.RendererGL": 1, + "p5.Graphics": 1, + "p5.Renderer": 1 + }, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "module": "Rendering", + "file": "src/webgl/p5.RendererGL.js", + "line": 474, + "description": "

    Thin wrapper around a renderer, to be used for creating a\ngraphics buffer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels. The fields and methods for this class are\nextensive, but mirror the normal drawing API for p5.

    \n" + }, + "Transform": { + "name": "Transform", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "module": "Transform", + "file": "src/core/transform.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Data": { + "name": "Data", + "submodules": { + "Dictionary": 1, + "Array Functions": 1, + "Conversion": 1, + "String Functions": 1 + }, + "elements": {}, + "classes": { + "p5.TypedDict": 1, + "p5.StringDict": 1, + "p5.NumberDict": 1 + }, + "fors": { + "p5.TypedDict": 1, + "p5": 1 + }, + "namespaces": {}, + "file": "src/data/p5.TypedDict.js", + "line": 422 + }, + "Dictionary": { + "name": "Dictionary", + "submodules": {}, + "elements": {}, + "classes": { + "p5.TypedDict": 1, + "p5.StringDict": 1, + "p5.NumberDict": 1 + }, + "fors": { + "p5.TypedDict": 1, + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Data", + "namespace": "", + "file": "src/data/p5.TypedDict.js", + "line": 422, + "requires": [ + "core\n\nThis module defines the p5 methods for the p5 Dictionary classes.\nThe classes StringDict and NumberDict are for storing and working\nwith key-value pairs." + ], + "description": "

    Base class for all p5.Dictionary types. Specifically\n typed Dictionary classes inherit from this class.

    \n" + }, + "Events": { + "name": "Events", + "submodules": { + "Acceleration": 1, + "Keyboard": 1, + "Mouse": 1, + "Touch": 1 + }, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "namespaces": {} + }, + "Acceleration": { + "name": "Acceleration", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Events", + "namespace": "", + "file": "src/events/acceleration.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Keyboard": { + "name": "Keyboard", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Events", + "namespace": "", + "file": "src/events/keyboard.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Mouse": { + "name": "Mouse", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Events", + "namespace": "", + "file": "src/events/mouse.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Touch": { + "name": "Touch", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Events", + "namespace": "", + "file": "src/events/touch.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Image": { + "name": "Image", + "submodules": { + "Pixels": 1 + }, + "elements": {}, + "classes": { + "p5.Image": 1 + }, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "module": "Image", + "file": "src/image/p5.Image.js", + "line": 23, + "requires": [ + "core" + ], + "description": "

    Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n

    \np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n

    \nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n

    \nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.

    \n" + }, + "Loading & Displaying": { + "name": "Loading & Displaying", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Typography", + "namespace": "", + "file": "src/image/loading_displaying.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Pixels": { + "name": "Pixels", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Image", + "namespace": "", + "file": "src/image/pixels.js", + "line": 1, + "requires": [ + "core" + ] + }, + "IO": { + "name": "IO", + "submodules": { + "Structure": 1, + "Input": 1, + "Output": 1, + "Table": 1, + "XML": 1, + "Time & Date": 1 + }, + "elements": {}, + "classes": { + "p5": 1, + "p5.PrintWriter": 1, + "p5.Table": 1, + "p5.TableRow": 1, + "p5.XML": 1 + }, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "file": "src/io/p5.XML.js", + "line": 11 + }, + "Input": { + "name": "Input", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "IO", + "namespace": "", + "file": "src/io/files.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Output": { + "name": "Output", + "submodules": {}, + "elements": {}, + "classes": { + "p5": 1, + "p5.PrintWriter": 1 + }, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "IO", + "namespace": "", + "file": "src/io/files.js", + "line": 1231, + "description": "

    This is the p5 instance constructor.

    \n

    A p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.

    \n

    A p5 sketch can run in "global" or "instance" mode:\n"global" - all properties and methods are attached to the window\n"instance" - all properties and methods are bound to this p5 object

    \n" + }, + "Table": { + "name": "Table", + "submodules": {}, + "elements": {}, + "classes": { + "p5.Table": 1, + "p5.TableRow": 1 + }, + "fors": {}, + "is_submodule": 1, + "namespaces": {}, + "module": "IO", + "namespace": "", + "file": "src/io/p5.TableRow.js", + "line": 11, + "requires": [ + "core" + ], + "description": "

    Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.

    \n" + }, + "XML": { + "name": "XML", + "submodules": {}, + "elements": {}, + "classes": { + "p5.XML": 1 + }, + "fors": {}, + "is_submodule": 1, + "namespaces": {}, + "module": "IO", + "namespace": "", + "file": "src/io/p5.XML.js", + "line": 11, + "requires": [ + "core" + ], + "description": "

    XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.

    \n" + }, + "Math": { + "name": "Math", + "submodules": { + "Calculation": 1, + "Noise": 1, + "Random": 1, + "Trigonometry": 1 + }, + "elements": {}, + "classes": { + "p5.Vector": 1 + }, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "module": "Math", + "file": "src/math/p5.Vector.js", + "line": 12, + "requires": [ + "core" + ], + "description": "

    A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n

    \nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n

    \nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.

    \n" + }, + "Calculation": { + "name": "Calculation", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Math", + "namespace": "", + "file": "src/math/calculation.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Noise": { + "name": "Noise", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Math", + "namespace": "", + "file": "src/math/noise.js", + "line": 14, + "requires": [ + "core" + ] + }, + "Random": { + "name": "Random", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Math", + "namespace": "", + "file": "src/math/random.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Trigonometry": { + "name": "Trigonometry", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Math", + "namespace": "", + "file": "src/math/trigonometry.js", + "line": 1, + "requires": [ + "core", + "constants" + ] + }, + "Typography": { + "name": "Typography", + "submodules": { + "Attributes": 1, + "Loading & Displaying": 1, + "Font": 1 + }, + "elements": {}, + "classes": { + "p5.Font": 1 + }, + "fors": { + "p5": 1 + }, + "namespaces": {}, + "file": "src/typography/p5.Font.js", + "line": 15 + }, + "Font": { + "name": "Font", + "submodules": {}, + "elements": {}, + "classes": { + "p5.Font": 1 + }, + "fors": {}, + "is_submodule": 1, + "namespaces": {}, + "module": "Typography", + "namespace": "", + "file": "src/typography/p5.Font.js", + "line": 15, + "description": "

    This module defines the p5.Font class and functions for\ndrawing text to the display canvas.

    \n", + "requires": [ + "core", + "constants" + ] + }, + "Array Functions": { + "name": "Array Functions", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Data", + "namespace": "", + "file": "src/utilities/array_functions.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Conversion": { + "name": "Conversion", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Data", + "namespace": "", + "file": "src/utilities/conversion.js", + "line": 1, + "requires": [ + "core" + ] + }, + "String Functions": { + "name": "String Functions", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Data", + "namespace": "", + "file": "src/utilities/string_functions.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Time & Date": { + "name": "Time & Date", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "IO", + "namespace": "", + "file": "src/utilities/time_date.js", + "line": 1, + "requires": [ + "core" + ] + }, + "3D Primitives": { + "name": "3D Primitives", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Shape", + "namespace": "", + "file": "src/webgl/3d_primitives.js", + "line": 1, + "requires": [ + "core", + "p5.Geometry" + ] + }, + "Lights, Camera": { + "name": "Lights, Camera", + "submodules": { + "Interaction": 1, + "Lights": 1, + "Material": 1, + "Camera": 1, + "Shaders": 1 + }, + "elements": {}, + "classes": { + "p5.Camera": 1, + "p5.Geometry": 1, + "p5.Matrix": 1, + "p5.Shader": 1, + "p5.Texture": 1, + "ImageInfos": 1, + "FontInfo": 1, + "Cubic": 1 + }, + "fors": { + "p5": 1, + "p5.Camera": 1 + }, + "namespaces": {}, + "file": "src/webgl/text.js", + "line": 259 + }, + "Interaction": { + "name": "Interaction", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Lights, Camera", + "namespace": "", + "file": "src/webgl/interaction.js", + "line": 1, + "requires": [ + "core" + ] + }, + "Lights": { + "name": "Lights", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Lights, Camera", + "namespace": "", + "file": "src/webgl/light.js", + "line": 1, + "requires": [ + "core" + ] + }, + "3D Models": { + "name": "3D Models", + "submodules": {}, + "elements": {}, + "classes": {}, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Shape", + "namespace": "", + "file": "src/webgl/loading.js", + "line": 1, + "requires": [ + "core", + "p5.Geometry" + ] + }, + "Material": { + "name": "Material", + "submodules": {}, + "elements": {}, + "classes": { + "p5.Texture": 1 + }, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Lights, Camera", + "namespace": "", + "file": "src/webgl/p5.Texture.js", + "line": 14, + "requires": [ + "core" + ], + "description": "

    This module defines the p5.Texture class

    \n" + }, + "Camera": { + "name": "Camera", + "submodules": {}, + "elements": {}, + "classes": { + "p5.Camera": 1 + }, + "fors": { + "p5": 1, + "p5.Camera": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Lights, Camera", + "namespace": "", + "file": "src/webgl/p5.Camera.js", + "line": 209, + "requires": [ + "core" + ], + "description": "

    This class describes a camera for use in p5's\n\nWebGL mode. It contains camera position, orientation, and projection\ninformation necessary for rendering a 3D scene.

    \n

    New p5.Camera objects can be made through the\ncreateCamera() function and controlled through\nthe methods described below. A camera created in this way will use a default\nposition in the scene and a default perspective projection until these\nproperties are changed through the various methods available. It is possible\nto create multiple cameras, in which case the current camera\ncan be set through the setCamera() method.

    \n

    Note:\nThe methods below operate in two coordinate systems: the 'world' coordinate\nsystem describe positions in terms of their relationship to the origin along\nthe X, Y and Z axes whereas the camera's 'local' coordinate system\ndescribes positions from the camera's point of view: left-right, up-down,\nand forward-backward. The move() method,\nfor instance, moves the camera along its own axes, whereas the\nsetPosition()\nmethod sets the camera's position in world-space.

    \n" + }, + "Shaders": { + "name": "Shaders", + "submodules": {}, + "elements": {}, + "classes": { + "p5.Shader": 1 + }, + "fors": { + "p5": 1 + }, + "is_submodule": 1, + "namespaces": {}, + "module": "Lights, Camera", + "namespace": "", + "file": "src/webgl/p5.Shader.js", + "line": 13, + "description": "

    This module defines the p5.Shader class

    \n", + "requires": [ + "core" + ] + }, + "p5.dom": { + "name": "p5.dom", + "submodules": {}, + "elements": {}, + "classes": { + "p5.MediaElement": 1, + "p5.File": 1 + }, + "fors": { + "p5": 1, + "p5.Element": 1 + }, + "namespaces": {}, + "module": "p5.dom", + "file": "lib/addons/p5.dom.js", + "line": 3331, + "description": "

    The web is much more than just canvas and p5.dom makes it easy to interact\nwith other HTML5 objects, including text, hyperlink, image, input, video,\naudio, and webcam.

    \n

    There is a set of creation methods, DOM manipulation methods, and\nan extended p5.Element that supports a range of HTML elements. See the\n\nbeyond the canvas tutorial for a full overview of how this addon works.

    \n

    Methods and properties shown in black are part of the p5.js core, items in\nblue are part of the p5.dom library. You will need to include an extra file\nin order to access the blue functions. See the\nusing a library\nsection for information on how to include this library. p5.dom comes with\np5 complete or you can download the single file\n\nhere.

    \n

    See tutorial: beyond the canvas\nfor more info on how to use this library.

    \n", + "tag": "main", + "itemtype": "main" + }, + "p5.sound": { + "name": "p5.sound", + "submodules": {}, + "elements": {}, + "classes": { + "p5.sound": 1, + "p5.SoundFile": 1, + "p5.Amplitude": 1, + "p5.FFT": 1, + "p5.Signal": 1, + "p5.Oscillator": 1, + "p5.SinOsc": 1, + "p5.TriOsc": 1, + "p5.SawOsc": 1, + "p5.SqrOsc": 1, + "p5.Envelope": 1, + "p5.Pulse": 1, + "p5.Noise": 1, + "p5.AudioIn": 1, + "p5.Effect": 1, + "p5.Filter": 1, + "p5.LowPass": 1, + "p5.HighPass": 1, + "p5.BandPass": 1, + "p5.EQ": 1, + "p5.Panner3D": 1, + "p5.Delay": 1, + "p5.Reverb": 1, + "p5.Convolver": 1, + "p5.Phrase": 1, + "p5.Part": 1, + "p5.Score": 1, + "p5.SoundLoop": 1, + "p5.Compressor": 1, + "p5.SoundRecorder": 1, + "p5.PeakDetect": 1, + "p5.Gain": 1, + "p5.AudioVoice": 1, + "p5.MonoSynth": 1, + "p5.PolySynth": 1, + "p5.Distortion": 1 + }, + "fors": { + "p5.sound": 1, + "p5": 1 + }, + "namespaces": {}, + "module": "p5.sound", + "file": "lib/addons/p5.sound.js", + "line": 12767, + "description": "

    p5.sound extends p5 with Web Audio functionality including audio input,\nplayback, analysis and synthesis.\n

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

    \np5.sound is on GitHub.\nDownload the latest version\nhere.

    \n", + "tag": "main", + "itemtype": "main" + } + }, + "classes": { + "p5": { + "name": "p5", + "shortname": "p5", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "IO", + "submodule": "Output", + "namespace": "", + "file": "src/core/main.js", + "line": 15, + "description": "

    This is the p5 instance constructor.

    \n

    A p5 instance holds all the properties and methods related to\na p5 sketch. It expects an incoming sketch closure and it can also\ntake an optional node parameter for attaching the generated p5 canvas\nto a node. The sketch closure takes the newly created p5 instance as\nits sole argument and may optionally set preload(), setup(), and/or\ndraw() properties on it for running a sketch.

    \n

    A p5 sketch can run in "global" or "instance" mode:\n"global" - all properties and methods are attached to the window\n"instance" - all properties and methods are bound to this p5 object

    \n", + "is_constructor": 1, + "params": [ + { + "name": "sketch", + "description": "

    a closure that can set optional preload(),\n setup(), and/or draw() properties on the\n given p5 instance

    \n", + "type": "Function" + }, + { + "name": "node", + "description": "

    element to attach canvas to, if a\n boolean is passed in use it as sync

    \n", + "type": "HTMLElement|Boolean", + "optional": true + }, + { + "name": "sync", + "description": "

    start synchronously (optional)

    \n", + "type": "Boolean", + "optional": true + } + ], + "return": { + "description": "a p5 instance", + "type": "P5" + } + }, + "p5.Color": { + "name": "p5.Color", + "shortname": "p5.Color", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Color", + "submodule": "Creating & Reading", + "namespace": "", + "file": "src/color/p5.Color.js", + "line": 16, + "description": "

    Each color stores the color mode and level maxes that applied at the\ntime of its construction. These are used to interpret the input arguments\n(at construction and later for that instance of color) and to format the\noutput e.g. when saturation() is requested.

    \n

    Internally we store an array representing the ideal RGBA values in floating\npoint form, normalized from 0 to 1. From this we calculate the closest\nscreen color (RGBA levels from 0 to 255) and expose this to the renderer.

    \n

    We also cache normalized, floating point components of the color in various\nrepresentations as they are calculated. This is done to prevent repeating a\nconversion that has already been performed.

    \n" + }, + "p5.Element": { + "name": "p5.Element", + "shortname": "p5.Element", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "DOM", + "submodule": "DOM", + "namespace": "", + "file": "src/core/p5.Element.js", + "line": 11, + "description": "

    Base class for all elements added to a sketch, including canvas,\ngraphics buffers, and other HTML elements. Methods in blue are\nincluded in the core functionality, methods in brown are added\nwith the p5.dom\nlibrary.\nIt is not called directly, but p5.Element\nobjects are created by calling createCanvas, createGraphics,\nor in the p5.dom library, createDiv, createImg, createInput, etc.

    \n", + "params": [ + { + "name": "elt", + "description": "

    DOM node that is wrapped

    \n", + "type": "String" + }, + { + "name": "pInst", + "description": "

    pointer to p5 instance

    \n", + "type": "P5", + "optional": true + } + ] + }, + "p5.Graphics": { + "name": "p5.Graphics", + "shortname": "p5.Graphics", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Rendering", + "submodule": "Rendering", + "namespace": "", + "file": "src/core/p5.Graphics.js", + "line": 12, + "description": "

    Thin wrapper around a renderer, to be used for creating a\ngraphics buffer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels. The fields and methods for this class are\nextensive, but mirror the normal drawing API for p5.

    \n", + "extends": "p5.Element", + "params": [ + { + "name": "w", + "description": "

    width

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height

    \n", + "type": "Number" + }, + { + "name": "renderer", + "description": "

    the renderer to use, either P2D or WEBGL

    \n", + "type": "Constant" + }, + { + "name": "pInst", + "description": "

    pointer to p5 instance

    \n", + "type": "P5", + "optional": true + } + ] + }, + "p5.Renderer": { + "name": "p5.Renderer", + "shortname": "p5.Renderer", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Rendering", + "submodule": "Rendering", + "namespace": "", + "file": "src/core/p5.Renderer.js", + "line": 12, + "description": "

    Main graphics and rendering context, as well as the base API\nimplementation for p5.js "core". To be used as the superclass for\nRenderer2D and Renderer3D classes, respecitvely.

    \n", + "is_constructor": 1, + "extends": "p5.Element", + "params": [ + { + "name": "elt", + "description": "

    DOM node that is wrapped

    \n", + "type": "String" + }, + { + "name": "pInst", + "description": "

    pointer to p5 instance

    \n", + "type": "P5", + "optional": true + }, + { + "name": "isMainCanvas", + "description": "

    whether we're using it as main canvas

    \n", + "type": "Boolean", + "optional": true + } + ] + }, + "p5.TypedDict": { + "name": "p5.TypedDict", + "shortname": "p5.TypedDict", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Data", + "submodule": "Dictionary", + "namespace": "", + "file": "src/data/p5.TypedDict.js", + "line": 84, + "description": "

    Base class for all p5.Dictionary types. Specifically\n typed Dictionary classes inherit from this class.

    \n" + }, + "p5.StringDict": { + "name": "p5.StringDict", + "shortname": "p5.StringDict", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Data", + "submodule": "Dictionary", + "namespace": "", + "file": "src/data/p5.TypedDict.js", + "line": 403, + "description": "

    A simple Dictionary class for Strings.

    \n", + "extends": "p5.TypedDict" + }, + "p5.NumberDict": { + "name": "p5.NumberDict", + "shortname": "p5.NumberDict", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Data", + "submodule": "Dictionary", + "namespace": "", + "file": "src/data/p5.TypedDict.js", + "line": 422, + "description": "

    A simple Dictionary class for Numbers.

    \n", + "extends": "p5.TypedDict" + }, + "p5.Image": { + "name": "p5.Image", + "shortname": "p5.Image", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Image", + "submodule": "Image", + "namespace": "", + "file": "src/image/p5.Image.js", + "line": 23, + "description": "

    Creates a new p5.Image. A p5.Image is a canvas backed representation of an\nimage.\n

    \np5 can display .gif, .jpg and .png images. Images may be displayed\nin 2D and 3D space. Before an image is used, it must be loaded with the\nloadImage() function. The p5.Image class contains fields for the width and\nheight of the image, as well as an array called pixels[] that contains the\nvalues for every pixel in the image.\n

    \nThe methods described below allow easy access to the image's pixels and\nalpha channel and simplify the process of compositing.\n

    \nBefore using the pixels[] array, be sure to use the loadPixels() method on\nthe image to make sure that the pixel data is properly loaded.

    \n", + "example": [ + "\n
    \nfunction setup() {\n let img = createImage(100, 100); // same as new p5.Image(100, 100);\n img.loadPixels();\n createCanvas(100, 100);\n background(0);\n\n // helper for writing color to array\n function writeColor(image, x, y, red, green, blue, alpha) {\n let index = (x + y * width) * 4;\n image.pixels[index] = red;\n image.pixels[index + 1] = green;\n image.pixels[index + 2] = blue;\n image.pixels[index + 3] = alpha;\n }\n\n let x, y;\n // fill with random colors\n for (y = 0; y < img.height; y++) {\n for (x = 0; x < img.width; x++) {\n let red = random(255);\n let green = random(255);\n let blue = random(255);\n let alpha = 255;\n writeColor(img, x, y, red, green, blue, alpha);\n }\n }\n\n // draw a red line\n y = 0;\n for (x = 0; x < img.width; x++) {\n writeColor(img, x, y, 255, 0, 0, 255);\n }\n\n // draw a green line\n y = img.height - 1;\n for (x = 0; x < img.width; x++) {\n writeColor(img, x, y, 0, 255, 0, 255);\n }\n\n img.updatePixels();\n image(img, 0, 0);\n}\n
    " + ], + "params": [ + { + "name": "width", + "description": "", + "type": "Number" + }, + { + "name": "height", + "description": "", + "type": "Number" + } + ] + }, + "p5.PrintWriter": { + "name": "p5.PrintWriter", + "shortname": "p5.PrintWriter", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "IO", + "submodule": "Output", + "namespace": "", + "file": "src/io/files.js", + "line": 1231, + "params": [ + { + "name": "filename", + "description": "", + "type": "String" + }, + { + "name": "extension", + "description": "", + "type": "String", + "optional": true + } + ] + }, + "p5.Table": { + "name": "p5.Table", + "shortname": "p5.Table", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "IO", + "submodule": "Table", + "namespace": "", + "file": "src/io/p5.Table.js", + "line": 35, + "description": "

    Table objects store data with multiple rows and columns, much\nlike in a traditional spreadsheet. Tables can be generated from\nscratch, dynamically, or using data from an existing file.

    \n", + "is_constructor": 1, + "params": [ + { + "name": "rows", + "description": "

    An array of p5.TableRow objects

    \n", + "type": "p5.TableRow[]", + "optional": true + } + ] + }, + "p5.TableRow": { + "name": "p5.TableRow", + "shortname": "p5.TableRow", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "IO", + "submodule": "Table", + "namespace": "", + "file": "src/io/p5.TableRow.js", + "line": 11, + "description": "

    A TableRow object represents a single row of data values,\nstored in columns, from a table.

    \n

    A Table Row contains both an ordered array, and an unordered\nJSON object.

    \n", + "is_constructor": 1, + "params": [ + { + "name": "str", + "description": "

    optional: populate the row with a\n string of values, separated by the\n separator

    \n", + "type": "String", + "optional": true + }, + { + "name": "separator", + "description": "

    comma separated values (csv) by default

    \n", + "type": "String", + "optional": true + } + ] + }, + "p5.XML": { + "name": "p5.XML", + "shortname": "p5.XML", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "IO", + "submodule": "XML", + "namespace": "", + "file": "src/io/p5.XML.js", + "line": 11, + "description": "

    XML is a representation of an XML object, able to parse XML code. Use\nloadXML() to load external XML files and create XML objects.

    \n", + "is_constructor": 1, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let children = xml.getChildren('animal');\n\n for (let i = 0; i < children.length; i++) {\n let id = children[i].getNum('id');\n let coloring = children[i].getString('species');\n let name = children[i].getContent();\n print(id + ', ' + coloring + ', ' + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n
    " + ], + "alt": "no image displayed" + }, + "p5.Vector": { + "name": "p5.Vector", + "shortname": "p5.Vector", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Math", + "submodule": "Math", + "namespace": "", + "file": "src/math/p5.Vector.js", + "line": 12, + "description": "

    A class to describe a two or three dimensional vector, specifically\na Euclidean (also known as geometric) vector. A vector is an entity\nthat has both magnitude and direction. The datatype, however, stores\nthe components of the vector (x, y for 2D, and x, y, z for 3D). The magnitude\nand direction can be accessed via the methods mag() and heading().\n

    \nIn many of the p5.js examples, you will see p5.Vector used to describe a\nposition, velocity, or acceleration. For example, if you consider a rectangle\nmoving across the screen, at any given instant it has a position (a vector\nthat points from the origin to its location), a velocity (the rate at which\nthe object's position changes per time unit, expressed as a vector), and\nacceleration (the rate at which the object's velocity changes per time\nunit, expressed as a vector).\n

    \nSince vectors represent groupings of values, we cannot simply use\ntraditional addition/multiplication/etc. Instead, we'll need to do some\n"vector" math, which is made easy by the methods inside the p5.Vector class.

    \n", + "params": [ + { + "name": "x", + "description": "

    x component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    y component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    z component of the vector

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \n\nlet v1 = createVector(40, 50);\nlet v2 = createVector(40, 50);\n\nellipse(v1.x, v1.y, 50, 50);\nellipse(v2.x, v2.y, 50, 50);\nv1.add(v2);\nellipse(v1.x, v1.y, 50, 50);\n\n
    " + ], + "alt": "2 white ellipses. One center-left the other bottom right and off canvas" + }, + "p5.Font": { + "name": "p5.Font", + "shortname": "p5.Font", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Typography", + "submodule": "Font", + "namespace": "", + "file": "src/typography/p5.Font.js", + "line": 15, + "description": "

    Base class for font handling

    \n", + "params": [ + { + "name": "pInst", + "description": "

    pointer to p5 instance

    \n", + "type": "P5", + "optional": true + } + ] + }, + "p5.Camera": { + "name": "p5.Camera", + "shortname": "p5.Camera", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Lights, Camera", + "submodule": "Camera", + "namespace": "", + "file": "src/webgl/p5.Camera.js", + "line": 209, + "description": "

    This class describes a camera for use in p5's\n\nWebGL mode. It contains camera position, orientation, and projection\ninformation necessary for rendering a 3D scene.

    \n

    New p5.Camera objects can be made through the\ncreateCamera() function and controlled through\nthe methods described below. A camera created in this way will use a default\nposition in the scene and a default perspective projection until these\nproperties are changed through the various methods available. It is possible\nto create multiple cameras, in which case the current camera\ncan be set through the setCamera() method.

    \n

    Note:\nThe methods below operate in two coordinate systems: the 'world' coordinate\nsystem describe positions in terms of their relationship to the origin along\nthe X, Y and Z axes whereas the camera's 'local' coordinate system\ndescribes positions from the camera's point of view: left-right, up-down,\nand forward-backward. The move() method,\nfor instance, moves the camera along its own axes, whereas the\nsetPosition()\nmethod sets the camera's position in world-space.

    \n", + "params": [ + { + "name": "rendererGL", + "description": "

    instance of WebGL renderer

    \n", + "type": "RendererGL" + } + ], + "example": [ + "\n
    \n\nlet cam;\nlet delta = 0.01;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n // set initial pan angle\n cam.pan(-0.8);\n}\n\nfunction draw() {\n background(200);\n\n // pan camera according to angle 'delta'\n cam.pan(delta);\n\n // every 160 frames, switch direction\n if (frameCount % 160 === 0) {\n delta *= -1;\n }\n\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n
    " + ], + "alt": "camera view pans left and right across a series of rotating 3D boxes." + }, + "p5.Geometry": { + "name": "p5.Geometry", + "shortname": "p5.Geometry", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Lights, Camera", + "namespace": "", + "file": "src/webgl/p5.Geometry.js", + "line": 6, + "description": "

    p5 Geometry class

    \n", + "is_constructor": 1, + "params": [ + { + "name": "detailX", + "description": "

    number of vertices on horizontal surface

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    number of vertices on horizontal surface

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "callback", + "description": "

    function to call upon object instantiation.

    \n", + "type": "Function", + "optional": true + } + ] + }, + "p5.Shader": { + "name": "p5.Shader", + "shortname": "p5.Shader", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "Lights, Camera", + "submodule": "Shaders", + "namespace": "", + "file": "src/webgl/p5.Shader.js", + "line": 13, + "description": "

    Shader class for WEBGL Mode

    \n", + "params": [ + { + "name": "renderer", + "description": "

    an instance of p5.RendererGL that\nwill provide the GL context for this new p5.Shader

    \n", + "type": "p5.RendererGL" + }, + { + "name": "vertSrc", + "description": "

    source code for the vertex shader (as a string)

    \n", + "type": "String" + }, + { + "name": "fragSrc", + "description": "

    source code for the fragment shader (as a string)

    \n", + "type": "String" + } + ] + }, + "p5.MediaElement": { + "name": "p5.MediaElement", + "shortname": "p5.MediaElement", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.dom", + "submodule": "p5.dom", + "namespace": "", + "file": "lib/addons/p5.dom.js", + "line": 2228, + "description": "

    Extends p5.Element to handle audio and video. In addition to the methods\nof p5.Element, it also contains methods for controlling media. It is not\ncalled directly, but p5.MediaElements are created by calling createVideo,\ncreateAudio, and createCapture.

    \n", + "is_constructor": 1, + "params": [ + { + "name": "elt", + "description": "

    DOM node that is wrapped

    \n", + "type": "String" + } + ] + }, + "p5.File": { + "name": "p5.File", + "shortname": "p5.File", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.dom", + "submodule": "p5.dom", + "namespace": "", + "file": "lib/addons/p5.dom.js", + "line": 3331, + "description": "

    Base class for a file.\nUsed for Element.drop and createFileInput.

    \n", + "is_constructor": 1, + "params": [ + { + "name": "file", + "description": "

    File that is wrapped

    \n", + "type": "File" + } + ] + }, + "p5.sound": { + "name": "p5.sound", + "shortname": "p5.sound", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "" + }, + "p5.SoundFile": { + "name": "p5.SoundFile", + "shortname": "p5.SoundFile", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 1645, + "description": "

    SoundFile object with a path to a file.

    \n\n

    The p5.SoundFile may not be available immediately because\nit loads the file information asynchronously.

    \n\n

    To do something with the sound as soon as it loads\npass the name of a function as the second parameter.

    \n\n

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

    ", + "is_constructor": 1, + "params": [ + { + "name": "path", + "description": "

    path to a sound file (String). Optionally,\n you may include multiple file formats in\n an array. Alternately, accepts an object\n from the HTML5 File API, or a p5.File.

    \n", + "type": "String|Array" + }, + { + "name": "successCallback", + "description": "

    Name of a function to call once file loads

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    Name of a function to call if file fails to\n load. This function will receive an error or\n XMLHttpRequest object with information\n about what went wrong.

    \n", + "type": "Function", + "optional": true + }, + { + "name": "whileLoadingCallback", + "description": "

    Name of a function to call while file\n is loading. That function will\n receive progress of the request to\n load the sound file\n (between 0 and 1) as its first\n parameter. This progress\n does not account for the additional\n time needed to decode the audio data.

    \n", + "type": "Function", + "optional": true + } + ], + "example": [ + "\n
    \n\nfunction preload() {\n soundFormats('mp3', 'ogg');\n mySound = loadSound('assets/doorbell.mp3');\n}\n\nfunction setup() {\n mySound.setVolume(0.1);\n mySound.play();\n}\n\n
    " + ] + }, + "p5.Amplitude": { + "name": "p5.Amplitude", + "shortname": "p5.Amplitude", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 3179, + "description": "

    Amplitude measures volume between 0.0 and 1.0.\nListens to all p5sound by default, or use setInput()\nto listen to a specific sound source. Accepts an optional\nsmoothing value, which defaults to 0.

    \n", + "is_constructor": 1, + "params": [ + { + "name": "smoothing", + "description": "

    between 0.0 and .999 to smooth\n amplitude readings (defaults to 0)

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar sound, amplitude, cnv;\n\nfunction preload(){\n sound = loadSound('assets/beat.mp3');\n}\nfunction setup() {\n cnv = createCanvas(100,100);\n amplitude = new p5.Amplitude();\n\n // start / stop the sound when canvas is clicked\n cnv.mouseClicked(function() {\n if (sound.isPlaying() ){\n sound.stop();\n } else {\n sound.play();\n }\n });\n}\nfunction draw() {\n background(0);\n fill(255);\n var level = amplitude.getLevel();\n var size = map(level, 0, 1, 0, 200);\n ellipse(width/2, height/2, size, size);\n}\n\n
    " + ] + }, + "p5.FFT": { + "name": "p5.FFT", + "shortname": "p5.FFT", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 3458, + "description": "

    FFT (Fast Fourier Transform) is an analysis algorithm that\nisolates individual\n\naudio frequencies within a waveform.

    \n\n

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

    \n\n

    FFT analyzes a very short snapshot of sound called a sample\nbuffer. It returns an array of amplitude measurements, referred\nto as bins. The array is 1024 bins long by default.\nYou can change the bin array length, but it must be a power of 2\nbetween 16 and 1024 in order for the FFT algorithm to function\ncorrectly. The actual size of the FFT buffer is twice the\nnumber of bins, so given a standard sample rate, the buffer is\n2048/44100 seconds long.

    ", + "is_constructor": 1, + "params": [ + { + "name": "smoothing", + "description": "

    Smooth results of Freq Spectrum.\n 0.0 < smoothing < 1.0.\n Defaults to 0.8.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "bins", + "description": "

    Length of resulting array.\n Must be a power of two between\n 16 and 1024. Defaults to 1024.

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nfunction preload(){\n sound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup(){\n var cnv = createCanvas(100,100);\n cnv.mouseClicked(togglePlay);\n fft = new p5.FFT();\n sound.amp(0.2);\n}\n\nfunction draw(){\n background(0);\n\n var spectrum = fft.analyze();\n noStroke();\n fill(0,255,0); // spectrum is green\n for (var i = 0; i< spectrum.length; i++){\n var x = map(i, 0, spectrum.length, 0, width);\n var h = -height + map(spectrum[i], 0, 255, height, 0);\n rect(x, height, width / spectrum.length, h )\n }\n\n var waveform = fft.waveform();\n noFill();\n beginShape();\n stroke(255,0,0); // waveform is red\n strokeWeight(1);\n for (var i = 0; i< waveform.length; i++){\n var x = map(i, 0, waveform.length, 0, width);\n var y = map( waveform[i], -1, 1, 0, height);\n vertex(x,y);\n }\n endShape();\n\n text('click to play/pause', 4, 10);\n}\n\n// fade sound if mouse is over canvas\nfunction togglePlay() {\n if (sound.isPlaying()) {\n sound.pause();\n } else {\n sound.loop();\n }\n}\n
    " + ] + }, + "p5.Signal": { + "name": "p5.Signal", + "shortname": "p5.Signal", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 5223, + "description": "

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

    \n\n

    This is necessary because Web Audio is processed on a seprate clock.\nFor example, the p5 draw loop runs about 60 times per second. But\nthe audio clock must process samples 44100 times per second. If we\nwant to add a value to each of those samples, we can't do it in the\ndraw loop, but we can do it by adding a constant-rate audio signal.</p.\n\n

    This class mostly functions behind the scenes in p5.sound, and returns\na Tone.Signal from the Tone.js library by Yotam Mann.\nIf you want to work directly with audio signals for modular\nsynthesis, check out\ntone.js.

    ", + "is_constructor": 1, + "return": { + "description": "A Signal object from the Tone.js library", + "type": "Tone.Signal" + }, + "example": [ + "\n
    \nfunction setup() {\n carrier = new p5.Oscillator('sine');\n carrier.amp(1); // set amplitude\n carrier.freq(220); // set frequency\n carrier.start(); // start oscillating\n\n modulator = new p5.Oscillator('sawtooth');\n modulator.disconnect();\n modulator.amp(1);\n modulator.freq(4);\n modulator.start();\n\n // Modulator's default amplitude range is -1 to 1.\n // Multiply it by -200, so the range is -200 to 200\n // then add 220 so the range is 20 to 420\n carrier.freq( modulator.mult(-200).add(220) );\n}\n
    " + ] + }, + "p5.Oscillator": { + "name": "p5.Oscillator", + "shortname": "p5.Oscillator", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 5369, + "description": "

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

    \n\n

    Set the type of oscillation with setType(), or by instantiating a\nspecific oscillator: p5.SinOsc, p5.TriOsc, p5.SqrOsc, or p5.SawOsc.\n

    ", + "is_constructor": 1, + "params": [ + { + "name": "freq", + "description": "

    frequency defaults to 440Hz

    \n", + "type": "Number", + "optional": true + }, + { + "name": "type", + "description": "

    type of oscillator. Options:\n 'sine' (default), 'triangle',\n 'sawtooth', 'square'

    \n", + "type": "String", + "optional": true + } + ], + "example": [ + "\n
    \nvar osc;\nvar playing = false;\n\nfunction setup() {\n backgroundColor = color(255,0,255);\n textAlign(CENTER);\n\n osc = new p5.Oscillator();\n osc.setType('sine');\n osc.freq(240);\n osc.amp(0);\n osc.start();\n}\n\nfunction draw() {\n background(backgroundColor)\n text('click to play', width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {\n if (!playing) {\n // ramp amplitude to 0.5 over 0.05 seconds\n osc.amp(0.5, 0.05);\n playing = true;\n backgroundColor = color(0,255,255);\n } else {\n // ramp amplitude to 0 over 0.5 seconds\n osc.amp(0, 0.5);\n playing = false;\n backgroundColor = color(255,0,255);\n }\n }\n}\n
    " + ] + }, + "p5.SinOsc": { + "name": "p5.SinOsc", + "shortname": "p5.SinOsc", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 5810, + "description": "

    Constructor: new p5.SinOsc().\nThis creates a Sine Wave Oscillator and is\nequivalent to new p5.Oscillator('sine')\n or creating a p5.Oscillator and then calling\nits method setType('sine').\nSee p5.Oscillator for methods.

    \n", + "is_constructor": 1, + "extends": "p5.Oscillator", + "params": [ + { + "name": "freq", + "description": "

    Set the frequency

    \n", + "type": "Number", + "optional": true + } + ] + }, + "p5.TriOsc": { + "name": "p5.TriOsc", + "shortname": "p5.TriOsc", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 5827, + "description": "

    Constructor: new p5.TriOsc().\nThis creates a Triangle Wave Oscillator and is\nequivalent to new p5.Oscillator('triangle')\n or creating a p5.Oscillator and then calling\nits method setType('triangle').\nSee p5.Oscillator for methods.

    \n", + "is_constructor": 1, + "extends": "p5.Oscillator", + "params": [ + { + "name": "freq", + "description": "

    Set the frequency

    \n", + "type": "Number", + "optional": true + } + ] + }, + "p5.SawOsc": { + "name": "p5.SawOsc", + "shortname": "p5.SawOsc", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 5844, + "description": "

    Constructor: new p5.SawOsc().\nThis creates a SawTooth Wave Oscillator and is\nequivalent to new p5.Oscillator('sawtooth')\n or creating a p5.Oscillator and then calling\nits method setType('sawtooth').\nSee p5.Oscillator for methods.

    \n", + "is_constructor": 1, + "extends": "p5.Oscillator", + "params": [ + { + "name": "freq", + "description": "

    Set the frequency

    \n", + "type": "Number", + "optional": true + } + ] + }, + "p5.SqrOsc": { + "name": "p5.SqrOsc", + "shortname": "p5.SqrOsc", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 5861, + "description": "

    Constructor: new p5.SqrOsc().\nThis creates a Square Wave Oscillator and is\nequivalent to new p5.Oscillator('square')\n or creating a p5.Oscillator and then calling\nits method setType('square').\nSee p5.Oscillator for methods.

    \n", + "is_constructor": 1, + "extends": "p5.Oscillator", + "params": [ + { + "name": "freq", + "description": "

    Set the frequency

    \n", + "type": "Number", + "optional": true + } + ] + }, + "p5.Envelope": { + "name": "p5.Envelope", + "shortname": "p5.Envelope", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 6316, + "description": "

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

    \n

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

    \n

    Use the play method to play the entire envelope,\nthe ramp method for a pingable trigger,\nor triggerAttack/\ntriggerRelease to trigger noteOn/noteOff.

    ", + "is_constructor": 1, + "example": [ + "\n
    \nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv() {\n env.play();\n}\n
    " + ] + }, + "p5.Pulse": { + "name": "p5.Pulse", + "shortname": "p5.Pulse", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 7114, + "description": "

    Creates a Pulse object, an oscillator that implements\nPulse Width Modulation.\nThe pulse is created with two oscillators.\nAccepts a parameter for frequency, and to set the\nwidth between the pulses. See \np5.Oscillator for a full list of methods.

    \n", + "extends": "p5.Oscillator", + "is_constructor": 1, + "params": [ + { + "name": "freq", + "description": "

    Frequency in oscillations per second (Hz)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "w", + "description": "

    Width between the pulses (0 to 1.0,\n defaults to 0)

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar pulse;\nfunction setup() {\n background(0);\n\n // Create and start the pulse wave oscillator\n pulse = new p5.Pulse();\n pulse.amp(0.5);\n pulse.freq(220);\n pulse.start();\n}\n\nfunction draw() {\n var w = map(mouseX, 0, width, 0, 1);\n w = constrain(w, 0, 1);\n pulse.width(w)\n}\n
    " + ] + }, + "p5.Noise": { + "name": "p5.Noise", + "shortname": "p5.Noise", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 7293, + "description": "

    Noise is a type of oscillator that generates a buffer with random values.

    \n", + "extends": "p5.Oscillator", + "is_constructor": 1, + "params": [ + { + "name": "type", + "description": "

    Type of noise can be 'white' (default),\n 'brown' or 'pink'.

    \n", + "type": "String" + } + ] + }, + "p5.AudioIn": { + "name": "p5.AudioIn", + "shortname": "p5.AudioIn", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 7441, + "description": "

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

    \n\n

    Turn the mic on/off with the start() and stop() methods. When the mic\nis on, its volume can be measured with getLevel or by connecting an\nFFT object.

    \n\n

    If you want to hear the AudioIn, use the .connect() method.\nAudioIn does not connect to p5.sound output by default to prevent\nfeedback.

    \n\n

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

    ", + "is_constructor": 1, + "params": [ + { + "name": "errorCallback", + "description": "

    A function to call if there is an error\n accessing the AudioIn. For example,\n Safari and iOS devices do not\n currently allow microphone access.

    \n", + "type": "Function", + "optional": true + } + ], + "example": [ + "\n
    \nvar mic;\nfunction setup(){\n mic = new p5.AudioIn()\n mic.start();\n}\nfunction draw(){\n background(0);\n micLevel = mic.getLevel();\n ellipse(width/2, constrain(height-micLevel*height*5, 0, height), 10, 10);\n}\n
    " + ] + }, + "p5.Effect": { + "name": "p5.Effect", + "shortname": "p5.Effect", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 8357, + "description": "

    Effect is a base class for audio effects in p5.
    \nThis module handles the nodes and methods that are \ncommon and useful for current and future effects.

    \n

    This class is extended by p5.Distortion, \np5.Compressor,\np5.Delay, \np5.Filter, \np5.Reverb.

    \n", + "is_constructor": 1, + "params": [ + { + "name": "ac", + "description": "

    Reference to the audio context of the p5 object

    \n", + "type": "Object", + "optional": true + }, + { + "name": "input", + "description": "

    Gain Node effect wrapper

    \n", + "type": "AudioNode", + "optional": true + }, + { + "name": "output", + "description": "

    Gain Node effect wrapper

    \n", + "type": "AudioNode", + "optional": true + }, + { + "name": "_drywet", + "description": "

    Tone.JS CrossFade node (defaults to value: 1)

    \n", + "type": "Object", + "optional": true + }, + { + "name": "wet", + "description": "

    Effects that extend this class should connect\n to the wet signal to this gain node, so that dry and wet \n signals are mixed properly.

    \n", + "type": "AudioNode", + "optional": true + } + ] + }, + "p5.Filter": { + "name": "p5.Filter", + "shortname": "p5.Filter", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 8499, + "description": "

    A p5.Filter uses a Web Audio Biquad Filter to filter\nthe frequency response of an input source. Subclasses\ninclude:

    \n
      \n
    • p5.LowPass:\nAllows frequencies below the cutoff frequency to pass through,\nand attenuates frequencies above the cutoff.
      • \n
    • p5.HighPass:\nThe opposite of a lowpass filter.
      • \n
    • p5.BandPass:\nAllows a range of frequencies to pass through and attenuates\nthe frequencies below and above this frequency range.
      • \n
    \n

    The .res() method controls either width of the\nbandpass, or resonance of the low/highpass cutoff frequency.

    \n

    This class extends p5.Effect.
    Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.

    \n", + "extends": "p5.Effect", + "is_constructor": 1, + "params": [ + { + "name": "type", + "description": "

    'lowpass' (default), 'highpass', 'bandpass'

    \n", + "type": "String", + "optional": true + } + ], + "example": [ + "\n
    \nvar fft, noise, filter;\n\nfunction setup() {\n fill(255, 40, 255);\n\n filter = new p5.BandPass();\n\n noise = new p5.Noise();\n // disconnect unfiltered noise,\n // and connect to filter\n noise.disconnect();\n noise.connect(filter);\n noise.start();\n\n fft = new p5.FFT();\n}\n\nfunction draw() {\n background(30);\n\n // set the BandPass frequency based on mouseX\n var freq = map(mouseX, 0, width, 20, 10000);\n filter.freq(freq);\n // give the filter a narrow band (lower res = wider bandpass)\n filter.res(50);\n\n // draw filtered spectrum\n var spectrum = fft.analyze();\n noStroke();\n for (var i = 0; i < spectrum.length; i++) {\n var x = map(i, 0, spectrum.length, 0, width);\n var h = -height + map(spectrum[i], 0, 255, height, 0);\n rect(x, height, width/spectrum.length, h);\n }\n\n isMouseOverCanvas();\n}\n\nfunction isMouseOverCanvas() {\n var mX = mouseX, mY = mouseY;\n if (mX > 0 && mX < width && mY < height && mY > 0) {\n noise.amp(0.5, 0.2);\n } else {\n noise.amp(0, 0.2);\n }\n}\n
    " + ] + }, + "p5.LowPass": { + "name": "p5.LowPass", + "shortname": "p5.LowPass", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 8730, + "description": "

    Constructor: new p5.LowPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('lowpass').\nSee p5.Filter for methods.

    \n", + "is_constructor": 1, + "extends": "p5.Filter" + }, + "p5.HighPass": { + "name": "p5.HighPass", + "shortname": "p5.HighPass", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 8744, + "description": "

    Constructor: new p5.HighPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('highpass').\nSee p5.Filter for methods.

    \n", + "is_constructor": 1, + "extends": "p5.Filter" + }, + "p5.BandPass": { + "name": "p5.BandPass", + "shortname": "p5.BandPass", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 8758, + "description": "

    Constructor: new p5.BandPass() Filter.\nThis is the same as creating a p5.Filter and then calling\nits method setType('bandpass').\nSee p5.Filter for methods.

    \n", + "is_constructor": 1, + "extends": "p5.Filter" + }, + "p5.EQ": { + "name": "p5.EQ", + "shortname": "p5.EQ", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 8829, + "description": "

    p5.EQ is an audio effect that performs the function of a multiband\naudio equalizer. Equalization is used to adjust the balance of\nfrequency compoenents of an audio signal. This process is commonly used\nin sound production and recording to change the waveform before it reaches\na sound output device. EQ can also be used as an audio effect to create\ninteresting distortions by filtering out parts of the spectrum. p5.EQ is\nbuilt using a chain of Web Audio Biquad Filter Nodes and can be\ninstantiated with 3 or 8 bands. Bands can be added or removed from\nthe EQ by directly modifying p5.EQ.bands (the array that stores filters).

    \n

    This class extends p5.Effect.\nMethods amp(), chain(),\ndrywet(), connect(), and\ndisconnect() are available.

    \n", + "is_constructor": 1, + "extends": "p5.Effect", + "params": [ + { + "name": "_eqsize", + "description": "

    Constructor will accept 3 or 8, defaults to 3

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "p5.EQ object", + "type": "Object" + }, + "example": [ + "\n
    \nvar eq;\nvar band_names;\nvar band_index;\n\nvar soundFile, play;\n\nfunction preload() {\n soundFormats('mp3', 'ogg');\n soundFile = loadSound('assets/beat');\n}\n\nfunction setup() {\n eq = new p5.EQ(3);\n soundFile.disconnect();\n eq.process(soundFile);\n\n band_names = ['lows','mids','highs'];\n band_index = 0;\n play = false;\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(30);\n noStroke();\n fill(255);\n text('click to kill',50,25);\n\n fill(255, 40, 255);\n textSize(26);\n text(band_names[band_index],50,55);\n\n fill(255);\n textSize(9);\n text('space = play/pause',50,80);\n}\n\n//If mouse is over canvas, cycle to the next band and kill the frequency\nfunction mouseClicked() {\n for (var i = 0; i < eq.bands.length; i++) {\n eq.bands[i].gain(0);\n }\n eq.bands[band_index].gain(-40);\n if (mouseX > 0 && mouseX < width && mouseY < height && mouseY > 0) {\n band_index === 2 ? band_index = 0 : band_index++;\n }\n}\n\n//use space bar to trigger play / pause\nfunction keyPressed() {\n if (key===' ') {\n play = !play\n play ? soundFile.loop() : soundFile.pause();\n }\n}\n
    " + ] + }, + "p5.Panner3D": { + "name": "p5.Panner3D", + "shortname": "p5.Panner3D", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 9021, + "description": "

    Panner3D is based on the \nWeb Audio Spatial Panner Node.\nThis panner is a spatial processing node that allows audio to be positioned\nand oriented in 3D space.

    \n

    The position is relative to an \nAudio Context Listener, which can be accessed\nby p5.soundOut.audiocontext.listener

    \n", + "is_constructor": 1 + }, + "p5.Delay": { + "name": "p5.Delay", + "shortname": "p5.Delay", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 9472, + "description": "

    Delay is an echo effect. It processes an existing sound source,\nand outputs a delayed version of that sound. The p5.Delay can\nproduce different effects depending on the delayTime, feedback,\nfilter, and type. In the example below, a feedback of 0.5 (the\ndefaul value) will produce a looping delay that decreases in\nvolume by 50% each repeat. A filter will cut out the high\nfrequencies so that the delay does not sound as piercing as the\noriginal source.

    \n

    This class extends p5.Effect.
    Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.

    \n", + "extends": "p5.Effect", + "is_constructor": 1, + "example": [ + "\n
    \nvar noise, env, delay;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n noise = new p5.Noise('brown');\n noise.amp(0);\n noise.start();\n\n delay = new p5.Delay();\n\n // delay.process() accepts 4 parameters:\n // source, delayTime, feedback, filter frequency\n // play with these numbers!!\n delay.process(noise, .12, .7, 2300);\n\n // play the noise with an envelope,\n // a series of fades ( time / value pairs )\n env = new p5.Envelope(.01, 0.2, .2, .1);\n}\n\n// mouseClick triggers envelope\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(noise);\n }\n}\n
    " + ] + }, + "p5.Reverb": { + "name": "p5.Reverb", + "shortname": "p5.Reverb", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 9749, + "description": "

    Reverb adds depth to a sound through a large number of decaying\nechoes. It creates the perception that sound is occurring in a\nphysical space. The p5.Reverb has paramters for Time (how long does the\nreverb last) and decayRate (how much the sound decays with each echo)\nthat can be set with the .set() or .process() methods. The p5.Convolver\nextends p5.Reverb allowing you to recreate the sound of actual physical\nspaces through convolution.

    \n

    This class extends p5.Effect.\nMethods amp(), chain(),\ndrywet(), connect(), and\ndisconnect() are available.

    \n", + "extends": "p5.Effect", + "is_constructor": 1, + "example": [ + "\n
    \nvar soundFile, reverb;\nfunction preload() {\n soundFile = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n reverb = new p5.Reverb();\n soundFile.disconnect(); // so we'll only hear reverb...\n\n // connect soundFile to reverb, process w/\n // 3 second reverbTime, decayRate of 2%\n reverb.process(soundFile, 3, 2);\n soundFile.play();\n}\n
    " + ] + }, + "p5.Convolver": { + "name": "p5.Convolver", + "shortname": "p5.Convolver", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 9920, + "description": "

    p5.Convolver extends p5.Reverb. It can emulate the sound of real\nphysical spaces through a process called \nconvolution.

    \n\n

    Convolution multiplies any audio input by an "impulse response"\nto simulate the dispersion of sound over time. The impulse response is\ngenerated from an audio file that you provide. One way to\ngenerate an impulse response is to pop a balloon in a reverberant space\nand record the echo. Convolution can also be used to experiment with\nsound.

    \n\n

    Use the method createConvolution(path) to instantiate a\np5.Convolver with a path to your impulse response audio file.

    ", + "extends": "p5.Effect", + "is_constructor": 1, + "params": [ + { + "name": "path", + "description": "

    path to a sound file

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function to call when loading succeeds

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to call if loading fails.\n This function will receive an error or\n XMLHttpRequest object with information\n about what went wrong.

    \n", + "type": "Function", + "optional": true + } + ], + "example": [ + "\n
    \nvar cVerb, sound;\nfunction preload() {\n // We have both MP3 and OGG versions of all sound assets\n soundFormats('ogg', 'mp3');\n\n // Try replacing 'bx-spring' with other soundfiles like\n // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox'\n cVerb = createConvolver('assets/bx-spring.mp3');\n\n // Try replacing 'Damscray_DancingTiger' with\n // 'beat', 'doorbell', lucky_dragons_-_power_melody'\n sound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n // disconnect from master output...\n sound.disconnect();\n\n // ...and process with cVerb\n // so that we only hear the convolution\n cVerb.process(sound);\n\n sound.play();\n}\n
    " + ] + }, + "p5.Phrase": { + "name": "p5.Phrase", + "shortname": "p5.Phrase", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 10476, + "description": "

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

    \n\n

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

    \n\n

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

    ", + "is_constructor": 1, + "params": [ + { + "name": "name", + "description": "

    Name so that you can access the Phrase.

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    The name of a function that this phrase\n will call. Typically it will play a sound,\n and accept two parameters: a time at which\n to play the sound (in seconds from now),\n and a value from the sequence array. The\n time should be passed into the play() or\n start() method to ensure precision.

    \n", + "type": "Function" + }, + { + "name": "sequence", + "description": "

    Array of values to pass into the callback\n at each step of the phrase.

    \n", + "type": "Array" + } + ], + "example": [ + "\n
    \nvar mySound, myPhrase, myPart;\nvar pattern = [1,0,0,2,0,2,0,0];\nvar msg = 'click to play';\n\nfunction preload() {\n mySound = loadSound('assets/beatbox.mp3');\n}\n\nfunction setup() {\n noStroke();\n fill(255);\n textAlign(CENTER);\n masterVolume(0.1);\n\n myPhrase = new p5.Phrase('bbox', makeSound, pattern);\n myPart = new p5.Part();\n myPart.addPhrase(myPhrase);\n myPart.setBPM(60);\n}\n\nfunction draw() {\n background(0);\n text(msg, width/2, height/2);\n}\n\nfunction makeSound(time, playbackRate) {\n mySound.rate(playbackRate);\n mySound.play(time);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n myPart.start();\n msg = 'playing pattern';\n }\n}\n\n
    " + ] + }, + "p5.Part": { + "name": "p5.Part", + "shortname": "p5.Part", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 10561, + "description": "

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

    \n\n

    See p5.Phrase for more about musical timing.

    ", + "is_constructor": 1, + "params": [ + { + "name": "steps", + "description": "

    Steps in the part

    \n", + "type": "Number", + "optional": true + }, + { + "name": "tatums", + "description": "

    Divisions of a beat, e.g. use 1/4, or 0.25 for a quater note (default is 1/16, a sixteenth note)

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar box, drum, myPart;\nvar boxPat = [1,0,0,2,0,2,0,0];\nvar drumPat = [0,1,1,0,2,0,1,0];\nvar msg = 'click to play';\n\nfunction preload() {\n box = loadSound('assets/beatbox.mp3');\n drum = loadSound('assets/drum.mp3');\n}\n\nfunction setup() {\n noStroke();\n fill(255);\n textAlign(CENTER);\n masterVolume(0.1);\n\n var boxPhrase = new p5.Phrase('box', playBox, boxPat);\n var drumPhrase = new p5.Phrase('drum', playDrum, drumPat);\n myPart = new p5.Part();\n myPart.addPhrase(boxPhrase);\n myPart.addPhrase(drumPhrase);\n myPart.setBPM(60);\n masterVolume(0.1);\n}\n\nfunction draw() {\n background(0);\n text(msg, width/2, height/2);\n}\n\nfunction playBox(time, playbackRate) {\n box.rate(playbackRate);\n box.play(time);\n}\n\nfunction playDrum(time, playbackRate) {\n drum.rate(playbackRate);\n drum.play(time);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n myPart.start();\n msg = 'playing part';\n }\n}\n
    " + ] + }, + "p5.Score": { + "name": "p5.Score", + "shortname": "p5.Score", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 10814, + "description": "

    A Score consists of a series of Parts. The parts will\nbe played back in order. For example, you could have an\nA part, a B part, and a C part, and play them back in this order\nnew p5.Score(a, a, b, a, c)

    \n", + "is_constructor": 1, + "params": [ + { + "name": "parts", + "description": "

    One or multiple parts, to be played in sequence.

    \n", + "type": "p5.Part", + "optional": true, + "multiple": true + } + ] + }, + "p5.SoundLoop": { + "name": "p5.SoundLoop", + "shortname": "p5.SoundLoop", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 10945, + "description": "

    SoundLoop

    \n", + "is_constructor": 1, + "params": [ + { + "name": "callback", + "description": "

    this function will be called on each iteration of theloop

    \n", + "type": "Function" + }, + { + "name": "interval", + "description": "

    amount of time or beats for each iteration of the loop\n defaults to 1

    \n", + "type": "Number|String", + "optional": true + } + ], + "example": [ + "\n
    \nvar click;\nvar looper1;\n\nfunction preload() {\n click = loadSound('assets/drum.mp3');\n}\n\nfunction setup() {\n //the looper's callback is passed the timeFromNow\n //this value should be used as a reference point from \n //which to schedule sounds \n looper1 = new p5.SoundLoop(function(timeFromNow){\n click.play(timeFromNow);\n background(255 * (looper1.iterations % 2));\n }, 2);\n\n //stop after 10 iteratios;\n looper1.maxIterations = 10;\n //start the loop\n looper1.start();\n}\n
    " + ] + }, + "p5.Compressor": { + "name": "p5.Compressor", + "shortname": "p5.Compressor", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 11205, + "description": "

    Compressor is an audio effect class that performs dynamics compression\non an audio input source. This is a very commonly used technique in music\nand sound production. Compression creates an overall louder, richer, \nand fuller sound by lowering the volume of louds and raising that of softs.\nCompression can be used to avoid clipping (sound distortion due to \npeaks in volume) and is especially useful when many sounds are played \nat once. Compression can be used on indivudal sound sources in addition\nto the master output.

    \n

    This class extends p5.Effect.
    Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.

    \n", + "is_constructor": 1, + "extends": "p5.Effect" + }, + "p5.SoundRecorder": { + "name": "p5.SoundRecorder", + "shortname": "p5.SoundRecorder", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 11417, + "description": "

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

    \n

    The record() method accepts a p5.SoundFile as a parameter.\nWhen playback is stopped (either after the given amount of time,\nor with the stop() method), the p5.SoundRecorder will send its\nrecording to that p5.SoundFile for playback.

    ", + "is_constructor": 1, + "example": [ + "\n
    \nvar mic, recorder, soundFile;\nvar state = 0;\n\nfunction setup() {\n background(200);\n // create an audio in\n mic = new p5.AudioIn();\n\n // prompts user to enable their browser mic\n mic.start();\n\n // create a sound recorder\n recorder = new p5.SoundRecorder();\n\n // connect the mic to the recorder\n recorder.setInput(mic);\n\n // this sound file will be used to\n // playback & save the recording\n soundFile = new p5.SoundFile();\n\n text('keyPress to record', 20, 20);\n}\n\nfunction keyPressed() {\n // make sure user enabled the mic\n if (state === 0 && mic.enabled) {\n\n // record to our p5.SoundFile\n recorder.record(soundFile);\n\n background(255,0,0);\n text('Recording!', 20, 20);\n state++;\n }\n else if (state === 1) {\n background(0,255,0);\n\n // stop recorder and\n // send result to soundFile\n recorder.stop();\n\n text('Stopped', 20, 20);\n state++;\n }\n\n else if (state === 2) {\n soundFile.play(); // play the result!\n save(soundFile, 'mySound.wav');\n state++;\n }\n}\n
    " + ] + }, + "p5.PeakDetect": { + "name": "p5.PeakDetect", + "shortname": "p5.PeakDetect", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 11655, + "description": "

    PeakDetect works in conjunction with p5.FFT to\nlook for onsets in some or all of the frequency spectrum.\n

    \n

    \nTo use p5.PeakDetect, call update in the draw loop\nand pass in a p5.FFT object.\n

    \n

    \nYou can listen for a specific part of the frequency spectrum by\nsetting the range between freq1 and freq2.\n

    \n\n

    threshold is the threshold for detecting a peak,\nscaled between 0 and 1. It is logarithmic, so 0.1 is half as loud\nas 1.0.

    \n\n

    \nThe update method is meant to be run in the draw loop, and\nframes determines how many loops must pass before\nanother peak can be detected.\nFor example, if the frameRate() = 60, you could detect the beat of a\n120 beat-per-minute song with this equation:\n framesPerPeak = 60 / (estimatedBPM / 60 );\n

    \n\n

    \nBased on example contribtued by @b2renger, and a simple beat detection\nexplanation by Felix Turner.\n

    ", + "is_constructor": 1, + "params": [ + { + "name": "freq1", + "description": "

    lowFrequency - defaults to 20Hz

    \n", + "type": "Number", + "optional": true + }, + { + "name": "freq2", + "description": "

    highFrequency - defaults to 20000 Hz

    \n", + "type": "Number", + "optional": true + }, + { + "name": "threshold", + "description": "

    Threshold for detecting a beat between 0 and 1\n scaled logarithmically where 0.1 is 1/2 the loudness\n of 1.0. Defaults to 0.35.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "framesPerPeak", + "description": "

    Defaults to 20.

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \n\nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 10;\n\nfunction preload() {\n soundFile = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n\n // p5.PeakDetect requires a p5.FFT\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n}\n\nfunction draw() {\n background(0);\n text('click to play/pause', width/2, height/2);\n\n // peakDetect accepts an fft post-analysis\n fft.analyze();\n peakDetect.update(fft);\n\n if ( peakDetect.isDetected ) {\n ellipseWidth = 50;\n } else {\n ellipseWidth *= 0.95;\n }\n\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// toggle play/stop when canvas is clicked\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n }\n}\n
    " + ] + }, + "p5.Gain": { + "name": "p5.Gain", + "shortname": "p5.Gain", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 11879, + "description": "

    A gain node is usefull to set the relative volume of sound.\nIt's typically used to build mixers.

    \n", + "is_constructor": 1, + "example": [ + "\n
    \n\n // load two soundfile and crossfade beetween them\n var sound1,sound2;\n var gain1, gain2, gain3;\n\n function preload(){\n soundFormats('ogg', 'mp3');\n sound1 = loadSound('assets/Damscray_-_Dancing_Tiger_01');\n sound2 = loadSound('assets/beat.mp3');\n }\n\n function setup() {\n createCanvas(400,200);\n\n // create a 'master' gain to which we will connect both soundfiles\n gain3 = new p5.Gain();\n gain3.connect();\n\n // setup first sound for playing\n sound1.rate(1);\n sound1.loop();\n sound1.disconnect(); // diconnect from p5 output\n\n gain1 = new p5.Gain(); // setup a gain node\n gain1.setInput(sound1); // connect the first sound to its input\n gain1.connect(gain3); // connect its output to the 'master'\n\n sound2.rate(1);\n sound2.disconnect();\n sound2.loop();\n\n gain2 = new p5.Gain();\n gain2.setInput(sound2);\n gain2.connect(gain3);\n\n }\n\n function draw(){\n background(180);\n\n // calculate the horizontal distance beetween the mouse and the right of the screen\n var d = dist(mouseX,0,width,0);\n\n // map the horizontal position of the mouse to values useable for volume control of sound1\n var vol1 = map(mouseX,0,width,0,1);\n var vol2 = 1-vol1; // when sound1 is loud, sound2 is quiet and vice versa\n\n gain1.amp(vol1,0.5,0);\n gain2.amp(vol2,0.5,0);\n\n // map the vertical position of the mouse to values useable for 'master volume control'\n var vol3 = map(mouseY,0,height,0,1);\n gain3.amp(vol3,0.5,0);\n }\n
    \n" + ] + }, + "p5.AudioVoice": { + "name": "p5.AudioVoice", + "shortname": "p5.AudioVoice", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 12020, + "description": "

    Base class for monophonic synthesizers. Any extensions of this class\nshould follow the API and implement the methods below in order to \nremain compatible with p5.PolySynth();

    \n", + "is_constructor": 1 + }, + "p5.MonoSynth": { + "name": "p5.MonoSynth", + "shortname": "p5.MonoSynth", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 12073, + "description": "

    A MonoSynth is used as a single voice for sound synthesis.\nThis is a class to be used in conjunction with the PolySynth\nclass. Custom synthetisers should be built inheriting from\nthis class.

    \n", + "is_constructor": 1, + "example": [ + "\n
    \nvar monoSynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n monoSynth = new p5.MonoSynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // time from now (in seconds)\n var time = 0;\n // note duration (in seconds)\n var dur = 0.25;\n // velocity (volume, from 0 to 1)\n var v = 0.2;\n\n monoSynth.play(\"G3\", v, time, dur);\n monoSynth.play(\"C4\", v, time += dur, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n
    " + ] + }, + "p5.PolySynth": { + "name": "p5.PolySynth", + "shortname": "p5.PolySynth", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 12362, + "description": "

    An AudioVoice is used as a single voice for sound synthesis.\nThe PolySynth class holds an array of AudioVoice, and deals\nwith voices allocations, with setting notes to be played, and\nparameters to be set.

    \n", + "is_constructor": 1, + "params": [ + { + "name": "synthVoice", + "description": "

    A monophonic synth voice inheriting\n the AudioVoice class. Defaults to p5.MonoSynth

    \n", + "type": "Number", + "optional": true + }, + { + "name": "maxVoices", + "description": "

    Number of voices, defaults to 8;

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar polySynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n polySynth = new p5.PolySynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // note duration (in seconds)\n var dur = 1.5;\n\n // time from now (in seconds)\n var time = 0;\n\n // velocity (volume, from 0 to 1)\n var vel = 0.1;\n\n // notes can overlap with each other\n polySynth.play(\"G2\", vel, 0, dur);\n polySynth.play(\"C3\", vel, time += 1/3, dur);\n polySynth.play(\"G3\", vel, time += 1/3, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n
    " + ] + }, + "p5.Distortion": { + "name": "p5.Distortion", + "shortname": "p5.Distortion", + "classitems": [], + "plugins": [], + "extensions": [], + "plugin_for": [], + "extension_for": [], + "module": "p5.sound", + "submodule": "p5.sound", + "namespace": "", + "file": "lib/addons/p5.sound.js", + "line": 12767, + "description": "

    A Distortion effect created with a Waveshaper Node,\nwith an approach adapted from\nKevin Ennis

    \n

    This class extends p5.Effect.
    Methods amp(), chain(), \ndrywet(), connect(), and \ndisconnect() are available.

    \n", + "extends": "p5.Effect", + "is_constructor": 1, + "params": [ + { + "name": "amount", + "description": "

    Unbounded distortion amount.\n Normal values range from 0-1.

    \n", + "type": "Number", + "optional": true, + "optdefault": "0.25" + }, + { + "name": "oversample", + "description": "

    'none', '2x', or '4x'.

    \n", + "type": "String", + "optional": true, + "optdefault": "'none'" + } + ] + } + }, + "elements": {}, + "classitems": [ + { + "file": "src/color/color_conversion.js", + "line": 10, + "description": "

    Conversions adapted from http://www.easyrgb.com/en/math.php.

    \n

    In these functions, hue is always in the range [0, 1], just like all other\ncomponents are in the range [0, 1]. 'Brightness' and 'value' are used\ninterchangeably.

    \n", + "class": "p5", + "module": "Color", + "submodule": "Color Conversion" + }, + { + "file": "src/color/color_conversion.js", + "line": 21, + "description": "

    Convert an HSBA array to HSLA.

    \n", + "class": "p5", + "module": "Color", + "submodule": "Color Conversion" + }, + { + "file": "src/color/color_conversion.js", + "line": 47, + "description": "

    Convert an HSBA array to RGBA.

    \n", + "class": "p5", + "module": "Color", + "submodule": "Color Conversion" + }, + { + "file": "src/color/color_conversion.js", + "line": 102, + "description": "

    Convert an HSLA array to HSBA.

    \n", + "class": "p5", + "module": "Color", + "submodule": "Color Conversion" + }, + { + "file": "src/color/color_conversion.js", + "line": 125, + "description": "

    Convert an HSLA array to RGBA.

    \n

    We need to change basis from HSLA to something that can be more easily be\nprojected onto RGBA. We will choose hue and brightness as our first two\ncomponents, and pick a convenient third one ('zest') so that we don't need\nto calculate formal HSBA saturation.

    \n", + "class": "p5", + "module": "Color", + "submodule": "Color Conversion" + }, + { + "file": "src/color/color_conversion.js", + "line": 189, + "description": "

    Convert an RGBA array to HSBA.

    \n", + "class": "p5", + "module": "Color", + "submodule": "Color Conversion" + }, + { + "file": "src/color/color_conversion.js", + "line": 228, + "description": "

    Convert an RGBA array to HSLA.

    \n", + "class": "p5", + "module": "Color", + "submodule": "Color Conversion" + }, + { + "file": "src/color/creating_reading.js", + "line": 16, + "description": "

    Extracts the alpha value from a color or pixel array.

    \n", + "itemtype": "method", + "name": "alpha", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the alpha value", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoStroke();\nlet c = color(0, 126, 255, 102);\nfill(c);\nrect(15, 15, 35, 70);\nlet value = alpha(c); // Sets 'value' to 102\nfill(value);\nrect(50, 15, 35, 70);\n\n
    " + ], + "alt": "Left half of canvas light blue and right half light charcoal grey.\nLeft half of canvas light purple and right half a royal blue.\nLeft half of canvas salmon pink and the right half white.\nYellow rect in middle right of canvas, with 55 pixel width and height.\nYellow ellipse in top left canvas, black ellipse in bottom right,both 80x80.\nBright fuchsia rect in middle of canvas, 60 pixel width and height.\nTwo bright green rects on opposite sides of the canvas, both 45x80.\nFour blue rects in each corner of the canvas, each are 35x35.\nBright sea green rect on left and darker rect on right of canvas, both 45x80.\nDark green rect on left and light green rect on right of canvas, both 45x80.\nDark blue rect on left and light teal rect on right of canvas, both 45x80.\nblue rect on left and green on right, both with black outlines & 35x60.\nsalmon pink rect on left and black on right, both 35x60.\n4 rects, tan, brown, brownish purple and purple, with white outlines & 20x60.\nlight pastel green rect on left and dark grey rect on right, both 35x60.\nyellow rect on left and red rect on right, both with black outlines & 35x60.\ngrey canvas\ndeep pink rect on left and grey rect on right, both 35x60.", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 61, + "description": "

    Extracts the blue value from a color or pixel array.

    \n", + "itemtype": "method", + "name": "blue", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the blue value", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet c = color(175, 100, 220); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nlet blueValue = blue(c); // Get blue in 'c'\nprint(blueValue); // Prints \"220.0\"\nfill(0, 0, blueValue); // Use 'blueValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n
    " + ], + "alt": "Left half of canvas light purple and right half a royal blue.", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 91, + "description": "

    Extracts the HSB brightness value from a color or pixel array.

    \n", + "itemtype": "method", + "name": "brightness", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the brightness value", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoStroke();\ncolorMode(HSB, 255);\nlet c = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nlet value = brightness(c); // Sets 'value' to 255\nfill(value);\nrect(50, 20, 35, 60);\n\n
    \n
    \n\nnoStroke();\ncolorMode(HSB, 255);\nlet c = color('hsb(60, 100%, 50%)');\nfill(c);\nrect(15, 20, 35, 60);\nlet value = brightness(c); // A 'value' of 50% is 127.5\nfill(value);\nrect(50, 20, 35, 60);\n\n
    " + ], + "alt": "Left half of canvas salmon pink and the right half white.\nLeft half of canvas yellow at half brightness and the right gray .", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 134, + "description": "

    Creates colors for storing in variables of the color datatype. The\nparameters are interpreted as RGB or HSB values depending on the\ncurrent colorMode(). The default mode is RGB values from 0 to 255\nand, therefore, the function call color(255, 204, 0) will return a\nbright yellow color.\n

    \nNote that if only one value is provided to color(), it will be interpreted\nas a grayscale value. Add a second value, and it will be used for alpha\ntransparency. When three values are specified, they are interpreted as\neither RGB or HSB values. Adding a fourth value applies alpha\ntransparency.\n

    \nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.

    \n", + "itemtype": "method", + "name": "color", + "return": { + "description": "resulting color", + "type": "p5.Color" + }, + "example": [ + "\n
    \n\nlet c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(30, 20, 55, 55); // Draw rectangle\n\n
    \n\n
    \n\nlet c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nellipse(25, 25, 80, 80); // Draw left circle\n\n// Using only one value with color()\n// generates a grayscale value.\nc = color(65); // Update 'c' with grayscale value\nfill(c); // Use updated 'c' as fill color\nellipse(75, 75, 80, 80); // Draw right circle\n\n
    \n\n
    \n\n// Named SVG & CSS colors may be used,\nlet c = color('magenta');\nfill(c); // Use 'c' as fill color\nnoStroke(); // Don't draw a stroke around shapes\nrect(20, 20, 60, 60); // Draw rectangle\n\n
    \n\n
    \n\n// as can hex color codes:\nnoStroke(); // Don't draw a stroke around shapes\nlet c = color('#0f0');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('#00ff00');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n
    \n\n
    \n\n// RGB and RGBA color strings are also supported:\n// these all set to the same color (solid blue)\nlet c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('rgb(0,0,255)');\nfill(c); // Use 'c' as fill color\nrect(10, 10, 35, 35); // Draw rectangle\n\nc = color('rgb(0%, 0%, 100%)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 35, 35); // Draw rectangle\n\nc = color('rgba(0, 0, 255, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(10, 55, 35, 35); // Draw rectangle\n\nc = color('rgba(0%, 0%, 100%, 1)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 55, 35, 35); // Draw rectangle\n\n
    \n\n
    \n\n// HSL color is also supported and can be specified\n// by value\nlet c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsl(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsla(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n
    \n\n
    \n\n// HSB color is also supported and can be specified\n// by value\nlet c;\nnoStroke(); // Don't draw a stroke around shapes\nc = color('hsb(160, 100%, 50%)');\nfill(c); // Use 'c' as fill color\nrect(0, 10, 45, 80); // Draw rectangle\n\nc = color('hsba(160, 100%, 50%, 0.5)');\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw rectangle\n\n
    \n\n
    \n\nlet c; // Declare color 'c'\nnoStroke(); // Don't draw a stroke around shapes\n\n// If no colorMode is specified, then the\n// default of RGB with scale of 0-255 is used.\nc = color(50, 55, 100); // Create a color for 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(0, 10, 45, 80); // Draw left rect\n\ncolorMode(HSB, 100); // Use HSB with scale of 0-100\nc = color(50, 55, 100); // Update 'c' with new color\nfill(c); // Use updated 'c' as fill color\nrect(55, 10, 45, 80); // Draw right rect\n\n
    " + ], + "alt": "Yellow rect in middle right of canvas, with 55 pixel width and height.\nYellow ellipse in top left of canvas, black ellipse in bottom right,both 80x80.\nBright fuchsia rect in middle of canvas, 60 pixel width and height.\nTwo bright green rects on opposite sides of the canvas, both 45x80.\nFour blue rects in each corner of the canvas, each are 35x35.\nBright sea green rect on left and darker rect on right of canvas, both 45x80.\nDark green rect on left and lighter green rect on right of canvas, both 45x80.\nDark blue rect on left and light teal rect on right of canvas, both 45x80.", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading", + "overloads": [ + { + "line": 134, + "params": [ + { + "name": "gray", + "description": "

    number specifying value between white\n and black.

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "

    alpha value relative to current color range\n (default is 0-255)

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "resulting color", + "type": "p5.Color" + } + }, + { + "line": 293, + "params": [ + { + "name": "v1", + "description": "

    red or hue value relative to\n the current color range

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "", + "type": "p5.Color" + } + }, + { + "line": 305, + "params": [ + { + "name": "value", + "description": "

    a color string

    \n", + "type": "String" + } + ], + "return": { + "description": "", + "type": "p5.Color" + } + }, + { + "line": 310, + "params": [ + { + "name": "values", + "description": "

    an array containing the red,green,blue &\n and alpha components of the color

    \n", + "type": "Number[]" + } + ], + "return": { + "description": "", + "type": "p5.Color" + } + }, + { + "line": 316, + "params": [ + { + "name": "color", + "description": "", + "type": "p5.Color" + } + ], + "return": { + "description": "", + "type": "p5.Color" + } + } + ] + }, + { + "file": "src/color/creating_reading.js", + "line": 332, + "description": "

    Extracts the green value from a color or pixel array.

    \n", + "itemtype": "method", + "name": "green", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the green value", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet c = color(20, 75, 200); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nlet greenValue = green(c); // Get green in 'c'\nprint(greenValue); // Print \"75.0\"\nfill(0, greenValue, 0); // Use 'greenValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n
    " + ], + "alt": "blue rect on left and green on right, both with black outlines & 35x60.", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 363, + "description": "

    Extracts the hue value from a color or pixel array.

    \n

    Hue exists in both HSB and HSL. This function will return the\nHSB-normalized hue when supplied with an HSB color object (or when supplied\nwith a pixel array while the color mode is HSB), but will default to the\nHSL-normalized hue otherwise. (The values will only be different if the\nmaximum hue setting for each system is different.)

    \n", + "itemtype": "method", + "name": "hue", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the hue", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoStroke();\ncolorMode(HSB, 255);\nlet c = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nlet value = hue(c); // Sets 'value' to \"0\"\nfill(value);\nrect(50, 20, 35, 60);\n\n
    " + ], + "alt": "salmon pink rect on left and black on right, both 35x60.", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 400, + "description": "

    Blends two colors to find a third color somewhere between them. The amt\nparameter is the amount to interpolate between the two values where 0.0\nequal to the first color, 0.1 is very near the first color, 0.5 is halfway\nin between, etc. An amount below 0 will be treated as 0. Likewise, amounts\nabove 1 will be capped at 1. This is different from the behavior of lerp(),\nbut necessary because otherwise numbers outside the range will produce\nstrange and unexpected colors.\n

    \nThe way that colours are interpolated depends on the current color mode.

    \n", + "itemtype": "method", + "name": "lerpColor", + "params": [ + { + "name": "c1", + "description": "

    interpolate from this color

    \n", + "type": "p5.Color" + }, + { + "name": "c2", + "description": "

    interpolate to this color

    \n", + "type": "p5.Color" + }, + { + "name": "amt", + "description": "

    number between 0 and 1

    \n", + "type": "Number" + } + ], + "return": { + "description": "interpolated color", + "type": "p5.Color" + }, + "example": [ + "\n
    \n\ncolorMode(RGB);\nstroke(255);\nbackground(51);\nlet from = color(218, 165, 32);\nlet to = color(72, 61, 139);\ncolorMode(RGB); // Try changing to HSB.\nlet interA = lerpColor(from, to, 0.33);\nlet interB = lerpColor(from, to, 0.66);\nfill(from);\nrect(10, 20, 20, 60);\nfill(interA);\nrect(30, 20, 20, 60);\nfill(interB);\nrect(50, 20, 20, 60);\nfill(to);\nrect(70, 20, 20, 60);\n\n
    " + ], + "alt": "4 rects one tan, brown, brownish purple, purple, with white outlines & 20x60", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 497, + "description": "

    Extracts the HSL lightness value from a color or pixel array.

    \n", + "itemtype": "method", + "name": "lightness", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the lightness", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoStroke();\ncolorMode(HSL);\nlet c = color(156, 100, 50, 1);\nfill(c);\nrect(15, 20, 35, 60);\nlet value = lightness(c); // Sets 'value' to 50\nfill(value);\nrect(50, 20, 35, 60);\n\n
    " + ], + "alt": "light pastel green rect on left and dark grey rect on right, both 35x60.", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 527, + "description": "

    Extracts the red value from a color or pixel array.

    \n", + "itemtype": "method", + "name": "red", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the red value", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet c = color(255, 204, 0); // Define color 'c'\nfill(c); // Use color variable 'c' as fill color\nrect(15, 20, 35, 60); // Draw left rectangle\n\nlet redValue = red(c); // Get red in 'c'\nprint(redValue); // Print \"255.0\"\nfill(redValue, 0, 0); // Use 'redValue' in new fill\nrect(50, 20, 35, 60); // Draw right rectangle\n\n
    \n\n
    \n\ncolorMode(RGB, 255); // Sets the range for red, green, and blue to 255\nlet c = color(127, 255, 0);\ncolorMode(RGB, 1); // Sets the range for red, green, and blue to 1\nlet myColor = red(c);\nprint(myColor); // 0.4980392156862745\n\n
    " + ], + "alt": "yellow rect on left and red rect on right, both with black outlines and 35x60.\ngrey canvas", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/creating_reading.js", + "line": 567, + "description": "

    Extracts the saturation value from a color or pixel array.

    \n

    Saturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object (or when supplied\nwith a pixel array while the color mode is HSB), but will default to the\nHSL saturation otherwise.

    \n", + "itemtype": "method", + "name": "saturation", + "params": [ + { + "name": "color", + "description": "

    p5.Color object, color components,\n or CSS color

    \n", + "type": "p5.Color|Number[]|String" + } + ], + "return": { + "description": "the saturation value", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoStroke();\ncolorMode(HSB, 255);\nlet c = color(0, 126, 255);\nfill(c);\nrect(15, 20, 35, 60);\nlet value = saturation(c); // Sets 'value' to 126\nfill(value);\nrect(50, 20, 35, 60);\n\n
    " + ], + "alt": "deep pink rect on left and grey rect on right, both 35x60.", + "class": "p5", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 52, + "description": "

    This function returns the color formatted as a string. This can be useful\nfor debugging, or for using p5.js with other libraries.

    \n", + "itemtype": "method", + "name": "toString", + "params": [ + { + "name": "format", + "description": "

    How the color string will be formatted.\nLeaving this empty formats the string as rgba(r, g, b, a).\n'#rgb' '#rgba' '#rrggbb' and '#rrggbbaa' format as hexadecimal color codes.\n'rgb' 'hsb' and 'hsl' return the color formatted in the specified color mode.\n'rgba' 'hsba' and 'hsla' are the same as above but with alpha channels.\n'rgb%' 'hsb%' 'hsl%' 'rgba%' 'hsba%' and 'hsla%' format as percentages.

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "the formatted string", + "type": "String" + }, + "example": [ + "\n
    \n\nlet myColor;\nfunction setup() {\n createCanvas(200, 200);\n stroke(255);\n myColor = color(100, 100, 250);\n fill(myColor);\n}\n\nfunction draw() {\n rotate(HALF_PI);\n text(myColor.toString(), 0, -5);\n text(myColor.toString('#rrggbb'), 0, -30);\n text(myColor.toString('rgba%'), 0, -55);\n}\n\n
    " + ], + "alt": "canvas with text representation of color", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 253, + "itemtype": "method", + "name": "setRed", + "params": [ + { + "name": "red", + "description": "

    the new red value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nlet backgroundColor;\n\nfunction setup() {\n backgroundColor = color(100, 50, 150);\n}\n\nfunction draw() {\n backgroundColor.setRed(128 + 128 * sin(millis() / 1000));\n background(backgroundColor);\n}\n\n
    " + ], + "alt": "canvas with gradually changing background color", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 280, + "itemtype": "method", + "name": "setGreen", + "params": [ + { + "name": "green", + "description": "

    the new green value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nlet backgroundColor;\n\nfunction setup() {\n backgroundColor = color(100, 50, 150);\n}\n\nfunction draw() {\n backgroundColor.setGreen(128 + 128 * sin(millis() / 1000));\n background(backgroundColor);\n}\n\n
    " + ], + "alt": "canvas with gradually changing background color", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 307, + "itemtype": "method", + "name": "setBlue", + "params": [ + { + "name": "blue", + "description": "

    the new blue value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nlet backgroundColor;\n\nfunction setup() {\n backgroundColor = color(100, 50, 150);\n}\n\nfunction draw() {\n backgroundColor.setBlue(128 + 128 * sin(millis() / 1000));\n background(backgroundColor);\n}\n\n
    " + ], + "alt": "canvas with gradually changing background color", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 334, + "itemtype": "method", + "name": "setAlpha", + "params": [ + { + "name": "alpha", + "description": "

    the new alpha value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nlet squareColor;\n\nfunction setup() {\n ellipseMode(CORNERS);\n strokeWeight(4);\n squareColor = color(100, 50, 150);\n}\n\nfunction draw() {\n background(255);\n\n noFill();\n stroke(0);\n ellipse(10, 10, width - 10, height - 10);\n\n squareColor.setAlpha(128 + 128 * sin(millis() / 1000));\n fill(squareColor);\n noStroke();\n rect(13, 13, width - 26, height - 26);\n}\n\n
    " + ], + "alt": "circle behind a square with gradually changing opacity", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 415, + "description": "

    Hue is the same in HSB and HSL, but the maximum value may be different.\nThis function will return the HSB-normalized saturation when supplied with\nan HSB color object, but will default to the HSL-normalized saturation\notherwise.

    \n", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 446, + "description": "

    Saturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object, but will default\nto the HSL saturation otherwise.

    \n", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 465, + "description": "

    CSS named colors.

    \n", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 618, + "description": "

    These regular expressions are used to build up the patterns for matching\nviable CSS color strings: fragmenting the regexes in this way increases the\nlegibility and comprehensibility of the code.

    \n

    Note that RGB values of .9 are not parsed by IE, but are supported here for\ncolor string consistency.

    \n", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 631, + "description": "

    Full color string patterns. The capture groups are necessary.

    \n", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/p5.Color.js", + "line": 994, + "description": "

    For HSB and HSL, interpret the gray level as a brightness/lightness\nvalue (they are equivalent when chroma is zero). For RGB, normalize the\ngray level according to the blue maximum.

    \n", + "class": "p5.Color", + "module": "Color", + "submodule": "Creating & Reading" + }, + { + "file": "src/color/setting.js", + "line": 15, + "description": "

    The background() function sets the color used for the background of the\np5.js canvas. The default background is transparent. This function is\ntypically used within draw() to clear the display window at the beginning\nof each frame, but it can be used inside setup() to set the background on\nthe first frame of animation or if the background need only be set once.\n

    \nThe color is either specified in terms of the RGB, HSB, or HSL color\ndepending on the current colorMode. (The default color space is RGB, with\neach value in the range from 0 to 255). The alpha range by default is also 0 to 255.\n

    \nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n

    \nA p5.Color object can also be provided to set the background color.\n

    \nA p5.Image can also be provided to set the background image.

    \n", + "itemtype": "method", + "name": "background", + "chainable": 1, + "example": [ + "\n
    \n\n// Grayscale integer value\nbackground(51);\n\n
    \n\n
    \n\n// R, G & B integer values\nbackground(255, 204, 0);\n\n
    \n\n
    \n\n// H, S & B integer values\ncolorMode(HSB);\nbackground(255, 204, 100);\n\n
    \n\n
    \n\n// Named SVG/CSS color string\nbackground('red');\n\n
    \n\n
    \n\n// three-digit hexadecimal RGB notation\nbackground('#fae');\n\n
    \n\n
    \n\n// six-digit hexadecimal RGB notation\nbackground('#222222');\n\n
    \n\n
    \n\n// integer RGB notation\nbackground('rgb(0,255,0)');\n\n
    \n\n
    \n\n// integer RGBA notation\nbackground('rgba(0,255,0, 0.25)');\n\n
    \n\n
    \n\n// percentage RGB notation\nbackground('rgb(100%,0%,10%)');\n\n
    \n\n
    \n\n// percentage RGBA notation\nbackground('rgba(100%,0%,100%,0.5)');\n\n
    \n\n
    \n\n// p5 Color object\nbackground(color(0, 0, 255));\n\n
    " + ], + "alt": "canvas with darkest charcoal grey background.\ncanvas with yellow background.\ncanvas with royal blue background.\ncanvas with red background.\ncanvas with pink background.\ncanvas with black background.\ncanvas with bright green background.\ncanvas with soft green background.\ncanvas with red background.\ncanvas with light purple background.\ncanvas with blue background.", + "class": "p5", + "module": "Color", + "submodule": "Setting", + "overloads": [ + { + "line": 15, + "params": [ + { + "name": "color", + "description": "

    any value created by the color() function

    \n", + "type": "p5.Color" + } + ], + "chainable": 1 + }, + { + "line": 131, + "params": [ + { + "name": "colorstring", + "description": "

    color string, possible formats include: integer\n rgb() or rgba(), percentage rgb() or rgba(),\n 3-digit hex, 6-digit hex

    \n", + "type": "String" + }, + { + "name": "a", + "description": "

    opacity of the background relative to current\n color range (default is 0-255)

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 141, + "params": [ + { + "name": "gray", + "description": "

    specifies a value between white and black

    \n", + "type": "Number" + }, + { + "name": "a", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 148, + "params": [ + { + "name": "v1", + "description": "

    red or hue value (depending on the current color\n mode)

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value (depending on the current\n color mode)

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value (depending on the current\n color mode)

    \n", + "type": "Number" + }, + { + "name": "a", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 160, + "params": [ + { + "name": "values", + "description": "

    an array containing the red, green, blue\n and alpha components of the color

    \n", + "type": "Number[]" + } + ], + "chainable": 1 + }, + { + "line": 167, + "params": [ + { + "name": "image", + "description": "

    image created with loadImage() or createImage(),\n to set as background\n (must be same size as the sketch window)

    \n", + "type": "p5.Image" + }, + { + "name": "a", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/color/setting.js", + "line": 181, + "description": "

    Clears the pixels within a buffer. This function only clears the canvas.\nIt will not clear objects created by createX() methods such as\ncreateVideo() or createDiv().\nUnlike the main graphics context, pixels in additional graphics areas created\nwith createGraphics() can be entirely\nor partially transparent. This function clears everything to make all of\nthe pixels 100% transparent.

    \n", + "itemtype": "method", + "name": "clear", + "chainable": 1, + "example": [ + "\n
    \n\n// Clear the screen on mouse press.\nfunction setup() {\n createCanvas(100, 100);\n}\n\nfunction draw() {\n ellipse(mouseX, mouseY, 20, 20);\n}\n\nfunction mousePressed() {\n clear();\n}\n\n
    " + ], + "alt": "20x20 white ellipses are continually drawn at mouse x and y coordinates.", + "class": "p5", + "module": "Color", + "submodule": "Setting" + }, + { + "file": "src/color/setting.js", + "line": 220, + "description": "

    colorMode() changes the way p5.js interprets color data. By default, the\nparameters for fill(), stroke(), background(), and color() are defined by\nvalues between 0 and 255 using the RGB color model. This is equivalent to\nsetting colorMode(RGB, 255). Setting colorMode(HSB) lets you use the HSB\nsystem instead. By default, this is colorMode(HSB, 360, 100, 100, 1). You\ncan also use HSL.\n

    \nNote: existing color objects remember the mode that they were created in,\nso you can change modes as you like without affecting their appearance.

    \n", + "itemtype": "method", + "name": "colorMode", + "chainable": 1, + "example": [ + "\n
    \n\nnoStroke();\ncolorMode(RGB, 100);\nfor (let i = 0; i < 100; i++) {\n for (let j = 0; j < 100; j++) {\n stroke(i, j, 0);\n point(i, j);\n }\n}\n\n
    \n\n
    \n\nnoStroke();\ncolorMode(HSB, 100);\nfor (let i = 0; i < 100; i++) {\n for (let j = 0; j < 100; j++) {\n stroke(i, j, 100);\n point(i, j);\n }\n}\n\n
    \n\n
    \n\ncolorMode(RGB, 255);\nlet c = color(127, 255, 0);\n\ncolorMode(RGB, 1);\nlet myColor = c._getRed();\ntext(myColor, 10, 10, 80, 80);\n\n
    \n\n
    \n\nnoFill();\ncolorMode(RGB, 255, 255, 255, 1);\nbackground(255);\n\nstrokeWeight(4);\nstroke(255, 0, 10, 0.3);\nellipse(40, 40, 50, 50);\nellipse(50, 50, 40, 40);\n\n
    " + ], + "alt": "Green to red gradient from bottom L to top R. shading originates from top left.\nRainbow gradient from left to right. Brightness increasing to white at top.\nunknown image.\n50x50 ellipse at middle L & 40x40 ellipse at center. Translucent pink outlines.", + "class": "p5", + "module": "Color", + "submodule": "Setting", + "overloads": [ + { + "line": 220, + "params": [ + { + "name": "mode", + "description": "

    either RGB, HSB or HSL, corresponding to\n Red/Green/Blue and Hue/Saturation/Brightness\n (or Lightness)

    \n", + "type": "Constant" + }, + { + "name": "max", + "description": "

    range for all values

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 297, + "params": [ + { + "name": "mode", + "description": "", + "type": "Constant" + }, + { + "name": "max1", + "description": "

    range for the red or hue depending on the\n current color mode

    \n", + "type": "Number" + }, + { + "name": "max2", + "description": "

    range for the green or saturation depending\n on the current color mode

    \n", + "type": "Number" + }, + { + "name": "max3", + "description": "

    range for the blue or brightness/lightness\n depending on the current color mode

    \n", + "type": "Number" + }, + { + "name": "maxA", + "description": "

    range for the alpha

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/color/setting.js", + "line": 341, + "description": "

    Sets the color used to fill shapes. For example, if you run\nfill(204, 102, 0), all subsequent shapes will be filled with orange. This\ncolor is either specified in terms of the RGB or HSB color depending on\nthe current colorMode(). (The default color space is RGB, with each value\nin the range from 0 to 255). The alpha range by default is also 0 to 255.\n

    \nIf a single string argument is provided, RGB, RGBA and Hex CSS color strings\nand all named color strings are supported. In this case, an alpha number\nvalue as a second argument is not supported, the RGBA form should be used.\n

    \nA p5 Color object can also be provided to set the fill color.

    \n", + "itemtype": "method", + "name": "fill", + "chainable": 1, + "example": [ + "\n
    \n\n// Grayscale integer value\nfill(51);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// R, G & B integer values\nfill(255, 204, 0);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// H, S & B integer values\ncolorMode(HSB);\nfill(255, 204, 100);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// Named SVG/CSS color string\nfill('red');\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// three-digit hexadecimal RGB notation\nfill('#fae');\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// six-digit hexadecimal RGB notation\nfill('#222222');\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// integer RGB notation\nfill('rgb(0,255,0)');\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// integer RGBA notation\nfill('rgba(0,255,0, 0.25)');\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// percentage RGB notation\nfill('rgb(100%,0%,10%)');\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// percentage RGBA notation\nfill('rgba(100%,0%,100%,0.5)');\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// p5 Color object\nfill(color(0, 0, 255));\nrect(20, 20, 60, 60);\n\n
    " + ], + "alt": "60x60 dark charcoal grey rect with black outline in center of canvas.\n60x60 yellow rect with black outline in center of canvas.\n60x60 royal blue rect with black outline in center of canvas.\n60x60 red rect with black outline in center of canvas.\n60x60 pink rect with black outline in center of canvas.\n60x60 black rect with black outline in center of canvas.\n60x60 light green rect with black outline in center of canvas.\n60x60 soft green rect with black outline in center of canvas.\n60x60 red rect with black outline in center of canvas.\n60x60 dark fuchsia rect with black outline in center of canvas.\n60x60 blue rect with black outline in center of canvas.", + "class": "p5", + "module": "Color", + "submodule": "Setting", + "overloads": [ + { + "line": 341, + "params": [ + { + "name": "v1", + "description": "

    red or hue value relative to\n the current color range

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 466, + "params": [ + { + "name": "value", + "description": "

    a color string

    \n", + "type": "String" + } + ], + "chainable": 1 + }, + { + "line": 472, + "params": [ + { + "name": "gray", + "description": "

    a gray value

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 479, + "params": [ + { + "name": "values", + "description": "

    an array containing the red,green,blue &\n and alpha components of the color

    \n", + "type": "Number[]" + } + ], + "chainable": 1 + }, + { + "line": 486, + "params": [ + { + "name": "color", + "description": "

    the fill color

    \n", + "type": "p5.Color" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/color/setting.js", + "line": 498, + "description": "

    Disables filling geometry. If both noStroke() and noFill() are called,\nnothing will be drawn to the screen.

    \n", + "itemtype": "method", + "name": "noFill", + "chainable": 1, + "example": [ + "\n
    \n\nrect(15, 10, 55, 55);\nnoFill();\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n noFill();\n stroke(100, 100, 240);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(45, 45, 45);\n}\n\n
    " + ], + "alt": "white rect top middle and noFill rect center. Both 60x60 with black outlines.\nblack canvas with purple cube wireframe spinning", + "class": "p5", + "module": "Color", + "submodule": "Setting" + }, + { + "file": "src/color/setting.js", + "line": 539, + "description": "

    Disables drawing the stroke (outline). If both noStroke() and noFill()\nare called, nothing will be drawn to the screen.

    \n", + "itemtype": "method", + "name": "noStroke", + "chainable": 1, + "example": [ + "\n
    \n\nnoStroke();\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n noStroke();\n fill(240, 150, 150);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(45, 45, 45);\n}\n\n
    " + ], + "alt": "60x60 white rect at center. no outline.\nblack canvas with pink cube spinning", + "class": "p5", + "module": "Color", + "submodule": "Setting" + }, + { + "file": "src/color/setting.js", + "line": 579, + "description": "

    Sets the color used to draw lines and borders around shapes. This color\nis either specified in terms of the RGB or HSB color depending on the\ncurrent colorMode() (the default color space is RGB, with each value in\nthe range from 0 to 255). The alpha range by default is also 0 to 255.\n

    \nIf a single string argument is provided, RGB, RGBA and Hex CSS color\nstrings and all named color strings are supported. In this case, an alpha\nnumber value as a second argument is not supported, the RGBA form should be\nused.\n

    \nA p5 Color object can also be provided to set the stroke color.

    \n", + "itemtype": "method", + "name": "stroke", + "chainable": 1, + "example": [ + "\n
    \n\n// Grayscale integer value\nstrokeWeight(4);\nstroke(51);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// R, G & B integer values\nstroke(255, 204, 0);\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// H, S & B integer values\ncolorMode(HSB);\nstrokeWeight(4);\nstroke(255, 204, 100);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// Named SVG/CSS color string\nstroke('red');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// three-digit hexadecimal RGB notation\nstroke('#fae');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// six-digit hexadecimal RGB notation\nstroke('#222222');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// integer RGB notation\nstroke('rgb(0,255,0)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// integer RGBA notation\nstroke('rgba(0,255,0,0.25)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// percentage RGB notation\nstroke('rgb(100%,0%,10%)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// percentage RGBA notation\nstroke('rgba(100%,0%,100%,0.5)');\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    \n\n
    \n\n// p5 Color object\nstroke(color(0, 0, 255));\nstrokeWeight(4);\nrect(20, 20, 60, 60);\n\n
    " + ], + "alt": "60x60 white rect at center. Dark charcoal grey outline.\n60x60 white rect at center. Yellow outline.\n60x60 white rect at center. Royal blue outline.\n60x60 white rect at center. Red outline.\n60x60 white rect at center. Pink outline.\n60x60 white rect at center. Black outline.\n60x60 white rect at center. Bright green outline.\n60x60 white rect at center. Soft green outline.\n60x60 white rect at center. Red outline.\n60x60 white rect at center. Dark fuchsia outline.\n60x60 white rect at center. Blue outline.", + "class": "p5", + "module": "Color", + "submodule": "Setting", + "overloads": [ + { + "line": 579, + "params": [ + { + "name": "v1", + "description": "

    red or hue value relative to\n the current color range

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 718, + "params": [ + { + "name": "value", + "description": "

    a color string

    \n", + "type": "String" + } + ], + "chainable": 1 + }, + { + "line": 724, + "params": [ + { + "name": "gray", + "description": "

    a gray value

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 731, + "params": [ + { + "name": "values", + "description": "

    an array containing the red,green,blue &\n and alpha components of the color

    \n", + "type": "Number[]" + } + ], + "chainable": 1 + }, + { + "line": 738, + "params": [ + { + "name": "color", + "description": "

    the stroke color

    \n", + "type": "p5.Color" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 16, + "description": "

    This function does 3 things:

    \n
      \n

    1. Bounds the desired start/stop angles for an arc (in radians) so that:

      \n
      0 <= start < TWO_PI ;    start <= stop < start + TWO_PI\n

      This means that the arc rendering functions don't have to be concerned\nwith what happens if stop is smaller than start, or if the arc 'goes\nround more than once', etc.: they can just start at start and increase\nuntil stop and the correct arc will be drawn.

      \n
      2. \n

    2. Optionally adjusts the angles within each quadrant to counter the naive\nscaling of the underlying ellipse up from the unit circle. Without\nthis, the angles become arbitrary when width != height: 45 degrees\nmight be drawn at 5 degrees on a 'wide' ellipse, or at 85 degrees on\na 'tall' ellipse.

      \n
      3. \n

    3. Flags up when start and stop correspond to the same place on the\nunderlying ellipse. This is useful if you want to do something special\nthere (like rendering a whole ellipse instead).

      \n
      4. \n
    \n", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives" + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 102, + "description": "

    Draw an arc to the screen. If called with only x, y, w, h, start, and\nstop, the arc will be drawn and filled as an open pie segment. If a mode parameter is provided, the arc\nwill be filled like an open semi-circle (OPEN) , a closed semi-circle (CHORD), or as a closed pie segment (PIE). The\norigin may be changed with the ellipseMode() function.

    \nThe arc is always drawn clockwise from wherever start falls to wherever stop falls on the ellipse.\nAdding or subtracting TWO_PI to either angle does not change where they fall.\nIf both start and stop fall at the same place, a full ellipse will be drawn.

    \n", + "itemtype": "method", + "name": "arc", + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the arc's ellipse

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the arc's ellipse

    \n", + "type": "Number" + }, + { + "name": "w", + "description": "

    width of the arc's ellipse by default

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height of the arc's ellipse by default

    \n", + "type": "Number" + }, + { + "name": "start", + "description": "

    angle to start the arc, specified in radians

    \n", + "type": "Number" + }, + { + "name": "stop", + "description": "

    angle to stop the arc, specified in radians

    \n", + "type": "Number" + }, + { + "name": "mode", + "description": "

    optional parameter to determine the way of drawing\n the arc. either CHORD, PIE or OPEN

    \n", + "type": "Constant", + "optional": true + }, + { + "name": "detail", + "description": "

    optional parameter for WebGL mode only. This is to\n specify the number of vertices that makes up the\n perimeter of the arc. Default value is 25.

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\narc(50, 55, 50, 50, 0, HALF_PI);\nnoFill();\narc(50, 55, 60, 60, HALF_PI, PI);\narc(50, 55, 70, 70, PI, PI + QUARTER_PI);\narc(50, 55, 80, 80, PI + QUARTER_PI, TWO_PI);\n\n
    \n\n
    \n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI);\n\n
    \n\n
    \n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI, OPEN);\n\n
    \n\n
    \n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI, CHORD);\n\n
    \n\n
    \n\narc(50, 50, 80, 80, 0, PI + QUARTER_PI, PIE);\n\n
    " + ], + "alt": "shattered outline of an ellipse with a quarter of a white circle bottom-right.\nwhite ellipse with top right quarter missing.\nwhite ellipse with black outline with top right missing.\nwhite ellipse with top right missing with black outline around shape.\nwhite ellipse with top right quarter missing with black outline around the shape.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives" + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 210, + "description": "

    Draws an ellipse (oval) to the screen. An ellipse with equal width and\nheight is a circle. By default, the first two parameters set the location,\nand the third and fourth parameters set the shape's width and height. If\nno height is specified, the value of width is used for both the width and\nheight. If a negative height or width is specified, the absolute value is taken.\nThe origin may be changed with the ellipseMode() function.

    \n", + "itemtype": "method", + "name": "ellipse", + "chainable": 1, + "example": [ + "\n
    \n\nellipse(56, 46, 55, 55);\n\n
    " + ], + "alt": "white ellipse with black outline in middle-right of canvas that is 55x55.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives", + "overloads": [ + { + "line": 210, + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the ellipse.

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the ellipse.

    \n", + "type": "Number" + }, + { + "name": "w", + "description": "

    width of the ellipse.

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height of the ellipse.

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 235, + "params": [ + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + }, + { + "name": "w", + "description": "", + "type": "Number" + }, + { + "name": "h", + "description": "", + "type": "Number" + }, + { + "name": "detail", + "description": "

    number of radial sectors to draw (for WebGL mode)

    \n", + "type": "Integer" + } + ] + } + ] + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 270, + "description": "

    Draws a circle to the screen. A circle is a simple closed shape.\nIt is the set of all points in a plane that are at a given distance from a given point, the centre.\nThis function is a special case of the ellipse() function, where the width and height of the ellipse are the same.\nHeight and width of the ellipse correspond to the diameter of the circle.\nBy default, the first two parameters set the location of the centre of the circle, the third sets the diameter of the circle.

    \n", + "itemtype": "method", + "name": "circle", + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the centre of the circle.

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the centre of the circle.

    \n", + "type": "Number" + }, + { + "name": "d", + "description": "

    diameter of the circle.

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// Draw a circle at location (30, 30) with a diameter of 20.\ncircle(30, 30, 20);\n\n
    " + ], + "alt": "white circle with black outline in mid of canvas that is 55x55.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives" + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 300, + "description": "

    Draws a line (a direct path between two points) to the screen. The version\nof line() with four parameters draws the line in 2D. To color a line, use\nthe stroke() function. A line cannot be filled, therefore the fill()\nfunction will not affect the color of a line. 2D lines are drawn with a\nwidth of one pixel by default, but this can be changed with the\nstrokeWeight() function.

    \n", + "itemtype": "method", + "name": "line", + "chainable": 1, + "example": [ + "\n
    \n\nline(30, 20, 85, 75);\n\n
    \n\n
    \n\nline(30, 20, 85, 20);\nstroke(126);\nline(85, 20, 85, 75);\nstroke(255);\nline(85, 75, 30, 75);\n\n
    " + ], + "alt": "line 78 pixels long running from mid-top to bottom-right of canvas.\n3 lines of various stroke sizes. Form top, bottom and right sides of a square.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives", + "overloads": [ + { + "line": 300, + "params": [ + { + "name": "x1", + "description": "

    the x-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "y1", + "description": "

    the y-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "

    the x-coordinate of the second point

    \n", + "type": "Number" + }, + { + "name": "y2", + "description": "

    the y-coordinate of the second point

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 336, + "params": [ + { + "name": "x1", + "description": "", + "type": "Number" + }, + { + "name": "y1", + "description": "", + "type": "Number" + }, + { + "name": "z1", + "description": "

    the z-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "", + "type": "Number" + }, + { + "name": "y2", + "description": "", + "type": "Number" + }, + { + "name": "z2", + "description": "

    the z-coordinate of the second point

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 356, + "description": "

    Draws a point, a coordinate in space at the dimension of one pixel.\nThe first parameter is the horizontal value for the point, the second\nvalue is the vertical value for the point. The color of the point is\ndetermined by the current stroke.

    \n", + "itemtype": "method", + "name": "point", + "params": [ + { + "name": "x", + "description": "

    the x-coordinate

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    the y-coordinate

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    the z-coordinate (for WebGL mode)

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\npoint(30, 20);\npoint(85, 20);\npoint(85, 75);\npoint(30, 75);\n\n
    " + ], + "alt": "4 points centered in the middle-right of the canvas.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives" + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 391, + "description": "

    Draw a quad. A quad is a quadrilateral, a four sided polygon. It is\nsimilar to a rectangle, but the angles between its edges are not\nconstrained to ninety degrees. The first pair of parameters (x1,y1)\nsets the first vertex and the subsequent pairs should proceed\nclockwise or counter-clockwise around the defined shape.\nz-arguments only work when quad() is used in WEBGL mode.

    \n", + "itemtype": "method", + "name": "quad", + "chainable": 1, + "example": [ + "\n
    \n\nquad(38, 31, 86, 20, 69, 63, 30, 76);\n\n
    " + ], + "alt": "irregular white quadrilateral shape with black outline mid-right of canvas.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives", + "overloads": [ + { + "line": 391, + "params": [ + { + "name": "x1", + "description": "

    the x-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "y1", + "description": "

    the y-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "

    the x-coordinate of the second point

    \n", + "type": "Number" + }, + { + "name": "y2", + "description": "

    the y-coordinate of the second point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "

    the x-coordinate of the third point

    \n", + "type": "Number" + }, + { + "name": "y3", + "description": "

    the y-coordinate of the third point

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "

    the x-coordinate of the fourth point

    \n", + "type": "Number" + }, + { + "name": "y4", + "description": "

    the y-coordinate of the fourth point

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 421, + "params": [ + { + "name": "x1", + "description": "", + "type": "Number" + }, + { + "name": "y1", + "description": "", + "type": "Number" + }, + { + "name": "z1", + "description": "

    the z-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "", + "type": "Number" + }, + { + "name": "y2", + "description": "", + "type": "Number" + }, + { + "name": "z2", + "description": "

    the z-coordinate of the second point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "", + "type": "Number" + }, + { + "name": "y3", + "description": "", + "type": "Number" + }, + { + "name": "z3", + "description": "

    the z-coordinate of the third point

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "", + "type": "Number" + }, + { + "name": "y4", + "description": "", + "type": "Number" + }, + { + "name": "z4", + "description": "

    the z-coordinate of the fourth point

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 458, + "description": "

    Draws a rectangle to the screen. A rectangle is a four-sided shape with\nevery angle at ninety degrees. By default, the first two parameters set\nthe location of the upper-left corner, the third sets the width, and the\nfourth sets the height. The way these parameters are interpreted, however,\nmay be changed with the rectMode() function.\n

    \nThe fifth, sixth, seventh and eighth parameters, if specified,\ndetermine corner radius for the top-left, top-right, lower-right and\nlower-left corners, respectively. An omitted corner radius parameter is set\nto the value of the previously specified radius value in the parameter list.

    \n", + "itemtype": "method", + "name": "rect", + "chainable": 1, + "example": [ + "\n
    \n\n// Draw a rectangle at location (30, 20) with a width and height of 55.\nrect(30, 20, 55, 55);\n\n
    \n\n
    \n\n// Draw a rectangle with rounded corners, each having a radius of 20.\nrect(30, 20, 55, 55, 20);\n\n
    \n\n
    \n\n// Draw a rectangle with rounded corners having the following radii:\n// top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5.\nrect(30, 20, 55, 55, 20, 15, 10, 5);\n\n
    " + ], + "alt": "55x55 white rect with black outline in mid-right of canvas.\n55x55 white rect with black outline and rounded edges in mid-right of canvas.\n55x55 white rect with black outline and rounded edges of different radii.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives", + "overloads": [ + { + "line": 458, + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the rectangle.

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the rectangle.

    \n", + "type": "Number" + }, + { + "name": "w", + "description": "

    width of the rectangle.

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height of the rectangle.

    \n", + "type": "Number" + }, + { + "name": "tl", + "description": "

    optional radius of top-left corner.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "tr", + "description": "

    optional radius of top-right corner.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "br", + "description": "

    optional radius of bottom-right corner.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "bl", + "description": "

    optional radius of bottom-left corner.

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 508, + "params": [ + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + }, + { + "name": "w", + "description": "", + "type": "Number" + }, + { + "name": "h", + "description": "", + "type": "Number" + }, + { + "name": "detailX", + "description": "

    number of segments in the x-direction (for WebGL mode)

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    number of segments in the y-direction (for WebGL mode)

    \n", + "type": "Integer", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 541, + "description": "

    Draws a square to the screen. A square is a four-sided shape with\nevery angle at ninety degrees, and equal side size.\nThis function is a special case of the rect() function, where the width and height are the same, and the parameter is called "s" for side size.\nBy default, the first two parameters set the location of the upper-left corner, the third sets the side size of the square.\nThe way these parameters are interpreted, however,\nmay be changed with the rectMode() function.\n

    \nThe fourth, fifth, sixth and seventh parameters, if specified,\ndetermine corner radius for the top-left, top-right, lower-right and\nlower-left corners, respectively. An omitted corner radius parameter is set\nto the value of the previously specified radius value in the parameter list.

    \n", + "itemtype": "method", + "name": "square", + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the square.

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the square.

    \n", + "type": "Number" + }, + { + "name": "s", + "description": "

    side size of the square.

    \n", + "type": "Number" + }, + { + "name": "tl", + "description": "

    optional radius of top-left corner.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "tr", + "description": "

    optional radius of top-right corner.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "br", + "description": "

    optional radius of bottom-right corner.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "bl", + "description": "

    optional radius of bottom-left corner.

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// Draw a square at location (30, 20) with a side size of 55.\nsquare(30, 20, 55);\n\n
    \n\n
    \n\n// Draw a square with rounded corners, each having a radius of 20.\nsquare(30, 20, 55, 20);\n\n
    \n\n
    \n\n// Draw a square with rounded corners having the following radii:\n// top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5.\nsquare(30, 20, 55, 20, 15, 10, 5);\n\n
    " + ], + "alt": "55x55 white square with black outline in mid-right of canvas.\n55x55 white square with black outline and rounded edges in mid-right of canvas.\n55x55 white square with black outline and rounded edges of different radii.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives" + }, + { + "file": "src/core/shape/2d_primitives.js", + "line": 595, + "description": "

    A triangle is a plane created by connecting three points. The first two\narguments specify the first point, the middle two arguments specify the\nsecond point, and the last two arguments specify the third point.

    \n", + "itemtype": "method", + "name": "triangle", + "params": [ + { + "name": "x1", + "description": "

    x-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "y1", + "description": "

    y-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "

    x-coordinate of the second point

    \n", + "type": "Number" + }, + { + "name": "y2", + "description": "

    y-coordinate of the second point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "

    x-coordinate of the third point

    \n", + "type": "Number" + }, + { + "name": "y3", + "description": "

    y-coordinate of the third point

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\ntriangle(30, 75, 58, 20, 86, 75);\n\n
    " + ], + "alt": "white triangle with black outline in mid-right of canvas.", + "class": "p5", + "module": "Shape", + "submodule": "2D Primitives" + }, + { + "file": "src/core/shape/attributes.js", + "line": 14, + "description": "

    Modifies the location from which ellipses are drawn by changing the way\nin which parameters given to ellipse() are interpreted.\n

    \nThe default mode is ellipseMode(CENTER), which interprets the first two\nparameters of ellipse() as the shape's center point, while the third and\nfourth parameters are its width and height.\n

    \nellipseMode(RADIUS) also uses the first two parameters of ellipse() as\nthe shape's center point, but uses the third and fourth parameters to\nspecify half of the shapes's width and height.\n

    \nellipseMode(CORNER) interprets the first two parameters of ellipse() as\nthe upper-left corner of the shape, while the third and fourth parameters\nare its width and height.\n

    \nellipseMode(CORNERS) interprets the first two parameters of ellipse() as\nthe location of one corner of the ellipse's bounding box, and the third\nand fourth parameters as the location of the opposite corner.\n

    \nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.

    \n", + "itemtype": "method", + "name": "ellipseMode", + "params": [ + { + "name": "mode", + "description": "

    either CENTER, RADIUS, CORNER, or CORNERS

    \n", + "type": "Constant" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nellipseMode(RADIUS); // Set ellipseMode to RADIUS\nfill(255); // Set fill to white\nellipse(50, 50, 30, 30); // Draw white ellipse using RADIUS mode\n\nellipseMode(CENTER); // Set ellipseMode to CENTER\nfill(100); // Set fill to gray\nellipse(50, 50, 30, 30); // Draw gray ellipse using CENTER mode\n\n
    \n\n
    \n\nellipseMode(CORNER); // Set ellipseMode is CORNER\nfill(255); // Set fill to white\nellipse(25, 25, 50, 50); // Draw white ellipse using CORNER mode\n\nellipseMode(CORNERS); // Set ellipseMode to CORNERS\nfill(100); // Set fill to gray\nellipse(25, 25, 50, 50); // Draw gray ellipse using CORNERS mode\n\n
    " + ], + "alt": "60x60 white ellipse and 30x30 grey ellipse with black outlines at center.\n60x60 white ellipse @center and 30x30 grey ellipse top-right, black outlines.", + "class": "p5", + "module": "Shape", + "submodule": "Attributes" + }, + { + "file": "src/core/shape/attributes.js", + "line": 83, + "description": "

    Draws all geometry with jagged (aliased) edges. Note that smooth() is\nactive by default in 2D mode, so it is necessary to call noSmooth() to disable\nsmoothing of geometry, images, and fonts. In 3D mode, noSmooth() is enabled\nby default, so it is necessary to call smooth() if you would like\nsmooth (antialiased) edges on your geometry.

    \n", + "itemtype": "method", + "name": "noSmooth", + "chainable": 1, + "example": [ + "\n
    \n\nbackground(0);\nnoStroke();\nsmooth();\nellipse(30, 48, 36, 36);\nnoSmooth();\nellipse(70, 48, 36, 36);\n\n
    " + ], + "alt": "2 pixelated 36x36 white ellipses to left & right of center, black background", + "class": "p5", + "module": "Shape", + "submodule": "Attributes" + }, + { + "file": "src/core/shape/attributes.js", + "line": 116, + "description": "

    Modifies the location from which rectangles are drawn by changing the way\nin which parameters given to rect() are interpreted.\n

    \nThe default mode is rectMode(CORNER), which interprets the first two\nparameters of rect() as the upper-left corner of the shape, while the\nthird and fourth parameters are its width and height.\n

    \nrectMode(CORNERS) interprets the first two parameters of rect() as the\nlocation of one corner, and the third and fourth parameters as the\nlocation of the opposite corner.\n

    \nrectMode(CENTER) interprets the first two parameters of rect() as the\nshape's center point, while the third and fourth parameters are its\nwidth and height.\n

    \nrectMode(RADIUS) also uses the first two parameters of rect() as the\nshape's center point, but uses the third and fourth parameters to specify\nhalf of the shapes's width and height.\n

    \nThe parameter must be written in ALL CAPS because Javascript is a\ncase-sensitive language.

    \n", + "itemtype": "method", + "name": "rectMode", + "params": [ + { + "name": "mode", + "description": "

    either CORNER, CORNERS, CENTER, or RADIUS

    \n", + "type": "Constant" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nrectMode(CORNER); // Default rectMode is CORNER\nfill(255); // Set fill to white\nrect(25, 25, 50, 50); // Draw white rect using CORNER mode\n\nrectMode(CORNERS); // Set rectMode to CORNERS\nfill(100); // Set fill to gray\nrect(25, 25, 50, 50); // Draw gray rect using CORNERS mode\n\n
    \n\n
    \n\nrectMode(RADIUS); // Set rectMode to RADIUS\nfill(255); // Set fill to white\nrect(50, 50, 30, 30); // Draw white rect using RADIUS mode\n\nrectMode(CENTER); // Set rectMode to CENTER\nfill(100); // Set fill to gray\nrect(50, 50, 30, 30); // Draw gray rect using CENTER mode\n\n
    " + ], + "alt": "50x50 white rect at center and 25x25 grey rect in the top left of the other.\n50x50 white rect at center and 25x25 grey rect in the center of the other.", + "class": "p5", + "module": "Shape", + "submodule": "Attributes" + }, + { + "file": "src/core/shape/attributes.js", + "line": 185, + "description": "

    Draws all geometry with smooth (anti-aliased) edges. smooth() will also\nimprove image quality of resized images. Note that smooth() is active by\ndefault in 2D mode; noSmooth() can be used to disable smoothing of geometry,\nimages, and fonts. In 3D mode, noSmooth() is enabled\nby default, so it is necessary to call smooth() if you would like\nsmooth (antialiased) edges on your geometry.

    \n", + "itemtype": "method", + "name": "smooth", + "chainable": 1, + "example": [ + "\n
    \n\nbackground(0);\nnoStroke();\nsmooth();\nellipse(30, 48, 36, 36);\nnoSmooth();\nellipse(70, 48, 36, 36);\n\n
    " + ], + "alt": "2 pixelated 36x36 white ellipses one left one right of center. On black.", + "class": "p5", + "module": "Shape", + "submodule": "Attributes" + }, + { + "file": "src/core/shape/attributes.js", + "line": 219, + "description": "

    Sets the style for rendering line endings. These ends are either squared,\nextended, or rounded, each of which specified with the corresponding\nparameters: SQUARE, PROJECT, and ROUND. The default cap is ROUND.

    \n", + "itemtype": "method", + "name": "strokeCap", + "params": [ + { + "name": "cap", + "description": "

    either SQUARE, PROJECT, or ROUND

    \n", + "type": "Constant" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nstrokeWeight(12.0);\nstrokeCap(ROUND);\nline(20, 30, 80, 30);\nstrokeCap(SQUARE);\nline(20, 50, 80, 50);\nstrokeCap(PROJECT);\nline(20, 70, 80, 70);\n\n
    " + ], + "alt": "3 lines. Top line: rounded ends, mid: squared, bottom:longer squared ends.", + "class": "p5", + "module": "Shape", + "submodule": "Attributes" + }, + { + "file": "src/core/shape/attributes.js", + "line": 256, + "description": "

    Sets the style of the joints which connect line segments. These joints\nare either mitered, beveled, or rounded and specified with the\ncorresponding parameters MITER, BEVEL, and ROUND. The default joint is\nMITER.

    \n", + "itemtype": "method", + "name": "strokeJoin", + "params": [ + { + "name": "join", + "description": "

    either MITER, BEVEL, ROUND

    \n", + "type": "Constant" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nnoFill();\nstrokeWeight(10.0);\nstrokeJoin(MITER);\nbeginShape();\nvertex(35, 20);\nvertex(65, 50);\nvertex(35, 80);\nendShape();\n\n
    \n\n
    \n\nnoFill();\nstrokeWeight(10.0);\nstrokeJoin(BEVEL);\nbeginShape();\nvertex(35, 20);\nvertex(65, 50);\nvertex(35, 80);\nendShape();\n\n
    \n\n
    \n\nnoFill();\nstrokeWeight(10.0);\nstrokeJoin(ROUND);\nbeginShape();\nvertex(35, 20);\nvertex(65, 50);\nvertex(35, 80);\nendShape();\n\n
    " + ], + "alt": "Right-facing arrowhead shape with pointed tip in center of canvas.\nRight-facing arrowhead shape with flat tip in center of canvas.\nRight-facing arrowhead shape with rounded tip in center of canvas.", + "class": "p5", + "module": "Shape", + "submodule": "Attributes" + }, + { + "file": "src/core/shape/attributes.js", + "line": 323, + "description": "

    Sets the width of the stroke used for lines, points, and the border\naround shapes. All widths are set in units of pixels.

    \n", + "itemtype": "method", + "name": "strokeWeight", + "params": [ + { + "name": "weight", + "description": "

    the weight (in pixels) of the stroke

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nstrokeWeight(1); // Default\nline(20, 20, 80, 20);\nstrokeWeight(4); // Thicker\nline(20, 40, 80, 40);\nstrokeWeight(10); // Beastly\nline(20, 70, 80, 70);\n\n
    " + ], + "alt": "3 horizontal black lines. Top line: thin, mid: medium, bottom:thick.", + "class": "p5", + "module": "Shape", + "submodule": "Attributes" + }, + { + "file": "src/core/shape/curves.js", + "line": 13, + "description": "

    Draws a cubic Bezier curve on the screen. These curves are defined by a\nseries of anchor and control points. The first two parameters specify\nthe first anchor point and the last two parameters specify the other\nanchor point, which become the first and last points on the curve. The\nmiddle parameters specify the two control points which define the shape\nof the curve. Approximately speaking, control points "pull" the curve\ntowards them.

    Bezier curves were developed by French\nautomotive engineer Pierre Bezier, and are commonly used in computer\ngraphics to define gently sloping curves. See also curve().

    \n", + "itemtype": "method", + "name": "bezier", + "chainable": 1, + "example": [ + "\n
    \n\nnoFill();\nstroke(255, 102, 0);\nline(85, 20, 10, 10);\nline(90, 90, 15, 80);\nstroke(0, 0, 0);\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\n\n
    \n\n
    \n\nbackground(0, 0, 0);\nnoFill();\nstroke(255);\nbezier(250, 250, 0, 100, 100, 0, 100, 0, 0, 0, 100, 0);\n\n
    " + ], + "alt": "stretched black s-shape in center with orange lines extending from end points.\nstretched black s-shape with 10 5x5 white ellipses along the shape.\nstretched black s-shape with 7 5x5 ellipses and orange lines along the shape.\nstretched black s-shape with 17 small orange lines extending from under shape.\nhorseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.\nLine shaped like right-facing arrow,points move with mouse-x and warp shape.\nhorizontal line that hooks downward on the right and 13 5x5 ellipses along it.\nright curving line mid-right of canvas with 7 short lines radiating from it.", + "class": "p5", + "module": "Shape", + "submodule": "Curves", + "overloads": [ + { + "line": 13, + "params": [ + { + "name": "x1", + "description": "

    x-coordinate for the first anchor point

    \n", + "type": "Number" + }, + { + "name": "y1", + "description": "

    y-coordinate for the first anchor point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "

    x-coordinate for the first control point

    \n", + "type": "Number" + }, + { + "name": "y2", + "description": "

    y-coordinate for the first control point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "

    x-coordinate for the second control point

    \n", + "type": "Number" + }, + { + "name": "y3", + "description": "

    y-coordinate for the second control point

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "

    x-coordinate for the second anchor point

    \n", + "type": "Number" + }, + { + "name": "y4", + "description": "

    y-coordinate for the second anchor point

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 66, + "params": [ + { + "name": "x1", + "description": "", + "type": "Number" + }, + { + "name": "y1", + "description": "", + "type": "Number" + }, + { + "name": "z1", + "description": "

    z-coordinate for the first anchor point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "", + "type": "Number" + }, + { + "name": "y2", + "description": "", + "type": "Number" + }, + { + "name": "z2", + "description": "

    z-coordinate for the first control point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "", + "type": "Number" + }, + { + "name": "y3", + "description": "", + "type": "Number" + }, + { + "name": "z3", + "description": "

    z-coordinate for the second control point

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "", + "type": "Number" + }, + { + "name": "y4", + "description": "", + "type": "Number" + }, + { + "name": "z4", + "description": "

    z-coordinate for the second anchor point

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/curves.js", + "line": 96, + "description": "

    Sets the resolution at which Beziers display.

    \n

    The default value is 20.

    \n

    This function is only useful when using the WEBGL renderer\nas the default canvas renderer does not use this information.

    \n", + "itemtype": "method", + "name": "bezierDetail", + "params": [ + { + "name": "detail", + "description": "

    resolution of the curves

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n noFill();\n\n bezierDetail(5);\n}\n\nfunction draw() {\n background(200);\n\n bezier(-40, -40, 0,\n 90, -40, 0,\n -90, 40, 0,\n 40, 40, 0);\n}\n\n
    " + ], + "alt": "stretched black s-shape with a low level of bezier detail", + "class": "p5", + "module": "Shape", + "submodule": "Curves" + }, + { + "file": "src/core/shape/curves.js", + "line": 139, + "description": "

    Evaluates the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a bezier curve at t.

    \n", + "itemtype": "method", + "name": "bezierPoint", + "params": [ + { + "name": "a", + "description": "

    coordinate of first point on the curve

    \n", + "type": "Number" + }, + { + "name": "b", + "description": "

    coordinate of first control point

    \n", + "type": "Number" + }, + { + "name": "c", + "description": "

    coordinate of second control point

    \n", + "type": "Number" + }, + { + "name": "d", + "description": "

    coordinate of second point on the curve

    \n", + "type": "Number" + }, + { + "name": "t", + "description": "

    value between 0 and 1

    \n", + "type": "Number" + } + ], + "return": { + "description": "the value of the Bezier at position t", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoFill();\nlet x1 = 85,\n x2 = 10,\n x3 = 90,\n x4 = 15;\nlet y1 = 20,\n y2 = 10,\n y3 = 90,\n y4 = 80;\nbezier(x1, y1, x2, y2, x3, y3, x4, y4);\nfill(255);\nlet steps = 10;\nfor (let i = 0; i <= steps; i++) {\n let t = i / steps;\n let x = bezierPoint(x1, x2, x3, x4, t);\n let y = bezierPoint(y1, y2, y3, y4, t);\n ellipse(x, y, 5, 5);\n}\n\n
    " + ], + "alt": "stretched black s-shape with 17 small orange lines extending from under shape.", + "class": "p5", + "module": "Shape", + "submodule": "Curves" + }, + { + "file": "src/core/shape/curves.js", + "line": 194, + "description": "

    Evaluates the tangent to the Bezier at position t for points a, b, c, d.\nThe parameters a and d are the first and last points\non the curve, and b and c are the control points.\nThe final parameter t varies between 0 and 1.

    \n", + "itemtype": "method", + "name": "bezierTangent", + "params": [ + { + "name": "a", + "description": "

    coordinate of first point on the curve

    \n", + "type": "Number" + }, + { + "name": "b", + "description": "

    coordinate of first control point

    \n", + "type": "Number" + }, + { + "name": "c", + "description": "

    coordinate of second control point

    \n", + "type": "Number" + }, + { + "name": "d", + "description": "

    coordinate of second point on the curve

    \n", + "type": "Number" + }, + { + "name": "t", + "description": "

    value between 0 and 1

    \n", + "type": "Number" + } + ], + "return": { + "description": "the tangent at position t", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nlet steps = 6;\nfill(255);\nfor (let i = 0; i <= steps; i++) {\n let t = i / steps;\n // Get the location of the point\n let x = bezierPoint(85, 10, 90, 15, t);\n let y = bezierPoint(20, 10, 90, 80, t);\n // Get the tangent points\n let tx = bezierTangent(85, 10, 90, 15, t);\n let ty = bezierTangent(20, 10, 90, 80, t);\n // Calculate an angle from the tangent points\n let a = atan2(ty, tx);\n a += PI;\n stroke(255, 102, 0);\n line(x, y, cos(a) * 30 + x, sin(a) * 30 + y);\n // The following line of code makes a line\n // inverse of the above line\n //line(x, y, cos(a)*-30 + x, sin(a)*-30 + y);\n stroke(0);\n ellipse(x, y, 5, 5);\n}\n\n
    \n\n
    \n\nnoFill();\nbezier(85, 20, 10, 10, 90, 90, 15, 80);\nstroke(255, 102, 0);\nlet steps = 16;\nfor (let i = 0; i <= steps; i++) {\n let t = i / steps;\n let x = bezierPoint(85, 10, 90, 15, t);\n let y = bezierPoint(20, 10, 90, 80, t);\n let tx = bezierTangent(85, 10, 90, 15, t);\n let ty = bezierTangent(20, 10, 90, 80, t);\n let a = atan2(ty, tx);\n a -= HALF_PI;\n line(x, y, cos(a) * 8 + x, sin(a) * 8 + y);\n}\n\n
    " + ], + "alt": "s-shaped line with 17 short orange lines extending from underside of shape", + "class": "p5", + "module": "Shape", + "submodule": "Curves" + }, + { + "file": "src/core/shape/curves.js", + "line": 273, + "description": "

    Draws a curved line on the screen between two points, given as the\nmiddle four parameters. The first two parameters are a control point, as\nif the curve came from this point even though it's not drawn. The last\ntwo parameters similarly describe the other control point.

    \nLonger curves can be created by putting a series of curve() functions\ntogether or using curveVertex(). An additional function called\ncurveTightness() provides control for the visual quality of the curve.\nThe curve() function is an implementation of Catmull-Rom splines.

    \n", + "itemtype": "method", + "name": "curve", + "chainable": 1, + "example": [ + "\n
    \n\nnoFill();\nstroke(255, 102, 0);\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\nstroke(0);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nstroke(255, 102, 0);\ncurve(73, 24, 73, 61, 15, 65, 15, 65);\n\n
    \n
    \n\n// Define the curve points as JavaScript objects\nlet p1 = { x: 5, y: 26 },\n p2 = { x: 73, y: 24 };\nlet p3 = { x: 73, y: 61 },\n p4 = { x: 15, y: 65 };\nnoFill();\nstroke(255, 102, 0);\ncurve(p1.x, p1.y, p1.x, p1.y, p2.x, p2.y, p3.x, p3.y);\nstroke(0);\ncurve(p1.x, p1.y, p2.x, p2.y, p3.x, p3.y, p4.x, p4.y);\nstroke(255, 102, 0);\ncurve(p2.x, p2.y, p3.x, p3.y, p4.x, p4.y, p4.x, p4.y);\n\n
    \n
    \n\nnoFill();\nstroke(255, 102, 0);\ncurve(5, 26, 0, 5, 26, 0, 73, 24, 0, 73, 61, 0);\nstroke(0);\ncurve(5, 26, 0, 73, 24, 0, 73, 61, 0, 15, 65, 0);\nstroke(255, 102, 0);\ncurve(73, 24, 0, 73, 61, 0, 15, 65, 0, 15, 65, 0);\n\n
    " + ], + "alt": "horseshoe shape with orange ends facing left and black curved center.\nhorseshoe shape with orange ends facing left and black curved center.\ncurving black and orange lines.", + "class": "p5", + "module": "Shape", + "submodule": "Curves", + "overloads": [ + { + "line": 273, + "params": [ + { + "name": "x1", + "description": "

    x-coordinate for the beginning control point

    \n", + "type": "Number" + }, + { + "name": "y1", + "description": "

    y-coordinate for the beginning control point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "

    x-coordinate for the first point

    \n", + "type": "Number" + }, + { + "name": "y2", + "description": "

    y-coordinate for the first point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "

    x-coordinate for the second point

    \n", + "type": "Number" + }, + { + "name": "y3", + "description": "

    y-coordinate for the second point

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "

    x-coordinate for the ending control point

    \n", + "type": "Number" + }, + { + "name": "y4", + "description": "

    y-coordinate for the ending control point

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 338, + "params": [ + { + "name": "x1", + "description": "", + "type": "Number" + }, + { + "name": "y1", + "description": "", + "type": "Number" + }, + { + "name": "z1", + "description": "

    z-coordinate for the beginning control point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "", + "type": "Number" + }, + { + "name": "y2", + "description": "", + "type": "Number" + }, + { + "name": "z2", + "description": "

    z-coordinate for the first point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "", + "type": "Number" + }, + { + "name": "y3", + "description": "", + "type": "Number" + }, + { + "name": "z3", + "description": "

    z-coordinate for the second point

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "", + "type": "Number" + }, + { + "name": "y4", + "description": "", + "type": "Number" + }, + { + "name": "z4", + "description": "

    z-coordinate for the ending control point

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/curves.js", + "line": 364, + "description": "

    Sets the resolution at which curves display.

    \n

    The default value is 20 while the minimum value is 3.

    \n

    This function is only useful when using the WEBGL renderer\nas the default canvas renderer does not use this\ninformation.

    \n", + "itemtype": "method", + "name": "curveDetail", + "params": [ + { + "name": "resolution", + "description": "

    resolution of the curves

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n\n curveDetail(5);\n}\nfunction draw() {\n background(200);\n\n curve(250, 600, 0, -30, 40, 0, 30, 30, 0, -250, 600, 0);\n}\n\n
    " + ], + "alt": "white arch shape with a low level of curve detail.", + "class": "p5", + "module": "Shape", + "submodule": "Curves" + }, + { + "file": "src/core/shape/curves.js", + "line": 406, + "description": "

    Modifies the quality of forms created with curve() and curveVertex().\nThe parameter tightness determines how the curve fits to the vertex\npoints. The value 0.0 is the default value for tightness (this value\ndefines the curves to be Catmull-Rom splines) and the value 1.0 connects\nall the points with straight lines. Values within the range -5.0 and 5.0\nwill deform the curves but will leave them recognizable and as values\nincrease in magnitude, they will continue to deform.

    \n", + "itemtype": "method", + "name": "curveTightness", + "params": [ + { + "name": "amount", + "description": "

    amount of deformation from the original vertices

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// Move the mouse left and right to see the curve change\n\nfunction setup() {\n createCanvas(100, 100);\n noFill();\n}\n\nfunction draw() {\n background(204);\n let t = map(mouseX, 0, width, -5, 5);\n curveTightness(t);\n beginShape();\n curveVertex(10, 26);\n curveVertex(10, 26);\n curveVertex(83, 24);\n curveVertex(83, 61);\n curveVertex(25, 65);\n curveVertex(25, 65);\n endShape();\n}\n\n
    " + ], + "alt": "Line shaped like right-facing arrow,points move with mouse-x and warp shape.", + "class": "p5", + "module": "Shape", + "submodule": "Curves" + }, + { + "file": "src/core/shape/curves.js", + "line": 453, + "description": "

    Evaluates the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are control points\nof the curve, and b and c are the start and end points of the curve.\nThis can be done once with the x coordinates and a second time\nwith the y coordinates to get the location of a curve at t.

    \n", + "itemtype": "method", + "name": "curvePoint", + "params": [ + { + "name": "a", + "description": "

    coordinate of first control point of the curve

    \n", + "type": "Number" + }, + { + "name": "b", + "description": "

    coordinate of first point

    \n", + "type": "Number" + }, + { + "name": "c", + "description": "

    coordinate of second point

    \n", + "type": "Number" + }, + { + "name": "d", + "description": "

    coordinate of second control point

    \n", + "type": "Number" + }, + { + "name": "t", + "description": "

    value between 0 and 1

    \n", + "type": "Number" + } + ], + "return": { + "description": "bezier value at position t", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoFill();\ncurve(5, 26, 5, 26, 73, 24, 73, 61);\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nfill(255);\nellipseMode(CENTER);\nlet steps = 6;\nfor (let i = 0; i <= steps; i++) {\n let t = i / steps;\n let x = curvePoint(5, 5, 73, 73, t);\n let y = curvePoint(26, 26, 24, 61, t);\n ellipse(x, y, 5, 5);\n x = curvePoint(5, 73, 73, 15, t);\n y = curvePoint(26, 24, 61, 65, t);\n ellipse(x, y, 5, 5);\n}\n\n
    \n\nline hooking down to right-bottom with 13 5x5 white ellipse points" + ], + "class": "p5", + "module": "Shape", + "submodule": "Curves" + }, + { + "file": "src/core/shape/curves.js", + "line": 502, + "description": "

    Evaluates the tangent to the curve at position t for points a, b, c, d.\nThe parameter t varies between 0 and 1, a and d are points on the curve,\nand b and c are the control points.

    \n", + "itemtype": "method", + "name": "curveTangent", + "params": [ + { + "name": "a", + "description": "

    coordinate of first point on the curve

    \n", + "type": "Number" + }, + { + "name": "b", + "description": "

    coordinate of first control point

    \n", + "type": "Number" + }, + { + "name": "c", + "description": "

    coordinate of second control point

    \n", + "type": "Number" + }, + { + "name": "d", + "description": "

    coordinate of second point on the curve

    \n", + "type": "Number" + }, + { + "name": "t", + "description": "

    value between 0 and 1

    \n", + "type": "Number" + } + ], + "return": { + "description": "the tangent at position t", + "type": "Number" + }, + "example": [ + "\n
    \n\nnoFill();\ncurve(5, 26, 73, 24, 73, 61, 15, 65);\nlet steps = 6;\nfor (let i = 0; i <= steps; i++) {\n let t = i / steps;\n let x = curvePoint(5, 73, 73, 15, t);\n let y = curvePoint(26, 24, 61, 65, t);\n //ellipse(x, y, 5, 5);\n let tx = curveTangent(5, 73, 73, 15, t);\n let ty = curveTangent(26, 24, 61, 65, t);\n let a = atan2(ty, tx);\n a -= PI / 2.0;\n line(x, y, cos(a) * 8 + x, sin(a) * 8 + y);\n}\n\n
    " + ], + "alt": "right curving line mid-right of canvas with 7 short lines radiating from it.", + "class": "p5", + "module": "Shape", + "submodule": "Curves" + }, + { + "file": "src/core/shape/vertex.js", + "line": 22, + "description": "

    Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n

    \nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.

    \n", + "itemtype": "method", + "name": "beginContour", + "chainable": 1, + "example": [ + "\n
    \n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n
    " + ], + "alt": "white rect and smaller grey rect with red outlines in center of canvas.", + "class": "p5", + "module": "Shape", + "submodule": "Vertex" + }, + { + "file": "src/core/shape/vertex.js", + "line": 70, + "description": "

    Using the beginShape() and endShape() functions allow creating more\ncomplex forms. beginShape() begins recording vertices for a shape and\nendShape() stops recording. The value of the kind parameter tells it which\ntypes of shapes to create from the provided vertices. With no mode\nspecified, the shape can be any irregular polygon.\n

    \nThe parameters available for beginShape() are POINTS, LINES, TRIANGLES,\nTRIANGLE_FAN, TRIANGLE_STRIP, QUADS, and QUAD_STRIP. After calling the\nbeginShape() function, a series of vertex() commands must follow. To stop\ndrawing the shape, call endShape(). Each shape will be outlined with the\ncurrent stroke color and filled with the fill color.\n

    \nTransformations such as translate(), rotate(), and scale() do not work\nwithin beginShape(). It is also not possible to use other shapes, such as\nellipse() or rect() within beginShape().

    \n", + "itemtype": "method", + "name": "beginShape", + "params": [ + { + "name": "kind", + "description": "

    either POINTS, LINES, TRIANGLES, TRIANGLE_FAN\n TRIANGLE_STRIP, QUADS, or QUAD_STRIP

    \n", + "type": "Constant", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n
    \n\n
    \n\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n
    \n\n
    \n\nbeginShape(LINES);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n
    \n\n
    \n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n
    \n\n
    \n\nnoFill();\nbeginShape();\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape(CLOSE);\n\n
    \n\n
    \n\nbeginShape(TRIANGLES);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nendShape();\n\n
    \n\n
    \n\nbeginShape(TRIANGLE_STRIP);\nvertex(30, 75);\nvertex(40, 20);\nvertex(50, 75);\nvertex(60, 20);\nvertex(70, 75);\nvertex(80, 20);\nvertex(90, 75);\nendShape();\n\n
    \n\n
    \n\nbeginShape(TRIANGLE_FAN);\nvertex(57.5, 50);\nvertex(57.5, 15);\nvertex(92, 50);\nvertex(57.5, 85);\nvertex(22, 50);\nvertex(57.5, 15);\nendShape();\n\n
    \n\n
    \n\nbeginShape(QUADS);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 75);\nvertex(50, 20);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 75);\nvertex(85, 20);\nendShape();\n\n
    \n\n
    \n\nbeginShape(QUAD_STRIP);\nvertex(30, 20);\nvertex(30, 75);\nvertex(50, 20);\nvertex(50, 75);\nvertex(65, 20);\nvertex(65, 75);\nvertex(85, 20);\nvertex(85, 75);\nendShape();\n\n
    \n\n
    \n\nbeginShape();\nvertex(20, 20);\nvertex(40, 20);\nvertex(40, 40);\nvertex(60, 40);\nvertex(60, 60);\nvertex(20, 60);\nendShape(CLOSE);\n\n
    " + ], + "alt": "white square-shape with black outline in middle-right of canvas.\n4 black points in a square shape in middle-right of canvas.\n2 horizontal black lines. In the top-right and bottom-right of canvas.\n3 line shape with horizontal on top, vertical in middle and horizontal bottom.\nsquare line shape in middle-right of canvas.\n2 white triangle shapes mid-right canvas. left one pointing up and right down.\n5 horizontal interlocking and alternating white triangles in mid-right canvas.\n4 interlocking white triangles in 45 degree rotated square-shape.\n2 white rectangle shapes in mid-right canvas. Both 20x55.\n3 side-by-side white rectangles center rect is smaller in mid-right canvas.\nThick white l-shape with black outline mid-top-left of canvas.", + "class": "p5", + "module": "Shape", + "submodule": "Vertex" + }, + { + "file": "src/core/shape/vertex.js", + "line": 270, + "description": "

    Specifies vertex coordinates for Bezier curves. Each call to\nbezierVertex() defines the position of two control points and\none anchor point of a Bezier curve, adding a new segment to a\nline or shape. For WebGL mode bezierVertex() can be used in 2D\nas well as 3D mode. 2D mode expects 6 parameters, while 3D mode\nexpects 9 parameters (including z coordinates).\n

    \nThe first time bezierVertex() is used within a beginShape()\ncall, it must be prefaced with a call to vertex() to set the first anchor\npoint. This function must be used between beginShape() and endShape()\nand only when there is no MODE or POINTS parameter specified to\nbeginShape().

    \n", + "itemtype": "method", + "name": "bezierVertex", + "chainable": 1, + "example": [ + "\n
    \n\nnoFill();\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nendShape();\n\n
    ", + "\n
    \n\nbeginShape();\nvertex(30, 20);\nbezierVertex(80, 0, 80, 75, 30, 75);\nbezierVertex(50, 80, 60, 25, 30, 20);\nendShape();\n\n
    ", + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n setAttributes('antialias', true);\n}\nfunction draw() {\n orbitControl();\n background(50);\n strokeWeight(4);\n stroke(255);\n point(-25, 30);\n point(25, 30);\n point(25, -30);\n point(-25, -30);\n\n strokeWeight(1);\n noFill();\n\n beginShape();\n vertex(-25, 30);\n bezierVertex(25, 30, 25, -30, -25, -30);\n endShape();\n\n beginShape();\n vertex(-25, 30, 20);\n bezierVertex(25, 30, 20, 25, -30, 20, -25, -30, 20);\n endShape();\n}\n\n
    " + ], + "alt": "crescent shape in middle of canvas with another crescent shape on positive z-axis.", + "class": "p5", + "module": "Shape", + "submodule": "Vertex", + "overloads": [ + { + "line": 270, + "params": [ + { + "name": "x2", + "description": "

    x-coordinate for the first control point

    \n", + "type": "Number" + }, + { + "name": "y2", + "description": "

    y-coordinate for the first control point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "

    x-coordinate for the second control point

    \n", + "type": "Number" + }, + { + "name": "y3", + "description": "

    y-coordinate for the second control point

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "

    x-coordinate for the anchor point

    \n", + "type": "Number" + }, + { + "name": "y4", + "description": "

    y-coordinate for the anchor point

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 358, + "params": [ + { + "name": "x2", + "description": "", + "type": "Number" + }, + { + "name": "y2", + "description": "", + "type": "Number" + }, + { + "name": "z2", + "description": "

    z-coordinate for the first control point (for WebGL mode)

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "", + "type": "Number" + }, + { + "name": "y3", + "description": "", + "type": "Number" + }, + { + "name": "z3", + "description": "

    z-coordinate for the second control point (for WebGL mode)

    \n", + "type": "Number" + }, + { + "name": "x4", + "description": "", + "type": "Number" + }, + { + "name": "y4", + "description": "", + "type": "Number" + }, + { + "name": "z4", + "description": "

    z-coordinate for the anchor point (for WebGL mode)

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/vertex.js", + "line": 398, + "description": "

    Specifies vertex coordinates for curves. This function may only\nbe used between beginShape() and endShape() and only when there\nis no MODE parameter specified to beginShape().\nFor WebGL mode curveVertex() can be used in 2D as well as 3D mode.\n2D mode expects 2 parameters, while 3D mode expects 3 parameters.\n

    \nThe first and last points in a series of curveVertex() lines will be used to\nguide the beginning and end of a the curve. A minimum of four\npoints is required to draw a tiny curve between the second and\nthird points. Adding a fifth point with curveVertex() will draw\nthe curve between the second, third, and fourth points. The\ncurveVertex() function is an implementation of Catmull-Rom\nsplines.

    \n", + "itemtype": "method", + "name": "curveVertex", + "chainable": 1, + "example": [ + "\n
    \n\nstrokeWeight(5);\npoint(84, 91);\npoint(68, 19);\npoint(21, 17);\npoint(32, 91);\nstrokeWeight(1);\n\nnoFill();\nbeginShape();\ncurveVertex(84, 91);\ncurveVertex(84, 91);\ncurveVertex(68, 19);\ncurveVertex(21, 17);\ncurveVertex(32, 91);\ncurveVertex(32, 91);\nendShape();\n\n
    " + ], + "alt": "Upside-down u-shape line, mid canvas. left point extends beyond canvas view.", + "class": "p5", + "module": "Shape", + "submodule": "Vertex", + "overloads": [ + { + "line": 398, + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the vertex

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the vertex

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 443, + "params": [ + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + }, + { + "name": "z", + "description": "

    z-coordinate of the vertex (for WebGL mode)

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/vertex.js", + "line": 508, + "description": "

    Use the beginContour() and endContour() functions to create negative\nshapes within shapes such as the center of the letter 'O'. beginContour()\nbegins recording vertices for the shape and endContour() stops recording.\nThe vertices that define a negative shape must "wind" in the opposite\ndirection from the exterior shape. First draw vertices for the exterior\nclockwise order, then for internal shapes, draw vertices\nshape in counter-clockwise.\n

    \nThese functions can only be used within a beginShape()/endShape() pair and\ntransformations such as translate(), rotate(), and scale() do not work\nwithin a beginContour()/endContour() pair. It is also not possible to use\nother shapes, such as ellipse() or rect() within.

    \n", + "itemtype": "method", + "name": "endContour", + "chainable": 1, + "example": [ + "\n
    \n\ntranslate(50, 50);\nstroke(255, 0, 0);\nbeginShape();\n// Exterior part of shape, clockwise winding\nvertex(-40, -40);\nvertex(40, -40);\nvertex(40, 40);\nvertex(-40, 40);\n// Interior part of shape, counter-clockwise winding\nbeginContour();\nvertex(-20, -20);\nvertex(-20, 20);\nvertex(20, 20);\nvertex(20, -20);\nendContour();\nendShape(CLOSE);\n\n
    " + ], + "alt": "white rect and smaller grey rect with red outlines in center of canvas.", + "class": "p5", + "module": "Shape", + "submodule": "Vertex" + }, + { + "file": "src/core/shape/vertex.js", + "line": 568, + "description": "

    The endShape() function is the companion to beginShape() and may only be\ncalled after beginShape(). When endshape() is called, all of image data\ndefined since the previous call to beginShape() is written into the image\nbuffer. The constant CLOSE as the value for the MODE parameter to close\nthe shape (to connect the beginning and the end).

    \n", + "itemtype": "method", + "name": "endShape", + "params": [ + { + "name": "mode", + "description": "

    use CLOSE to close the shape

    \n", + "type": "Constant", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nnoFill();\n\nbeginShape();\nvertex(20, 20);\nvertex(45, 20);\nvertex(45, 80);\nendShape(CLOSE);\n\nbeginShape();\nvertex(50, 20);\nvertex(75, 20);\nvertex(75, 80);\nendShape();\n\n
    " + ], + "alt": "Triangle line shape with smallest interior angle on bottom and upside-down L.", + "class": "p5", + "module": "Shape", + "submodule": "Vertex" + }, + { + "file": "src/core/shape/vertex.js", + "line": 654, + "description": "

    Specifies vertex coordinates for quadratic Bezier curves. Each call to\nquadraticVertex() defines the position of one control points and one\nanchor point of a Bezier curve, adding a new segment to a line or shape.\nThe first time quadraticVertex() is used within a beginShape() call, it\nmust be prefaced with a call to vertex() to set the first anchor point.\nFor WebGL mode quadraticVertex() can be used in 2D as well as 3D mode.\n2D mode expects 4 parameters, while 3D mode expects 6 parameters\n(including z coordinates).\n

    \nThis function must be used between beginShape() and endShape()\nand only when there is no MODE or POINTS parameter specified to\nbeginShape().

    \n", + "itemtype": "method", + "name": "quadraticVertex", + "chainable": 1, + "example": [ + "\n
    \n\nstrokeWeight(5);\npoint(20, 20);\npoint(80, 20);\npoint(50, 50);\n\nnoFill();\nstrokeWeight(1);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nendShape();\n\n
    \n\n
    \n\nstrokeWeight(5);\npoint(20, 20);\npoint(80, 20);\npoint(50, 50);\n\npoint(20, 80);\npoint(80, 80);\npoint(80, 60);\n\nnoFill();\nstrokeWeight(1);\nbeginShape();\nvertex(20, 20);\nquadraticVertex(80, 20, 50, 50);\nquadraticVertex(20, 80, 80, 80);\nvertex(80, 60);\nendShape();\n\n
    " + ], + "alt": "arched-shaped black line with 4 pixel thick stroke weight.\nbackwards s-shaped black line with 4 pixel thick stroke weight.", + "class": "p5", + "module": "Shape", + "submodule": "Vertex", + "overloads": [ + { + "line": 654, + "params": [ + { + "name": "cx", + "description": "

    x-coordinate for the control point

    \n", + "type": "Number" + }, + { + "name": "cy", + "description": "

    y-coordinate for the control point

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "

    x-coordinate for the anchor point

    \n", + "type": "Number" + }, + { + "name": "y3", + "description": "

    y-coordinate for the anchor point

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 720, + "params": [ + { + "name": "cx", + "description": "", + "type": "Number" + }, + { + "name": "cy", + "description": "", + "type": "Number" + }, + { + "name": "cz", + "description": "

    z-coordinate for the control point (for WebGL mode)

    \n", + "type": "Number" + }, + { + "name": "x3", + "description": "", + "type": "Number" + }, + { + "name": "y3", + "description": "", + "type": "Number" + }, + { + "name": "z3", + "description": "

    z-coordinate for the anchor point (for WebGL mode)

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/shape/vertex.js", + "line": 813, + "description": "

    All shapes are constructed by connecting a series of vertices. vertex()\nis used to specify the vertex coordinates for points, lines, triangles,\nquads, and polygons. It is used exclusively within the beginShape() and\nendShape() functions.

    \n", + "itemtype": "method", + "name": "vertex", + "chainable": 1, + "example": [ + "\n
    \n\nstrokeWeight(3);\nbeginShape(POINTS);\nvertex(30, 20);\nvertex(85, 20);\nvertex(85, 75);\nvertex(30, 75);\nendShape();\n\n
    " + ], + "alt": "8 points making 4 lines", + "class": "p5", + "module": "Shape", + "submodule": "Vertex", + "overloads": [ + { + "line": 813, + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the vertex

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the vertex

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 900, + "params": [ + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + }, + { + "name": "z", + "description": "

    z-coordinate of the vertex

    \n", + "type": "Number" + }, + { + "name": "u", + "description": "

    the vertex's texture u-coordinate

    \n", + "type": "Number", + "optional": true + }, + { + "name": "v", + "description": "

    the vertex's texture v-coordinate

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/constants.js", + "line": 13, + "itemtype": "property", + "name": "P2D", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 18, + "itemtype": "property", + "name": "WEBGL", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 25, + "itemtype": "property", + "name": "ARROW", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 30, + "itemtype": "property", + "name": "CROSS", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 35, + "itemtype": "property", + "name": "HAND", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 40, + "itemtype": "property", + "name": "MOVE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 45, + "itemtype": "property", + "name": "TEXT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 50, + "itemtype": "property", + "name": "WAIT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 58, + "description": "

    HALF_PI is a mathematical constant with the value\n1.57079632679489661923. It is half the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().

    \n", + "itemtype": "property", + "name": "HALF_PI", + "type": "Number", + "final": 1, + "example": [ + "\n
    \narc(50, 50, 80, 80, 0, HALF_PI);\n
    " + ], + "alt": "80x80 white quarter-circle with curve toward bottom right of canvas.", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 77, + "description": "

    PI is a mathematical constant with the value\n3.14159265358979323846. It is the ratio of the circumference\nof a circle to its diameter. It is useful in combination with\nthe trigonometric functions sin() and cos().

    \n", + "itemtype": "property", + "name": "PI", + "type": "Number", + "final": 1, + "example": [ + "\n
    \narc(50, 50, 80, 80, 0, PI);\n
    " + ], + "alt": "white half-circle with curve toward bottom of canvas.", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 96, + "description": "

    QUARTER_PI is a mathematical constant with the value 0.7853982.\nIt is one quarter the ratio of the circumference of a circle to\nits diameter. It is useful in combination with the trigonometric\nfunctions sin() and cos().

    \n", + "itemtype": "property", + "name": "QUARTER_PI", + "type": "Number", + "final": 1, + "example": [ + "\n
    \narc(50, 50, 80, 80, 0, QUARTER_PI);\n
    " + ], + "alt": "white eighth-circle rotated about 40 degrees with curve bottom right canvas.", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 115, + "description": "

    TAU is an alias for TWO_PI, a mathematical constant with the\nvalue 6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().

    \n", + "itemtype": "property", + "name": "TAU", + "type": "Number", + "final": 1, + "example": [ + "\n
    \narc(50, 50, 80, 80, 0, TAU);\n
    " + ], + "alt": "80x80 white ellipse shape in center of canvas.", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 134, + "description": "

    TWO_PI is a mathematical constant with the value\n6.28318530717958647693. It is twice the ratio of the\ncircumference of a circle to its diameter. It is useful in\ncombination with the trigonometric functions sin() and cos().

    \n", + "itemtype": "property", + "name": "TWO_PI", + "type": "Number", + "final": 1, + "example": [ + "\n
    \narc(50, 50, 80, 80, 0, TWO_PI);\n
    " + ], + "alt": "80x80 white ellipse shape in center of canvas.", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 153, + "description": "

    Constant to be used with angleMode() function, to set the mode which\np5.js interprates and calculates angles (either DEGREES or RADIANS).

    \n", + "itemtype": "property", + "name": "DEGREES", + "type": "String", + "final": 1, + "example": [ + "\n
    \nfunction setup() {\n angleMode(DEGREES);\n}\n
    " + ], + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 167, + "description": "

    Constant to be used with angleMode() function, to set the mode which\np5.js interprates and calculates angles (either RADIANS or DEGREES).

    \n", + "itemtype": "property", + "name": "RADIANS", + "type": "String", + "final": 1, + "example": [ + "\n
    \nfunction setup() {\n angleMode(RADIANS);\n}\n
    " + ], + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 185, + "itemtype": "property", + "name": "CORNER", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 190, + "itemtype": "property", + "name": "CORNERS", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 195, + "itemtype": "property", + "name": "RADIUS", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 200, + "itemtype": "property", + "name": "RIGHT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 205, + "itemtype": "property", + "name": "LEFT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 210, + "itemtype": "property", + "name": "CENTER", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 215, + "itemtype": "property", + "name": "TOP", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 220, + "itemtype": "property", + "name": "BOTTOM", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 225, + "itemtype": "property", + "name": "BASELINE", + "type": "String", + "final": 1, + "default": "alphabetic", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 231, + "itemtype": "property", + "name": "POINTS", + "type": "Number", + "final": 1, + "default": "0x0000", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 237, + "itemtype": "property", + "name": "LINES", + "type": "Number", + "final": 1, + "default": "0x0001", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 243, + "itemtype": "property", + "name": "LINE_STRIP", + "type": "Number", + "final": 1, + "default": "0x0003", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 249, + "itemtype": "property", + "name": "LINE_LOOP", + "type": "Number", + "final": 1, + "default": "0x0002", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 255, + "itemtype": "property", + "name": "TRIANGLES", + "type": "Number", + "final": 1, + "default": "0x0004", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 261, + "itemtype": "property", + "name": "TRIANGLE_FAN", + "type": "Number", + "final": 1, + "default": "0x0006", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 267, + "itemtype": "property", + "name": "TRIANGLE_STRIP", + "type": "Number", + "final": 1, + "default": "0x0005", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 273, + "itemtype": "property", + "name": "QUADS", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 278, + "itemtype": "property", + "name": "QUAD_STRIP", + "type": "String", + "final": 1, + "default": "quad_strip", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 284, + "itemtype": "property", + "name": "CLOSE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 289, + "itemtype": "property", + "name": "OPEN", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 294, + "itemtype": "property", + "name": "CHORD", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 299, + "itemtype": "property", + "name": "PIE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 304, + "itemtype": "property", + "name": "PROJECT", + "type": "String", + "final": 1, + "default": "square", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 310, + "itemtype": "property", + "name": "SQUARE", + "type": "String", + "final": 1, + "default": "butt", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 316, + "itemtype": "property", + "name": "ROUND", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 321, + "itemtype": "property", + "name": "BEVEL", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 326, + "itemtype": "property", + "name": "MITER", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 333, + "itemtype": "property", + "name": "RGB", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 338, + "itemtype": "property", + "name": "HSB", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 343, + "itemtype": "property", + "name": "HSL", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 350, + "description": "

    AUTO allows us to automatically set the width or height of an element (but not both),\nbased on the current height and width of the element. Only one parameter can\nbe passed to the size function as AUTO, at a time.

    \n", + "itemtype": "property", + "name": "AUTO", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 377, + "itemtype": "property", + "name": "BLEND", + "type": "String", + "final": 1, + "default": "source-over", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 383, + "itemtype": "property", + "name": "ADD", + "type": "String", + "final": 1, + "default": "lighter", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 391, + "itemtype": "property", + "name": "DARKEST", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 396, + "itemtype": "property", + "name": "LIGHTEST", + "type": "String", + "final": 1, + "default": "lighten", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 402, + "itemtype": "property", + "name": "DIFFERENCE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 407, + "itemtype": "property", + "name": "SUBTRACT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 412, + "itemtype": "property", + "name": "EXCLUSION", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 417, + "itemtype": "property", + "name": "MULTIPLY", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 422, + "itemtype": "property", + "name": "SCREEN", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 427, + "itemtype": "property", + "name": "REPLACE", + "type": "String", + "final": 1, + "default": "copy", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 433, + "itemtype": "property", + "name": "OVERLAY", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 438, + "itemtype": "property", + "name": "HARD_LIGHT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 443, + "itemtype": "property", + "name": "SOFT_LIGHT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 448, + "itemtype": "property", + "name": "DODGE", + "type": "String", + "final": 1, + "default": "color-dodge", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 454, + "itemtype": "property", + "name": "BURN", + "type": "String", + "final": 1, + "default": "color-burn", + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 462, + "itemtype": "property", + "name": "THRESHOLD", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 467, + "itemtype": "property", + "name": "GRAY", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 472, + "itemtype": "property", + "name": "OPAQUE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 477, + "itemtype": "property", + "name": "INVERT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 482, + "itemtype": "property", + "name": "POSTERIZE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 487, + "itemtype": "property", + "name": "DILATE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 492, + "itemtype": "property", + "name": "ERODE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 497, + "itemtype": "property", + "name": "BLUR", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 504, + "itemtype": "property", + "name": "NORMAL", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 509, + "itemtype": "property", + "name": "ITALIC", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 514, + "itemtype": "property", + "name": "BOLD", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 519, + "itemtype": "property", + "name": "BOLDITALIC", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 544, + "itemtype": "property", + "name": "IMAGE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 558, + "itemtype": "property", + "name": "LANDSCAPE", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 563, + "itemtype": "property", + "name": "PORTRAIT", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 573, + "itemtype": "property", + "name": "GRID", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/constants.js", + "line": 579, + "itemtype": "property", + "name": "AXES", + "type": "String", + "final": 1, + "class": "p5", + "module": "Constants", + "submodule": "Constants" + }, + { + "file": "src/core/environment.js", + "line": 22, + "description": "

    The print() function writes to the console area of your browser.\nThis function is often helpful for looking at the data a program is\nproducing. This function creates a new line of text for each call to\nthe function. Individual elements can be\nseparated with quotes ("") and joined with the addition operator (+).

    \n

    Note that calling print() without any arguments invokes the window.print()\nfunction which opens the browser's print dialog. To print a blank line\nto console you can write print('\\n').

    \n", + "itemtype": "method", + "name": "print", + "params": [ + { + "name": "contents", + "description": "

    any combination of Number, String, Object, Boolean,\n Array to print

    \n", + "type": "Any" + } + ], + "example": [ + "\n
    \nlet x = 10;\nprint('The value of x is ' + x);\n// prints \"The value of x is 10\"\n
    " + ], + "alt": "default grey canvas", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 53, + "description": "

    The system variable frameCount contains the number of frames that have\nbeen displayed since the program started. Inside setup() the value is 0,\nafter the first iteration of draw it is 1, etc.

    \n", + "itemtype": "property", + "name": "frameCount", + "type": "Integer", + "readonly": "", + "example": [ + "\n
    \nfunction setup() {\n frameRate(30);\n textSize(30);\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(200);\n text(frameCount, width / 2, height / 2);\n}\n
    " + ], + "alt": "numbers rapidly counting upward with frame count set to 30.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 80, + "description": "

    Confirms if the window a p5.js program is in is "focused," meaning that\nthe sketch will accept mouse or keyboard input. This variable is\n"true" if the window is focused and "false" if not.

    \n", + "itemtype": "property", + "name": "focused", + "type": "Boolean", + "readonly": "", + "example": [ + "\n
    \n// To demonstrate, put two windows side by side.\n// Click on the window that the p5 sketch isn't in!\nfunction draw() {\n background(200);\n noStroke();\n fill(0, 200, 0);\n ellipse(25, 25, 50, 50);\n\n if (!focused) {\n // or \"if (focused === false)\"\n stroke(200, 0, 0);\n line(0, 0, 100, 100);\n line(100, 0, 0, 100);\n }\n}\n
    " + ], + "alt": "green 50x50 ellipse at top left. Red X covers canvas when page focus changes", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 112, + "description": "

    Sets the cursor to a predefined symbol or an image, or makes it visible\nif already hidden. If you are trying to set an image as the cursor, the\nrecommended size is 16x16 or 32x32 pixels. The values for parameters x and y\nmust be less than the dimensions of the image.

    \n", + "itemtype": "method", + "name": "cursor", + "params": [ + { + "name": "type", + "description": "

    Built-In: either ARROW, CROSS, HAND, MOVE, TEXT and WAIT\n Native CSS properties: 'grab', 'progress', 'cell' etc.\n External: path for cursor's images\n (Allowed File extensions: .cur, .gif, .jpg, .jpeg, .png)\n For more information on Native CSS cursors and url visit:\n https://developer.mozilla.org/en-US/docs/Web/CSS/cursor

    \n", + "type": "String|Constant" + }, + { + "name": "x", + "description": "

    the horizontal active spot of the cursor (must be less than 32)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    the vertical active spot of the cursor (must be less than 32)

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \n// Move the mouse across the quadrants\n// to see the cursor change\nfunction draw() {\n line(width / 2, 0, width / 2, height);\n line(0, height / 2, width, height / 2);\n if (mouseX < 50 && mouseY < 50) {\n cursor(CROSS);\n } else if (mouseX > 50 && mouseY < 50) {\n cursor('progress');\n } else if (mouseX > 50 && mouseY > 50) {\n cursor('https://s3.amazonaws.com/mupublicdata/cursor.cur');\n } else {\n cursor('grab');\n }\n}\n
    " + ], + "alt": "canvas is divided into four quadrants. cursor on first is a cross, second is a progress,\nthird is a custom cursor using path to the cursor and fourth is a grab.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 181, + "description": "

    Specifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default frame rate is based on the frame rate of the display\n(here also called "refresh rate"), which is set to 60 frames per second on most\ncomputers. A frame rate of 24 frames per second (usual for movies) or above\nwill be enough for smooth animations\nThis is the same as setFrameRate(val).\n

    \nCalling frameRate() with no arguments returns the current framerate. The\ndraw function must run at least once before it will return a value. This\nis the same as getFrameRate().\n

    \nCalling frameRate() with arguments that are not of the type numbers\nor are non positive also returns current framerate.

    \n", + "itemtype": "method", + "name": "frameRate", + "chainable": 1, + "example": [ + "\n\n
    \nlet rectX = 0;\nlet fr = 30; //starting FPS\nlet clr;\n\nfunction setup() {\n background(200);\n frameRate(fr); // Attempt to refresh at starting FPS\n clr = color(255, 0, 0);\n}\n\nfunction draw() {\n background(200);\n rectX = rectX += 1; // Move Rectangle\n\n if (rectX >= width) {\n // If you go off screen.\n if (fr === 30) {\n clr = color(0, 0, 255);\n fr = 10;\n frameRate(fr); // make frameRate 10 FPS\n } else {\n clr = color(255, 0, 0);\n fr = 30;\n frameRate(fr); // make frameRate 30 FPS\n }\n rectX = 0;\n }\n fill(clr);\n rect(rectX, 40, 20, 20);\n}\n
    " + ], + "alt": "blue rect moves left to right, followed by red rect moving faster. Loops.", + "class": "p5", + "module": "Environment", + "submodule": "Environment", + "overloads": [ + { + "line": 181, + "params": [ + { + "name": "fps", + "description": "

    number of frames to be displayed every second

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 242, + "params": [], + "return": { + "description": "current frameRate", + "type": "Number" + } + } + ] + }, + { + "file": "src/core/environment.js", + "line": 281, + "description": "

    Hides the cursor from view.

    \n", + "itemtype": "method", + "name": "noCursor", + "example": [ + "\n
    \nfunction setup() {\n noCursor();\n}\n\nfunction draw() {\n background(200);\n ellipse(mouseX, mouseY, 10, 10);\n}\n
    " + ], + "alt": "cursor becomes 10x 10 white ellipse the moves with mouse x and y.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 306, + "description": "

    System variable that stores the width of the screen display according to The\ndefault pixelDensity. This is used to run a\nfull-screen program on any display size. To return actual screen size,\nmultiply this by pixelDensity.

    \n", + "itemtype": "property", + "name": "displayWidth", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \ncreateCanvas(displayWidth, displayHeight);\n
    " + ], + "alt": "cursor becomes 10x 10 white ellipse the moves with mouse x and y.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 325, + "description": "

    System variable that stores the height of the screen display according to The\ndefault pixelDensity. This is used to run a\nfull-screen program on any display size. To return actual screen size,\nmultiply this by pixelDensity.

    \n", + "itemtype": "property", + "name": "displayHeight", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \ncreateCanvas(displayWidth, displayHeight);\n
    " + ], + "alt": "no display.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 344, + "description": "

    System variable that stores the width of the inner window, it maps to\nwindow.innerWidth.

    \n", + "itemtype": "property", + "name": "windowWidth", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \ncreateCanvas(windowWidth, windowHeight);\n
    " + ], + "alt": "no display.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 360, + "description": "

    System variable that stores the height of the inner window, it maps to\nwindow.innerHeight.

    \n", + "itemtype": "property", + "name": "windowHeight", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \ncreateCanvas(windowWidth, windowHeight);\n
    " + ], + "alt": "no display.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 376, + "description": "

    The windowResized() function is called once every time the browser window\nis resized. This is a good place to resize the canvas or do any other\nadjustments to accommodate the new window size.

    \n", + "itemtype": "method", + "name": "windowResized", + "example": [ + "\n
    \nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n
    " + ], + "alt": "no display.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 430, + "description": "

    System variable that stores the width of the drawing canvas. This value\nis set by the first parameter of the createCanvas() function.\nFor example, the function call createCanvas(320, 240) sets the width\nvariable to the value 320. The value of width defaults to 100 if\ncreateCanvas() is not used in a program.

    \n", + "itemtype": "property", + "name": "width", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 442, + "description": "

    System variable that stores the height of the drawing canvas. This value\nis set by the second parameter of the createCanvas() function. For\nexample, the function call createCanvas(320, 240) sets the height\nvariable to the value 240. The value of height defaults to 100 if\ncreateCanvas() is not used in a program.

    \n", + "itemtype": "property", + "name": "height", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 454, + "description": "

    If argument is given, sets the sketch to fullscreen or not based on the\nvalue of the argument. If no argument is given, returns the current\nfullscreen state. Note that due to browser restrictions this can only\nbe called on user input, for example, on mouse press like the example\nbelow.

    \n", + "itemtype": "method", + "name": "fullscreen", + "params": [ + { + "name": "val", + "description": "

    whether the sketch should be in fullscreen mode\nor not

    \n", + "type": "Boolean", + "optional": true + } + ], + "return": { + "description": "current fullscreen state", + "type": "Boolean" + }, + "example": [ + "\n
    \n\n// Clicking in the box toggles fullscreen on and off.\nfunction setup() {\n background(200);\n}\nfunction mousePressed() {\n if (mouseX > 0 && mouseX < 100 && mouseY > 0 && mouseY < 100) {\n let fs = fullscreen();\n fullscreen(!fs);\n }\n}\n\n
    " + ], + "alt": "no display.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 505, + "description": "

    Sets the pixel scaling for high pixel density displays. By default\npixel density is set to match display density, call pixelDensity(1)\nto turn this off. Calling pixelDensity() with no arguments returns\nthe current pixel density of the sketch.

    \n", + "itemtype": "method", + "name": "pixelDensity", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n pixelDensity(1);\n createCanvas(100, 100);\n background(200);\n ellipse(width / 2, height / 2, 50, 50);\n}\n\n
    \n
    \n\nfunction setup() {\n pixelDensity(3.0);\n createCanvas(100, 100);\n background(200);\n ellipse(width / 2, height / 2, 50, 50);\n}\n\n
    " + ], + "alt": "fuzzy 50x50 white ellipse with black outline in center of canvas.\nsharp 50x50 white ellipse with black outline in center of canvas.", + "class": "p5", + "module": "Environment", + "submodule": "Environment", + "overloads": [ + { + "line": 505, + "params": [ + { + "name": "val", + "description": "

    whether or how much the sketch should scale

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 540, + "params": [], + "return": { + "description": "current pixel density of the sketch", + "type": "Number" + } + } + ] + }, + { + "file": "src/core/environment.js", + "line": 560, + "description": "

    Returns the pixel density of the current display the sketch is running on.

    \n", + "itemtype": "method", + "name": "displayDensity", + "return": { + "description": "current pixel density of the display", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let density = displayDensity();\n pixelDensity(density);\n createCanvas(100, 100);\n background(200);\n ellipse(width / 2, height / 2, 50, 50);\n}\n\n
    " + ], + "alt": "50x50 white ellipse with black outline in center of canvas.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 617, + "description": "

    Gets the current URL.

    \n", + "itemtype": "method", + "name": "getURL", + "return": { + "description": "url", + "type": "String" + }, + "example": [ + "\n
    \n\nlet url;\nlet x = 100;\n\nfunction setup() {\n fill(0);\n noStroke();\n url = getURL();\n}\n\nfunction draw() {\n background(200);\n text(url, x, height / 2);\n x--;\n}\n\n
    " + ], + "alt": "current url (http://p5js.org/reference/#/p5/getURL) moves right to left.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 648, + "description": "

    Gets the current URL path as an array.

    \n", + "itemtype": "method", + "name": "getURLPath", + "return": { + "description": "path components", + "type": "String[]" + }, + "example": [ + "\n
    \nfunction setup() {\n let urlPath = getURLPath();\n for (let i = 0; i < urlPath.length; i++) {\n text(urlPath[i], 10, i * 20 + 20);\n }\n}\n
    " + ], + "alt": "no display", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/environment.js", + "line": 671, + "description": "

    Gets the current URL params as an Object.

    \n", + "itemtype": "method", + "name": "getURLParams", + "return": { + "description": "URL params", + "type": "Object" + }, + "example": [ + "\n
    \n\n// Example: http://p5js.org?year=2014&month=May&day=15\n\nfunction setup() {\n let params = getURLParams();\n text(params.day, 10, 20);\n text(params.month, 10, 40);\n text(params.year, 10, 60);\n}\n\n
    " + ], + "alt": "no display.", + "class": "p5", + "module": "Environment", + "submodule": "Environment" + }, + { + "file": "src/core/error_helpers.js", + "line": 1, + "requires": [ + "core" + ], + "class": "p5", + "module": "Environment" + }, + { + "file": "src/core/error_helpers.js", + "line": 584, + "description": "

    Validates parameters\nparam {String} func the name of the function\nparam {Array} args user input arguments

    \n

    example:\n var a;\n ellipse(10,10,a,5);\nconsole ouput:\n "It looks like ellipse received an empty variable in spot #2."

    \n

    example:\n ellipse(10,"foo",5,5);\nconsole output:\n "ellipse was expecting a number for parameter #1,\n received "foo" instead."

    \n", + "class": "p5", + "module": "Environment" + }, + { + "file": "src/core/error_helpers.js", + "line": 645, + "description": "

    Prints out all the colors in the color pallete with white text.\nFor color blindness testing.

    \n", + "class": "p5", + "module": "Environment" + }, + { + "file": "src/core/helpers.js", + "line": 1, + "requires": [ + "constants" + ], + "class": "p5", + "module": "Environment" + }, + { + "file": "src/core/legacy.js", + "line": 1, + "requires": [ + "core\nThese are functions that are part of the Processing API but are not part of\nthe p5.js API. In some cases they have a new name", + "in others", + "they are\nremoved completely. Not all unsupported Processing functions are listed here\nbut we try to include ones that a user coming from Processing might likely\ncall." + ], + "class": "p5", + "module": "Environment" + }, + { + "file": "src/core/main.js", + "line": 49, + "description": "

    Called directly before setup(), the preload() function is used to handle\nasynchronous loading of external files in a blocking way. If a preload\nfunction is defined, setup() will wait until any load calls within have\nfinished. Nothing besides load calls (loadImage, loadJSON, loadFont,\nloadStrings, etc.) should be inside the preload function. If asynchronous\nloading is preferred, the load methods can instead be called in setup()\nor anywhere else with the use of a callback parameter.\n

    \nBy default the text "loading..." will be displayed. To make your own\nloading page, include an HTML element with id "p5_loading" in your\npage. More information here.

    \n", + "itemtype": "method", + "name": "preload", + "example": [ + "\n
    \nlet img;\nlet c;\nfunction preload() {\n // preload() runs once\n img = loadImage('assets/laDefense.jpg');\n}\n\nfunction setup() {\n // setup() waits until preload() is done\n img.loadPixels();\n // get color of middle pixel\n c = img.get(img.width / 2, img.height / 2);\n}\n\nfunction draw() {\n background(c);\n image(img, 25, 25, 50, 50);\n}\n
    " + ], + "alt": "nothing displayed", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/main.js", + "line": 90, + "description": "

    The setup() function is called once when the program starts. It's used to\ndefine initial environment properties such as screen size and background\ncolor and to load media such as images and fonts as the program starts.\nThere can only be one setup() function for each program and it shouldn't\nbe called again after its initial execution.\n

    \nNote: Variables declared within setup() are not accessible within other\nfunctions, including draw().

    \n", + "itemtype": "method", + "name": "setup", + "example": [ + "\n
    \nlet a = 0;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(102);\n}\n\nfunction draw() {\n rect(a++ % width, 10, 2, 80);\n}\n
    " + ], + "alt": "nothing displayed", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/main.js", + "line": 121, + "description": "

    Called directly after setup(), the draw() function continuously executes\nthe lines of code contained inside its block until the program is stopped\nor noLoop() is called. Note if noLoop() is called in setup(), draw() will\nstill be executed once before stopping. draw() is called automatically and\nshould never be called explicitly.\n

    \nIt should always be controlled with noLoop(), redraw() and loop(). After\nnoLoop() stops the code in draw() from executing, redraw() causes the\ncode inside draw() to execute once, and loop() will cause the code\ninside draw() to resume executing continuously.\n

    \nThe number of times draw() executes in each second may be controlled with\nthe frameRate() function.\n

    \nThere can only be one draw() function for each sketch, and draw() must\nexist if you want the code to run continuously, or to process events such\nas mousePressed(). Sometimes, you might have an empty call to draw() in\nyour program, as shown in the above example.\n

    \nIt is important to note that the drawing coordinate system will be reset\nat the beginning of each draw() call. If any transformations are performed\nwithin draw() (ex: scale, rotate, translate), their effects will be\nundone at the beginning of draw(), so transformations will not accumulate\nover time. On the other hand, styling applied (ex: fill, stroke, etc) will\nremain in effect.

    \n", + "itemtype": "method", + "name": "draw", + "example": [ + "\n
    \nlet yPos = 0;\nfunction setup() {\n // setup() runs once\n frameRate(30);\n}\nfunction draw() {\n // draw() loops forever, until stopped\n background(204);\n yPos = yPos - 1;\n if (yPos < 0) {\n yPos = height;\n }\n line(0, yPos, width, yPos);\n}\n
    " + ], + "alt": "nothing displayed", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/main.js", + "line": 401, + "description": "

    Removes the entire p5 sketch. This will remove the canvas and any\nelements created by p5.js. It will also stop the draw loop and unbind\nany properties or methods from the window global scope. It will\nleave a variable p5 in case you wanted to create a new p5 sketch.\nIf you like, you can set p5 = null to erase it. While all functions and\nvariables and objects created by the p5 library will be removed, any\nother global variables created by your code will remain.

    \n", + "itemtype": "method", + "name": "remove", + "example": [ + "\n
    \nfunction draw() {\n ellipse(50, 50, 10, 10);\n}\n\nfunction mousePressed() {\n remove(); // remove whole sketch on mouse press\n}\n
    " + ], + "alt": "nothing displayed", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/main.js", + "line": 586, + "description": "

    Allows for the friendly error system (FES) to be turned off when creating a sketch,\nwhich can give a significant boost to performance when needed.\nSee \ndisabling the friendly error system.

    \n", + "itemtype": "property", + "name": "disableFriendlyErrors", + "type": "Boolean", + "example": [ + "\n
    \np5.disableFriendlyErrors = true;\n\nfunction setup() {\n createCanvas(100, 50);\n}\n
    " + ], + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/p5.Element.js", + "line": 26, + "description": "

    Underlying HTML element. All normal HTML methods can be called on this.

    \n", + "example": [ + "\n
    \n\nfunction setup() {\n let c = createCanvas(50, 50);\n c.elt.style.border = '5px solid red';\n}\n\nfunction draw() {\n background(220);\n}\n\n
    " + ], + "itemtype": "property", + "name": "elt", + "readonly": "", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 52, + "description": "

    Attaches the element to the parent specified. A way of setting\n the container for the element. Accepts either a string ID, DOM\n node, or p5.Element. If no arguments given, parent node is returned.\n For more ways to position the canvas, see the\n \n positioning the canvas wiki page.\nAll above examples except for the first one require the inclusion of\n the p5.dom library in your index.html. See the\n using a library\n section for information on how to include this library.

    \n", + "itemtype": "method", + "name": "parent", + "chainable": 1, + "example": [ + "\n
    \n // in the html file:\n // <div id=\"myContainer\"></div>\n// in the js file:\n let cnv = createCanvas(100, 100);\n cnv.parent('myContainer');\n
    \n
    \n let div0 = createDiv('this is the parent');\n let div1 = createDiv('this is the child');\n div1.parent(div0); // use p5.Element\n
    \n
    \n let div0 = createDiv('this is the parent');\n div0.id('apples');\n let div1 = createDiv('this is the child');\n div1.parent('apples'); // use id\n
    \n
    \n let elt = document.getElementById('myParentDiv');\n let div1 = createDiv('this is the child');\n div1.parent(elt); // use element from page\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM", + "overloads": [ + { + "line": 52, + "params": [ + { + "name": "parent", + "description": "

    the ID, DOM node, or p5.Element\n of desired parent element

    \n", + "type": "String|p5.Element|Object" + } + ], + "chainable": 1 + }, + { + "line": 100, + "params": [], + "return": { + "description": "", + "type": "p5.Element" + } + } + ] + }, + { + "file": "src/core/p5.Element.js", + "line": 122, + "description": "

    Sets the ID of the element. If no ID argument is passed in, it instead\n returns the current ID of the element.\n Note that only one element can have a particular id in a page.\n The .class() function can be used\n to identify multiple elements with the same class name.

    \n", + "itemtype": "method", + "name": "id", + "chainable": 1, + "example": [ + "\n
    \n function setup() {\n let cnv = createCanvas(100, 100);\n // Assigns a CSS selector ID to\n // the canvas element.\n cnv.id('mycanvas');\n }\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM", + "overloads": [ + { + "line": 122, + "params": [ + { + "name": "id", + "description": "

    ID of the element

    \n", + "type": "String" + } + ], + "chainable": 1 + }, + { + "line": 147, + "params": [], + "return": { + "description": "the id of the element", + "type": "String" + } + } + ] + }, + { + "file": "src/core/p5.Element.js", + "line": 162, + "description": "

    Adds given class to the element. If no class argument is passed in, it\n instead returns a string containing the current class(es) of the element.

    \n", + "itemtype": "method", + "name": "class", + "chainable": 1, + "example": [ + "\n
    \n function setup() {\n let cnv = createCanvas(100, 100);\n // Assigns a CSS selector class 'small'\n // to the canvas element.\n cnv.class('small');\n }\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM", + "overloads": [ + { + "line": 162, + "params": [ + { + "name": "class", + "description": "

    class to add

    \n", + "type": "String" + } + ], + "chainable": 1 + }, + { + "line": 184, + "params": [], + "return": { + "description": "the class of the element", + "type": "String" + } + } + ] + }, + { + "file": "src/core/p5.Element.js", + "line": 197, + "description": "

    The .mousePressed() function is called once after every time a\nmouse button is pressed over the element.\nSome mobile browsers may also trigger this event on a touch screen,\nif the user performs a quick tap.\nThis can be used to attach element specific event listeners.

    \n", + "itemtype": "method", + "name": "mousePressed", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when mouse is\n pressed over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mousePressed(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any click anywhere\nfunction mousePressed() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 258, + "description": "

    The .doubleClicked() function is called once after every time a\nmouse button is pressed twice over the element. This can be used to\nattach element and action specific event listeners.

    \n", + "itemtype": "method", + "name": "doubleClicked", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when mouse is\n double clicked over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "return": { + "description": "", + "type": "p5.Element" + }, + "example": [ + "\n
    \nlet cnv;\nlet d;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.doubleClicked(changeGray); // attach listener for\n // canvas double click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any double click anywhere\nfunction doubleClicked() {\n d = d + 10;\n}\n\n// this function fires only when cnv is double clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 307, + "description": "

    The .mouseWheel() function is called once after every time a\nmouse wheel is scrolled over the element. This can be used to\nattach element specific event listeners.\n

    \nThe function accepts a callback function as argument which will be executed\nwhen the wheel event is triggered on the element, the callback function is\npassed one argument event. The event.deltaY property returns negative\nvalues if the mouse wheel is rotated up or away from the user and positive\nin the other direction. The event.deltaX does the same as event.deltaY\nexcept it reads the horizontal wheel scroll of the mouse wheel.\n

    \nOn OS X with "natural" scrolling enabled, the event.deltaY values are\nreversed.

    \n", + "itemtype": "method", + "name": "mouseWheel", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when mouse is\n scrolled over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseWheel(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with mousewheel movement\n// anywhere on screen\nfunction mouseWheel() {\n g = g + 10;\n}\n\n// this function fires with mousewheel movement\n// over canvas only\nfunction changeSize(event) {\n if (event.deltaY > 0) {\n d = d + 10;\n } else {\n d = d - 10;\n }\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 373, + "description": "

    The .mouseReleased() function is called once after every time a\nmouse button is released over the element.\nSome mobile browsers may also trigger this event on a touch screen,\nif the user performs a quick tap.\nThis can be used to attach element specific event listeners.

    \n", + "itemtype": "method", + "name": "mouseReleased", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when mouse is\n released over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseReleased(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires after the mouse has been\n// released\nfunction mouseReleased() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// released while on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 427, + "description": "

    The .mouseClicked() function is called once after a mouse button is\npressed and released over the element.\nSome mobile browsers may also trigger this event on a touch screen,\nif the user performs a quick tap.\nThis can be used to attach element specific event listeners.

    \n", + "itemtype": "method", + "name": "mouseClicked", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when mouse is\n clicked over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nlet cnv;\nlet d;\nlet g;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseClicked(changeGray); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires after the mouse has been\n// clicked anywhere\nfunction mouseClicked() {\n d = d + 10;\n}\n\n// this function fires after the mouse has been\n// clicked on canvas\nfunction changeGray() {\n g = random(0, 255);\n}\n\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 483, + "description": "

    The .mouseMoved() function is called once every time a\nmouse moves over the element. This can be used to attach an\nelement specific event listener.

    \n", + "itemtype": "method", + "name": "mouseMoved", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a mouse moves\n over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d = 30;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseMoved(changeSize); // attach listener for\n // activity on canvas only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n fill(200);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires when mouse moves anywhere on\n// page\nfunction mouseMoved() {\n g = g + 5;\n if (g > 255) {\n g = 0;\n }\n}\n\n// this function fires when mouse moves over canvas\nfunction changeSize() {\n d = d + 2;\n if (d > 100) {\n d = 0;\n }\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 541, + "description": "

    The .mouseOver() function is called once after every time a\nmouse moves onto the element. This can be used to attach an\nelement specific event listener.

    \n", + "itemtype": "method", + "name": "mouseOver", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a mouse moves\n onto the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOver(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width / 2, height / 2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 584, + "description": "

    The .mouseOut() function is called once after every time a\nmouse moves off the element. This can be used to attach an\nelement specific event listener.

    \n", + "itemtype": "method", + "name": "mouseOut", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a mouse\n moves off of an element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.mouseOut(changeGray);\n d = 10;\n}\n\nfunction draw() {\n ellipse(width / 2, height / 2, d, d);\n}\n\nfunction changeGray() {\n d = d + 10;\n if (d > 100) {\n d = 0;\n }\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 626, + "description": "

    The .touchStarted() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.

    \n", + "itemtype": "method", + "name": "touchStarted", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a touch\n starts over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchStarted(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchStarted() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 674, + "description": "

    The .touchMoved() function is called once after every time a touch move is\nregistered. This can be used to attach element specific event listeners.

    \n", + "itemtype": "method", + "name": "touchMoved", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a touch moves over\n the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchMoved(changeGray); // attach listener for\n // canvas click only\n g = 100;\n}\n\nfunction draw() {\n background(g);\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 714, + "description": "

    The .touchEnded() function is called once after every time a touch is\nregistered. This can be used to attach element specific event listeners.

    \n", + "itemtype": "method", + "name": "touchEnded", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a touch ends\n over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nlet cnv;\nlet d;\nlet g;\nfunction setup() {\n cnv = createCanvas(100, 100);\n cnv.touchEnded(changeGray); // attach listener for\n // canvas click only\n d = 10;\n g = 100;\n}\n\nfunction draw() {\n background(g);\n ellipse(width / 2, height / 2, d, d);\n}\n\n// this function fires with any touch anywhere\nfunction touchEnded() {\n d = d + 10;\n}\n\n// this function fires only when cnv is clicked\nfunction changeGray() {\n g = random(0, 255);\n}\n
    " + ], + "alt": "no display.", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 763, + "description": "

    The .dragOver() function is called once after every time a\nfile is dragged over the element. This can be used to attach an\nelement specific event listener.

    \n", + "itemtype": "method", + "name": "dragOver", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a file is\n dragged over the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \n// To test this sketch, simply drag a\n// file over the canvas\nfunction setup() {\n let c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width / 2, height / 2);\n c.dragOver(dragOverCallback);\n}\n\n// This function will be called whenever\n// a file is dragged over the canvas\nfunction dragOverCallback() {\n background(240);\n text('Dragged over', width / 2, height / 2);\n}\n
    " + ], + "alt": "nothing displayed", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 801, + "description": "

    The .dragLeave() function is called once after every time a\ndragged file leaves the element area. This can be used to attach an\nelement specific event listener.

    \n", + "itemtype": "method", + "name": "dragLeave", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when a file is\n dragged off the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \n// To test this sketch, simply drag a file\n// over and then out of the canvas area\nfunction setup() {\n let c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('Drag file', width / 2, height / 2);\n c.dragLeave(dragLeaveCallback);\n}\n\n// This function will be called whenever\n// a file is dragged out of the canvas\nfunction dragLeaveCallback() {\n background(240);\n text('Dragged off', width / 2, height / 2);\n}\n
    " + ], + "alt": "nothing displayed", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Element.js", + "line": 865, + "description": "

    Helper fxn for sharing pixel methods

    \n", + "class": "p5.Element", + "module": "DOM", + "submodule": "DOM" + }, + { + "file": "src/core/p5.Graphics.js", + "line": 65, + "description": "

    Resets certain values such as those modified by functions in the Transform category\nand in the Lights category that are not automatically reset\nwith graphics buffer objects. Calling this in draw() will copy the behavior\nof the standard canvas.

    \n", + "itemtype": "method", + "name": "reset", + "example": [ + "\n\n
    \nlet pg;\nfunction setup() {\n createCanvas(100, 100);\n background(0);\n pg = createGraphics(50, 100);\n pg.fill(0);\n frameRate(5);\n}\nfunction draw() {\n image(pg, width / 2, 0);\n pg.background(255);\n // p5.Graphics object behave a bit differently in some cases\n // The normal canvas on the left resets the translate\n // with every loop through draw()\n // the graphics object on the right doesn't automatically reset\n // so translate() is additive and it moves down the screen\n rect(0, 0, width / 2, 5);\n pg.rect(0, 0, width / 2, 5);\n translate(0, 5, 0);\n pg.translate(0, 5, 0);\n}\nfunction mouseClicked() {\n // if you click you will see that\n // reset() resets the translate back to the initial state\n // of the Graphics object\n pg.reset();\n}\n
    " + ], + "alt": "A white line on a black background stays still on the top-left half.\nA black line animates from top to bottom on a white background on the right half.\nWhen clicked, the black line starts back over at the top.", + "class": "p5.Graphics", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/p5.Graphics.js", + "line": 117, + "description": "

    Removes a Graphics object from the page and frees any resources\nassociated with it.

    \n", + "itemtype": "method", + "name": "remove", + "example": [ + "\n
    \nlet bg;\nfunction setup() {\n bg = createCanvas(100, 100);\n bg.background(0);\n image(bg, 0, 0);\n bg.remove();\n}\n
    \n\n
    \nlet bg;\nfunction setup() {\n pixelDensity(1);\n createCanvas(100, 100);\n stroke(255);\n fill(0);\n\n // create and draw the background image\n bg = createGraphics(100, 100);\n bg.background(200);\n bg.ellipse(50, 50, 80, 80);\n}\nfunction draw() {\n let t = millis() / 1000;\n // draw the background\n if (bg) {\n image(bg, frameCount % 100, 0);\n image(bg, frameCount % 100 - 100, 0);\n }\n // draw the foreground\n let p = p5.Vector.fromAngle(t, 35).add(50, 50);\n ellipse(p.x, p.y, 30);\n}\nfunction mouseClicked() {\n // remove the background\n if (bg) {\n bg.remove();\n bg = null;\n }\n}\n
    " + ], + "alt": "no image\na multi-colored circle moving back and forth over a scrolling background.", + "class": "p5.Graphics", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/p5.Renderer.js", + "line": 97, + "description": "

    Resize our canvas element.

    \n", + "class": "p5.Renderer", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/p5.Renderer.js", + "line": 335, + "description": "

    Helper fxn to check font type (system or otf)

    \n", + "class": "p5.Renderer", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/p5.Renderer.js", + "line": 388, + "description": "

    Helper fxn to measure ascent and descent.\nAdapted from http://stackoverflow.com/a/25355178

    \n", + "class": "p5.Renderer", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/p5.Renderer2D.js", + "line": 9, + "description": "

    p5.Renderer2D\nThe 2D graphics canvas renderer class.\nextends p5.Renderer

    \n", + "class": "p5", + "module": "Rendering" + }, + { + "file": "src/core/p5.Renderer2D.js", + "line": 405, + "description": "

    Generate a cubic Bezier representing an arc on the unit circle of total\nangle size radians, beginning start radians above the x-axis. Up to\nfour of these curves are combined to make a full arc.

    \n

    See www.joecridge.me/bezier.pdf for an explanation of the method.

    \n", + "class": "p5", + "module": "Rendering" + }, + { + "file": "src/core/rendering.js", + "line": 17, + "description": "

    Creates a canvas element in the document, and sets the dimensions of it\nin pixels. This method should be called only once at the start of setup.\nCalling createCanvas more than once in a sketch will result in very\nunpredictable behavior. If you want more than one drawing canvas\nyou could use createGraphics (hidden by default but it can be shown).\n

    \nThe system variables width and height are set by the parameters passed\nto this function. If createCanvas() is not used, the window will be\ngiven a default size of 100x100 pixels.\n

    \nFor more ways to position the canvas, see the\n\npositioning the canvas wiki page.

    \n", + "itemtype": "method", + "name": "createCanvas", + "params": [ + { + "name": "w", + "description": "

    width of the canvas

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height of the canvas

    \n", + "type": "Number" + }, + { + "name": "renderer", + "description": "

    either P2D or WEBGL

    \n", + "type": "Constant", + "optional": true + } + ], + "return": { + "description": "", + "type": "p5.Renderer" + }, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 50);\n background(153);\n line(0, 0, width, height);\n}\n\n
    " + ], + "alt": "Black line extending from top-left of canvas to bottom right.", + "class": "p5", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/rendering.js", + "line": 119, + "description": "

    Resizes the canvas to given width and height. The canvas will be cleared\nand draw will be called immediately, allowing the sketch to re-render itself\nin the resized canvas.

    \n", + "itemtype": "method", + "name": "resizeCanvas", + "params": [ + { + "name": "w", + "description": "

    width of the canvas

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height of the canvas

    \n", + "type": "Number" + }, + { + "name": "noRedraw", + "description": "

    don't redraw the canvas immediately

    \n", + "type": "Boolean", + "optional": true + } + ], + "example": [ + "\n
    \nfunction setup() {\n createCanvas(windowWidth, windowHeight);\n}\n\nfunction draw() {\n background(0, 100, 200);\n}\n\nfunction windowResized() {\n resizeCanvas(windowWidth, windowHeight);\n}\n
    " + ], + "alt": "No image displayed.", + "class": "p5", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/rendering.js", + "line": 174, + "description": "

    Removes the default canvas for a p5 sketch that doesn't\nrequire a canvas

    \n", + "itemtype": "method", + "name": "noCanvas", + "example": [ + "\n
    \n\nfunction setup() {\n noCanvas();\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/rendering.js", + "line": 197, + "description": "

    Creates and returns a new p5.Renderer object. Use this class if you need\nto draw into an off-screen graphics buffer. The two parameters define the\nwidth and height in pixels.

    \n", + "itemtype": "method", + "name": "createGraphics", + "params": [ + { + "name": "w", + "description": "

    width of the offscreen graphics buffer

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height of the offscreen graphics buffer

    \n", + "type": "Number" + }, + { + "name": "renderer", + "description": "

    either P2D or WEBGL\nundefined defaults to p2d

    \n", + "type": "Constant", + "optional": true + } + ], + "return": { + "description": "offscreen graphics buffer", + "type": "p5.Graphics" + }, + "example": [ + "\n
    \n\nlet pg;\nfunction setup() {\n createCanvas(100, 100);\n pg = createGraphics(100, 100);\n}\nfunction draw() {\n background(200);\n pg.background(100);\n pg.noStroke();\n pg.ellipse(pg.width / 2, pg.height / 2, 50, 50);\n image(pg, 50, 50);\n image(pg, 0, 0, 50, 50);\n}\n\n
    " + ], + "alt": "4 grey squares alternating light and dark grey. White quarter circle mid-left.", + "class": "p5", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/rendering.js", + "line": 236, + "description": "

    Blends the pixels in the display window according to the defined mode.\nThere is a choice of the following modes to blend the source pixels (A)\nwith the ones of pixels already in the display window (B):

    \n

      \n

    • BLEND - linear interpolation of colours: C =\nA*factor + B. This is the default blending mode.

      • \n

    • ADD - sum of A and B

      • \n

    • DARKEST - only the darkest colour succeeds: C =\nmin(A*factor, B).

      • \n

    • LIGHTEST - only the lightest colour succeeds: C =\nmax(A*factor, B).

      • \n

    • DIFFERENCE - subtract colors from underlying image.

      • \n

    • EXCLUSION - similar to DIFFERENCE, but less\nextreme.

      • \n

    • MULTIPLY - multiply the colors, result will always be\ndarker.

      • \n

    • SCREEN - opposite multiply, uses inverse values of the\ncolors.

      • \n

    • REPLACE - the pixels entirely replace the others and\ndon't utilize alpha (transparency) values.

      • \n

    • OVERLAY - mix of MULTIPLY and SCREEN\n. Multiplies dark values, and screens light values. (2D)

      • \n

    • HARD_LIGHT - SCREEN when greater than 50%\ngray, MULTIPLY when lower. (2D)

      • \n

    • SOFT_LIGHT - mix of DARKEST and\nLIGHTEST. Works like OVERLAY, but not as harsh. (2D)\n

      • \n

    • DODGE - lightens light tones and increases contrast,\nignores darks. (2D)

      • \n

    • BURN - darker areas are applied, increasing contrast,\nignores lights. (2D)

      • \n

    • SUBTRACT - remainder of A and B (3D)
      • \n
    \n

    \n(2D) indicates that this blend mode only works in the 2D renderer.
    \n(3D) indicates that this blend mode only works in the WEBGL renderer.

    \n", + "itemtype": "method", + "name": "blendMode", + "params": [ + { + "name": "mode", + "description": "

    blend mode to set for canvas.\n either BLEND, DARKEST, LIGHTEST, DIFFERENCE, MULTIPLY,\n EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,\n SOFT_LIGHT, DODGE, BURN, ADD, or SUBTRACT

    \n", + "type": "Constant" + } + ], + "example": [ + "\n
    \n\nblendMode(LIGHTEST);\nstrokeWeight(30);\nstroke(80, 150, 255);\nline(25, 25, 75, 75);\nstroke(255, 50, 50);\nline(75, 25, 25, 75);\n\n
    \n
    \n\nblendMode(MULTIPLY);\nstrokeWeight(30);\nstroke(80, 150, 255);\nline(25, 25, 75, 75);\nstroke(255, 50, 50);\nline(75, 25, 25, 75);\n\n
    " + ], + "alt": "translucent image thick red & blue diagonal rounded lines intersecting center\nThick red & blue diagonal rounded lines intersecting center. dark at overlap", + "class": "p5", + "module": "Rendering", + "submodule": "Rendering" + }, + { + "file": "src/core/shim.js", + "line": 23, + "description": "

    shim for Uint8ClampedArray.slice\n(allows arrayCopy to work with pixels[])\nwith thanks to http://halfpapstudios.com/blog/tag/html5-canvas/\nEnumerable set to false to protect for...in from\nUint8ClampedArray.prototype pollution.

    \n", + "class": "p5", + "module": "Rendering" + }, + { + "file": "src/core/shim.js", + "line": 45, + "description": "

    this is implementation of Object.assign() which is unavailable in\nIE11 and (non-Chrome) Android browsers.\nThe assign() method is used to copy the values of all enumerable\nown properties from one or more source objects to a target object.\nIt will return the target object.\nModified from https://github.com/ljharb/object.assign

    \n", + "class": "p5", + "module": "Rendering" + }, + { + "file": "src/core/structure.js", + "line": 12, + "description": "

    Stops p5.js from continuously executing the code within draw().\nIf loop() is called, the code in draw() begins to run continuously again.\nIf using noLoop() in setup(), it should be the last line inside the block.\n

    \nWhen noLoop() is used, it's not possible to manipulate or access the\nscreen inside event handling functions such as mousePressed() or\nkeyPressed(). Instead, use those functions to call redraw() or loop(),\nwhich will run draw(), which can update the screen properly. This means\nthat when noLoop() has been called, no drawing can happen, and functions\nlike saveFrame() or loadPixels() may not be used.\n

    \nNote that if the sketch is resized, redraw() will be called to update\nthe sketch, even after noLoop() has been specified. Otherwise, the sketch\nwould enter an odd state until loop() was called.

    \n", + "itemtype": "method", + "name": "noLoop", + "example": [ + "\n
    \nfunction setup() {\n createCanvas(100, 100);\n background(200);\n noLoop();\n}\n\nfunction draw() {\n line(10, 10, 90, 90);\n}\n
    \n\n
    \nlet x = 0;\nfunction setup() {\n createCanvas(100, 100);\n}\n\nfunction draw() {\n background(204);\n x = x + 0.1;\n if (x > width) {\n x = 0;\n }\n line(x, 0, x, height);\n}\n\nfunction mousePressed() {\n noLoop();\n}\n\nfunction mouseReleased() {\n loop();\n}\n
    " + ], + "alt": "113 pixel long line extending from top-left to bottom right of canvas.\nhorizontal line moves slowly from left. Loops but stops on mouse press.", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/structure.js", + "line": 74, + "description": "

    By default, p5.js loops through draw() continuously, executing the code\nwithin it. However, the draw() loop may be stopped by calling noLoop().\nIn that case, the draw() loop can be resumed with loop().

    \n

    Avoid calling loop() from inside setup().

    \n", + "itemtype": "method", + "name": "loop", + "example": [ + "\n
    \nlet x = 0;\nfunction setup() {\n createCanvas(100, 100);\n noLoop();\n}\n\nfunction draw() {\n background(204);\n x = x + 0.1;\n if (x > width) {\n x = 0;\n }\n line(x, 0, x, height);\n}\n\nfunction mousePressed() {\n loop();\n}\n\nfunction mouseReleased() {\n noLoop();\n}\n
    " + ], + "alt": "horizontal line moves slowly from left. Loops but stops on mouse press.", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/structure.js", + "line": 122, + "description": "

    The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n

    \npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textSize(), textLeading().\n

    \nIn WEBGL mode additional style settings are stored. These are controlled by the following functions: setCamera(), ambientLight(), directionalLight(),\npointLight(), texture(), specularMaterial(), shininess(), normalMaterial()\nand shader().

    \n", + "itemtype": "method", + "name": "push", + "example": [ + "\n
    \n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\ntranslate(50, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n
    \n
    \n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n
    " + ], + "alt": "Gold ellipse + thick black outline @center 2 white ellipses on left and right.\n2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/structure.js", + "line": 191, + "description": "

    The push() function saves the current drawing style settings and\ntransformations, while pop() restores these settings. Note that these\nfunctions are always used together. They allow you to change the style\nand transformation settings and later return to what you had. When a new\nstate is started with push(), it builds on the current style and transform\ninformation. The push() and pop() functions can be embedded to provide\nmore control. (See the second example for a demonstration.)\n

    \npush() stores information related to the current transformation state\nand style settings controlled by the following functions: fill(),\nstroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),\nimageMode(), rectMode(), ellipseMode(), colorMode(), textAlign(),\ntextFont(), textSize(), textLeading().\n

    \nIn WEBGL mode additional style settings are stored. These are controlled by the following functions: setCamera(), ambientLight(), directionalLight(),\npointLight(), texture(), specularMaterial(), shininess(), normalMaterial()\nand shader().

    \n", + "itemtype": "method", + "name": "pop", + "example": [ + "\n
    \n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\ntranslate(50, 0);\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(0, 50, 33, 33); // Middle circle\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n
    \n
    \n\nellipse(0, 50, 33, 33); // Left circle\n\npush(); // Start a new drawing state\nstrokeWeight(10);\nfill(204, 153, 0);\nellipse(33, 50, 33, 33); // Left-middle circle\n\npush(); // Start another new drawing state\nstroke(0, 102, 153);\nellipse(66, 50, 33, 33); // Right-middle circle\npop(); // Restore previous state\n\npop(); // Restore original state\n\nellipse(100, 50, 33, 33); // Right circle\n\n
    " + ], + "alt": "Gold ellipse + thick black outline @center 2 white ellipses on left and right.\n2 Gold ellipses left black right blue stroke. 2 white ellipses on left+right.", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/structure.js", + "line": 261, + "description": "

    Executes the code within draw() one time. This functions allows the\n program to update the display window only when necessary, for example\n when an event registered by mousePressed() or keyPressed() occurs.\n

    \n In structuring a program, it only makes sense to call redraw() within\n events such as mousePressed(). This is because redraw() does not run\n draw() immediately (it only sets a flag that indicates an update is\n needed).\n

    \n The redraw() function does not work properly when called inside draw().\n To enable/disable animations, use loop() and noLoop().\n

    \n In addition you can set the number of redraws per method call. Just\n add an integer as single parameter for the number of redraws.

    \n", + "itemtype": "method", + "name": "redraw", + "params": [ + { + "name": "n", + "description": "

    Redraw for n-times. The default value is 1.

    \n", + "type": "Integer", + "optional": true + } + ], + "example": [ + "\n
    \n let x = 0;\nfunction setup() {\n createCanvas(100, 100);\n noLoop();\n }\nfunction draw() {\n background(204);\n line(x, 0, x, height);\n }\nfunction mousePressed() {\n x += 1;\n redraw();\n }\n
    \n
    \n let x = 0;\nfunction setup() {\n createCanvas(100, 100);\n noLoop();\n }\nfunction draw() {\n background(204);\n x += 1;\n line(x, 0, x, height);\n }\nfunction mousePressed() {\n redraw(5);\n }\n
    " + ], + "alt": "black line on far left of canvas\n black line on far left of canvas", + "class": "p5", + "module": "Structure", + "submodule": "Structure" + }, + { + "file": "src/core/transform.js", + "line": 13, + "description": "

    Multiplies the current matrix by the one specified through the parameters.\nThis is a powerful operation that can perform the equivalent of translate,\nscale, shear and rotate all at once. You can learn more about transformation\nmatrices on \nWikipedia.

    \n

    The naming of the arguments here follows the naming of the \nWHATWG specification and corresponds to a\ntransformation matrix of the\nform:

    \n
    \n

    \n
    \n", + "itemtype": "method", + "name": "applyMatrix", + "params": [ + { + "name": "a", + "description": "

    numbers which define the 2x3 matrix to be multiplied

    \n", + "type": "Number" + }, + { + "name": "b", + "description": "

    numbers which define the 2x3 matrix to be multiplied

    \n", + "type": "Number" + }, + { + "name": "c", + "description": "

    numbers which define the 2x3 matrix to be multiplied

    \n", + "type": "Number" + }, + { + "name": "d", + "description": "

    numbers which define the 2x3 matrix to be multiplied

    \n", + "type": "Number" + }, + { + "name": "e", + "description": "

    numbers which define the 2x3 matrix to be multiplied

    \n", + "type": "Number" + }, + { + "name": "f", + "description": "

    numbers which define the 2x3 matrix to be multiplied

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n // Equivalent to translate(x, y);\n applyMatrix(1, 0, 0, 1, 40 + step, 50);\n rect(0, 0, 50, 50);\n}\n\n
    \n
    \n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n background(200);\n translate(50, 50);\n // Equivalent to scale(x, y);\n applyMatrix(1 / step, 0, 0, 1 / step, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n
    \n
    \n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n var angle = map(step, 0, 20, 0, TWO_PI);\n var cos_a = cos(angle);\n var sin_a = sin(angle);\n background(200);\n translate(50, 50);\n // Equivalent to rotate(angle);\n applyMatrix(cos_a, sin_a, -sin_a, cos_a, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n
    \n
    \n\nfunction setup() {\n frameRate(10);\n rectMode(CENTER);\n}\n\nfunction draw() {\n var step = frameCount % 20;\n var angle = map(step, 0, 20, -PI / 4, PI / 4);\n background(200);\n translate(50, 50);\n // equivalent to shearX(angle);\n var shear_factor = 1 / tan(PI / 2 - angle);\n applyMatrix(1, 0, shear_factor, 1, 0, 0);\n rect(0, 0, 50, 50);\n}\n\n
    \n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n noFill();\n}\n\nfunction draw() {\n background(200);\n rotateY(PI / 6);\n stroke(153);\n box(35);\n var rad = millis() / 1000;\n // Set rotation angles\n var ct = cos(rad);\n var st = sin(rad);\n // Matrix for rotation around the Y axis\n applyMatrix( ct, 0.0, st, 0.0,\n 0.0, 1.0, 0.0, 0.0,\n -st, 0.0, ct, 0.0,\n 0.0, 0.0, 0.0, 1.0);\n stroke(255);\n box(50);\n}\n\n
    " + ], + "alt": "A rectangle translating to the right\nA rectangle shrinking to the center\nA rectangle rotating clockwise about the center\nA rectangle shearing", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 150, + "description": "

    Replaces the current matrix with the identity matrix.

    \n", + "itemtype": "method", + "name": "resetMatrix", + "chainable": 1, + "example": [ + "\n
    \n\ntranslate(50, 50);\napplyMatrix(0.5, 0.5, -0.5, 0.5, 0, 0);\nrect(0, 0, 20, 20);\n// Note that the translate is also reset.\nresetMatrix();\nrect(0, 0, 20, 20);\n\n
    " + ], + "alt": "A rotated retangle in the center with another at the top left corner", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 176, + "description": "

    Rotates a shape the amount specified by the angle parameter. This\nfunction accounts for angleMode, so angles can be entered in either\nRADIANS or DEGREES.\n

    \nObjects are always rotated around their relative position to the\norigin and positive numbers rotate objects in a clockwise direction.\nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nrotate(HALF_PI) and then rotate(HALF_PI) is the same as rotate(PI).\nAll tranformations are reset when draw() begins again.\n

    \nTechnically, rotate() multiplies the current transformation matrix\nby a rotation matrix. This function can be further controlled by\nthe push() and pop().

    \n", + "itemtype": "method", + "name": "rotate", + "params": [ + { + "name": "angle", + "description": "

    the angle of rotation, specified in radians\n or degrees, depending on current angleMode

    \n", + "type": "Number" + }, + { + "name": "axis", + "description": "

    (in 3d) the axis to rotate around

    \n", + "type": "p5.Vector|Number[]", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\ntranslate(width / 2, height / 2);\nrotate(PI / 3.0);\nrect(-26, -26, 52, 52);\n\n
    " + ], + "alt": "white 52x52 rect with black outline at center rotated counter 45 degrees", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 216, + "description": "

    Rotates around X axis.

    \n", + "itemtype": "method", + "name": "rotateX", + "params": [ + { + "name": "angle", + "description": "

    the angle of rotation, specified in radians\n or degrees, depending on current angleMode

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(255);\n rotateX(millis() / 1000);\n box();\n}\n\n
    " + ], + "alt": "3d box rotating around the x axis.", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 246, + "description": "

    Rotates around Y axis.

    \n", + "itemtype": "method", + "name": "rotateY", + "params": [ + { + "name": "angle", + "description": "

    the angle of rotation, specified in radians\n or degrees, depending on current angleMode

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(255);\n rotateY(millis() / 1000);\n box();\n}\n\n
    " + ], + "alt": "3d box rotating around the y axis.", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 276, + "description": "

    Rotates around Z axis. Webgl mode only.

    \n", + "itemtype": "method", + "name": "rotateZ", + "params": [ + { + "name": "angle", + "description": "

    the angle of rotation, specified in radians\n or degrees, depending on current angleMode

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(255);\n rotateZ(millis() / 1000);\n box();\n}\n\n
    " + ], + "alt": "3d box rotating around the z axis.", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 306, + "description": "

    Increases or decreases the size of a shape by expanding and contracting\nvertices. Objects always scale from their relative origin to the\ncoordinate system. Scale values are specified as decimal percentages.\nFor example, the function call scale(2.0) increases the dimension of a\nshape by 200%.\n

    \nTransformations apply to everything that happens after and subsequent\ncalls to the function multiply the effect. For example, calling scale(2.0)\nand then scale(1.5) is the same as scale(3.0). If scale() is called\nwithin draw(), the transformation is reset when the loop begins again.\n

    \nUsing this function with the z parameter is only available in WEBGL mode.\nThis function can be further controlled with push() and pop().

    \n", + "itemtype": "method", + "name": "scale", + "chainable": 1, + "example": [ + "\n
    \n\nrect(30, 20, 50, 50);\nscale(0.5);\nrect(30, 20, 50, 50);\n\n
    \n\n
    \n\nrect(30, 20, 50, 50);\nscale(0.5, 1.3);\nrect(30, 20, 50, 50);\n\n
    " + ], + "alt": "white 52x52 rect with black outline at center rotated counter 45 degrees\n2 white rects with black outline- 1 50x50 at center. other 25x65 bottom left", + "class": "p5", + "module": "Transform", + "submodule": "Transform", + "overloads": [ + { + "line": 306, + "params": [ + { + "name": "s", + "description": "

    percent to scale the object, or percentage to\n scale the object in the x-axis if multiple arguments\n are given

    \n", + "type": "Number|p5.Vector|Number[]" + }, + { + "name": "y", + "description": "

    percent to scale the object in the y-axis

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    percent to scale the object in the z-axis (webgl only)

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 351, + "params": [ + { + "name": "scales", + "description": "

    per-axis percents to scale the object

    \n", + "type": "p5.Vector|Number[]" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/core/transform.js", + "line": 381, + "description": "

    Shears a shape around the x-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode.\nObjects are always sheared around their relative position to the origin\nand positive numbers shear objects in a clockwise direction.\n

    \nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearX(PI/2) and then shearX(PI/2) is the same as shearX(PI).\nIf shearX() is called within the draw(), the transformation is reset when\nthe loop begins again.\n

    \nTechnically, shearX() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.

    \n", + "itemtype": "method", + "name": "shearX", + "params": [ + { + "name": "angle", + "description": "

    angle of shear specified in radians or degrees,\n depending on current angleMode

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\ntranslate(width / 4, height / 4);\nshearX(PI / 4.0);\nrect(0, 0, 30, 30);\n\n
    " + ], + "alt": "white irregular quadrilateral with black outline at top middle.", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 421, + "description": "

    Shears a shape around the y-axis the amount specified by the angle\nparameter. Angles should be specified in the current angleMode. Objects\nare always sheared around their relative position to the origin and\npositive numbers shear objects in a clockwise direction.\n

    \nTransformations apply to everything that happens after and subsequent\ncalls to the function accumulates the effect. For example, calling\nshearY(PI/2) and then shearY(PI/2) is the same as shearY(PI). If\nshearY() is called within the draw(), the transformation is reset when\nthe loop begins again.\n

    \nTechnically, shearY() multiplies the current transformation matrix by a\nrotation matrix. This function can be further controlled by the\npush() and pop() functions.

    \n", + "itemtype": "method", + "name": "shearY", + "params": [ + { + "name": "angle", + "description": "

    angle of shear specified in radians or degrees,\n depending on current angleMode

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\ntranslate(width / 4, height / 4);\nshearY(PI / 4.0);\nrect(0, 0, 30, 30);\n\n
    " + ], + "alt": "white irregular quadrilateral with black outline at middle bottom.", + "class": "p5", + "module": "Transform", + "submodule": "Transform" + }, + { + "file": "src/core/transform.js", + "line": 461, + "description": "

    Specifies an amount to displace objects within the display window.\nThe x parameter specifies left/right translation, the y parameter\nspecifies up/down translation.\n

    \nTransformations are cumulative and apply to everything that happens after\nand subsequent calls to the function accumulates the effect. For example,\ncalling translate(50, 0) and then translate(20, 0) is the same as\ntranslate(70, 0). If translate() is called within draw(), the\ntransformation is reset when the loop begins again. This function can be\nfurther controlled by using push() and pop().

    \n", + "itemtype": "method", + "name": "translate", + "chainable": 1, + "example": [ + "\n
    \n\ntranslate(30, 20);\nrect(0, 0, 55, 55);\n\n
    \n\n
    \n\nrect(0, 0, 55, 55); // Draw rect at original 0,0\ntranslate(30, 20);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\ntranslate(14, 14);\nrect(0, 0, 55, 55); // Draw rect at new 0,0\n\n
    \n\n\n
    \n\nfunction draw() {\n background(200);\n rectMode(CENTER);\n translate(width / 2, height / 2);\n translate(p5.Vector.fromAngle(millis() / 1000, 40));\n rect(0, 0, 20, 20);\n}\n\n
    " + ], + "alt": "white 55x55 rect with black outline at center right.\n3 white 55x55 rects with black outlines at top-l, center-r and bottom-r.\na 20x20 white rect moving in a circle around the canvas", + "class": "p5", + "module": "Transform", + "submodule": "Transform", + "overloads": [ + { + "line": 461, + "params": [ + { + "name": "x", + "description": "

    left/right translation

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    up/down translation

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    forward/backward translation (webgl only)

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 515, + "params": [ + { + "name": "vector", + "description": "

    the vector to translate by

    \n", + "type": "p5.Vector" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 16, + "description": "

    Creates a new instance of p5.StringDict using the key-value pair\n or the object you provide.

    \n", + "itemtype": "method", + "name": "createStringDict", + "return": { + "description": "", + "type": "p5.StringDict" + }, + "example": [ + "\n
    \n \n function setup() {\n let myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // logs true to console\n let anotherDictionary = createStringDict({ happy: 'coding' });\n print(anotherDictionary.hasKey('happy')); // logs true to console\n }\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Dictionary", + "overloads": [ + { + "line": 16, + "params": [ + { + "name": "key", + "description": "", + "type": "String" + }, + { + "name": "value", + "description": "", + "type": "String" + } + ], + "return": { + "description": "", + "type": "p5.StringDict" + } + }, + { + "line": 39, + "params": [ + { + "name": "object", + "description": "

    object

    \n", + "type": "Object" + } + ], + "return": { + "description": "", + "type": "p5.StringDict" + } + } + ] + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 50, + "description": "

    Creates a new instance of p5.NumberDict using the key-value pair\n or object you provide.

    \n", + "itemtype": "method", + "name": "createNumberDict", + "return": { + "description": "", + "type": "p5.NumberDict" + }, + "example": [ + "\n
    \n \n function setup() {\n let myDictionary = createNumberDict(100, 42);\n print(myDictionary.hasKey(100)); // logs true to console\n let anotherDictionary = createNumberDict({ 200: 84 });\n print(anotherDictionary.hasKey(200)); // logs true to console\n }\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Dictionary", + "overloads": [ + { + "line": 50, + "params": [ + { + "name": "key", + "description": "", + "type": "Number" + }, + { + "name": "value", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "", + "type": "p5.NumberDict" + } + }, + { + "line": 73, + "params": [ + { + "name": "object", + "description": "

    object

    \n", + "type": "Object" + } + ], + "return": { + "description": "", + "type": "p5.NumberDict" + } + } + ] + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 103, + "description": "

    Returns the number of key-value pairs currently stored in the Dictionary.

    \n", + "itemtype": "method", + "name": "size", + "return": { + "description": "the number of key-value pairs in the Dictionary", + "type": "Integer" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict(1, 10);\n myDictionary.create(2, 20);\n myDictionary.create(3, 30);\n print(myDictionary.size()); // logs 3 to the console\n}\n
    \n" + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 125, + "description": "

    Returns true if the given key exists in the Dictionary,\notherwise returns false.

    \n", + "itemtype": "method", + "name": "hasKey", + "params": [ + { + "name": "key", + "description": "

    that you want to look up

    \n", + "type": "Number|String" + } + ], + "return": { + "description": "whether that key exists in Dictionary", + "type": "Boolean" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // logs true to console\n}\n
    \n" + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 148, + "description": "

    Returns the value stored at the given key.

    \n", + "itemtype": "method", + "name": "get", + "params": [ + { + "name": "the", + "description": "

    key you want to access

    \n", + "type": "Number|String" + } + ], + "return": { + "description": "the value stored at that key", + "type": "Number|String" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createStringDict('p5', 'js');\n let myValue = myDictionary.get('p5');\n print(myValue === 'js'); // logs true to console\n}\n
    \n" + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 175, + "description": "

    Updates the value associated with the given key in case it already exists\nin the Dictionary. Otherwise a new key-value pair is added.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "key", + "description": "", + "type": "Number|String" + }, + { + "name": "value", + "description": "", + "type": "Number|String" + } + ], + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createStringDict('p5', 'js');\n myDictionary.set('p5', 'JS');\n myDictionary.print(); // logs \"key: p5 - value: JS\" to console\n}\n
    \n" + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 203, + "description": "

    private helper function to handle the user passing in objects\nduring construction or calls to create()

    \n", + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 214, + "description": "

    Creates a new key-value pair in the Dictionary.

    \n", + "itemtype": "method", + "name": "create", + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print();\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n}\n
    " + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary", + "overloads": [ + { + "line": 214, + "params": [ + { + "name": "key", + "description": "", + "type": "Number|String" + }, + { + "name": "value", + "description": "", + "type": "Number|String" + } + ] + }, + { + "line": 232, + "params": [ + { + "name": "obj", + "description": "

    key/value pair

    \n", + "type": "Object" + } + ] + } + ] + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 250, + "description": "

    Removes all previously stored key-value pairs from the Dictionary.

    \n", + "itemtype": "method", + "name": "clear", + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createStringDict('p5', 'js');\n print(myDictionary.hasKey('p5')); // prints 'true'\n myDictionary.clear();\n print(myDictionary.hasKey('p5')); // prints 'false'\n}\n\n
    " + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 271, + "description": "

    Removes the key-value pair stored at the given key from the Dictionary.

    \n", + "itemtype": "method", + "name": "remove", + "params": [ + { + "name": "key", + "description": "

    for the pair to remove

    \n", + "type": "Number|String" + } + ], + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print();\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n myDictionary.remove('p5');\n myDictionary.print();\n // above logs \"key: happy value: coding\" to console\n}\n
    \n" + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 301, + "description": "

    Logs the set of items currently stored in the Dictionary to the console.

    \n", + "itemtype": "method", + "name": "print", + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createStringDict('p5', 'js');\n myDictionary.create('happy', 'coding');\n myDictionary.print();\n // above logs \"key: p5 - value: js, key: happy - value: coding\" to console\n}\n\n
    " + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 325, + "description": "

    Converts the Dictionary into a CSV file for local download.

    \n", + "itemtype": "method", + "name": "saveTable", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100);\n background(200);\n text('click here to save', 10, 10, 70, 80);\n}\n\nfunction mousePressed() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n createStringDict({\n john: 1940,\n paul: 1942,\n george: 1943,\n ringo: 1940\n }).saveTable('beatles');\n }\n}\n\n
    " + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 363, + "description": "

    Converts the Dictionary into a JSON file for local download.

    \n", + "itemtype": "method", + "name": "saveJSON", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100);\n background(200);\n text('click here to save', 10, 10, 70, 80);\n}\n\nfunction mousePressed() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n createStringDict({\n john: 1940,\n paul: 1942,\n george: 1943,\n ringo: 1940\n }).saveJSON('beatles');\n }\n}\n\n
    " + ], + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 394, + "description": "

    private helper function to ensure that the user passed in valid\nvalues for the Dictionary type

    \n", + "class": "p5.TypedDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 437, + "description": "

    private helper function to ensure that the user passed in valid\nvalues for the Dictionary type

    \n", + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 446, + "description": "

    Add the given number to the value currently stored at the given key.\nThe sum then replaces the value previously stored in the Dictionary.

    \n", + "itemtype": "method", + "name": "add", + "params": [ + { + "name": "Key", + "description": "

    for the value you wish to add to

    \n", + "type": "Number" + }, + { + "name": "Number", + "description": "

    to add to the value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict(2, 5);\n myDictionary.add(2, 2);\n print(myDictionary.get(2)); // logs 7 to console.\n}\n
    \n\n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 474, + "description": "

    Subtract the given number from the value currently stored at the given key.\nThe difference then replaces the value previously stored in the Dictionary.

    \n", + "itemtype": "method", + "name": "sub", + "params": [ + { + "name": "Key", + "description": "

    for the value you wish to subtract from

    \n", + "type": "Number" + }, + { + "name": "Number", + "description": "

    to subtract from the value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict(2, 5);\n myDictionary.sub(2, 2);\n print(myDictionary.get(2)); // logs 3 to console.\n}\n
    \n\n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 498, + "description": "

    Multiply the given number with the value currently stored at the given key.\nThe product then replaces the value previously stored in the Dictionary.

    \n", + "itemtype": "method", + "name": "mult", + "params": [ + { + "name": "Key", + "description": "

    for value you wish to multiply

    \n", + "type": "Number" + }, + { + "name": "Amount", + "description": "

    to multiply the value by

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict(2, 4);\n myDictionary.mult(2, 2);\n print(myDictionary.get(2)); // logs 8 to console.\n}\n
    \n\n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 526, + "description": "

    Divide the given number with the value currently stored at the given key.\nThe quotient then replaces the value previously stored in the Dictionary.

    \n", + "itemtype": "method", + "name": "div", + "params": [ + { + "name": "Key", + "description": "

    for value you wish to divide

    \n", + "type": "Number" + }, + { + "name": "Amount", + "description": "

    to divide the value by

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict(2, 8);\n myDictionary.div(2, 2);\n print(myDictionary.get(2)); // logs 4 to console.\n}\n
    \n\n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 554, + "description": "

    private helper function for finding lowest or highest value\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'

    \n", + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 579, + "description": "

    Return the lowest number currently stored in the Dictionary.

    \n", + "itemtype": "method", + "name": "minValue", + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 });\n let lowestValue = myDictionary.minValue(); // value is -10\n print(lowestValue);\n}\n
    \n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 600, + "description": "

    Return the highest number currently stored in the Dictionary.

    \n", + "itemtype": "method", + "name": "maxValue", + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 });\n let highestValue = myDictionary.maxValue(); // value is 3\n print(highestValue);\n}\n
    \n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 621, + "description": "

    private helper function for finding lowest or highest key\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'

    \n", + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 644, + "description": "

    Return the lowest key currently used in the Dictionary.

    \n", + "itemtype": "method", + "name": "minKey", + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 });\n let lowestKey = myDictionary.minKey(); // value is 1.2\n print(lowestKey);\n}\n
    \n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/data/p5.TypedDict.js", + "line": 665, + "description": "

    Return the highest key currently used in the Dictionary.

    \n", + "itemtype": "method", + "name": "maxKey", + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 });\n let highestKey = myDictionary.maxKey(); // value is 4\n print(highestKey);\n}\n
    \n" + ], + "class": "p5.NumberDict", + "module": "Data", + "submodule": "Dictionary" + }, + { + "file": "src/events/acceleration.js", + "line": 12, + "description": "

    The system variable deviceOrientation always contains the orientation of\nthe device. The value of this variable will either be set 'landscape'\nor 'portrait'. If no data is available it will be set to 'undefined'.\neither LANDSCAPE or PORTRAIT.

    \n", + "itemtype": "property", + "name": "deviceOrientation", + "type": "Constant", + "readonly": "", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 23, + "description": "

    The system variable accelerationX always contains the acceleration of the\ndevice along the x axis. Value is represented as meters per second squared.

    \n", + "itemtype": "property", + "name": "accelerationX", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\n// Move a touchscreen device to register\n// acceleration changes.\nfunction draw() {\n background(220, 50);\n fill('magenta');\n ellipse(width / 2, height / 2, accelerationX);\n}\n\n
    " + ], + "alt": "Magnitude of device acceleration is displayed as ellipse size", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 46, + "description": "

    The system variable accelerationY always contains the acceleration of the\ndevice along the y axis. Value is represented as meters per second squared.

    \n", + "itemtype": "property", + "name": "accelerationY", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\n// Move a touchscreen device to register\n// acceleration changes.\nfunction draw() {\n background(220, 50);\n fill('magenta');\n ellipse(width / 2, height / 2, accelerationY);\n}\n\n
    " + ], + "alt": "Magnitude of device acceleration is displayed as ellipse size", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 69, + "description": "

    The system variable accelerationZ always contains the acceleration of the\ndevice along the z axis. Value is represented as meters per second squared.

    \n", + "itemtype": "property", + "name": "accelerationZ", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\n// Move a touchscreen device to register\n// acceleration changes.\nfunction draw() {\n background(220, 50);\n fill('magenta');\n ellipse(width / 2, height / 2, accelerationZ);\n}\n\n
    " + ], + "alt": "Magnitude of device acceleration is displayed as ellipse size", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 94, + "description": "

    The system variable pAccelerationX always contains the acceleration of the\ndevice along the x axis in the frame previous to the current frame. Value\nis represented as meters per second squared.

    \n", + "itemtype": "property", + "name": "pAccelerationX", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 104, + "description": "

    The system variable pAccelerationY always contains the acceleration of the\ndevice along the y axis in the frame previous to the current frame. Value\nis represented as meters per second squared.

    \n", + "itemtype": "property", + "name": "pAccelerationY", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 114, + "description": "

    The system variable pAccelerationZ always contains the acceleration of the\ndevice along the z axis in the frame previous to the current frame. Value\nis represented as meters per second squared.

    \n", + "itemtype": "property", + "name": "pAccelerationZ", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 135, + "description": "

    The system variable rotationX always contains the rotation of the\ndevice along the x axis. Value is represented as 0 to +/-180 degrees.\n

    \nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.

    \n", + "itemtype": "property", + "name": "rotationX", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n //rotateZ(radians(rotationZ));\n rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n
    " + ], + "alt": "red horizontal line right, green vertical line bottom. black background.", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 166, + "description": "

    The system variable rotationY always contains the rotation of the\ndevice along the y axis. Value is represented as 0 to +/-90 degrees.\n

    \nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.

    \n", + "itemtype": "property", + "name": "rotationY", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n //rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n
    " + ], + "alt": "red horizontal line right, green vertical line bottom. black background.", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 197, + "description": "

    The system variable rotationZ always contains the rotation of the\ndevice along the z axis. Value is represented as 0 to 359 degrees.\n

    \nUnlike rotationX and rotationY, this variable is available for devices\nwith a built-in compass only.\n

    \nNote: The order the rotations are called is important, ie. if used\ntogether, it must be called in the order Z-X-Y or there might be\nunexpected behaviour.

    \n", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateZ(radians(rotationZ));\n //rotateX(radians(rotationX));\n //rotateY(radians(rotationY));\n box(200, 200, 200);\n}\n\n
    " + ], + "itemtype": "property", + "name": "rotationZ", + "type": "Number", + "readonly": "", + "alt": "red horizontal line right, green vertical line bottom. black background.", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 233, + "description": "

    The system variable pRotationX always contains the rotation of the\ndevice along the x axis in the frame previous to the current frame. Value\nis represented as 0 to +/-180 degrees.\n

    \npRotationX can also be used with rotationX to determine the rotate\ndirection of the device along the X-axis.

    \n", + "example": [ + "\n
    \n\n// A simple if statement looking at whether\n// rotationX - pRotationX < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nlet rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely necessary but the logic\n// will be different in that case.\n\nlet rX = rotationX + 180;\nlet pRX = pRotationX + 180;\n\nif ((rX - pRX > 0 && rX - pRX < 270) || rX - pRX < -270) {\n rotateDirection = 'clockwise';\n} else if (rX - pRX < 0 || rX - pRX > 270) {\n rotateDirection = 'counter-clockwise';\n}\n\nprint(rotateDirection);\n\n
    " + ], + "alt": "no image to display.", + "itemtype": "property", + "name": "pRotationX", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 278, + "description": "

    The system variable pRotationY always contains the rotation of the\ndevice along the y axis in the frame previous to the current frame. Value\nis represented as 0 to +/-90 degrees.\n

    \npRotationY can also be used with rotationY to determine the rotate\ndirection of the device along the Y-axis.

    \n", + "example": [ + "\n
    \n\n// A simple if statement looking at whether\n// rotationY - pRotationY < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nlet rotateDirection = 'clockwise';\n\n// Simple range conversion to make things simpler.\n// This is not absolutely necessary but the logic\n// will be different in that case.\n\nlet rY = rotationY + 180;\nlet pRY = pRotationY + 180;\n\nif ((rY - pRY > 0 && rY - pRY < 270) || rY - pRY < -270) {\n rotateDirection = 'clockwise';\n} else if (rY - pRY < 0 || rY - pRY > 270) {\n rotateDirection = 'counter-clockwise';\n}\nprint(rotateDirection);\n\n
    " + ], + "alt": "no image to display.", + "itemtype": "property", + "name": "pRotationY", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 322, + "description": "

    The system variable pRotationZ always contains the rotation of the\ndevice along the z axis in the frame previous to the current frame. Value\nis represented as 0 to 359 degrees.\n

    \npRotationZ can also be used with rotationZ to determine the rotate\ndirection of the device along the Z-axis.

    \n", + "example": [ + "\n
    \n\n// A simple if statement looking at whether\n// rotationZ - pRotationZ < 0 is true or not will be\n// sufficient for determining the rotate direction\n// in most cases.\n\n// Some extra logic is needed to account for cases where\n// the angles wrap around.\nlet rotateDirection = 'clockwise';\n\nif (\n (rotationZ - pRotationZ > 0 && rotationZ - pRotationZ < 270) ||\n rotationZ - pRotationZ < -270\n) {\n rotateDirection = 'clockwise';\n} else if (rotationZ - pRotationZ < 0 || rotationZ - pRotationZ > 270) {\n rotateDirection = 'counter-clockwise';\n}\nprint(rotateDirection);\n\n
    " + ], + "alt": "no image to display.", + "itemtype": "property", + "name": "pRotationZ", + "type": "Number", + "readonly": "", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 380, + "description": "

    When a device is rotated, the axis that triggers the deviceTurned()\nmethod is stored in the turnAxis variable. The turnAxis variable is only defined within\nthe scope of deviceTurned().

    \n", + "itemtype": "property", + "name": "turnAxis", + "type": "String", + "readonly": "", + "example": [ + "\n
    \n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees in the\n// X-axis to change the value.\n\nvar value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (turnAxis === 'X') {\n if (value === 0) {\n value = 255;\n } else if (value === 255) {\n value = 0;\n }\n }\n}\n\n
    " + ], + "alt": "50x50 black rect in center of canvas. turns white on mobile when device turns\n50x50 black rect in center of canvas. turns white on mobile when x-axis turns", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 419, + "description": "

    The setMoveThreshold() function is used to set the movement threshold for\nthe deviceMoved() function. The default threshold is set to 0.5.

    \n", + "itemtype": "method", + "name": "setMoveThreshold", + "params": [ + { + "name": "value", + "description": "

    The threshold value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\n// Run this example on a mobile device\n// You will need to move the device incrementally further\n// the closer the square's color gets to white in order to change the value.\n\nlet value = 0;\nlet threshold = 0.5;\nfunction setup() {\n setMoveThreshold(threshold);\n}\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceMoved() {\n value = value + 5;\n threshold = threshold + 0.1;\n if (value > 255) {\n value = 0;\n threshold = 30;\n }\n setMoveThreshold(threshold);\n}\n\n
    " + ], + "alt": "50x50 black rect in center of canvas. turns white on mobile when device moves", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 462, + "description": "

    The setShakeThreshold() function is used to set the movement threshold for\nthe deviceShaken() function. The default threshold is set to 30.

    \n", + "itemtype": "method", + "name": "setShakeThreshold", + "params": [ + { + "name": "value", + "description": "

    The threshold value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\n// Run this example on a mobile device\n// You will need to shake the device more firmly\n// the closer the box's fill gets to white in order to change the value.\n\nlet value = 0;\nlet threshold = 30;\nfunction setup() {\n setShakeThreshold(threshold);\n}\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceMoved() {\n value = value + 5;\n threshold = threshold + 5;\n if (value > 255) {\n value = 0;\n threshold = 30;\n }\n setShakeThreshold(threshold);\n}\n\n
    " + ], + "alt": "50x50 black rect in center of canvas. turns white on mobile when device\nis being shaked", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 506, + "description": "

    The deviceMoved() function is called when the device is moved by more than\nthe threshold value along X, Y or Z axis. The default threshold is set to 0.5.\nThe threshold value can be changed using setMoveThreshold().

    \n", + "itemtype": "method", + "name": "deviceMoved", + "example": [ + "\n
    \n\n// Run this example on a mobile device\n// Move the device around\n// to change the value.\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceMoved() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n
    " + ], + "alt": "50x50 black rect in center of canvas. turns white on mobile when device moves", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 538, + "description": "

    The deviceTurned() function is called when the device rotates by\nmore than 90 degrees continuously.\n

    \nThe axis that triggers the deviceTurned() method is stored in the turnAxis\nvariable. The deviceTurned() method can be locked to trigger on any axis:\nX, Y or Z by comparing the turnAxis variable to 'X', 'Y' or 'Z'.

    \n", + "itemtype": "method", + "name": "deviceTurned", + "example": [ + "\n
    \n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees\n// to change the value.\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (value === 0) {\n value = 255;\n } else if (value === 255) {\n value = 0;\n }\n}\n\n
    \n
    \n\n// Run this example on a mobile device\n// Rotate the device by 90 degrees in the\n// X-axis to change the value.\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceTurned() {\n if (turnAxis === 'X') {\n if (value === 0) {\n value = 255;\n } else if (value === 255) {\n value = 0;\n }\n }\n}\n\n
    " + ], + "alt": "50x50 black rect in center of canvas. turns white on mobile when device turns\n50x50 black rect in center of canvas. turns white on mobile when x-axis turns", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/acceleration.js", + "line": 597, + "description": "

    The deviceShaken() function is called when the device total acceleration\nchanges of accelerationX and accelerationY values is more than\nthe threshold value. The default threshold is set to 30.\nThe threshold value can be changed using setShakeThreshold().

    \n", + "itemtype": "method", + "name": "deviceShaken", + "example": [ + "\n
    \n\n// Run this example on a mobile device\n// Shake the device to change the value.\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction deviceShaken() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n
    " + ], + "alt": "50x50 black rect in center of canvas. turns white on mobile when device shakes", + "class": "p5", + "module": "Events", + "submodule": "Acceleration" + }, + { + "file": "src/events/keyboard.js", + "line": 12, + "description": "

    The boolean system variable keyIsPressed is true if any key is pressed\nand false if no keys are pressed.

    \n", + "itemtype": "property", + "name": "keyIsPressed", + "type": "Boolean", + "readonly": "", + "example": [ + "\n
    \n\nfunction draw() {\n if (keyIsPressed === true) {\n fill(0);\n } else {\n fill(255);\n }\n rect(25, 25, 50, 50);\n}\n\n
    " + ], + "alt": "50x50 white rect that turns black on keypress.", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/keyboard.js", + "line": 39, + "description": "

    The system variable key always contains the value of the most recent\nkey on the keyboard that was typed. To get the proper capitalization, it\nis best to use it within keyTyped(). For non-ASCII keys, use the keyCode\nvariable.

    \n", + "itemtype": "property", + "name": "key", + "type": "String", + "readonly": "", + "example": [ + "\n
    \n// Click any key to display it!\n// (Not Guaranteed to be Case Sensitive)\nfunction setup() {\n fill(245, 123, 158);\n textSize(50);\n}\n\nfunction draw() {\n background(200);\n text(key, 33, 65); // Display last key pressed.\n}\n
    " + ], + "alt": "canvas displays any key value that is pressed in pink font.", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/keyboard.js", + "line": 68, + "description": "

    The variable keyCode is used to detect special keys such as BACKSPACE,\nDELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL, OPTION, ALT, UP_ARROW,\nDOWN_ARROW, LEFT_ARROW, RIGHT_ARROW.\nYou can also check for custom keys by looking up the keyCode of any key\non a site like this: keycode.info.

    \n", + "itemtype": "property", + "name": "keyCode", + "type": "Integer", + "readonly": "", + "example": [ + "\n
    \nlet fillVal = 126;\nfunction draw() {\n fill(fillVal);\n rect(25, 25, 50, 50);\n}\n\nfunction keyPressed() {\n if (keyCode === UP_ARROW) {\n fillVal = 255;\n } else if (keyCode === DOWN_ARROW) {\n fillVal = 0;\n }\n return false; // prevent default\n}\n
    \n
    \nfunction draw() {}\nfunction keyPressed() {\n background('yellow');\n text(`${key} ${keyCode}`, 10, 40);\n print(key, ' ', keyCode);\n return false; // prevent default\n}\n
    " + ], + "alt": "Grey rect center. turns white when up arrow pressed and black when down\nDisplay key pressed and its keyCode in a yellow box", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/keyboard.js", + "line": 109, + "description": "

    The keyPressed() function is called once every time a key is pressed. The\nkeyCode for the key that was pressed is stored in the keyCode variable.\n

    \nFor non-ASCII keys, use the keyCode variable. You can check if the keyCode\nequals BACKSPACE, DELETE, ENTER, RETURN, TAB, ESCAPE, SHIFT, CONTROL,\nOPTION, ALT, UP_ARROW, DOWN_ARROW, LEFT_ARROW, RIGHT_ARROW.\n

    \nFor ASCII keys, the key that was pressed is stored in the key variable. However, it\ndoes not distinguish between uppercase and lowercase. For this reason, it\nis recommended to use keyTyped() to read the key variable, in which the\ncase of the variable will be distinguished.\n

    \nBecause of how operating systems handle key repeats, holding down a key\nmay cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.

    \nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.

    \n", + "itemtype": "method", + "name": "keyPressed", + "example": [ + "\n
    \n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n
    \n
    \n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyPressed() {\n if (keyCode === LEFT_ARROW) {\n value = 255;\n } else if (keyCode === RIGHT_ARROW) {\n value = 0;\n }\n}\n\n
    \n
    \n\nfunction keyPressed() {\n // Do something\n return false; // prevent any default behaviour\n}\n\n
    " + ], + "alt": "black rect center. turns white when key pressed and black when released\nblack rect center. turns white when left arrow pressed and black when right.", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/keyboard.js", + "line": 196, + "description": "

    The keyReleased() function is called once every time a key is released.\nSee key and keyCode for more information.

    \nBrowsers may have different default\nbehaviors attached to various key events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.

    \n", + "itemtype": "method", + "name": "keyReleased", + "example": [ + "\n
    \n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyReleased() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n return false; // prevent any default behavior\n}\n\n
    " + ], + "alt": "black rect center. turns white when key pressed and black when pressed again", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/keyboard.js", + "line": 248, + "description": "

    The keyTyped() function is called once every time a key is pressed, but\naction keys such as Ctrl, Shift, and Alt are ignored. The most recent\nkey pressed will be stored in the key variable.\n

    \nBecause of how operating systems handle key repeats, holding down a key\nwill cause multiple calls to keyTyped() (and keyReleased() as well). The\nrate of repeat is set by the operating system and how each computer is\nconfigured.

    \nBrowsers may have different default behaviors attached to various key\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.

    \n", + "itemtype": "method", + "name": "keyTyped", + "example": [ + "\n
    \n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction keyTyped() {\n if (key === 'a') {\n value = 255;\n } else if (key === 'b') {\n value = 0;\n }\n // uncomment to prevent any default behavior\n // return false;\n}\n\n
    " + ], + "alt": "black rect center. turns white when 'a' key typed and black when 'b' pressed", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/keyboard.js", + "line": 302, + "description": "

    The onblur function is called when the user is no longer focused\non the p5 element. Because the keyup events will not fire if the user is\nnot focused on the element we must assume all keys currently down have\nbeen released.

    \n", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/keyboard.js", + "line": 312, + "description": "

    The keyIsDown() function checks if the key is currently down, i.e. pressed.\nIt can be used if you have an object that moves, and you want several keys\nto be able to affect its behaviour simultaneously, such as moving a\nsprite diagonally. You can put in any number representing the keyCode of\nthe key, or use any of the variable keyCode names listed\nhere.

    \n", + "itemtype": "method", + "name": "keyIsDown", + "params": [ + { + "name": "code", + "description": "

    The key to check for.

    \n", + "type": "Number" + } + ], + "return": { + "description": "whether key is down or not", + "type": "Boolean" + }, + "example": [ + "\n
    \nlet x = 100;\nlet y = 100;\n\nfunction setup() {\n createCanvas(512, 512);\n fill(255, 0, 0);\n}\n\nfunction draw() {\n if (keyIsDown(LEFT_ARROW)) {\n x -= 5;\n }\n\n if (keyIsDown(RIGHT_ARROW)) {\n x += 5;\n }\n\n if (keyIsDown(UP_ARROW)) {\n y -= 5;\n }\n\n if (keyIsDown(DOWN_ARROW)) {\n y += 5;\n }\n\n clear();\n ellipse(x, y, 50, 50);\n}\n
    \n\n
    \nlet diameter = 50;\n\nfunction setup() {\n createCanvas(512, 512);\n}\n\nfunction draw() {\n // 107 and 187 are keyCodes for \"+\"\n if (keyIsDown(107) || keyIsDown(187)) {\n diameter += 1;\n }\n\n // 109 and 189 are keyCodes for \"-\"\n if (keyIsDown(109) || keyIsDown(189)) {\n diameter -= 1;\n }\n\n clear();\n fill(255, 0, 0);\n ellipse(50, 50, diameter, diameter);\n}\n
    " + ], + "alt": "50x50 red ellipse moves left, right, up and down with arrow presses.\n50x50 red ellipse gets bigger or smaller when + or - are pressed.", + "class": "p5", + "module": "Events", + "submodule": "Keyboard" + }, + { + "file": "src/events/mouse.js", + "line": 22, + "description": "

    The system variable mouseX always contains the current horizontal\nposition of the mouse, relative to (0, 0) of the canvas. If touch is\nused instead of mouse input, mouseX will hold the x value of the most\nrecent touch point.

    \n", + "itemtype": "property", + "name": "mouseX", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\n// Move the mouse across the canvas\nfunction draw() {\n background(244, 248, 252);\n line(mouseX, 0, mouseX, 100);\n}\n\n
    " + ], + "alt": "horizontal black line moves left and right with mouse x-position", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 48, + "description": "

    The system variable mouseY always contains the current vertical position\nof the mouse, relative to (0, 0) of the canvas. If touch is\nused instead of mouse input, mouseY will hold the y value of the most\nrecent touch point.

    \n", + "itemtype": "property", + "name": "mouseY", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\n// Move the mouse across the canvas\nfunction draw() {\n background(244, 248, 252);\n line(0, mouseY, 100, mouseY);\n}\n\n
    " + ], + "alt": "vertical black line moves up and down with mouse y-position", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 74, + "description": "

    The system variable pmouseX always contains the horizontal position of\nthe mouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas. Note: pmouseX will be reset to the current mouseX\nvalue at the start of each touch event.

    \n", + "itemtype": "property", + "name": "pmouseX", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\n// Move the mouse across the canvas to leave a trail\nfunction setup() {\n //slow down the frameRate to make it more visible\n frameRate(10);\n}\n\nfunction draw() {\n background(244, 248, 252);\n line(mouseX, mouseY, pmouseX, pmouseY);\n print(pmouseX + ' -> ' + mouseX);\n}\n\n
    " + ], + "alt": "line trail is created from cursor movements. faster movement make longer line.", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 106, + "description": "

    The system variable pmouseY always contains the vertical position of the\nmouse or finger in the frame previous to the current frame, relative to\n(0, 0) of the canvas. Note: pmouseY will be reset to the current mouseY\nvalue at the start of each touch event.

    \n", + "itemtype": "property", + "name": "pmouseY", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n //draw a square only if the mouse is not moving\n if (mouseY === pmouseY && mouseX === pmouseX) {\n rect(20, 20, 60, 60);\n }\n\n print(pmouseY + ' -> ' + mouseY);\n}\n\n
    " + ], + "alt": "60x60 black rect center, fuchsia background. rect flickers on mouse movement", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 137, + "description": "

    The system variable winMouseX always contains the current horizontal\nposition of the mouse, relative to (0, 0) of the window.

    \n", + "itemtype": "property", + "name": "winMouseX", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\nlet myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n const body = document.getElementsByTagName('body')[0];\n myCanvas.parent(body);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the horizontal mouse position\n //relative to the window\n myCanvas.position(winMouseX + 1, windowHeight / 2);\n\n //the y of the square is relative to the canvas\n rect(20, mouseY, 60, 60);\n}\n\n
    " + ], + "alt": "60x60 black rect y moves with mouse y and fuchsia canvas moves with mouse x", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 176, + "description": "

    The system variable winMouseY always contains the current vertical\nposition of the mouse, relative to (0, 0) of the window.

    \n", + "itemtype": "property", + "name": "winMouseY", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\nlet myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n const body = document.getElementsByTagName('body')[0];\n myCanvas.parent(body);\n}\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n //move the canvas to the vertical mouse position\n //relative to the window\n myCanvas.position(windowWidth / 2, winMouseY + 1);\n\n //the x of the square is relative to the canvas\n rect(mouseX, 20, 60, 60);\n}\n\n
    " + ], + "alt": "60x60 black rect x moves with mouse x and fuchsia canvas y moves with mouse y", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 215, + "description": "

    The system variable pwinMouseX always contains the horizontal position\nof the mouse in the frame previous to the current frame, relative to\n(0, 0) of the window. Note: pwinMouseX will be reset to the current winMouseX\nvalue at the start of each touch event.

    \n", + "itemtype": "property", + "name": "pwinMouseX", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\nlet myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n}\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current x position is the horizontal mouse speed\n let speed = abs(winMouseX - pwinMouseX);\n //change the size of the circle\n //according to the horizontal speed\n ellipse(50, 50, 10 + speed * 5, 10 + speed * 5);\n //move the canvas to the mouse position\n myCanvas.position(winMouseX + 1, winMouseY + 1);\n}\n\n
    " + ], + "alt": "fuchsia ellipse moves with mouse x and y. Grows and shrinks with mouse speed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 256, + "description": "

    The system variable pwinMouseY always contains the vertical position of\nthe mouse in the frame previous to the current frame, relative to (0, 0)\nof the window. Note: pwinMouseY will be reset to the current winMouseY\nvalue at the start of each touch event.

    \n", + "itemtype": "property", + "name": "pwinMouseY", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \n\nlet myCanvas;\n\nfunction setup() {\n //use a variable to store a pointer to the canvas\n myCanvas = createCanvas(100, 100);\n noStroke();\n fill(237, 34, 93);\n}\n\nfunction draw() {\n clear();\n //the difference between previous and\n //current y position is the vertical mouse speed\n let speed = abs(winMouseY - pwinMouseY);\n //change the size of the circle\n //according to the vertical speed\n ellipse(50, 50, 10 + speed * 5, 10 + speed * 5);\n //move the canvas to the mouse position\n myCanvas.position(winMouseX + 1, winMouseY + 1);\n}\n\n
    " + ], + "alt": "fuchsia ellipse moves with mouse x and y. Grows and shrinks with mouse speed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 298, + "description": "

    Processing automatically tracks if the mouse button is pressed and which\nbutton is pressed. The value of the system variable mouseButton is either\nLEFT, RIGHT, or CENTER depending on which button was pressed last.\nWarning: different browsers may track mouseButton differently.

    \n", + "itemtype": "property", + "name": "mouseButton", + "type": "Constant", + "readonly": "", + "example": [ + "\n
    \n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed) {\n if (mouseButton === LEFT) {\n ellipse(50, 50, 50, 50);\n }\n if (mouseButton === RIGHT) {\n rect(25, 25, 50, 50);\n }\n if (mouseButton === CENTER) {\n triangle(23, 75, 50, 20, 78, 75);\n }\n }\n\n print(mouseButton);\n}\n\n
    " + ], + "alt": "50x50 black ellipse appears on center of fuchsia canvas on mouse click/press.", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 337, + "description": "

    The boolean system variable mouseIsPressed is true if the mouse is pressed\nand false if not.

    \n", + "itemtype": "property", + "name": "mouseIsPressed", + "type": "Boolean", + "readonly": "", + "example": [ + "\n
    \n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n\n if (mouseIsPressed) {\n ellipse(50, 50, 50, 50);\n } else {\n rect(25, 25, 50, 50);\n }\n\n print(mouseIsPressed);\n}\n\n
    " + ], + "alt": "black 50x50 rect becomes ellipse with mouse click/press. fuchsia background.", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 428, + "description": "

    The mouseMoved() function is called every time the mouse moves and a mouse\nbutton is not pressed.

    \nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.

    \n", + "itemtype": "method", + "name": "mouseMoved", + "params": [ + { + "name": "event", + "description": "

    optional MouseEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Move the mouse across the page\n// to change its value\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseMoved() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction mouseMoved() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a MouseEvent object\n// as a callback argument\nfunction mouseMoved(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "black 50x50 rect becomes lighter with mouse movements until white then resets\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 483, + "description": "

    The mouseDragged() function is called once every time the mouse moves and\na mouse button is pressed. If no mouseDragged() function is defined, the\ntouchMoved() function will be called instead if it is defined.

    \nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.

    \n", + "itemtype": "method", + "name": "mouseDragged", + "params": [ + { + "name": "event", + "description": "

    optional MouseEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Drag the mouse across the page\n// to change its value\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseDragged() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction mouseDragged() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a MouseEvent object\n// as a callback argument\nfunction mouseDragged(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "black 50x50 rect turns lighter with mouse click and drag until white, resets\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 564, + "description": "

    The mousePressed() function is called once after every time a mouse button\nis pressed. The mouseButton variable (see the related reference entry)\ncan be used to determine which button has been pressed. If no\nmousePressed() function is defined, the touchStarted() function will be\ncalled instead if it is defined.

    \nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.

    \n", + "itemtype": "method", + "name": "mousePressed", + "params": [ + { + "name": "event", + "description": "

    optional MouseEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Click within the image to change\n// the value of the rectangle\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mousePressed() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction mousePressed() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a MouseEvent object\n// as a callback argument\nfunction mousePressed(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "black 50x50 rect turns white with mouse click/press.\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 641, + "description": "

    The mouseReleased() function is called every time a mouse button is\nreleased. If no mouseReleased() function is defined, the touchEnded()\nfunction will be called instead if it is defined.

    \nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.

    \n", + "itemtype": "method", + "name": "mouseReleased", + "params": [ + { + "name": "event", + "description": "

    optional MouseEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction mouseReleased() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction mouseReleased() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a MouseEvent object\n// as a callback argument\nfunction mouseReleased(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "black 50x50 rect turns white with mouse click/press.\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 719, + "description": "

    The mouseClicked() function is called once after a mouse button has been\npressed and then released.

    \nBrowsers handle clicks differently, so this function is only guaranteed to be\nrun when the left mouse button is clicked. To handle other mouse buttons\nbeing pressed or released, see mousePressed() or mouseReleased().

    \nBrowsers may have different default\nbehaviors attached to various mouse events. To prevent any default\nbehavior for this event, add "return false" to the end of the method.

    \n", + "itemtype": "method", + "name": "mouseClicked", + "params": [ + { + "name": "event", + "description": "

    optional MouseEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been clicked\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction mouseClicked() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction mouseClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a MouseEvent object\n// as a callback argument\nfunction mouseClicked(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "black 50x50 rect turns white with mouse click/press.\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 789, + "description": "

    The doubleClicked() function is executed every time a event\nlistener has detected a dblclick event which is a part of the\nDOM L3 specification. The doubleClicked event is fired when a\npointing device button (usually a mouse's primary button)\nis clicked twice on a single element. For more info on the\ndblclick event refer to mozilla's documentation here:\nhttps://developer.mozilla.org/en-US/docs/Web/Events/dblclick

    \n", + "itemtype": "method", + "name": "doubleClicked", + "params": [ + { + "name": "event", + "description": "

    optional MouseEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Click within the image to change\n// the value of the rectangle\n// after the mouse has been double clicked\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\n\nfunction doubleClicked() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction doubleClicked() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a MouseEvent object\n// as a callback argument\nfunction doubleClicked(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "black 50x50 rect turns white with mouse doubleClick/press.\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/mouse.js", + "line": 874, + "description": "

    The function mouseWheel() is executed every time a vertical mouse wheel\nevent is detected either triggered by an actual mouse wheel or by a\ntouchpad.

    \nThe event.delta property returns the amount the mouse wheel\nhave scrolled. The values can be positive or negative depending on the\nscroll direction (on OS X with "natural" scrolling enabled, the signs\nare inverted).

    \nBrowsers may have different default behaviors attached to various\nmouse events. To prevent any default behavior for this event, add\n"return false" to the end of the method.

    \nDue to the current support of the "wheel" event on Safari, the function\nmay only work as expected if "return false" is included while using Safari.

    \n", + "itemtype": "method", + "name": "mouseWheel", + "params": [ + { + "name": "event", + "description": "

    optional WheelEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\nlet pos = 25;\n\nfunction draw() {\n background(237, 34, 93);\n fill(0);\n rect(25, pos, 50, 50);\n}\n\nfunction mouseWheel(event) {\n print(event.delta);\n //move the square according to the vertical scroll amount\n pos += event.delta;\n //uncomment to block page scrolling\n //return false;\n}\n\n
    " + ], + "alt": "black 50x50 rect moves up and down with vertical scroll. fuchsia background", + "class": "p5", + "module": "Events", + "submodule": "Mouse" + }, + { + "file": "src/events/touch.js", + "line": 12, + "description": "

    The system variable touches[] contains an array of the positions of all\ncurrent touch points, relative to (0, 0) of the canvas, and IDs identifying a\nunique touch as it moves. Each element in the array is an object with x, y,\nand id properties.

    \n

    The touches[] array is not supported on Safari and IE on touch-based\ndesktops (laptops).

    \n", + "itemtype": "property", + "name": "touches", + "type": "Object[]", + "readonly": "", + "example": [ + "\n
    \n\n// On a touchscreen device, touch\n// the canvas using one or more fingers\n// at the same time\nfunction draw() {\n clear();\n let display = touches.length + ' touches';\n text(display, 5, 10);\n}\n\n
    " + ], + "alt": "Number of touches currently registered are displayed on the canvas", + "class": "p5", + "module": "Events", + "submodule": "Touch" + }, + { + "file": "src/events/touch.js", + "line": 74, + "description": "

    The touchStarted() function is called once after every time a touch is\nregistered. If no touchStarted() function is defined, the mousePressed()\nfunction will be called instead if it is defined.

    \nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.

    \n", + "itemtype": "method", + "name": "touchStarted", + "params": [ + { + "name": "event", + "description": "

    optional TouchEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Touch within the image to change\n// the value of the rectangle\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchStarted() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction touchStarted() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a TouchEvent object\n// as a callback argument\nfunction touchStarted(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "50x50 black rect turns white with touch event.\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Touch" + }, + { + "file": "src/events/touch.js", + "line": 149, + "description": "

    The touchMoved() function is called every time a touch move is registered.\nIf no touchMoved() function is defined, the mouseDragged() function will\nbe called instead if it is defined.

    \nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.

    \n", + "itemtype": "method", + "name": "touchMoved", + "params": [ + { + "name": "event", + "description": "

    optional TouchEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Move your finger across the page\n// to change its value\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchMoved() {\n value = value + 5;\n if (value > 255) {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction touchMoved() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a TouchEvent object\n// as a callback argument\nfunction touchMoved(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "50x50 black rect turns lighter with touch until white. resets\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Touch" + }, + { + "file": "src/events/touch.js", + "line": 222, + "description": "

    The touchEnded() function is called every time a touch ends. If no\ntouchEnded() function is defined, the mouseReleased() function will be\ncalled instead if it is defined.

    \nBrowsers may have different default behaviors attached to various touch\nevents. To prevent any default behavior for this event, add "return false"\nto the end of the method.

    \n", + "itemtype": "method", + "name": "touchEnded", + "params": [ + { + "name": "event", + "description": "

    optional TouchEvent callback argument.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \n\n// Release touch within the image to\n// change the value of the rectangle\n\nlet value = 0;\nfunction draw() {\n fill(value);\n rect(25, 25, 50, 50);\n}\nfunction touchEnded() {\n if (value === 0) {\n value = 255;\n } else {\n value = 0;\n }\n}\n\n
    \n\n
    \n\nfunction touchEnded() {\n ellipse(mouseX, mouseY, 5, 5);\n // prevent default\n return false;\n}\n\n
    \n\n
    \n\n// returns a TouchEvent object\n// as a callback argument\nfunction touchEnded(event) {\n console.log(event);\n}\n\n
    " + ], + "alt": "50x50 black rect turns white with touch.\nno image displayed", + "class": "p5", + "module": "Events", + "submodule": "Touch" + }, + { + "file": "src/image/filters.js", + "line": 3, + "description": "

    This module defines the filters for use with image buffers.

    \n

    This module is basically a collection of functions stored in an object\nas opposed to modules. The functions are destructive, modifying\nthe passed in canvas rather than creating a copy.

    \n

    Generally speaking users of this module will use the Filters.apply method\non a canvas to create an effect.

    \n

    A number of functions are borrowed/adapted from\nhttp://www.html5rocks.com/en/tutorials/canvas/imagefilters/\nor the java processing implementation.

    \n", + "class": "p5", + "module": "Events" + }, + { + "file": "src/image/image.js", + "line": 8, + "description": "

    This module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.

    \n", + "class": "p5", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/image.js", + "line": 22, + "description": "

    Creates a new p5.Image (the datatype for storing images). This provides a\nfresh buffer of pixels to play with. Set the size of the buffer with the\nwidth and height parameters.\n

    \n.pixels gives access to an array containing the values for all the pixels\nin the display window.\nThese values are numbers. This array is the size (including an appropriate\nfactor for the pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. See .pixels for\nmore info. It may also be simpler to use set() or get().\n

    \nBefore accessing the pixels of an image, the data must loaded with the\nloadPixels() function. After the array data has been modified, the\nupdatePixels() function must be run to update the changes.

    \n", + "itemtype": "method", + "name": "createImage", + "params": [ + { + "name": "width", + "description": "

    width in pixels

    \n", + "type": "Integer" + }, + { + "name": "height", + "description": "

    height in pixels

    \n", + "type": "Integer" + } + ], + "return": { + "description": "the p5.Image object", + "type": "p5.Image" + }, + "example": [ + "\n
    \n\nlet img = createImage(66, 66);\nimg.loadPixels();\nfor (let i = 0; i < img.width; i++) {\n for (let j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n
    \n\n
    \n\nlet img = createImage(66, 66);\nimg.loadPixels();\nfor (let i = 0; i < img.width; i++) {\n for (let j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, (i % img.width) * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n
    \n\n
    \n\nlet pink = color(255, 102, 204);\nlet img = createImage(66, 66);\nimg.loadPixels();\nlet d = pixelDensity();\nlet halfImage = 4 * (img.width * d) * (img.height / 2 * d);\nfor (let i = 0; i < halfImage; i += 4) {\n img.pixels[i] = red(pink);\n img.pixels[i + 1] = green(pink);\n img.pixels[i + 2] = blue(pink);\n img.pixels[i + 3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n
    " + ], + "alt": "66x66 dark turquoise rect in center of canvas.\n2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas\nno image displayed", + "class": "p5", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/image.js", + "line": 102, + "description": "

    Save the current canvas as an image. The browser will either save the\nfile immediately, or prompt the user with a dialogue window.

    \n", + "itemtype": "method", + "name": "saveCanvas", + "example": [ + "\n
    \n function setup() {\n let c = createCanvas(100, 100);\n background(255, 0, 0);\n saveCanvas(c, 'myCanvas', 'jpg');\n }\n
    \n
    \n // note that this example has the same result as above\n // if no canvas is specified, defaults to main canvas\n function setup() {\n let c = createCanvas(100, 100);\n background(255, 0, 0);\n saveCanvas('myCanvas', 'jpg');\n\n // all of the following are valid\n saveCanvas(c, 'myCanvas', 'jpg');\n saveCanvas(c, 'myCanvas.jpg');\n saveCanvas(c, 'myCanvas');\n saveCanvas(c);\n saveCanvas('myCanvas', 'png');\n saveCanvas('myCanvas');\n saveCanvas();\n }\n
    " + ], + "alt": "no image displayed\n no image displayed\n no image displayed", + "class": "p5", + "module": "Image", + "submodule": "Image", + "overloads": [ + { + "line": 102, + "params": [ + { + "name": "selectedCanvas", + "description": "

    a variable\n representing a specific html5 canvas (optional)

    \n", + "type": "p5.Element|HTMLCanvasElement" + }, + { + "name": "filename", + "description": "", + "type": "String", + "optional": true + }, + { + "name": "extension", + "description": "

    'jpg' or 'png'

    \n", + "type": "String", + "optional": true + } + ] + }, + { + "line": 144, + "params": [ + { + "name": "filename", + "description": "", + "type": "String", + "optional": true + }, + { + "name": "extension", + "description": "", + "type": "String", + "optional": true + } + ] + } + ] + }, + { + "file": "src/image/image.js", + "line": 195, + "description": "

    Capture a sequence of frames that can be used to create a movie.\nAccepts a callback. For example, you may wish to send the frames\nto a server where they can be stored or converted into a movie.\nIf no callback is provided, the browser will pop up save dialogues in an\nattempt to download all of the images that have just been created. With the\ncallback provided the image data isn't saved by default but instead passed\nas an argument to the callback function as an array of objects, with the\nsize of array equal to the total number of frames.

    \n

    Note that saveFrames() will only save the first 15 frames of an animation.\nTo export longer animations, you might look into a library like\nccapture.js.

    \n", + "itemtype": "method", + "name": "saveFrames", + "params": [ + { + "name": "filename", + "description": "", + "type": "String" + }, + { + "name": "extension", + "description": "

    'jpg' or 'png'

    \n", + "type": "String" + }, + { + "name": "duration", + "description": "

    Duration in seconds to save the frames for.

    \n", + "type": "Number" + }, + { + "name": "framerate", + "description": "

    Framerate to save the frames in.

    \n", + "type": "Number" + }, + { + "name": "callback", + "description": "

    A callback function that will be executed\n to handle the image data. This function\n should accept an array as argument. The\n array will contain the specified number of\n frames of objects. Each object has three\n properties: imageData - an\n image/octet-stream, filename and extension.

    \n", + "type": "Function(Array)", + "optional": true + } + ], + "example": [ + "\n
    \n function draw() {\n background(mouseX);\n }\n\n function mousePressed() {\n saveFrames('out', 'png', 1, 25, data => {\n print(data);\n });\n }\n
    " + ], + "alt": "canvas background goes from light to dark with mouse x.", + "class": "p5", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/loading_displaying.js", + "line": 17, + "description": "

    Loads an image from a path and creates a p5.Image from it.\n

    \nThe image may not be immediately available for rendering\nIf you want to ensure that the image is ready before doing\nanything with it, place the loadImage() call in preload().\nYou may also supply a callback function to handle the image when it's ready.\n

    \nThe path to the image should be relative to the HTML file\nthat links in your sketch. Loading an image from a URL or other\nremote location may be blocked due to your browser's built-in\nsecurity.

    \n", + "itemtype": "method", + "name": "loadImage", + "params": [ + { + "name": "path", + "description": "

    Path of the image to be loaded

    \n", + "type": "String" + }, + { + "name": "successCallback", + "description": "

    Function to be called once\n the image is loaded. Will be passed the\n p5.Image.

    \n", + "type": "function(p5.Image)", + "optional": true + }, + { + "name": "failureCallback", + "description": "

    called with event error if\n the image fails to load.

    \n", + "type": "Function(Event)", + "optional": true + } + ], + "return": { + "description": "the p5.Image object", + "type": "p5.Image" + }, + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n}\n\n
    \n
    \n\nfunction setup() {\n // here we use a callback to display the image after loading\n loadImage('assets/laDefense.jpg', img => {\n image(img, 0, 0);\n });\n}\n\n
    " + ], + "alt": "image of the underside of a white umbrella and grided ceililng above\nimage of the underside of a white umbrella and grided ceililng above", + "class": "p5", + "module": "Image", + "submodule": "Loading & Displaying" + }, + { + "file": "src/image/loading_displaying.js", + "line": 127, + "description": "

    Draw an image to the p5.js canvas.

    \n

    This function can be used with different numbers of parameters. The\nsimplest use requires only three parameters: img, x, and y—where (x, y) is\nthe position of the image. Two more parameters can optionally be added to\nspecify the width and height of the image.

    \n

    This function can also be used with all eight Number parameters. To\ndifferentiate between all these parameters, p5.js uses the language of\n"destination rectangle" (which corresponds to "dx", "dy", etc.) and "source\nimage" (which corresponds to "sx", "sy", etc.) below. Specifying the\n"source image" dimensions can be useful when you want to display a\nsubsection of the source image instead of the whole thing. Here's a diagram\nto explain further:\n

    \n", + "itemtype": "method", + "name": "image", + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img's original width and height\n image(img, 0, 0);\n}\n\n
    \n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n background(50);\n // Top-left corner of the img is at (10, 10)\n // Width and height are 50 x 50\n image(img, 10, 10, 50, 50);\n}\n\n
    \n
    \n\nfunction setup() {\n // Here, we use a callback to display the image after loading\n loadImage('assets/laDefense.jpg', img => {\n image(img, 0, 0);\n });\n}\n\n
    \n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/gradient.png');\n}\nfunction setup() {\n // 1. Background image\n // Top-left corner of the img is at (0, 0)\n // Width and height are the img's original width and height, 100 x 100\n image(img, 0, 0);\n // 2. Top right image\n // Top-left corner of destination rectangle is at (50, 0)\n // Destination rectangle width and height are 40 x 20\n // The next parameters are relative to the source image:\n // - Starting at position (50, 50) on the source image, capture a 50 x 50\n // subsection\n // - Draw this subsection to fill the dimensions of the destination rectangle\n image(img, 50, 0, 40, 20, 50, 50, 50, 50);\n}\n\n
    " + ], + "alt": "image of the underside of a white umbrella and gridded ceiling above\nimage of the underside of a white umbrella and gridded ceiling above", + "class": "p5", + "module": "Image", + "submodule": "Loading & Displaying", + "overloads": [ + { + "line": 127, + "params": [ + { + "name": "img", + "description": "

    the image to display

    \n", + "type": "p5.Image|p5.Element" + }, + { + "name": "x", + "description": "

    the x-coordinate of the top-left corner of the image

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    the y-coordinate of the top-left corner of the image

    \n", + "type": "Number" + }, + { + "name": "width", + "description": "

    the width to draw the image

    \n", + "type": "Number", + "optional": true + }, + { + "name": "height", + "description": "

    the height to draw the image

    \n", + "type": "Number", + "optional": true + } + ] + }, + { + "line": 215, + "params": [ + { + "name": "img", + "description": "", + "type": "p5.Image|p5.Element" + }, + { + "name": "dx", + "description": "

    the x-coordinate of the destination\n rectangle in which to draw the source image

    \n", + "type": "Number" + }, + { + "name": "dy", + "description": "

    the y-coordinate of the destination\n rectangle in which to draw the source image

    \n", + "type": "Number" + }, + { + "name": "dWidth", + "description": "

    the width of the destination rectangle

    \n", + "type": "Number" + }, + { + "name": "dHeight", + "description": "

    the height of the destination rectangle

    \n", + "type": "Number" + }, + { + "name": "sx", + "description": "

    the x-coordinate of the subsection of the source\nimage to draw into the destination rectangle

    \n", + "type": "Number" + }, + { + "name": "sy", + "description": "

    the y-coordinate of the subsection of the source\nimage to draw into the destination rectangle

    \n", + "type": "Number" + }, + { + "name": "sWidth", + "description": "

    the width of the subsection of the\n source image to draw into the destination\n rectangle

    \n", + "type": "Number", + "optional": true + }, + { + "name": "sHeight", + "description": "

    the height of the subsection of the\n source image to draw into the destination rectangle

    \n", + "type": "Number", + "optional": true + } + ] + } + ] + }, + { + "file": "src/image/loading_displaying.js", + "line": 298, + "description": "

    Sets the fill value for displaying images. Images can be tinted to\nspecified colors or made transparent by including an alpha value.\n

    \nTo apply transparency to an image without affecting its color, use\nwhite as the tint color and specify an alpha value. For instance,\ntint(255, 128) will make an image 50% transparent (assuming the default\nalpha range of 0-255, which can be changed with colorMode()).\n

    \nThe value for the gray parameter must be less than or equal to the current\nmaximum value as specified by colorMode(). The default maximum value is\n255.

    \n", + "itemtype": "method", + "name": "tint", + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n tint(0, 153, 204); // Tint blue\n image(img, 50, 0);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n tint(0, 153, 204, 126); // Tint blue and set transparency\n image(img, 50, 0);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n tint(255, 126); // Apply transparency without changing color\n image(img, 50, 0);\n}\n\n
    " + ], + "alt": "2 side by side images of umbrella and ceiling, one image with blue tint\nImages of umbrella and ceiling, one half of image with blue tint\n2 side by side images of umbrella and ceiling, one image translucent", + "class": "p5", + "module": "Image", + "submodule": "Loading & Displaying", + "overloads": [ + { + "line": 298, + "params": [ + { + "name": "v1", + "description": "

    red or hue value relative to\n the current color range

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ] + }, + { + "line": 371, + "params": [ + { + "name": "value", + "description": "

    a color string

    \n", + "type": "String" + } + ] + }, + { + "line": 376, + "params": [ + { + "name": "gray", + "description": "

    a gray value

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ] + }, + { + "line": 382, + "params": [ + { + "name": "values", + "description": "

    an array containing the red,green,blue &\n and alpha components of the color

    \n", + "type": "Number[]" + } + ] + }, + { + "line": 388, + "params": [ + { + "name": "color", + "description": "

    the tint color

    \n", + "type": "p5.Color" + } + ] + } + ] + }, + { + "file": "src/image/loading_displaying.js", + "line": 398, + "description": "

    Removes the current fill value for displaying images and reverts to\ndisplaying images with their original hues.

    \n", + "itemtype": "method", + "name": "noTint", + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n tint(0, 153, 204); // Tint blue\n image(img, 0, 0);\n noTint(); // Disable tint\n image(img, 50, 0);\n}\n\n
    " + ], + "alt": "2 side by side images of bricks, left image with blue tint", + "class": "p5", + "module": "Image", + "submodule": "Loading & Displaying" + }, + { + "file": "src/image/loading_displaying.js", + "line": 464, + "description": "

    Set image mode. Modifies the location from which images are drawn by\nchanging the way in which parameters given to image() are interpreted.\nThe default mode is imageMode(CORNER), which interprets the second and\nthird parameters of image() as the upper-left corner of the image. If\ntwo additional parameters are specified, they are used to set the image's\nwidth and height.\n

    \nimageMode(CORNERS) interprets the second and third parameters of image()\nas the location of one corner, and the fourth and fifth parameters as the\nopposite corner.\n

    \nimageMode(CENTER) interprets the second and third parameters of image()\nas the image's center point. If two additional parameters are specified,\nthey are used to set the image's width and height.

    \n", + "itemtype": "method", + "name": "imageMode", + "params": [ + { + "name": "mode", + "description": "

    either CORNER, CORNERS, or CENTER

    \n", + "type": "Constant" + } + ], + "example": [ + "\n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n imageMode(CORNER);\n image(img, 10, 10, 50, 50);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n imageMode(CORNERS);\n image(img, 10, 10, 90, 40);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n imageMode(CENTER);\n image(img, 50, 50, 80, 80);\n}\n\n
    " + ], + "alt": "small square image of bricks\nhorizontal rectangle image of bricks\nlarge square image of bricks", + "class": "p5", + "module": "Image", + "submodule": "Loading & Displaying" + }, + { + "file": "src/image/p5.Image.js", + "line": 9, + "description": "

    This module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.

    \n", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 90, + "description": "

    Image width.

    \n", + "itemtype": "property", + "name": "width", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \nlet img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (let i = 0; i < img.width; i++) {\n let c = img.get(i, img.height / 2);\n stroke(c);\n line(i, height / 2, i, height);\n }\n}\n
    " + ], + "alt": "rocky mountains in top and horizontal lines in corresponding colors in bottom.", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 117, + "description": "

    Image height.

    \n", + "itemtype": "property", + "name": "height", + "type": "Number", + "readonly": "", + "example": [ + "\n
    \nlet img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100);\n image(img, 0, 0);\n for (let i = 0; i < img.height; i++) {\n let c = img.get(img.width / 2, i);\n stroke(c);\n line(0, i, width / 2, i);\n }\n}\n
    " + ], + "alt": "rocky mountains on right and vertical lines in corresponding colors on left.", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 153, + "description": "

    Array containing the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh denisty displays may have more pixels (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. With\npixelDensity = 2, there will be 160,000. The first four values\n(indices 0-3) in the array will be the R, G, B, A values of the pixel at\n(0, 0). The second four values (indices 4-7) will contain the R, G, B, A\nvalues of the pixel at (1, 0). More generally, to set values for a pixel\nat (x, y):

    \n
    let d = pixelDensity();\nfor (let i = 0; i < d; i++) {\n  for (let j = 0; j < d; j++) {\n    // loop over\n    index = 4 * ((y * d + j) * width * d + (x * d + i));\n    pixels[index] = r;\n    pixels[index+1] = g;\n    pixels[index+2] = b;\n    pixels[index+3] = a;\n  }\n}\n
    \n



    \nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.

    \n", + "itemtype": "property", + "name": "pixels", + "type": "Number[]", + "example": [ + "\n
    \n\nlet img = createImage(66, 66);\nimg.loadPixels();\nfor (let i = 0; i < img.width; i++) {\n for (let j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n
    \n
    \n\nlet pink = color(255, 102, 204);\nlet img = createImage(66, 66);\nimg.loadPixels();\nfor (let i = 0; i < 4 * (width * height / 2); i += 4) {\n img.pixels[i] = red(pink);\n img.pixels[i + 1] = green(pink);\n img.pixels[i + 2] = blue(pink);\n img.pixels[i + 3] = alpha(pink);\n}\nimg.updatePixels();\nimage(img, 17, 17);\n\n
    " + ], + "alt": "66x66 turquoise rect in center of canvas\n66x66 pink rect in center of canvas", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 223, + "description": "

    Helper fxn for sharing pixel methods

    \n", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 232, + "description": "

    Loads the pixels data for this image into the [pixels] attribute.

    \n", + "itemtype": "method", + "name": "loadPixels", + "example": [ + "\n
    \nlet myImage;\nlet halfImage;\n\nfunction preload() {\n myImage = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n myImage.loadPixels();\n halfImage = 4 * myImage.width * myImage.height / 2;\n for (let i = 0; i < halfImage; i++) {\n myImage.pixels[i + halfImage] = myImage.pixels[i];\n }\n myImage.updatePixels();\n}\n\nfunction draw() {\n image(myImage, 0, 0, width, height);\n}\n
    " + ], + "alt": "2 images of rocky mountains vertically stacked", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 268, + "description": "

    Updates the backing canvas for this image with the contents of\nthe [pixels] array.

    \n", + "itemtype": "method", + "name": "updatePixels", + "example": [ + "\n
    \nlet myImage;\nlet halfImage;\n\nfunction preload() {\n myImage = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n myImage.loadPixels();\n halfImage = 4 * myImage.width * myImage.height / 2;\n for (let i = 0; i < halfImage; i++) {\n myImage.pixels[i + halfImage] = myImage.pixels[i];\n }\n myImage.updatePixels();\n}\n\nfunction draw() {\n image(myImage, 0, 0, width, height);\n}\n
    " + ], + "alt": "2 images of rocky mountains vertically stacked", + "class": "p5.Image", + "module": "Image", + "submodule": "Image", + "overloads": [ + { + "line": 268, + "params": [ + { + "name": "x", + "description": "

    x-offset of the target update area for the\n underlying canvas

    \n", + "type": "Integer" + }, + { + "name": "y", + "description": "

    y-offset of the target update area for the\n underlying canvas

    \n", + "type": "Integer" + }, + { + "name": "w", + "description": "

    height of the target update area for the\n underlying canvas

    \n", + "type": "Integer" + }, + { + "name": "h", + "description": "

    height of the target update area for the\n underlying canvas

    \n", + "type": "Integer" + } + ] + }, + { + "line": 308, + "params": [] + } + ] + }, + { + "file": "src/image/p5.Image.js", + "line": 316, + "description": "

    Get a region of pixels from an image.

    \n

    If no params are passed, the whole image is returned.\nIf x and y are the only params passed a single pixel is extracted.\nIf all params are passed a rectangle region is extracted and a p5.Image\nis returned.

    \n", + "itemtype": "method", + "name": "get", + "return": { + "description": "the rectangle p5.Image", + "type": "p5.Image" + }, + "example": [ + "\n
    \nlet myImage;\nlet c;\n\nfunction preload() {\n myImage = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n background(myImage);\n noStroke();\n c = myImage.get(60, 90);\n fill(c);\n rect(25, 25, 50, 50);\n}\n\n//get() returns color here\n
    " + ], + "alt": "image of rocky mountains with 50x50 green rect in front", + "class": "p5.Image", + "module": "Image", + "submodule": "Image", + "overloads": [ + { + "line": 316, + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "w", + "description": "

    width

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height

    \n", + "type": "Number" + } + ], + "return": { + "description": "the rectangle p5.Image", + "type": "p5.Image" + } + }, + { + "line": 354, + "params": [], + "return": { + "description": "the whole p5.Image", + "type": "p5.Image" + } + }, + { + "line": 358, + "params": [ + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "color of pixel at x,y in array format [R, G, B, A]", + "type": "Number[]" + } + } + ] + }, + { + "file": "src/image/p5.Image.js", + "line": 371, + "description": "

    Set the color of a single pixel or write an image into\nthis p5.Image.

    \n

    Note that for a large number of pixels this will\nbe slower than directly manipulating the pixels array\nand then calling updatePixels().

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "a", + "description": "

    grayscale value | pixel array |\n a p5.Color | image to copy

    \n", + "type": "Number|Number[]|Object" + } + ], + "example": [ + "\n
    \n\nlet img = createImage(66, 66);\nimg.loadPixels();\nfor (let i = 0; i < img.width; i++) {\n for (let j = 0; j < img.height; j++) {\n img.set(i, j, color(0, 90, 102, (i % img.width) * 2));\n }\n}\nimg.updatePixels();\nimage(img, 17, 17);\nimage(img, 34, 34);\n\n
    " + ], + "alt": "2 gradated dark turquoise rects fade left. 1 center 1 bottom right of canvas", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 409, + "description": "

    Resize the image to a new width and height. To make the image scale\nproportionally, use 0 as the value for the wide or high parameter.\nFor instance, to make the width of an image 150 pixels, and change\nthe height using the same proportion, use resize(150, 0).

    \n", + "itemtype": "method", + "name": "resize", + "params": [ + { + "name": "width", + "description": "

    the resized image width

    \n", + "type": "Number" + }, + { + "name": "height", + "description": "

    the resized image height

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \nlet img;\n\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction draw() {\n image(img, 0, 0);\n}\n\nfunction mousePressed() {\n img.resize(50, 100);\n}\n
    " + ], + "alt": "image of rocky mountains. zoomed in", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 494, + "description": "

    Copies a region of pixels from one image to another. If no\nsrcImage is specified this is used as the source. If the source\nand destination regions aren't the same size, it will\nautomatically resize source pixels to fit the specified\ntarget region.

    \n", + "itemtype": "method", + "name": "copy", + "example": [ + "\n
    \nlet photo;\nlet bricks;\nlet x;\nlet y;\n\nfunction preload() {\n photo = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks.jpg');\n}\n\nfunction setup() {\n x = bricks.width / 2;\n y = bricks.height / 2;\n photo.copy(bricks, 0, 0, x, y, 0, 0, x, y);\n image(photo, 0, 0);\n}\n
    " + ], + "alt": "image of rocky mountains and smaller image on top of bricks at top left", + "class": "p5.Image", + "module": "Image", + "submodule": "Image", + "overloads": [ + { + "line": 494, + "params": [ + { + "name": "srcImage", + "description": "

    source image

    \n", + "type": "p5.Image|p5.Element" + }, + { + "name": "sx", + "description": "

    X coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sy", + "description": "

    Y coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sw", + "description": "

    source image width

    \n", + "type": "Integer" + }, + { + "name": "sh", + "description": "

    source image height

    \n", + "type": "Integer" + }, + { + "name": "dx", + "description": "

    X coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dy", + "description": "

    Y coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dw", + "description": "

    destination image width

    \n", + "type": "Integer" + }, + { + "name": "dh", + "description": "

    destination image height

    \n", + "type": "Integer" + } + ] + }, + { + "line": 535, + "params": [ + { + "name": "sx", + "description": "", + "type": "Integer" + }, + { + "name": "sy", + "description": "", + "type": "Integer" + }, + { + "name": "sw", + "description": "", + "type": "Integer" + }, + { + "name": "sh", + "description": "", + "type": "Integer" + }, + { + "name": "dx", + "description": "", + "type": "Integer" + }, + { + "name": "dy", + "description": "", + "type": "Integer" + }, + { + "name": "dw", + "description": "", + "type": "Integer" + }, + { + "name": "dh", + "description": "", + "type": "Integer" + } + ] + } + ] + }, + { + "file": "src/image/p5.Image.js", + "line": 575, + "description": "

    Masks part of an image from displaying by loading another\nimage and using it's alpha channel as an alpha channel for\nthis image.

    \n", + "itemtype": "method", + "name": "mask", + "params": [ + { + "name": "srcImage", + "description": "

    source image

    \n", + "type": "p5.Image" + } + ], + "example": [ + "\n
    \nlet photo, maskImage;\nfunction preload() {\n photo = loadImage('assets/rockies.jpg');\n maskImage = loadImage('assets/mask2.png');\n}\n\nfunction setup() {\n createCanvas(100, 100);\n photo.mask(maskImage);\n image(photo, 0, 0);\n}\n
    " + ], + "alt": "image of rocky mountains with white at right\n\n\nhttp://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 638, + "description": "

    Applies an image filter to a p5.Image

    \n", + "itemtype": "method", + "name": "filter", + "params": [ + { + "name": "filterType", + "description": "

    either THRESHOLD, GRAY, OPAQUE, INVERT,\n POSTERIZE, BLUR, ERODE, DILATE or BLUR.\n See Filters.js for docs on\n each available filter

    \n", + "type": "Constant" + }, + { + "name": "filterParam", + "description": "

    an optional parameter unique\n to each filter, see above

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nlet photo1;\nlet photo2;\n\nfunction preload() {\n photo1 = loadImage('assets/rockies.jpg');\n photo2 = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n photo2.filter(GRAY);\n image(photo1, 0, 0);\n image(photo2, width / 2, 0);\n}\n
    " + ], + "alt": "2 images of rocky mountains left one in color, right in black and white", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/p5.Image.js", + "line": 674, + "description": "

    Copies a region of pixels from one image to another, using a specified\nblend mode to do the operation.

    \n", + "itemtype": "method", + "name": "blend", + "example": [ + "\n
    \nlet mountains;\nlet bricks;\n\nfunction preload() {\n mountains = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n
    \n
    \nlet mountains;\nlet bricks;\n\nfunction preload() {\n mountains = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n
    \n
    \nlet mountains;\nlet bricks;\n\nfunction preload() {\n mountains = loadImage('assets/rockies.jpg');\n bricks = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n mountains.blend(bricks, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n image(mountains, 0, 0);\n image(bricks, 0, 0);\n}\n
    " + ], + "alt": "image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent", + "class": "p5.Image", + "module": "Image", + "submodule": "Image", + "overloads": [ + { + "line": 674, + "params": [ + { + "name": "srcImage", + "description": "

    source image

    \n", + "type": "p5.Image" + }, + { + "name": "sx", + "description": "

    X coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sy", + "description": "

    Y coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sw", + "description": "

    source image width

    \n", + "type": "Integer" + }, + { + "name": "sh", + "description": "

    source image height

    \n", + "type": "Integer" + }, + { + "name": "dx", + "description": "

    X coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dy", + "description": "

    Y coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dw", + "description": "

    destination image width

    \n", + "type": "Integer" + }, + { + "name": "dh", + "description": "

    destination image height

    \n", + "type": "Integer" + }, + { + "name": "blendMode", + "description": "

    the blend mode. either\n BLEND, DARKEST, LIGHTEST, DIFFERENCE,\n MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,\n SOFT_LIGHT, DODGE, BURN, ADD or NORMAL.

    \n

    Available blend modes are: normal | multiply | screen | overlay |\n darken | lighten | color-dodge | color-burn | hard-light |\n soft-light | difference | exclusion | hue | saturation |\n color | luminosity

    \n

    http://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/

    \n", + "type": "Constant" + } + ] + }, + { + "line": 753, + "params": [ + { + "name": "sx", + "description": "", + "type": "Integer" + }, + { + "name": "sy", + "description": "", + "type": "Integer" + }, + { + "name": "sw", + "description": "", + "type": "Integer" + }, + { + "name": "sh", + "description": "", + "type": "Integer" + }, + { + "name": "dx", + "description": "", + "type": "Integer" + }, + { + "name": "dy", + "description": "", + "type": "Integer" + }, + { + "name": "dw", + "description": "", + "type": "Integer" + }, + { + "name": "dh", + "description": "", + "type": "Integer" + }, + { + "name": "blendMode", + "description": "", + "type": "Constant" + } + ] + } + ] + }, + { + "file": "src/image/p5.Image.js", + "line": 796, + "description": "

    Saves the image to a file and force the browser to download it.\nAccepts two strings for filename and file extension\nSupports png (default) and jpg.

    \n", + "itemtype": "method", + "name": "save", + "params": [ + { + "name": "filename", + "description": "

    give your file a name

    \n", + "type": "String" + }, + { + "name": "extension", + "description": "

    'png' or 'jpg'

    \n", + "type": "String" + } + ], + "example": [ + "\n
    \nlet photo;\n\nfunction preload() {\n photo = loadImage('assets/rockies.jpg');\n}\n\nfunction draw() {\n image(photo, 0, 0);\n}\n\nfunction keyTyped() {\n if (key === 's') {\n photo.save('photo', 'png');\n }\n}\n
    " + ], + "alt": "image of rocky mountains.", + "class": "p5.Image", + "module": "Image", + "submodule": "Image" + }, + { + "file": "src/image/pixels.js", + "line": 14, + "description": "

    Uint8ClampedArray\ncontaining the values for all the pixels in the display window.\nThese values are numbers. This array is the size (include an appropriate\nfactor for pixelDensity) of the display window x4,\nrepresenting the R, G, B, A values in order for each pixel, moving from\nleft to right across each row, then down each column. Retina and other\nhigh density displays will have more pixels[] (by a factor of\npixelDensity^2).\nFor example, if the image is 100x100 pixels, there will be 40,000. On a\nretina display, there will be 160,000.\n

    \nThe first four values (indices 0-3) in the array will be the R, G, B, A\nvalues of the pixel at (0, 0). The second four values (indices 4-7) will\ncontain the R, G, B, A values of the pixel at (1, 0). More generally, to\nset values for a pixel at (x, y):

    \n
    let d = pixelDensity();\nfor (let i = 0; i < d; i++) {\n  for (let j = 0; j < d; j++) {\n    // loop over\n    index = 4 * ((y * d + j) * width * d + (x * d + i));\n    pixels[index] = r;\n    pixels[index+1] = g;\n    pixels[index+2] = b;\n    pixels[index+3] = a;\n  }\n}\n
    \n

    While the above method is complex, it is flexible enough to work with\nany pixelDensity. Note that set() will automatically take care of\nsetting all the appropriate values in pixels[] for a given (x, y) at\nany pixelDensity, but the performance may not be as fast when lots of\nmodifications are made to the pixel array.\n

    \nBefore accessing this array, the data must loaded with the loadPixels()\nfunction. After the array data has been modified, the updatePixels()\nfunction must be run to update the changes.\n

    \nNote that this is not a standard javascript array. This means that\nstandard javascript functions such as slice() or\narrayCopy() do not\nwork.

    ", + "itemtype": "property", + "name": "pixels", + "type": "Number[]", + "example": [ + "\n
    \n\nlet pink = color(255, 102, 204);\nloadPixels();\nlet d = pixelDensity();\nlet halfImage = 4 * (width * d) * (height / 2 * d);\nfor (let i = 0; i < halfImage; i += 4) {\n pixels[i] = red(pink);\n pixels[i + 1] = green(pink);\n pixels[i + 2] = blue(pink);\n pixels[i + 3] = alpha(pink);\n}\nupdatePixels();\n\n
    " + ], + "alt": "top half of canvas pink, bottom grey", + "class": "p5", + "module": "Image", + "submodule": "Pixels" + }, + { + "file": "src/image/pixels.js", + "line": 83, + "description": "

    Copies a region of pixels from one image to another, using a specified\nblend mode to do the operation.

    \n", + "itemtype": "method", + "name": "blend", + "example": [ + "\n
    \nlet img0;\nlet img1;\n\nfunction preload() {\n img0 = loadImage('assets/rockies.jpg');\n img1 = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, LIGHTEST);\n}\n
    \n
    \nlet img0;\nlet img1;\n\nfunction preload() {\n img0 = loadImage('assets/rockies.jpg');\n img1 = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, DARKEST);\n}\n
    \n
    \nlet img0;\nlet img1;\n\nfunction preload() {\n img0 = loadImage('assets/rockies.jpg');\n img1 = loadImage('assets/bricks_third.jpg');\n}\n\nfunction setup() {\n background(img0);\n image(img1, 0, 0);\n blend(img1, 0, 0, 33, 100, 67, 0, 33, 100, ADD);\n}\n
    " + ], + "alt": "image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent", + "class": "p5", + "module": "Image", + "submodule": "Pixels", + "overloads": [ + { + "line": 83, + "params": [ + { + "name": "srcImage", + "description": "

    source image

    \n", + "type": "p5.Image" + }, + { + "name": "sx", + "description": "

    X coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sy", + "description": "

    Y coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sw", + "description": "

    source image width

    \n", + "type": "Integer" + }, + { + "name": "sh", + "description": "

    source image height

    \n", + "type": "Integer" + }, + { + "name": "dx", + "description": "

    X coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dy", + "description": "

    Y coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dw", + "description": "

    destination image width

    \n", + "type": "Integer" + }, + { + "name": "dh", + "description": "

    destination image height

    \n", + "type": "Integer" + }, + { + "name": "blendMode", + "description": "

    the blend mode. either\n BLEND, DARKEST, LIGHTEST, DIFFERENCE,\n MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT,\n SOFT_LIGHT, DODGE, BURN, ADD or NORMAL.

    \n", + "type": "Constant" + } + ] + }, + { + "line": 156, + "params": [ + { + "name": "sx", + "description": "", + "type": "Integer" + }, + { + "name": "sy", + "description": "", + "type": "Integer" + }, + { + "name": "sw", + "description": "", + "type": "Integer" + }, + { + "name": "sh", + "description": "", + "type": "Integer" + }, + { + "name": "dx", + "description": "", + "type": "Integer" + }, + { + "name": "dy", + "description": "", + "type": "Integer" + }, + { + "name": "dw", + "description": "", + "type": "Integer" + }, + { + "name": "dh", + "description": "", + "type": "Integer" + }, + { + "name": "blendMode", + "description": "", + "type": "Constant" + } + ] + } + ] + }, + { + "file": "src/image/pixels.js", + "line": 177, + "description": "

    Copies a region of the canvas to another region of the canvas\nand copies a region of pixels from an image used as the srcImg parameter\ninto the canvas srcImage is specified this is used as the source. If\nthe source and destination regions aren't the same size, it will\nautomatically resize source pixels to fit the specified\ntarget region.

    \n", + "itemtype": "method", + "name": "copy", + "example": [ + "\n
    \nlet img;\n\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n background(img);\n copy(img, 7, 22, 10, 10, 35, 25, 50, 50);\n stroke(255);\n noFill();\n // Rectangle shows area being copied\n rect(7, 22, 10, 10);\n}\n
    " + ], + "alt": "image of rocky mountains. Brick images on left and right. Right overexposed\nimage of rockies. Brickwall images on left and right. Right mortar transparent\nimage of rockies. Brickwall images on left and right. Right translucent", + "class": "p5", + "module": "Image", + "submodule": "Pixels", + "overloads": [ + { + "line": 177, + "params": [ + { + "name": "srcImage", + "description": "

    source image

    \n", + "type": "p5.Image|p5.Element" + }, + { + "name": "sx", + "description": "

    X coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sy", + "description": "

    Y coordinate of the source's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "sw", + "description": "

    source image width

    \n", + "type": "Integer" + }, + { + "name": "sh", + "description": "

    source image height

    \n", + "type": "Integer" + }, + { + "name": "dx", + "description": "

    X coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dy", + "description": "

    Y coordinate of the destination's upper left corner

    \n", + "type": "Integer" + }, + { + "name": "dw", + "description": "

    destination image width

    \n", + "type": "Integer" + }, + { + "name": "dh", + "description": "

    destination image height

    \n", + "type": "Integer" + } + ] + }, + { + "line": 220, + "params": [ + { + "name": "sx", + "description": "", + "type": "Integer" + }, + { + "name": "sy", + "description": "", + "type": "Integer" + }, + { + "name": "sw", + "description": "", + "type": "Integer" + }, + { + "name": "sh", + "description": "", + "type": "Integer" + }, + { + "name": "dx", + "description": "", + "type": "Integer" + }, + { + "name": "dy", + "description": "", + "type": "Integer" + }, + { + "name": "dw", + "description": "", + "type": "Integer" + }, + { + "name": "dh", + "description": "", + "type": "Integer" + } + ] + } + ] + }, + { + "file": "src/image/pixels.js", + "line": 236, + "description": "

    Applies a filter to the canvas.\n

    \n

    The presets options are:\n

    \n

    THRESHOLD\nConverts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.\n

    \n

    GRAY\nConverts any colors in the image to grayscale equivalents. No parameter\nis used.\n

    \n

    OPAQUE\nSets the alpha channel to entirely opaque. No parameter is used.\n

    \n

    INVERT\nSets each pixel to its inverse value. No parameter is used.\n

    \n

    POSTERIZE\nLimits each channel of the image to the number of colors specified as the\nparameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.\n

    \n

    BLUR\nExecutes a Gaussian blur with the level parameter specifying the extent\nof the blurring. If no parameter is used, the blur is equivalent to\nGaussian blur of radius 1. Larger values increase the blur.\n

    \n

    ERODE\nReduces the light areas. No parameter is used.\n

    \n

    DILATE\nIncreases the light areas. No parameter is used.

    \n", + "itemtype": "method", + "name": "filter", + "params": [ + { + "name": "filterType", + "description": "

    either THRESHOLD, GRAY, OPAQUE, INVERT,\n POSTERIZE, BLUR, ERODE, DILATE or BLUR.\n See Filters.js for docs on\n each available filter

    \n", + "type": "Constant" + }, + { + "name": "filterParam", + "description": "

    an optional parameter unique\n to each filter, see above

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(THRESHOLD);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(GRAY);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(OPAQUE);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(INVERT);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(POSTERIZE, 3);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(DILATE);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(BLUR, 3);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/bricks.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n filter(ERODE);\n}\n\n
    " + ], + "alt": "black and white image of a brick wall.\ngreyscale image of a brickwall\nimage of a brickwall\njade colored image of a brickwall\nred and pink image of a brickwall\nimage of a brickwall\nblurry image of a brickwall\nimage of a brickwall\nimage of a brickwall with less detail", + "class": "p5", + "module": "Image", + "submodule": "Pixels" + }, + { + "file": "src/image/pixels.js", + "line": 415, + "description": "

    Get a region of pixels, or a single pixel, from the canvas.

    \n

    Returns an array of [R,G,B,A] values for any pixel or grabs a section of\nan image. If no parameters are specified, the entire image is returned.\nUse the x and y parameters to get the value of one pixel. Get a section of\nthe display window by specifying additional w and h parameters. When\ngetting an image, the x and y parameters define the coordinates for the\nupper-left corner of the image, regardless of the current imageMode().\n

    \nTo get the color components scaled according to the current color ranges\nand taking into account colorMode, use getColor instead of get.\n

    \nGetting the color of a single pixel with get(x, y) is easy, but not as fast\nas grabbing the data directly from pixels[]. The equivalent statement to\nget(x, y) using pixels[] with pixel density d is

    \n
    let x, y, d; // set these to the coordinates\nlet off = (y * width + x) * d * 4;\nlet components = [\n  pixels[off],\n  pixels[off + 1],\n  pixels[off + 2],\n  pixels[off + 3]\n];\nprint(components);\n
    \n



    \n

    See the reference for pixels[] for more information.

    \n

    If you want to extract an array of colors or a subimage from an p5.Image object,\ntake a look at p5.Image.get()

    \n", + "itemtype": "method", + "name": "get", + "return": { + "description": "the rectangle p5.Image", + "type": "p5.Image" + }, + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n let c = get();\n image(c, width / 2, 0);\n}\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\nfunction setup() {\n image(img, 0, 0);\n let c = get(50, 90);\n fill(c);\n noStroke();\n rect(25, 25, 50, 50);\n}\n\n
    " + ], + "alt": "2 images of the rocky mountains, side-by-side\nImage of the rocky mountains with 50x50 green rect in center of canvas", + "class": "p5", + "module": "Image", + "submodule": "Pixels", + "overloads": [ + { + "line": 415, + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "w", + "description": "

    width

    \n", + "type": "Number" + }, + { + "name": "h", + "description": "

    height

    \n", + "type": "Number" + } + ], + "return": { + "description": "the rectangle p5.Image", + "type": "p5.Image" + } + }, + { + "line": 491, + "params": [], + "return": { + "description": "the whole p5.Image", + "type": "p5.Image" + } + }, + { + "line": 495, + "params": [ + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "color of pixel at x,y in array format [R, G, B, A]", + "type": "Number[]" + } + } + ] + }, + { + "file": "src/image/pixels.js", + "line": 506, + "description": "

    Loads the pixel data for the display window into the pixels[] array. This\nfunction must always be called before reading from or writing to pixels[].\nNote that only changes made with set() or direct manipulation of pixels[]\nwill occur.

    \n", + "itemtype": "method", + "name": "loadPixels", + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n image(img, 0, 0, width, height);\n let d = pixelDensity();\n let halfImage = 4 * (width * d) * (height * d / 2);\n loadPixels();\n for (let i = 0; i < halfImage; i++) {\n pixels[i + halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n
    " + ], + "alt": "two images of the rocky mountains. one on top, one on bottom of canvas.", + "class": "p5", + "module": "Image", + "submodule": "Pixels" + }, + { + "file": "src/image/pixels.js", + "line": 543, + "description": "

    Changes the color of any pixel, or writes an image directly to the\ndisplay window.

    \n

    The x and y parameters specify the pixel to change and the c parameter\nspecifies the color value. This can be a p5.Color object, or [R, G, B, A]\npixel array. It can also be a single grayscale value.\nWhen setting an image, the x and y parameters define the coordinates for\nthe upper-left corner of the image, regardless of the current imageMode().\n

    \n

    \nAfter using set(), you must call updatePixels() for your changes to appear.\nThis should be called once all pixels have been set, and must be called before\ncalling .get() or drawing the image.\n

    \n

    Setting the color of a single pixel with set(x, y) is easy, but not as\nfast as putting the data directly into pixels[]. Setting the pixels[]\nvalues directly may be complicated when working with a retina display,\nbut will perform better when lots of pixels need to be set directly on\nevery loop.

    \n

    See the reference for pixels[] for more information.

    ", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of the pixel

    \n", + "type": "Number" + }, + { + "name": "c", + "description": "

    insert a grayscale value | a pixel array |\n a p5.Color object | a p5.Image to copy

    \n", + "type": "Number|Number[]|Object" + } + ], + "example": [ + "\n
    \n\nlet black = color(0);\nset(30, 20, black);\nset(85, 20, black);\nset(85, 75, black);\nset(30, 75, black);\nupdatePixels();\n\n
    \n\n
    \n\nfor (let i = 30; i < width - 15; i++) {\n for (let j = 20; j < height - 25; j++) {\n let c = color(204 - j, 153 - i, 0);\n set(i, j, c);\n }\n}\nupdatePixels();\n\n
    \n\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n set(0, 0, img);\n updatePixels();\n line(0, 0, width, height);\n line(0, height, width, 0);\n}\n\n
    " + ], + "alt": "4 black points in the shape of a square middle-right of canvas.\nsquare with orangey-brown gradient lightening at bottom right.\nimage of the rocky mountains. with lines like an 'x' through the center.", + "class": "p5", + "module": "Image", + "submodule": "Pixels" + }, + { + "file": "src/image/pixels.js", + "line": 617, + "description": "

    Updates the display window with the data in the pixels[] array.\nUse in conjunction with loadPixels(). If you're only reading pixels from\nthe array, there's no need to call updatePixels() — updating is only\nnecessary to apply changes. updatePixels() should be called anytime the\npixels array is manipulated or set() is called, and only changes made with\nset() or direct changes to pixels[] will occur.

    \n", + "itemtype": "method", + "name": "updatePixels", + "params": [ + { + "name": "x", + "description": "

    x-coordinate of the upper-left corner of region\n to update

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    y-coordinate of the upper-left corner of region\n to update

    \n", + "type": "Number", + "optional": true + }, + { + "name": "w", + "description": "

    width of region to update

    \n", + "type": "Number", + "optional": true + }, + { + "name": "h", + "description": "

    height of region to update

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/rockies.jpg');\n}\n\nfunction setup() {\n image(img, 0, 0, width, height);\n let d = pixelDensity();\n let halfImage = 4 * (width * d) * (height * d / 2);\n loadPixels();\n for (let i = 0; i < halfImage; i++) {\n pixels[i + halfImage] = pixels[i];\n }\n updatePixels();\n}\n\n
    " + ], + "alt": "two images of the rocky mountains. one on top, one on bottom of canvas.", + "class": "p5", + "module": "Image", + "submodule": "Pixels" + }, + { + "file": "src/io/files.js", + "line": 19, + "description": "

    Loads a JSON file from a file or a URL, and returns an Object.\nNote that even if the JSON file contains an Array, an Object will be\nreturned with index numbers as keys.

    \n

    This method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. JSONP is supported via a polyfill and you\ncan pass in as the second argument an object with definitions of the json\ncallback following the syntax specified here.

    \n

    This method is suitable for fetching files up to size of 64MB.

    \n", + "itemtype": "method", + "name": "loadJSON", + "return": { + "description": "JSON data", + "type": "Object|Array" + }, + "example": [ + "\n\n

    Calling loadJSON() inside preload() guarantees to complete the\noperation before setup() and draw() are called.

    \n\n
    \n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\nlet earthquakes;\nfunction preload() {\n // Get the most recent earthquake in the database\n let url =\n 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' +\n 'summary/all_day.geojson';\n earthquakes = loadJSON(url);\n}\n\nfunction setup() {\n noLoop();\n}\n\nfunction draw() {\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n let earthquakeMag = earthquakes.features[0].properties.mag;\n let earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n
    \n\n\n

    Outside of preload(), you may supply a callback function to handle the\nobject:

    \n
    \nfunction setup() {\n noLoop();\n let url =\n 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' +\n 'summary/all_day.geojson';\n loadJSON(url, drawEarthquake);\n}\n\nfunction draw() {\n background(200);\n}\n\nfunction drawEarthquake(earthquakes) {\n // Get the magnitude and name of the earthquake out of the loaded JSON\n let earthquakeMag = earthquakes.features[0].properties.mag;\n let earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n}\n
    " + ], + "alt": "50x50 ellipse that changes from black to white depending on the current humidity\n50x50 ellipse that changes from black to white depending on the current humidity", + "class": "p5", + "module": "IO", + "submodule": "Input", + "overloads": [ + { + "line": 19, + "params": [ + { + "name": "path", + "description": "

    name of the file or url to load

    \n", + "type": "String" + }, + { + "name": "jsonpOptions", + "description": "

    options object for jsonp related settings

    \n", + "type": "Object", + "optional": true + }, + { + "name": "datatype", + "description": "

    "json" or "jsonp"

    \n", + "type": "String", + "optional": true + }, + { + "name": "callback", + "description": "

    function to be executed after\n loadJSON() completes, data is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if\n there is an error, response is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "JSON data", + "type": "Object|Array" + } + }, + { + "line": 105, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "datatype", + "description": "", + "type": "String" + }, + { + "name": "callback", + "description": "", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Object|Array" + } + }, + { + "line": 113, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "callback", + "description": "", + "type": "Function" + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Object|Array" + } + } + ] + }, + { + "file": "src/io/files.js", + "line": 180, + "description": "

    Reads the contents of a file and creates a String array of its individual\nlines. If the name of the file is used as the parameter, as in the above\nexample, the file must be located in the sketch directory/folder.\n

    \nAlternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.\n

    \nThis method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed.

    \n

    This method is suitable for fetching files up to size of 64MB.

    \n", + "itemtype": "method", + "name": "loadStrings", + "params": [ + { + "name": "filename", + "description": "

    name of the file or url to load

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function to be executed after loadStrings()\n completes, Array is passed in as first\n argument

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if\n there is an error, response is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "Array of Strings", + "type": "String[]" + }, + "example": [ + "\n\n

    Calling loadStrings() inside preload() guarantees to complete the\noperation before setup() and draw() are called.

    \n\n
    \nlet result;\nfunction preload() {\n result = loadStrings('assets/test.txt');\n}\n\nfunction setup() {\n background(200);\n let ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n
    \n\n

    Outside of preload(), you may supply a callback function to handle the\nobject:

    \n\n
    \nfunction setup() {\n loadStrings('assets/test.txt', pickString);\n}\n\nfunction pickString(result) {\n background(200);\n let ind = floor(random(result.length));\n text(result[ind], 10, 10, 80, 80);\n}\n
    " + ], + "alt": "randomly generated text from a file, for example \"i smell like butter\"\nrandomly generated text from a file, for example \"i have three feet\"", + "class": "p5", + "module": "IO", + "submodule": "Input" + }, + { + "file": "src/io/files.js", + "line": 293, + "description": "

    Reads the contents of a file or URL and creates a p5.Table object with\nits values. If a file is specified, it must be located in the sketch's\n"data" folder. The filename parameter can also be a URL to a file found\nonline. By default, the file is assumed to be comma-separated (in CSV\nformat). Table only looks for a header row if the 'header' option is\nincluded.

    \n\n

    Possible options include:\n

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

    \n\n

    When passing in multiple options, pass them in as separate parameters,\nseperated by commas. For example:\n

    \n\nloadTable('my_csv_file.csv', 'csv', 'header');\n\n

    \n\n

    All files loaded and saved use UTF-8 encoding.

    \n\n

    This method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadTable() inside preload()\nguarantees to complete the operation before setup() and draw() are called.\n

    Outside of preload(), you may supply a callback function to handle the\nobject:

    \n

    \n\n

    This method is suitable for fetching files up to size of 64MB.

    \n", + "itemtype": "method", + "name": "loadTable", + "return": { + "description": "Table object containing data", + "type": "Object" + }, + "example": [ + "\n
    \n\n// Given the following CSV file called \"mammals.csv\"\n// located in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n //the file can be remote\n //table = loadTable(\"http://p5js.org/reference/assets/mammals.csv\",\n // \"csv\", \"header\");\n}\n\nfunction setup() {\n //count the columns\n print(table.getRowCount() + ' total rows in table');\n print(table.getColumnCount() + ' total columns in table');\n\n print(table.getColumn('name'));\n //[\"Goat\", \"Leopard\", \"Zebra\"]\n\n //cycle through the table\n for (let r = 0; r < table.getRowCount(); r++)\n for (let c = 0; c < table.getColumnCount(); c++) {\n print(table.getString(r, c));\n }\n}\n\n
    " + ], + "alt": "randomly generated text from a file, for example \"i smell like butter\"\nrandomly generated text from a file, for example \"i have three feet\"", + "class": "p5", + "module": "IO", + "submodule": "Input", + "overloads": [ + { + "line": 293, + "params": [ + { + "name": "filename", + "description": "

    name of the file or URL to load

    \n", + "type": "String" + }, + { + "name": "options", + "description": "

    "header" "csv" "tsv"

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function to be executed after\n loadTable() completes. On success, the\n Table object is passed in as the\n first argument.

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if\n there is an error, response is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "Table object containing data", + "type": "Object" + } + }, + { + "line": 383, + "params": [ + { + "name": "filename", + "description": "", + "type": "String" + }, + { + "name": "callback", + "description": "", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Object" + } + } + ] + }, + { + "file": "src/io/files.js", + "line": 603, + "description": "

    Reads the contents of a file and creates an XML object with its values.\nIf the name of the file is used as the parameter, as in the above example,\nthe file must be located in the sketch directory/folder.

    \n

    Alternatively, the file maybe be loaded from anywhere on the local\ncomputer using an absolute path (something that starts with / on Unix and\nLinux, or a drive letter on Windows), or the filename parameter can be a\nURL for a file found on a network.

    \n

    This method is asynchronous, meaning it may not finish before the next\nline in your sketch is executed. Calling loadXML() inside preload()\nguarantees to complete the operation before setup() and draw() are called.

    \n

    Outside of preload(), you may supply a callback function to handle the\nobject.

    \n

    This method is suitable for fetching files up to size of 64MB.

    \n", + "itemtype": "method", + "name": "loadXML", + "params": [ + { + "name": "filename", + "description": "

    name of the file or URL to load

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function to be executed after loadXML()\n completes, XML object is passed in as\n first argument

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if\n there is an error, response is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "XML object containing data", + "type": "Object" + }, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let children = xml.getChildren('animal');\n\n for (let i = 0; i < children.length; i++) {\n let id = children[i].getNum('id');\n let coloring = children[i].getString('species');\n let name = children[i].getContent();\n print(id + ', ' + coloring + ', ' + name);\n }\n}\n\n// Sketch prints:\n// 0, Capra hircus, Goat\n// 1, Panthera pardus, Leopard\n// 2, Equus zebra, Zebra\n
    " + ], + "alt": "no image displayed", + "class": "p5", + "module": "IO", + "submodule": "Input" + }, + { + "file": "src/io/files.js", + "line": 714, + "description": "

    This method is suitable for fetching files up to size of 64MB.

    \n", + "itemtype": "method", + "name": "loadBytes", + "params": [ + { + "name": "file", + "description": "

    name of the file or URL to load

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function to be executed after loadBytes()\n completes

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if there\n is an error

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "an object whose 'bytes' property will be the loaded buffer", + "type": "Object" + }, + "example": [ + "\n
    \nlet data;\n\nfunction preload() {\n data = loadBytes('assets/mammals.xml');\n}\n\nfunction setup() {\n for (let i = 0; i < 5; i++) {\n console.log(data.bytes[i].toString(16));\n }\n}\n
    " + ], + "alt": "no image displayed", + "class": "p5", + "module": "IO", + "submodule": "Input" + }, + { + "file": "src/io/files.js", + "line": 774, + "description": "

    Method for executing an HTTP GET request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'GET'). The 'binary' datatype will return\na Blob object, and the 'arrayBuffer' datatype will return an ArrayBuffer\nwhich can be used to initialize typed arrays (such as Uint8Array).

    \n", + "itemtype": "method", + "name": "httpGet", + "return": { + "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.", + "type": "Promise" + }, + "example": [ + "\n
    \n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\nlet earthquakes;\nfunction preload() {\n // Get the most recent earthquake in the database\n let url =\n 'https://earthquake.usgs.gov/fdsnws/event/1/query?' +\n 'format=geojson&limit=1&orderby=time';\n httpGet(url, 'jsonp', false, function(response) {\n // when the HTTP request completes, populate the variable that holds the\n // earthquake data used in the visualization.\n earthquakes = response;\n });\n}\n\nfunction draw() {\n if (!earthquakes) {\n // Wait until the earthquake data has loaded before drawing.\n return;\n }\n background(200);\n // Get the magnitude and name of the earthquake out of the loaded JSON\n let earthquakeMag = earthquakes.features[0].properties.mag;\n let earthquakeName = earthquakes.features[0].properties.place;\n ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10);\n textAlign(CENTER);\n text(earthquakeName, 0, height - 30, width, 30);\n noLoop();\n}\n
    " + ], + "class": "p5", + "module": "IO", + "submodule": "Input", + "overloads": [ + { + "line": 774, + "params": [ + { + "name": "path", + "description": "

    name of the file or url to load

    \n", + "type": "String" + }, + { + "name": "datatype", + "description": "

    "json", "jsonp", "binary", "arrayBuffer",\n "xml", or "text"

    \n", + "type": "String", + "optional": true + }, + { + "name": "data", + "description": "

    param data passed sent with request

    \n", + "type": "Object|Boolean", + "optional": true + }, + { + "name": "callback", + "description": "

    function to be executed after\n httpGet() completes, data is passed in\n as first argument

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if\n there is an error, response is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.", + "type": "Promise" + } + }, + { + "line": 828, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "data", + "description": "", + "type": "Object|Boolean" + }, + { + "name": "callback", + "description": "", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Promise" + } + }, + { + "line": 836, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "callback", + "description": "", + "type": "Function" + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Promise" + } + } + ] + }, + { + "file": "src/io/files.js", + "line": 851, + "description": "

    Method for executing an HTTP POST request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text. This is equivalent to\ncalling httpDo(path, 'POST').

    \n", + "itemtype": "method", + "name": "httpPost", + "return": { + "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.", + "type": "Promise" + }, + "example": [ + "\n
    \n\n// Examples use jsonplaceholder.typicode.com for a Mock Data API\n\nlet url = 'https://jsonplaceholder.typicode.com/posts';\nlet postData = { userId: 1, title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\nfunction setup() {\n createCanvas(800, 800);\n}\n\nfunction mousePressed() {\n // Pick new random color values\n let r = random(255);\n let g = random(255);\n let b = random(255);\n\n httpPost(url, 'json', postData, function(result) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n ellipse(mouseX, mouseY, 200, 200);\n text(result.body, mouseX, mouseY);\n });\n}\n\n
    \n\n\n
    \nlet url = 'https://invalidURL'; // A bad URL that will cause errors\nlet postData = { title: 'p5 Clicked!', body: 'p5.js is way cool.' };\n\nfunction setup() {\n createCanvas(800, 800);\n}\n\nfunction mousePressed() {\n // Pick new random color values\n let r = random(255);\n let g = random(255);\n let b = random(255);\n\n httpPost(\n url,\n 'json',\n postData,\n function(result) {\n // ... won't be called\n },\n function(error) {\n strokeWeight(2);\n stroke(r, g, b);\n fill(r, g, b, 127);\n text(error.toString(), mouseX, mouseY);\n }\n );\n}\n
    \n" + ], + "class": "p5", + "module": "IO", + "submodule": "Input", + "overloads": [ + { + "line": 851, + "params": [ + { + "name": "path", + "description": "

    name of the file or url to load

    \n", + "type": "String" + }, + { + "name": "datatype", + "description": "

    "json", "jsonp", "xml", or "text".\n If omitted, httpPost() will guess.

    \n", + "type": "String", + "optional": true + }, + { + "name": "data", + "description": "

    param data passed sent with request

    \n", + "type": "Object|Boolean", + "optional": true + }, + { + "name": "callback", + "description": "

    function to be executed after\n httpPost() completes, data is passed in\n as first argument

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if\n there is an error, response is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.", + "type": "Promise" + } + }, + { + "line": 933, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "data", + "description": "", + "type": "Object|Boolean" + }, + { + "name": "callback", + "description": "", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Promise" + } + }, + { + "line": 941, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "callback", + "description": "", + "type": "Function" + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Promise" + } + } + ] + }, + { + "file": "src/io/files.js", + "line": 956, + "description": "

    Method for executing an HTTP request. If data type is not specified,\np5 will try to guess based on the URL, defaulting to text.

    \nFor more advanced use, you may also pass in the path as the first argument\nand a object as the second argument, the signature follows the one specified\nin the Fetch API specification.\nThis method is suitable for fetching files up to size of 64MB when "GET" is used.

    \n", + "itemtype": "method", + "name": "httpDo", + "return": { + "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.", + "type": "Promise" + }, + "example": [ + "\n
    \n\n// Examples use USGS Earthquake API:\n// https://earthquake.usgs.gov/fdsnws/event/1/#methods\n\n// displays an animation of all USGS earthquakes\nlet earthquakes;\nlet eqFeatureIndex = 0;\n\nfunction preload() {\n let url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson';\n httpDo(\n url,\n {\n method: 'GET',\n // Other Request options, like special headers for apis\n headers: { authorization: 'Bearer secretKey' }\n },\n function(res) {\n earthquakes = res;\n }\n );\n}\n\nfunction draw() {\n // wait until the data is loaded\n if (!earthquakes || !earthquakes.features[eqFeatureIndex]) {\n return;\n }\n clear();\n\n let feature = earthquakes.features[eqFeatureIndex];\n let mag = feature.properties.mag;\n let rad = mag / 11 * ((width + height) / 2);\n fill(255, 0, 0, 100);\n ellipse(width / 2 + random(-2, 2), height / 2 + random(-2, 2), rad, rad);\n\n if (eqFeatureIndex >= earthquakes.features.length) {\n eqFeatureIndex = 0;\n } else {\n eqFeatureIndex += 1;\n }\n}\n\n
    " + ], + "class": "p5", + "module": "IO", + "submodule": "Input", + "overloads": [ + { + "line": 956, + "params": [ + { + "name": "path", + "description": "

    name of the file or url to load

    \n", + "type": "String" + }, + { + "name": "method", + "description": "

    either "GET", "POST", or "PUT",\n defaults to "GET"

    \n", + "type": "String", + "optional": true + }, + { + "name": "datatype", + "description": "

    "json", "jsonp", "xml", or "text"

    \n", + "type": "String", + "optional": true + }, + { + "name": "data", + "description": "

    param data passed sent with request

    \n", + "type": "Object", + "optional": true + }, + { + "name": "callback", + "description": "

    function to be executed after\n httpGet() completes, data is passed in\n as first argument

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to be executed if\n there is an error, response is passed\n in as first argument

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "A promise that resolves with the data when the operation\n completes successfully or rejects with the error after\n one occurs.", + "type": "Promise" + } + }, + { + "line": 1027, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "options", + "description": "

    Request object options as documented in the\n "fetch" API\nreference

    \n", + "type": "Object" + }, + { + "name": "callback", + "description": "", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "Promise" + } + } + ] + }, + { + "file": "src/io/files.js", + "line": 1186, + "itemtype": "method", + "name": "createWriter", + "params": [ + { + "name": "name", + "description": "

    name of the file to be created

    \n", + "type": "String" + }, + { + "name": "extension", + "description": "", + "type": "String", + "optional": true + } + ], + "return": { + "description": "", + "type": "p5.PrintWriter" + }, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100);\n background(200);\n text('click here to save', 10, 10, 70, 80);\n}\n\nfunction mousePressed() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n var writer = createWriter('squares.txt');\n for (let i = 0; i < 10; i++) {\n writer.print(i * i);\n }\n writer.close();\n writer.clear();\n }\n}\n\n
    " + ], + "class": "p5", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1241, + "description": "

    Writes data to the PrintWriter stream

    \n", + "itemtype": "method", + "name": "write", + "params": [ + { + "name": "data", + "description": "

    all data to be written by the PrintWriter

    \n", + "type": "Array" + } + ], + "example": [ + "\n
    \n\n// creates a file called 'newFile.txt'\nlet writer = createWriter('newFile.txt');\n// write 'Hello world!'' to the file\nwriter.write(['Hello world!']);\n// close the PrintWriter and save the file\nwriter.close();\n\n
    \n
    \n\n// creates a file called 'newFile2.txt'\nlet writer = createWriter('newFile2.txt');\n// write 'apples,bananas,123' to the file\nwriter.write(['apples', 'bananas', 123]);\n// close the PrintWriter and save the file\nwriter.close();\n\n
    \n
    \n\n// creates a file called 'newFile3.txt'\nlet writer = createWriter('newFile3.txt');\n// write 'My name is: Teddy' to the file\nwriter.write('My name is:');\nwriter.write(' Teddy');\n// close the PrintWriter and save the file\nwriter.close();\n\n
    " + ], + "class": "p5.PrintWriter", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1281, + "description": "

    Writes data to the PrintWriter stream, and adds a new line at the end

    \n", + "itemtype": "method", + "name": "print", + "params": [ + { + "name": "data", + "description": "

    all data to be printed by the PrintWriter

    \n", + "type": "Array" + } + ], + "example": [ + "\n
    \n\n// creates a file called 'newFile.txt'\nlet writer = createWriter('newFile.txt');\n// creates a file containing\n// My name is:\n// Teddy\nwriter.print('My name is:');\nwriter.print('Teddy');\n// close the PrintWriter and save the file\nwriter.close();\n\n
    \n
    \n\nlet writer;\n\nfunction setup() {\n createCanvas(400, 400);\n // create a PrintWriter\n writer = createWriter('newFile.txt');\n}\n\nfunction draw() {\n // print all mouseX and mouseY coordinates to the stream\n writer.print([mouseX, mouseY]);\n}\n\nfunction mouseClicked() {\n // close the PrintWriter and save the file\n writer.close();\n}\n\n
    " + ], + "class": "p5.PrintWriter", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1324, + "description": "

    Clears the data already written to the PrintWriter object

    \n", + "itemtype": "method", + "name": "clear", + "example": [ + "\n
    \n// create writer object\nlet writer = createWriter('newFile.txt');\nwriter.write(['clear me']);\n// clear writer object here\nwriter.clear();\n// close writer\nwriter.close();\n
    \n" + ], + "class": "p5.PrintWriter", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1342, + "description": "

    Closes the PrintWriter

    \n", + "itemtype": "method", + "name": "close", + "example": [ + "\n
    \n\n// create a file called 'newFile.txt'\nlet writer = createWriter('newFile.txt');\n// close the PrintWriter and save the file\nwriter.close();\n\n
    \n
    \n\n// create a file called 'newFile2.txt'\nlet writer = createWriter('newFile2.txt');\n// write some data to the file\nwriter.write([100, 101, 102]);\n// close the PrintWriter and save the file\nwriter.close();\n\n
    " + ], + "class": "p5.PrintWriter", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1391, + "description": "

    Save an image, text, json, csv, wav, or html. Prompts download to\nthe client's computer. Note that it is not recommended to call save()\nwithin draw if it's looping, as the save() function will open a new save\ndialog every frame.

    \n

    The default behavior is to save the canvas as an image. You can\noptionally specify a filename.\nFor example:

    \n 
    \n save();\n save('myCanvas.jpg'); // save a specific canvas with a filename\n
    \n\n

    Alternately, the first parameter can be a pointer to a canvas\np5.Element, an Array of Strings,\nan Array of JSON, a JSON object, a p5.Table, a p5.Image, or a\np5.SoundFile (requires p5.sound). The second parameter is a filename\n(including extension). The third parameter is for options specific\nto this type of object. This method will save a file that fits the\ngiven parameters. For example:

    \n\n 
    \n // Saves canvas as an image\n save('myCanvas.jpg');\n\n // Saves pImage as a png image\n let img = createImage(10, 10);\n save(img, 'my.png');\n\n // Saves canvas as an image\n let cnv = createCanvas(100, 100);\n save(cnv, 'myCanvas.jpg');\n\n // Saves p5.Renderer object as an image\n let gb = createGraphics(100, 100);\n save(gb, 'myGraphics.jpg');\n\n let myTable = new p5.Table();\n\n // Saves table as html file\n save(myTable, 'myTable.html');\n\n // Comma Separated Values\n save(myTable, 'myTable.csv');\n\n // Tab Separated Values\n save(myTable, 'myTable.tsv');\n\n let myJSON = { a: 1, b: true };\n\n // Saves pretty JSON\n save(myJSON, 'my.json');\n\n // Optimizes JSON filesize\n save(myJSON, 'my.json', true);\n\n // Saves array of strings to a text file with line breaks after each item\n let arrayOfStrings = ['a', 'b'];\n save(arrayOfStrings, 'my.txt');\n
    ", + "itemtype": "method", + "name": "save", + "params": [ + { + "name": "objectOrFilename", + "description": "

    If filename is provided, will\n save canvas as an image with\n either png or jpg extension\n depending on the filename.\n If object is provided, will\n save depending on the object\n and filename (see examples\n above).

    \n", + "type": "Object|String", + "optional": true + }, + { + "name": "filename", + "description": "

    If an object is provided as the first\n parameter, then the second parameter\n indicates the filename,\n and should include an appropriate\n file extension (see examples above).

    \n", + "type": "String", + "optional": true + }, + { + "name": "options", + "description": "

    Additional options depend on\n filetype. For example, when saving JSON,\n true indicates that the\n output will be optimized for filesize,\n rather than readability.

    \n", + "type": "Boolean|String", + "optional": true + } + ], + "class": "p5", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1519, + "description": "

    Writes the contents of an Array or a JSON object to a .json file.\nThe file saving process and location of the saved file will\nvary between web browsers.

    \n", + "itemtype": "method", + "name": "saveJSON", + "params": [ + { + "name": "json", + "description": "", + "type": "Array|Object" + }, + { + "name": "filename", + "description": "", + "type": "String" + }, + { + "name": "optimize", + "description": "

    If true, removes line breaks\n and spaces from the output\n file to optimize filesize\n (but not readability).

    \n", + "type": "Boolean", + "optional": true + } + ], + "example": [ + "\n
    \n let json = {}; // new JSON Object\n\n json.id = 0;\n json.species = 'Panthera leo';\n json.name = 'Lion';\n\n function setup() {\n createCanvas(100, 100);\n background(200);\n text('click here to save', 10, 10, 70, 80);\n }\n\n function mousePressed() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n saveJSON(json, 'lion.json');\n }\n }\n\n // saves the following to a file called \"lion.json\":\n // {\n // \"id\": 0,\n // \"species\": \"Panthera leo\",\n // \"name\": \"Lion\"\n // }\n
    " + ], + "alt": "no image displayed", + "class": "p5", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1577, + "description": "

    Writes an array of Strings to a text file, one line per String.\nThe file saving process and location of the saved file will\nvary between web browsers.

    \n", + "itemtype": "method", + "name": "saveStrings", + "params": [ + { + "name": "list", + "description": "

    string array to be written

    \n", + "type": "String[]" + }, + { + "name": "filename", + "description": "

    filename for output

    \n", + "type": "String" + }, + { + "name": "extension", + "description": "

    the filename's extension

    \n", + "type": "String", + "optional": true + } + ], + "example": [ + "\n
    \n let words = 'apple bear cat dog';\n\n // .split() outputs an Array\n let list = split(words, ' ');\n\n function setup() {\n createCanvas(100, 100);\n background(200);\n text('click here to save', 10, 10, 70, 80);\n }\n\n function mousePressed() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n saveStrings(list, 'nouns.txt');\n }\n }\n\n // Saves the following to a file called 'nouns.txt':\n //\n // apple\n // bear\n // cat\n // dog\n
    " + ], + "alt": "no image displayed", + "class": "p5", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/files.js", + "line": 1645, + "description": "

    Writes the contents of a Table object to a file. Defaults to a\ntext file with comma-separated-values ('csv') but can also\nuse tab separation ('tsv'), or generate an HTML table ('html').\nThe file saving process and location of the saved file will\nvary between web browsers.

    \n", + "itemtype": "method", + "name": "saveTable", + "params": [ + { + "name": "Table", + "description": "

    the Table object to save to a file

    \n", + "type": "p5.Table" + }, + { + "name": "filename", + "description": "

    the filename to which the Table should be saved

    \n", + "type": "String" + }, + { + "name": "options", + "description": "

    can be one of "tsv", "csv", or "html"

    \n", + "type": "String", + "optional": true + } + ], + "example": [ + "\n
    \n let table;\n\n function setup() {\n table = new p5.Table();\n\n table.addColumn('id');\n table.addColumn('species');\n table.addColumn('name');\n\n let newRow = table.addRow();\n newRow.setNum('id', table.getRowCount() - 1);\n newRow.setString('species', 'Panthera leo');\n newRow.setString('name', 'Lion');\n\n // To save, un-comment next line then click 'run'\n // saveTable(table, 'new.csv');\n }\n\n // Saves the following to a file called 'new.csv':\n // id,species,name\n // 0,Panthera leo,Lion\n
    " + ], + "alt": "no image displayed", + "class": "p5", + "module": "IO", + "submodule": "Output" + }, + { + "file": "src/io/p5.Table.js", + "line": 11, + "description": "

    Table Options

    \n

    Generic class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.

    \n

    CSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don't bother with the\nquotes.

    \n

    File names should end with .csv if they're comma separated.

    \n

    A rough "spec" for CSV can be found\nhere.

    \n

    To load files, use the loadTable method.

    \n

    To save tables to your computer, use the save method\n or the saveTable method.

    \n\n

    Possible options include:

    \n
      \n
    • csv - parse the table as comma-separated values\n
    • tsv - parse the table as tab-separated values\n
    • header - this table has a header (title) row\n
    ", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 45, + "itemtype": "property", + "name": "columns", + "type": "String[]", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 50, + "itemtype": "property", + "name": "rows", + "type": "p5.TableRow[]", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 56, + "description": "

    Use addRow() to add a new row of data to a p5.Table object. By default,\nan empty row is created. Typically, you would store a reference to\nthe new row in a TableRow object (see newRow in the example above),\nand then set individual values using set().

    \n

    If a p5.TableRow object is included as a parameter, then that row is\nduplicated and added to the table.

    \n", + "itemtype": "method", + "name": "addRow", + "params": [ + { + "name": "row", + "description": "

    row to be added to the table

    \n", + "type": "p5.TableRow", + "optional": true + } + ], + "return": { + "description": "the row that was added", + "type": "p5.TableRow" + }, + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //add a row\n let newRow = table.addRow();\n newRow.setString('id', table.getRowCount() - 1);\n newRow.setString('species', 'Canis Lupus');\n newRow.setString('name', 'Wolf');\n\n //print the results\n for (let r = 0; r < table.getRowCount(); r++)\n for (let c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 120, + "description": "

    Removes a row from the table object.

    \n", + "itemtype": "method", + "name": "removeRow", + "params": [ + { + "name": "id", + "description": "

    ID number of the row to remove

    \n", + "type": "Integer" + } + ], + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n //remove the first row\n table.removeRow(0);\n\n //print the results\n for (let r = 0; r < table.getRowCount(); r++)\n for (let c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 168, + "description": "

    Returns a reference to the specified p5.TableRow. The reference\ncan then be used to get and set values of the selected row.

    \n", + "itemtype": "method", + "name": "getRow", + "params": [ + { + "name": "rowID", + "description": "

    ID number of the row to get

    \n", + "type": "Integer" + } + ], + "return": { + "description": "p5.TableRow object", + "type": "p5.TableRow" + }, + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n let row = table.getRow(1);\n //print it column by column\n //note: a row is an object, not an array\n for (let c = 0; c < table.getColumnCount(); c++) {\n print(row.getString(c));\n }\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 214, + "description": "

    Gets all rows from the table. Returns an array of p5.TableRows.

    \n", + "itemtype": "method", + "name": "getRows", + "return": { + "description": "Array of p5.TableRows", + "type": "p5.TableRow[]" + }, + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n let rows = table.getRows();\n\n //warning: rows is an array of objects\n for (let r = 0; r < rows.length; r++) {\n rows[r].set('name', 'Unicorn');\n }\n\n //print the results\n for (let r = 0; r < table.getRowCount(); r++)\n for (let c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 263, + "description": "

    Finds the first row in the Table that contains the value\nprovided, and returns a reference to that row. Even if\nmultiple rows are possible matches, only the first matching\nrow is returned. The column to search may be specified by\neither its ID or title.

    \n", + "itemtype": "method", + "name": "findRow", + "params": [ + { + "name": "value", + "description": "

    The value to match

    \n", + "type": "String" + }, + { + "name": "column", + "description": "

    ID number or title of the\n column to search

    \n", + "type": "Integer|String" + } + ], + "return": { + "description": "", + "type": "p5.TableRow" + }, + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //find the animal named zebra\n let row = table.findRow('Zebra', 'name');\n //find the corresponding species\n print(row.getString('species'));\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 328, + "description": "

    Finds the rows in the Table that contain the value\nprovided, and returns references to those rows. Returns an\nArray, so for must be used to iterate through all the rows,\nas shown in the example above. The column to search may be\nspecified by either its ID or title.

    \n", + "itemtype": "method", + "name": "findRows", + "params": [ + { + "name": "value", + "description": "

    The value to match

    \n", + "type": "String" + }, + { + "name": "column", + "description": "

    ID number or title of the\n column to search

    \n", + "type": "Integer|String" + } + ], + "return": { + "description": "An Array of TableRow objects", + "type": "p5.TableRow[]" + }, + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //add another goat\n let newRow = table.addRow();\n newRow.setString('id', table.getRowCount() - 1);\n newRow.setString('species', 'Scape Goat');\n newRow.setString('name', 'Goat');\n\n //find the rows containing animals named Goat\n let rows = table.findRows('Goat', 'name');\n print(rows.length + ' Goats found');\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 397, + "description": "

    Finds the first row in the Table that matches the regular\nexpression provided, and returns a reference to that row.\nEven if multiple rows are possible matches, only the first\nmatching row is returned. The column to search may be\nspecified by either its ID or title.

    \n", + "itemtype": "method", + "name": "matchRow", + "params": [ + { + "name": "regexp", + "description": "

    The regular expression to match

    \n", + "type": "String|RegExp" + }, + { + "name": "column", + "description": "

    The column ID (number) or\n title (string)

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "TableRow object", + "type": "p5.TableRow" + }, + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n //Search using specified regex on a given column, return TableRow object\n let mammal = table.matchRow(new RegExp('ant'), 1);\n print(mammal.getString(1));\n //Output \"Panthera pardus\"\n}\n\n
    \n" + ], + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 456, + "description": "

    Finds the rows in the Table that match the regular expression provided,\nand returns references to those rows. Returns an array, so for must be\nused to iterate through all the rows, as shown in the example. The\ncolumn to search may be specified by either its ID or title.

    \n", + "itemtype": "method", + "name": "matchRows", + "params": [ + { + "name": "regexp", + "description": "

    The regular expression to match

    \n", + "type": "String" + }, + { + "name": "column", + "description": "

    The column ID (number) or\n title (string)

    \n", + "type": "String|Integer", + "optional": true + } + ], + "return": { + "description": "An Array of TableRow objects", + "type": "p5.TableRow[]" + }, + "example": [ + "\n
    \n\nlet table;\n\nfunction setup() {\n table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n let newRow = table.addRow();\n newRow.setString('name', 'Lion');\n newRow.setString('type', 'Mammal');\n\n newRow = table.addRow();\n newRow.setString('name', 'Snake');\n newRow.setString('type', 'Reptile');\n\n newRow = table.addRow();\n newRow.setString('name', 'Mosquito');\n newRow.setString('type', 'Insect');\n\n newRow = table.addRow();\n newRow.setString('name', 'Lizard');\n newRow.setString('type', 'Reptile');\n\n let rows = table.matchRows('R.*', 'type');\n for (let i = 0; i < rows.length; i++) {\n print(rows[i].getString('name') + ': ' + rows[i].getString('type'));\n }\n}\n// Sketch prints:\n// Snake: Reptile\n// Lizard: Reptile\n\n
    " + ], + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 523, + "description": "

    Retrieves all values in the specified column, and returns them\nas an array. The column may be specified by either its ID or title.

    \n", + "itemtype": "method", + "name": "getColumn", + "params": [ + { + "name": "column", + "description": "

    String or Number of the column to return

    \n", + "type": "String|Number" + } + ], + "return": { + "description": "Array of column values", + "type": "Array" + }, + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n //getColumn returns an array that can be printed directly\n print(table.getColumn('species'));\n //outputs [\"Capra hircus\", \"Panthera pardus\", \"Equus zebra\"]\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 576, + "description": "

    Removes all rows from a Table. While all rows are removed,\ncolumns and column titles are maintained.

    \n", + "itemtype": "method", + "name": "clearRows", + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n table.clearRows();\n print(table.getRowCount() + ' total rows in table');\n print(table.getColumnCount() + ' total columns in table');\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 618, + "description": "

    Use addColumn() to add a new column to a Table object.\nTypically, you will want to specify a title, so the column\nmay be easily referenced later by name. (If no title is\nspecified, the new column's title will be null.)

    \n", + "itemtype": "method", + "name": "addColumn", + "params": [ + { + "name": "title", + "description": "

    title of the given column

    \n", + "type": "String", + "optional": true + } + ], + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n table.addColumn('carnivore');\n table.set(0, 'carnivore', 'no');\n table.set(1, 'carnivore', 'yes');\n table.set(2, 'carnivore', 'no');\n\n //print the results\n for (let r = 0; r < table.getRowCount(); r++)\n for (let c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 669, + "description": "

    Returns the total number of columns in a Table.

    \n", + "itemtype": "method", + "name": "getColumnCount", + "return": { + "description": "Number of columns in this table", + "type": "Integer" + }, + "example": [ + "\n
    \n \n // given the cvs file \"blobs.csv\" in /assets directory\n // ID, Name, Flavor, Shape, Color\n // Blob1, Blobby, Sweet, Blob, Pink\n // Blob2, Saddy, Savory, Blob, Blue\n\n let table;\n\n function preload() {\n table = loadTable('assets/blobs.csv');\n }\n\n function setup() {\n createCanvas(200, 100);\n textAlign(CENTER);\n background(255);\n }\n\n function draw() {\n let numOfColumn = table.getColumnCount();\n text('There are ' + numOfColumn + ' columns in the table.', 100, 50);\n }\n \n
    " + ], + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 705, + "description": "

    Returns the total number of rows in a Table.

    \n", + "itemtype": "method", + "name": "getRowCount", + "return": { + "description": "Number of rows in this table", + "type": "Integer" + }, + "example": [ + "\n
    \n \n // given the cvs file \"blobs.csv\" in /assets directory\n //\n // ID, Name, Flavor, Shape, Color\n // Blob1, Blobby, Sweet, Blob, Pink\n // Blob2, Saddy, Savory, Blob, Blue\n\n let table;\n\n function preload() {\n table = loadTable('assets/blobs.csv');\n }\n\n function setup() {\n createCanvas(200, 100);\n textAlign(CENTER);\n background(255);\n }\n\n function draw() {\n text('There are ' + table.getRowCount() + ' rows in the table.', 100, 50);\n }\n \n
    " + ], + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 741, + "description": "

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

    \n\n

    If no column is specified, then the values in all columns and\nrows are processed. A specific column may be referenced by\neither its ID or title.

    ", + "itemtype": "method", + "name": "removeTokens", + "params": [ + { + "name": "chars", + "description": "

    String listing characters to be removed

    \n", + "type": "String" + }, + { + "name": "column", + "description": "

    Column ID (number)\n or name (string)

    \n", + "type": "String|Integer", + "optional": true + } + ], + "example": [ + "\n
    \n function setup() {\n let table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n let newRow = table.addRow();\n newRow.setString('name', ' $Lion ,');\n newRow.setString('type', ',,,Mammal');\n\n newRow = table.addRow();\n newRow.setString('name', '$Snake ');\n newRow.setString('type', ',,,Reptile');\n\n table.removeTokens(',$ ');\n print(table.getArray());\n }\n\n // prints:\n // 0 \"Lion\" \"Mamal\"\n // 1 \"Snake\" \"Reptile\"\n
    " + ], + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 815, + "description": "

    Trims leading and trailing whitespace, such as spaces and tabs,\nfrom String table values. If no column is specified, then the\nvalues in all columns and rows are trimmed. A specific column\nmay be referenced by either its ID or title.

    \n", + "itemtype": "method", + "name": "trim", + "params": [ + { + "name": "column", + "description": "

    Column ID (number)\n or name (string)

    \n", + "type": "String|Integer", + "optional": true + } + ], + "example": [ + "\n
    \n function setup() {\n let table = new p5.Table();\n\n table.addColumn('name');\n table.addColumn('type');\n\n let newRow = table.addRow();\n newRow.setString('name', ' Lion ,');\n newRow.setString('type', ' Mammal ');\n\n newRow = table.addRow();\n newRow.setString('name', ' Snake ');\n newRow.setString('type', ' Reptile ');\n\n table.trim();\n print(table.getArray());\n }\n\n // prints:\n // 0 \"Lion\" \"Mamal\"\n // 1 \"Snake\" \"Reptile\"\n
    " + ], + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 879, + "description": "

    Use removeColumn() to remove an existing column from a Table\nobject. The column to be removed may be identified by either\nits title (a String) or its index value (an int).\nremoveColumn(0) would remove the first column, removeColumn(1)\nwould remove the second column, and so on.

    \n", + "itemtype": "method", + "name": "removeColumn", + "params": [ + { + "name": "column", + "description": "

    columnName (string) or ID (number)

    \n", + "type": "String|Integer" + } + ], + "example": [ + "\n
    \n \n // Given the CSV file \"mammals.csv\"\n // in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n table.removeColumn('id');\n print(table.getColumnCount());\n }\n \n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 944, + "description": "

    Stores a value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "row", + "description": "

    row ID

    \n", + "type": "Integer" + }, + { + "name": "column", + "description": "

    column ID (Number)\n or title (String)

    \n", + "type": "String|Integer" + }, + { + "name": "value", + "description": "

    value to assign

    \n", + "type": "String|Number" + } + ], + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n table.set(0, 'species', 'Canis Lupus');\n table.set(0, 'name', 'Wolf');\n\n //print the results\n for (let r = 0; r < table.getRowCount(); r++)\n for (let c = 0; c < table.getColumnCount(); c++)\n print(table.getString(r, c));\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 994, + "description": "

    Stores a Float value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.

    \n", + "itemtype": "method", + "name": "setNum", + "params": [ + { + "name": "row", + "description": "

    row ID

    \n", + "type": "Integer" + }, + { + "name": "column", + "description": "

    column ID (Number)\n or title (String)

    \n", + "type": "String|Integer" + }, + { + "name": "value", + "description": "

    value to assign

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n table.setNum(1, 'id', 1);\n\n print(table.getColumn(0));\n //[\"0\", 1, \"2\"]\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 1040, + "description": "

    Stores a String value in the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified\nby either its ID or title.

    \n", + "itemtype": "method", + "name": "setString", + "params": [ + { + "name": "row", + "description": "

    row ID

    \n", + "type": "Integer" + }, + { + "name": "column", + "description": "

    column ID (Number)\n or title (String)

    \n", + "type": "String|Integer" + }, + { + "name": "value", + "description": "

    value to assign

    \n", + "type": "String" + } + ], + "example": [ + "\n
    \n// Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n //add a row\n let newRow = table.addRow();\n newRow.setString('id', table.getRowCount() - 1);\n newRow.setString('species', 'Canis Lupus');\n newRow.setString('name', 'Wolf');\n\n print(table.getArray());\n}\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 1085, + "description": "

    Retrieves a value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.

    \n", + "itemtype": "method", + "name": "get", + "params": [ + { + "name": "row", + "description": "

    row ID

    \n", + "type": "Integer" + }, + { + "name": "column", + "description": "

    columnName (string) or\n ID (number)

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "", + "type": "String|Number" + }, + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n print(table.get(0, 1));\n //Capra hircus\n print(table.get(0, 'species'));\n //Capra hircus\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 1132, + "description": "

    Retrieves a Float value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.

    \n", + "itemtype": "method", + "name": "getNum", + "params": [ + { + "name": "row", + "description": "

    row ID

    \n", + "type": "Integer" + }, + { + "name": "column", + "description": "

    columnName (string) or\n ID (number)

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n print(table.getNum(1, 0) + 100);\n //id 1 + 100 = 101\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 1177, + "description": "

    Retrieves a String value from the Table's specified row and column.\nThe row is specified by its ID, while the column may be specified by\neither its ID or title.

    \n", + "itemtype": "method", + "name": "getString", + "params": [ + { + "name": "row", + "description": "

    row ID

    \n", + "type": "Integer" + }, + { + "name": "column", + "description": "

    columnName (string) or\n ID (number)

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "", + "type": "String" + }, + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n // table is comma separated value \"CSV\"\n // and has specifiying header for column labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n print(table.getString(0, 0)); // 0\n print(table.getString(0, 1)); // Capra hircus\n print(table.getString(0, 2)); // Goat\n print(table.getString(1, 0)); // 1\n print(table.getString(1, 1)); // Panthera pardus\n print(table.getString(1, 2)); // Leopard\n print(table.getString(2, 0)); // 2\n print(table.getString(2, 1)); // Equus zebra\n print(table.getString(2, 2)); // Zebra\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 1230, + "description": "

    Retrieves all table data and returns as an object. If a column name is\npassed in, each row object will be stored with that attribute as its\ntitle.

    \n", + "itemtype": "method", + "name": "getObject", + "params": [ + { + "name": "headerColumn", + "description": "

    Name of the column which should be used to\n title each row object (optional)

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "", + "type": "Object" + }, + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder:\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leopard\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n let tableObject = table.getObject();\n\n print(tableObject);\n //outputs an object\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.Table.js", + "line": 1296, + "description": "

    Retrieves all table data and returns it as a multidimensional array.

    \n", + "itemtype": "method", + "name": "getArray", + "return": { + "description": "", + "type": "Array" + }, + "example": [ + "\n
    \n\n// Given the CSV file \"mammals.csv\"\n// in the project's \"assets\" folder\n//\n// id,species,name\n// 0,Capra hircus,Goat\n// 1,Panthera pardus,Leoperd\n// 2,Equus zebra,Zebra\n\nlet table;\n\nfunction preload() {\n // table is comma separated value \"CSV\"\n // and has specifiying header for column labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n}\n\nfunction setup() {\n let tableArray = table.getArray();\n for (let i = 0; i < tableArray.length; i++) {\n print(tableArray[i]);\n }\n}\n\n
    " + ], + "alt": "no image displayed", + "class": "p5.Table", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.TableRow.js", + "line": 42, + "description": "

    Stores a value in the TableRow's specified column.\nThe column may be specified by either its ID or title.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "column", + "description": "

    Column ID (Number)\n or Title (String)

    \n", + "type": "String|Integer" + }, + { + "name": "value", + "description": "

    The value to be stored

    \n", + "type": "String|Number" + } + ], + "example": [ + "\n
    \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n let rows = table.getRows();\n for (let r = 0; r < rows.length; r++) {\n rows[r].set('name', 'Unicorn');\n }\n\n //print the results\n print(table.getArray());\n }\n
    " + ], + "alt": "no image displayed", + "class": "p5.TableRow", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.TableRow.js", + "line": 106, + "description": "

    Stores a Float value in the TableRow's specified column.\nThe column may be specified by either its ID or title.

    \n", + "itemtype": "method", + "name": "setNum", + "params": [ + { + "name": "column", + "description": "

    Column ID (Number)\n or Title (String)

    \n", + "type": "String|Integer" + }, + { + "name": "value", + "description": "

    The value to be stored\n as a Float

    \n", + "type": "Number|String" + } + ], + "example": [ + "\n
    \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n let rows = table.getRows();\n for (let r = 0; r < rows.length; r++) {\n rows[r].setNum('id', r + 10);\n }\n\n print(table.getArray());\n }\n
    " + ], + "alt": "no image displayed", + "class": "p5.TableRow", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.TableRow.js", + "line": 150, + "description": "

    Stores a String value in the TableRow's specified column.\nThe column may be specified by either its ID or title.

    \n", + "itemtype": "method", + "name": "setString", + "params": [ + { + "name": "column", + "description": "

    Column ID (Number)\n or Title (String)

    \n", + "type": "String|Integer" + }, + { + "name": "value", + "description": "

    The value to be stored\n as a String

    \n", + "type": "String|Number|Boolean|Object" + } + ], + "example": [ + "\n
    \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n let rows = table.getRows();\n for (let r = 0; r < rows.length; r++) {\n let name = rows[r].getString('name');\n rows[r].setString('name', 'A ' + name + ' named George');\n }\n\n print(table.getArray());\n }\n
    " + ], + "alt": "no image displayed", + "class": "p5.TableRow", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.TableRow.js", + "line": 195, + "description": "

    Retrieves a value from the TableRow's specified column.\nThe column may be specified by either its ID or title.

    \n", + "itemtype": "method", + "name": "get", + "params": [ + { + "name": "column", + "description": "

    columnName (string) or\n ID (number)

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "", + "type": "String|Number" + }, + "example": [ + "\n
    \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n let names = [];\n let rows = table.getRows();\n for (let r = 0; r < rows.length; r++) {\n names.push(rows[r].get('name'));\n }\n\n print(names);\n }\n
    " + ], + "alt": "no image displayed", + "class": "p5.TableRow", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.TableRow.js", + "line": 243, + "description": "

    Retrieves a Float value from the TableRow's specified\ncolumn. The column may be specified by either its ID or\ntitle.

    \n", + "itemtype": "method", + "name": "getNum", + "params": [ + { + "name": "column", + "description": "

    columnName (string) or\n ID (number)

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "Float Floating point number", + "type": "Number" + }, + "example": [ + "\n
    \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n let rows = table.getRows();\n let minId = Infinity;\n let maxId = -Infinity;\n for (let r = 0; r < rows.length; r++) {\n let id = rows[r].getNum('id');\n minId = min(minId, id);\n maxId = min(maxId, id);\n }\n print('minimum id = ' + minId + ', maximum id = ' + maxId);\n }\n
    " + ], + "alt": "no image displayed", + "class": "p5.TableRow", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.TableRow.js", + "line": 299, + "description": "

    Retrieves an String value from the TableRow's specified\ncolumn. The column may be specified by either its ID or\ntitle.

    \n", + "itemtype": "method", + "name": "getString", + "params": [ + { + "name": "column", + "description": "

    columnName (string) or\n ID (number)

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "String", + "type": "String" + }, + "example": [ + "\n
    \n // Given the CSV file \"mammals.csv\" in the project's \"assets\" folder:\n //\n // id,species,name\n // 0,Capra hircus,Goat\n // 1,Panthera pardus,Leopard\n // 2,Equus zebra,Zebra\n\n let table;\n\n function preload() {\n //my table is comma separated value \"csv\"\n //and has a header specifying the columns labels\n table = loadTable('assets/mammals.csv', 'csv', 'header');\n }\n\n function setup() {\n let rows = table.getRows();\n let longest = '';\n for (let r = 0; r < rows.length; r++) {\n let species = rows[r].getString('species');\n if (longest.length < species.length) {\n longest = species;\n }\n }\n\n print('longest: ' + longest);\n }\n
    " + ], + "alt": "no image displayed", + "class": "p5.TableRow", + "module": "IO", + "submodule": "Table" + }, + { + "file": "src/io/p5.XML.js", + "line": 65, + "description": "

    Gets a copy of the element's parent. Returns the parent as another\np5.XML object.

    \n", + "itemtype": "method", + "name": "getParent", + "return": { + "description": "element parent", + "type": "p5.XML" + }, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let children = xml.getChildren('animal');\n let parent = children[1].getParent();\n print(parent.getName());\n}\n\n// Sketch prints:\n// mammals\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 103, + "description": "

    Gets the element's full name, which is returned as a String.

    \n", + "itemtype": "method", + "name": "getName", + "return": { + "description": "the name of the node", + "type": "String" + }, + "example": [ + "<animal\n
    \n // The following short XML file called \"mammals.xml\" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n // <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n // <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n // </mammals>\n\n let xml;\n\n function preload() {\n xml = loadXML('assets/mammals.xml');\n }\n\n function setup() {\n print(xml.getName());\n }\n\n // Sketch prints:\n // mammals\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 138, + "description": "

    Sets the element's name, which is specified as a String.

    \n", + "itemtype": "method", + "name": "setName", + "params": [ + { + "name": "the", + "description": "

    new name of the node

    \n", + "type": "String" + } + ], + "example": [ + "<animal\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n print(xml.getName());\n xml.setName('fish');\n print(xml.getName());\n}\n\n// Sketch prints:\n// mammals\n// fish\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 184, + "description": "

    Checks whether or not the element has any children, and returns the result\nas a boolean.

    \n", + "itemtype": "method", + "name": "hasChildren", + "return": { + "description": "", + "type": "Boolean" + }, + "example": [ + "<animal\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n print(xml.hasChildren());\n}\n\n// Sketch prints:\n// true\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 220, + "description": "

    Get the names of all of the element's children, and returns the names as an\narray of Strings. This is the same as looping through and calling getName()\non each child element individually.

    \n", + "itemtype": "method", + "name": "listChildren", + "return": { + "description": "names of the children of the element", + "type": "String[]" + }, + "example": [ + "<animal\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n print(xml.listChildren());\n}\n\n// Sketch prints:\n// [\"animal\", \"animal\", \"animal\"]\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 261, + "description": "

    Returns all of the element's children as an array of p5.XML objects. When\nthe name parameter is specified, then it will return all children that match\nthat name.

    \n", + "itemtype": "method", + "name": "getChildren", + "params": [ + { + "name": "name", + "description": "

    element name

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "children of the element", + "type": "p5.XML[]" + }, + "example": [ + "<animal\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let animals = xml.getChildren('animal');\n\n for (let i = 0; i < animals.length; i++) {\n print(animals[i].getContent());\n }\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Leopard\"\n// \"Zebra\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 317, + "description": "

    Returns the first of the element's children that matches the name parameter\nor the child of the given index.It returns undefined if no matching\nchild is found.

    \n", + "itemtype": "method", + "name": "getChild", + "params": [ + { + "name": "name", + "description": "

    element name or index

    \n", + "type": "String|Integer" + } + ], + "return": { + "description": "", + "type": "p5.XML" + }, + "example": [ + "<animal\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n
    \n
    \nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let secondChild = xml.getChild(1);\n print(secondChild.getContent());\n}\n\n// Sketch prints:\n// \"Leopard\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 378, + "description": "

    Appends a new child to the element. The child can be specified with\neither a String, which will be used as the new tag's name, or as a\nreference to an existing p5.XML object.\nA reference to the newly created child is returned as an p5.XML object.

    \n", + "itemtype": "method", + "name": "addChild", + "params": [ + { + "name": "node", + "description": "

    a p5.XML Object which will be the child to be added

    \n", + "type": "p5.XML" + } + ], + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let child = new p5.XML();\n child.setName('animal');\n child.setAttribute('id', '3');\n child.setAttribute('species', 'Ornithorhynchus anatinus');\n child.setContent('Platypus');\n xml.addChild(child);\n\n let animals = xml.getChildren('animal');\n print(animals[animals.length - 1].getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Leopard\"\n// \"Zebra\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 430, + "description": "

    Removes the element specified by name or index.

    \n", + "itemtype": "method", + "name": "removeChild", + "params": [ + { + "name": "name", + "description": "

    element name or index

    \n", + "type": "String|Integer" + } + ], + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n xml.removeChild('animal');\n let children = xml.getChildren();\n for (let i = 0; i < children.length; i++) {\n print(children[i].getContent());\n }\n}\n\n// Sketch prints:\n// \"Leopard\"\n// \"Zebra\"\n
    \n
    \nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n xml.removeChild(1);\n let children = xml.getChildren();\n for (let i = 0; i < children.length; i++) {\n print(children[i].getContent());\n }\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Zebra\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 502, + "description": "

    Counts the specified element's number of attributes, returned as an Number.

    \n", + "itemtype": "method", + "name": "getAttributeCount", + "return": { + "description": "", + "type": "Integer" + }, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.getAttributeCount());\n}\n\n// Sketch prints:\n// 2\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 538, + "description": "

    Gets all of the specified element's attributes, and returns them as an\narray of Strings.

    \n", + "itemtype": "method", + "name": "listAttributes", + "return": { + "description": "an array of strings containing the names of attributes", + "type": "String[]" + }, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.listAttributes());\n}\n\n// Sketch prints:\n// [\"id\", \"species\"]\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 580, + "description": "

    Checks whether or not an element has the specified attribute.

    \n", + "itemtype": "method", + "name": "hasAttribute", + "params": [ + { + "name": "the", + "description": "

    attribute to be checked

    \n", + "type": "String" + } + ], + "return": { + "description": "true if attribute found else false", + "type": "Boolean" + }, + "example": [ + "\n
    \n // The following short XML file called \"mammals.xml\" is parsed\n // in the code below.\n //\n // \n // <mammals>\n // <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n // <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n // <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n // </mammals>\n\n let xml;\n\n function preload() {\n xml = loadXML('assets/mammals.xml');\n }\n\n function setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.hasAttribute('species'));\n print(firstChild.hasAttribute('color'));\n }\n\n // Sketch prints:\n // true\n // false\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 624, + "description": "

    Returns an attribute value of the element as an Number. If the defaultValue\nparameter is specified and the attribute doesn't exist, then defaultValue\nis returned. If no defaultValue is specified and the attribute doesn't\nexist, the value 0 is returned.

    \n", + "itemtype": "method", + "name": "getNum", + "params": [ + { + "name": "name", + "description": "

    the non-null full name of the attribute

    \n", + "type": "String" + }, + { + "name": "defaultValue", + "description": "

    the default value of the attribute

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.getNum('id'));\n}\n\n// Sketch prints:\n// 0\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 670, + "description": "

    Returns an attribute value of the element as an String. If the defaultValue\nparameter is specified and the attribute doesn't exist, then defaultValue\nis returned. If no defaultValue is specified and the attribute doesn't\nexist, null is returned.

    \n", + "itemtype": "method", + "name": "getString", + "params": [ + { + "name": "name", + "description": "

    the non-null full name of the attribute

    \n", + "type": "String" + }, + { + "name": "defaultValue", + "description": "

    the default value of the attribute

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "", + "type": "String" + }, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.getString('species'));\n}\n\n// Sketch prints:\n// \"Capra hircus\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 716, + "description": "

    Sets the content of an element's attribute. The first parameter specifies\nthe attribute name, while the second specifies the new content.

    \n", + "itemtype": "method", + "name": "setAttribute", + "params": [ + { + "name": "name", + "description": "

    the full name of the attribute

    \n", + "type": "String" + }, + { + "name": "value", + "description": "

    the value of the attribute

    \n", + "type": "Number|String|Boolean" + } + ], + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.getString('species'));\n firstChild.setAttribute('species', 'Jamides zebra');\n print(firstChild.getString('species'));\n}\n\n// Sketch prints:\n// \"Capra hircus\"\n// \"Jamides zebra\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 757, + "description": "

    Returns the content of an element. If there is no such content,\ndefaultValue is returned if specified, otherwise null is returned.

    \n", + "itemtype": "method", + "name": "getContent", + "params": [ + { + "name": "defaultValue", + "description": "

    value returned if no content is found

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "", + "type": "String" + }, + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 798, + "description": "

    Sets the element's content.

    \n", + "itemtype": "method", + "name": "setContent", + "params": [ + { + "name": "text", + "description": "

    the new content

    \n", + "type": "String" + } + ], + "example": [ + "\n
    \n// The following short XML file called \"mammals.xml\" is parsed\n// in the code below.\n//\n// \n// <mammals>\n// <animal id=\"0\" species=\"Capra hircus\">Goat</animal>\n// <animal id=\"1\" species=\"Panthera pardus\">Leopard</animal>\n// <animal id=\"2\" species=\"Equus zebra\">Zebra</animal>\n// </mammals>\n\nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n let firstChild = xml.getChild('animal');\n print(firstChild.getContent());\n firstChild.setContent('Mountain Goat');\n print(firstChild.getContent());\n}\n\n// Sketch prints:\n// \"Goat\"\n// \"Mountain Goat\"\n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/io/p5.XML.js", + "line": 839, + "description": "

    Serializes the element into a string. This function is useful for preparing\nthe content to be sent over a http request or saved to file.

    \n", + "itemtype": "method", + "name": "serialize", + "return": { + "description": "Serialized string of the element", + "type": "String" + }, + "example": [ + "\n
    \nlet xml;\n\nfunction preload() {\n xml = loadXML('assets/mammals.xml');\n}\n\nfunction setup() {\n print(xml.serialize());\n}\n\n// Sketch prints:\n// \n// Goat\n// Leopard\n// Zebra\n// \n
    " + ], + "class": "p5.XML", + "module": "IO", + "submodule": "XML" + }, + { + "file": "src/math/calculation.js", + "line": 12, + "description": "

    Calculates the absolute value (magnitude) of a number. Maps to Math.abs().\nThe absolute value of a number is always positive.

    \n", + "itemtype": "method", + "name": "abs", + "params": [ + { + "name": "n", + "description": "

    number to compute

    \n", + "type": "Number" + } + ], + "return": { + "description": "absolute value of given number", + "type": "Number" + }, + "example": [ + "\n
    \nfunction setup() {\n let x = -3;\n let y = abs(x);\n\n print(x); // -3\n print(y); // 3\n}\n
    " + ], + "alt": "no image displayed", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 36, + "description": "

    Calculates the closest int value that is greater than or equal to the\nvalue of the parameter. Maps to Math.ceil(). For example, ceil(9.03)\nreturns the value 10.

    \n", + "itemtype": "method", + "name": "ceil", + "params": [ + { + "name": "n", + "description": "

    number to round up

    \n", + "type": "Number" + } + ], + "return": { + "description": "rounded up number", + "type": "Integer" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n // map, mouseX between 0 and 5.\n let ax = map(mouseX, 0, 100, 0, 5);\n let ay = 66;\n\n //Get the ceiling of the mapped number.\n let bx = ceil(map(mouseX, 0, 100, 0, 5));\n let by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2), ax, ay - 5);\n text(nfc(bx, 1), bx, by - 5);\n}\n
    " + ], + "alt": "2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 76, + "description": "

    Constrains a value between a minimum and maximum value.

    \n", + "itemtype": "method", + "name": "constrain", + "params": [ + { + "name": "n", + "description": "

    number to constrain

    \n", + "type": "Number" + }, + { + "name": "low", + "description": "

    minimum limit

    \n", + "type": "Number" + }, + { + "name": "high", + "description": "

    maximum limit

    \n", + "type": "Number" + } + ], + "return": { + "description": "constrained number", + "type": "Number" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n\n let leftWall = 25;\n let rightWall = 75;\n\n // xm is just the mouseX, while\n // xc is the mouseX, but constrained\n // between the leftWall and rightWall!\n let xm = mouseX;\n let xc = constrain(mouseX, leftWall, rightWall);\n\n // Draw the walls.\n stroke(150);\n line(leftWall, 0, leftWall, height);\n line(rightWall, 0, rightWall, height);\n\n // Draw xm and xc as circles.\n noStroke();\n fill(150);\n ellipse(xm, 33, 9, 9); // Not Constrained\n fill(0);\n ellipse(xc, 66, 9, 9); // Constrained\n}\n
    " + ], + "alt": "2 vertical lines. 2 ellipses move with mouse X 1 does not move passed lines", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 121, + "description": "

    Calculates the distance between two points.

    \n", + "itemtype": "method", + "name": "dist", + "return": { + "description": "distance between the two points", + "type": "Number" + }, + "example": [ + "\n
    \n// Move your mouse inside the canvas to see the\n// change in distance between two points!\nfunction draw() {\n background(200);\n fill(0);\n\n let x1 = 10;\n let y1 = 90;\n let x2 = mouseX;\n let y2 = mouseY;\n\n line(x1, y1, x2, y2);\n ellipse(x1, y1, 7, 7);\n ellipse(x2, y2, 7, 7);\n\n // d is the length of the line\n // the distance from point 1 to point 2.\n let d = int(dist(x1, y1, x2, y2));\n\n // Let's write d along the line we are drawing!\n push();\n translate((x1 + x2) / 2, (y1 + y2) / 2);\n rotate(atan2(y2 - y1, x2 - x1));\n text(nfc(d, 1), 0, -5);\n pop();\n // Fancy!\n}\n
    " + ], + "alt": "2 ellipses joined by line. 1 ellipse moves with mouse X&Y. Distance displayed.", + "class": "p5", + "module": "Math", + "submodule": "Calculation", + "overloads": [ + { + "line": 121, + "params": [ + { + "name": "x1", + "description": "

    x-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "y1", + "description": "

    y-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "

    x-coordinate of the second point

    \n", + "type": "Number" + }, + { + "name": "y2", + "description": "

    y-coordinate of the second point

    \n", + "type": "Number" + } + ], + "return": { + "description": "distance between the two points", + "type": "Number" + } + }, + { + "line": 165, + "params": [ + { + "name": "x1", + "description": "", + "type": "Number" + }, + { + "name": "y1", + "description": "", + "type": "Number" + }, + { + "name": "z1", + "description": "

    z-coordinate of the first point

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "", + "type": "Number" + }, + { + "name": "y2", + "description": "", + "type": "Number" + }, + { + "name": "z2", + "description": "

    z-coordinate of the second point

    \n", + "type": "Number" + } + ], + "return": { + "description": "distance between the two points", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/calculation.js", + "line": 190, + "description": "

    Returns Euler's number e (2.71828...) raised to the power of the n\nparameter. Maps to Math.exp().

    \n", + "itemtype": "method", + "name": "exp", + "params": [ + { + "name": "n", + "description": "

    exponent to raise

    \n", + "type": "Number" + } + ], + "return": { + "description": "e^n", + "type": "Number" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n\n // Compute the exp() function with a value between 0 and 2\n let xValue = map(mouseX, 0, width, 0, 2);\n let yValue = exp(xValue);\n\n let y = map(yValue, 0, 8, height, 0);\n\n let legend = 'exp (' + nfc(xValue, 3) + ')\\n= ' + nf(yValue, 1, 4);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text(legend, 5, 15);\n noStroke();\n ellipse(mouseX, y, 7, 7);\n\n // Draw the exp(x) curve,\n // over the domain of x from 0 to 2\n noFill();\n stroke(0);\n beginShape();\n for (let x = 0; x < width; x++) {\n xValue = map(x, 0, width, 0, 2);\n yValue = exp(xValue);\n y = map(yValue, 0, 8, height, 0);\n vertex(x, y);\n }\n\n endShape();\n line(0, 0, 0, height);\n line(0, height - 1, width, height - 1);\n}\n
    " + ], + "alt": "ellipse moves along a curve with mouse x. e^n displayed.", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 240, + "description": "

    Calculates the closest int value that is less than or equal to the\nvalue of the parameter. Maps to Math.floor().

    \n", + "itemtype": "method", + "name": "floor", + "params": [ + { + "name": "n", + "description": "

    number to round down

    \n", + "type": "Number" + } + ], + "return": { + "description": "rounded down number", + "type": "Integer" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n let ax = map(mouseX, 0, 100, 0, 5);\n let ay = 66;\n\n //Get the floor of the mapped number.\n let bx = floor(map(mouseX, 0, 100, 0, 5));\n let by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2), ax, ay - 5);\n text(nfc(bx, 1), bx, by - 5);\n}\n
    " + ], + "alt": "2 horizontal lines & number sets. increase with mouse x. bottom to 2 decimals", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 279, + "description": "

    Calculates a number between two numbers at a specific increment. The amt\nparameter is the amount to interpolate between the two values where 0.0\nequal to the first point, 0.1 is very near the first point, 0.5 is\nhalf-way in between, and 1.0 is equal to the second point. If the\nvalue of amt is more than 1.0 or less than 0.0, the number will be\ncalculated accordingly in the ratio of the two given numbers. The lerp\nfunction is convenient for creating motion along a straight\npath and for drawing dotted lines.

    \n", + "itemtype": "method", + "name": "lerp", + "params": [ + { + "name": "start", + "description": "

    first value

    \n", + "type": "Number" + }, + { + "name": "stop", + "description": "

    second value

    \n", + "type": "Number" + }, + { + "name": "amt", + "description": "

    number

    \n", + "type": "Number" + } + ], + "return": { + "description": "lerped value", + "type": "Number" + }, + "example": [ + "\n
    \nfunction setup() {\n background(200);\n let a = 20;\n let b = 80;\n let c = lerp(a, b, 0.2);\n let d = lerp(a, b, 0.5);\n let e = lerp(a, b, 0.8);\n\n let y = 50;\n\n strokeWeight(5);\n stroke(0); // Draw the original points in black\n point(a, y);\n point(b, y);\n\n stroke(100); // Draw the lerp points in gray\n point(c, y);\n point(d, y);\n point(e, y);\n}\n
    " + ], + "alt": "5 points horizontally staggered mid-canvas. mid 3 are grey, outer black", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 327, + "description": "

    Calculates the natural logarithm (the base-e logarithm) of a number. This\nfunction expects the n parameter to be a value greater than 0.0. Maps to\nMath.log().

    \n", + "itemtype": "method", + "name": "log", + "params": [ + { + "name": "n", + "description": "

    number greater than 0

    \n", + "type": "Number" + } + ], + "return": { + "description": "natural logarithm of n", + "type": "Number" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n let maxX = 2.8;\n let maxY = 1.5;\n\n // Compute the natural log of a value between 0 and maxX\n let xValue = map(mouseX, 0, width, 0, maxX);\n let yValue, y;\n if (xValue > 0) {\n // Cannot take the log of a negative number.\n yValue = log(xValue);\n y = map(yValue, -maxY, maxY, height, 0);\n\n // Display the calculation occurring.\n let legend = 'log(' + nf(xValue, 1, 2) + ')\\n= ' + nf(yValue, 1, 3);\n stroke(150);\n line(mouseX, y, mouseX, height);\n fill(0);\n text(legend, 5, 15);\n noStroke();\n ellipse(mouseX, y, 7, 7);\n }\n\n // Draw the log(x) curve,\n // over the domain of x from 0 to maxX\n noFill();\n stroke(0);\n beginShape();\n for (let x = 0; x < width; x++) {\n xValue = map(x, 0, width, 0, maxX);\n yValue = log(xValue);\n y = map(yValue, -maxY, maxY, height, 0);\n vertex(x, y);\n }\n endShape();\n line(0, 0, 0, height);\n line(0, height / 2, width, height / 2);\n}\n
    " + ], + "alt": "ellipse moves along a curve with mouse x. natural logarithm of n displayed.", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 383, + "description": "

    Calculates the magnitude (or length) of a vector. A vector is a direction\nin space commonly used in computer graphics and linear algebra. Because it\nhas no "start" position, the magnitude of a vector can be thought of as\nthe distance from the coordinate 0,0 to its x,y value. Therefore, mag() is\na shortcut for writing dist(0, 0, x, y).

    \n", + "itemtype": "method", + "name": "mag", + "params": [ + { + "name": "a", + "description": "

    first value

    \n", + "type": "Number" + }, + { + "name": "b", + "description": "

    second value

    \n", + "type": "Number" + } + ], + "return": { + "description": "magnitude of vector from (0,0) to (a,b)", + "type": "Number" + }, + "example": [ + "\n
    \nfunction setup() {\n let x1 = 20;\n let x2 = 80;\n let y1 = 30;\n let y2 = 70;\n\n line(0, 0, x1, y1);\n print(mag(x1, y1)); // Prints \"36.05551275463989\"\n line(0, 0, x2, y1);\n print(mag(x2, y1)); // Prints \"85.44003745317531\"\n line(0, 0, x1, y2);\n print(mag(x1, y2)); // Prints \"72.80109889280519\"\n line(0, 0, x2, y2);\n print(mag(x2, y2)); // Prints \"106.3014581273465\"\n}\n
    " + ], + "alt": "4 lines of different length radiate from top left of canvas.", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 422, + "description": "

    Re-maps a number from one range to another.\n

    \nIn the first example above, the number 25 is converted from a value in the\nrange of 0 to 100 into a value that ranges from the left edge of the\nwindow (0) to the right edge (width).

    \n", + "itemtype": "method", + "name": "map", + "params": [ + { + "name": "value", + "description": "

    the incoming value to be converted

    \n", + "type": "Number" + }, + { + "name": "start1", + "description": "

    lower bound of the value's current range

    \n", + "type": "Number" + }, + { + "name": "stop1", + "description": "

    upper bound of the value's current range

    \n", + "type": "Number" + }, + { + "name": "start2", + "description": "

    lower bound of the value's target range

    \n", + "type": "Number" + }, + { + "name": "stop2", + "description": "

    upper bound of the value's target range

    \n", + "type": "Number" + }, + { + "name": "withinBounds", + "description": "

    constrain the value to the newly mapped range

    \n", + "type": "Boolean", + "optional": true + } + ], + "return": { + "description": "remapped number", + "type": "Number" + }, + "example": [ + "\n
    \nlet value = 25;\nlet m = map(value, 0, 100, 0, width);\nellipse(m, 50, 10, 10);\n
    \n\n
    \nfunction setup() {\n noStroke();\n}\n\nfunction draw() {\n background(204);\n let x1 = map(mouseX, 0, width, 25, 75);\n ellipse(x1, 25, 25, 25);\n //This ellipse is constrained to the 0-100 range\n //after setting withinBounds to true\n let x2 = map(mouseX, 0, width, 0, 100, true);\n ellipse(x2, 75, 25, 25);\n}\n
    " + ], + "alt": "10 by 10 white ellipse with in mid left canvas\n2 25 by 25 white ellipses move with mouse x. Bottom has more range from X", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 478, + "description": "

    Determines the largest value in a sequence of numbers, and then returns\nthat value. max() accepts any number of Number parameters, or an Array\nof any length.

    \n", + "itemtype": "method", + "name": "max", + "return": { + "description": "maximum Number", + "type": "Number" + }, + "example": [ + "\n
    \nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how max() works!\n let numArray = [2, 1, 5, 4, 8, 9];\n fill(0);\n noStroke();\n text('Array Elements', 0, 10);\n // Draw all numbers in the array\n let spacing = 15;\n let elemsY = 25;\n for (let i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n let maxX = 33;\n let maxY = 80;\n // Draw the Maximum value in the array.\n textSize(32);\n text(max(numArray), maxX, maxY);\n}\n
    " + ], + "alt": "Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 9", + "class": "p5", + "module": "Math", + "submodule": "Calculation", + "overloads": [ + { + "line": 478, + "params": [ + { + "name": "n0", + "description": "

    Number to compare

    \n", + "type": "Number" + }, + { + "name": "n1", + "description": "

    Number to compare

    \n", + "type": "Number" + } + ], + "return": { + "description": "maximum Number", + "type": "Number" + } + }, + { + "line": 514, + "params": [ + { + "name": "nums", + "description": "

    Numbers to compare

    \n", + "type": "Number[]" + } + ], + "return": { + "description": "", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/calculation.js", + "line": 528, + "description": "

    Determines the smallest value in a sequence of numbers, and then returns\nthat value. min() accepts any number of Number parameters, or an Array\nof any length.

    \n", + "itemtype": "method", + "name": "min", + "return": { + "description": "minimum Number", + "type": "Number" + }, + "example": [ + "\n
    \nfunction setup() {\n // Change the elements in the array and run the sketch\n // to show how min() works!\n let numArray = [2, 1, 5, 4, 8, 9];\n fill(0);\n noStroke();\n text('Array Elements', 0, 10);\n // Draw all numbers in the array\n let spacing = 15;\n let elemsY = 25;\n for (let i = 0; i < numArray.length; i++) {\n text(numArray[i], i * spacing, elemsY);\n }\n let maxX = 33;\n let maxY = 80;\n // Draw the Minimum value in the array.\n textSize(32);\n text(min(numArray), maxX, maxY);\n}\n
    " + ], + "alt": "Small text at top reads: Array Elements 2 1 5 4 8 9. Large text at center: 1", + "class": "p5", + "module": "Math", + "submodule": "Calculation", + "overloads": [ + { + "line": 528, + "params": [ + { + "name": "n0", + "description": "

    Number to compare

    \n", + "type": "Number" + }, + { + "name": "n1", + "description": "

    Number to compare

    \n", + "type": "Number" + } + ], + "return": { + "description": "minimum Number", + "type": "Number" + } + }, + { + "line": 564, + "params": [ + { + "name": "nums", + "description": "

    Numbers to compare

    \n", + "type": "Number[]" + } + ], + "return": { + "description": "", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/calculation.js", + "line": 578, + "description": "

    Normalizes a number from another range into a value between 0 and 1.\nIdentical to map(value, low, high, 0, 1).\nNumbers outside of the range are not clamped to 0 and 1, because\nout-of-range values are often intentional and useful. (See the example above.)

    \n", + "itemtype": "method", + "name": "norm", + "params": [ + { + "name": "value", + "description": "

    incoming value to be normalized

    \n", + "type": "Number" + }, + { + "name": "start", + "description": "

    lower bound of the value's current range

    \n", + "type": "Number" + }, + { + "name": "stop", + "description": "

    upper bound of the value's current range

    \n", + "type": "Number" + } + ], + "return": { + "description": "normalized number", + "type": "Number" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n let currentNum = mouseX;\n let lowerBound = 0;\n let upperBound = width; //100;\n let normalized = norm(currentNum, lowerBound, upperBound);\n let lineY = 70;\n stroke(3);\n line(0, lineY, width, lineY);\n //Draw an ellipse mapped to the non-normalized value.\n noStroke();\n fill(50);\n let s = 7; // ellipse size\n ellipse(currentNum, lineY, s, s);\n\n // Draw the guide\n let guideY = lineY + 15;\n text('0', 0, guideY);\n textAlign(RIGHT);\n text('100', width, guideY);\n\n // Draw the normalized value\n textAlign(LEFT);\n fill(0);\n textSize(32);\n let normalY = 40;\n let normalX = 20;\n text(normalized, normalX, normalY);\n}\n
    " + ], + "alt": "ellipse moves with mouse. 0 shown left & 100 right and updating values center", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 631, + "description": "

    Facilitates exponential expressions. The pow() function is an efficient\nway of multiplying numbers by themselves (or their reciprocals) in large\nquantities. For example, pow(3, 5) is equivalent to the expression\n33333 and pow(3, -5) is equivalent to 1 / 33333. Maps to\nMath.pow().

    \n", + "itemtype": "method", + "name": "pow", + "params": [ + { + "name": "n", + "description": "

    base of the exponential expression

    \n", + "type": "Number" + }, + { + "name": "e", + "description": "

    power by which to raise the base

    \n", + "type": "Number" + } + ], + "return": { + "description": "n^e", + "type": "Number" + }, + "example": [ + "\n
    \nfunction setup() {\n //Exponentially increase the size of an ellipse.\n let eSize = 3; // Original Size\n let eLoc = 10; // Original Location\n\n ellipse(eLoc, eLoc, eSize, eSize);\n\n ellipse(eLoc * 2, eLoc * 2, pow(eSize, 2), pow(eSize, 2));\n\n ellipse(eLoc * 4, eLoc * 4, pow(eSize, 3), pow(eSize, 3));\n\n ellipse(eLoc * 8, eLoc * 8, pow(eSize, 4), pow(eSize, 4));\n}\n
    " + ], + "alt": "small to large ellipses radiating from top left of canvas", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 665, + "description": "

    Calculates the integer closest to the n parameter. For example,\nround(133.8) returns the value 134. Maps to Math.round().

    \n", + "itemtype": "method", + "name": "round", + "params": [ + { + "name": "n", + "description": "

    number to round

    \n", + "type": "Number" + } + ], + "return": { + "description": "rounded number", + "type": "Integer" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n //map, mouseX between 0 and 5.\n let ax = map(mouseX, 0, 100, 0, 5);\n let ay = 66;\n\n // Round the mapped number.\n let bx = round(map(mouseX, 0, 100, 0, 5));\n let by = 33;\n\n // Multiply the mapped numbers by 20 to more easily\n // see the changes.\n stroke(0);\n fill(0);\n line(0, ay, ax * 20, ay);\n line(0, by, bx * 20, by);\n\n // Reformat the float returned by map and draw it.\n noStroke();\n text(nfc(ax, 2), ax, ay - 5);\n text(nfc(bx, 1), bx, by - 5);\n}\n
    " + ], + "alt": "horizontal center line squared values displayed on top and regular on bottom.", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 704, + "description": "

    Squares a number (multiplies a number by itself). The result is always a\npositive number, as multiplying two negative numbers always yields a\npositive result. For example, -1 * -1 = 1.

    \n", + "itemtype": "method", + "name": "sq", + "params": [ + { + "name": "n", + "description": "

    number to square

    \n", + "type": "Number" + } + ], + "return": { + "description": "squared number", + "type": "Number" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n let eSize = 7;\n let x1 = map(mouseX, 0, width, 0, 10);\n let y1 = 80;\n let x2 = sq(x1);\n let y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100);\n line(0, height / 2, width, height / 2);\n\n // Draw text.\n let spacing = 15;\n noStroke();\n fill(0);\n text('x = ' + x1, 0, y1 + spacing);\n text('sq(x) = ' + x2, 0, y2 + spacing);\n}\n
    " + ], + "alt": "horizontal center line squared values displayed on top and regular on bottom.", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/calculation.js", + "line": 751, + "description": "

    Calculates the square root of a number. The square root of a number is\nalways positive, even though there may be a valid negative root. The\nsquare root s of number a is such that s*s = a. It is the opposite of\nsquaring. Maps to Math.sqrt().

    \n", + "itemtype": "method", + "name": "sqrt", + "params": [ + { + "name": "n", + "description": "

    non-negative number to square root

    \n", + "type": "Number" + } + ], + "return": { + "description": "square root of number", + "type": "Number" + }, + "example": [ + "\n
    \nfunction draw() {\n background(200);\n let eSize = 7;\n let x1 = mouseX;\n let y1 = 80;\n let x2 = sqrt(x1);\n let y2 = 20;\n\n // Draw the non-squared.\n line(0, y1, width, y1);\n ellipse(x1, y1, eSize, eSize);\n\n // Draw the squared.\n line(0, y2, width, y2);\n ellipse(x2, y2, eSize, eSize);\n\n // Draw dividing line.\n stroke(100);\n line(0, height / 2, width, height / 2);\n\n // Draw text.\n noStroke();\n fill(0);\n let spacing = 15;\n text('x = ' + x1, 0, y1 + spacing);\n text('sqrt(x) = ' + x2, 0, y2 + spacing);\n}\n
    " + ], + "alt": "horizontal center line squareroot values displayed on top and regular on bottom.", + "class": "p5", + "module": "Math", + "submodule": "Calculation" + }, + { + "file": "src/math/math.js", + "line": 12, + "description": "

    Creates a new p5.Vector (the datatype for storing vectors). This provides a\ntwo or three dimensional vector, specifically a Euclidean (also known as\ngeometric) vector. A vector is an entity that has both magnitude and\ndirection.

    \n", + "itemtype": "method", + "name": "createVector", + "params": [ + { + "name": "x", + "description": "

    x component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    y component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    z component of the vector

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "", + "type": "p5.Vector" + }, + "example": [ + "\n
    \nfunction setup() {\n createCanvas(100, 100, WEBGL);\n noStroke();\n fill(255, 102, 204);\n}\n\nfunction draw() {\n background(255);\n pointLight(color(255), createVector(sin(millis() / 1000) * 20, -40, -10));\n scale(0.75);\n sphere();\n}\n
    " + ], + "alt": "a purple sphere lit by a point light oscillating horizontally", + "class": "p5", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/noise.js", + "line": 40, + "description": "

    Returns the Perlin noise value at specified coordinates. Perlin noise is\na random sequence generator producing a more natural ordered, harmonic\nsuccession of numbers compared to the standard random() function.\nIt was invented by Ken Perlin in the 1980s and been used since in\ngraphical applications to produce procedural textures, natural motion,\nshapes, terrains etc.

    The main difference to the\nrandom() function is that Perlin noise is defined in an infinite\nn-dimensional space where each pair of coordinates corresponds to a\nfixed semi-random value (fixed only for the lifespan of the program; see\nthe noiseSeed() function). p5.js can compute 1D, 2D and 3D noise,\ndepending on the number of coordinates given. The resulting value will\nalways be between 0.0 and 1.0. The noise value can be animated by moving\nthrough the noise space as demonstrated in the example above. The 2nd\nand 3rd dimension can also be interpreted as time.

    The actual\nnoise is structured similar to an audio signal, in respect to the\nfunction's use of frequencies. Similar to the concept of harmonics in\nphysics, perlin noise is computed over several octaves which are added\ntogether for the final result.

    Another way to adjust the\ncharacter of the resulting sequence is the scale of the input\ncoordinates. As the function works within an infinite space the value of\nthe coordinates doesn't matter as such, only the distance between\nsuccessive coordinates does (eg. when using noise() within a\nloop). As a general rule the smaller the difference between coordinates,\nthe smoother the resulting noise sequence will be. Steps of 0.005-0.03\nwork best for most applications, but this will differ depending on use.

    \n", + "itemtype": "method", + "name": "noise", + "params": [ + { + "name": "x", + "description": "

    x-coordinate in noise space

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate in noise space

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    z-coordinate in noise space

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "Perlin noise value (between 0 and 1) at specified\n coordinates", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet xoff = 0.0;\n\nfunction draw() {\n background(204);\n xoff = xoff + 0.01;\n let n = noise(xoff) * width;\n line(n, 0, n, height);\n}\n\n
    \n
    \nlet noiseScale=0.02;\n\nfunction draw() {\n background(0);\n for (let x=0; x < width; x++) {\n let noiseVal = noise((mouseX+x)*noiseScale, mouseY*noiseScale);\n stroke(noiseVal*255);\n line(x, mouseY+noiseVal*80, x, height);\n }\n}\n\n
    " + ], + "alt": "vertical line moves left to right with updating noise values.\nhorizontal wave pattern effected by mouse x-position & updating noise values.", + "class": "p5", + "module": "Math", + "submodule": "Noise" + }, + { + "file": "src/math/noise.js", + "line": 187, + "description": "

    Adjusts the character and level of detail produced by the Perlin noise\n function. Similar to harmonics in physics, noise is computed over\n several octaves. Lower octaves contribute more to the output signal and\n as such define the overall intensity of the noise, whereas higher octaves\n create finer grained details in the noise sequence.\n

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

    \n By changing these parameters, the signal created by the noise()\n function can be adapted to fit very specific needs and characteristics.

    \n", + "itemtype": "method", + "name": "noiseDetail", + "params": [ + { + "name": "lod", + "description": "

    number of octaves to be used by the noise

    \n", + "type": "Number" + }, + { + "name": "falloff", + "description": "

    falloff factor for each octave

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n \n let noiseVal;\n let noiseScale = 0.02;\nfunction setup() {\n createCanvas(100, 100);\n }\nfunction draw() {\n background(0);\n for (let y = 0; y < height; y++) {\n for (let x = 0; x < width / 2; x++) {\n noiseDetail(2, 0.2);\n noiseVal = noise((mouseX + x) * noiseScale, (mouseY + y) * noiseScale);\n stroke(noiseVal * 255);\n point(x, y);\n noiseDetail(8, 0.65);\n noiseVal = noise(\n (mouseX + x + width / 2) * noiseScale,\n (mouseY + y) * noiseScale\n );\n stroke(noiseVal * 255);\n point(x + width / 2, y);\n }\n }\n }\n \n
    " + ], + "alt": "2 vertical grey smokey patterns affected my mouse x-position and noise.", + "class": "p5", + "module": "Math", + "submodule": "Noise" + }, + { + "file": "src/math/noise.js", + "line": 253, + "description": "

    Sets the seed value for noise(). By default, noise()\nproduces different results each time the program is run. Set the\nvalue parameter to a constant to return the same pseudo-random\nnumbers each time the software is run.

    \n", + "itemtype": "method", + "name": "noiseSeed", + "params": [ + { + "name": "seed", + "description": "

    the seed value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \nlet xoff = 0.0;\n\nfunction setup() {\n noiseSeed(99);\n stroke(0, 10);\n}\n\nfunction draw() {\n xoff = xoff + .01;\n let n = noise(xoff) * width;\n line(n, 0, n, height);\n}\n\n
    " + ], + "alt": "vertical grey lines drawing in pattern affected by noise.", + "class": "p5", + "module": "Math", + "submodule": "Noise" + }, + { + "file": "src/math/p5.Vector.js", + "line": 67, + "description": "

    The x component of the vector

    \n", + "itemtype": "property", + "name": "x", + "type": "Number", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 72, + "description": "

    The y component of the vector

    \n", + "itemtype": "property", + "name": "y", + "type": "Number", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 77, + "description": "

    The z component of the vector

    \n", + "itemtype": "property", + "name": "z", + "type": "Number", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 84, + "description": "

    Returns a string representation of a vector v by calling String(v)\nor v.toString(). This method is useful for logging vectors in the\nconsole.

    \n", + "itemtype": "method", + "name": "toString", + "return": { + "description": "", + "type": "String" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let v = createVector(20, 30);\n print(String(v)); // prints \"p5.Vector Object : [20, 30, 0]\"\n}\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 0);\n let v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'black');\n\n noStroke();\n text(v1.toString(), 10, 25, 90, 75);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 134, + "description": "

    Sets the x, y, and z component of the vector using two or three separate\nvariables, the data from a p5.Vector, or the values from a float array.

    \n", + "itemtype": "method", + "name": "set", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n let v = createVector(1, 2, 3);\n v.set(4, 5, 6); // Sets vector to [4, 5, 6]\n\n let v1 = createVector(0, 0, 0);\n let arr = [1, 2, 3];\n v1.set(arr); // Sets vector to [1, 2, 3]\n}\n\n
    \n\n
    \n\nlet v0, v1;\nfunction setup() {\n createCanvas(100, 100);\n\n v0 = createVector(0, 0);\n v1 = createVector(50, 50);\n}\n\nfunction draw() {\n background(240);\n\n drawArrow(v0, v1, 'black');\n v1.set(v1.x + random(-1, 1), v1.y + random(-1, 1));\n\n noStroke();\n text('x: ' + round(v1.x) + ' y: ' + round(v1.y), 20, 90);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 134, + "params": [ + { + "name": "x", + "description": "

    the x component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    the y component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    the z component of the vector

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 193, + "params": [ + { + "name": "value", + "description": "

    the vector to set

    \n", + "type": "p5.Vector|Number[]" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 217, + "description": "

    Gets a copy of the vector, returns a p5.Vector object.

    \n", + "itemtype": "method", + "name": "copy", + "return": { + "description": "the copy of the p5.Vector object", + "type": "p5.Vector" + }, + "example": [ + "\n
    \n\nlet v1 = createVector(1, 2, 3);\nlet v2 = v1.copy();\nprint(v1.x === v2.x && v1.y === v2.y && v1.z === v2.z);\n// Prints \"true\"\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 240, + "description": "

    Adds x, y, and z components to a vector, adds one vector to another, or\nadds two independent vectors together. The version of the method that adds\ntwo vectors together is a static method and returns a p5.Vector, the others\nacts directly on the vector. See the examples for more context.

    \n", + "itemtype": "method", + "name": "add", + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(1, 2, 3);\nv.add(4, 5, 6);\n// v's components are set to [5, 7, 9]\n\n
    \n\n
    \n\n// Static method\nlet v1 = createVector(1, 2, 3);\nlet v2 = createVector(2, 3, 4);\n\nlet v3 = p5.Vector.add(v1, v2);\n// v3 has components [3, 5, 7]\nprint(v3);\n\n
    \n\n
    \n\n// red vector + blue vector = purple vector\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 0);\n let v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'red');\n\n let v2 = createVector(-30, 20);\n drawArrow(v1, v2, 'blue');\n\n let v3 = p5.Vector.add(v1, v2);\n drawArrow(v0, v3, 'purple');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 240, + "params": [ + { + "name": "x", + "description": "

    the x component of the vector to be added

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    the y component of the vector to be added

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    the z component of the vector to be added

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 306, + "params": [ + { + "name": "value", + "description": "

    the vector to add

    \n", + "type": "p5.Vector|Number[]" + } + ], + "chainable": 1 + }, + { + "line": 1556, + "params": [ + { + "name": "v1", + "description": "

    a p5.Vector to add

    \n", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "

    a p5.Vector to add

    \n", + "type": "p5.Vector" + }, + { + "name": "target", + "description": "

    the vector to receive the result

    \n", + "type": "p5.Vector" + } + ], + "static": 1 + }, + { + "line": 1563, + "params": [ + { + "name": "v1", + "description": "", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "", + "type": "p5.Vector" + } + ], + "static": 1, + "return": { + "description": "the resulting p5.Vector", + "type": "p5.Vector" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 330, + "description": "

    Subtracts x, y, and z components from a vector, subtracts one vector from\nanother, or subtracts two independent vectors. The version of the method\nthat subtracts two vectors is a static method and returns a p5.Vector, the\nother acts directly on the vector. See the examples for more context.

    \n", + "itemtype": "method", + "name": "sub", + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(4, 5, 6);\nv.sub(1, 1, 1);\n// v's components are set to [3, 4, 5]\n\n
    \n\n
    \n\n// Static method\nlet v1 = createVector(2, 3, 4);\nlet v2 = createVector(1, 2, 3);\n\nlet v3 = p5.Vector.sub(v1, v2);\n// v3 has components [1, 1, 1]\nprint(v3);\n\n
    \n\n
    \n\n// red vector - blue vector = purple vector\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 0);\n let v1 = createVector(70, 50);\n drawArrow(v0, v1, 'red');\n\n let v2 = createVector(mouseX, mouseY);\n drawArrow(v0, v2, 'blue');\n\n let v3 = p5.Vector.sub(v1, v2);\n drawArrow(v2, v3, 'purple');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 330, + "params": [ + { + "name": "x", + "description": "

    the x component of the vector to subtract

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    the y component of the vector to subtract

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    the z component of the vector to subtract

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 396, + "params": [ + { + "name": "value", + "description": "

    the vector to subtract

    \n", + "type": "p5.Vector|Number[]" + } + ], + "chainable": 1 + }, + { + "line": 1586, + "params": [ + { + "name": "v1", + "description": "

    a p5.Vector to subtract from

    \n", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "

    a p5.Vector to subtract

    \n", + "type": "p5.Vector" + }, + { + "name": "target", + "description": "

    if undefined a new vector will be created

    \n", + "type": "p5.Vector" + } + ], + "static": 1 + }, + { + "line": 1593, + "params": [ + { + "name": "v1", + "description": "", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "", + "type": "p5.Vector" + } + ], + "static": 1, + "return": { + "description": "the resulting p5.Vector", + "type": "p5.Vector" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 420, + "description": "

    Multiply the vector by a scalar. The static version of this method\ncreates a new p5.Vector while the non static version acts on the vector\ndirectly. See the examples for more context.

    \n", + "itemtype": "method", + "name": "mult", + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(1, 2, 3);\nv.mult(2);\n// v's components are set to [2, 4, 6]\n\n
    \n\n
    \n\n// Static method\nlet v1 = createVector(1, 2, 3);\nlet v2 = p5.Vector.mult(v1, 2);\n// v2 has components [2, 4, 6]\nprint(v2);\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(50, 50);\n let v1 = createVector(25, -25);\n drawArrow(v0, v1, 'red');\n\n let num = map(mouseX, 0, width, -2, 2, true);\n let v2 = p5.Vector.mult(v1, num);\n drawArrow(v0, v2, 'blue');\n\n noStroke();\n text('multiplied by ' + num.toFixed(2), 5, 90);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 420, + "params": [ + { + "name": "n", + "description": "

    the number to multiply with the vector

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 1614, + "params": [ + { + "name": "v", + "description": "

    the vector to multiply

    \n", + "type": "p5.Vector" + }, + { + "name": "n", + "description": "", + "type": "Number" + }, + { + "name": "target", + "description": "

    if undefined a new vector will be created

    \n", + "type": "p5.Vector" + } + ], + "static": 1 + }, + { + "line": 1621, + "params": [ + { + "name": "v", + "description": "", + "type": "p5.Vector" + }, + { + "name": "n", + "description": "", + "type": "Number" + } + ], + "static": 1, + "return": { + "description": "the resulting new p5.Vector", + "type": "p5.Vector" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 495, + "description": "

    Divide the vector by a scalar. The static version of this method creates a\nnew p5.Vector while the non static version acts on the vector directly.\nSee the examples for more context.

    \n", + "itemtype": "method", + "name": "div", + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(6, 4, 2);\nv.div(2); //v's components are set to [3, 2, 1]\n\n
    \n\n
    \n\n// Static method\nlet v1 = createVector(6, 4, 2);\nlet v2 = p5.Vector.div(v1, 2);\n// v2 has components [3, 2, 1]\nprint(v2);\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 100);\n let v1 = createVector(50, -50);\n drawArrow(v0, v1, 'red');\n\n let num = map(mouseX, 0, width, 10, 0.5, true);\n let v2 = p5.Vector.div(v1, num);\n drawArrow(v0, v2, 'blue');\n\n noStroke();\n text('divided by ' + num.toFixed(2), 10, 90);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 495, + "params": [ + { + "name": "n", + "description": "

    the number to divide the vector by

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 1641, + "params": [ + { + "name": "v", + "description": "

    the vector to divide

    \n", + "type": "p5.Vector" + }, + { + "name": "n", + "description": "", + "type": "Number" + }, + { + "name": "target", + "description": "

    if undefined a new vector will be created

    \n", + "type": "p5.Vector" + } + ], + "static": 1 + }, + { + "line": 1648, + "params": [ + { + "name": "v", + "description": "", + "type": "p5.Vector" + }, + { + "name": "n", + "description": "", + "type": "Number" + } + ], + "static": 1, + "return": { + "description": "the resulting new p5.Vector", + "type": "p5.Vector" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 573, + "description": "

    Calculates the magnitude (length) of the vector and returns the result as\na float (this is simply the equation sqrt(xx + yy + z*z).)

    \n", + "itemtype": "method", + "name": "mag", + "return": { + "description": "magnitude of the vector", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 0);\n let v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'black');\n\n noStroke();\n text('vector length: ' + v1.mag().toFixed(2), 10, 70, 90, 30);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    \n
    \n\nlet v = createVector(20.0, 30.0, 40.0);\nlet m = v.mag();\nprint(m); // Prints \"53.85164807134504\"\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 573, + "params": [], + "return": { + "description": "magnitude of the vector", + "type": "Number" + } + }, + { + "line": 1738, + "params": [ + { + "name": "vecT", + "description": "

    the vector to return the magnitude of

    \n", + "type": "p5.Vector" + } + ], + "static": 1, + "return": { + "description": "the magnitude of vecT", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 621, + "description": "

    Calculates the squared magnitude of the vector and returns the result\nas a float (this is simply the equation (xx + yy + z*z).)\nFaster if the real length is not required in the\ncase of comparing vectors, etc.

    \n", + "itemtype": "method", + "name": "magSq", + "return": { + "description": "squared magnitude of the vector", + "type": "Number" + }, + "example": [ + "\n
    \n\n// Static method\nlet v1 = createVector(6, 4, 2);\nprint(v1.magSq()); // Prints \"56\"\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 0);\n let v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'black');\n\n noStroke();\n text('vector length squared: ' + v1.magSq().toFixed(2), 10, 45, 90, 55);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 675, + "description": "

    Calculates the dot product of two vectors. The version of the method\nthat computes the dot product of two independent vectors is a static\nmethod. See the examples for more context.

    \n", + "itemtype": "method", + "name": "dot", + "return": { + "description": "the dot product", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet v1 = createVector(1, 2, 3);\nlet v2 = createVector(2, 3, 4);\n\nprint(v1.dot(v2)); // Prints \"20\"\n\n
    \n\n
    \n\n//Static method\nlet v1 = createVector(1, 2, 3);\nlet v2 = createVector(3, 2, 1);\nprint(p5.Vector.dot(v1, v2)); // Prints \"10\"\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 675, + "params": [ + { + "name": "x", + "description": "

    x component of the vector

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    z component of the vector

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "the dot product", + "type": "Number" + } + }, + { + "line": 706, + "params": [ + { + "name": "value", + "description": "

    value component of the vector or a p5.Vector

    \n", + "type": "p5.Vector" + } + ], + "return": { + "description": "", + "type": "Number" + } + }, + { + "line": 1668, + "params": [ + { + "name": "v1", + "description": "

    the first p5.Vector

    \n", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "

    the second p5.Vector

    \n", + "type": "p5.Vector" + } + ], + "static": 1, + "return": { + "description": "the dot product", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 718, + "description": "

    Calculates and returns a vector composed of the cross product between\ntwo vectors. Both the static and non static methods return a new p5.Vector.\nSee the examples for more context.

    \n", + "itemtype": "method", + "name": "cross", + "return": { + "description": "p5.Vector composed of cross product", + "type": "p5.Vector" + }, + "example": [ + "\n
    \n\nlet v1 = createVector(1, 2, 3);\nlet v2 = createVector(1, 2, 3);\n\nv1.cross(v2); // v's components are [0, 0, 0]\n\n
    \n\n
    \n\n// Static method\nlet v1 = createVector(1, 0, 0);\nlet v2 = createVector(0, 1, 0);\n\nlet crossProduct = p5.Vector.cross(v1, v2);\n// crossProduct has components [0, 0, 1]\nprint(crossProduct);\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 718, + "params": [ + { + "name": "v", + "description": "

    p5.Vector to be crossed

    \n", + "type": "p5.Vector" + } + ], + "return": { + "description": "p5.Vector composed of cross product", + "type": "p5.Vector" + } + }, + { + "line": 1682, + "params": [ + { + "name": "v1", + "description": "

    the first p5.Vector

    \n", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "

    the second p5.Vector

    \n", + "type": "p5.Vector" + } + ], + "static": 1, + "return": { + "description": "the cross product", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 759, + "description": "

    Calculates the Euclidean distance between two points (considering a\npoint as a vector object).

    \n", + "itemtype": "method", + "name": "dist", + "return": { + "description": "the distance", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet v1 = createVector(1, 0, 0);\nlet v2 = createVector(0, 1, 0);\n\nlet distance = v1.dist(v2); // distance is 1.4142...\nprint(distance);\n\n
    \n\n
    \n\n// Static method\nlet v1 = createVector(1, 0, 0);\nlet v2 = createVector(0, 1, 0);\n\nlet distance = p5.Vector.dist(v1, v2);\n// distance is 1.4142...\nprint(distance);\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 0);\n\n let v1 = createVector(70, 50);\n drawArrow(v0, v1, 'red');\n\n let v2 = createVector(mouseX, mouseY);\n drawArrow(v0, v2, 'blue');\n\n noStroke();\n text('distance between vectors: ' + v2.dist(v1).toFixed(2), 5, 50, 95, 50);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 759, + "params": [ + { + "name": "v", + "description": "

    the x, y, and z coordinates of a p5.Vector

    \n", + "type": "p5.Vector" + } + ], + "return": { + "description": "the distance", + "type": "Number" + } + }, + { + "line": 1697, + "params": [ + { + "name": "v1", + "description": "

    the first p5.Vector

    \n", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "

    the second p5.Vector

    \n", + "type": "p5.Vector" + } + ], + "static": 1, + "return": { + "description": "the distance", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 830, + "description": "

    Normalize the vector to length 1 (make it a unit vector).

    \n", + "itemtype": "method", + "name": "normalize", + "return": { + "description": "normalized p5.Vector", + "type": "p5.Vector" + }, + "example": [ + "\n
    \n\nlet v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.normalize();\n// v's components are set to\n// [0.4454354, 0.8908708, 0.089087084]\n\n
    \n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(50, 50);\n let v1 = createVector(mouseX - 50, mouseY - 50);\n\n drawArrow(v0, v1, 'red');\n v1.normalize();\n drawArrow(v0, v1.mult(35), 'blue');\n\n noFill();\n ellipse(50, 50, 35 * 2);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 886, + "description": "

    Limit the magnitude of this vector to the value used for the max\nparameter.

    \n", + "itemtype": "method", + "name": "limit", + "params": [ + { + "name": "max", + "description": "

    the maximum magnitude for the vector

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.limit(5);\n// v's components are set to\n// [2.2271771, 4.4543543, 0.4454354]\n\n
    \n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(50, 50);\n let v1 = createVector(mouseX - 50, mouseY - 50);\n\n drawArrow(v0, v1, 'red');\n drawArrow(v0, v1.limit(35), 'blue');\n\n noFill();\n ellipse(50, 50, 35 * 2);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 944, + "description": "

    Set the magnitude of this vector to the value used for the len\nparameter.

    \n", + "itemtype": "method", + "name": "setMag", + "params": [ + { + "name": "len", + "description": "

    the new length for this vector

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(10, 20, 2);\n// v has components [10.0, 20.0, 2.0]\nv.setMag(10);\n// v's components are set to [6.0, 8.0, 0.0]\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(0, 0);\n let v1 = createVector(50, 50);\n\n drawArrow(v0, v1, 'red');\n\n let length = map(mouseX, 0, width, 0, 141, true);\n v1.setMag(length);\n drawArrow(v0, v1, 'blue');\n\n noStroke();\n text('magnitude set to: ' + length.toFixed(2), 10, 70, 90, 30);\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1000, + "description": "

    Calculate the angle of rotation for this vector (only 2D vectors)

    \n", + "itemtype": "method", + "name": "heading", + "return": { + "description": "the angle of rotation", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let v1 = createVector(30, 50);\n print(v1.heading()); // 1.0303768265243125\n\n v1 = createVector(40, 50);\n print(v1.heading()); // 0.8960553845713439\n\n v1 = createVector(30, 70);\n print(v1.heading()); // 1.1659045405098132\n}\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n\n let v0 = createVector(50, 50);\n let v1 = createVector(mouseX - 50, mouseY - 50);\n\n drawArrow(v0, v1, 'black');\n\n let myHeading = v1.heading();\n noStroke();\n text(\n 'vector heading: ' +\n myHeading.toFixed(2) +\n ' radians or ' +\n degrees(myHeading).toFixed(2) +\n ' degrees',\n 10,\n 50,\n 90,\n 50\n );\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1069, + "description": "

    Rotate the vector by an angle (only 2D vectors), magnitude remains the\nsame

    \n", + "itemtype": "method", + "name": "rotate", + "params": [ + { + "name": "angle", + "description": "

    the angle of rotation

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(10.0, 20.0);\n// v has components [10.0, 20.0, 0.0]\nv.rotate(HALF_PI);\n// v's components are set to [-20.0, 9.999999, 0.0]\n\n
    \n\n
    \n\nlet angle = 0;\nfunction draw() {\n background(240);\n\n let v0 = createVector(50, 50);\n let v1 = createVector(50, 0);\n\n drawArrow(v0, v1.rotate(angle), 'black');\n angle += 0.01;\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1125, + "description": "

    Calculates and returns the angle (in radians) between two vectors.

    \n", + "itemtype": "method", + "name": "angleBetween", + "params": [ + { + "name": "the", + "description": "

    x, y, and z components of a p5.Vector

    \n", + "type": "p5.Vector" + } + ], + "return": { + "description": "the angle between (in radians)", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet v1 = createVector(1, 0, 0);\nlet v2 = createVector(0, 1, 0);\n\nlet angle = v1.angleBetween(v2);\n// angle is PI/2\nprint(angle);\n\n
    \n\n
    \n\nfunction draw() {\n background(240);\n let v0 = createVector(50, 50);\n\n let v1 = createVector(50, 0);\n drawArrow(v0, v1, 'red');\n\n let v2 = createVector(mouseX - 50, mouseY - 50);\n drawArrow(v0, v2, 'blue');\n\n let angleBetween = v1.angleBetween(v2);\n noStroke();\n text(\n 'angle between: ' +\n angleBetween.toFixed(2) +\n ' radians or ' +\n degrees(angleBetween).toFixed(2) +\n ' degrees',\n 10,\n 50,\n 90,\n 50\n );\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1198, + "description": "

    Linear interpolate the vector to another vector

    \n", + "itemtype": "method", + "name": "lerp", + "chainable": 1, + "example": [ + "\n
    \n\nlet v = createVector(1, 1, 0);\n\nv.lerp(3, 3, 0, 0.5); // v now has components [2,2,0]\n\n
    \n\n
    \n\nlet v1 = createVector(0, 0, 0);\nlet v2 = createVector(100, 100, 0);\n\nlet v3 = p5.Vector.lerp(v1, v2, 0.5);\n// v3 has components [50,50,0]\nprint(v3);\n\n
    \n\n
    \n\nlet step = 0.01;\nlet amount = 0;\n\nfunction draw() {\n background(240);\n let v0 = createVector(0, 0);\n\n let v1 = createVector(mouseX, mouseY);\n drawArrow(v0, v1, 'red');\n\n let v2 = createVector(90, 90);\n drawArrow(v0, v2, 'blue');\n\n if (amount > 1 || amount < 0) {\n step *= -1;\n }\n amount += step;\n let v3 = p5.Vector.lerp(v1, v2, amount);\n\n drawArrow(v0, v3, 'purple');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 1198, + "params": [ + { + "name": "x", + "description": "

    the x component

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    the y component

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    the z component

    \n", + "type": "Number" + }, + { + "name": "amt", + "description": "

    the amount of interpolation; some value between 0.0\n (old vector) and 1.0 (new vector). 0.9 is very near\n the new vector. 0.5 is halfway in between.

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 1271, + "params": [ + { + "name": "v", + "description": "

    the p5.Vector to lerp to

    \n", + "type": "p5.Vector" + }, + { + "name": "amt", + "description": "", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 1712, + "params": [ + { + "name": "v1", + "description": "", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "", + "type": "p5.Vector" + }, + { + "name": "amt", + "description": "", + "type": "Number" + }, + { + "name": "target", + "description": "

    if undefined a new vector will be created

    \n", + "type": "p5.Vector" + } + ], + "static": 1 + }, + { + "line": 1720, + "params": [ + { + "name": "v1", + "description": "", + "type": "p5.Vector" + }, + { + "name": "v2", + "description": "", + "type": "p5.Vector" + }, + { + "name": "amt", + "description": "", + "type": "Number" + } + ], + "static": 1, + "return": { + "description": "the lerped value", + "type": "Number" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 1287, + "description": "

    Return a representation of this vector as a float array. This is only\nfor temporary use. If used in any other fashion, the contents should be\ncopied by using the p5.Vector.copy() method to copy into your own\narray.

    \n", + "itemtype": "method", + "name": "array", + "return": { + "description": "an Array with the 3 values", + "type": "Number[]" + }, + "example": [ + "\n
    \n\nfunction setup() {\n let v = createVector(20, 30);\n print(v.array()); // Prints : Array [20, 30, 0]\n}\n\n
    \n\n
    \n\nlet v = createVector(10.0, 20.0, 30.0);\nlet f = v.array();\nprint(f[0]); // Prints \"10.0\"\nprint(f[1]); // Prints \"20.0\"\nprint(f[2]); // Prints \"30.0\"\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1319, + "description": "

    Equality check against a p5.Vector

    \n", + "itemtype": "method", + "name": "equals", + "return": { + "description": "whether the vectors are equals", + "type": "Boolean" + }, + "example": [ + "\n
    \n\nlet v1 = createVector(5, 10, 20);\nlet v2 = createVector(5, 10, 20);\nlet v3 = createVector(13, 10, 19);\n\nprint(v1.equals(v2.x, v2.y, v2.z)); // true\nprint(v1.equals(v3.x, v3.y, v3.z)); // false\n\n
    \n\n
    \n\nlet v1 = createVector(10.0, 20.0, 30.0);\nlet v2 = createVector(10.0, 20.0, 30.0);\nlet v3 = createVector(0.0, 0.0, 0.0);\nprint(v1.equals(v2)); // true\nprint(v1.equals(v3)); // false\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math", + "overloads": [ + { + "line": 1319, + "params": [ + { + "name": "x", + "description": "

    the x component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    the y component of the vector

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    the z component of the vector

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "whether the vectors are equals", + "type": "Boolean" + } + }, + { + "line": 1349, + "params": [ + { + "name": "value", + "description": "

    the vector to compare

    \n", + "type": "p5.Vector|Array" + } + ], + "return": { + "description": "", + "type": "Boolean" + } + } + ] + }, + { + "file": "src/math/p5.Vector.js", + "line": 1374, + "description": "

    Make a new 2D vector from an angle

    \n", + "itemtype": "method", + "name": "fromAngle", + "static": 1, + "params": [ + { + "name": "angle", + "description": "

    the desired angle, in radians

    \n", + "type": "Number" + }, + { + "name": "length", + "description": "

    the length of the new vector (defaults to 1)

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "the new p5.Vector object", + "type": "p5.Vector" + }, + "example": [ + "\n
    \n\nfunction draw() {\n background(200);\n\n // Create a variable, proportional to the mouseX,\n // varying from 0-360, to represent an angle in degrees.\n angleMode(DEGREES);\n let myDegrees = map(mouseX, 0, width, 0, 360);\n\n // Display that variable in an onscreen text.\n // (Note the nfc() function to truncate additional decimal places,\n // and the \"\\xB0\" character for the degree symbol.)\n let readout = 'angle = ' + nfc(myDegrees, 1) + '\\xB0';\n noStroke();\n fill(0);\n text(readout, 5, 15);\n\n // Create a p5.Vector using the fromAngle function,\n // and extract its x and y components.\n let v = p5.Vector.fromAngle(radians(myDegrees), 30);\n let vx = v.x;\n let vy = v.y;\n\n push();\n translate(width / 2, height / 2);\n noFill();\n stroke(150);\n line(0, 0, 30, 0);\n stroke(0);\n line(0, 0, vx, vy);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1426, + "description": "

    Make a new 3D vector from a pair of ISO spherical angles

    \n", + "itemtype": "method", + "name": "fromAngles", + "static": 1, + "params": [ + { + "name": "theta", + "description": "

    the polar angle, in radians (zero is up)

    \n", + "type": "Number" + }, + { + "name": "phi", + "description": "

    the azimuthal angle, in radians\n (zero is out of the screen)

    \n", + "type": "Number" + }, + { + "name": "length", + "description": "

    the length of the new vector (defaults to 1)

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "the new p5.Vector object", + "type": "p5.Vector" + }, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n fill(255);\n noStroke();\n}\nfunction draw() {\n background(255);\n\n let t = millis() / 1000;\n\n // add three point lights\n pointLight(color('#f00'), p5.Vector.fromAngles(t * 1.0, t * 1.3, 100));\n pointLight(color('#0f0'), p5.Vector.fromAngles(t * 1.1, t * 1.2, 100));\n pointLight(color('#00f'), p5.Vector.fromAngles(t * 1.2, t * 1.1, 100));\n\n sphere(35);\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1475, + "description": "

    Make a new 2D unit vector from a random angle

    \n", + "itemtype": "method", + "name": "random2D", + "static": 1, + "return": { + "description": "the new p5.Vector object", + "type": "p5.Vector" + }, + "example": [ + "\n
    \n\nlet v = p5.Vector.random2D();\n// May make v's attributes something like:\n// [0.61554617, -0.51195765, 0.0] or\n// [-0.4695841, -0.14366731, 0.0] or\n// [0.6091097, -0.22805278, 0.0]\nprint(v);\n\n
    \n\n
    \n\nfunction setup() {\n frameRate(1);\n}\n\nfunction draw() {\n background(240);\n\n let v0 = createVector(50, 50);\n let v1 = p5.Vector.random2D();\n drawArrow(v0, v1.mult(50), 'black');\n}\n\n// draw an arrow for a vector at a given base position\nfunction drawArrow(base, vec, myColor) {\n push();\n stroke(myColor);\n strokeWeight(3);\n fill(myColor);\n translate(base.x, base.y);\n line(0, 0, vec.x, vec.y);\n rotate(vec.heading());\n let arrowSize = 7;\n translate(vec.mag() - arrowSize, 0);\n triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0);\n pop();\n}\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1528, + "description": "

    Make a new random 3D unit vector.

    \n", + "itemtype": "method", + "name": "random3D", + "static": 1, + "return": { + "description": "the new p5.Vector object", + "type": "p5.Vector" + }, + "example": [ + "\n
    \n\nlet v = p5.Vector.random3D();\n// May make v's attributes something like:\n// [0.61554617, -0.51195765, 0.599168] or\n// [-0.4695841, -0.14366731, -0.8711202] or\n// [0.6091097, -0.22805278, -0.7595902]\nprint(v);\n\n
    " + ], + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1611, + "description": "

    Multiplies a vector by a scalar and returns a new vector.

    \n", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1638, + "description": "

    Divides a vector by a scalar and returns a new vector.

    \n", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1665, + "description": "

    Calculates the dot product of two vectors.

    \n", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1679, + "description": "

    Calculates the cross product of two vectors.

    \n", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1693, + "description": "

    Calculates the Euclidean distance between two points (considering a\npoint as a vector object).

    \n", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/p5.Vector.js", + "line": 1708, + "description": "

    Linear interpolate a vector to another vector and return the result as a\nnew vector.

    \n", + "class": "p5.Vector", + "module": "Math", + "submodule": "Math" + }, + { + "file": "src/math/random.js", + "line": 48, + "description": "

    Sets the seed value for random().

    \n

    By default, random() produces different results each time the program\nis run. Set the seed parameter to a constant to return the same\npseudo-random numbers each time the software is run.

    \n", + "itemtype": "method", + "name": "randomSeed", + "params": [ + { + "name": "seed", + "description": "

    the seed value

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nrandomSeed(99);\nfor (let i = 0; i < 100; i++) {\n let r = random(0, 255);\n stroke(r);\n line(i, 0, i, 100);\n}\n\n
    " + ], + "alt": "many vertical lines drawn in white, black or grey.", + "class": "p5", + "module": "Math", + "submodule": "Random" + }, + { + "file": "src/math/random.js", + "line": 79, + "description": "

    Return a random floating-point number.

    \n

    Takes either 0, 1 or 2 arguments.

    \n

    If no argument is given, returns a random number from 0\nup to (but not including) 1.

    \n

    If one argument is given and it is a number, returns a random number from 0\nup to (but not including) the number.

    \n

    If one argument is given and it is an array, returns a random element from\nthat array.

    \n

    If two arguments are given, returns a random number from the\nfirst argument up to (but not including) the second argument.

    \n", + "itemtype": "method", + "name": "random", + "return": { + "description": "the random number", + "type": "Number" + }, + "example": [ + "\n
    \n\nfor (let i = 0; i < 100; i++) {\n let r = random(50);\n stroke(r * 5);\n line(50, i, 50 + r, i);\n}\n\n
    \n
    \n\nfor (let i = 0; i < 100; i++) {\n let r = random(-50, 50);\n line(50, i, 50 + r, i);\n}\n\n
    \n
    \n\n// Get a random element from an array using the random(Array) syntax\nlet words = ['apple', 'bear', 'cat', 'dog'];\nlet word = random(words); // select random word\ntext(word, 10, 50); // draw the word\n\n
    " + ], + "alt": "100 horizontal lines from center canvas to right. size+fill change each time\n100 horizontal lines from center of canvas. height & side change each render\nword displayed at random. Either apple, bear, cat, or dog", + "class": "p5", + "module": "Math", + "submodule": "Random", + "overloads": [ + { + "line": 79, + "params": [ + { + "name": "min", + "description": "

    the lower bound (inclusive)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "max", + "description": "

    the upper bound (exclusive)

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "the random number", + "type": "Number" + } + }, + { + "line": 133, + "params": [ + { + "name": "choices", + "description": "

    the array to choose from

    \n", + "type": "Array" + } + ], + "return": { + "description": "the random element from the array", + "type": "*" + } + } + ] + }, + { + "file": "src/math/random.js", + "line": 166, + "description": "

    Returns a random number fitting a Gaussian, or\n normal, distribution. There is theoretically no minimum or maximum\n value that randomGaussian() might return. Rather, there is\n just a very low probability that values far from the mean will be\n returned; and a higher probability that numbers near the mean will\n be returned.\n

    \n Takes either 0, 1 or 2 arguments.
    \n If no args, returns a mean of 0 and standard deviation of 1.
    \n If one arg, that arg is the mean (standard deviation is 1).
    \n If two args, first is mean, second is standard deviation.

    \n", + "itemtype": "method", + "name": "randomGaussian", + "params": [ + { + "name": "mean", + "description": "

    the mean

    \n", + "type": "Number" + }, + { + "name": "sd", + "description": "

    the standard deviation

    \n", + "type": "Number" + } + ], + "return": { + "description": "the random number", + "type": "Number" + }, + "example": [ + "\n
    \n \n for (let y = 0; y < 100; y++) {\n let x = randomGaussian(50, 15);\n line(50, y, x, y);\n }\n \n
    \n
    \n \n let distribution = new Array(360);\nfunction setup() {\n createCanvas(100, 100);\n for (let i = 0; i < distribution.length; i++) {\n distribution[i] = floor(randomGaussian(0, 15));\n }\n }\nfunction draw() {\n background(204);\n translate(width / 2, width / 2);\n for (let i = 0; i < distribution.length; i++) {\n rotate(TWO_PI / distribution.length);\n stroke(0);\n let dist = abs(distribution[i]);\n line(0, 0, dist, 0);\n }\n }\n \n
    " + ], + "alt": "100 horizontal lines from center of canvas. height & side change each render\n black lines radiate from center of canvas. size determined each render", + "class": "p5", + "module": "Math", + "submodule": "Random" + }, + { + "file": "src/math/trigonometry.js", + "line": 20, + "description": "

    The inverse of cos(), returns the arc cosine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned in\nthe range 0 to PI (3.1415927).

    \n", + "itemtype": "method", + "name": "acos", + "params": [ + { + "name": "value", + "description": "

    the value whose arc cosine is to be returned

    \n", + "type": "Number" + } + ], + "return": { + "description": "the arc cosine of the given value", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet a = PI;\nlet c = cos(a);\nlet ac = acos(c);\n// Prints: \"3.1415927 : -1.0 : 3.1415927\"\nprint(a + ' : ' + c + ' : ' + ac);\n\n
    \n\n
    \n\nlet a = PI + PI / 4.0;\nlet c = cos(a);\nlet ac = acos(c);\n// Prints: \"3.926991 : -0.70710665 : 2.3561943\"\nprint(a + ' : ' + c + ' : ' + ac);\n\n
    " + ], + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 54, + "description": "

    The inverse of sin(), returns the arc sine of a value. This function\nexpects the values in the range of -1 to 1 and values are returned\nin the range -PI/2 to PI/2.

    \n", + "itemtype": "method", + "name": "asin", + "params": [ + { + "name": "value", + "description": "

    the value whose arc sine is to be returned

    \n", + "type": "Number" + } + ], + "return": { + "description": "the arc sine of the given value", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet a = PI + PI / 3;\nlet s = sin(a);\nlet as = asin(s);\n// Prints: \"1.0471976 : 0.86602545 : 1.0471976\"\nprint(a + ' : ' + s + ' : ' + as);\n\n
    \n\n
    \n\nlet a = PI + PI / 3.0;\nlet s = sin(a);\nlet as = asin(s);\n// Prints: \"4.1887903 : -0.86602545 : -1.0471976\"\nprint(a + ' : ' + s + ' : ' + as);\n\n
    \n" + ], + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 89, + "description": "

    The inverse of tan(), returns the arc tangent of a value. This function\nexpects the values in the range of -Infinity to Infinity (exclusive) and\nvalues are returned in the range -PI/2 to PI/2.

    \n", + "itemtype": "method", + "name": "atan", + "params": [ + { + "name": "value", + "description": "

    the value whose arc tangent is to be returned

    \n", + "type": "Number" + } + ], + "return": { + "description": "the arc tangent of the given value", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet a = PI + PI / 3;\nlet t = tan(a);\nlet at = atan(t);\n// Prints: \"1.0471976 : 1.7320509 : 1.0471976\"\nprint(a + ' : ' + t + ' : ' + at);\n\n
    \n\n
    \n\nlet a = PI + PI / 3.0;\nlet t = tan(a);\nlet at = atan(t);\n// Prints: \"4.1887903 : 1.7320513 : 1.0471977\"\nprint(a + ' : ' + t + ' : ' + at);\n\n
    \n" + ], + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 124, + "description": "

    Calculates the angle (in radians) from a specified point to the coordinate\norigin as measured from the positive x-axis. Values are returned as a\nfloat in the range from PI to -PI. The atan2() function is most often used\nfor orienting geometry to the position of the cursor.\n

    \nNote: The y-coordinate of the point is the first parameter, and the\nx-coordinate is the second parameter, due the the structure of calculating\nthe tangent.

    \n", + "itemtype": "method", + "name": "atan2", + "params": [ + { + "name": "y", + "description": "

    y-coordinate of the point

    \n", + "type": "Number" + }, + { + "name": "x", + "description": "

    x-coordinate of the point

    \n", + "type": "Number" + } + ], + "return": { + "description": "the arc tangent of the given point", + "type": "Number" + }, + "example": [ + "\n
    \n\nfunction draw() {\n background(204);\n translate(width / 2, height / 2);\n let a = atan2(mouseY - height / 2, mouseX - width / 2);\n rotate(a);\n rect(-30, -5, 60, 10);\n}\n\n
    " + ], + "alt": "60 by 10 rect at center of canvas rotates with mouse movements", + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 160, + "description": "

    Calculates the cosine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.

    \n", + "itemtype": "method", + "name": "cos", + "params": [ + { + "name": "angle", + "description": "

    the angle

    \n", + "type": "Number" + } + ], + "return": { + "description": "the cosine of the angle", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet a = 0.0;\nlet inc = TWO_PI / 25.0;\nfor (let i = 0; i < 25; i++) {\n line(i * 4, 50, i * 4, 50 + cos(a) * 40.0);\n a = a + inc;\n}\n\n
    " + ], + "alt": "vertical black lines form wave patterns, extend-down on left and right side", + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 188, + "description": "

    Calculates the sine of an angle. This function takes into account the\ncurrent angleMode. Values are returned in the range -1 to 1.

    \n", + "itemtype": "method", + "name": "sin", + "params": [ + { + "name": "angle", + "description": "

    the angle

    \n", + "type": "Number" + } + ], + "return": { + "description": "the sine of the angle", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet a = 0.0;\nlet inc = TWO_PI / 25.0;\nfor (let i = 0; i < 25; i++) {\n line(i * 4, 50, i * 4, 50 + sin(a) * 40.0);\n a = a + inc;\n}\n\n
    " + ], + "alt": "vertical black lines extend down and up from center to form wave pattern", + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 216, + "description": "

    Calculates the tangent of an angle. This function takes into account\nthe current angleMode. Values are returned in the range -1 to 1.

    \n", + "itemtype": "method", + "name": "tan", + "params": [ + { + "name": "angle", + "description": "

    the angle

    \n", + "type": "Number" + } + ], + "return": { + "description": "the tangent of the angle", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet a = 0.0;\nlet inc = TWO_PI / 50.0;\nfor (let i = 0; i < 100; i = i + 2) {\n line(i, 50, i, 50 + tan(a) * 2.0);\n a = a + inc;\n}\n" + ], + "alt": "vertical black lines end down and up from center to form spike pattern", + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 244, + "description": "

    Converts a radian measurement to its corresponding value in degrees.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964. This function does not take into account the\ncurrent angleMode.

    \n", + "itemtype": "method", + "name": "degrees", + "params": [ + { + "name": "radians", + "description": "

    the radians value to convert to degrees

    \n", + "type": "Number" + } + ], + "return": { + "description": "the converted angle", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet rad = PI / 4;\nlet deg = degrees(rad);\nprint(rad + ' radians is ' + deg + ' degrees');\n// Prints: 0.7853981633974483 radians is 45 degrees\n\n
    \n" + ], + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 271, + "description": "

    Converts a degree measurement to its corresponding value in radians.\nRadians and degrees are two ways of measuring the same thing. There are\n360 degrees in a circle and 2*PI radians in a circle. For example,\n90° = PI/2 = 1.5707964. This function does not take into account the\ncurrent angleMode.

    \n", + "itemtype": "method", + "name": "radians", + "params": [ + { + "name": "degrees", + "description": "

    the degree value to convert to radians

    \n", + "type": "Number" + } + ], + "return": { + "description": "the converted angle", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet deg = 45.0;\nlet rad = radians(deg);\nprint(deg + ' degrees is ' + rad + ' radians');\n// Prints: 45 degrees is 0.7853981633974483 radians\n\n
    " + ], + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/math/trigonometry.js", + "line": 296, + "description": "

    Sets the current mode of p5 to given mode. Default mode is RADIANS.

    \n", + "itemtype": "method", + "name": "angleMode", + "params": [ + { + "name": "mode", + "description": "

    either RADIANS or DEGREES

    \n", + "type": "Constant" + } + ], + "example": [ + "\n
    \n\nfunction draw() {\n background(204);\n angleMode(DEGREES); // Change the mode to DEGREES\n let a = atan2(mouseY - height / 2, mouseX - width / 2);\n translate(width / 2, height / 2);\n push();\n rotate(a);\n rect(-20, -5, 40, 10); // Larger rectangle is rotating in degrees\n pop();\n angleMode(RADIANS); // Change the mode to RADIANS\n rotate(a); // variable a stays the same\n rect(-40, -5, 20, 10); // Smaller rectangle is rotating in radians\n}\n\n
    " + ], + "alt": "40 by 10 rect in center rotates with mouse moves. 20 by 10 rect moves faster.", + "class": "p5", + "module": "Math", + "submodule": "Trigonometry" + }, + { + "file": "src/typography/attributes.js", + "line": 13, + "description": "

    Sets the current alignment for drawing text. Accepts two\narguments: horizAlign (LEFT, CENTER, or RIGHT) and\nvertAlign (TOP, BOTTOM, CENTER, or BASELINE).

    \n

    The horizAlign parameter is in reference to the x value\nof the text() function, while the vertAlign parameter is\nin reference to the y value.

    \n

    So if you write textAlign(LEFT), you are aligning the left\nedge of your text to the x value you give in text(). If you\nwrite textAlign(RIGHT, TOP), you are aligning the right edge\nof your text to the x value and the top of edge of the text\nto the y value.

    \n", + "itemtype": "method", + "name": "textAlign", + "chainable": 1, + "example": [ + "\n
    \n\ntextSize(16);\ntextAlign(RIGHT);\ntext('ABCD', 50, 30);\ntextAlign(CENTER);\ntext('EFGH', 50, 50);\ntextAlign(LEFT);\ntext('IJKL', 50, 70);\n\n
    \n\n
    \n\ntextSize(16);\nstrokeWeight(0.5);\n\nline(0, 12, width, 12);\ntextAlign(CENTER, TOP);\ntext('TOP', 0, 12, width);\n\nline(0, 37, width, 37);\ntextAlign(CENTER, CENTER);\ntext('CENTER', 0, 37, width);\n\nline(0, 62, width, 62);\ntextAlign(CENTER, BASELINE);\ntext('BASELINE', 0, 62, width);\n\nline(0, 87, width, 87);\ntextAlign(CENTER, BOTTOM);\ntext('BOTTOM', 0, 87, width);\n\n
    " + ], + "alt": "Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left.\nThe names of the four vertical alignments rendered each showing that alignment's placement relative to a horizontal line.", + "class": "p5", + "module": "Typography", + "submodule": "Attributes", + "overloads": [ + { + "line": 13, + "params": [ + { + "name": "horizAlign", + "description": "

    horizontal alignment, either LEFT,\n CENTER, or RIGHT

    \n", + "type": "Constant" + }, + { + "name": "vertAlign", + "description": "

    vertical alignment, either TOP,\n BOTTOM, CENTER, or BASELINE

    \n", + "type": "Constant", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 75, + "params": [], + "return": { + "description": "", + "type": "Object" + } + } + ] + }, + { + "file": "src/typography/attributes.js", + "line": 84, + "description": "

    Sets/gets the spacing, in pixels, between lines of text. This\nsetting will be used in all subsequent calls to the text() function.

    \n", + "itemtype": "method", + "name": "textLeading", + "chainable": 1, + "example": [ + "\n
    \n\n// Text to display. The \"\\n\" is a \"new line\" character\nlet lines = 'L1\\nL2\\nL3';\ntextSize(12);\n\ntextLeading(10); // Set leading to 10\ntext(lines, 10, 25);\n\ntextLeading(20); // Set leading to 20\ntext(lines, 40, 25);\n\ntextLeading(30); // Set leading to 30\ntext(lines, 70, 25);\n\n
    " + ], + "alt": "set L1 L2 & L3 displayed vertically 3 times. spacing increases for each set", + "class": "p5", + "module": "Typography", + "submodule": "Attributes", + "overloads": [ + { + "line": 84, + "params": [ + { + "name": "leading", + "description": "

    the size in pixels for spacing between lines

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 113, + "params": [], + "return": { + "description": "", + "type": "Number" + } + } + ] + }, + { + "file": "src/typography/attributes.js", + "line": 122, + "description": "

    Sets/gets the current font size. This size will be used in all subsequent\ncalls to the text() function. Font size is measured in pixels.

    \n", + "itemtype": "method", + "name": "textSize", + "chainable": 1, + "example": [ + "\n
    \n\ntextSize(12);\ntext('Font Size 12', 10, 30);\ntextSize(14);\ntext('Font Size 14', 10, 60);\ntextSize(16);\ntext('Font Size 16', 10, 90);\n\n
    " + ], + "alt": "Font Size 12 displayed small, Font Size 14 medium & Font Size 16 large", + "class": "p5", + "module": "Typography", + "submodule": "Attributes", + "overloads": [ + { + "line": 122, + "params": [ + { + "name": "theSize", + "description": "

    the size of the letters in units of pixels

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 145, + "params": [], + "return": { + "description": "", + "type": "Number" + } + } + ] + }, + { + "file": "src/typography/attributes.js", + "line": 154, + "description": "

    Sets/gets the style of the text for system fonts to NORMAL, ITALIC, BOLD or BOLDITALIC.\nNote: this may be is overridden by CSS styling. For non-system fonts\n(opentype, truetype, etc.) please load styled fonts instead.

    \n", + "itemtype": "method", + "name": "textStyle", + "chainable": 1, + "example": [ + "\n
    \n\nstrokeWeight(0);\ntextSize(12);\ntextStyle(NORMAL);\ntext('Font Style Normal', 10, 15);\ntextStyle(ITALIC);\ntext('Font Style Italic', 10, 40);\ntextStyle(BOLD);\ntext('Font Style Bold', 10, 65);\ntextStyle(BOLDITALIC);\ntext('Font Style Bold Italic', 10, 90);\n\n
    " + ], + "alt": "words Font Style Normal displayed normally, Italic in italic, bold in bold and bold italic in bold italics.", + "class": "p5", + "module": "Typography", + "submodule": "Attributes", + "overloads": [ + { + "line": 154, + "params": [ + { + "name": "theStyle", + "description": "

    styling for text, either NORMAL,\n ITALIC, BOLD or BOLDITALIC

    \n", + "type": "Constant" + } + ], + "chainable": 1 + }, + { + "line": 182, + "params": [], + "return": { + "description": "", + "type": "String" + } + } + ] + }, + { + "file": "src/typography/attributes.js", + "line": 191, + "description": "

    Calculates and returns the width of any character or text string.

    \n", + "itemtype": "method", + "name": "textWidth", + "params": [ + { + "name": "theText", + "description": "

    the String of characters to measure

    \n", + "type": "String" + } + ], + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\ntextSize(28);\n\nlet aChar = 'P';\nlet cWidth = textWidth(aChar);\ntext(aChar, 0, 40);\nline(cWidth, 0, cWidth, 50);\n\nlet aString = 'p5.js';\nlet sWidth = textWidth(aString);\ntext(aString, 0, 85);\nline(sWidth, 50, sWidth, 100);\n\n
    " + ], + "alt": "Letter P and p5.js are displayed with vertical lines at end. P is wide", + "class": "p5", + "module": "Typography", + "submodule": "Attributes" + }, + { + "file": "src/typography/attributes.js", + "line": 226, + "description": "

    Returns the ascent of the current font at its current size. The ascent\nrepresents the distance, in pixels, of the tallest character above\nthe baseline.

    \n", + "itemtype": "method", + "name": "textAscent", + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet base = height * 0.75;\nlet scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nlet asc = textAscent() * scalar; // Calc ascent\nline(0, base - asc, width, base - asc);\ntext('dp', 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\nasc = textAscent() * scalar; // Recalc ascent\nline(40, base - asc, width, base - asc);\ntext('dp', 40, base); // Draw text on baseline\n\n
    " + ], + "class": "p5", + "module": "Typography", + "submodule": "Attributes" + }, + { + "file": "src/typography/attributes.js", + "line": 255, + "description": "

    Returns the descent of the current font at its current size. The descent\nrepresents the distance, in pixels, of the character with the longest\ndescender below the baseline.

    \n", + "itemtype": "method", + "name": "textDescent", + "return": { + "description": "", + "type": "Number" + }, + "example": [ + "\n
    \n\nlet base = height * 0.75;\nlet scalar = 0.8; // Different for each font\n\ntextSize(32); // Set initial text size\nlet desc = textDescent() * scalar; // Calc ascent\nline(0, base + desc, width, base + desc);\ntext('dp', 0, base); // Draw text on baseline\n\ntextSize(64); // Increase text size\ndesc = textDescent() * scalar; // Recalc ascent\nline(40, base + desc, width, base + desc);\ntext('dp', 40, base); // Draw text on baseline\n\n
    " + ], + "class": "p5", + "module": "Typography", + "submodule": "Attributes" + }, + { + "file": "src/typography/attributes.js", + "line": 284, + "description": "

    Helper function to measure ascent and descent.

    \n", + "class": "p5", + "module": "Typography", + "submodule": "Attributes" + }, + { + "file": "src/typography/loading_displaying.js", + "line": 16, + "description": "

    Loads an opentype font file (.otf, .ttf) from a file or a URL,\nand returns a PFont Object. This method is asynchronous,\nmeaning it may not finish before the next line in your sketch\nis executed.\n

    \nThe path to the font should be relative to the HTML file\nthat links in your sketch. Loading fonts from a URL or other\nremote location may be blocked due to your browser's built-in\nsecurity.

    \n", + "itemtype": "method", + "name": "loadFont", + "params": [ + { + "name": "path", + "description": "

    name of the file or url to load

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function to be executed after\n loadFont() completes

    \n", + "type": "Function", + "optional": true + }, + { + "name": "onError", + "description": "

    function to be executed if\n an error occurs

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "p5.Font object", + "type": "p5.Font" + }, + "example": [ + "\n\n

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

    \n\n
    \nlet myFont;\nfunction preload() {\n myFont = loadFont('assets/inconsolata.otf');\n}\n\nfunction setup() {\n fill('#ED225D');\n textFont(myFont);\n textSize(36);\n text('p5*js', 10, 50);\n}\n
    \n\nOutside of preload(), you may supply a callback function to handle the\nobject:\n\n
    \nfunction setup() {\n loadFont('assets/inconsolata.otf', drawText);\n}\n\nfunction drawText(font) {\n fill('#ED225D');\n textFont(font, 36);\n text('p5*js', 10, 50);\n}\n
    \n\n

    You can also use the font filename string (without the file extension) to style other HTML\nelements.

    \n\n
    \nfunction preload() {\n loadFont('assets/inconsolata.otf');\n}\n\nfunction setup() {\n let myDiv = createDiv('hello there');\n myDiv.style('font-family', 'Inconsolata');\n}\n
    " + ], + "alt": "p5*js in p5's theme dark pink\np5*js in p5's theme dark pink", + "class": "p5", + "module": "Typography", + "submodule": "Loading & Displaying" + }, + { + "file": "src/typography/loading_displaying.js", + "line": 143, + "description": "

    Draws text to the screen. Displays the information specified in the first\nparameter on the screen in the position specified by the additional\nparameters. A default font will be used unless a font is set with the\ntextFont() function and a default size will be used unless a font is set\nwith textSize(). Change the color of the text with the fill() function.\nChange the outline of the text with the stroke() and strokeWeight()\nfunctions.\n

    \nThe text displays in relation to the textAlign() function, which gives the\noption to draw to the left, right, and center of the coordinates.\n

    \nThe x2 and y2 parameters define a rectangular area to display within and\nmay only be used with string data. When these parameters are specified,\nthey are interpreted based on the current rectMode() setting. Text that\ndoes not fit completely within the rectangle specified will not be drawn\nto the screen. If x2 and y2 are not specified, the baseline alignment is the\ndefault, which means that the text will be drawn upwards from x and y.\n

    \nWEBGL: Only opentype/truetype fonts are supported. You must load a font using the\nloadFont() method (see the example above).\nstroke() currently has no effect in webgl mode.

    \n", + "itemtype": "method", + "name": "text", + "params": [ + { + "name": "str", + "description": "

    the alphanumeric\n symbols to be displayed

    \n", + "type": "String|Object|Array|Number|Boolean" + }, + { + "name": "x", + "description": "

    x-coordinate of text

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-coordinate of text

    \n", + "type": "Number" + }, + { + "name": "x2", + "description": "

    by default, the width of the text box,\n see rectMode() for more info

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y2", + "description": "

    by default, the height of the text box,\n see rectMode() for more info

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\ntextSize(32);\ntext('word', 10, 30);\nfill(0, 102, 153);\ntext('word', 10, 60);\nfill(0, 102, 153, 51);\ntext('word', 10, 90);\n\n
    \n
    \n\nlet s = 'The quick brown fox jumped over the lazy dog.';\nfill(50);\ntext(s, 10, 10, 70, 80); // Text wraps within text box\n\n
    \n\n
    \n\nlet inconsolata;\nfunction preload() {\n inconsolata = loadFont('assets/inconsolata.otf');\n}\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n textFont(inconsolata);\n textSize(width / 3);\n textAlign(CENTER, CENTER);\n}\nfunction draw() {\n background(0);\n let time = millis();\n rotateX(time / 1000);\n rotateZ(time / 1234);\n text('p5.js', 0, 0);\n}\n\n
    " + ], + "alt": "'word' displayed 3 times going from black, blue to translucent blue\nThe quick brown fox jumped over the lazy dog.\nthe text 'p5.js' spinning in 3d", + "class": "p5", + "module": "Typography", + "submodule": "Loading & Displaying" + }, + { + "file": "src/typography/loading_displaying.js", + "line": 230, + "description": "

    Sets the current font that will be drawn with the text() function.\n

    \nWEBGL: Only fonts loaded via loadFont() are supported.

    \n", + "itemtype": "method", + "name": "textFont", + "return": { + "description": "the current font", + "type": "Object" + }, + "example": [ + "\n
    \n\nfill(0);\ntextSize(12);\ntextFont('Georgia');\ntext('Georgia', 12, 30);\ntextFont('Helvetica');\ntext('Helvetica', 12, 60);\n\n
    \n
    \n\nlet fontRegular, fontItalic, fontBold;\nfunction preload() {\n fontRegular = loadFont('assets/Regular.otf');\n fontItalic = loadFont('assets/Italic.ttf');\n fontBold = loadFont('assets/Bold.ttf');\n}\nfunction setup() {\n background(210);\n fill(0)\n .strokeWeight(0)\n .textSize(10);\n textFont(fontRegular);\n text('Font Style Normal', 10, 30);\n textFont(fontItalic);\n text('Font Style Italic', 10, 50);\n textFont(fontBold);\n text('Font Style Bold', 10, 70);\n}\n\n
    " + ], + "alt": "words Font Style Normal displayed normally, Italic in italic and bold in bold", + "class": "p5", + "module": "Typography", + "submodule": "Loading & Displaying", + "overloads": [ + { + "line": 230, + "params": [], + "return": { + "description": "the current font", + "type": "Object" + } + }, + { + "line": 275, + "params": [ + { + "name": "font", + "description": "

    a font loaded via loadFont(), or a String\nrepresenting a web safe font (a font\nthat is generally available across all systems)

    \n", + "type": "Object|String" + }, + { + "name": "size", + "description": "

    the font size to use

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/typography/p5.Font.js", + "line": 25, + "description": "

    Underlying opentype font implementation

    \n", + "itemtype": "property", + "name": "font", + "class": "p5.Font", + "module": "Typography", + "submodule": "Font" + }, + { + "file": "src/typography/p5.Font.js", + "line": 32, + "description": "

    Returns a tight bounding box for the given text string using this\nfont (currently only supports single lines)

    \n", + "itemtype": "method", + "name": "textBounds", + "params": [ + { + "name": "line", + "description": "

    a line of text

    \n", + "type": "String" + }, + { + "name": "x", + "description": "

    x-position

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-position

    \n", + "type": "Number" + }, + { + "name": "fontSize", + "description": "

    font size to use (optional) Default is 12.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "options", + "description": "

    opentype options (optional)\n opentype fonts contains alignment and baseline options.\n Default is 'LEFT' and 'alphabetic'

    \n", + "type": "Object", + "optional": true + } + ], + "return": { + "description": "a rectangle object with properties: x, y, w, h", + "type": "Object" + }, + "example": [ + "\n
    \n\nlet font;\nlet textString = 'Lorem ipsum dolor sit amet.';\nfunction preload() {\n font = loadFont('./assets/Regular.otf');\n}\nfunction setup() {\n background(210);\n\n let bbox = font.textBounds(textString, 10, 30, 12);\n fill(255);\n stroke(0);\n rect(bbox.x, bbox.y, bbox.w, bbox.h);\n fill(0);\n noStroke();\n\n textFont(font);\n textSize(12);\n text(textString, 10, 30);\n}\n\n
    " + ], + "alt": "words Lorem ipsum dol go off canvas and contained by white bounding box", + "class": "p5.Font", + "module": "Typography", + "submodule": "Font" + }, + { + "file": "src/typography/p5.Font.js", + "line": 156, + "description": "

    Computes an array of points following the path for specified text

    \n", + "itemtype": "method", + "name": "textToPoints", + "params": [ + { + "name": "txt", + "description": "

    a line of text

    \n", + "type": "String" + }, + { + "name": "x", + "description": "

    x-position

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y-position

    \n", + "type": "Number" + }, + { + "name": "fontSize", + "description": "

    font size to use (optional)

    \n", + "type": "Number" + }, + { + "name": "options", + "description": "

    an (optional) object that can contain:

    \n


    sampleFactor - the ratio of path-length to number of samples\n(default=.1); higher values yield more points and are therefore\nmore precise

    \n


    simplifyThreshold - if set to a non-zero value, collinear points will be\nbe removed from the polygon; the value represents the threshold angle to use\nwhen determining whether two edges are collinear

    \n", + "type": "Object", + "optional": true + } + ], + "return": { + "description": "an array of points, each with x, y, alpha (the path angle)", + "type": "Array" + }, + "example": [ + "\n
    \n\nlet font;\nfunction preload() {\n font = loadFont('assets/inconsolata.otf');\n}\n\nlet points;\nlet bounds;\nfunction setup() {\n createCanvas(100, 100);\n stroke(0);\n fill(255, 104, 204);\n\n points = font.textToPoints('p5', 0, 0, 10, {\n sampleFactor: 5,\n simplifyThreshold: 0\n });\n bounds = font.textBounds(' p5 ', 0, 0, 10);\n}\n\nfunction draw() {\n background(255);\n beginShape();\n translate(-bounds.x * width / bounds.w, -bounds.y * height / bounds.h);\n for (let i = 0; i < points.length; i++) {\n let p = points[i];\n vertex(\n p.x * width / bounds.w +\n sin(20 * p.y / bounds.h + millis() / 1000) * width / 30,\n p.y * height / bounds.h\n );\n }\n endShape(CLOSE);\n}\n\n
    \n" + ], + "class": "p5.Font", + "module": "Typography", + "submodule": "Font" + }, + { + "file": "src/utilities/array_functions.js", + "line": 12, + "description": "

    Adds a value to the end of an array. Extends the length of\nthe array by one. Maps to Array.push().

    \n", + "itemtype": "method", + "name": "append", + "deprecated": true, + "deprecationMessage": "Use array.push(value) instead.", + "params": [ + { + "name": "array", + "description": "

    Array to append

    \n", + "type": "Array" + }, + { + "name": "value", + "description": "

    to be added to the Array

    \n", + "type": "Any" + } + ], + "return": { + "description": "the array that was appended to", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var myArray = ['Mango', 'Apple', 'Papaya'];\n print(myArray); // ['Mango', 'Apple', 'Papaya']\n\n append(myArray, 'Peach');\n print(myArray); // ['Mango', 'Apple', 'Papaya', 'Peach']\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/array_functions.js", + "line": 37, + "description": "

    Copies an array (or part of an array) to another array. The src array is\ncopied to the dst array, beginning at the position specified by\nsrcPosition and into the position specified by dstPosition. The number of\nelements to copy is determined by length. Note that copying values\noverwrites existing values in the destination array. To append values\ninstead of overwriting them, use concat().\n

    \nThe simplified version with only two arguments, arrayCopy(src, dst),\ncopies an entire array to another of the same size. It is equivalent to\narrayCopy(src, 0, dst, 0, src.length).\n

    \nUsing this function is far more efficient for copying array data than\niterating through a for() loop and copying each element individually.

    \n", + "itemtype": "method", + "name": "arrayCopy", + "deprecated": true, + "example": [ + "\n
    \nvar src = ['A', 'B', 'C'];\nvar dst = [1, 2, 3];\nvar srcPosition = 1;\nvar dstPosition = 0;\nvar length = 2;\n\nprint(src); // ['A', 'B', 'C']\nprint(dst); // [ 1 , 2 , 3 ]\n\narrayCopy(src, srcPosition, dst, dstPosition, length);\nprint(dst); // ['B', 'C', 3]\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions", + "overloads": [ + { + "line": 37, + "params": [ + { + "name": "src", + "description": "

    the source Array

    \n", + "type": "Array" + }, + { + "name": "srcPosition", + "description": "

    starting position in the source Array

    \n", + "type": "Integer" + }, + { + "name": "dst", + "description": "

    the destination Array

    \n", + "type": "Array" + }, + { + "name": "dstPosition", + "description": "

    starting position in the destination Array

    \n", + "type": "Integer" + }, + { + "name": "length", + "description": "

    number of Array elements to be copied

    \n", + "type": "Integer" + } + ] + }, + { + "line": 75, + "params": [ + { + "name": "src", + "description": "", + "type": "Array" + }, + { + "name": "dst", + "description": "", + "type": "Array" + }, + { + "name": "length", + "description": "", + "type": "Integer", + "optional": true + } + ] + } + ] + }, + { + "file": "src/utilities/array_functions.js", + "line": 114, + "description": "

    Concatenates two arrays, maps to Array.concat(). Does not modify the\ninput arrays.

    \n", + "itemtype": "method", + "name": "concat", + "deprecated": true, + "deprecationMessage": "Use arr1.concat(arr2) instead.", + "params": [ + { + "name": "a", + "description": "

    first Array to concatenate

    \n", + "type": "Array" + }, + { + "name": "b", + "description": "

    second Array to concatenate

    \n", + "type": "Array" + } + ], + "return": { + "description": "concatenated array", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var arr1 = ['A', 'B', 'C'];\n var arr2 = [1, 2, 3];\n\n print(arr1); // ['A','B','C']\n print(arr2); // [1,2,3]\n\n var arr3 = concat(arr1, arr2);\n\n print(arr1); // ['A','B','C']\n print(arr2); // [1, 2, 3]\n print(arr3); // ['A','B','C', 1, 2, 3]\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/array_functions.js", + "line": 145, + "description": "

    Reverses the order of an array, maps to Array.reverse()

    \n", + "itemtype": "method", + "name": "reverse", + "deprecated": true, + "deprecationMessage": "Use array.reverse() instead.", + "params": [ + { + "name": "list", + "description": "

    Array to reverse

    \n", + "type": "Array" + } + ], + "return": { + "description": "the reversed list", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var myArray = ['A', 'B', 'C'];\n print(myArray); // ['A','B','C']\n\n reverse(myArray);\n print(myArray); // ['C','B','A']\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/array_functions.js", + "line": 167, + "description": "

    Decreases an array by one element and returns the shortened array,\nmaps to Array.pop().

    \n", + "itemtype": "method", + "name": "shorten", + "deprecated": true, + "deprecationMessage": "Use array.pop() instead.", + "params": [ + { + "name": "list", + "description": "

    Array to shorten

    \n", + "type": "Array" + } + ], + "return": { + "description": "shortened Array", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var myArray = ['A', 'B', 'C'];\n print(myArray); // ['A', 'B', 'C']\n var newArray = shorten(myArray);\n print(myArray); // ['A','B','C']\n print(newArray); // ['A','B']\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/array_functions.js", + "line": 191, + "description": "

    Randomizes the order of the elements of an array. Implements\n\nFisher-Yates Shuffle Algorithm.

    \n", + "itemtype": "method", + "name": "shuffle", + "params": [ + { + "name": "array", + "description": "

    Array to shuffle

    \n", + "type": "Array" + }, + { + "name": "bool", + "description": "

    modify passed array

    \n", + "type": "Boolean", + "optional": true + } + ], + "return": { + "description": "shuffled Array", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var regularArr = ['ABC', 'def', createVector(), TAU, Math.E];\n print(regularArr);\n shuffle(regularArr, true); // force modifications to passed array\n print(regularArr);\n\n // By default shuffle() returns a shuffled cloned array:\n var newArr = shuffle(regularArr);\n print(regularArr);\n print(newArr);\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/array_functions.js", + "line": 233, + "description": "

    Sorts an array of numbers from smallest to largest, or puts an array of\nwords in alphabetical order. The original array is not modified; a\nre-ordered array is returned. The count parameter states the number of\nelements to sort. For example, if there are 12 elements in an array and\ncount is set to 5, only the first 5 elements in the array will be sorted.

    \n", + "itemtype": "method", + "name": "sort", + "deprecated": true, + "deprecationMessage": "Use array.sort() instead.", + "params": [ + { + "name": "list", + "description": "

    Array to sort

    \n", + "type": "Array" + }, + { + "name": "count", + "description": "

    number of elements to sort, starting from 0

    \n", + "type": "Integer", + "optional": true + } + ], + "return": { + "description": "the sorted list", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var words = ['banana', 'apple', 'pear', 'lime'];\n print(words); // ['banana', 'apple', 'pear', 'lime']\n var count = 4; // length of array\n\n words = sort(words, count);\n print(words); // ['apple', 'banana', 'lime', 'pear']\n}\n
    \n
    \nfunction setup() {\n var numbers = [2, 6, 1, 5, 14, 9, 8, 12];\n print(numbers); // [2, 6, 1, 5, 14, 9, 8, 12]\n var count = 5; // Less than the length of the array\n\n numbers = sort(numbers, count);\n print(numbers); // [1,2,5,6,14,9,8,12]\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/array_functions.js", + "line": 281, + "description": "

    Inserts a value or an array of values into an existing array. The first\nparameter specifies the initial array to be modified, and the second\nparameter defines the data to be inserted. The third parameter is an index\nvalue which specifies the array position from which to insert data.\n(Remember that array index numbering starts at zero, so the first position\nis 0, the second position is 1, and so on.)

    \n", + "itemtype": "method", + "name": "splice", + "deprecated": true, + "deprecationMessage": "Use array.splice() instead.", + "params": [ + { + "name": "list", + "description": "

    Array to splice into

    \n", + "type": "Array" + }, + { + "name": "value", + "description": "

    value to be spliced in

    \n", + "type": "Any" + }, + { + "name": "position", + "description": "

    in the array from which to insert data

    \n", + "type": "Integer" + } + ], + "return": { + "description": "the list", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var myArray = [0, 1, 2, 3, 4];\n var insArray = ['A', 'B', 'C'];\n print(myArray); // [0, 1, 2, 3, 4]\n print(insArray); // ['A','B','C']\n\n splice(myArray, insArray, 3);\n print(myArray); // [0,1,2,'A','B','C',3,4]\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/array_functions.js", + "line": 316, + "description": "

    Extracts an array of elements from an existing array. The list parameter\ndefines the array from which the elements will be copied, and the start\nand count parameters specify which elements to extract. If no count is\ngiven, elements will be extracted from the start to the end of the array.\nWhen specifying the start, remember that the first array element is 0.\nThis function does not change the source array.

    \n", + "itemtype": "method", + "name": "subset", + "deprecated": true, + "deprecationMessage": "Use array.slice() instead.", + "params": [ + { + "name": "list", + "description": "

    Array to extract from

    \n", + "type": "Array" + }, + { + "name": "start", + "description": "

    position to begin

    \n", + "type": "Integer" + }, + { + "name": "count", + "description": "

    number of values to extract

    \n", + "type": "Integer", + "optional": true + } + ], + "return": { + "description": "Array of extracted elements", + "type": "Array" + }, + "example": [ + "\n
    \nfunction setup() {\n var myArray = [1, 2, 3, 4, 5];\n print(myArray); // [1, 2, 3, 4, 5]\n\n var sub1 = subset(myArray, 0, 3);\n var sub2 = subset(myArray, 2, 2);\n print(sub1); // [1,2,3]\n print(sub2); // [3,4]\n}\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Array Functions" + }, + { + "file": "src/utilities/conversion.js", + "line": 12, + "description": "

    Converts a string to its floating point representation. The contents of a\nstring must resemble a number, or NaN (not a number) will be returned.\nFor example, float("1234.56") evaluates to 1234.56, but float("giraffe")\nwill return NaN.

    \n

    When an array of values is passed in, then an array of floats of the same\nlength is returned.

    \n", + "itemtype": "method", + "name": "float", + "params": [ + { + "name": "str", + "description": "

    float string to parse

    \n", + "type": "String" + } + ], + "return": { + "description": "floating point representation of string", + "type": "Number" + }, + "example": [ + "\n
    \nvar str = '20';\nvar diameter = float(str);\nellipse(width / 2, height / 2, diameter, diameter);\n
    \n
    \nprint(float('10.31')); // 10.31\nprint(float('Infinity')); // Infinity\nprint(float('-Infinity')); // -Infinity\n
    " + ], + "alt": "20 by 20 white ellipse in the center of the canvas", + "class": "p5", + "module": "Data", + "submodule": "Conversion" + }, + { + "file": "src/utilities/conversion.js", + "line": 47, + "description": "

    Converts a boolean, string, or float to its integer representation.\nWhen an array of values is passed in, then an int array of the same length\nis returned.

    \n", + "itemtype": "method", + "name": "int", + "return": { + "description": "integer representation of value", + "type": "Number" + }, + "example": [ + "\n
    \nprint(int('10')); // 10\nprint(int(10.31)); // 10\nprint(int(-10)); // -10\nprint(int(true)); // 1\nprint(int(false)); // 0\nprint(int([false, true, '10.3', 9.8])); // [0, 1, 10, 9]\nprint(int(Infinity)); // Infinity\nprint(int('-Infinity')); // -Infinity\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion", + "overloads": [ + { + "line": 47, + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "String|Boolean|Number" + }, + { + "name": "radix", + "description": "

    the radix to convert to (default: 10)

    \n", + "type": "Integer", + "optional": true + } + ], + "return": { + "description": "integer representation of value", + "type": "Number" + } + }, + { + "line": 69, + "params": [ + { + "name": "ns", + "description": "

    values to parse

    \n", + "type": "Array" + } + ], + "return": { + "description": "integer representation of values", + "type": "Number[]" + } + } + ] + }, + { + "file": "src/utilities/conversion.js", + "line": 93, + "description": "

    Converts a boolean, string or number to its string representation.\nWhen an array of values is passed in, then an array of strings of the same\nlength is returned.

    \n", + "itemtype": "method", + "name": "str", + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "String|Boolean|Number|Array" + } + ], + "return": { + "description": "string representation of value", + "type": "String" + }, + "example": [ + "\n
    \nprint(str('10')); // \"10\"\nprint(str(10.31)); // \"10.31\"\nprint(str(-10)); // \"-10\"\nprint(str(true)); // \"true\"\nprint(str(false)); // \"false\"\nprint(str([true, '10.3', 9.8])); // [ \"true\", \"10.3\", \"9.8\" ]\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion" + }, + { + "file": "src/utilities/conversion.js", + "line": 119, + "description": "

    Converts a number or string to its boolean representation.\nFor a number, any non-zero value (positive or negative) evaluates to true,\nwhile zero evaluates to false. For a string, the value "true" evaluates to\ntrue, while any other value evaluates to false. When an array of number or\nstring values is passed in, then a array of booleans of the same length is\nreturned.

    \n", + "itemtype": "method", + "name": "boolean", + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "String|Boolean|Number|Array" + } + ], + "return": { + "description": "boolean representation of value", + "type": "Boolean" + }, + "example": [ + "\n
    \nprint(boolean(0)); // false\nprint(boolean(1)); // true\nprint(boolean('true')); // true\nprint(boolean('abcd')); // false\nprint(boolean([0, 12, 'true'])); // [false, true, true]\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion" + }, + { + "file": "src/utilities/conversion.js", + "line": 151, + "description": "

    Converts a number, string representation of a number, or boolean to its byte\nrepresentation. A byte can be only a whole number between -128 and 127, so\nwhen a value outside of this range is converted, it wraps around to the\ncorresponding byte representation. When an array of number, string or boolean\nvalues is passed in, then an array of bytes the same length is returned.

    \n", + "itemtype": "method", + "name": "byte", + "return": { + "description": "byte representation of value", + "type": "Number" + }, + "example": [ + "\n
    \nprint(byte(127)); // 127\nprint(byte(128)); // -128\nprint(byte(23.4)); // 23\nprint(byte('23.4')); // 23\nprint(byte('hello')); // NaN\nprint(byte(true)); // 1\nprint(byte([0, 255, '100'])); // [0, -1, 100]\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion", + "overloads": [ + { + "line": 151, + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "String|Boolean|Number" + } + ], + "return": { + "description": "byte representation of value", + "type": "Number" + } + }, + { + "line": 173, + "params": [ + { + "name": "ns", + "description": "

    values to parse

    \n", + "type": "Array" + } + ], + "return": { + "description": "array of byte representation of values", + "type": "Number[]" + } + } + ] + }, + { + "file": "src/utilities/conversion.js", + "line": 187, + "description": "

    Converts a number or string to its corresponding single-character\nstring representation. If a string parameter is provided, it is first\nparsed as an integer and then translated into a single-character string.\nWhen an array of number or string values is passed in, then an array of\nsingle-character strings of the same length is returned.

    \n", + "itemtype": "method", + "name": "char", + "return": { + "description": "string representation of value", + "type": "String" + }, + "example": [ + "\n
    \nprint(char(65)); // \"A\"\nprint(char('65')); // \"A\"\nprint(char([65, 66, 67])); // [ \"A\", \"B\", \"C\" ]\nprint(join(char([65, 66, 67]), '')); // \"ABC\"\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion", + "overloads": [ + { + "line": 187, + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "String|Number" + } + ], + "return": { + "description": "string representation of value", + "type": "String" + } + }, + { + "line": 206, + "params": [ + { + "name": "ns", + "description": "

    values to parse

    \n", + "type": "Array" + } + ], + "return": { + "description": "array of string representation of values", + "type": "String[]" + } + } + ] + }, + { + "file": "src/utilities/conversion.js", + "line": 221, + "description": "

    Converts a single-character string to its corresponding integer\nrepresentation. When an array of single-character string values is passed\nin, then an array of integers of the same length is returned.

    \n", + "itemtype": "method", + "name": "unchar", + "return": { + "description": "integer representation of value", + "type": "Number" + }, + "example": [ + "\n
    \nprint(unchar('A')); // 65\nprint(unchar(['A', 'B', 'C'])); // [ 65, 66, 67 ]\nprint(unchar(split('ABC', ''))); // [ 65, 66, 67 ]\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion", + "overloads": [ + { + "line": 221, + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "String" + } + ], + "return": { + "description": "integer representation of value", + "type": "Number" + } + }, + { + "line": 237, + "params": [ + { + "name": "ns", + "description": "

    values to parse

    \n", + "type": "Array" + } + ], + "return": { + "description": "integer representation of values", + "type": "Number[]" + } + } + ] + }, + { + "file": "src/utilities/conversion.js", + "line": 250, + "description": "

    Converts a number to a string in its equivalent hexadecimal notation. If a\nsecond parameter is passed, it is used to set the number of characters to\ngenerate in the hexadecimal notation. When an array is passed in, an\narray of strings in hexadecimal notation of the same length is returned.

    \n", + "itemtype": "method", + "name": "hex", + "return": { + "description": "hexadecimal string representation of value", + "type": "String" + }, + "example": [ + "\n
    \nprint(hex(255)); // \"000000FF\"\nprint(hex(255, 6)); // \"0000FF\"\nprint(hex([0, 127, 255], 6)); // [ \"000000\", \"00007F\", \"0000FF\" ]\nprint(Infinity); // \"FFFFFFFF\"\nprint(-Infinity); // \"00000000\"\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion", + "overloads": [ + { + "line": 250, + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "Number" + }, + { + "name": "digits", + "description": "", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "hexadecimal string representation of value", + "type": "String" + } + }, + { + "line": 270, + "params": [ + { + "name": "ns", + "description": "

    array of values to parse

    \n", + "type": "Number[]" + }, + { + "name": "digits", + "description": "", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "hexadecimal string representation of values", + "type": "String[]" + } + } + ] + }, + { + "file": "src/utilities/conversion.js", + "line": 302, + "description": "

    Converts a string representation of a hexadecimal number to its equivalent\ninteger value. When an array of strings in hexadecimal notation is passed\nin, an array of integers of the same length is returned.

    \n", + "itemtype": "method", + "name": "unhex", + "return": { + "description": "integer representation of hexadecimal value", + "type": "Number" + }, + "example": [ + "\n
    \nprint(unhex('A')); // 10\nprint(unhex('FF')); // 255\nprint(unhex(['FF', 'AA', '00'])); // [ 255, 170, 0 ]\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "Conversion", + "overloads": [ + { + "line": 302, + "params": [ + { + "name": "n", + "description": "

    value to parse

    \n", + "type": "String" + } + ], + "return": { + "description": "integer representation of hexadecimal value", + "type": "Number" + } + }, + { + "line": 318, + "params": [ + { + "name": "ns", + "description": "

    values to parse

    \n", + "type": "Array" + } + ], + "return": { + "description": "integer representations of hexadecimal value", + "type": "Number[]" + } + } + ] + }, + { + "file": "src/utilities/string_functions.js", + "line": 15, + "description": "

    Combines an array of Strings into one String, each separated by the\ncharacter(s) used for the separator parameter. To join arrays of ints or\nfloats, it's necessary to first convert them to Strings using nf() or\nnfs().

    \n", + "itemtype": "method", + "name": "join", + "params": [ + { + "name": "list", + "description": "

    array of Strings to be joined

    \n", + "type": "Array" + }, + { + "name": "separator", + "description": "

    String to be placed between each item

    \n", + "type": "String" + } + ], + "return": { + "description": "joined String", + "type": "String" + }, + "example": [ + "\n
    \n\nvar array = ['Hello', 'world!'];\nvar separator = ' ';\nvar message = join(array, separator);\ntext(message, 5, 50);\n\n
    " + ], + "alt": "\"hello world!\" displayed middle left of canvas.", + "class": "p5", + "module": "Data", + "submodule": "String Functions" + }, + { + "file": "src/utilities/string_functions.js", + "line": 44, + "description": "

    This function is used to apply a regular expression to a piece of text,\nand return matching groups (elements found inside parentheses) as a\nString array. If there are no matches, a null value will be returned.\nIf no groups are specified in the regular expression, but the sequence\nmatches, an array of length 1 (with the matched text as the first element\nof the array) will be returned.\n

    \nTo use the function, first check to see if the result is null. If the\nresult is null, then the sequence did not match at all. If the sequence\ndid match, an array is returned.\n

    \nIf there are groups (specified by sets of parentheses) in the regular\nexpression, then the contents of each will be returned in the array.\nElement [0] of a regular expression match returns the entire matching\nstring, and the match groups start at element [1] (the first group is [1],\nthe second [2], and so on).

    \n", + "itemtype": "method", + "name": "match", + "params": [ + { + "name": "str", + "description": "

    the String to be searched

    \n", + "type": "String" + }, + { + "name": "regexp", + "description": "

    the regexp to be used for matching

    \n", + "type": "String" + } + ], + "return": { + "description": "Array of Strings found", + "type": "String[]" + }, + "example": [ + "\n
    \n\nvar string = 'Hello p5js*!';\nvar regexp = 'p5js\\\\*';\nvar m = match(string, regexp);\ntext(m, 5, 50);\n\n
    " + ], + "alt": "\"p5js*\" displayed middle left of canvas.", + "class": "p5", + "module": "Data", + "submodule": "String Functions" + }, + { + "file": "src/utilities/string_functions.js", + "line": 85, + "description": "

    This function is used to apply a regular expression to a piece of text,\nand return a list of matching groups (elements found inside parentheses)\nas a two-dimensional String array. If there are no matches, a null value\nwill be returned. If no groups are specified in the regular expression,\nbut the sequence matches, a two dimensional array is still returned, but\nthe second dimension is only of length one.\n

    \nTo use the function, first check to see if the result is null. If the\nresult is null, then the sequence did not match at all. If the sequence\ndid match, a 2D array is returned.\n

    \nIf there are groups (specified by sets of parentheses) in the regular\nexpression, then the contents of each will be returned in the array.\nAssuming a loop with counter variable i, element [i][0] of a regular\nexpression match returns the entire matching string, and the match groups\nstart at element [i][1] (the first group is [i][1], the second [i][2],\nand so on).

    \n", + "itemtype": "method", + "name": "matchAll", + "params": [ + { + "name": "str", + "description": "

    the String to be searched

    \n", + "type": "String" + }, + { + "name": "regexp", + "description": "

    the regexp to be used for matching

    \n", + "type": "String" + } + ], + "return": { + "description": "2d Array of Strings found", + "type": "String[]" + }, + "example": [ + "\n
    \n\nvar string = 'Hello p5js*! Hello world!';\nvar regexp = 'Hello';\nmatchAll(string, regexp);\n\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "String Functions" + }, + { + "file": "src/utilities/string_functions.js", + "line": 132, + "description": "

    Utility function for formatting numbers into strings. There are two\nversions: one for formatting floats, and one for formatting ints.\nThe values for the digits, left, and right parameters should always\nbe positive integers.\n(NOTE): Be cautious when using left and right parameters as it prepends numbers of 0's if the parameter\nif greater than the current length of the number.\nFor example if number is 123.2 and left parameter passed is 4 which is greater than length of 123\n(integer part) i.e 3 than result will be 0123.2. Same case for right parameter i.e. if right is 3 than\nthe result will be 123.200.

    \n", + "itemtype": "method", + "name": "nf", + "return": { + "description": "formatted String", + "type": "String" + }, + "example": [ + "\n
    \n\nvar myFont;\nfunction preload() {\n myFont = loadFont('assets/fonts/inconsolata.ttf');\n}\nfunction setup() {\n background(200);\n var num1 = 321;\n var num2 = -1321;\n\n noStroke();\n fill(0);\n textFont(myFont);\n textSize(22);\n\n text(nf(num1, 4, 2), 10, 30);\n text(nf(num2, 4, 2), 10, 80);\n // Draw dividing line\n stroke(120);\n line(0, 50, width, 50);\n}\n\n
    " + ], + "alt": "\"0321.00\" middle top, -1321.00\" middle bottom canvas", + "class": "p5", + "module": "Data", + "submodule": "String Functions", + "overloads": [ + { + "line": 132, + "params": [ + { + "name": "num", + "description": "

    the Number to format

    \n", + "type": "Number|String" + }, + { + "name": "left", + "description": "

    number of digits to the left of the\n decimal point

    \n", + "type": "Integer|String", + "optional": true + }, + { + "name": "right", + "description": "

    number of digits to the right of the\n decimal point

    \n", + "type": "Integer|String", + "optional": true + } + ], + "return": { + "description": "formatted String", + "type": "String" + } + }, + { + "line": 180, + "params": [ + { + "name": "nums", + "description": "

    the Numbers to format

    \n", + "type": "Array" + }, + { + "name": "left", + "description": "", + "type": "Integer|String", + "optional": true + }, + { + "name": "right", + "description": "", + "type": "Integer|String", + "optional": true + } + ], + "return": { + "description": "formatted Strings", + "type": "String[]" + } + } + ] + }, + { + "file": "src/utilities/string_functions.js", + "line": 243, + "description": "

    Utility function for formatting numbers into strings and placing\nappropriate commas to mark units of 1000. There are two versions: one\nfor formatting ints, and one for formatting an array of ints. The value\nfor the right parameter should always be a positive integer.

    \n", + "itemtype": "method", + "name": "nfc", + "return": { + "description": "formatted String", + "type": "String" + }, + "example": [ + "\n
    \n\nfunction setup() {\n background(200);\n var num = 11253106.115;\n var numArr = [1, 1, 2];\n\n noStroke();\n fill(0);\n textSize(12);\n\n // Draw formatted numbers\n text(nfc(num, 4), 10, 30);\n text(nfc(numArr, 2), 10, 80);\n\n // Draw dividing line\n stroke(120);\n line(0, 50, width, 50);\n}\n\n
    " + ], + "alt": "\"11,253,106.115\" top middle and \"1.00,1.00,2.00\" displayed bottom mid", + "class": "p5", + "module": "Data", + "submodule": "String Functions", + "overloads": [ + { + "line": 243, + "params": [ + { + "name": "num", + "description": "

    the Number to format

    \n", + "type": "Number|String" + }, + { + "name": "right", + "description": "

    number of digits to the right of the\n decimal point

    \n", + "type": "Integer|String", + "optional": true + } + ], + "return": { + "description": "formatted String", + "type": "String" + } + }, + { + "line": 281, + "params": [ + { + "name": "nums", + "description": "

    the Numbers to format

    \n", + "type": "Array" + }, + { + "name": "right", + "description": "", + "type": "Integer|String", + "optional": true + } + ], + "return": { + "description": "formatted Strings", + "type": "String[]" + } + } + ] + }, + { + "file": "src/utilities/string_functions.js", + "line": 319, + "description": "

    Utility function for formatting numbers into strings. Similar to nf() but\nputs a "+" in front of positive numbers and a "-" in front of negative\nnumbers. There are two versions: one for formatting floats, and one for\nformatting ints. The values for left, and right parameters\nshould always be positive integers.

    \n", + "itemtype": "method", + "name": "nfp", + "return": { + "description": "formatted String", + "type": "String" + }, + "example": [ + "\n
    \n\nfunction setup() {\n background(200);\n var num1 = 11253106.115;\n var num2 = -11253106.115;\n\n noStroke();\n fill(0);\n textSize(12);\n\n // Draw formatted numbers\n text(nfp(num1, 4, 2), 10, 30);\n text(nfp(num2, 4, 2), 10, 80);\n\n // Draw dividing line\n stroke(120);\n line(0, 50, width, 50);\n}\n\n
    " + ], + "alt": "\"+11253106.11\" top middle and \"-11253106.11\" displayed bottom middle", + "class": "p5", + "module": "Data", + "submodule": "String Functions", + "overloads": [ + { + "line": 319, + "params": [ + { + "name": "num", + "description": "

    the Number to format

    \n", + "type": "Number" + }, + { + "name": "left", + "description": "

    number of digits to the left of the decimal\n point

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "right", + "description": "

    number of digits to the right of the\n decimal point

    \n", + "type": "Integer", + "optional": true + } + ], + "return": { + "description": "formatted String", + "type": "String" + } + }, + { + "line": 360, + "params": [ + { + "name": "nums", + "description": "

    the Numbers to format

    \n", + "type": "Number[]" + }, + { + "name": "left", + "description": "", + "type": "Integer", + "optional": true + }, + { + "name": "right", + "description": "", + "type": "Integer", + "optional": true + } + ], + "return": { + "description": "formatted Strings", + "type": "String[]" + } + } + ] + }, + { + "file": "src/utilities/string_functions.js", + "line": 381, + "description": "

    Utility function for formatting numbers into strings. Similar to nf() but\nputs an additional "_" (space) in front of positive numbers just in case to align it with negative\nnumbers which includes "-" (minus) sign.\nThe main usecase of nfs() can be seen when one wants to align the digits (place values) of a positive\nnumber with some negative number (See the example to get a clear picture).\nThere are two versions: one for formatting float, and one for formatting int.\nThe values for the digits, left, and right parameters should always be positive integers.\n(IMP): The result on the canvas basically the expected alignment can vary based on the typeface you are using.\n(NOTE): Be cautious when using left and right parameters as it prepends numbers of 0's if the parameter\nif greater than the current length of the number.\nFor example if number is 123.2 and left parameter passed is 4 which is greater than length of 123\n(integer part) i.e 3 than result will be 0123.2. Same case for right parameter i.e. if right is 3 than\nthe result will be 123.200.

    \n", + "itemtype": "method", + "name": "nfs", + "return": { + "description": "formatted String", + "type": "String" + }, + "example": [ + "\n
    \n\nvar myFont;\nfunction preload() {\n myFont = loadFont('assets/fonts/inconsolata.ttf');\n}\nfunction setup() {\n background(200);\n var num1 = 321;\n var num2 = -1321;\n\n noStroke();\n fill(0);\n textFont(myFont);\n textSize(22);\n\n // nfs() aligns num1 (positive number) with num2 (negative number) by\n // adding a blank space in front of the num1 (positive number)\n // [left = 4] in num1 add one 0 in front, to align the digits with num2\n // [right = 2] in num1 and num2 adds two 0's after both numbers\n // To see the differences check the example of nf() too.\n text(nfs(num1, 4, 2), 10, 30);\n text(nfs(num2, 4, 2), 10, 80);\n // Draw dividing line\n stroke(120);\n line(0, 50, width, 50);\n}\n\n
    " + ], + "alt": "\"0321.00\" top middle and \"-1321.00\" displayed bottom middle", + "class": "p5", + "module": "Data", + "submodule": "String Functions", + "overloads": [ + { + "line": 381, + "params": [ + { + "name": "num", + "description": "

    the Number to format

    \n", + "type": "Number" + }, + { + "name": "left", + "description": "

    number of digits to the left of the decimal\n point

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "right", + "description": "

    number of digits to the right of the\n decimal point

    \n", + "type": "Integer", + "optional": true + } + ], + "return": { + "description": "formatted String", + "type": "String" + } + }, + { + "line": 438, + "params": [ + { + "name": "nums", + "description": "

    the Numbers to format

    \n", + "type": "Array" + }, + { + "name": "left", + "description": "", + "type": "Integer", + "optional": true + }, + { + "name": "right", + "description": "", + "type": "Integer", + "optional": true + } + ], + "return": { + "description": "formatted Strings", + "type": "String[]" + } + } + ] + }, + { + "file": "src/utilities/string_functions.js", + "line": 459, + "description": "

    The split() function maps to String.split(), it breaks a String into\npieces using a character or string as the delimiter. The delim parameter\nspecifies the character or characters that mark the boundaries between\neach piece. A String[] array is returned that contains each of the pieces.

    \n

    The splitTokens() function works in a similar fashion, except that it\nsplits using a range of characters instead of a specific character or\nsequence.

    \n", + "itemtype": "method", + "name": "split", + "params": [ + { + "name": "value", + "description": "

    the String to be split

    \n", + "type": "String" + }, + { + "name": "delim", + "description": "

    the String used to separate the data

    \n", + "type": "String" + } + ], + "return": { + "description": "Array of Strings", + "type": "String[]" + }, + "example": [ + "\n
    \n\nvar names = 'Pat,Xio,Alex';\nvar splitString = split(names, ',');\ntext(splitString[0], 5, 30);\ntext(splitString[1], 5, 50);\ntext(splitString[2], 5, 70);\n\n
    " + ], + "alt": "\"pat\" top left, \"Xio\" mid left and \"Alex\" displayed bottom left", + "class": "p5", + "module": "Data", + "submodule": "String Functions" + }, + { + "file": "src/utilities/string_functions.js", + "line": 493, + "description": "

    The splitTokens() function splits a String at one or many character\ndelimiters or "tokens." The delim parameter specifies the character or\ncharacters to be used as a boundary.\n

    \nIf no delim characters are specified, any whitespace character is used to\nsplit. Whitespace characters include tab (\\t), line feed (\\n), carriage\nreturn (\\r), form feed (\\f), and space.

    \n", + "itemtype": "method", + "name": "splitTokens", + "params": [ + { + "name": "value", + "description": "

    the String to be split

    \n", + "type": "String" + }, + { + "name": "delim", + "description": "

    list of individual Strings that will be used as\n separators

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "Array of Strings", + "type": "String[]" + }, + "example": [ + "\n
    \n\nfunction setup() {\n var myStr = 'Mango, Banana, Lime';\n var myStrArr = splitTokens(myStr, ',');\n\n print(myStrArr); // prints : [\"Mango\",\" Banana\",\" Lime\"]\n}\n\n
    " + ], + "class": "p5", + "module": "Data", + "submodule": "String Functions" + }, + { + "file": "src/utilities/string_functions.js", + "line": 548, + "description": "

    Removes whitespace characters from the beginning and end of a String. In\naddition to standard whitespace characters such as space, carriage return,\nand tab, this function also removes the Unicode "nbsp" character.

    \n", + "itemtype": "method", + "name": "trim", + "return": { + "description": "a trimmed String", + "type": "String" + }, + "example": [ + "\n
    \n\nvar string = trim(' No new lines\\n ');\ntext(string + ' here', 2, 50);\n\n
    " + ], + "alt": "\"No new lines here\" displayed center canvas", + "class": "p5", + "module": "Data", + "submodule": "String Functions", + "overloads": [ + { + "line": 548, + "params": [ + { + "name": "str", + "description": "

    a String to be trimmed

    \n", + "type": "String" + } + ], + "return": { + "description": "a trimmed String", + "type": "String" + } + }, + { + "line": 568, + "params": [ + { + "name": "strs", + "description": "

    an Array of Strings to be trimmed

    \n", + "type": "Array" + } + ], + "return": { + "description": "an Array of trimmed Strings", + "type": "String[]" + } + } + ] + }, + { + "file": "src/utilities/time_date.js", + "line": 12, + "description": "

    p5.js communicates with the clock on your computer. The day() function\nreturns the current day as a value from 1 - 31.

    \n", + "itemtype": "method", + "name": "day", + "return": { + "description": "the current day", + "type": "Integer" + }, + "example": [ + "\n
    \n\nvar d = day();\ntext('Current day: \\n' + d, 5, 50);\n\n
    " + ], + "alt": "Current day is displayed", + "class": "p5", + "module": "IO", + "submodule": "Time & Date" + }, + { + "file": "src/utilities/time_date.js", + "line": 34, + "description": "

    p5.js communicates with the clock on your computer. The hour() function\nreturns the current hour as a value from 0 - 23.

    \n", + "itemtype": "method", + "name": "hour", + "return": { + "description": "the current hour", + "type": "Integer" + }, + "example": [ + "\n
    \n\nvar h = hour();\ntext('Current hour:\\n' + h, 5, 50);\n\n
    " + ], + "alt": "Current hour is displayed", + "class": "p5", + "module": "IO", + "submodule": "Time & Date" + }, + { + "file": "src/utilities/time_date.js", + "line": 56, + "description": "

    p5.js communicates with the clock on your computer. The minute() function\nreturns the current minute as a value from 0 - 59.

    \n", + "itemtype": "method", + "name": "minute", + "return": { + "description": "the current minute", + "type": "Integer" + }, + "example": [ + "\n
    \n\nvar m = minute();\ntext('Current minute: \\n' + m, 5, 50);\n\n
    " + ], + "alt": "Current minute is displayed", + "class": "p5", + "module": "IO", + "submodule": "Time & Date" + }, + { + "file": "src/utilities/time_date.js", + "line": 78, + "description": "

    Returns the number of milliseconds (thousandths of a second) since\nstarting the program. This information is often used for timing events and\nanimation sequences.

    \n", + "itemtype": "method", + "name": "millis", + "return": { + "description": "the number of milliseconds since starting the program", + "type": "Number" + }, + "example": [ + "\n
    \n\nvar millisecond = millis();\ntext('Milliseconds \\nrunning: \\n' + millisecond, 5, 40);\n\n
    " + ], + "alt": "number of milliseconds since program has started displayed", + "class": "p5", + "module": "IO", + "submodule": "Time & Date" + }, + { + "file": "src/utilities/time_date.js", + "line": 101, + "description": "

    p5.js communicates with the clock on your computer. The month() function\nreturns the current month as a value from 1 - 12.

    \n", + "itemtype": "method", + "name": "month", + "return": { + "description": "the current month", + "type": "Integer" + }, + "example": [ + "\n
    \n\nvar m = month();\ntext('Current month: \\n' + m, 5, 50);\n\n
    " + ], + "alt": "Current month is displayed", + "class": "p5", + "module": "IO", + "submodule": "Time & Date" + }, + { + "file": "src/utilities/time_date.js", + "line": 123, + "description": "

    p5.js communicates with the clock on your computer. The second() function\nreturns the current second as a value from 0 - 59.

    \n", + "itemtype": "method", + "name": "second", + "return": { + "description": "the current second", + "type": "Integer" + }, + "example": [ + "\n
    \n\nvar s = second();\ntext('Current second: \\n' + s, 5, 50);\n\n
    " + ], + "alt": "Current second is displayed", + "class": "p5", + "module": "IO", + "submodule": "Time & Date" + }, + { + "file": "src/utilities/time_date.js", + "line": 145, + "description": "

    p5.js communicates with the clock on your computer. The year() function\nreturns the current year as an integer (2014, 2015, 2016, etc).

    \n", + "itemtype": "method", + "name": "year", + "return": { + "description": "the current year", + "type": "Integer" + }, + "example": [ + "\n
    \n\nvar y = year();\ntext('Current year: \\n' + y, 5, 50);\n\n
    " + ], + "alt": "Current year is displayed", + "class": "p5", + "module": "IO", + "submodule": "Time & Date" + }, + { + "file": "src/webgl/3d_primitives.js", + "line": 14, + "description": "

    Draw a plane with given a width and height

    \n", + "itemtype": "method", + "name": "plane", + "params": [ + { + "name": "width", + "description": "

    width of the plane

    \n", + "type": "Number", + "optional": true + }, + { + "name": "height", + "description": "

    height of the plane

    \n", + "type": "Number", + "optional": true + }, + { + "name": "detailX", + "description": "

    Optional number of triangle\n subdivisions in x-dimension

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    Optional number of triangle\n subdivisions in y-dimension

    \n", + "type": "Integer", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// draw a plane\n// with width 50 and height 50\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n plane(50, 50);\n}\n\n
    " + ], + "alt": "Nothing displayed on canvas\nRotating interior view of a box with sides that change color.\n3d red and green gradient.\nRotating interior view of a cylinder with sides that change color.\nRotating view of a cylinder with sides that change color.\n3d red and green gradient.\nrotating view of a multi-colored cylinder with concave sides.", + "class": "p5", + "module": "Shape", + "submodule": "3D Primitives" + }, + { + "file": "src/webgl/3d_primitives.js", + "line": 98, + "description": "

    Draw a box with given width, height and depth

    \n", + "itemtype": "method", + "name": "box", + "params": [ + { + "name": "width", + "description": "

    width of the box

    \n", + "type": "Number", + "optional": true + }, + { + "name": "Height", + "description": "

    height of the box

    \n", + "type": "Number", + "optional": true + }, + { + "name": "depth", + "description": "

    depth of the box

    \n", + "type": "Number", + "optional": true + }, + { + "name": "detailX", + "description": "

    Optional number of triangle\n subdivisions in x-dimension

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    Optional number of triangle\n subdivisions in y-dimension

    \n", + "type": "Integer", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// draw a spinning box\n// with width, height and depth of 50\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n box(50);\n}\n\n
    " + ], + "class": "p5", + "module": "Shape", + "submodule": "3D Primitives" + }, + { + "file": "src/webgl/3d_primitives.js", + "line": 216, + "description": "

    Draw a sphere with given radius

    \n", + "itemtype": "method", + "name": "sphere", + "params": [ + { + "name": "radius", + "description": "

    radius of circle

    \n", + "type": "Number", + "optional": true + }, + { + "name": "detailX", + "description": "

    number of segments,\n the more segments the smoother geometry\n default is 24

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    number of segments,\n the more segments the smoother geometry\n default is 16

    \n", + "type": "Integer", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// draw a sphere with radius 40\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n sphere(40);\n}\n\n
    " + ], + "class": "p5", + "module": "Shape", + "submodule": "3D Primitives" + }, + { + "file": "src/webgl/3d_primitives.js", + "line": 378, + "description": "

    Draw a cylinder with given radius and height

    \n", + "itemtype": "method", + "name": "cylinder", + "params": [ + { + "name": "radius", + "description": "

    radius of the surface

    \n", + "type": "Number", + "optional": true + }, + { + "name": "height", + "description": "

    height of the cylinder

    \n", + "type": "Number", + "optional": true + }, + { + "name": "detailX", + "description": "

    number of segments,\n the more segments the smoother geometry\n default is 24

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    number of segments in y-dimension,\n the more segments the smoother geometry\n default is 1

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "bottomCap", + "description": "

    whether to draw the bottom of the cylinder

    \n", + "type": "Boolean", + "optional": true + }, + { + "name": "topCap", + "description": "

    whether to draw the top of the cylinder

    \n", + "type": "Boolean", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// draw a spinning cylinder\n// with radius 20 and height 50\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cylinder(20, 50);\n}\n\n
    " + ], + "class": "p5", + "module": "Shape", + "submodule": "3D Primitives" + }, + { + "file": "src/webgl/3d_primitives.js", + "line": 470, + "description": "

    Draw a cone with given radius and height

    \n", + "itemtype": "method", + "name": "cone", + "params": [ + { + "name": "radius", + "description": "

    radius of the bottom surface

    \n", + "type": "Number", + "optional": true + }, + { + "name": "height", + "description": "

    height of the cone

    \n", + "type": "Number", + "optional": true + }, + { + "name": "detailX", + "description": "

    number of segments,\n the more segments the smoother geometry\n default is 24

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    number of segments,\n the more segments the smoother geometry\n default is 1

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "cap", + "description": "

    whether to draw the base of the cone

    \n", + "type": "Boolean", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// draw a spinning cone\n// with radius 40 and height 70\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateZ(frameCount * 0.01);\n cone(40, 70);\n}\n\n
    " + ], + "class": "p5", + "module": "Shape", + "submodule": "3D Primitives" + }, + { + "file": "src/webgl/3d_primitives.js", + "line": 540, + "description": "

    Draw an ellipsoid with given radius

    \n", + "itemtype": "method", + "name": "ellipsoid", + "params": [ + { + "name": "radiusx", + "description": "

    x-radius of ellipsoid

    \n", + "type": "Number", + "optional": true + }, + { + "name": "radiusy", + "description": "

    y-radius of ellipsoid

    \n", + "type": "Number", + "optional": true + }, + { + "name": "radiusz", + "description": "

    z-radius of ellipsoid

    \n", + "type": "Number", + "optional": true + }, + { + "name": "detailX", + "description": "

    number of segments,\n the more segments the smoother geometry\n default is 24. Avoid detail number above\n 150, it may crash the browser.

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    number of segments,\n the more segments the smoother geometry\n default is 16. Avoid detail number above\n 150, it may crash the browser.

    \n", + "type": "Integer", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// draw an ellipsoid\n// with radius 30, 40 and 40.\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n ellipsoid(30, 40, 40);\n}\n\n
    " + ], + "class": "p5", + "module": "Shape", + "submodule": "3D Primitives" + }, + { + "file": "src/webgl/3d_primitives.js", + "line": 631, + "description": "

    Draw a torus with given radius and tube radius

    \n", + "itemtype": "method", + "name": "torus", + "params": [ + { + "name": "radius", + "description": "

    radius of the whole ring

    \n", + "type": "Number", + "optional": true + }, + { + "name": "tubeRadius", + "description": "

    radius of the tube

    \n", + "type": "Number", + "optional": true + }, + { + "name": "detailX", + "description": "

    number of segments in x-dimension,\n the more segments the smoother geometry\n default is 24

    \n", + "type": "Integer", + "optional": true + }, + { + "name": "detailY", + "description": "

    number of segments in y-dimension,\n the more segments the smoother geometry\n default is 16

    \n", + "type": "Integer", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n// draw a spinning torus\n// with ring radius 30 and tube radius 15\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n torus(30, 15);\n}\n\n
    " + ], + "class": "p5", + "module": "Shape", + "submodule": "3D Primitives" + }, + { + "file": "src/webgl/interaction.js", + "line": 13, + "description": "

    Allows movement around a 3D sketch using a mouse or trackpad. Left-clicking\nand dragging will rotate the camera position about the center of the sketch,\nright-clicking and dragging will pan the camera position without rotation,\nand using the mouse wheel (scrolling) will move the camera closer or further\nfrom the center of the sketch. This function can be called with parameters\ndictating sensitivity to mouse movement along the X and Y axes. Calling\nthis function without parameters is equivalent to calling orbitControl(1,1).\nTo reverse direction of movement in either axis, enter a negative number\nfor sensitivity.

    \n", + "itemtype": "method", + "name": "orbitControl", + "params": [ + { + "name": "sensitivityX", + "description": "

    sensitivity to mouse movement along X axis

    \n", + "type": "Number", + "optional": true + }, + { + "name": "sensitivityY", + "description": "

    sensitivity to mouse movement along Y axis

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n}\nfunction draw() {\n background(200);\n orbitControl();\n rotateY(0.5);\n box(30, 50);\n}\n\n
    " + ], + "alt": "Camera orbits around a box when mouse is hold-clicked & then moved.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Interaction" + }, + { + "file": "src/webgl/interaction.js", + "line": 146, + "description": "

    debugMode() helps visualize 3D space by adding a grid to indicate where the\n‘ground’ is in a sketch and an axes icon which indicates the +X, +Y, and +Z\ndirections. This function can be called without parameters to create a\ndefault grid and axes icon, or it can be called according to the examples\nabove to customize the size and position of the grid and/or axes icon. The\ngrid is drawn using the most recently set stroke color and weight. To\nspecify these parameters, add a call to stroke() and strokeWeight()\njust before the end of the draw() loop.

    \n

    By default, the grid will run through the origin (0,0,0) of the sketch\nalong the XZ plane\nand the axes icon will be offset from the origin. Both the grid and axes\nicon will be sized according to the current canvas size. Note that because the\ngrid runs parallel to the default camera view, it is often helpful to use\ndebugMode along with orbitControl to allow full view of the grid.

    \n", + "itemtype": "method", + "name": "debugMode", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode();\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n // Press the spacebar to turn debugMode off!\n if (keyIsDown(32)) {\n noDebugMode();\n }\n}\n\n
    ", + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(GRID);\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n}\n\n
    ", + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(AXES);\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n}\n\n
    ", + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(GRID, 100, 10, 0, 0, 0);\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n}\n\n
    ", + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode(100, 10, 0, 0, 0, 20, 0, -40, 0);\n}\n\nfunction draw() {\n noStroke();\n background(200);\n orbitControl();\n box(15, 30);\n // set the stroke color and weight for the grid!\n stroke(255, 0, 150);\n strokeWeight(0.8);\n}\n\n
    " + ], + "alt": "a 3D box is centered on a grid in a 3D sketch. an icon\nindicates the direction of each axis: a red line points +X,\na green line +Y, and a blue line +Z.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Interaction", + "overloads": [ + { + "line": 146, + "params": [] + }, + { + "line": 279, + "params": [ + { + "name": "mode", + "description": "

    either GRID or AXES

    \n", + "type": "Constant" + } + ] + }, + { + "line": 284, + "params": [ + { + "name": "mode", + "description": "", + "type": "Constant" + }, + { + "name": "gridSize", + "description": "

    size of one side of the grid

    \n", + "type": "Number", + "optional": true + }, + { + "name": "gridDivisions", + "description": "

    number of divisions in the grid

    \n", + "type": "Number", + "optional": true + }, + { + "name": "xOff", + "description": "

    X axis offset from origin (0,0,0)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "yOff", + "description": "

    Y axis offset from origin (0,0,0)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "zOff", + "description": "

    Z axis offset from origin (0,0,0)

    \n", + "type": "Number", + "optional": true + } + ] + }, + { + "line": 294, + "params": [ + { + "name": "mode", + "description": "", + "type": "Constant" + }, + { + "name": "axesSize", + "description": "

    size of axes icon

    \n", + "type": "Number", + "optional": true + }, + { + "name": "xOff", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "yOff", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "zOff", + "description": "", + "type": "Number", + "optional": true + } + ] + }, + { + "line": 303, + "params": [ + { + "name": "gridSize", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "gridDivisions", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "gridXOff", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "gridYOff", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "gridZOff", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "axesSize", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "axesXOff", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "axesYOff", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "axesZOff", + "description": "", + "type": "Number", + "optional": true + } + ] + } + ] + }, + { + "file": "src/webgl/interaction.js", + "line": 380, + "description": "

    Turns off debugMode() in a 3D sketch.

    \n", + "itemtype": "method", + "name": "noDebugMode", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n camera(0, -30, 100, 0, 0, 0, 0, 1, 0);\n normalMaterial();\n debugMode();\n}\n\nfunction draw() {\n background(200);\n orbitControl();\n box(15, 30);\n // Press the spacebar to turn debugMode off!\n if (keyIsDown(32)) {\n noDebugMode();\n }\n}\n\n
    " + ], + "alt": "a 3D box is centered on a grid in a 3D sketch. an icon\nindicates the direction of each axis: a red line points +X,\na green line +Y, and a blue line +Z. the grid and icon disappear when the\nspacebar is pressed.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Interaction" + }, + { + "file": "src/webgl/light.js", + "line": 12, + "description": "

    Creates an ambient light with a color

    \n", + "itemtype": "method", + "name": "ambientLight", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n ambientLight(150);\n ambientMaterial(250);\n noStroke();\n sphere(40);\n}\n\n
    " + ], + "alt": "evenly distributed light across a sphere", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Lights", + "overloads": [ + { + "line": 12, + "params": [ + { + "name": "v1", + "description": "

    red or hue value relative to\n the current color range

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value\n relative to the current color range

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "

    the alpha value

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 46, + "params": [ + { + "name": "value", + "description": "

    a color string

    \n", + "type": "String" + } + ], + "chainable": 1 + }, + { + "line": 52, + "params": [ + { + "name": "gray", + "description": "

    a gray value

    \n", + "type": "Number" + }, + { + "name": "alpha", + "description": "", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 59, + "params": [ + { + "name": "values", + "description": "

    an array containing the red,green,blue &\n and alpha components of the color

    \n", + "type": "Number[]" + } + ], + "chainable": 1 + }, + { + "line": 66, + "params": [ + { + "name": "color", + "description": "

    the ambient light color

    \n", + "type": "p5.Color" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/webgl/light.js", + "line": 87, + "description": "

    Creates a directional light with a color and a direction

    \n", + "itemtype": "method", + "name": "directionalLight", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n //move your mouse to change light direction\n let dirX = (mouseX / width - 0.5) * 2;\n let dirY = (mouseY / height - 0.5) * 2;\n directionalLight(250, 250, 250, -dirX, -dirY, -1);\n noStroke();\n sphere(40);\n}\n\n
    " + ], + "alt": "light source on canvas changeable with mouse position", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Lights", + "overloads": [ + { + "line": 87, + "params": [ + { + "name": "v1", + "description": "

    red or hue value (depending on the current\ncolor mode),

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value

    \n", + "type": "Number" + }, + { + "name": "position", + "description": "

    the direction of the light

    \n", + "type": "p5.Vector" + } + ], + "chainable": 1 + }, + { + "line": 119, + "params": [ + { + "name": "color", + "description": "

    color Array, CSS color string,\n or p5.Color value

    \n", + "type": "Number[]|String|p5.Color" + }, + { + "name": "x", + "description": "

    x axis direction

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y axis direction

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    z axis direction

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 129, + "params": [ + { + "name": "color", + "description": "", + "type": "Number[]|String|p5.Color" + }, + { + "name": "position", + "description": "", + "type": "p5.Vector" + } + ], + "chainable": 1 + }, + { + "line": 136, + "params": [ + { + "name": "v1", + "description": "", + "type": "Number" + }, + { + "name": "v2", + "description": "", + "type": "Number" + }, + { + "name": "v3", + "description": "", + "type": "Number" + }, + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + }, + { + "name": "z", + "description": "", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/webgl/light.js", + "line": 185, + "description": "

    Creates a point light with a color and a light position

    \n", + "itemtype": "method", + "name": "pointLight", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n //move your mouse to change light position\n let locX = mouseX - width / 2;\n let locY = mouseY - height / 2;\n // to set the light position,\n // think of the world's coordinate as:\n // -width/2,-height/2 -------- width/2,-height/2\n // | |\n // | 0,0 |\n // | |\n // -width/2,height/2--------width/2,height/2\n pointLight(250, 250, 250, locX, locY, 50);\n noStroke();\n sphere(40);\n}\n\n
    " + ], + "alt": "spot light on canvas changes position with mouse", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Lights", + "overloads": [ + { + "line": 185, + "params": [ + { + "name": "v1", + "description": "

    red or hue value (depending on the current\ncolor mode),

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value

    \n", + "type": "Number" + }, + { + "name": "v3", + "description": "

    blue or brightness value

    \n", + "type": "Number" + }, + { + "name": "x", + "description": "

    x axis position

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y axis position

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    z axis position

    \n", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 226, + "params": [ + { + "name": "v1", + "description": "", + "type": "Number" + }, + { + "name": "v2", + "description": "", + "type": "Number" + }, + { + "name": "v3", + "description": "", + "type": "Number" + }, + { + "name": "position", + "description": "

    the position of the light

    \n", + "type": "p5.Vector" + } + ], + "chainable": 1 + }, + { + "line": 235, + "params": [ + { + "name": "color", + "description": "

    color Array, CSS color string,\nor p5.Color value

    \n", + "type": "Number[]|String|p5.Color" + }, + { + "name": "x", + "description": "", + "type": "Number" + }, + { + "name": "y", + "description": "", + "type": "Number" + }, + { + "name": "z", + "description": "", + "type": "Number" + } + ], + "chainable": 1 + }, + { + "line": 245, + "params": [ + { + "name": "color", + "description": "", + "type": "Number[]|String|p5.Color" + }, + { + "name": "position", + "description": "", + "type": "p5.Vector" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/webgl/light.js", + "line": 287, + "description": "

    Sets the default ambient and directional light. The defaults are ambientLight(128, 128, 128) and directionalLight(128, 128, 128, 0, 0, -1). Lights need to be included in the draw() to remain persistent in a looping program. Placing them in the setup() of a looping program will cause them to only have an effect the first time through the loop.

    \n", + "itemtype": "method", + "name": "lights", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n lights();\n rotateX(millis() / 1000);\n rotateY(millis() / 1000);\n rotateZ(millis() / 1000);\n box();\n}\n\n
    " + ], + "alt": "the light is partially ambient and partially directional", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Lights" + }, + { + "file": "src/webgl/loading.js", + "line": 14, + "description": "

    Load a 3d model from an OBJ file.\n

    \nOne of the limitations of the OBJ format is that it doesn't have a built-in\nsense of scale. This means that models exported from different programs might\nbe very different sizes. If your model isn't displaying, try calling\nloadModel() with the normalized parameter set to true. This will resize the\nmodel to a scale appropriate for p5. You can also make additional changes to\nthe final size of your model with the scale() function.

    \n", + "itemtype": "method", + "name": "loadModel", + "return": { + "description": "the p5.Geometry object", + "type": "p5.Geometry" + }, + "example": [ + "\n
    \n\n//draw a spinning octahedron\nlet octahedron;\n\nfunction preload() {\n octahedron = loadModel('assets/octahedron.obj');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n model(octahedron);\n}\n\n
    ", + "\n
    \n\n//draw a spinning teapot\nlet teapot;\n\nfunction preload() {\n // Load model with normalise parameter set to true\n teapot = loadModel('assets/teapot.obj', true);\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n scale(0.4); // Scaled to make model fit into canvas\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n normalMaterial(); // For effect\n model(teapot);\n}\n\n
    " + ], + "alt": "Vertically rotating 3-d teapot with red, green and blue gradient.", + "class": "p5", + "module": "Shape", + "submodule": "3D Models", + "overloads": [ + { + "line": 14, + "params": [ + { + "name": "path", + "description": "

    Path of the model to be loaded

    \n", + "type": "String" + }, + { + "name": "normalize", + "description": "

    If true, scale the model to a\n standardized size when loading

    \n", + "type": "Boolean" + }, + { + "name": "successCallback", + "description": "

    Function to be called\n once the model is loaded. Will be passed\n the 3D model object.

    \n", + "type": "function(p5.Geometry)", + "optional": true + }, + { + "name": "failureCallback", + "description": "

    called with event error if\n the image fails to load.

    \n", + "type": "Function(Event)", + "optional": true + } + ], + "return": { + "description": "the p5.Geometry object", + "type": "p5.Geometry" + } + }, + { + "line": 90, + "params": [ + { + "name": "path", + "description": "", + "type": "String" + }, + { + "name": "successCallback", + "description": "", + "type": "function(p5.Geometry)", + "optional": true + }, + { + "name": "failureCallback", + "description": "", + "type": "Function(Event)", + "optional": true + } + ], + "return": { + "description": "the p5.Geometry object", + "type": "p5.Geometry" + } + } + ] + }, + { + "file": "src/webgl/loading.js", + "line": 135, + "description": "

    Parse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:

    \n

    v -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5

    \n

    f 4 3 2 1

    \n", + "class": "p5", + "module": "Shape", + "submodule": "3D Models" + }, + { + "file": "src/webgl/loading.js", + "line": 244, + "description": "

    Render a 3d model to the screen.

    \n", + "itemtype": "method", + "name": "model", + "params": [ + { + "name": "model", + "description": "

    Loaded 3d model to be rendered

    \n", + "type": "p5.Geometry" + } + ], + "example": [ + "\n
    \n\n//draw a spinning octahedron\nlet octahedron;\n\nfunction preload() {\n octahedron = loadModel('assets/octahedron.obj');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n model(octahedron);\n}\n\n
    " + ], + "alt": "Vertically rotating 3-d octahedron.", + "class": "p5", + "module": "Shape", + "submodule": "3D Models" + }, + { + "file": "src/webgl/material.js", + "line": 14, + "description": "

    Loads a custom shader from the provided vertex and fragment\nshader paths. The shader files are loaded asynchronously in the\nbackground, so this method should be used in preload().

    \n

    For now, there are three main types of shaders. p5 will automatically\nsupply appropriate vertices, normals, colors, and lighting attributes\nif the parameters defined in the shader match the names.

    \n", + "itemtype": "method", + "name": "loadShader", + "params": [ + { + "name": "vertFilename", + "description": "

    path to file containing vertex shader\nsource code

    \n", + "type": "String" + }, + { + "name": "fragFilename", + "description": "

    path to file containing fragment shader\nsource code

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    callback to be executed after loadShader\ncompletes. On success, the Shader object is passed as the first argument.

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    callback to be executed when an error\noccurs inside loadShader. On error, the error is passed as the first\nargument.

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "a shader object created from the provided\nvertex and fragment shader files.", + "type": "p5.Shader" + }, + "example": [ + "\n
    \n\nlet mandel;\nfunction preload() {\n // load the shader definitions from files\n mandel = loadShader('assets/shader.vert', 'assets/shader.frag');\n}\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n // use the shader\n shader(mandel);\n noStroke();\n mandel.setUniform('p', [-0.74364388703, 0.13182590421]);\n}\n\nfunction draw() {\n mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000))));\n quad(-1, -1, 1, -1, 1, 1, -1, 1);\n}\n\n
    " + ], + "alt": "zooming Mandelbrot set. a colorful, infinitely detailed fractal.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 113, + "itemtype": "method", + "name": "createShader", + "params": [ + { + "name": "vertSrc", + "description": "

    source code for the vertex shader

    \n", + "type": "String" + }, + { + "name": "fragSrc", + "description": "

    source code for the fragment shader

    \n", + "type": "String" + } + ], + "return": { + "description": "a shader object created from the provided\nvertex and fragment shaders.", + "type": "p5.Shader" + }, + "example": [ + "\n
    \n\n// the 'varying's are shared between both vertex & fragment shaders\nlet varying = 'precision highp float; varying vec2 vPos;';\n\n// the vertex shader is called for each vertex\nlet vs =\n varying +\n 'attribute vec3 aPosition;' +\n 'void main() { vPos = (gl_Position = vec4(aPosition,1.0)).xy; }';\n\n// the fragment shader is called for each pixel\nlet fs =\n varying +\n 'uniform vec2 p;' +\n 'uniform float r;' +\n 'const int I = 500;' +\n 'void main() {' +\n ' vec2 c = p + vPos * r, z = c;' +\n ' float n = 0.0;' +\n ' for (int i = I; i > 0; i --) {' +\n ' if(z.x*z.x+z.y*z.y > 4.0) {' +\n ' n = float(i)/float(I);' +\n ' break;' +\n ' }' +\n ' z = vec2(z.x*z.x-z.y*z.y, 2.0*z.x*z.y) + c;' +\n ' }' +\n ' gl_FragColor = vec4(0.5-cos(n*17.0)/2.0,0.5-cos(n*13.0)/2.0,0.5-cos(n*23.0)/2.0,1.0);' +\n '}';\n\nlet mandel;\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n\n // create and initialize the shader\n mandel = createShader(vs, fs);\n shader(mandel);\n noStroke();\n\n // 'p' is the center point of the Mandelbrot image\n mandel.setUniform('p', [-0.74364388703, 0.13182590421]);\n}\n\nfunction draw() {\n // 'r' is the size of the image in Mandelbrot-space\n mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000))));\n quad(-1, -1, 1, -1, 1, 1, -1, 1);\n}\n\n
    " + ], + "alt": "zooming Mandelbrot set. a colorful, infinitely detailed fractal.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 181, + "description": "

    The shader() function lets the user provide a custom shader\nto fill in shapes in WEBGL mode. Users can create their\nown shaders by loading vertex and fragment shaders with\nloadShader().

    \n", + "itemtype": "method", + "name": "shader", + "chainable": 1, + "params": [ + { + "name": "s", + "description": "

    the desired p5.Shader to use for rendering\nshapes.

    \n", + "type": "p5.Shader", + "optional": true + } + ], + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 212, + "description": "

    This function restores the default shaders in WEBGL mode. Code that runs\nafter resetShader() will not be affected by previously defined\nshaders. Should be run after shader().

    \n", + "itemtype": "method", + "name": "resetShader", + "chainable": 1, + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 225, + "description": "

    Normal material for geometry. You can view all\npossible materials in this\nexample.

    \n", + "itemtype": "method", + "name": "normalMaterial", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(200);\n normalMaterial();\n sphere(40);\n}\n\n
    " + ], + "alt": "Red, green and blue gradient.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 262, + "description": "

    Texture for geometry. You can view other possible materials in this\nexample.

    \n", + "itemtype": "method", + "name": "texture", + "params": [ + { + "name": "tex", + "description": "

    2-dimensional graphics\n to render as texture

    \n", + "type": "p5.Image|p5.MediaElement|p5.Graphics" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n rotateZ(frameCount * 0.01);\n rotateX(frameCount * 0.01);\n rotateY(frameCount * 0.01);\n //pass image as texture\n texture(img);\n box(200, 200, 200);\n}\n\n
    \n\n
    \n\nlet pg;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n pg = createGraphics(200, 200);\n pg.textSize(75);\n}\n\nfunction draw() {\n background(0);\n pg.background(255);\n pg.text('hello!', 0, 100);\n //pass image as texture\n texture(pg);\n rotateX(0.5);\n noStroke();\n plane(50);\n}\n\n
    \n\n
    \n\nlet vid;\nfunction preload() {\n vid = createVideo('assets/fingers.mov');\n vid.hide();\n}\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(0);\n //pass video frame as texture\n texture(vid);\n rect(-40, -40, 80, 80);\n}\n\nfunction mousePressed() {\n vid.loop();\n}\n\n
    " + ], + "alt": "Rotating view of many images umbrella and grid roof on a 3d plane\nblack canvas\nblack canvas", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 359, + "description": "

    Sets the coordinate space for texture mapping. The default mode is IMAGE\nwhich refers to the actual coordinates of the image.\nNORMAL refers to a normalized space of values ranging from 0 to 1.\nThis function only works in WEBGL mode.

    \n

    With IMAGE, if an image is 100 x 200 pixels, mapping the image onto the entire\nsize of a quad would require the points (0,0) (100, 0) (100,200) (0,200).\nThe same mapping in NORMAL is (0,0) (1,0) (1,1) (0,1).

    \n", + "itemtype": "method", + "name": "textureMode", + "params": [ + { + "name": "mode", + "description": "

    either IMAGE or NORMAL

    \n", + "type": "Constant" + } + ], + "example": [ + "\n
    \n\nlet img;\n\nfunction preload() {\n img = loadImage('assets/laDefense.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n texture(img);\n textureMode(NORMAL);\n beginShape();\n vertex(-50, -50, 0, 0);\n vertex(50, -50, 1, 0);\n vertex(50, 50, 1, 1);\n vertex(-50, 50, 0, 1);\n endShape();\n}\n\n
    " + ], + "alt": "the underside of a white umbrella and gridded ceiling above", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 438, + "description": "

    Sets the global texture wrapping mode. This controls how textures behave\nwhen their uv's go outside of the 0 - 1 range. There are three options:\nCLAMP, REPEAT, and MIRROR.

    \n

    CLAMP causes the pixels at the edge of the texture to extend to the bounds\nREPEAT causes the texture to tile repeatedly until reaching the bounds\nMIRROR works similarly to REPEAT but it flips the texture with every new tile

    \n

    REPEAT & MIRROR are only available if the texture\nis a power of two size (128, 256, 512, 1024, etc.).

    \n

    This method will affect all textures in your sketch until a subsequent\ntextureWrap call is made.

    \n

    If only one argument is provided, it will be applied to both the\nhorizontal and vertical axes.

    \n", + "itemtype": "method", + "name": "textureWrap", + "params": [ + { + "name": "wrapX", + "description": "

    either CLAMP, REPEAT, or MIRROR

    \n", + "type": "Constant" + }, + { + "name": "wrapY", + "description": "

    either CLAMP, REPEAT, or MIRROR

    \n", + "type": "Constant", + "optional": true + } + ], + "example": [ + "\n
    \n\nlet img;\nfunction preload() {\n img = loadImage('assets/rockies128.jpg');\n}\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n textureWrap(MIRROR);\n}\n\nfunction draw() {\n background(0);\n\n let dX = mouseX;\n let dY = mouseY;\n\n let u = lerp(1.0, 2.0, dX);\n let v = lerp(1.0, 2.0, dY);\n\n scale(width / 2);\n\n texture(img);\n\n beginShape(TRIANGLES);\n vertex(-1, -1, 0, 0, 0);\n vertex(1, -1, 0, u, 0);\n vertex(1, 1, 0, u, v);\n\n vertex(1, 1, 0, u, v);\n vertex(-1, 1, 0, 0, v);\n vertex(-1, -1, 0, 0, 0);\n endShape();\n}\n\n
    " + ], + "alt": "an image of the rocky mountains repeated in mirrored tiles", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/material.js", + "line": 513, + "description": "

    Ambient material for geometry with a given color. You can view all\npossible materials in this\nexample.

    \n", + "itemtype": "method", + "name": "ambientMaterial", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n noStroke();\n ambientLight(200);\n ambientMaterial(70, 130, 230);\n sphere(40);\n}\n\n
    " + ], + "alt": "radiating light source from top right of canvas", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material", + "overloads": [ + { + "line": 513, + "params": [ + { + "name": "v1", + "description": "

    gray value, red or hue value\n (depending on the current color mode),

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value

    \n", + "type": "Number", + "optional": true + }, + { + "name": "v3", + "description": "

    blue or brightness value

    \n", + "type": "Number", + "optional": true + }, + { + "name": "a", + "description": "

    opacity

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 544, + "params": [ + { + "name": "color", + "description": "

    color, color Array, or CSS color string

    \n", + "type": "Number[]|String|p5.Color" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/webgl/material.js", + "line": 563, + "description": "

    Specular material for geometry with a given color. You can view all\npossible materials in this\nexample.

    \n", + "itemtype": "method", + "name": "specularMaterial", + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n noStroke();\n ambientLight(50);\n pointLight(250, 250, 250, 100, 100, 30);\n specularMaterial(250);\n sphere(40);\n}\n\n
    " + ], + "alt": "diffused radiating light source from top right of canvas", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material", + "overloads": [ + { + "line": 563, + "params": [ + { + "name": "v1", + "description": "

    gray value, red or hue value\n (depending on the current color mode),

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    green or saturation value

    \n", + "type": "Number", + "optional": true + }, + { + "name": "v3", + "description": "

    blue or brightness value

    \n", + "type": "Number", + "optional": true + }, + { + "name": "a", + "description": "

    opacity

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + }, + { + "line": 595, + "params": [ + { + "name": "color", + "description": "

    color Array, or CSS color string

    \n", + "type": "Number[]|String|p5.Color" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "src/webgl/material.js", + "line": 614, + "description": "

    Sets the amount of gloss in the surface of shapes.\nUsed in combination with specularMaterial() in setting\nthe material properties of shapes. The default and minimum value is 1.

    \n", + "itemtype": "method", + "name": "shininess", + "params": [ + { + "name": "shine", + "description": "

    Degree of Shininess.\n Defaults to 1.

    \n", + "type": "Number" + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(0);\n noStroke();\n let locX = mouseX - width / 2;\n let locY = mouseY - height / 2;\n ambientLight(60, 60, 60);\n pointLight(255, 255, 255, locX, locY, 50);\n specularMaterial(250);\n translate(-25, 0, 0);\n shininess(1);\n sphere(20);\n translate(50, 0, 0);\n shininess(20);\n sphere(20);\n}\n\n
    " + ], + "alt": "Shininess on Camera changes position with mouse", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Material" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 15, + "description": "

    Sets the camera position for a 3D sketch. Parameters for this function define\nthe position for the camera, the center of the sketch (where the camera is\npointing), and an up direction (the orientation of the camera).

    \n

    When called with no arguments, this function creates a default camera\nequivalent to\ncamera(0, 0, (height/2.0) / tan(PI*30.0 / 180.0), 0, 0, 0, 0, 1, 0);

    \n", + "itemtype": "method", + "name": "camera", + "params": [ + { + "name": "x", + "description": "

    camera position value on x axis

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    camera position value on y axis

    \n", + "type": "Number", + "optional": true + }, + { + "name": "z", + "description": "

    camera position value on z axis

    \n", + "type": "Number", + "optional": true + }, + { + "name": "centerX", + "description": "

    x coordinate representing center of the sketch

    \n", + "type": "Number", + "optional": true + }, + { + "name": "centerY", + "description": "

    y coordinate representing center of the sketch

    \n", + "type": "Number", + "optional": true + }, + { + "name": "centerZ", + "description": "

    z coordinate representing center of the sketch

    \n", + "type": "Number", + "optional": true + }, + { + "name": "upX", + "description": "

    x component of direction 'up' from camera

    \n", + "type": "Number", + "optional": true + }, + { + "name": "upY", + "description": "

    y component of direction 'up' from camera

    \n", + "type": "Number", + "optional": true + }, + { + "name": "upZ", + "description": "

    z component of direction 'up' from camera

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\nfunction draw() {\n background(204);\n //move the camera away from the plane by a sin wave\n camera(0, 0, 20 + sin(frameCount * 0.01) * 10, 0, 0, 0, 0, 1, 0);\n plane(10, 10);\n}\n\n
    " + ], + "alt": "White square repeatedly grows to fill canvas and then shrinks.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 61, + "description": "

    Sets a perspective projection for the camera in a 3D sketch. This projection\nrepresents depth through foreshortening: objects that are close to the camera\nappear their actual size while those that are further away from the camera\nappear smaller. The parameters to this function define the viewing frustum\n(the truncated pyramid within which objects are seen by the camera) through\nvertical field of view, aspect ratio (usually width/height), and near and far\nclipping planes.

    \n

    When called with no arguments, the defaults\nprovided are equivalent to\nperspective(PI/3.0, width/height, eyeZ/10.0, eyeZ10.0), where eyeZ\nis equal to ((height/2.0) / tan(PI60.0/360.0));

    \n", + "itemtype": "method", + "name": "perspective", + "params": [ + { + "name": "fovy", + "description": "

    camera frustum vertical field of view,\n from bottom to top of view, in angleMode units

    \n", + "type": "Number", + "optional": true + }, + { + "name": "aspect", + "description": "

    camera frustum aspect ratio

    \n", + "type": "Number", + "optional": true + }, + { + "name": "near", + "description": "

    frustum near plane length

    \n", + "type": "Number", + "optional": true + }, + { + "name": "far", + "description": "

    frustum far plane length

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n//drag the mouse to look around!\n//you will see there's a vanishing point\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n perspective(PI / 3.0, width / height, 0.1, 500);\n}\nfunction draw() {\n background(200);\n orbitControl();\n normalMaterial();\n\n rotateX(-0.3);\n rotateY(-0.2);\n translate(0, 0, -50);\n\n push();\n translate(-15, 0, sin(frameCount / 30) * 95);\n box(30);\n pop();\n push();\n translate(15, 0, sin(frameCount / 30 + PI) * 95);\n box(30);\n pop();\n}\n\n
    " + ], + "alt": "two colored 3D boxes move back and forth, rotating as mouse is dragged.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 126, + "description": "

    Sets an orthographic projection for the camera in a 3D sketch and defines a\nbox-shaped viewing frustum within which objects are seen. In this projection,\nall objects with the same dimension appear the same size, regardless of\nwhether they are near or far from the camera. The parameters to this\nfunction specify the viewing frustum where left and right are the minimum and\nmaximum x values, top and bottom are the minimum and maximum y values, and near\nand far are the minimum and maximum z values. If no parameters are given, the\ndefault is used: ortho(-width/2, width/2, -height/2, height/2).

    \n", + "itemtype": "method", + "name": "ortho", + "params": [ + { + "name": "left", + "description": "

    camera frustum left plane

    \n", + "type": "Number", + "optional": true + }, + { + "name": "right", + "description": "

    camera frustum right plane

    \n", + "type": "Number", + "optional": true + }, + { + "name": "bottom", + "description": "

    camera frustum bottom plane

    \n", + "type": "Number", + "optional": true + }, + { + "name": "top", + "description": "

    camera frustum top plane

    \n", + "type": "Number", + "optional": true + }, + { + "name": "near", + "description": "

    camera frustum near plane

    \n", + "type": "Number", + "optional": true + }, + { + "name": "far", + "description": "

    camera frustum far plane

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \n\n//drag the mouse to look around!\n//there's no vanishing point\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n ortho(-width / 2, width / 2, height / 2, -height / 2, 0, 500);\n}\nfunction draw() {\n background(200);\n orbitControl();\n normalMaterial();\n\n rotateX(0.2);\n rotateY(-0.2);\n push();\n translate(-15, 0, sin(frameCount / 30) * 65);\n box(30);\n pop();\n push();\n translate(15, 0, sin(frameCount / 30 + PI) * 65);\n box(30);\n pop();\n}\n\n
    " + ], + "alt": "two 3D boxes move back and forth along same plane, rotating as mouse is dragged.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 187, + "description": "

    Creates a new p5.Camera object and tells the\nrenderer to use that camera.\nReturns the p5.Camera object.

    \n", + "itemtype": "method", + "name": "createCamera", + "return": { + "description": "The newly created camera object.", + "type": "p5.Camera" + }, + "class": "p5", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 298, + "description": "

    Sets a perspective projection for a p5.Camera object and sets parameters\nfor that projection according to perspective()\nsyntax.

    \n", + "itemtype": "method", + "name": "perspective", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 379, + "description": "

    Sets an orthographic projection for a p5.Camera object and sets parameters\nfor that projection according to ortho() syntax.

    \n", + "itemtype": "method", + "name": "ortho", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 486, + "description": "

    Panning rotates the camera view to the left and right.

    \n", + "itemtype": "method", + "name": "pan", + "params": [ + { + "name": "angle", + "description": "

    amount to rotate camera in current\nangleMode units.\nGreater than 0 values rotate counterclockwise (to the left).

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nlet cam;\nlet delta = 0.01;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n // set initial pan angle\n cam.pan(-0.8);\n}\n\nfunction draw() {\n background(200);\n\n // pan camera according to angle 'delta'\n cam.pan(delta);\n\n // every 160 frames, switch direction\n if (frameCount % 160 === 0) {\n delta *= -1;\n }\n\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n
    " + ], + "alt": "camera view pans left and right across a series of rotating 3D boxes.", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 545, + "description": "

    Tilting rotates the camera view up and down.

    \n", + "itemtype": "method", + "name": "tilt", + "params": [ + { + "name": "angle", + "description": "

    amount to rotate camera in current\nangleMode units.\nGreater than 0 values rotate counterclockwise (to the left).

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nlet cam;\nlet delta = 0.01;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n // set initial tilt\n cam.tilt(-0.8);\n}\n\nfunction draw() {\n background(200);\n\n // pan camera according to angle 'delta'\n cam.tilt(delta);\n\n // every 160 frames, switch direction\n if (frameCount % 160 === 0) {\n delta *= -1;\n }\n\n rotateY(frameCount * 0.01);\n translate(0, -100, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n translate(0, 35, 0);\n box(20);\n}\n\n
    " + ], + "alt": "camera view tilts up and down across a series of rotating 3D boxes.", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 603, + "description": "

    Reorients the camera to look at a position in world space.

    \n", + "itemtype": "method", + "name": "lookAt", + "params": [ + { + "name": "x", + "description": "

    x position of a point in world space

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y position of a point in world space

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    z position of a point in world space

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nlet cam;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n}\n\nfunction draw() {\n background(200);\n\n // look at a new random point every 60 frames\n if (frameCount % 60 === 0) {\n cam.lookAt(random(-100, 100), random(-50, 50), 0);\n }\n\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n
    " + ], + "alt": "camera view of rotating 3D cubes changes to look at a new random\npoint every second .", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 670, + "description": "

    Sets a camera's position and orientation. This is equivalent to calling\ncamera() on a p5.Camera object.

    \n", + "itemtype": "method", + "name": "camera", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 751, + "description": "

    Move camera along its local axes while maintaining current camera orientation.

    \n", + "itemtype": "method", + "name": "move", + "params": [ + { + "name": "x", + "description": "

    amount to move along camera's left-right axis

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    amount to move along camera's up-down axis

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    amount to move along camera's forward-backward axis

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\n// see the camera move along its own axes while maintaining its orientation\nlet cam;\nlet delta = 0.5;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n}\n\nfunction draw() {\n background(200);\n\n // move the camera along its local axes\n cam.move(delta, delta, 0);\n\n // every 100 frames, switch direction\n if (frameCount % 150 === 0) {\n delta *= -1;\n }\n\n translate(-10, -10, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n translate(15, 15, 0);\n box(50, 8, 50);\n}\n\n
    " + ], + "alt": "camera view moves along a series of 3D boxes, maintaining the same\norientation throughout the move", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 823, + "description": "

    Set camera position in world-space while maintaining current camera\norientation.

    \n", + "itemtype": "method", + "name": "setPosition", + "params": [ + { + "name": "x", + "description": "

    x position of a point in world space

    \n", + "type": "Number" + }, + { + "name": "y", + "description": "

    y position of a point in world space

    \n", + "type": "Number" + }, + { + "name": "z", + "description": "

    z position of a point in world space

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\n// press '1' '2' or '3' keys to set camera position\n\nlet cam;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n cam = createCamera();\n}\n\nfunction draw() {\n background(200);\n\n // '1' key\n if (keyIsDown(49)) {\n cam.setPosition(30, 0, 80);\n }\n // '2' key\n if (keyIsDown(50)) {\n cam.setPosition(0, 0, 80);\n }\n // '3' key\n if (keyIsDown(51)) {\n cam.setPosition(-30, 0, 80);\n }\n\n box(20);\n}\n\n
    " + ], + "alt": "camera position changes as the user presses keys, altering view of a 3D box", + "class": "p5.Camera", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Camera.js", + "line": 1088, + "description": "

    Sets rendererGL's current camera to a p5.Camera object. Allows switching\nbetween multiple cameras.

    \n", + "itemtype": "method", + "name": "setCamera", + "params": [ + { + "name": "cam", + "description": "

    p5.Camera object

    \n", + "type": "p5.Camera" + } + ], + "example": [ + "\n
    \n\nlet cam1, cam2;\nlet currentCamera;\n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n normalMaterial();\n\n cam1 = createCamera();\n cam2 = createCamera();\n cam2.setPosition(30, 0, 50);\n cam2.lookAt(0, 0, 0);\n cam2.ortho();\n\n // set variable for previously active camera:\n currentCamera = 1;\n}\n\nfunction draw() {\n background(200);\n\n // camera 1:\n cam1.lookAt(0, 0, 0);\n cam1.setPosition(sin(frameCount / 60) * 200, 0, 100);\n\n // every 100 frames, switch between the two cameras\n if (frameCount % 100 === 0) {\n if (currentCamera === 1) {\n setCamera(cam1);\n currentCamera = 0;\n } else {\n setCamera(cam2);\n currentCamera = 1;\n }\n }\n\n drawBoxes();\n}\n\nfunction drawBoxes() {\n rotateX(frameCount * 0.01);\n translate(-100, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n translate(35, 0, 0);\n box(20);\n}\n\n
    " + ], + "alt": "Canvas switches between two camera views, each showing a series of spinning\n3D boxes.", + "class": "p5", + "module": "Lights, Camera", + "submodule": "Camera" + }, + { + "file": "src/webgl/p5.Geometry.js", + "line": 50, + "itemtype": "method", + "name": "computeFaces", + "chainable": 1, + "class": "p5.Geometry", + "module": "Lights, Camera" + }, + { + "file": "src/webgl/p5.Geometry.js", + "line": 92, + "description": "

    computes smooth normals per vertex as an average of each\nface.

    \n", + "itemtype": "method", + "name": "computeNormals", + "chainable": 1, + "class": "p5.Geometry", + "module": "Lights, Camera" + }, + { + "file": "src/webgl/p5.Geometry.js", + "line": 131, + "description": "

    Averages the vertex normals. Used in curved\nsurfaces

    \n", + "itemtype": "method", + "name": "averageNormals", + "chainable": 1, + "class": "p5.Geometry", + "module": "Lights, Camera" + }, + { + "file": "src/webgl/p5.Geometry.js", + "line": 152, + "description": "

    Averages pole normals. Used in spherical primitives

    \n", + "itemtype": "method", + "name": "averagePoleNormals", + "chainable": 1, + "class": "p5.Geometry", + "module": "Lights, Camera" + }, + { + "file": "src/webgl/p5.Geometry.js", + "line": 245, + "description": "

    Modifies all vertices to be centered within the range -100 to 100.

    \n", + "itemtype": "method", + "name": "normalize", + "chainable": 1, + "class": "p5.Geometry", + "module": "Lights, Camera" + }, + { + "file": "src/webgl/p5.RendererGL.js", + "line": 228, + "description": "

    Set attributes for the WebGL Drawing context.\nThis is a way of adjusting how the WebGL\nrenderer works to fine-tune the display and performance.\n

    \nNote that this will reinitialize the drawing context\nif called after the WebGL canvas is made.\n

    \nIf an object is passed as the parameter, all attributes\nnot declared in the object will be set to defaults.\n

    \nThe available attributes are:\n
    \nalpha - indicates if the canvas contains an alpha buffer\ndefault is false\n

    \ndepth - indicates whether the drawing buffer has a depth buffer\nof at least 16 bits - default is true\n

    \nstencil - indicates whether the drawing buffer has a stencil buffer\nof at least 8 bits\n

    \nantialias - indicates whether or not to perform anti-aliasing\ndefault is false\n

    \npremultipliedAlpha - indicates that the page compositor will assume\nthe drawing buffer contains colors with pre-multiplied alpha\ndefault is false\n

    \npreserveDrawingBuffer - if true the buffers will not be cleared and\nand will preserve their values until cleared or overwritten by author\n(note that p5 clears automatically on draw loop)\ndefault is true\n

    \nperPixelLighting - if true, per-pixel lighting will be used in the\nlighting shader.\ndefault is false\n

    \n", + "itemtype": "method", + "name": "setAttributes", + "example": [ + "\n
    \n\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(255);\n push();\n rotateZ(frameCount * 0.02);\n rotateX(frameCount * 0.02);\n rotateY(frameCount * 0.02);\n fill(0, 0, 0);\n box(50);\n pop();\n}\n\n
    \n
    \nNow with the antialias attribute set to true.\n
    \n
    \n\nfunction setup() {\n setAttributes('antialias', true);\n createCanvas(100, 100, WEBGL);\n}\n\nfunction draw() {\n background(255);\n push();\n rotateZ(frameCount * 0.02);\n rotateX(frameCount * 0.02);\n rotateY(frameCount * 0.02);\n fill(0, 0, 0);\n box(50);\n pop();\n}\n\n
    \n\n
    \n\n// press the mouse button to enable perPixelLighting\nfunction setup() {\n createCanvas(100, 100, WEBGL);\n noStroke();\n fill(255);\n}\n\nvar lights = [\n { c: '#f00', t: 1.12, p: 1.91, r: 0.2 },\n { c: '#0f0', t: 1.21, p: 1.31, r: 0.2 },\n { c: '#00f', t: 1.37, p: 1.57, r: 0.2 },\n { c: '#ff0', t: 1.12, p: 1.91, r: 0.7 },\n { c: '#0ff', t: 1.21, p: 1.31, r: 0.7 },\n { c: '#f0f', t: 1.37, p: 1.57, r: 0.7 }\n];\n\nfunction draw() {\n var t = millis() / 1000 + 1000;\n background(0);\n directionalLight(color('#222'), 1, 1, 1);\n\n for (var i = 0; i < lights.length; i++) {\n var light = lights[i];\n pointLight(\n color(light.c),\n p5.Vector.fromAngles(t * light.t, t * light.p, width * light.r)\n );\n }\n\n specularMaterial(255);\n sphere(width * 0.1);\n\n rotateX(t * 0.77);\n rotateY(t * 0.83);\n rotateZ(t * 0.91);\n torus(width * 0.3, width * 0.07, 24, 10);\n}\n\nfunction mousePressed() {\n setAttributes('perPixelLighting', true);\n noStroke();\n fill(255);\n}\nfunction mouseReleased() {\n setAttributes('perPixelLighting', false);\n noStroke();\n fill(255);\n}\n\n
    " + ], + "alt": "a rotating cube with smoother edges", + "class": "p5", + "module": "Rendering", + "submodule": "Rendering", + "overloads": [ + { + "line": 228, + "params": [ + { + "name": "key", + "description": "

    Name of attribute

    \n", + "type": "String" + }, + { + "name": "value", + "description": "

    New value of named attribute

    \n", + "type": "Boolean" + } + ] + }, + { + "line": 367, + "params": [ + { + "name": "obj", + "description": "

    object with key-value pairs

    \n", + "type": "Object" + } + ] + } + ] + }, + { + "file": "src/webgl/p5.Shader.js", + "line": 268, + "description": "

    Wrapper around gl.uniform functions.\nAs we store uniform info in the shader we can use that\nto do type checking on the supplied data and call\nthe appropriate function.

    \n", + "itemtype": "method", + "name": "setUniform", + "chainable": 1, + "params": [ + { + "name": "uniformName", + "description": "

    the name of the uniform in the\nshader program

    \n", + "type": "String" + }, + { + "name": "data", + "description": "

    the data to be associated\nwith that uniform; type varies (could be a single numerical value, array,\nmatrix, or texture / sampler reference)

    \n", + "type": "Object|Number|Boolean|Number[]" + } + ], + "class": "p5.Shader", + "module": "Lights, Camera", + "submodule": "Shaders" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 40, + "description": "

    Searches the page for an element with the given ID, class, or tag name (using the '#' or '.'\nprefixes to specify an ID or class respectively, and none for a tag) and returns it as\na p5.Element. If a class or tag name is given with more than 1 element,\nonly the first element will be returned.\nThe DOM node itself can be accessed with .elt.\nReturns null if none found. You can also specify a container to search within.

    \n", + "itemtype": "method", + "name": "select", + "params": [ + { + "name": "name", + "description": "

    id, class, or tag name of element to search for

    \n", + "type": "String" + }, + { + "name": "container", + "description": "

    id, p5.Element, or\n HTML element to search within

    \n", + "type": "String|p5.Element|HTMLElement", + "optional": true + } + ], + "return": { + "description": "p5.Element containing node found", + "type": "p5.Element|null" + }, + "example": [ + "\n
    \nfunction setup() {\n createCanvas(100, 100);\n //translates canvas 50px down\n select('canvas').position(100, 100);\n}\n
    \n
    \n// these are all valid calls to select()\nvar a = select('#moo');\nvar b = select('#blah', '#myContainer');\nvar c, e;\nif (b) {\n c = select('#foo', b);\n}\nvar d = document.getElementById('beep');\nif (d) {\n e = select('p', d);\n}\n[a, b, c, d, e]; // unused\n
    \n" + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 107, + "description": "

    Searches the page for elements with the given class or tag name (using the '.' prefix\nto specify a class and no prefix for a tag) and returns them as p5.Elements\nin an array.\nThe DOM node itself can be accessed with .elt.\nReturns an empty array if none found.\nYou can also specify a container to search within.

    \n", + "itemtype": "method", + "name": "selectAll", + "params": [ + { + "name": "name", + "description": "

    class or tag name of elements to search for

    \n", + "type": "String" + }, + { + "name": "container", + "description": "

    id, p5.Element, or HTML element to search within

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "Array of p5.Elements containing nodes found", + "type": "p5.Element[]" + }, + "example": [ + "\n
    \nfunction setup() {\n createButton('btn');\n createButton('2nd btn');\n createButton('3rd btn');\n var buttons = selectAll('button');\n\n for (var i = 0; i < buttons.length; i++) {\n buttons[i].size(100, 100);\n }\n}\n
    \n
    \n// these are all valid calls to selectAll()\nvar a = selectAll('.moo');\na = selectAll('div');\na = selectAll('button', '#myContainer');\n\nvar d = select('#container');\na = selectAll('p', d);\n\nvar f = document.getElementById('beep');\na = select('.blah', f);\n\na; // unused\n
    \n" + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 168, + "description": "

    Helper function for select and selectAll

    \n", + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 184, + "description": "

    Helper function for getElement and getElements.

    \n", + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 218, + "description": "

    Removes all elements created by p5, except any canvas / graphics\nelements created by createCanvas or createGraphics.\nEvent handlers are removed, and element is removed from the DOM.

    \n", + "itemtype": "method", + "name": "removeElements", + "example": [ + "\n
    \nfunction setup() {\n createCanvas(100, 100);\n createDiv('this is some text');\n createP('this is a paragraph');\n}\nfunction mousePressed() {\n removeElements(); // this will remove the div and p, not canvas\n}\n
    \n" + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 245, + "description": "

    The .changed() function is called when the value of an\nelement changes.\nThis can be used to attach an element specific event listener.

    \n", + "itemtype": "method", + "name": "changed", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when the value of\n an element changes.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text(\"it's a \" + item + '!', 50, 50);\n}\n
    \n\n
    \nvar checkbox;\nvar cnv;\n\nfunction setup() {\n checkbox = createCheckbox(' fill');\n checkbox.changed(changeFill);\n cnv = createCanvas(100, 100);\n cnv.position(0, 30);\n noFill();\n}\n\nfunction draw() {\n background(200);\n ellipse(50, 50, 50, 50);\n}\n\nfunction changeFill() {\n if (checkbox.checked()) {\n fill(0);\n } else {\n noFill();\n }\n}\n
    " + ], + "alt": "dropdown: pear, kiwi, grape. When selected text \"its a\" + selection shown.", + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 313, + "description": "

    The .input() function is called when any user input is\ndetected with an element. The input event is often used\nto detect keystrokes in a input element, or changes on a\nslider element. This can be used to attach an element specific\nevent listener.

    \n", + "itemtype": "method", + "name": "input", + "params": [ + { + "name": "fxn", + "description": "

    function to be fired when any user input is\n detected within the element.\n if false is passed instead, the previously\n firing function will no longer fire.

    \n", + "type": "Function|Boolean" + } + ], + "chainable": 1, + "example": [ + "\n
    \n// Open your console to see the output\nfunction setup() {\n var inp = createInput('');\n inp.input(myInputEvent);\n}\n\nfunction myInputEvent() {\n console.log('you are typing: ', this.value());\n}\n
    " + ], + "alt": "no display.", + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 348, + "description": "

    Helpers for create methods.

    \n", + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 361, + "description": "

    Creates a <div></div> element in the DOM with given inner HTML.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createDiv", + "params": [ + { + "name": "html", + "description": "

    inner HTML for element created

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \ncreateDiv('this is some text');\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 375, + "description": "

    Creates a <p></p> element in the DOM with given inner HTML. Used\nfor paragraph length text.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createP", + "params": [ + { + "name": "html", + "description": "

    inner HTML for element created

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \ncreateP('this is some text');\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 390, + "description": "

    Creates a <span></span> element in the DOM with given inner HTML.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createSpan", + "params": [ + { + "name": "html", + "description": "

    inner HTML for element created

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \ncreateSpan('this is some text');\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 413, + "description": "

    Creates an <img> element in the DOM with given src and\nalternate text.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createImg", + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \ncreateImg('http://p5js.org/img/asterisk-01.png');\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 413, + "params": [ + { + "name": "src", + "description": "

    src path or url for image

    \n", + "type": "String" + }, + { + "name": "alt", + "description": "

    alternate text to be used if image does not load

    \n", + "type": "String", + "optional": true + }, + { + "name": "successCallback", + "description": "

    callback to be called once image data is loaded

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + } + }, + { + "line": 429, + "params": [ + { + "name": "src", + "description": "", + "type": "String" + }, + { + "name": "successCallback", + "description": "", + "type": "Function" + } + ], + "return": { + "description": "", + "type": "Object|p5.Element" + } + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 463, + "description": "

    Creates an <a></a> element in the DOM for including a hyperlink.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createA", + "params": [ + { + "name": "href", + "description": "

    url of page to link to

    \n", + "type": "String" + }, + { + "name": "html", + "description": "

    inner html of link element to display

    \n", + "type": "String" + }, + { + "name": "target", + "description": "

    target where new link should open,\n could be _blank, _self, _parent, _top.

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \ncreateA('http://p5js.org/', 'this is a link');\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 488, + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 490, + "description": "

    Creates a slider <input></input> element in the DOM.\nUse .size() to set the display length of the slider.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createSlider", + "params": [ + { + "name": "min", + "description": "

    minimum value of the slider

    \n", + "type": "Number" + }, + { + "name": "max", + "description": "

    maximum value of the slider

    \n", + "type": "Number" + }, + { + "name": "value", + "description": "

    default value of the slider

    \n", + "type": "Number", + "optional": true + }, + { + "name": "step", + "description": "

    step size for each tick of the slider (if step is set to 0, the slider will move continuously from the minimum to the maximum value)

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \nvar slider;\nfunction setup() {\n slider = createSlider(0, 255, 100);\n slider.position(10, 10);\n slider.style('width', '80px');\n}\n\nfunction draw() {\n var val = slider.value();\n background(val);\n}\n
    \n\n
    \nvar slider;\nfunction setup() {\n colorMode(HSB);\n slider = createSlider(0, 360, 60, 40);\n slider.position(10, 10);\n slider.style('width', '80px');\n}\n\nfunction draw() {\n var val = slider.value();\n background(val, 100, 100, 1);\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 547, + "description": "

    Creates a <button></button> element in the DOM.\nUse .size() to set the display size of the button.\nUse .mousePressed() to specify behavior on press.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createButton", + "params": [ + { + "name": "label", + "description": "

    label displayed on the button

    \n", + "type": "String" + }, + { + "name": "value", + "description": "

    value of the button

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \nvar button;\nfunction setup() {\n createCanvas(100, 100);\n background(0);\n button = createButton('click me');\n button.position(19, 19);\n button.mousePressed(changeBG);\n}\n\nfunction changeBG() {\n var val = random(255);\n background(val);\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 583, + "description": "

    Creates a checkbox <input></input> element in the DOM.\nCalling .checked() on a checkbox returns if it is checked or not

    \n", + "itemtype": "method", + "name": "createCheckbox", + "params": [ + { + "name": "label", + "description": "

    label displayed after checkbox

    \n", + "type": "String", + "optional": true + }, + { + "name": "value", + "description": "

    value of the checkbox; checked is true, unchecked is false

    \n", + "type": "Boolean", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \nvar checkbox;\n\nfunction setup() {\n checkbox = createCheckbox('label', false);\n checkbox.changed(myCheckedEvent);\n}\n\nfunction myCheckedEvent() {\n if (this.checked()) {\n console.log('Checking!');\n } else {\n console.log('Unchecking!');\n }\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 651, + "description": "

    Creates a dropdown menu <select></select> element in the DOM.\nIt also helps to assign select-box methods to p5.Element when selecting existing select box

    \n", + "itemtype": "method", + "name": "createSelect", + "return": { + "description": "", + "type": "p5.Element" + }, + "example": [ + "\n
    \nvar sel;\n\nfunction setup() {\n textAlign(CENTER);\n background(200);\n sel = createSelect();\n sel.position(10, 10);\n sel.option('pear');\n sel.option('kiwi');\n sel.option('grape');\n sel.changed(mySelectEvent);\n}\n\nfunction mySelectEvent() {\n var item = sel.value();\n background(200);\n text('It is a ' + item + '!', 50, 50);\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 651, + "params": [ + { + "name": "multiple", + "description": "

    true if dropdown should support multiple selections

    \n", + "type": "Boolean", + "optional": true + } + ], + "return": { + "description": "", + "type": "p5.Element" + } + }, + { + "line": 679, + "params": [ + { + "name": "existing", + "description": "

    DOM select element

    \n", + "type": "Object" + } + ], + "return": { + "description": "", + "type": "p5.Element" + } + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 755, + "description": "

    Creates a radio button <input></input> element in the DOM.\nThe .option() method can be used to set options for the radio after it is\ncreated. The .value() method will return the currently selected option.

    \n", + "itemtype": "method", + "name": "createRadio", + "params": [ + { + "name": "divId", + "description": "

    the id and name of the created div and input field respectively

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option('black');\n radio.option('white');\n radio.option('gray');\n radio.style('width', '60px');\n textAlign(CENTER);\n fill(255, 0, 0);\n}\n\nfunction draw() {\n var val = radio.value();\n background(val);\n text(val, width / 2, height / 2);\n}\n
    \n
    \nvar radio;\n\nfunction setup() {\n radio = createRadio();\n radio.option('apple', 1);\n radio.option('bread', 2);\n radio.option('juice', 3);\n radio.style('width', '60px');\n textAlign(CENTER);\n}\n\nfunction draw() {\n background(200);\n var val = radio.value();\n if (val) {\n text('item cost is $' + val, width / 2, height / 2);\n }\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 893, + "description": "

    Creates a colorPicker element in the DOM for color input.\nThe .value() method will return a hex string (#rrggbb) of the color.\nThe .color() method will return a p5.Color object with the current chosen color.

    \n", + "itemtype": "method", + "name": "createColorPicker", + "params": [ + { + "name": "value", + "description": "

    default color of element

    \n", + "type": "String|p5.Color", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \n\nvar inp1, inp2;\nfunction setup() {\n createCanvas(100, 100);\n background('grey');\n inp1 = createColorPicker('#ff0000');\n inp2 = createColorPicker(color('yellow'));\n inp1.input(setShade1);\n inp2.input(setShade2);\n setMidShade();\n}\n\nfunction setMidShade() {\n // Finding a shade between the two\n var commonShade = lerpColor(inp1.color(), inp2.color(), 0.5);\n fill(commonShade);\n rect(20, 20, 60, 60);\n}\n\nfunction setShade1() {\n setMidShade();\n console.log('You are choosing shade 1 to be : ', this.value());\n}\nfunction setShade2() {\n setMidShade();\n console.log('You are choosing shade 2 to be : ', this.value());\n}\n\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 967, + "description": "

    Creates an <input></input> element in the DOM for text input.\nUse .size() to set the display length of the box.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createInput", + "params": [ + { + "name": "value", + "description": "

    default value of the input box

    \n", + "type": "String", + "optional": true + }, + { + "name": "type", + "description": "

    type of text, ie text, password etc. Defaults to text

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \nfunction setup() {\n var inp = createInput('');\n inp.input(myInputEvent);\n}\n\nfunction myInputEvent() {\n console.log('you are typing: ', this.value());\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 997, + "description": "

    Creates an <input></input> element in the DOM of type 'file'.\nThis allows users to select local files for use in a sketch.

    \n", + "itemtype": "method", + "name": "createFileInput", + "params": [ + { + "name": "callback", + "description": "

    callback function for when a file loaded

    \n", + "type": "Function", + "optional": true + }, + { + "name": "multiple", + "description": "

    optional to allow multiple files selected

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created DOM element", + "type": "p5.Element" + }, + "example": [ + "\n
    \nlet input;\nlet img;\n\nfunction setup() {\n input = createFileInput(handleFile);\n input.position(0, 0);\n}\n\nfunction draw() {\n background(255);\n if (img) {\n image(img, 0, 0, width, height);\n }\n}\n\nfunction handleFile(file) {\n print(file);\n if (file.type === 'image') {\n img = createImg(file.data);\n img.hide();\n } else {\n img = null;\n }\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1070, + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1112, + "description": "

    Creates an HTML5 <video> element in the DOM for simple playback\nof audio/video. Shown by default, can be hidden with .hide()\nand drawn into canvas using video(). Appends to the container\nnode if one is specified, otherwise appends to body. The first parameter\ncan be either a single string path to a video file, or an array of string\npaths to different formats of the same video. This is useful for ensuring\nthat your video can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.

    \n", + "itemtype": "method", + "name": "createVideo", + "params": [ + { + "name": "src", + "description": "

    path to a video file, or array of paths for\n supporting different browsers

    \n", + "type": "String|String[]" + }, + { + "name": "callback", + "description": "

    callback function to be called upon\n 'canplaythrough' event fire, that is, when the\n browser can play the media, and estimates that\n enough data has been loaded to play the media\n up to its end without having to stop for\n further buffering of content

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "pointer to video p5.Element", + "type": "p5.MediaElement" + }, + "example": [ + "\n
    \nvar vid;\nfunction setup() {\n noCanvas();\n\n vid = createVideo(\n ['assets/small.mp4', 'assets/small.ogv', 'assets/small.webm'],\n vidLoad\n );\n\n vid.size(100, 100);\n}\n\n// This function is called when the video loads\nfunction vidLoad() {\n vid.loop();\n vid.volume(0);\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1159, + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1161, + "description": "

    Creates a hidden HTML5 <audio> element in the DOM for simple audio\nplayback. Appends to the container node if one is specified,\notherwise appends to body. The first parameter\ncan be either a single string path to a audio file, or an array of string\npaths to different formats of the same audio. This is useful for ensuring\nthat your audio can play across different browsers, as each supports\ndifferent formats. See this\npage for further information about supported formats.

    \n", + "itemtype": "method", + "name": "createAudio", + "params": [ + { + "name": "src", + "description": "

    path to an audio file, or array of paths\n for supporting different browsers

    \n", + "type": "String|String[]", + "optional": true + }, + { + "name": "callback", + "description": "

    callback function to be called upon\n 'canplaythrough' event fire, that is, when the\n browser can play the media, and estimates that\n enough data has been loaded to play the media\n up to its end without having to stop for\n further buffering of content

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "pointer to audio p5.Element", + "type": "p5.MediaElement" + }, + "example": [ + "\n
    \nvar ele;\nfunction setup() {\n ele = createAudio('assets/beat.mp3');\n\n // here we set the element to autoplay\n // The element will play as soon\n // as it is able to do so.\n ele.autoplay(true);\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1199, + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1201, + "itemtype": "property", + "name": "VIDEO", + "type": "String", + "final": 1, + "category": [ + "Constants" + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1207, + "itemtype": "property", + "name": "AUDIO", + "type": "String", + "final": 1, + "category": [ + "Constants" + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1244, + "description": "

    Creates a new HTML5 <video> element that contains the audio/video\nfeed from a webcam. The element is separate from the canvas and is\ndisplayed by default. The element can be hidden using .hide(). The feed\ncan be drawn onto the canvas using image(). The loadedmetadata property can\nbe used to detect when the element has fully loaded (see second example).

    \n

    More specific properties of the feed can be passing in a Constraints object.\nSee the\n W3C\nspec for possible properties. Note that not all of these are supported\nby all browsers.

    \n

    Security note: A new browser security specification requires that getUserMedia,\nwhich is behind createCapture(), only works when you're running the code locally,\nor on HTTPS. Learn more here\nand here.

    ", + "itemtype": "method", + "name": "createCapture", + "params": [ + { + "name": "type", + "description": "

    type of capture, either VIDEO or\n AUDIO if none specified, default both,\n or a Constraints object

    \n", + "type": "String|Constant|Object" + }, + { + "name": "callback", + "description": "

    function to be called once\n stream has loaded

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "capture video p5.Element", + "type": "p5.Element" + }, + "example": [ + "\n
    \nvar capture;\n\nfunction setup() {\n createCanvas(480, 480);\n capture = createCapture(VIDEO);\n capture.hide();\n}\n\nfunction draw() {\n image(capture, 0, 0, width, width * capture.height / capture.width);\n filter(INVERT);\n}\n
    \n
    \nfunction setup() {\n createCanvas(480, 120);\n var constraints = {\n video: {\n mandatory: {\n minWidth: 1280,\n minHeight: 720\n },\n optional: [{ maxFrameRate: 10 }]\n },\n audio: true\n };\n createCapture(constraints, function(stream) {\n console.log(stream);\n });\n}\n
    \n
    \nvar capture;\n\nfunction setup() {\n createCanvas(640, 480);\n capture = createCapture(VIDEO);\n}\nfunction draw() {\n background(0);\n if (capture.loadedmetadata) {\n var c = capture.get(0, 0, 100, 100);\n image(c, 0, 0);\n }\n}\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1381, + "description": "

    Creates element with given tag in the DOM with given content.\nAppends to the container node if one is specified, otherwise\nappends to body.

    \n", + "itemtype": "method", + "name": "createElement", + "params": [ + { + "name": "tag", + "description": "

    tag for the new element

    \n", + "type": "String" + }, + { + "name": "content", + "description": "

    html content to be inserted into the element

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "pointer to p5.Element holding created node", + "type": "p5.Element" + }, + "example": [ + "\n
    \ncreateElement('h2', 'im an h2 p5.element!');\n
    " + ], + "class": "p5", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1407, + "description": "

    Adds specified class to the element.

    \n", + "itemtype": "method", + "name": "addClass", + "params": [ + { + "name": "class", + "description": "

    name of class to add

    \n", + "type": "String" + } + ], + "chainable": 1, + "example": [ + "\n
    \n var div = createDiv('div');\n div.addClass('myClass');\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1432, + "description": "

    Removes specified class from the element.

    \n", + "itemtype": "method", + "name": "removeClass", + "params": [ + { + "name": "class", + "description": "

    name of class to remove

    \n", + "type": "String" + } + ], + "chainable": 1, + "example": [ + "\n
    \n // In this example, a class is set when the div is created\n // and removed when mouse is pressed. This could link up\n // with a CSS style rule to toggle style properties.\nvar div;\nfunction setup() {\n div = createDiv('div');\n div.addClass('myClass');\n }\nfunction mousePressed() {\n div.removeClass('myClass');\n }\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1463, + "description": "

    Checks if specified class already set to element

    \n", + "itemtype": "method", + "name": "hasClass", + "return": { + "description": "a boolean value if element has specified class", + "type": "Boolean" + }, + "params": [ + { + "name": "c", + "description": "

    class name of class to check

    \n", + "type": "String" + } + ], + "example": [ + "\n
    \n var div;\nfunction setup() {\n div = createDiv('div');\n div.addClass('show');\n }\nfunction mousePressed() {\n if (div.hasClass('show')) {\n div.addClass('show');\n } else {\n div.removeClass('show');\n }\n }\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1492, + "description": "

    Toggles element class

    \n", + "itemtype": "method", + "name": "toggleClass", + "params": [ + { + "name": "c", + "description": "

    class name to toggle

    \n", + "type": "String" + } + ], + "chainable": 1, + "example": [ + "\n
    \n var div;\nfunction setup() {\n div = createDiv('div');\n div.addClass('show');\n }\nfunction mousePressed() {\n div.toggleClass('show');\n }\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1525, + "description": "

    Attaches the element as a child to the parent specified.\n Accepts either a string ID, DOM node, or p5.Element.\n If no argument is specified, an array of children DOM nodes is returned.

    \n", + "itemtype": "method", + "name": "child", + "return": { + "description": "an array of child nodes", + "type": "Node[]" + }, + "example": [ + "\n
    \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div0.child(div1); // use p5.Element\n
    \n
    \n var div0 = createDiv('this is the parent');\n var div1 = createDiv('this is the child');\n div1.id('apples');\n div0.child('apples'); // use id\n
    \n
    \n // this example assumes there is a div already on the page\n // with id \"myChildDiv\"\n var div0 = createDiv('this is the parent');\n var elt = document.getElementById('myChildDiv');\n div0.child(elt); // use element from page\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 1525, + "params": [], + "return": { + "description": "an array of child nodes", + "type": "Node[]" + } + }, + { + "line": 1553, + "params": [ + { + "name": "child", + "description": "

    the ID, DOM node, or p5.Element\n to add to the current element

    \n", + "type": "String|p5.Element", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1575, + "description": "

    Centers a p5 Element either vertically, horizontally,\nor both, relative to its parent or according to\nthe body if the Element has no parent. If no argument is passed\nthe Element is aligned both vertically and horizontally.

    \n", + "itemtype": "method", + "name": "center", + "params": [ + { + "name": "align", + "description": "

    passing 'vertical', 'horizontal' aligns element accordingly

    \n", + "type": "String", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \nfunction setup() {\n var div = createDiv('').size(10, 10);\n div.style('background-color', 'orange');\n div.center();\n}\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1629, + "description": "

    If an argument is given, sets the inner HTML of the element,\n replacing any existing html. If true is included as a second\n argument, html is appended instead of replacing existing html.\n If no arguments are given, returns\n the inner HTML of the element.

    \n", + "itemtype": "method", + "name": "html", + "return": { + "description": "the inner HTML of the element", + "type": "String" + }, + "example": [ + "\n
    \n var div = createDiv('').size(100, 100);\n div.html('hi');\n
    \n
    \n var div = createDiv('Hello ').size(100, 100);\n div.html('World', true);\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 1629, + "params": [], + "return": { + "description": "the inner HTML of the element", + "type": "String" + } + }, + { + "line": 1650, + "params": [ + { + "name": "html", + "description": "

    the HTML to be placed inside the element

    \n", + "type": "String", + "optional": true + }, + { + "name": "append", + "description": "

    whether to append HTML to existing

    \n", + "type": "Boolean", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1668, + "description": "

    Sets the position of the element relative to (0, 0) of the\n window. Essentially, sets position:absolute and left and top\n properties of style. If no arguments given returns the x and y position\n of the element in an object.

    \n", + "itemtype": "method", + "name": "position", + "return": { + "description": "the x and y position of the element in an object", + "type": "Object" + }, + "example": [ + "\n
    \n function setup() {\n var cnv = createCanvas(100, 100);\n // positions canvas 50px to the right and 100px\n // below upper left corner of the window\n cnv.position(50, 100);\n }\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 1668, + "params": [], + "return": { + "description": "the x and y position of the element in an object", + "type": "Object" + } + }, + { + "line": 1687, + "params": [ + { + "name": "x", + "description": "

    x-position relative to upper left of window

    \n", + "type": "Number", + "optional": true + }, + { + "name": "y", + "description": "

    y-position relative to upper left of window

    \n", + "type": "Number", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1762, + "description": "

    Sets the given style (css) property (1st arg) of the element with the\ngiven value (2nd arg). If a single argument is given, .style()\nreturns the value of the given property; however, if the single argument\nis given in css syntax ('text-align:center'), .style() sets the css\nappropriately.

    \n", + "itemtype": "method", + "name": "style", + "return": { + "description": "value of property", + "type": "String" + }, + "example": [ + "\n
    \nvar myDiv = createDiv('I like pandas.');\nmyDiv.style('font-size', '18px');\nmyDiv.style('color', '#ff0000');\n
    \n
    \nvar col = color(25, 23, 200, 50);\nvar button = createButton('button');\nbutton.style('background-color', col);\nbutton.position(10, 10);\n
    \n
    \nvar myDiv;\nfunction setup() {\n background(200);\n myDiv = createDiv('I like gray.');\n myDiv.position(20, 20);\n}\n\nfunction draw() {\n myDiv.style('font-size', mouseX + 'px');\n}\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 1762, + "params": [ + { + "name": "property", + "description": "

    property to be set

    \n", + "type": "String" + } + ], + "return": { + "description": "value of property", + "type": "String" + } + }, + { + "line": 1797, + "params": [ + { + "name": "property", + "description": "", + "type": "String" + }, + { + "name": "value", + "description": "

    value to assign to property

    \n", + "type": "String|Number|p5.Color" + } + ], + "chainable": 1, + "return": { + "description": "current value of property, if no value is given as second argument", + "type": "String" + } + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1851, + "description": "

    Adds a new attribute or changes the value of an existing attribute\n on the specified element. If no value is specified, returns the\n value of the given attribute, or null if attribute is not set.

    \n", + "itemtype": "method", + "name": "attribute", + "return": { + "description": "value of attribute", + "type": "String" + }, + "example": [ + "\n
    \n var myDiv = createDiv('I like pandas.');\n myDiv.attribute('align', 'center');\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 1851, + "params": [], + "return": { + "description": "value of attribute", + "type": "String" + } + }, + { + "line": 1866, + "params": [ + { + "name": "attr", + "description": "

    attribute to set

    \n", + "type": "String" + }, + { + "name": "value", + "description": "

    value to assign to attribute

    \n", + "type": "String" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1895, + "description": "

    Removes an attribute on the specified element.

    \n", + "itemtype": "method", + "name": "removeAttribute", + "params": [ + { + "name": "attr", + "description": "

    attribute to remove

    \n", + "type": "String" + } + ], + "chainable": 1, + "example": [ + "\n
    \n var button;\n var checkbox;\nfunction setup() {\n checkbox = createCheckbox('enable', true);\n checkbox.changed(enableButton);\n button = createButton('button');\n button.position(10, 10);\n }\nfunction enableButton() {\n if (this.checked()) {\n // Re-enable the button\n button.removeAttribute('disabled');\n } else {\n // Disable the button\n button.attribute('disabled', '');\n }\n }\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1940, + "description": "

    Either returns the value of the element if no arguments\ngiven, or sets the value of the element.

    \n", + "itemtype": "method", + "name": "value", + "return": { + "description": "value of the element", + "type": "String|Number" + }, + "example": [ + "\n
    \n// gets the value\nvar inp;\nfunction setup() {\n inp = createInput('');\n}\n\nfunction mousePressed() {\n print(inp.value());\n}\n
    \n
    \n// sets the value\nvar inp;\nfunction setup() {\n inp = createInput('myValue');\n}\n\nfunction mousePressed() {\n inp.value('myValue');\n}\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 1940, + "params": [], + "return": { + "description": "value of the element", + "type": "String|Number" + } + }, + { + "line": 1970, + "params": [ + { + "name": "value", + "description": "", + "type": "String|Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 1986, + "description": "

    Shows the current element. Essentially, setting display:block for the style.

    \n", + "itemtype": "method", + "name": "show", + "chainable": 1, + "example": [ + "\n
    \n var div = createDiv('div');\n div.style('display', 'none');\n div.show(); // turns display to block\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2004, + "description": "

    Hides the current element. Essentially, setting display:none for the style.

    \n", + "itemtype": "method", + "name": "hide", + "chainable": 1, + "example": [ + "\n
    \nvar div = createDiv('this is a div');\ndiv.hide();\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2020, + "description": "

    Sets the width and height of the element. AUTO can be used to\n only adjust one dimension at a time. If no arguments are given, it\n returns the width and height of the element in an object. In case of\n elements which need to be loaded, such as images, it is recommended\n to call the function after the element has finished loading.

    \n", + "itemtype": "method", + "name": "size", + "return": { + "description": "the width and height of the element in an object", + "type": "Object" + }, + "example": [ + "\n
    \n let div = createDiv('this is a div');\n div.size(100, 100);\n let img = createImg('assets/laDefense.jpg', () => {\n img.size(10, AUTO);\n });\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 2020, + "params": [], + "return": { + "description": "the width and height of the element in an object", + "type": "Object" + } + }, + { + "line": 2039, + "params": [ + { + "name": "w", + "description": "

    width of the element, either AUTO, or a number

    \n", + "type": "Number|Constant" + }, + { + "name": "h", + "description": "

    height of the element, either AUTO, or a number

    \n", + "type": "Number|Constant", + "optional": true + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2099, + "description": "

    Removes the element and deregisters all listeners.

    \n", + "itemtype": "method", + "name": "remove", + "example": [ + "\n
    \nvar myDiv = createDiv('this is some text');\nmyDiv.remove();\n
    " + ], + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2119, + "description": "

    Registers a callback that gets called every time a file that is\ndropped on the element has been loaded.\np5 will load every dropped file into memory and pass it as a p5.File object to the callback.\nMultiple files dropped at the same time will result in multiple calls to the callback.

    \n

    You can optionally pass a second callback which will be registered to the raw\ndrop event.\nThe callback will thus be provided the original\nDragEvent.\nDropping multiple files at the same time will trigger the second callback once per drop,\nwhereas the first callback will trigger for each loaded file.

    \n", + "itemtype": "method", + "name": "drop", + "params": [ + { + "name": "callback", + "description": "

    callback to receive loaded file, called for each file dropped.

    \n", + "type": "Function" + }, + { + "name": "fxn", + "description": "

    callback triggered once when files are dropped with the drop event.

    \n", + "type": "Function", + "optional": true + } + ], + "chainable": 1, + "example": [ + "\n
    \nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('drop file', width / 2, height / 2);\n c.drop(gotFile);\n}\n\nfunction gotFile(file) {\n background(200);\n text('received file:', width / 2, height / 2);\n text(file.name, width / 2, height / 2 + 50);\n}\n
    \n\n
    \nvar img;\n\nfunction setup() {\n var c = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('drop image', width / 2, height / 2);\n c.drop(gotFile);\n}\n\nfunction draw() {\n if (img) {\n image(img, 0, 0, width, height);\n }\n}\n\nfunction gotFile(file) {\n img = createImg(file.data).hide();\n}\n
    " + ], + "alt": "Canvas turns into whatever image is dragged/dropped onto it.", + "class": "p5.Element", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2253, + "description": "

    Path to the media element source.

    \n", + "itemtype": "property", + "name": "src", + "return": { + "description": "src", + "type": "String" + }, + "example": [ + "\n
    \nvar ele;\n\nfunction setup() {\n background(250);\n\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/beat.mp3');\n\n //We'll set up our example so that\n //when you click on the text,\n //an alert box displays the MediaElement's\n //src field.\n textAlign(CENTER);\n text('Click Me!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n //Show our p5.MediaElement's src field\n alert(ele.src);\n }\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2319, + "description": "

    Play an HTML5 media element.

    \n", + "itemtype": "method", + "name": "play", + "chainable": 1, + "example": [ + "\n
    \nvar ele;\n\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/beat.mp3');\n\n background(250);\n textAlign(CENTER);\n text('Click to Play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n //Here we call the play() function on\n //the p5.MediaElement we created above.\n //This will start the audio sample.\n ele.play();\n\n background(200);\n text('You clicked Play!', width / 2, height / 2);\n }\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2380, + "description": "

    Stops an HTML5 media element (sets current time to zero).

    \n", + "itemtype": "method", + "name": "stop", + "chainable": 1, + "example": [ + "\n
    \n//This example both starts\n//and stops a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/beat.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (sampleIsPlaying) {\n //if the sample is currently playing\n //calling the stop() function on\n //our p5.MediaElement will stop\n //it and reset its current\n //time to 0 (i.e. it will start\n //at the beginning the next time\n //you play it)\n ele.stop();\n\n sampleIsPlaying = false;\n text('Click to play!', width / 2, height / 2);\n } else {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop();\n\n sampleIsPlaying = true;\n text('Click to stop!', width / 2, height / 2);\n }\n }\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2444, + "description": "

    Pauses an HTML5 media element.

    \n", + "itemtype": "method", + "name": "pause", + "chainable": 1, + "example": [ + "\n
    \n//This example both starts\n//and pauses a sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/lucky_dragons.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (sampleIsPlaying) {\n //Calling pause() on our\n //p5.MediaElement will stop it\n //playing, but when we call the\n //loop() or play() functions\n //the sample will start from\n //where we paused it.\n ele.pause();\n\n sampleIsPlaying = false;\n text('Click to resume!', width / 2, height / 2);\n } else {\n //loop our sound element until we\n //call ele.pause() on it.\n ele.loop();\n\n sampleIsPlaying = true;\n text('Click to pause!', width / 2, height / 2);\n }\n }\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2506, + "description": "

    Set 'loop' to true for an HTML5 media element, and starts playing.

    \n", + "itemtype": "method", + "name": "loop", + "chainable": 1, + "example": [ + "\n
    \n//Clicking the canvas will loop\n//the audio sample until the user\n//clicks again to stop it\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n\n//while our audio is playing,\n//this will be set to true\nvar sampleIsLooping = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/lucky_dragons.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to loop!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (!sampleIsLooping) {\n //loop our sound element until we\n //call ele.stop() on it.\n ele.loop();\n\n sampleIsLooping = true;\n text('Click to stop!', width / 2, height / 2);\n } else {\n ele.stop();\n\n sampleIsLooping = false;\n text('Click to loop!', width / 2, height / 2);\n }\n }\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2562, + "description": "

    Set 'loop' to false for an HTML5 media element. Element will stop\nwhen it reaches the end.

    \n", + "itemtype": "method", + "name": "noLoop", + "chainable": 1, + "example": [ + "\n
    \n//This example both starts\n//and stops loop of sound sample\n//when the user clicks the canvas\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\n//while our audio is playing,\n//this will be set to true\nvar sampleIsPlaying = false;\n\nfunction setup() {\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/beat.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to play!', width / 2, height / 2);\n}\n\nfunction mouseClicked() {\n //here we test if the mouse is over the\n //canvas element when it's clicked\n if (mouseX >= 0 && mouseX <= width && mouseY >= 0 && mouseY <= height) {\n background(200);\n\n if (sampleIsPlaying) {\n ele.noLoop();\n text('No more Loops!', width / 2, height / 2);\n } else {\n ele.loop();\n sampleIsPlaying = true;\n text('Click to stop looping!', width / 2, height / 2);\n }\n }\n}\n
    \n" + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2614, + "description": "

    Set HTML5 media element to autoplay or not.

    \n", + "itemtype": "method", + "name": "autoplay", + "params": [ + { + "name": "autoplay", + "description": "

    whether the element should autoplay

    \n", + "type": "Boolean" + } + ], + "chainable": 1, + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2626, + "description": "

    Sets volume for this HTML5 media element. If no argument is given,\nreturns the current volume.

    \n", + "itemtype": "method", + "name": "volume", + "return": { + "description": "current volume", + "type": "Number" + }, + "example": [ + "\n
    \nvar ele;\nfunction setup() {\n // p5.MediaElement objects are usually created\n // by calling the createAudio(), createVideo(),\n // and createCapture() functions.\n // In this example we create\n // a new p5.MediaElement via createAudio().\n ele = createAudio('assets/lucky_dragons.mp3');\n background(250);\n textAlign(CENTER);\n text('Click to Play!', width / 2, height / 2);\n}\nfunction mouseClicked() {\n // Here we call the volume() function\n // on the sound element to set its volume\n // Volume must be between 0.0 and 1.0\n ele.volume(0.2);\n ele.play();\n background(200);\n text('You clicked Play!', width / 2, height / 2);\n}\n
    \n
    \nvar audio;\nvar counter = 0;\n\nfunction loaded() {\n audio.play();\n}\n\nfunction setup() {\n audio = createAudio('assets/lucky_dragons.mp3', loaded);\n textAlign(CENTER);\n}\n\nfunction draw() {\n if (counter === 0) {\n background(0, 255, 0);\n text('volume(0.9)', width / 2, height / 2);\n } else if (counter === 1) {\n background(255, 255, 0);\n text('volume(0.5)', width / 2, height / 2);\n } else if (counter === 2) {\n background(255, 0, 0);\n text('volume(0.1)', width / 2, height / 2);\n }\n}\n\nfunction mousePressed() {\n counter++;\n if (counter === 0) {\n audio.volume(0.9);\n } else if (counter === 1) {\n audio.volume(0.5);\n } else if (counter === 2) {\n audio.volume(0.1);\n } else {\n counter = 0;\n audio.volume(0.9);\n }\n}\n\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 2626, + "params": [], + "return": { + "description": "current volume", + "type": "Number" + } + }, + { + "line": 2699, + "params": [ + { + "name": "val", + "description": "

    volume between 0.0 and 1.0

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2712, + "description": "

    If no arguments are given, returns the current playback speed of the\nelement. The speed parameter sets the speed where 2.0 will play the\nelement twice as fast, 0.5 will play at half the speed, and -1 will play\nthe element in normal speed in reverse.(Note that not all browsers support\nbackward playback and even if they do, playback might not be smooth.)

    \n", + "itemtype": "method", + "name": "speed", + "return": { + "description": "current playback speed of the element", + "type": "Number" + }, + "example": [ + "\n
    \n//Clicking the canvas will loop\n//the audio sample until the user\n//clicks again to stop it\n\n//We will store the p5.MediaElement\n//object in here\nvar ele;\nvar button;\n\nfunction setup() {\n createCanvas(710, 400);\n //Here we create a p5.MediaElement object\n //using the createAudio() function.\n ele = createAudio('assets/beat.mp3');\n ele.loop();\n background(200);\n\n button = createButton('2x speed');\n button.position(100, 68);\n button.mousePressed(twice_speed);\n\n button = createButton('half speed');\n button.position(200, 68);\n button.mousePressed(half_speed);\n\n button = createButton('reverse play');\n button.position(300, 68);\n button.mousePressed(reverse_speed);\n\n button = createButton('STOP');\n button.position(400, 68);\n button.mousePressed(stop_song);\n\n button = createButton('PLAY!');\n button.position(500, 68);\n button.mousePressed(play_speed);\n}\n\nfunction twice_speed() {\n ele.speed(2);\n}\n\nfunction half_speed() {\n ele.speed(0.5);\n}\n\nfunction reverse_speed() {\n ele.speed(-1);\n}\n\nfunction stop_song() {\n ele.stop();\n}\n\nfunction play_speed() {\n ele.play();\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 2712, + "params": [], + "return": { + "description": "current playback speed of the element", + "type": "Number" + } + }, + { + "line": 2783, + "params": [ + { + "name": "speed", + "description": "

    speed multiplier for element playback

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2800, + "description": "

    If no arguments are given, returns the current time of the element.\nIf an argument is given the current time of the element is set to it.

    \n", + "itemtype": "method", + "name": "time", + "return": { + "description": "current time (in seconds)", + "type": "Number" + }, + "example": [ + "\n
    \nvar ele;\nvar beginning = true;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/lucky_dragons.mp3');\n background(250);\n textAlign(CENTER);\n text('start at beginning', width / 2, height / 2);\n}\n\n// this function fires with click anywhere\nfunction mousePressed() {\n if (beginning === true) {\n // here we start the sound at the beginning\n // time(0) is not necessary here\n // as this produces the same result as\n // play()\n ele.play().time(0);\n background(200);\n text('jump 2 sec in', width / 2, height / 2);\n beginning = false;\n } else {\n // here we jump 2 seconds into the sound\n ele.play().time(2);\n background(250);\n text('start at beginning', width / 2, height / 2);\n beginning = true;\n }\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom", + "overloads": [ + { + "line": 2800, + "params": [], + "return": { + "description": "current time (in seconds)", + "type": "Number" + } + }, + { + "line": 2845, + "params": [ + { + "name": "time", + "description": "

    time to jump to (in seconds)

    \n", + "type": "Number" + } + ], + "chainable": 1 + } + ] + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2859, + "description": "

    Returns the duration of the HTML5 media element.

    \n", + "itemtype": "method", + "name": "duration", + "return": { + "description": "duration", + "type": "Number" + }, + "example": [ + "\n
    \nvar ele;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n //In this example we create\n //a new p5.MediaElement via createAudio().\n ele = createAudio('assets/doorbell.mp3');\n background(250);\n textAlign(CENTER);\n text('Click to know the duration!', 10, 25, 70, 80);\n}\nfunction mouseClicked() {\n ele.play();\n background(200);\n //ele.duration dislpays the duration\n text(ele.duration() + ' seconds', width / 2, height / 2);\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 2998, + "description": "

    Schedule an event to be called when the audio or video\nelement reaches the end. If the element is looping,\nthis will not be called. The element is passed in\nas the argument to the onended callback.

    \n", + "itemtype": "method", + "name": "onended", + "params": [ + { + "name": "callback", + "description": "

    function to call when the\n soundfile has ended. The\n media element will be passed\n in as the argument to the\n callback.

    \n", + "type": "Function" + } + ], + "chainable": 1, + "example": [ + "\n
    \nfunction setup() {\n var audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n audioEl.onended(sayDone);\n}\n\nfunction sayDone(elt) {\n alert('done playing ' + elt.src);\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3029, + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3031, + "description": "

    Send the audio output of this element to a specified audioNode or\np5.sound object. If no element is provided, connects to p5's master\noutput. That connection is established when this method is first called.\nAll connections are removed by the .disconnect() method.

    \n

    This method is meant to be used with the p5.sound.js addon library.

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "audioNode", + "description": "

    AudioNode from the Web Audio API,\nor an object from the p5.sound library

    \n", + "type": "AudioNode|Object" + } + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3080, + "description": "

    Disconnect all Web Audio routing, including to master output.\nThis is useful if you want to re-route the output through\naudio effects, for example.

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3095, + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3097, + "description": "

    Show the default MediaElement controls, as determined by the web browser.

    \n", + "itemtype": "method", + "name": "showControls", + "example": [ + "\n
    \nvar ele;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n //In this example we create\n //a new p5.MediaElement via createAudio()\n ele = createAudio('assets/lucky_dragons.mp3');\n background(200);\n textAlign(CENTER);\n text('Click to Show Controls!', 10, 25, 70, 80);\n}\nfunction mousePressed() {\n ele.showControls();\n background(200);\n text('Controls Shown', width / 2, height / 2);\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3128, + "description": "

    Hide the default mediaElement controls.

    \n", + "itemtype": "method", + "name": "hideControls", + "example": [ + "\n
    \nvar ele;\nfunction setup() {\n //p5.MediaElement objects are usually created\n //by calling the createAudio(), createVideo(),\n //and createCapture() functions.\n //In this example we create\n //a new p5.MediaElement via createAudio()\n ele = createAudio('assets/lucky_dragons.mp3');\n ele.showControls();\n background(200);\n textAlign(CENTER);\n text('Click to hide Controls!', 10, 25, 70, 80);\n}\nfunction mousePressed() {\n ele.hideControls();\n background(200);\n text('Controls hidden', width / 2, height / 2);\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3157, + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3168, + "description": "

    Schedule events to trigger every time a MediaElement\n(audio/video) reaches a playback cue point.

    \n

    Accepts a callback function, a time (in seconds) at which to trigger\nthe callback, and an optional parameter for the callback.

    \n

    Time will be passed as the first parameter to the callback function,\nand param will be the second parameter.

    \n", + "itemtype": "method", + "name": "addCue", + "params": [ + { + "name": "time", + "description": "

    Time in seconds, relative to this media\n element's playback. For example, to trigger\n an event every time playback reaches two\n seconds, pass in the number 2. This will be\n passed as the first parameter to\n the callback function.

    \n", + "type": "Number" + }, + { + "name": "callback", + "description": "

    Name of a function that will be\n called at the given time. The callback will\n receive time and (optionally) param as its\n two parameters.

    \n", + "type": "Function" + }, + { + "name": "value", + "description": "

    An object to be passed as the\n second parameter to the\n callback function.

    \n", + "type": "Object", + "optional": true + } + ], + "return": { + "description": "id ID of this cue,\n useful for removeCue(id)", + "type": "Number" + }, + "example": [ + "\n
    \n//\n//\nfunction setup() {\n noCanvas();\n\n var audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n\n // schedule three calls to changeBackground\n audioEl.addCue(0.5, changeBackground, color(255, 0, 0));\n audioEl.addCue(1.0, changeBackground, color(0, 255, 0));\n audioEl.addCue(2.5, changeBackground, color(0, 0, 255));\n audioEl.addCue(3.0, changeBackground, color(0, 255, 255));\n audioEl.addCue(4.2, changeBackground, color(255, 255, 0));\n audioEl.addCue(5.0, changeBackground, color(255, 255, 0));\n}\n\nfunction changeBackground(val) {\n background(val);\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3232, + "description": "

    Remove a callback based on its ID. The ID is returned by the\naddCue method.

    \n", + "itemtype": "method", + "name": "removeCue", + "params": [ + { + "name": "id", + "description": "

    ID of the cue, as returned by addCue

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \nvar audioEl, id1, id2;\nfunction setup() {\n background(255, 255, 255);\n audioEl = createAudio('assets/beat.mp3');\n audioEl.showControls();\n // schedule five calls to changeBackground\n id1 = audioEl.addCue(0.5, changeBackground, color(255, 0, 0));\n audioEl.addCue(1.0, changeBackground, color(0, 255, 0));\n audioEl.addCue(2.5, changeBackground, color(0, 0, 255));\n audioEl.addCue(3.0, changeBackground, color(0, 255, 255));\n id2 = audioEl.addCue(4.2, changeBackground, color(255, 255, 0));\n text('Click to remove first and last Cue!', 10, 25, 70, 80);\n}\nfunction mousePressed() {\n audioEl.removeCue(id1);\n audioEl.removeCue(id2);\n}\nfunction changeBackground(val) {\n background(val);\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3274, + "description": "

    Remove all of the callbacks that had originally been scheduled\nvia the addCue method.

    \n", + "itemtype": "method", + "name": "clearCues", + "params": [ + { + "name": "id", + "description": "

    ID of the cue, as returned by addCue

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \nvar audioEl;\nfunction setup() {\n background(255, 255, 255);\n audioEl = createAudio('assets/beat.mp3');\n //Show the default MediaElement controls, as determined by the web browser\n audioEl.showControls();\n // schedule calls to changeBackground\n background(200);\n text('Click to change Cue!', 10, 25, 70, 80);\n audioEl.addCue(0.5, changeBackground, color(255, 0, 0));\n audioEl.addCue(1.0, changeBackground, color(0, 255, 0));\n audioEl.addCue(2.5, changeBackground, color(0, 0, 255));\n audioEl.addCue(3.0, changeBackground, color(0, 255, 255));\n audioEl.addCue(4.2, changeBackground, color(255, 255, 0));\n}\nfunction mousePressed() {\n // here we clear the scheduled callbacks\n audioEl.clearCues();\n // then we add some more callbacks\n audioEl.addCue(1, changeBackground, color(2, 2, 2));\n audioEl.addCue(3, changeBackground, color(255, 255, 0));\n}\nfunction changeBackground(val) {\n background(val);\n}\n
    " + ], + "class": "p5.MediaElement", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3340, + "description": "

    Underlying File object. All normal File methods can be called on this.

    \n", + "itemtype": "property", + "name": "file", + "class": "p5.File", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3352, + "description": "

    File type (image, text, etc.)

    \n", + "itemtype": "property", + "name": "type", + "class": "p5.File", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3358, + "description": "

    File subtype (usually the file extension jpg, png, xml, etc.)

    \n", + "itemtype": "property", + "name": "subtype", + "class": "p5.File", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3364, + "description": "

    File name

    \n", + "itemtype": "property", + "name": "name", + "class": "p5.File", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3370, + "description": "

    File size

    \n", + "itemtype": "property", + "name": "size", + "class": "p5.File", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.dom.js", + "line": 3377, + "description": "

    URL string containing image data.

    \n", + "itemtype": "property", + "name": "data", + "class": "p5.File", + "module": "p5.dom", + "submodule": "p5.dom" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 46, + "description": "

    p5.sound \nhttps://p5js.org/reference/#/libraries/p5.sound

    \n

    From the Processing Foundation and contributors\nhttps://github.com/processing/p5.js-sound/graphs/contributors

    \n

    MIT License (MIT)\nhttps://github.com/processing/p5.js-sound/blob/master/LICENSE

    \n

    Some of the many audio libraries & resources that inspire p5.sound:

    \n\n", + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 214, + "description": "

    Determine which filetypes are supported (inspired by buzz.js)\nThe audio element (el) will only be used to test browser support for various audio formats

    \n", + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 363, + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 740, + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 810, + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1005, + "description": "

    Returns the Audio Context for this sketch. Useful for users\nwho would like to dig deeper into the Web Audio API\n.

    \n\n

    Some browsers require users to startAudioContext\nwith a user gesture, such as touchStarted in the example below.

    ", + "itemtype": "method", + "name": "getAudioContext", + "return": { + "description": "AudioContext for this sketch", + "type": "Object" + }, + "example": [ + "\n
    \n function draw() {\n background(255);\n textAlign(CENTER);\n\n if (getAudioContext().state !== 'running') {\n text('click to start audio', width/2, height/2);\n } else {\n text('audio is enabled', width/2, height/2);\n }\n }\n\n function touchStarted() {\n if (getAudioContext().state !== 'running') {\n getAudioContext().resume();\n }\n var synth = new p5.MonoSynth();\n synth.play('A4', 0.5, 0, 0.2);\n }\n\n
    " + ], + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1042, + "description": "

    It is a good practice to give users control over starting audio playback.\nThis practice is enforced by Google Chrome's autoplay policy as of r70\n(info), iOS Safari, and other browsers.\n

    \n\n

    \nuserStartAudio() starts the Audio Context on a user gesture. It utilizes\nthe StartAudioContext library by\nYotam Mann (MIT Licence, 2016). Read more at https://github.com/tambien/StartAudioContext.\n

    \n\n

    Starting the audio context on a user gesture can be as simple as userStartAudio().\nOptional parameters let you decide on a specific element that will start the audio context,\nand/or call a function once the audio context is started.

    ", + "params": [ + { + "name": "element(s)", + "description": "

    This argument can be an Element,\n Selector String, NodeList, p5.Element,\n jQuery Element, or an Array of any of those.

    \n", + "type": "Element|Array", + "optional": true + }, + { + "name": "callback", + "description": "

    Callback to invoke when the AudioContext has started

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "Returns a Promise which is resolved when\n the AudioContext state is 'running'", + "type": "Promise" + }, + "itemtype": "method", + "name": "userStartAudio", + "example": [ + "\n
    \nfunction setup() {\n var myDiv = createDiv('click to start audio');\n myDiv.position(0, 0);\n\n var mySynth = new p5.MonoSynth();\n\n // This won't play until the context has started\n mySynth.play('A6');\n\n // Start the audio context on a click/touch event\n userStartAudio().then(function() {\n myDiv.remove();\n });\n}\n
    " + ], + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1099, + "description": "

    Master contains AudioContext and the master sound output.

    \n", + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1132, + "description": "

    Returns a number representing the master amplitude (volume) for sound\nin this sketch.

    \n", + "itemtype": "method", + "name": "getMasterVolume", + "return": { + "description": "Master amplitude (volume) for sound in this sketch.\n Should be between 0.0 (silence) and 1.0.", + "type": "Number" + }, + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1143, + "description": "

    Scale the output of all sound in this sketch

    \nScaled between 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Envelope class.\n\nAlternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.\n\n

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

    \n\n

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

    ", + "itemtype": "method", + "name": "masterVolume", + "params": [ + { + "name": "volume", + "description": "

    Volume (amplitude) between 0.0\n and 1.0 or modulating signal/oscillator

    \n", + "type": "Number|Object" + }, + { + "name": "rampTime", + "description": "

    Fade for t seconds

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    Schedule this event to happen at\n t seconds in the future

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1185, + "description": "

    p5.soundOut is the p5.sound master output. It sends output to\nthe destination of this window's web audio context. It contains\nWeb Audio API nodes including a dyanmicsCompressor (.limiter),\nand Gain Nodes for .input and .output.

    \n", + "itemtype": "property", + "name": "soundOut", + "type": "Object", + "class": "p5.sound", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1210, + "class": "p5", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1213, + "description": "

    Returns a number representing the sample rate, in samples per second,\nof all sound objects in this audio context. It is determined by the\nsampling rate of your operating system's sound card, and it is not\ncurrently possile to change.\nIt is often 44100, or twice the range of human hearing.

    \n", + "itemtype": "method", + "name": "sampleRate", + "return": { + "description": "samplerate samples per second", + "type": "Number" + }, + "class": "p5", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1226, + "description": "

    Returns the closest MIDI note value for\na given frequency.

    \n", + "itemtype": "method", + "name": "freqToMidi", + "params": [ + { + "name": "frequency", + "description": "

    A freqeuncy, for example, the "A"\n above Middle C is 440Hz

    \n", + "type": "Number" + } + ], + "return": { + "description": "MIDI note value", + "type": "Number" + }, + "class": "p5", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1240, + "description": "

    Returns the frequency value of a MIDI note value.\nGeneral MIDI treats notes as integers where middle C\nis 60, C# is 61, D is 62 etc. Useful for generating\nmusical frequencies with oscillators.

    \n", + "itemtype": "method", + "name": "midiToFreq", + "params": [ + { + "name": "midiNote", + "description": "

    The number of a MIDI note

    \n", + "type": "Number" + } + ], + "return": { + "description": "Frequency value of the given MIDI note", + "type": "Number" + }, + "example": [ + "\n
    \nvar notes = [60, 64, 67, 72];\nvar i = 0;\n\nfunction setup() {\n osc = new p5.Oscillator('Triangle');\n osc.start();\n frameRate(1);\n}\n\nfunction draw() {\n var freq = midiToFreq(notes[i]);\n osc.freq(freq);\n i++;\n if (i >= notes.length){\n i = 0;\n }\n}\n
    " + ], + "class": "p5", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1302, + "description": "

    List the SoundFile formats that you will include. LoadSound\nwill search your directory for these extensions, and will pick\na format that is compatable with the client's web browser.\nHere is a free online file\nconverter.

    \n", + "itemtype": "method", + "name": "soundFormats", + "params": [ + { + "name": "formats", + "description": "

    i.e. 'mp3', 'wav', 'ogg'

    \n", + "type": "String", + "optional": true, + "multiple": true + } + ], + "example": [ + "\n
    \nfunction preload() {\n // set the global sound formats\n soundFormats('mp3', 'ogg');\n\n // load either beatbox.mp3, or .ogg, depending on browser\n mySound = loadSound('assets/beatbox.mp3');\n}\n\nfunction setup() {\n mySound.play();\n}\n
    " + ], + "class": "p5", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1415, + "description": "

    Used by Osc and Envelope to chain signal math

    \n", + "class": "p5", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1763, + "description": "

    loadSound() returns a new p5.SoundFile from a specified\npath. If called during preload(), the p5.SoundFile will be ready\nto play in time for setup() and draw(). If called outside of\npreload, the p5.SoundFile will not be ready immediately, so\nloadSound accepts a callback as the second parameter. Using a\n\nlocal server is recommended when loading external files.

    \n", + "itemtype": "method", + "name": "loadSound", + "params": [ + { + "name": "path", + "description": "

    Path to the sound file, or an array with\n paths to soundfiles in multiple formats\n i.e. ['sound.ogg', 'sound.mp3'].\n Alternately, accepts an object: either\n from the HTML5 File API, or a p5.File.

    \n", + "type": "String|Array" + }, + { + "name": "successCallback", + "description": "

    Name of a function to call once file loads

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    Name of a function to call if there is\n an error loading the file.

    \n", + "type": "Function", + "optional": true + }, + { + "name": "whileLoading", + "description": "

    Name of a function to call while file is loading.\n This function will receive the percentage loaded\n so far, from 0.0 to 1.0.

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "Returns a p5.SoundFile", + "type": "SoundFile" + }, + "example": [ + "\n
    \nfunction preload() {\n mySound = loadSound('assets/doorbell.mp3');\n}\n\nfunction setup() {\n mySound.setVolume(0.1);\n mySound.play();\n}\n
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1919, + "description": "

    Returns true if the sound file finished loading successfully.

    \n", + "itemtype": "method", + "name": "isLoaded", + "return": { + "description": "", + "type": "Boolean" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 1932, + "description": "

    Play the p5.SoundFile

    \n", + "itemtype": "method", + "name": "play", + "params": [ + { + "name": "startTime", + "description": "

    (optional) schedule playback to start (in seconds from now).

    \n", + "type": "Number", + "optional": true + }, + { + "name": "rate", + "description": "

    (optional) playback rate

    \n", + "type": "Number", + "optional": true + }, + { + "name": "amp", + "description": "

    (optional) amplitude (volume)\n of playback

    \n", + "type": "Number", + "optional": true + }, + { + "name": "cueStart", + "description": "

    (optional) cue start time in seconds

    \n", + "type": "Number", + "optional": true + }, + { + "name": "duration", + "description": "

    (optional) duration of playback in seconds

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2022, + "description": "

    p5.SoundFile has two play modes: restart and\nsustain. Play Mode determines what happens to a\np5.SoundFile if it is triggered while in the middle of playback.\nIn sustain mode, playback will continue simultaneous to the\nnew playback. In restart mode, play() will stop playback\nand start over. With untilDone, a sound will play only if it's\nnot already playing. Sustain is the default mode.

    \n", + "itemtype": "method", + "name": "playMode", + "params": [ + { + "name": "str", + "description": "

    'restart' or 'sustain' or 'untilDone'

    \n", + "type": "String" + } + ], + "example": [ + "\n
    \nvar mySound;\nfunction preload(){\n mySound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\nfunction mouseClicked() {\n mySound.playMode('sustain');\n mySound.play();\n}\nfunction keyPressed() {\n mySound.playMode('restart');\n mySound.play();\n}\n\n
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2066, + "description": "

    Pauses a file that is currently playing. If the file is not\nplaying, then nothing will happen.

    \n

    After pausing, .play() will resume from the paused\nposition.\nIf p5.SoundFile had been set to loop before it was paused,\nit will continue to loop after it is unpaused with .play().

    \n", + "itemtype": "method", + "name": "pause", + "params": [ + { + "name": "startTime", + "description": "

    (optional) schedule event to occur\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar soundFile;\n\nfunction preload() {\n soundFormats('ogg', 'mp3');\n soundFile = loadSound('assets/Damscray_-_Dancing_Tiger_02.mp3');\n}\nfunction setup() {\n background(0, 255, 0);\n soundFile.setVolume(0.1);\n soundFile.loop();\n}\nfunction keyTyped() {\n if (key == 'p') {\n soundFile.pause();\n background(255, 0, 0);\n }\n}\n\nfunction keyReleased() {\n if (key == 'p') {\n soundFile.play();\n background(0, 255, 0);\n }\n}\n\n
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2122, + "description": "

    Loop the p5.SoundFile. Accepts optional parameters to set the\nplayback rate, playback volume, loopStart, loopEnd.

    \n", + "itemtype": "method", + "name": "loop", + "params": [ + { + "name": "startTime", + "description": "

    (optional) schedule event to occur\n seconds from now

    \n", + "type": "Number", + "optional": true + }, + { + "name": "rate", + "description": "

    (optional) playback rate

    \n", + "type": "Number", + "optional": true + }, + { + "name": "amp", + "description": "

    (optional) playback volume

    \n", + "type": "Number", + "optional": true + }, + { + "name": "cueLoopStart", + "description": "

    (optional) startTime in seconds

    \n", + "type": "Number", + "optional": true + }, + { + "name": "duration", + "description": "

    (optional) loop duration in seconds

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2138, + "description": "

    Set a p5.SoundFile's looping flag to true or false. If the sound\nis currently playing, this change will take effect when it\nreaches the end of the current playback.

    \n", + "itemtype": "method", + "name": "setLoop", + "params": [ + { + "name": "Boolean", + "description": "

    set looping to true or false

    \n", + "type": "Boolean" + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2159, + "description": "

    Returns 'true' if a p5.SoundFile is currently looping and playing, 'false' if not.

    \n", + "itemtype": "method", + "name": "isLooping", + "return": { + "description": "", + "type": "Boolean" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2174, + "description": "

    Returns true if a p5.SoundFile is playing, false if not (i.e.\npaused or stopped).

    \n", + "itemtype": "method", + "name": "isPlaying", + "return": { + "description": "", + "type": "Boolean" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2184, + "description": "

    Returns true if a p5.SoundFile is paused, false if not (i.e.\nplaying or stopped).

    \n", + "itemtype": "method", + "name": "isPaused", + "return": { + "description": "", + "type": "Boolean" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2194, + "description": "

    Stop soundfile playback.

    \n", + "itemtype": "method", + "name": "stop", + "params": [ + { + "name": "startTime", + "description": "

    (optional) schedule event to occur\n in seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2239, + "description": "

    Multiply the output volume (amplitude) of a sound file\nbetween 0.0 (silence) and 1.0 (full volume).\n1.0 is the maximum amplitude of a digital sound, so multiplying\nby greater than 1.0 may cause digital distortion. To\nfade, provide a rampTime parameter. For more\ncomplex fades, see the Envelope class.

    \n

    Alternately, you can pass in a signal source such as an\noscillator to modulate the amplitude with an audio signal.

    \n", + "itemtype": "method", + "name": "setVolume", + "params": [ + { + "name": "volume", + "description": "

    Volume (amplitude) between 0.0\n and 1.0 or modulating signal/oscillator

    \n", + "type": "Number|Object" + }, + { + "name": "rampTime", + "description": "

    Fade for t seconds

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    Schedule this event to happen at\n t seconds in the future

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2280, + "description": "

    Set the stereo panning of a p5.sound object to\na floating point number between -1.0 (left) and 1.0 (right).\nDefault is 0.0 (center).

    \n", + "itemtype": "method", + "name": "pan", + "params": [ + { + "name": "panValue", + "description": "

    Set the stereo panner

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \n\n var ball = {};\n var soundFile;\n\n function preload() {\n soundFormats('ogg', 'mp3');\n soundFile = loadSound('assets/beatbox.mp3');\n }\n\n function draw() {\n background(0);\n ball.x = constrain(mouseX, 0, width);\n ellipse(ball.x, height/2, 20, 20)\n }\n\n function mousePressed(){\n // map the ball's x location to a panning degree\n // between -1.0 (left) and 1.0 (right)\n var panning = map(ball.x, 0., width,-1.0, 1.0);\n soundFile.pan(panning);\n soundFile.play();\n }\n
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2319, + "description": "

    Returns the current stereo pan position (-1.0 to 1.0)

    \n", + "itemtype": "method", + "name": "getPan", + "return": { + "description": "Returns the stereo pan setting of the Oscillator\n as a number between -1.0 (left) and 1.0 (right).\n 0.0 is center and default.", + "type": "Number" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2330, + "description": "

    Set the playback rate of a sound file. Will change the speed and the pitch.\nValues less than zero will reverse the audio buffer.

    \n", + "itemtype": "method", + "name": "rate", + "params": [ + { + "name": "playbackRate", + "description": "

    Set the playback rate. 1.0 is normal,\n .5 is half-speed, 2.0 is twice as fast.\n Values less than zero play backwards.

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar song;\n\nfunction preload() {\n song = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n song.loop();\n}\n\nfunction draw() {\n background(200);\n\n // Set the rate to a range between 0.1 and 4\n // Changing the rate also alters the pitch\n var speed = map(mouseY, 0.1, height, 0, 2);\n speed = constrain(speed, 0.01, 4);\n song.rate(speed);\n\n // Draw a circle to show what is going on\n stroke(0);\n fill(51, 100);\n ellipse(mouseX, 100, 48, 48);\n}\n\n \n
    \n" + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2403, + "description": "

    Returns the duration of a sound file in seconds.

    \n", + "itemtype": "method", + "name": "duration", + "return": { + "description": "The duration of the soundFile in seconds.", + "type": "Number" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2417, + "description": "

    Return the current position of the p5.SoundFile playhead, in seconds.\nTime is relative to the normal buffer direction, so if reverseBuffer\nhas been called, currentTime will count backwards.

    \n", + "itemtype": "method", + "name": "currentTime", + "return": { + "description": "currentTime of the soundFile in seconds.", + "type": "Number" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2428, + "description": "

    Move the playhead of the song to a position, in seconds. Start timing\nand playback duration. If none are given, will reset the file to play\nentire duration from start to finish.

    \n", + "itemtype": "method", + "name": "jump", + "params": [ + { + "name": "cueTime", + "description": "

    cueTime of the soundFile in seconds.

    \n", + "type": "Number" + }, + { + "name": "duration", + "description": "

    duration in seconds.

    \n", + "type": "Number" + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2451, + "description": "

    Return the number of channels in a sound file.\nFor example, Mono = 1, Stereo = 2.

    \n", + "itemtype": "method", + "name": "channels", + "return": { + "description": "[channels]", + "type": "Number" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2461, + "description": "

    Return the sample rate of the sound file.

    \n", + "itemtype": "method", + "name": "sampleRate", + "return": { + "description": "[sampleRate]", + "type": "Number" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2470, + "description": "

    Return the number of samples in a sound file.\nEqual to sampleRate * duration.

    \n", + "itemtype": "method", + "name": "frames", + "return": { + "description": "[sampleCount]", + "type": "Number" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2480, + "description": "

    Returns an array of amplitude peaks in a p5.SoundFile that can be\nused to draw a static waveform. Scans through the p5.SoundFile's\naudio buffer to find the greatest amplitudes. Accepts one\nparameter, 'length', which determines size of the array.\nLarger arrays result in more precise waveform visualizations.

    \n

    Inspired by Wavesurfer.js.

    \n", + "itemtype": "method", + "name": "getPeaks", + "params": [ + { + "name": "length", + "description": "

    length is the size of the returned array.\n Larger length results in more precision.\n Defaults to 5*width of the browser window.

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "Array of peaks.", + "type": "Float32Array" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2532, + "description": "

    Reverses the p5.SoundFile's buffer source.\nPlayback must be handled separately (see example).

    \n", + "itemtype": "method", + "name": "reverseBuffer", + "example": [ + "\n
    \nvar drum;\n\nfunction preload() {\n drum = loadSound('assets/drum.mp3');\n}\n\nfunction setup() {\n drum.reverseBuffer();\n drum.play();\n}\n\n \n
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2572, + "description": "

    Schedule an event to be called when the soundfile\nreaches the end of a buffer. If the soundfile is\nplaying through once, this will be called when it\nends. If it is looping, it will be called when\nstop is called.

    \n", + "itemtype": "method", + "name": "onended", + "params": [ + { + "name": "callback", + "description": "

    function to call when the\n soundfile has ended.

    \n", + "type": "Function" + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2625, + "description": "

    Connects the output of a p5sound object to input of another\np5.sound object. For example, you may connect a p5.SoundFile to an\nFFT or an Effect. If no parameter is given, it will connect to\nthe master output. Most p5sound objects connect to the master\noutput when they are created.

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "object", + "description": "

    Audio object that accepts an input

    \n", + "type": "Object", + "optional": true + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2646, + "description": "

    Disconnects the output of this p5sound object.

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2656, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2661, + "description": "

    Reset the source for this SoundFile to a\nnew path (URL).

    \n", + "itemtype": "method", + "name": "setPath", + "params": [ + { + "name": "path", + "description": "

    path to audio file

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    Callback

    \n", + "type": "Function" + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2674, + "description": "

    Replace the current Audio Buffer with a new Buffer.

    \n", + "itemtype": "method", + "name": "setBuffer", + "params": [ + { + "name": "buf", + "description": "

    Array of Float32 Array(s). 2 Float32 Arrays\n will create a stereo source. 1 will create\n a mono source.

    \n", + "type": "Array" + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2741, + "description": "

    processPeaks returns an array of timestamps where it thinks there is a beat.

    \n

    This is an asynchronous function that processes the soundfile in an offline audio context,\nand sends the results to your callback function.

    \n

    The process involves running the soundfile through a lowpass filter, and finding all of the\npeaks above the initial threshold. If the total number of peaks are below the minimum number of peaks,\nit decreases the threshold and re-runs the analysis until either minPeaks or minThreshold are reached.

    \n", + "itemtype": "method", + "name": "processPeaks", + "params": [ + { + "name": "callback", + "description": "

    a function to call once this data is returned

    \n", + "type": "Function" + }, + { + "name": "initThreshold", + "description": "

    initial threshold defaults to 0.9

    \n", + "type": "Number", + "optional": true + }, + { + "name": "minThreshold", + "description": "

    minimum threshold defaults to 0.22

    \n", + "type": "Number", + "optional": true + }, + { + "name": "minPeaks", + "description": "

    minimum number of peaks defaults to 200

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "Array of timestamped peaks", + "type": "Array" + }, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2934, + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 2943, + "description": "

    Schedule events to trigger every time a MediaElement\n(audio/video) reaches a playback cue point.

    \n

    Accepts a callback function, a time (in seconds) at which to trigger\nthe callback, and an optional parameter for the callback.

    \n

    Time will be passed as the first parameter to the callback function,\nand param will be the second parameter.

    \n", + "itemtype": "method", + "name": "addCue", + "params": [ + { + "name": "time", + "description": "

    Time in seconds, relative to this media\n element's playback. For example, to trigger\n an event every time playback reaches two\n seconds, pass in the number 2. This will be\n passed as the first parameter to\n the callback function.

    \n", + "type": "Number" + }, + { + "name": "callback", + "description": "

    Name of a function that will be\n called at the given time. The callback will\n receive time and (optionally) param as its\n two parameters.

    \n", + "type": "Function" + }, + { + "name": "value", + "description": "

    An object to be passed as the\n second parameter to the\n callback function.

    \n", + "type": "Object", + "optional": true + } + ], + "return": { + "description": "id ID of this cue,\n useful for removeCue(id)", + "type": "Number" + }, + "example": [ + "\n
    \nvar mySound;\nfunction preload() {\n mySound = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n // schedule calls to changeText\n mySound.addCue(0.50, changeText, \"hello\" );\n mySound.addCue(1.00, changeText, \"p5\" );\n mySound.addCue(1.50, changeText, \"what\" );\n mySound.addCue(2.00, changeText, \"do\" );\n mySound.addCue(2.50, changeText, \"you\" );\n mySound.addCue(3.00, changeText, \"want\" );\n mySound.addCue(4.00, changeText, \"to\" );\n mySound.addCue(5.00, changeText, \"make\" );\n mySound.addCue(6.00, changeText, \"?\" );\n}\n\nfunction changeText(val) {\n background(0);\n text(val, width/2, height/2);\n}\n\nfunction mouseClicked() {\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n if (mySound.isPlaying() ) {\n mySound.stop();\n } else {\n mySound.play();\n }\n }\n}\n
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3021, + "description": "

    Remove a callback based on its ID. The ID is returned by the\naddCue method.

    \n", + "itemtype": "method", + "name": "removeCue", + "params": [ + { + "name": "id", + "description": "

    ID of the cue, as returned by addCue

    \n", + "type": "Number" + } + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3040, + "description": "

    Remove all of the callbacks that had originally been scheduled\nvia the addCue method.

    \n", + "itemtype": "method", + "name": "clearCues", + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3065, + "description": "

    Save a p5.SoundFile as a .wav file. The browser will prompt the user\nto download the file to their device. To upload a file to a server, see\ngetBlob

    \n", + "itemtype": "method", + "name": "save", + "params": [ + { + "name": "fileName", + "description": "

    name of the resulting .wav file.

    \n", + "type": "String", + "optional": true + } + ], + "example": [ + "\n
    \n var inp, button, mySound;\n var fileName = 'cool';\n function preload() {\n mySound = loadSound('assets/doorbell.mp3');\n }\n function setup() {\n btn = createButton('click to save file');\n btn.position(0, 0);\n btn.mouseClicked(handleMouseClick);\n }\n\n function handleMouseClick() {\n mySound.save(fileName);\n }\n
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3094, + "description": "

    This method is useful for sending a SoundFile to a server. It returns the\n.wav-encoded audio data as a "Blob".\nA Blob is a file-like data object that can be uploaded to a server\nwith an http request. We'll\nuse the httpDo options object to send a POST request with some\nspecific options: we encode the request as multipart/form-data,\nand attach the blob as one of the form values using FormData.

    \n", + "itemtype": "method", + "name": "getBlob", + "return": { + "description": "A file-like data object", + "type": "Blob" + }, + "example": [ + "\n
    \n\n function preload() {\n mySound = loadSound('assets/doorbell.mp3');\n }\n\n function setup() {\n noCanvas();\n var soundBlob = mySound.getBlob();\n\n // Now we can send the blob to a server...\n var serverUrl = 'https://jsonplaceholder.typicode.com/posts';\n var httpRequestOptions = {\n method: 'POST',\n body: new FormData().append('soundBlob', soundBlob),\n headers: new Headers({\n 'Content-Type': 'multipart/form-data'\n })\n };\n httpDo(serverUrl, httpRequestOptions);\n\n // We can also create an `ObjectURL` pointing to the Blob\n var blobUrl = URL.createObjectURL(soundBlob);\n\n // The `
    " + ], + "class": "p5.SoundFile", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3257, + "description": "

    Connects to the p5sound instance (master output) by default.\nOptionally, you can pass in a specific source (i.e. a soundfile).

    \n", + "itemtype": "method", + "name": "setInput", + "params": [ + { + "name": "snd", + "description": "

    set the sound source\n (optional, defaults to\n master output)

    \n", + "type": "SoundObject|undefined", + "optional": true + }, + { + "name": "smoothing", + "description": "

    a range between 0.0 and 1.0\n to smooth amplitude readings

    \n", + "type": "Number|undefined", + "optional": true + } + ], + "example": [ + "\n
    \nfunction preload(){\n sound1 = loadSound('assets/beat.mp3');\n sound2 = loadSound('assets/drum.mp3');\n}\nfunction setup(){\n amplitude = new p5.Amplitude();\n sound1.play();\n sound2.play();\n amplitude.setInput(sound2);\n}\nfunction draw() {\n background(0);\n fill(255);\n var level = amplitude.getLevel();\n var size = map(level, 0, 1, 0, 200);\n ellipse(width/2, height/2, size, size);\n}\nfunction mouseClicked(){\n sound1.stop();\n sound2.stop();\n}\n
    " + ], + "class": "p5.Amplitude", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3364, + "description": "

    Returns a single Amplitude reading at the moment it is called.\nFor continuous readings, run in the draw loop.

    \n", + "itemtype": "method", + "name": "getLevel", + "params": [ + { + "name": "channel", + "description": "

    Optionally return only channel 0 (left) or 1 (right)

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "Amplitude as a number between 0.0 and 1.0", + "type": "Number" + }, + "example": [ + "\n
    \nfunction preload(){\n sound = loadSound('assets/beat.mp3');\n}\nfunction setup() {\n amplitude = new p5.Amplitude();\n sound.play();\n}\nfunction draw() {\n background(0);\n fill(255);\n var level = amplitude.getLevel();\n var size = map(level, 0, 1, 0, 200);\n ellipse(width/2, height/2, size, size);\n}\nfunction mouseClicked(){\n sound.stop();\n}\n
    " + ], + "class": "p5.Amplitude", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3405, + "description": "

    Determines whether the results of Amplitude.process() will be\nNormalized. To normalize, Amplitude finds the difference the\nloudest reading it has processed and the maximum amplitude of\n1.0. Amplitude adds this difference to all values to produce\nresults that will reliably map between 0.0 and 1.0. However,\nif a louder moment occurs, the amount that Normalize adds to\nall the values will change. Accepts an optional boolean parameter\n(true or false). Normalizing is off by default.

    \n", + "itemtype": "method", + "name": "toggleNormalize", + "params": [ + { + "name": "boolean", + "description": "

    set normalize to true (1) or false (0)

    \n", + "type": "Boolean", + "optional": true + } + ], + "class": "p5.Amplitude", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3425, + "description": "

    Smooth Amplitude analysis by averaging with the last analysis\nframe. Off by default.

    \n", + "itemtype": "method", + "name": "smooth", + "params": [ + { + "name": "set", + "description": "

    smoothing from 0.0 <= 1

    \n", + "type": "Number" + } + ], + "class": "p5.Amplitude", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3599, + "description": "

    Set the input source for the FFT analysis. If no source is\nprovided, FFT will analyze all sound in the sketch.

    \n", + "itemtype": "method", + "name": "setInput", + "params": [ + { + "name": "source", + "description": "

    p5.sound object (or web audio API source node)

    \n", + "type": "Object", + "optional": true + } + ], + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3618, + "description": "

    Returns an array of amplitude values (between -1.0 and +1.0) that represent\na snapshot of amplitude readings in a single buffer. Length will be\nequal to bins (defaults to 1024). Can be used to draw the waveform\nof a sound.

    \n", + "itemtype": "method", + "name": "waveform", + "params": [ + { + "name": "bins", + "description": "

    Must be a power of two between\n 16 and 1024. Defaults to 1024.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "precision", + "description": "

    If any value is provided, will return results\n in a Float32 Array which is more precise\n than a regular array.

    \n", + "type": "String", + "optional": true + } + ], + "return": { + "description": "Array Array of amplitude values (-1 to 1)\n over time. Array length = bins.", + "type": "Array" + }, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3661, + "description": "

    Returns an array of amplitude values (between 0 and 255)\nacross the frequency spectrum. Length is equal to FFT bins\n(1024 by default). The array indices correspond to frequencies\n(i.e. pitches), from the lowest to the highest that humans can\nhear. Each value represents amplitude at that slice of the\nfrequency spectrum. Must be called prior to using\ngetEnergy().

    \n", + "itemtype": "method", + "name": "analyze", + "params": [ + { + "name": "bins", + "description": "

    Must be a power of two between\n 16 and 1024. Defaults to 1024.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "scale", + "description": "

    If "dB," returns decibel\n float measurements between\n -140 and 0 (max).\n Otherwise returns integers from 0-255.

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "spectrum Array of energy (amplitude/volume)\n values across the frequency spectrum.\n Lowest energy (silence) = 0, highest\n possible is 255.", + "type": "Array" + }, + "example": [ + "\n
    \nvar osc;\nvar fft;\n\nfunction setup(){\n createCanvas(100,100);\n osc = new p5.Oscillator();\n osc.amp(0);\n osc.start();\n fft = new p5.FFT();\n}\n\nfunction draw(){\n background(0);\n\n var freq = map(mouseX, 0, 800, 20, 15000);\n freq = constrain(freq, 1, 20000);\n osc.freq(freq);\n\n var spectrum = fft.analyze();\n noStroke();\n fill(0,255,0); // spectrum is green\n for (var i = 0; i< spectrum.length; i++){\n var x = map(i, 0, spectrum.length, 0, width);\n var h = -height + map(spectrum[i], 0, 255, height, 0);\n rect(x, height, width / spectrum.length, h );\n }\n\n stroke(255);\n text('Freq: ' + round(freq)+'Hz', 10, 10);\n\n isMouseOverCanvas();\n}\n\n// only play sound when mouse is over canvas\nfunction isMouseOverCanvas() {\n var mX = mouseX, mY = mouseY;\n if (mX > 0 && mX < width && mY < height && mY > 0) {\n osc.amp(0.5, 0.2);\n } else {\n osc.amp(0, 0.2);\n }\n}\n
    \n\n" + ], + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3753, + "description": "

    Returns the amount of energy (volume) at a specific\n\nfrequency, or the average amount of energy between two\nfrequencies. Accepts Number(s) corresponding\nto frequency (in Hz), or a String corresponding to predefined\nfrequency ranges ("bass", "lowMid", "mid", "highMid", "treble").\nReturns a range between 0 (no energy/volume at that frequency) and\n255 (maximum energy).\nNOTE: analyze() must be called prior to getEnergy(). Analyze()\ntells the FFT to analyze frequency data, and getEnergy() uses\nthe results determine the value at a specific frequency or\nrange of frequencies.

    \n", + "itemtype": "method", + "name": "getEnergy", + "params": [ + { + "name": "frequency1", + "description": "

    Will return a value representing\n energy at this frequency. Alternately,\n the strings "bass", "lowMid" "mid",\n "highMid", and "treble" will return\n predefined frequency ranges.

    \n", + "type": "Number|String" + }, + { + "name": "frequency2", + "description": "

    If a second frequency is given,\n will return average amount of\n energy that exists between the\n two frequencies.

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "Energy Energy (volume/amplitude) from\n 0 and 255.", + "type": "Number" + }, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3835, + "description": "

    Returns the\n\nspectral centroid of the input signal.\nNOTE: analyze() must be called prior to getCentroid(). Analyze()\ntells the FFT to analyze frequency data, and getCentroid() uses\nthe results determine the spectral centroid.

    \n", + "itemtype": "method", + "name": "getCentroid", + "return": { + "description": "Spectral Centroid Frequency Frequency of the spectral centroid in Hz.", + "type": "Number" + }, + "example": [ + "\n
    \n\n\nfunction setup(){\ncnv = createCanvas(100,100);\nsound = new p5.AudioIn();\nsound.start();\nfft = new p5.FFT();\nsound.connect(fft);\n}\n\n\nfunction draw(){\n\nvar centroidplot = 0.0;\nvar spectralCentroid = 0;\n\n\nbackground(0);\nstroke(0,255,0);\nvar spectrum = fft.analyze();\nfill(0,255,0); // spectrum is green\n\n//draw the spectrum\nfor (var i = 0; i< spectrum.length; i++){\n var x = map(log(i), 0, log(spectrum.length), 0, width);\n var h = map(spectrum[i], 0, 255, 0, height);\n var rectangle_width = (log(i+1)-log(i))*(width/log(spectrum.length));\n rect(x, height, rectangle_width, -h )\n}\n\nvar nyquist = 22050;\n\n// get the centroid\nspectralCentroid = fft.getCentroid();\n\n// the mean_freq_index calculation is for the display.\nvar mean_freq_index = spectralCentroid/(nyquist/spectrum.length);\n\ncentroidplot = map(log(mean_freq_index), 0, log(spectrum.length), 0, width);\n\n\nstroke(255,0,0); // the line showing where the centroid is will be red\n\nrect(centroidplot, 0, width / spectrum.length, height)\nnoStroke();\nfill(255,255,255); // text is white\ntext(\"centroid: \", 10, 20);\ntext(round(spectralCentroid)+\" Hz\", 10, 40);\n}\n
    " + ], + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3915, + "description": "

    Smooth FFT analysis by averaging with the last analysis frame.

    \n", + "itemtype": "method", + "name": "smooth", + "params": [ + { + "name": "smoothing", + "description": "

    0.0 < smoothing < 1.0.\n Defaults to 0.8.

    \n", + "type": "Number" + } + ], + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3937, + "description": "

    Returns an array of average amplitude values for a given number\nof frequency bands split equally. N defaults to 16.\nNOTE: analyze() must be called prior to linAverages(). Analyze()\ntells the FFT to analyze frequency data, and linAverages() uses\nthe results to group them into a smaller set of averages.

    \n", + "itemtype": "method", + "name": "linAverages", + "params": [ + { + "name": "N", + "description": "

    Number of returned frequency groups

    \n", + "type": "Number" + } + ], + "return": { + "description": "linearAverages Array of average amplitude values for each group", + "type": "Array" + }, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3967, + "description": "

    Returns an array of average amplitude values of the spectrum, for a given\nset of \nOctave Bands\nNOTE: analyze() must be called prior to logAverages(). Analyze()\ntells the FFT to analyze frequency data, and logAverages() uses\nthe results to group them into a smaller set of averages.

    \n", + "itemtype": "method", + "name": "logAverages", + "params": [ + { + "name": "octaveBands", + "description": "

    Array of Octave Bands objects for grouping

    \n", + "type": "Array" + } + ], + "return": { + "description": "logAverages Array of average amplitude values for each group", + "type": "Array" + }, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 3997, + "description": "

    Calculates and Returns the 1/N\nOctave Bands\nN defaults to 3 and minimum central frequency to 15.625Hz.\n(1/3 Octave Bands ~= 31 Frequency Bands)\nSetting fCtr0 to a central value of a higher octave will ignore the lower bands\nand produce less frequency groups.

    \n", + "itemtype": "method", + "name": "getOctaveBands", + "params": [ + { + "name": "N", + "description": "

    Specifies the 1/N type of generated octave bands

    \n", + "type": "Number" + }, + { + "name": "fCtr0", + "description": "

    Minimum central frequency for the lowest band

    \n", + "type": "Number" + } + ], + "return": { + "description": "octaveBands Array of octave band objects with their bounds", + "type": "Array" + }, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4055, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4076, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4135, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4453, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4625, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4783, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4824, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 4881, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5049, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5097, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5128, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5149, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5169, + "class": "p5.FFT", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5268, + "description": "

    Fade to value, for smooth transitions

    \n", + "itemtype": "method", + "name": "fade", + "params": [ + { + "name": "value", + "description": "

    Value to set this signal

    \n", + "type": "Number" + }, + { + "name": "secondsFromNow", + "description": "

    Length of fade, in seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Signal", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5279, + "description": "

    Connect a p5.sound object or Web Audio node to this\np5.Signal so that its amplitude values can be scaled.

    \n", + "itemtype": "method", + "name": "setInput", + "params": [ + { + "name": "input", + "description": "", + "type": "Object" + } + ], + "class": "p5.Signal", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5293, + "description": "

    Add a constant value to this audio signal,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalAdd.

    \n", + "itemtype": "method", + "name": "add", + "params": [ + { + "name": "number", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "object", + "type": "p5.Signal" + }, + "class": "p5.Signal", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5312, + "description": "

    Multiply this signal by a constant value,\nand return the resulting audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalMult.

    \n", + "itemtype": "method", + "name": "mult", + "params": [ + { + "name": "number", + "description": "

    to multiply

    \n", + "type": "Number" + } + ], + "return": { + "description": "object", + "type": "p5.Signal" + }, + "class": "p5.Signal", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5331, + "description": "

    Scale this signal value to a given range,\nand return the result as an audio signal. Does\nnot change the value of the original signal,\ninstead it returns a new p5.SignalScale.

    \n", + "itemtype": "method", + "name": "scale", + "params": [ + { + "name": "number", + "description": "

    to multiply

    \n", + "type": "Number" + }, + { + "name": "inMin", + "description": "

    input range minumum

    \n", + "type": "Number" + }, + { + "name": "inMax", + "description": "

    input range maximum

    \n", + "type": "Number" + }, + { + "name": "outMin", + "description": "

    input range minumum

    \n", + "type": "Number" + }, + { + "name": "outMax", + "description": "

    input range maximum

    \n", + "type": "Number" + } + ], + "return": { + "description": "object", + "type": "p5.Signal" + }, + "class": "p5.Signal", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5465, + "description": "

    Start an oscillator. Accepts an optional parameter to\ndetermine how long (in seconds from now) until the\noscillator starts.

    \n", + "itemtype": "method", + "name": "start", + "params": [ + { + "name": "time", + "description": "

    startTime in seconds from now.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "frequency", + "description": "

    frequency in Hz.

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5505, + "description": "

    Stop an oscillator. Accepts an optional parameter\nto determine how long (in seconds from now) until the\noscillator stops.

    \n", + "itemtype": "method", + "name": "stop", + "params": [ + { + "name": "secondsFromNow", + "description": "

    Time, in seconds from now.

    \n", + "type": "Number" + } + ], + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5521, + "description": "

    Set the amplitude between 0 and 1.0. Or, pass in an object\nsuch as an oscillator to modulate amplitude with an audio signal.

    \n", + "itemtype": "method", + "name": "amp", + "params": [ + { + "name": "vol", + "description": "

    between 0 and 1.0\n or a modulating signal/oscillator

    \n", + "type": "Number|Object" + }, + { + "name": "rampTime", + "description": "

    create a fade that lasts rampTime

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "gain If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's\n gain/amplitude/volume)", + "type": "AudioParam" + }, + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5556, + "description": "

    Set frequency of an oscillator to a value. Or, pass in an object\nsuch as an oscillator to modulate the frequency with an audio signal.

    \n", + "itemtype": "method", + "name": "freq", + "params": [ + { + "name": "Frequency", + "description": "

    Frequency in Hz\n or modulating signal/oscillator

    \n", + "type": "Number|Object" + }, + { + "name": "rampTime", + "description": "

    Ramp time (in seconds)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    Schedule this event to happen\n at x seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "Frequency If no value is provided,\n returns the Web Audio API\n AudioParam that controls\n this oscillator's frequency", + "type": "AudioParam" + }, + "example": [ + "\n
    \nvar osc = new p5.Oscillator(300);\nosc.start();\nosc.freq(40, 10);\n
    " + ], + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5615, + "description": "

    Set type to 'sine', 'triangle', 'sawtooth' or 'square'.

    \n", + "itemtype": "method", + "name": "setType", + "params": [ + { + "name": "type", + "description": "

    'sine', 'triangle', 'sawtooth' or 'square'.

    \n", + "type": "String" + } + ], + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5627, + "description": "

    Connect to a p5.sound / Web Audio object.

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "

    A p5.sound or Web Audio object

    \n", + "type": "Object" + } + ], + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5644, + "description": "

    Disconnect all outputs

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5661, + "description": "

    Pan between Left (-1) and Right (1)

    \n", + "itemtype": "method", + "name": "pan", + "params": [ + { + "name": "panning", + "description": "

    Number between -1 and 1

    \n", + "type": "Number" + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number" + } + ], + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5693, + "description": "

    Set the phase of an oscillator between 0.0 and 1.0.\nIn this implementation, phase is a delay time\nbased on the oscillator's current frequency.

    \n", + "itemtype": "method", + "name": "phase", + "params": [ + { + "name": "phase", + "description": "

    float between 0.0 and 1.0

    \n", + "type": "Number" + } + ], + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5747, + "description": "

    Add a value to the p5.Oscillator's output amplitude,\nand return the oscillator. Calling this method again\nwill override the initial add() with a new value.

    \n", + "itemtype": "method", + "name": "add", + "params": [ + { + "name": "number", + "description": "

    Constant number to add

    \n", + "type": "Number" + } + ], + "return": { + "description": "Oscillator Returns this oscillator\n with scaled output", + "type": "p5.Oscillator" + }, + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5764, + "description": "

    Multiply the p5.Oscillator's output amplitude\nby a fixed value (i.e. turn it up!). Calling this method\nagain will override the initial mult() with a new value.

    \n", + "itemtype": "method", + "name": "mult", + "params": [ + { + "name": "number", + "description": "

    Constant number to multiply

    \n", + "type": "Number" + } + ], + "return": { + "description": "Oscillator Returns this oscillator\n with multiplied output", + "type": "p5.Oscillator" + }, + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5780, + "description": "

    Scale this oscillator's amplitude values to a given\nrange, and return the oscillator. Calling this method\nagain will override the initial scale() with new values.

    \n", + "itemtype": "method", + "name": "scale", + "params": [ + { + "name": "inMin", + "description": "

    input range minumum

    \n", + "type": "Number" + }, + { + "name": "inMax", + "description": "

    input range maximum

    \n", + "type": "Number" + }, + { + "name": "outMin", + "description": "

    input range minumum

    \n", + "type": "Number" + }, + { + "name": "outMax", + "description": "

    input range maximum

    \n", + "type": "Number" + } + ], + "return": { + "description": "Oscillator Returns this oscillator\n with scaled output", + "type": "p5.Oscillator" + }, + "class": "p5.Oscillator", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 5879, + "class": "p5.SqrOsc", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6082, + "class": "p5.SqrOsc", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6369, + "description": "

    Time until envelope reaches attackLevel

    \n", + "itemtype": "property", + "name": "attackTime", + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6374, + "description": "

    Level once attack is complete.

    \n", + "itemtype": "property", + "name": "attackLevel", + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6379, + "description": "

    Time until envelope reaches decayLevel.

    \n", + "itemtype": "property", + "name": "decayTime", + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6384, + "description": "

    Level after decay. The envelope will sustain here until it is released.

    \n", + "itemtype": "property", + "name": "decayLevel", + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6389, + "description": "

    Duration of the release portion of the envelope.

    \n", + "itemtype": "property", + "name": "releaseTime", + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6394, + "description": "

    Level at the end of the release.

    \n", + "itemtype": "property", + "name": "releaseLevel", + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6430, + "description": "

    Reset the envelope with a series of time/value pairs.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "attackTime", + "description": "

    Time (in seconds) before level\n reaches attackLevel

    \n", + "type": "Number" + }, + { + "name": "attackLevel", + "description": "

    Typically an amplitude between\n 0.0 and 1.0

    \n", + "type": "Number" + }, + { + "name": "decayTime", + "description": "

    Time

    \n", + "type": "Number" + }, + { + "name": "decayLevel", + "description": "

    Amplitude (In a standard ADSR envelope,\n decayLevel = sustainLevel)

    \n", + "type": "Number" + }, + { + "name": "releaseTime", + "description": "

    Release Time (in seconds)

    \n", + "type": "Number" + }, + { + "name": "releaseLevel", + "description": "

    Amplitude

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \nvar t1 = 0.1; // attack time in seconds\nvar l1 = 0.7; // attack level 0.0 to 1.0\nvar t2 = 0.3; // decay time in seconds\nvar l2 = 0.1; // decay level 0.0 to 1.0\nvar t3 = 0.2; // sustain time in seconds\nvar l3 = 0.5; // sustain level 0.0 to 1.0\n// release level defaults to zero\n\nvar env;\nvar triOsc;\n\nfunction setup() {\n background(0);\n noStroke();\n fill(255);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope(t1, l1, t2, l2, t3, l3);\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env); // give the env control of the triOsc's amp\n triOsc.start();\n}\n\n// mouseClick triggers envelope if over canvas\nfunction mouseClicked() {\n // is mouse over canvas?\n if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) {\n env.play(triOsc);\n }\n}\n
    \n" + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6489, + "description": "

    Set values like a traditional\n\nADSR envelope\n.

    \n", + "itemtype": "method", + "name": "setADSR", + "params": [ + { + "name": "attackTime", + "description": "

    Time (in seconds before envelope\n reaches Attack Level

    \n", + "type": "Number" + }, + { + "name": "decayTime", + "description": "

    Time (in seconds) before envelope\n reaches Decay/Sustain Level

    \n", + "type": "Number", + "optional": true + }, + { + "name": "susRatio", + "description": "

    Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "releaseTime", + "description": "

    Time in seconds from now (defaults to 0)

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv() {\n env.play();\n}\n
    " + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6554, + "description": "

    Set max (attackLevel) and min (releaseLevel) of envelope.

    \n", + "itemtype": "method", + "name": "setRange", + "params": [ + { + "name": "aLevel", + "description": "

    attack level (defaults to 1)

    \n", + "type": "Number" + }, + { + "name": "rLevel", + "description": "

    release level (defaults to 0)

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv() {\n env.play();\n}\n
    " + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6633, + "description": "

    Assign a parameter to be controlled by this envelope.\nIf a p5.Sound object is given, then the p5.Envelope will control its\noutput gain. If multiple inputs are provided, the env will\ncontrol all of them.

    \n", + "itemtype": "method", + "name": "setInput", + "params": [ + { + "name": "inputs", + "description": "

    A p5.sound object or\n Web Audio Param.

    \n", + "type": "Object", + "optional": true, + "multiple": true + } + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6648, + "description": "

    Set whether the envelope ramp is linear (default) or exponential.\nExponential ramps can be useful because we perceive amplitude\nand frequency logarithmically.

    \n", + "itemtype": "method", + "name": "setExp", + "params": [ + { + "name": "isExp", + "description": "

    true is exponential, false is linear

    \n", + "type": "Boolean" + } + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6666, + "description": "

    Play tells the envelope to start acting on a given input.\nIf the input is a p5.sound object (i.e. AudioIn, Oscillator,\nSoundFile), then Envelope will control its output volume.\nEnvelopes can also be used to control any \nWeb Audio Audio Param.

    \n", + "itemtype": "method", + "name": "play", + "params": [ + { + "name": "unit", + "description": "

    A p5.sound object or\n Web Audio Param.

    \n", + "type": "Object" + }, + { + "name": "startTime", + "description": "

    time from now (in seconds) at which to play

    \n", + "type": "Number", + "optional": true + }, + { + "name": "sustainTime", + "description": "

    time to sustain before releasing the envelope

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar susPercent = 0.2;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(playEnv);\n}\n\nfunction playEnv() {\n // trigger env on triOsc, 0 seconds from now\n // After decay, sustain for 0.2 seconds before release\n env.play(triOsc, 0, 0.2);\n}\n
    " + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6727, + "description": "

    Trigger the Attack, and Decay portion of the Envelope.\nSimilar to holding down a key on a piano, but it will\nhold the sustain level until you let go. Input can be\nany p5.sound object, or a \nWeb Audio Param.

    \n", + "itemtype": "method", + "name": "triggerAttack", + "params": [ + { + "name": "unit", + "description": "

    p5.sound Object or Web Audio Param

    \n", + "type": "Object" + }, + { + "name": "secondsFromNow", + "description": "

    time from now (in seconds)

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001;\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack() {\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n
    " + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6834, + "description": "

    Trigger the Release of the Envelope. This is similar to releasing\nthe key on a piano and letting the sound fade according to the\nrelease level and release time.

    \n", + "itemtype": "method", + "name": "triggerRelease", + "params": [ + { + "name": "unit", + "description": "

    p5.sound Object or Web Audio Param

    \n", + "type": "Object" + }, + { + "name": "secondsFromNow", + "description": "

    time to trigger the release

    \n", + "type": "Number" + } + ], + "example": [ + "\n
    \n\nvar attackLevel = 1.0;\nvar releaseLevel = 0;\n\nvar attackTime = 0.001;\nvar decayTime = 0.3;\nvar susPercent = 0.4;\nvar releaseTime = 0.5;\n\nvar env, triOsc;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n background(200);\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime, susPercent, releaseTime);\n env.setRange(attackLevel, releaseLevel);\n\n triOsc = new p5.Oscillator('triangle');\n triOsc.amp(env);\n triOsc.start();\n triOsc.freq(220);\n\n cnv.mousePressed(envAttack);\n}\n\nfunction envAttack() {\n console.log('trigger attack');\n env.triggerAttack();\n\n background(0,255,0);\n text('attack!', width/2, height/2);\n}\n\nfunction mouseReleased() {\n env.triggerRelease();\n\n background(200);\n text('click to play', width/2, height/2);\n}\n
    " + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 6931, + "description": "

    Exponentially ramp to a value using the first two\nvalues from setADSR(attackTime, decayTime)\nas \ntime constants for simple exponential ramps.\nIf the value is higher than current value, it uses attackTime,\nwhile a decrease uses decayTime.

    \n", + "itemtype": "method", + "name": "ramp", + "params": [ + { + "name": "unit", + "description": "

    p5.sound Object or Web Audio Param

    \n", + "type": "Object" + }, + { + "name": "secondsFromNow", + "description": "

    When to trigger the ramp

    \n", + "type": "Number" + }, + { + "name": "v", + "description": "

    Target value

    \n", + "type": "Number" + }, + { + "name": "v2", + "description": "

    Second target value (optional)

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar env, osc, amp, cnv;\n\nvar attackTime = 0.001;\nvar decayTime = 0.2;\nvar attackLevel = 1;\nvar decayLevel = 0;\n\nfunction setup() {\n cnv = createCanvas(100, 100);\n fill(0,255,0);\n noStroke();\n\n env = new p5.Envelope();\n env.setADSR(attackTime, decayTime);\n\n osc = new p5.Oscillator();\n osc.amp(env);\n osc.start();\n\n amp = new p5.Amplitude();\n\n cnv.mousePressed(triggerRamp);\n}\n\nfunction triggerRamp() {\n env.ramp(osc, 0, attackLevel, decayLevel);\n}\n\nfunction draw() {\n background(20,20,20);\n text('click me', 10, 20);\n var h = map(amp.getLevel(), 0, 0.4, 0, height);;\n\n rect(0, height, width, -h);\n}\n
    " + ], + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7038, + "description": "

    Add a value to the p5.Oscillator's output amplitude,\nand return the oscillator. Calling this method\nagain will override the initial add() with new values.

    \n", + "itemtype": "method", + "name": "add", + "params": [ + { + "name": "number", + "description": "

    Constant number to add

    \n", + "type": "Number" + } + ], + "return": { + "description": "Envelope Returns this envelope\n with scaled output", + "type": "p5.Envelope" + }, + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7054, + "description": "

    Multiply the p5.Envelope's output amplitude\nby a fixed value. Calling this method\nagain will override the initial mult() with new values.

    \n", + "itemtype": "method", + "name": "mult", + "params": [ + { + "name": "number", + "description": "

    Constant number to multiply

    \n", + "type": "Number" + } + ], + "return": { + "description": "Envelope Returns this envelope\n with scaled output", + "type": "p5.Envelope" + }, + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7070, + "description": "

    Scale this envelope's amplitude values to a given\nrange, and return the envelope. Calling this method\nagain will override the initial scale() with new values.

    \n", + "itemtype": "method", + "name": "scale", + "params": [ + { + "name": "inMin", + "description": "

    input range minumum

    \n", + "type": "Number" + }, + { + "name": "inMax", + "description": "

    input range maximum

    \n", + "type": "Number" + }, + { + "name": "outMin", + "description": "

    input range minumum

    \n", + "type": "Number" + }, + { + "name": "outMax", + "description": "

    input range maximum

    \n", + "type": "Number" + } + ], + "return": { + "description": "Envelope Returns this envelope\n with scaled output", + "type": "p5.Envelope" + }, + "class": "p5.Envelope", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7178, + "description": "

    Set the width of a Pulse object (an oscillator that implements\nPulse Width Modulation).

    \n", + "itemtype": "method", + "name": "width", + "params": [ + { + "name": "width", + "description": "

    Width between the pulses (0 to 1.0,\n defaults to 0)

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Pulse", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7365, + "description": "

    Set type of noise to 'white', 'pink' or 'brown'.\nWhite is the default.

    \n", + "itemtype": "method", + "name": "setType", + "params": [ + { + "name": "type", + "description": "

    'white', 'pink' or 'brown'

    \n", + "type": "String", + "optional": true + } + ], + "class": "p5.Noise", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7478, + "itemtype": "property", + "name": "input", + "type": "GainNode", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7482, + "itemtype": "property", + "name": "output", + "type": "GainNode", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7486, + "itemtype": "property", + "name": "stream", + "type": "MediaStream|null", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7490, + "itemtype": "property", + "name": "mediaStream", + "type": "MediaStreamAudioSourceNode|null", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7494, + "itemtype": "property", + "name": "currentSource", + "type": "Number|null", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7498, + "description": "

    Client must allow browser to access their microphone / audioin source.\nDefault: false. Will become true when the client enables acces.

    \n", + "itemtype": "property", + "name": "enabled", + "type": "Boolean", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7505, + "description": "

    Input amplitude, connect to it by default but not to master out

    \n", + "itemtype": "property", + "name": "amplitude", + "type": "p5.Amplitude", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7518, + "description": "

    Start processing audio input. This enables the use of other\nAudioIn methods like getLevel(). Note that by default, AudioIn\nis not connected to p5.sound's output. So you won't hear\nanything unless you use the connect() method.

    \n

    Certain browsers limit access to the user's microphone. For example,\nChrome only allows access from localhost and over https. For this reason,\nyou may want to include an errorCallback—a function that is called in case\nthe browser won't provide mic access.

    \n", + "itemtype": "method", + "name": "start", + "params": [ + { + "name": "successCallback", + "description": "

    Name of a function to call on\n success.

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    Name of a function to call if\n there was an error. For example,\n some browsers do not support\n getUserMedia.

    \n", + "type": "Function", + "optional": true + } + ], + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7571, + "description": "

    Turn the AudioIn off. If the AudioIn is stopped, it cannot getLevel().\nIf re-starting, the user may be prompted for permission access.

    \n", + "itemtype": "method", + "name": "stop", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7587, + "description": "

    Connect to an audio unit. If no parameter is provided, will\nconnect to the master output (i.e. your speakers).

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "

    An object that accepts audio input,\n such as an FFT

    \n", + "type": "Object", + "optional": true + } + ], + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7608, + "description": "

    Disconnect the AudioIn from all audio units. For example, if\nconnect() had been called, disconnect() will stop sending\nsignal to your speakers.

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7622, + "description": "

    Read the Amplitude (volume level) of an AudioIn. The AudioIn\nclass contains its own instance of the Amplitude class to help\nmake it easy to get a microphone's volume level. Accepts an\noptional smoothing value (0.0 < 1.0). NOTE: AudioIn must\n.start() before using .getLevel().

    \n", + "itemtype": "method", + "name": "getLevel", + "params": [ + { + "name": "smoothing", + "description": "

    Smoothing is 0.0 by default.\n Smooths values based on previous values.

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "Volume level (between 0.0 and 1.0)", + "type": "Number" + }, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7640, + "description": "

    Set amplitude (volume) of a mic input between 0 and 1.0.

    \n", + "itemtype": "method", + "name": "amp", + "params": [ + { + "name": "vol", + "description": "

    between 0 and 1.0

    \n", + "type": "Number" + }, + { + "name": "time", + "description": "

    ramp time (optional)

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7659, + "description": "

    Returns a list of available input sources. This is a wrapper\nfor <a title="MediaDevices.enumerateDevices() - Web APIs | MDN" target="_blank" href=\n "https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices"

    \n
    \n

    and it returns a Promise.

    \n
    \n", + "itemtype": "method", + "name": "getSources", + "params": [ + { + "name": "successCallback", + "description": "

    This callback function handles the sources when they\n have been enumerated. The callback function\n receives the deviceList array as its only argument

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    This optional callback receives the error\n message as its argument.

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "Returns a Promise that can be used in place of the callbacks, similar\n to the enumerateDevices() method", + "type": "Promise" + }, + "example": [ + "\n
    \n var audiograb;\n\n function setup(){\n //new audioIn\n audioGrab = new p5.AudioIn();\n\n audioGrab.getSources(function(deviceList) {\n //print out the array of available sources\n console.log(deviceList);\n //set the source to the first item in the deviceList array\n audioGrab.setSource(0);\n });\n }\n
    " + ], + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7710, + "description": "

    Set the input source. Accepts a number representing a\nposition in the array returned by getSources().\nThis is only available in browsers that support\n<a title="MediaDevices.enumerateDevices() - Web APIs | MDN" target="_blank" href=\n"https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/enumerateDevices"

    \n
    \n

    navigator.mediaDevices.enumerateDevices().

    \n
    \n", + "itemtype": "method", + "name": "setSource", + "params": [ + { + "name": "num", + "description": "

    position of input source in the array

    \n", + "type": "Number" + } + ], + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7750, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7766, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7790, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7816, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7838, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7860, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7906, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7937, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 7955, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8292, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8314, + "class": "p5.AudioIn", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8390, + "description": "

    In classes that extend\np5.Effect, connect effect nodes\nto the wet parameter

    \n", + "class": "p5.Effect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8403, + "description": "

    Set the output volume of the filter.

    \n", + "itemtype": "method", + "name": "amp", + "params": [ + { + "name": "vol", + "description": "

    amplitude between 0 and 1.0

    \n", + "type": "Number", + "optional": true + }, + { + "name": "rampTime", + "description": "

    create a fade that lasts until rampTime

    \n", + "type": "Number", + "optional": true + }, + { + "name": "tFromNow", + "description": "

    schedule this event to happen in tFromNow seconds

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Effect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8420, + "description": "

    Link effects together in a chain
    Example usage: filter.chain(reverb, delay, panner);\nMay be used with an open-ended number of arguments

    \n", + "itemtype": "method", + "name": "chain", + "params": [ + { + "name": "arguments", + "description": "

    Chain together multiple sound objects

    \n", + "type": "Object", + "optional": true + } + ], + "class": "p5.Effect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8437, + "description": "

    Adjust the dry/wet value.

    \n", + "itemtype": "method", + "name": "drywet", + "params": [ + { + "name": "fade", + "description": "

    The desired drywet value (0 - 1.0)

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Effect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8449, + "description": "

    Send output to a p5.js-sound, Web Audio Node, or use signal to\ncontrol an AudioParam

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "", + "type": "Object" + } + ], + "class": "p5.Effect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8460, + "description": "

    Disconnect all output.

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.Effect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8578, + "description": "

    The p5.Filter is built with a\n\nWeb Audio BiquadFilter Node.

    \n", + "itemtype": "property", + "name": "biquadFilter", + "type": "DelayNode", + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8596, + "description": "

    Filter an audio signal according to a set\nof filter parameters.

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "Signal", + "description": "

    An object that outputs audio

    \n", + "type": "Object" + }, + { + "name": "freq", + "description": "

    Frequency in Hz, from 10 to 22050

    \n", + "type": "Number", + "optional": true + }, + { + "name": "res", + "description": "

    Resonance/Width of the filter frequency\n from 0.001 to 1000

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8610, + "description": "

    Set the frequency and the resonance of the filter.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "freq", + "description": "

    Frequency in Hz, from 10 to 22050

    \n", + "type": "Number", + "optional": true + }, + { + "name": "res", + "description": "

    Resonance (Q) from 0.001 to 1000

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8627, + "description": "

    Set the filter frequency, in Hz, from 10 to 22050 (the range of\nhuman hearing, although in reality most people hear in a narrower\nrange).

    \n", + "itemtype": "method", + "name": "freq", + "params": [ + { + "name": "freq", + "description": "

    Filter Frequency

    \n", + "type": "Number" + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "value Returns the current frequency value", + "type": "Number" + }, + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8651, + "description": "

    Controls either width of a bandpass frequency,\nor the resonance of a low/highpass cutoff frequency.

    \n", + "itemtype": "method", + "name": "res", + "params": [ + { + "name": "res", + "description": "

    Resonance/Width of filter freq\n from 0.001 to 1000

    \n", + "type": "Number" + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "value Returns the current res value", + "type": "Number" + }, + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8673, + "description": "

    Controls the gain attribute of a Biquad Filter.\nThis is distinctly different from .amp() which is inherited from p5.Effect\n.amp() controls the volume via the output gain node\np5.Filter.gain() controls the gain parameter of a Biquad Filter node.

    \n", + "itemtype": "method", + "name": "gain", + "params": [ + { + "name": "gain", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "Returns the current or updated gain value", + "type": "Number" + }, + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8694, + "description": "

    Toggle function. Switches between the specified type and allpass

    \n", + "itemtype": "method", + "name": "toggle", + "return": { + "description": "[Toggle value]", + "type": "Boolean" + }, + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8709, + "description": "

    Set the type of a p5.Filter. Possible types include:\n"lowpass" (default), "highpass", "bandpass",\n"lowshelf", "highshelf", "peaking", "notch",\n"allpass".

    \n", + "itemtype": "method", + "name": "setType", + "params": [ + { + "name": "t", + "description": "", + "type": "String" + } + ], + "class": "p5.Filter", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8916, + "description": "

    The p5.EQ is built with abstracted p5.Filter objects.\nTo modify any bands, use methods of the \np5.Filter API, especially gain and freq.\nBands are stored in an array, with indices 0 - 3, or 0 - 7

    \n", + "itemtype": "property", + "name": "bands", + "type": "Array", + "class": "p5.EQ", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 8951, + "description": "

    Process an input by connecting it to the EQ

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "src", + "description": "

    Audio source

    \n", + "type": "Object" + } + ], + "class": "p5.EQ", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9039, + "description": "

    \nWeb Audio Spatial Panner Node

    \n

    Properties include

    \n\n", + "itemtype": "property", + "name": "panner", + "type": "AudioNode", + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9062, + "description": "

    Connect an audio sorce

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "src", + "description": "

    Input source

    \n", + "type": "Object" + } + ], + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9071, + "description": "

    Set the X,Y,Z position of the Panner

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "xVal", + "description": "", + "type": "Number" + }, + { + "name": "yVal", + "description": "", + "type": "Number" + }, + { + "name": "zVal", + "description": "", + "type": "Number" + }, + { + "name": "time", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "Updated x, y, z values as an array", + "type": "Array" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9090, + "description": "

    Getter and setter methods for position coordinates

    \n", + "itemtype": "method", + "name": "positionX", + "return": { + "description": "updated coordinate value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9095, + "description": "

    Getter and setter methods for position coordinates

    \n", + "itemtype": "method", + "name": "positionY", + "return": { + "description": "updated coordinate value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9100, + "description": "

    Getter and setter methods for position coordinates

    \n", + "itemtype": "method", + "name": "positionZ", + "return": { + "description": "updated coordinate value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9138, + "description": "

    Set the X,Y,Z position of the Panner

    \n", + "itemtype": "method", + "name": "orient", + "params": [ + { + "name": "xVal", + "description": "", + "type": "Number" + }, + { + "name": "yVal", + "description": "", + "type": "Number" + }, + { + "name": "zVal", + "description": "", + "type": "Number" + }, + { + "name": "time", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "Updated x, y, z values as an array", + "type": "Array" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9157, + "description": "

    Getter and setter methods for orient coordinates

    \n", + "itemtype": "method", + "name": "orientX", + "return": { + "description": "updated coordinate value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9162, + "description": "

    Getter and setter methods for orient coordinates

    \n", + "itemtype": "method", + "name": "orientY", + "return": { + "description": "updated coordinate value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9167, + "description": "

    Getter and setter methods for orient coordinates

    \n", + "itemtype": "method", + "name": "orientZ", + "return": { + "description": "updated coordinate value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9205, + "description": "

    Set the rolloff factor and max distance

    \n", + "itemtype": "method", + "name": "setFalloff", + "params": [ + { + "name": "maxDistance", + "description": "", + "type": "Number", + "optional": true + }, + { + "name": "rolloffFactor", + "description": "", + "type": "Number", + "optional": true + } + ], + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9215, + "description": "

    Maxium distance between the source and the listener

    \n", + "itemtype": "method", + "name": "maxDist", + "params": [ + { + "name": "maxDistance", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "updated value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9227, + "description": "

    How quickly the volume is reduced as the source moves away from the listener

    \n", + "itemtype": "method", + "name": "rollof", + "params": [ + { + "name": "rolloffFactor", + "description": "", + "type": "Number" + } + ], + "return": { + "description": "updated value", + "type": "Number" + }, + "class": "p5.Panner3D", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9532, + "description": "

    The p5.Delay is built with two\n\nWeb Audio Delay Nodes, one for each stereo channel.

    \n", + "itemtype": "property", + "name": "leftDelay", + "type": "DelayNode", + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9540, + "description": "

    The p5.Delay is built with two\n\nWeb Audio Delay Nodes, one for each stereo channel.

    \n", + "itemtype": "property", + "name": "rightDelay", + "type": "DelayNode", + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9572, + "description": "

    Add delay to an audio signal according to a set\nof delay parameters.

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "Signal", + "description": "

    An object that outputs audio

    \n", + "type": "Object" + }, + { + "name": "delayTime", + "description": "

    Time (in seconds) of the delay/echo.\n Some browsers limit delayTime to\n 1 second.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "feedback", + "description": "

    sends the delay back through itself\n in a loop that decreases in volume\n each time.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "lowPass", + "description": "

    Cutoff frequency. Only frequencies\n below the lowPass will be part of the\n delay.

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9607, + "description": "

    Set the delay (echo) time, in seconds. Usually this value will be\na floating point number between 0.0 and 1.0.

    \n", + "itemtype": "method", + "name": "delayTime", + "params": [ + { + "name": "delayTime", + "description": "

    Time (in seconds) of the delay

    \n", + "type": "Number" + } + ], + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9626, + "description": "

    Feedback occurs when Delay sends its signal back through its input\nin a loop. The feedback amount determines how much signal to send each\ntime through the loop. A feedback greater than 1.0 is not desirable because\nit will increase the overall output each time through the loop,\ncreating an infinite feedback loop. The default value is 0.5

    \n", + "itemtype": "method", + "name": "feedback", + "params": [ + { + "name": "feedback", + "description": "

    0.0 to 1.0, or an object such as an\n Oscillator that can be used to\n modulate this param

    \n", + "type": "Number|Object" + } + ], + "return": { + "description": "Feedback value", + "type": "Number" + }, + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9654, + "description": "

    Set a lowpass filter frequency for the delay. A lowpass filter\nwill cut off any frequencies higher than the filter frequency.

    \n", + "itemtype": "method", + "name": "filter", + "params": [ + { + "name": "cutoffFreq", + "description": "

    A lowpass filter will cut off any\n frequencies higher than the filter frequency.

    \n", + "type": "Number|Object" + }, + { + "name": "res", + "description": "

    Resonance of the filter frequency\n cutoff, or an object (i.e. a p5.Oscillator)\n that can be used to modulate this parameter.\n High numbers (i.e. 15) will produce a resonance,\n low numbers (i.e. .2) will produce a slope.

    \n", + "type": "Number|Object" + } + ], + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9671, + "description": "

    Choose a preset type of delay. 'pingPong' bounces the signal\nfrom the left to the right channel to produce a stereo effect.\nAny other parameter will revert to the default delay setting.

    \n", + "itemtype": "method", + "name": "setType", + "params": [ + { + "name": "type", + "description": "

    'pingPong' (1) or 'default' (0)

    \n", + "type": "String|Number" + } + ], + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9704, + "description": "

    Set the output level of the delay effect.

    \n", + "itemtype": "method", + "name": "amp", + "params": [ + { + "name": "volume", + "description": "

    amplitude between 0 and 1.0

    \n", + "type": "Number" + }, + { + "name": "rampTime", + "description": "

    create a fade that lasts rampTime

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9713, + "description": "

    Send output to a p5.sound or web audio object

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "", + "type": "Object" + } + ], + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9719, + "description": "

    Disconnect all output.

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.Delay", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9812, + "description": "

    Connect a source to the reverb, and assign reverb parameters.

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "src", + "description": "

    p5.sound / Web Audio object with a sound\n output.

    \n", + "type": "Object" + }, + { + "name": "seconds", + "description": "

    Duration of the reverb, in seconds.\n Min: 0, Max: 10. Defaults to 3.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "decayRate", + "description": "

    Percentage of decay with each echo.\n Min: 0, Max: 100. Defaults to 2.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "reverse", + "description": "

    Play the reverb backwards or forwards.

    \n", + "type": "Boolean", + "optional": true + } + ], + "class": "p5.Reverb", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9841, + "description": "

    Set the reverb settings. Similar to .process(), but without\nassigning a new input.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "seconds", + "description": "

    Duration of the reverb, in seconds.\n Min: 0, Max: 10. Defaults to 3.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "decayRate", + "description": "

    Percentage of decay with each echo.\n Min: 0, Max: 100. Defaults to 2.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "reverse", + "description": "

    Play the reverb backwards or forwards.

    \n", + "type": "Boolean", + "optional": true + } + ], + "class": "p5.Reverb", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9869, + "description": "

    Set the output level of the reverb effect.

    \n", + "itemtype": "method", + "name": "amp", + "params": [ + { + "name": "volume", + "description": "

    amplitude between 0 and 1.0

    \n", + "type": "Number" + }, + { + "name": "rampTime", + "description": "

    create a fade that lasts rampTime

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Reverb", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9878, + "description": "

    Send output to a p5.sound or web audio object

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "", + "type": "Object" + } + ], + "class": "p5.Reverb", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9884, + "description": "

    Disconnect all output.

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.Reverb", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9975, + "description": "

    Internally, the p5.Convolver uses the a\n\nWeb Audio Convolver Node.

    \n", + "itemtype": "property", + "name": "convolverNode", + "type": "ConvolverNode", + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 9998, + "description": "

    Create a p5.Convolver. Accepts a path to a soundfile\nthat will be used to generate an impulse response.

    \n", + "itemtype": "method", + "name": "createConvolver", + "params": [ + { + "name": "path", + "description": "

    path to a sound file

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function to call if loading is successful.\n The object will be passed in as the argument\n to the callback function.

    \n", + "type": "Function", + "optional": true + }, + { + "name": "errorCallback", + "description": "

    function to call if loading is not successful.\n A custom error will be passed in as the argument\n to the callback function.

    \n", + "type": "Function", + "optional": true + } + ], + "return": { + "description": "", + "type": "p5.Convolver" + }, + "example": [ + "\n
    \nvar cVerb, sound;\nfunction preload() {\n // We have both MP3 and OGG versions of all sound assets\n soundFormats('ogg', 'mp3');\n\n // Try replacing 'bx-spring' with other soundfiles like\n // 'concrete-tunnel' 'small-plate' 'drum' 'beatbox'\n cVerb = createConvolver('assets/bx-spring.mp3');\n\n // Try replacing 'Damscray_DancingTiger' with\n // 'beat', 'doorbell', lucky_dragons_-_power_melody'\n sound = loadSound('assets/Damscray_DancingTiger.mp3');\n}\n\nfunction setup() {\n // disconnect from master output...\n sound.disconnect();\n\n // ...and process with cVerb\n // so that we only hear the convolution\n cVerb.process(sound);\n\n sound.play();\n}\n
    " + ], + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10122, + "description": "

    Connect a source to the reverb, and assign reverb parameters.

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "src", + "description": "

    p5.sound / Web Audio object with a sound\n output.

    \n", + "type": "Object" + } + ], + "example": [ + "\n
    \nvar cVerb, sound;\nfunction preload() {\n soundFormats('ogg', 'mp3');\n\n cVerb = createConvolver('assets/concrete-tunnel.mp3');\n\n sound = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n // disconnect from master output...\n sound.disconnect();\n\n // ...and process with (i.e. connect to) cVerb\n // so that we only hear the convolution\n cVerb.process(sound);\n\n sound.play();\n}\n
    " + ], + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10154, + "description": "

    If you load multiple impulse files using the .addImpulse method,\nthey will be stored as Objects in this Array. Toggle between them\nwith the toggleImpulse(id) method.

    \n", + "itemtype": "property", + "name": "impulses", + "type": "Array", + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10162, + "description": "

    Load and assign a new Impulse Response to the p5.Convolver.\nThe impulse is added to the .impulses array. Previous\nimpulses can be accessed with the .toggleImpulse(id)\nmethod.

    \n", + "itemtype": "method", + "name": "addImpulse", + "params": [ + { + "name": "path", + "description": "

    path to a sound file

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function (optional)

    \n", + "type": "Function" + }, + { + "name": "errorCallback", + "description": "

    function (optional)

    \n", + "type": "Function" + } + ], + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10180, + "description": "

    Similar to .addImpulse, except that the .impulses\nArray is reset to save memory. A new .impulses\narray is created with this impulse as the only item.

    \n", + "itemtype": "method", + "name": "resetImpulse", + "params": [ + { + "name": "path", + "description": "

    path to a sound file

    \n", + "type": "String" + }, + { + "name": "callback", + "description": "

    function (optional)

    \n", + "type": "Function" + }, + { + "name": "errorCallback", + "description": "

    function (optional)

    \n", + "type": "Function" + } + ], + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10198, + "description": "

    If you have used .addImpulse() to add multiple impulses\nto a p5.Convolver, then you can use this method to toggle between\nthe items in the .impulses Array. Accepts a parameter\nto identify which impulse you wish to use, identified either by its\noriginal filename (String) or by its position in the .impulses\n Array (Number).
    \nYou can access the objects in the .impulses Array directly. Each\nObject has two attributes: an .audioBuffer (type:\nWeb Audio \nAudioBuffer) and a .name, a String that corresponds\nwith the original filename.

    \n", + "itemtype": "method", + "name": "toggleImpulse", + "params": [ + { + "name": "id", + "description": "

    Identify the impulse by its original filename\n (String), or by its position in the\n .impulses Array (Number).

    \n", + "type": "String|Number" + } + ], + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10240, + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10265, + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10460, + "description": "

    Set the global tempo, in beats per minute, for all\np5.Parts. This method will impact all active p5.Parts.

    \n", + "itemtype": "method", + "name": "setBPM", + "params": [ + { + "name": "BPM", + "description": "

    Beats Per Minute

    \n", + "type": "Number" + }, + { + "name": "rampTime", + "description": "

    Seconds from now

    \n", + "type": "Number" + } + ], + "class": "p5.Convolver", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10550, + "description": "

    Array of values to pass into the callback\nat each step of the phrase. Depending on the callback\nfunction's requirements, these values may be numbers,\nstrings, or an object with multiple parameters.\nZero (0) indicates a rest.

    \n", + "itemtype": "property", + "name": "sequence", + "type": "Array", + "class": "p5.Phrase", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10638, + "description": "

    Set the tempo of this part, in Beats Per Minute.

    \n", + "itemtype": "method", + "name": "setBPM", + "params": [ + { + "name": "BPM", + "description": "

    Beats Per Minute

    \n", + "type": "Number" + }, + { + "name": "rampTime", + "description": "

    Seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10648, + "description": "

    Returns the tempo, in Beats Per Minute, of this part.

    \n", + "itemtype": "method", + "name": "getBPM", + "return": { + "description": "", + "type": "Number" + }, + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10657, + "description": "

    Start playback of this part. It will play\nthrough all of its phrases at a speed\ndetermined by setBPM.

    \n", + "itemtype": "method", + "name": "start", + "params": [ + { + "name": "time", + "description": "

    seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10673, + "description": "

    Loop playback of this part. It will begin\nlooping through all of its phrases at a speed\ndetermined by setBPM.

    \n", + "itemtype": "method", + "name": "loop", + "params": [ + { + "name": "time", + "description": "

    seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10690, + "description": "

    Tell the part to stop looping.

    \n", + "itemtype": "method", + "name": "noLoop", + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10702, + "description": "

    Stop the part and cue it to step 0. Playback will resume from the begining of the Part when it is played again.

    \n", + "itemtype": "method", + "name": "stop", + "params": [ + { + "name": "time", + "description": "

    seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10712, + "description": "

    Pause the part. Playback will resume\nfrom the current step.

    \n", + "itemtype": "method", + "name": "pause", + "params": [ + { + "name": "time", + "description": "

    seconds from now

    \n", + "type": "Number" + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10724, + "description": "

    Add a p5.Phrase to this Part.

    \n", + "itemtype": "method", + "name": "addPhrase", + "params": [ + { + "name": "phrase", + "description": "

    reference to a p5.Phrase

    \n", + "type": "p5.Phrase" + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10745, + "description": "

    Remove a phrase from this part, based on the name it was\ngiven when it was created.

    \n", + "itemtype": "method", + "name": "removePhrase", + "params": [ + { + "name": "phraseName", + "description": "", + "type": "String" + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10759, + "description": "

    Get a phrase from this part, based on the name it was\ngiven when it was created. Now you can modify its array.

    \n", + "itemtype": "method", + "name": "getPhrase", + "params": [ + { + "name": "phraseName", + "description": "", + "type": "String" + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10773, + "description": "

    Find all sequences with the specified name, and replace their patterns with the specified array.

    \n", + "itemtype": "method", + "name": "replaceSequence", + "params": [ + { + "name": "phraseName", + "description": "", + "type": "String" + }, + { + "name": "sequence", + "description": "

    Array of values to pass into the callback\n at each step of the phrase.

    \n", + "type": "Array" + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10800, + "description": "

    Set the function that will be called at every step. This will clear the previous function.

    \n", + "itemtype": "method", + "name": "onStep", + "params": [ + { + "name": "callback", + "description": "

    The name of the callback\n you want to fire\n on every beat/tatum.

    \n", + "type": "Function" + } + ], + "class": "p5.Part", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10853, + "description": "

    Start playback of the score.

    \n", + "itemtype": "method", + "name": "start", + "class": "p5.Score", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10862, + "description": "

    Stop playback of the score.

    \n", + "itemtype": "method", + "name": "stop", + "class": "p5.Score", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10872, + "description": "

    Pause playback of the score.

    \n", + "itemtype": "method", + "name": "pause", + "class": "p5.Score", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10880, + "description": "

    Loop playback of the score.

    \n", + "itemtype": "method", + "name": "loop", + "class": "p5.Score", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10889, + "description": "

    Stop looping playback of the score. If it\nis currently playing, this will go into effect\nafter the current round of playback completes.

    \n", + "itemtype": "method", + "name": "noLoop", + "class": "p5.Score", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10914, + "description": "

    Set the tempo for all parts in the score

    \n", + "itemtype": "method", + "name": "setBPM", + "params": [ + { + "name": "BPM", + "description": "

    Beats Per Minute

    \n", + "type": "Number" + }, + { + "name": "rampTime", + "description": "

    Seconds from now

    \n", + "type": "Number" + } + ], + "class": "p5.Score", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10982, + "description": "

    musicalTimeMode uses Tone.Time convention\ntrue if string, false if number

    \n", + "itemtype": "property", + "name": "musicalTimeMode", + "type": "Boolean", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10989, + "description": "

    musicalTimeMode variables\nmodify these only when the interval is specified in musicalTime format as a string

    \n", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 10996, + "description": "

    Set a limit to the number of loops to play. defaults to Infinity

    \n", + "itemtype": "property", + "name": "maxIterations", + "type": "Number", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11005, + "description": "

    Do not initiate the callback if timeFromNow is < 0\nThis ususually occurs for a few milliseconds when the page\nis not fully loaded

    \n

    The callback should only be called until maxIterations is reached

    \n", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11019, + "description": "

    Start the loop

    \n", + "itemtype": "method", + "name": "start", + "params": [ + { + "name": "timeFromNow", + "description": "

    schedule a starting time

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11032, + "description": "

    Stop the loop

    \n", + "itemtype": "method", + "name": "stop", + "params": [ + { + "name": "timeFromNow", + "description": "

    schedule a stopping time

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11045, + "description": "

    Pause the loop

    \n", + "itemtype": "method", + "name": "pause", + "params": [ + { + "name": "timeFromNow", + "description": "

    schedule a pausing time

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11058, + "description": "

    Synchronize loops. Use this method to start two more more loops in synchronization\nor to start a loop in synchronization with a loop that is already playing\nThis method will schedule the implicit loop in sync with the explicit master loop\ni.e. loopToStart.syncedStart(loopToSyncWith)

    \n", + "itemtype": "method", + "name": "syncedStart", + "params": [ + { + "name": "otherLoop", + "description": "

    a p5.SoundLoop to sync with

    \n", + "type": "Object" + }, + { + "name": "timeFromNow", + "description": "

    Start the loops in sync after timeFromNow seconds

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11139, + "description": "

    Getters and Setters, setting any paramter will result in a change in the clock's\nfrequency, that will be reflected after the next callback\nbeats per minute (defaults to 60)

    \n", + "itemtype": "property", + "name": "bpm", + "type": "Number", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11157, + "description": "

    number of quarter notes in a measure (defaults to 4)

    \n", + "itemtype": "property", + "name": "timeSignature", + "type": "Number", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11173, + "description": "

    length of the loops interval

    \n", + "itemtype": "property", + "name": "interval", + "type": "Number|String", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11187, + "description": "

    how many times the callback has been called so far

    \n", + "itemtype": "property", + "name": "iterations", + "type": "Number", + "readonly": "", + "class": "p5.SoundLoop", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11228, + "description": "

    The p5.Compressor is built with a Web Audio Dynamics Compressor Node\n

    \n", + "itemtype": "property", + "name": "compressor", + "type": "AudioNode", + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11239, + "description": "

    Performs the same function as .connect, but also accepts\noptional parameters to set compressor's audioParams

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "src", + "description": "

    Sound source to be connected

    \n", + "type": "Object" + }, + { + "name": "attack", + "description": "

    The amount of time (in seconds) to reduce the gain by 10dB,\n default = .003, range 0 - 1

    \n", + "type": "Number", + "optional": true + }, + { + "name": "knee", + "description": "

    A decibel value representing the range above the \n threshold where the curve smoothly transitions to the "ratio" portion.\n default = 30, range 0 - 40

    \n", + "type": "Number", + "optional": true + }, + { + "name": "ratio", + "description": "

    The amount of dB change in input for a 1 dB change in output\n default = 12, range 1 - 20

    \n", + "type": "Number", + "optional": true + }, + { + "name": "threshold", + "description": "

    The decibel value above which the compression will start taking effect\n default = -24, range -100 - 0

    \n", + "type": "Number", + "optional": true + }, + { + "name": "release", + "description": "

    The amount of time (in seconds) to increase the gain by 10dB\n default = .25, range 0 - 1

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11262, + "description": "

    Set the paramters of a compressor.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "attack", + "description": "

    The amount of time (in seconds) to reduce the gain by 10dB,\n default = .003, range 0 - 1

    \n", + "type": "Number" + }, + { + "name": "knee", + "description": "

    A decibel value representing the range above the \n threshold where the curve smoothly transitions to the "ratio" portion.\n default = 30, range 0 - 40

    \n", + "type": "Number" + }, + { + "name": "ratio", + "description": "

    The amount of dB change in input for a 1 dB change in output\n default = 12, range 1 - 20

    \n", + "type": "Number" + }, + { + "name": "threshold", + "description": "

    The decibel value above which the compression will start taking effect\n default = -24, range -100 - 0

    \n", + "type": "Number" + }, + { + "name": "release", + "description": "

    The amount of time (in seconds) to increase the gain by 10dB\n default = .25, range 0 - 1

    \n", + "type": "Number" + } + ], + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11294, + "description": "

    Get current attack or set value w/ time ramp

    \n", + "itemtype": "method", + "name": "attack", + "params": [ + { + "name": "attack", + "description": "

    Attack is the amount of time (in seconds) to reduce the gain by 10dB,\n default = .003, range 0 - 1

    \n", + "type": "Number", + "optional": true + }, + { + "name": "time", + "description": "

    Assign time value to schedule the change in value

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11314, + "description": "

    Get current knee or set value w/ time ramp

    \n", + "itemtype": "method", + "name": "knee", + "params": [ + { + "name": "knee", + "description": "

    A decibel value representing the range above the \n threshold where the curve smoothly transitions to the "ratio" portion.\n default = 30, range 0 - 40

    \n", + "type": "Number", + "optional": true + }, + { + "name": "time", + "description": "

    Assign time value to schedule the change in value

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11334, + "description": "

    Get current ratio or set value w/ time ramp

    \n", + "itemtype": "method", + "name": "ratio", + "params": [ + { + "name": "ratio", + "description": "

    The amount of dB change in input for a 1 dB change in output\n default = 12, range 1 - 20

    \n", + "type": "Number", + "optional": true + }, + { + "name": "time", + "description": "

    Assign time value to schedule the change in value

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11353, + "description": "

    Get current threshold or set value w/ time ramp

    \n", + "itemtype": "method", + "name": "threshold", + "params": [ + { + "name": "threshold", + "description": "

    The decibel value above which the compression will start taking effect\n default = -24, range -100 - 0

    \n", + "type": "Number" + }, + { + "name": "time", + "description": "

    Assign time value to schedule the change in value

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11372, + "description": "

    Get current release or set value w/ time ramp

    \n", + "itemtype": "method", + "name": "release", + "params": [ + { + "name": "release", + "description": "

    The amount of time (in seconds) to increase the gain by 10dB\n default = .25, range 0 - 1

    \n", + "type": "Number" + }, + { + "name": "time", + "description": "

    Assign time value to schedule the change in value

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11392, + "description": "

    Return the current reduction value

    \n", + "itemtype": "method", + "name": "reduction", + "return": { + "description": "Value of the amount of gain reduction that is applied to the signal", + "type": "Number" + }, + "class": "p5.Compressor", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11508, + "description": "

    Connect a specific device to the p5.SoundRecorder.\nIf no parameter is given, p5.SoundRecorer will record\nall audible p5.sound from your sketch.

    \n", + "itemtype": "method", + "name": "setInput", + "params": [ + { + "name": "unit", + "description": "

    p5.sound object or a web audio unit\n that outputs sound

    \n", + "type": "Object", + "optional": true + } + ], + "class": "p5.SoundRecorder", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11529, + "description": "

    Start recording. To access the recording, provide\na p5.SoundFile as the first parameter. The p5.SoundRecorder\nwill send its recording to that p5.SoundFile for playback once\nrecording is complete. Optional parameters include duration\n(in seconds) of the recording, and a callback function that\nwill be called once the complete recording has been\ntransfered to the p5.SoundFile.

    \n", + "itemtype": "method", + "name": "record", + "params": [ + { + "name": "soundFile", + "description": "

    p5.SoundFile

    \n", + "type": "p5.SoundFile" + }, + { + "name": "duration", + "description": "

    Time (in seconds)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "callback", + "description": "

    The name of a function that will be\n called once the recording completes

    \n", + "type": "Function", + "optional": true + } + ], + "class": "p5.SoundRecorder", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11562, + "description": "

    Stop the recording. Once the recording is stopped,\nthe results will be sent to the p5.SoundFile that\nwas given on .record(), and if a callback function\nwas provided on record, that function will be called.

    \n", + "itemtype": "method", + "name": "stop", + "class": "p5.SoundRecorder", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11635, + "description": "

    Save a p5.SoundFile as a .wav file. The browser will prompt the user\nto download the file to their device.\nFor uploading audio to a server, use\np5.SoundFile.saveBlob.

    \n", + "itemtype": "method", + "name": "saveSound", + "params": [ + { + "name": "soundFile", + "description": "

    p5.SoundFile that you wish to save

    \n", + "type": "p5.SoundFile" + }, + { + "name": "fileName", + "description": "

    name of the resulting .wav file.

    \n", + "type": "String" + } + ], + "class": "p5", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11761, + "description": "

    isDetected is set to true when a peak is detected.

    \n", + "itemtype": "attribute", + "name": "isDetected", + "type": "Boolean", + "default": "false", + "class": "p5.PeakDetect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11774, + "description": "

    The update method is run in the draw loop.

    \n

    Accepts an FFT object. You must call .analyze()\non the FFT object prior to updating the peakDetect\nbecause it relies on a completed FFT analysis.

    \n", + "itemtype": "method", + "name": "update", + "params": [ + { + "name": "fftObject", + "description": "

    A p5.FFT object

    \n", + "type": "p5.FFT" + } + ], + "class": "p5.PeakDetect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11805, + "description": "

    onPeak accepts two arguments: a function to call when\na peak is detected. The value of the peak,\nbetween 0.0 and 1.0, is passed to the callback.

    \n", + "itemtype": "method", + "name": "onPeak", + "params": [ + { + "name": "callback", + "description": "

    Name of a function that will\n be called when a peak is\n detected.

    \n", + "type": "Function" + }, + { + "name": "val", + "description": "

    Optional value to pass\n into the function when\n a peak is detected.

    \n", + "type": "Object", + "optional": true + } + ], + "example": [ + "\n
    \nvar cnv, soundFile, fft, peakDetect;\nvar ellipseWidth = 0;\n\nfunction preload() {\n soundFile = loadSound('assets/beat.mp3');\n}\n\nfunction setup() {\n cnv = createCanvas(100,100);\n textAlign(CENTER);\n\n fft = new p5.FFT();\n peakDetect = new p5.PeakDetect();\n\n setupSound();\n\n // when a beat is detected, call triggerBeat()\n peakDetect.onPeak(triggerBeat);\n}\n\nfunction draw() {\n background(0);\n fill(255);\n text('click to play', width/2, height/2);\n\n fft.analyze();\n peakDetect.update(fft);\n\n ellipseWidth *= 0.95;\n ellipse(width/2, height/2, ellipseWidth, ellipseWidth);\n}\n\n// this function is called by peakDetect.onPeak\nfunction triggerBeat() {\n ellipseWidth = 50;\n}\n\n// mouseclick starts/stops sound\nfunction setupSound() {\n cnv.mouseClicked( function() {\n if (soundFile.isPlaying() ) {\n soundFile.stop();\n } else {\n soundFile.play();\n }\n });\n}\n
    " + ], + "class": "p5.PeakDetect", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11954, + "description": "

    Connect a source to the gain node.

    \n", + "itemtype": "method", + "name": "setInput", + "params": [ + { + "name": "src", + "description": "

    p5.sound / Web Audio object with a sound\n output.

    \n", + "type": "Object" + } + ], + "class": "p5.Gain", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11964, + "description": "

    Send output to a p5.sound or web audio object

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "", + "type": "Object" + } + ], + "class": "p5.Gain", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11974, + "description": "

    Disconnect all output.

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.Gain", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 11984, + "description": "

    Set the output level of the gain node.

    \n", + "itemtype": "method", + "name": "amp", + "params": [ + { + "name": "volume", + "description": "

    amplitude between 0 and 1.0

    \n", + "type": "Number" + }, + { + "name": "rampTime", + "description": "

    create a fade that lasts rampTime

    \n", + "type": "Number", + "optional": true + }, + { + "name": "timeFromNow", + "description": "

    schedule this event to happen\n seconds from now

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.Gain", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12042, + "description": "

    Connect to p5 objects or Web Audio Nodes

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "", + "type": "Object" + } + ], + "class": "p5.AudioVoice", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12051, + "description": "

    Disconnect from soundOut

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.AudioVoice", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12131, + "description": "

    Play tells the MonoSynth to start playing a note. This method schedules\nthe calling of .triggerAttack and .triggerRelease.

    \n", + "itemtype": "method", + "name": "play", + "params": [ + { + "name": "note", + "description": "

    the note you want to play, specified as a\n frequency in Hertz (Number) or as a midi\n value in Note/Octave format ("C4", "Eb3"...etc")\n See \n Tone. Defaults to 440 hz.

    \n", + "type": "String | Number" + }, + { + "name": "velocity", + "description": "

    velocity of the note to play (ranging from 0 to 1)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "secondsFromNow", + "description": "

    time from now (in seconds) at which to play

    \n", + "type": "Number", + "optional": true + }, + { + "name": "sustainTime", + "description": "

    time to sustain before releasing the envelope

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar monoSynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n monoSynth = new p5.MonoSynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // time from now (in seconds)\n var time = 0;\n // note duration (in seconds)\n var dur = 1/6;\n // note velocity (volume, from 0 to 1)\n var v = random();\n\n monoSynth.play(\"Fb3\", v, 0, dur);\n monoSynth.play(\"Gb3\", v, time += dur, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n
    \n" + ], + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12179, + "description": "

    Trigger the Attack, and Decay portion of the Envelope.\nSimilar to holding down a key on a piano, but it will\nhold the sustain level until you let go.

    \n", + "params": [ + { + "name": "note", + "description": "

    the note you want to play, specified as a\n frequency in Hertz (Number) or as a midi\n value in Note/Octave format ("C4", "Eb3"...etc")\n See \n Tone. Defaults to 440 hz

    \n", + "type": "String | Number" + }, + { + "name": "velocity", + "description": "

    velocity of the note to play (ranging from 0 to 1)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "secondsFromNow", + "description": "

    time from now (in seconds) at which to play

    \n", + "type": "Number", + "optional": true + } + ], + "itemtype": "method", + "name": "triggerAttack", + "example": [ + "\n
    \nvar monoSynth = new p5.MonoSynth();\n\nfunction mousePressed() {\n monoSynth.triggerAttack(\"E3\");\n}\n\nfunction mouseReleased() {\n monoSynth.triggerRelease();\n}\n
    " + ], + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12212, + "description": "

    Trigger the release of the Envelope. This is similar to releasing\nthe key on a piano and letting the sound fade according to the\nrelease level and release time.

    \n", + "params": [ + { + "name": "secondsFromNow", + "description": "

    time to trigger the release

    \n", + "type": "Number" + } + ], + "itemtype": "method", + "name": "triggerRelease", + "example": [ + "\n
    \nvar monoSynth = new p5.MonoSynth();\n\nfunction mousePressed() {\n monoSynth.triggerAttack(\"E3\");\n}\n\nfunction mouseReleased() {\n monoSynth.triggerRelease();\n}\n
    " + ], + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12236, + "description": "

    Set values like a traditional\n\nADSR envelope\n.

    \n", + "itemtype": "method", + "name": "setADSR", + "params": [ + { + "name": "attackTime", + "description": "

    Time (in seconds before envelope\n reaches Attack Level

    \n", + "type": "Number" + }, + { + "name": "decayTime", + "description": "

    Time (in seconds) before envelope\n reaches Decay/Sustain Level

    \n", + "type": "Number", + "optional": true + }, + { + "name": "susRatio", + "description": "

    Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "releaseTime", + "description": "

    Time in seconds from now (defaults to 0)

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12260, + "description": "

    Getters and Setters

    \n", + "itemtype": "property", + "name": "attack", + "type": "Number", + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12264, + "itemtype": "property", + "name": "decay", + "type": "Number", + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12267, + "itemtype": "property", + "name": "sustain", + "type": "Number", + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12270, + "itemtype": "property", + "name": "release", + "type": "Number", + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12307, + "description": "

    MonoSynth amp

    \n", + "itemtype": "method", + "name": "amp", + "params": [ + { + "name": "vol", + "description": "

    desired volume

    \n", + "type": "Number" + }, + { + "name": "rampTime", + "description": "

    Time to reach new volume

    \n", + "type": "Number", + "optional": true + } + ], + "return": { + "description": "new volume value", + "type": "Number" + }, + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12321, + "description": "

    Connect to a p5.sound / Web Audio object.

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "

    A p5.sound or Web Audio object

    \n", + "type": "Object" + } + ], + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12331, + "description": "

    Disconnect all outputs

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12341, + "description": "

    Get rid of the MonoSynth and free up its resources / memory.

    \n", + "itemtype": "method", + "name": "dispose", + "class": "p5.MonoSynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12411, + "description": "

    An object that holds information about which notes have been played and\nwhich notes are currently being played. New notes are added as keys\non the fly. While a note has been attacked, but not released, the value of the\nkey is the audiovoice which is generating that note. When notes are released,\nthe value of the key becomes undefined.

    \n", + "itemtype": "property", + "name": "notes", + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12423, + "description": "

    A PolySynth must have at least 1 voice, defaults to 8

    \n", + "itemtype": "property", + "name": "polyvalue", + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12428, + "description": "

    Monosynth that generates the sound for each note that is triggered. The\np5.PolySynth defaults to using the p5.MonoSynth as its voice.

    \n", + "itemtype": "property", + "name": "AudioVoice", + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12459, + "description": "

    Play a note by triggering noteAttack and noteRelease with sustain time

    \n", + "itemtype": "method", + "name": "play", + "params": [ + { + "name": "note", + "description": "

    midi note to play (ranging from 0 to 127 - 60 being a middle C)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "velocity", + "description": "

    velocity of the note to play (ranging from 0 to 1)

    \n", + "type": "Number", + "optional": true + }, + { + "name": "secondsFromNow", + "description": "

    time from now (in seconds) at which to play

    \n", + "type": "Number", + "optional": true + }, + { + "name": "sustainTime", + "description": "

    time to sustain before releasing the envelope

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar polySynth;\n\nfunction setup() {\n var cnv = createCanvas(100, 100);\n cnv.mousePressed(playSynth);\n\n polySynth = new p5.PolySynth();\n\n textAlign(CENTER);\n text('click to play', width/2, height/2);\n}\n\nfunction playSynth() {\n // note duration (in seconds)\n var dur = 0.1;\n\n // time from now (in seconds)\n var time = 0;\n\n // velocity (volume, from 0 to 1)\n var vel = 0.1;\n\n polySynth.play(\"G2\", vel, 0, dur);\n polySynth.play(\"C3\", vel, 0, dur);\n polySynth.play(\"G3\", vel, 0, dur);\n\n background(random(255), random(255), 255);\n text('click to play', width/2, height/2);\n}\n
    " + ], + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12505, + "description": "

    noteADSR sets the envelope for a specific note that has just been triggered.\nUsing this method modifies the envelope of whichever audiovoice is being used\nto play the desired note. The envelope should be reset before noteRelease is called\nin order to prevent the modified envelope from being used on other notes.

    \n", + "itemtype": "method", + "name": "noteADSR", + "params": [ + { + "name": "note", + "description": "

    Midi note on which ADSR should be set.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "attackTime", + "description": "

    Time (in seconds before envelope\n reaches Attack Level

    \n", + "type": "Number", + "optional": true + }, + { + "name": "decayTime", + "description": "

    Time (in seconds) before envelope\n reaches Decay/Sustain Level

    \n", + "type": "Number", + "optional": true + }, + { + "name": "susRatio", + "description": "

    Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "releaseTime", + "description": "

    Time in seconds from now (defaults to 0)

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12533, + "description": "

    Set the PolySynths global envelope. This method modifies the envelopes of each\nmonosynth so that all notes are played with this envelope.

    \n", + "itemtype": "method", + "name": "setADSR", + "params": [ + { + "name": "attackTime", + "description": "

    Time (in seconds before envelope\n reaches Attack Level

    \n", + "type": "Number", + "optional": true + }, + { + "name": "decayTime", + "description": "

    Time (in seconds) before envelope\n reaches Decay/Sustain Level

    \n", + "type": "Number", + "optional": true + }, + { + "name": "susRatio", + "description": "

    Ratio between attackLevel and releaseLevel, on a scale from 0 to 1,\n where 1.0 = attackLevel, 0.0 = releaseLevel.\n The susRatio determines the decayLevel and the level at which the\n sustain portion of the envelope will sustain.\n For example, if attackLevel is 0.4, releaseLevel is 0,\n and susAmt is 0.5, the decayLevel would be 0.2. If attackLevel is\n increased to 1.0 (using setRange),\n then decayLevel would increase proportionally, to become 0.5.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "releaseTime", + "description": "

    Time in seconds from now (defaults to 0)

    \n", + "type": "Number", + "optional": true + } + ], + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12557, + "description": "

    Trigger the Attack, and Decay portion of a MonoSynth.\nSimilar to holding down a key on a piano, but it will\nhold the sustain level until you let go.

    \n", + "itemtype": "method", + "name": "noteAttack", + "params": [ + { + "name": "note", + "description": "

    midi note on which attack should be triggered.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "velocity", + "description": "

    velocity of the note to play (ranging from 0 to 1)/

    \n", + "type": "Number", + "optional": true + }, + { + "name": "secondsFromNow", + "description": "

    time from now (in seconds)

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar polySynth = new p5.PolySynth();\nvar pitches = [\"G\", \"D\", \"G\", \"C\"];\nvar octaves = [2, 3, 4];\n\nfunction mousePressed() {\n // play a chord: multiple notes at the same time\n for (var i = 0; i < 4; i++) {\n var note = random(pitches) + random(octaves);\n polySynth.noteAttack(note, 0.1);\n }\n}\n\nfunction mouseReleased() {\n // release all voices\n polySynth.noteRelease();\n}\n
    " + ], + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12647, + "description": "

    Trigger the Release of an AudioVoice note. This is similar to releasing\nthe key on a piano and letting the sound fade according to the\nrelease level and release time.

    \n", + "itemtype": "method", + "name": "noteRelease", + "params": [ + { + "name": "note", + "description": "

    midi note on which attack should be triggered.\n If no value is provided, all notes will be released.

    \n", + "type": "Number", + "optional": true + }, + { + "name": "secondsFromNow", + "description": "

    time to trigger the release

    \n", + "type": "Number", + "optional": true + } + ], + "example": [ + "\n
    \nvar pitches = [\"G\", \"D\", \"G\", \"C\"];\nvar octaves = [2, 3, 4];\nvar polySynth = new p5.PolySynth();\n\nfunction mousePressed() {\n // play a chord: multiple notes at the same time\n for (var i = 0; i < 4; i++) {\n var note = random(pitches) + random(octaves);\n polySynth.noteAttack(note, 0.1);\n }\n}\n\nfunction mouseReleased() {\n // release all voices\n polySynth.noteRelease();\n}\n
    \n" + ], + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12712, + "description": "

    Connect to a p5.sound / Web Audio object.

    \n", + "itemtype": "method", + "name": "connect", + "params": [ + { + "name": "unit", + "description": "

    A p5.sound or Web Audio object

    \n", + "type": "Object" + } + ], + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12722, + "description": "

    Disconnect all outputs

    \n", + "itemtype": "method", + "name": "disconnect", + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12732, + "description": "

    Get rid of the MonoSynth and free up its resources / memory.

    \n", + "itemtype": "method", + "name": "dispose", + "class": "p5.PolySynth", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12800, + "description": "

    The p5.Distortion is built with a\n\nWeb Audio WaveShaper Node.

    \n", + "itemtype": "property", + "name": "WaveShaperNode", + "type": "AudioNode", + "class": "p5.Distortion", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12815, + "description": "

    Process a sound source, optionally specify amount and oversample values.

    \n", + "itemtype": "method", + "name": "process", + "params": [ + { + "name": "amount", + "description": "

    Unbounded distortion amount.\n Normal values range from 0-1.

    \n", + "type": "Number", + "optional": true, + "optdefault": "0.25" + }, + { + "name": "oversample", + "description": "

    'none', '2x', or '4x'.

    \n", + "type": "String", + "optional": true, + "optdefault": "'none'" + } + ], + "class": "p5.Distortion", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12827, + "description": "

    Set the amount and oversample of the waveshaper distortion.

    \n", + "itemtype": "method", + "name": "set", + "params": [ + { + "name": "amount", + "description": "

    Unbounded distortion amount.\n Normal values range from 0-1.

    \n", + "type": "Number", + "optional": true, + "optdefault": "0.25" + }, + { + "name": "oversample", + "description": "

    'none', '2x', or '4x'.

    \n", + "type": "String", + "optional": true, + "optdefault": "'none'" + } + ], + "class": "p5.Distortion", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12845, + "description": "

    Return the distortion amount, typically between 0-1.

    \n", + "itemtype": "method", + "name": "getAmount", + "return": { + "description": "Unbounded distortion amount.\n Normal values range from 0-1.", + "type": "Number" + }, + "class": "p5.Distortion", + "module": "p5.sound", + "submodule": "p5.sound" + }, + { + "file": "lib/addons/p5.sound.js", + "line": 12855, + "description": "

    Return the oversampling.

    \n", + "itemtype": "method", + "name": "getOversample", + "return": { + "description": "Oversample can either be 'none', '2x', or '4x'.", + "type": "String" + }, + "class": "p5.Distortion", + "module": "p5.sound", + "submodule": "p5.sound" + } + ], + "warnings": [ + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:16" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:61" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:91" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:134" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:332" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:363" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:400" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:497" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:527" + }, + { + "message": "unknown tag: alt", + "line": " src/color/creating_reading.js:567" + }, + { + "message": "unknown tag: alt", + "line": " src/color/p5.Color.js:52" + }, + { + "message": "unknown tag: alt", + "line": " src/color/p5.Color.js:253" + }, + { + "message": "unknown tag: alt", + "line": " src/color/p5.Color.js:280" + }, + { + "message": "unknown tag: alt", + "line": " src/color/p5.Color.js:307" + }, + { + "message": "unknown tag: alt", + "line": " src/color/p5.Color.js:334" + }, + { + "message": "unknown tag: alt", + "line": " src/color/p5.Color.js:768" + }, + { + "message": "unknown tag: alt", + "line": " src/color/setting.js:15" + }, + { + "message": "unknown tag: alt", + "line": " src/color/setting.js:181" + }, + { + "message": "unknown tag: alt", + "line": " src/color/setting.js:220" + }, + { + "message": "unknown tag: alt", + "line": " src/color/setting.js:341" + }, + { + "message": "unknown tag: alt", + "line": " src/color/setting.js:498" + }, + { + "message": "unknown tag: alt", + "line": " src/color/setting.js:539" + }, + { + "message": "unknown tag: alt", + "line": " src/color/setting.js:579" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:102" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:210" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:270" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:300" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:356" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:391" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:458" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:541" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/2d_primitives.js:595" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/attributes.js:14" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/attributes.js:83" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/attributes.js:116" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/attributes.js:185" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/attributes.js:219" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/attributes.js:256" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/attributes.js:323" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:13" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:96" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:139" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:194" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:273" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:364" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:406" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/curves.js:502" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:22" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:70" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:270" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:270" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:270" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:398" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:443" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:508" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:568" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:654" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:720" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:813" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:813" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:813" + }, + { + "message": "unknown tag: alt", + "line": " src/core/shape/vertex.js:813" + }, + { + "message": "unknown tag: alt", + "line": " src/core/constants.js:58" + }, + { + "message": "unknown tag: alt", + "line": " src/core/constants.js:77" + }, + { + "message": "unknown tag: alt", + "line": " src/core/constants.js:96" + }, + { + "message": "unknown tag: alt", + "line": " src/core/constants.js:115" + }, + { + "message": "unknown tag: alt", + "line": " src/core/constants.js:134" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:22" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:53" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:80" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:112" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:181" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:281" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:306" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:325" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:344" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:360" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:376" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:454" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:505" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/core/environment.js:540" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/core/environment.js:560" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:560" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:617" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:648" + }, + { + "message": "unknown tag: alt", + "line": " src/core/environment.js:671" + }, + { + "message": "unknown tag: alt", + "line": " src/core/main.js:49" + }, + { + "message": "unknown tag: alt", + "line": " src/core/main.js:90" + }, + { + "message": "unknown tag: alt", + "line": " src/core/main.js:121" + }, + { + "message": "unknown tag: alt", + "line": " src/core/main.js:401" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:52" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:122" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:162" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:197" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:258" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:307" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:373" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:427" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:483" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:541" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:584" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:626" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:674" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:714" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:763" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Element.js:801" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Graphics.js:65" + }, + { + "message": "unknown tag: alt", + "line": " src/core/p5.Graphics.js:117" + }, + { + "message": "unknown tag: alt", + "line": " src/core/rendering.js:17" + }, + { + "message": "unknown tag: alt", + "line": " src/core/rendering.js:119" + }, + { + "message": "unknown tag: alt", + "line": " src/core/rendering.js:174" + }, + { + "message": "unknown tag: alt", + "line": " src/core/rendering.js:197" + }, + { + "message": "unknown tag: alt", + "line": " src/core/rendering.js:236" + }, + { + "message": "unknown tag: alt", + "line": " src/core/structure.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/core/structure.js:74" + }, + { + "message": "unknown tag: alt", + "line": " src/core/structure.js:122" + }, + { + "message": "unknown tag: alt", + "line": " src/core/structure.js:191" + }, + { + "message": "unknown tag: alt", + "line": " src/core/structure.js:261" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:13" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:150" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:176" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:216" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:246" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:276" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:306" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:381" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:421" + }, + { + "message": "unknown tag: alt", + "line": " src/core/transform.js:461" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:23" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:46" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:69" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:135" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:166" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:197" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:233" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:278" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:322" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:380" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:419" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:462" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:506" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:538" + }, + { + "message": "unknown tag: alt", + "line": " src/events/acceleration.js:597" + }, + { + "message": "unknown tag: alt", + "line": " src/events/keyboard.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/events/keyboard.js:39" + }, + { + "message": "unknown tag: alt", + "line": " src/events/keyboard.js:68" + }, + { + "message": "unknown tag: alt", + "line": " src/events/keyboard.js:109" + }, + { + "message": "unknown tag: alt", + "line": " src/events/keyboard.js:196" + }, + { + "message": "unknown tag: alt", + "line": " src/events/keyboard.js:248" + }, + { + "message": "unknown tag: alt", + "line": " src/events/keyboard.js:312" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:22" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:48" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:74" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:106" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:137" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:176" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:215" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:256" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:298" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:337" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:428" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:483" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:564" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:641" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:719" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:789" + }, + { + "message": "unknown tag: alt", + "line": " src/events/mouse.js:874" + }, + { + "message": "unknown tag: alt", + "line": " src/events/touch.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/events/touch.js:74" + }, + { + "message": "unknown tag: alt", + "line": " src/events/touch.js:149" + }, + { + "message": "unknown tag: alt", + "line": " src/events/touch.js:222" + }, + { + "message": "unknown tag: alt", + "line": " src/image/image.js:22" + }, + { + "message": "unknown tag: alt", + "line": " src/image/image.js:102" + }, + { + "message": "unknown tag: alt", + "line": " src/image/image.js:195" + }, + { + "message": "unknown tag: alt", + "line": " src/image/loading_displaying.js:17" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/image/loading_displaying.js:110" + }, + { + "message": "unknown tag: alt", + "line": " src/image/loading_displaying.js:127" + }, + { + "message": "unknown tag: alt", + "line": " src/image/loading_displaying.js:298" + }, + { + "message": "unknown tag: alt", + "line": " src/image/loading_displaying.js:398" + }, + { + "message": "unknown tag: alt", + "line": " src/image/loading_displaying.js:464" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:90" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:117" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:153" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:232" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:268" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:316" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:371" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:409" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:494" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:575" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:638" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:674" + }, + { + "message": "unknown tag: alt", + "line": " src/image/p5.Image.js:796" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:14" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:83" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:177" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:236" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:415" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:506" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:543" + }, + { + "message": "unknown tag: alt", + "line": " src/image/pixels.js:617" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:19" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:180" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:293" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:603" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/io/files.js:714" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:714" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:1519" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:1577" + }, + { + "message": "unknown tag: alt", + "line": " src/io/files.js:1645" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:56" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:120" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:168" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:214" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:263" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:328" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:523" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:576" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:618" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:879" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:944" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:994" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:1040" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:1085" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:1132" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:1177" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:1230" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.Table.js:1296" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.TableRow.js:42" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.TableRow.js:106" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.TableRow.js:150" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.TableRow.js:195" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.TableRow.js:243" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.TableRow.js:299" + }, + { + "message": "unknown tag: alt", + "line": " src/io/p5.XML.js:11" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:36" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:76" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:121" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:190" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:240" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:279" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:327" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:383" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:422" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:478" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:528" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:578" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:631" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:665" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:704" + }, + { + "message": "unknown tag: alt", + "line": " src/math/calculation.js:751" + }, + { + "message": "unknown tag: alt", + "line": " src/math/math.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/math/noise.js:40" + }, + { + "message": "unknown tag: alt", + "line": " src/math/noise.js:187" + }, + { + "message": "unknown tag: alt", + "line": " src/math/noise.js:253" + }, + { + "message": "unknown tag: alt", + "line": " src/math/p5.Vector.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/math/random.js:48" + }, + { + "message": "unknown tag: alt", + "line": " src/math/random.js:79" + }, + { + "message": "unknown tag: alt", + "line": " src/math/random.js:166" + }, + { + "message": "unknown tag: alt", + "line": " src/math/trigonometry.js:124" + }, + { + "message": "unknown tag: alt", + "line": " src/math/trigonometry.js:160" + }, + { + "message": "unknown tag: alt", + "line": " src/math/trigonometry.js:188" + }, + { + "message": "unknown tag: alt", + "line": " src/math/trigonometry.js:216" + }, + { + "message": "unknown tag: alt", + "line": " src/math/trigonometry.js:296" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/math/trigonometry.js:332" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/math/trigonometry.js:347" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/math/trigonometry.js:362" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/attributes.js:13" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/attributes.js:84" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/attributes.js:122" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/attributes.js:154" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/attributes.js:191" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/loading_displaying.js:16" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/loading_displaying.js:143" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/loading_displaying.js:230" + }, + { + "message": "unknown tag: alt", + "line": " src/typography/p5.Font.js:32" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/conversion.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:15" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:44" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:132" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:243" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:319" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:381" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:459" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/string_functions.js:548" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/time_date.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/time_date.js:34" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/time_date.js:56" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/time_date.js:78" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/time_date.js:101" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/time_date.js:123" + }, + { + "message": "unknown tag: alt", + "line": " src/utilities/time_date.js:145" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/3d_primitives.js:14" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/interaction.js:13" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/interaction.js:146" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/interaction.js:146" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/interaction.js:146" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/interaction.js:146" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/interaction.js:146" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/interaction.js:380" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/light.js:12" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/light.js:87" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/light.js:185" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/light.js:287" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/loading.js:14" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/loading.js:14" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/loading.js:244" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:14" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/webgl/material.js:113" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:113" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:225" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:262" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:359" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:359" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:438" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:513" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:563" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/material.js:614" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:15" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:61" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:126" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:209" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:486" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:545" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:603" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:751" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:823" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.Camera.js:1088" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.RendererGL.js:228" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.RendererGL.js:474" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.RendererGL.js:516" + }, + { + "message": "unknown tag: alt", + "line": " src/webgl/p5.RendererGL.js:586" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:117" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/webgl/text.js:160" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:193" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:205" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:235" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:249" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:387" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " src/webgl/text.js:387" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:457" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:472" + }, + { + "message": "replacing incorrect tag: function with method", + "line": " src/webgl/text.js:547" + }, + { + "message": "unknown tag: alt", + "line": " lib/addons/p5.dom.js:245" + }, + { + "message": "unknown tag: alt", + "line": " lib/addons/p5.dom.js:313" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.dom.js:1463" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.dom.js:1525" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.dom.js:1629" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.dom.js:1668" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.dom.js:1762" + }, + { + "message": "unknown tag: alt", + "line": " lib/addons/p5.dom.js:2119" + }, + { + "message": "replacing incorrect tag: params with param", + "line": " lib/addons/p5.sound.js:2480" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.sound.js:2480" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.sound.js:3094" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.sound.js:7659" + }, + { + "message": "replacing incorrect tag: returns with return", + "line": " lib/addons/p5.sound.js:9626" + }, + { + "message": "Missing item type\nConversions adapted from .\n\nIn these functions, hue is always in the range [0, 1], just like all other\ncomponents are in the range [0, 1]. 'Brightness' and 'value' are used\ninterchangeably.", + "line": " src/color/color_conversion.js:10" + }, + { + "message": "Missing item type\nConvert an HSBA array to HSLA.", + "line": " src/color/color_conversion.js:21" + }, + { + "message": "Missing item type\nConvert an HSBA array to RGBA.", + "line": " src/color/color_conversion.js:47" + }, + { + "message": "Missing item type\nConvert an HSLA array to HSBA.", + "line": " src/color/color_conversion.js:102" + }, + { + "message": "Missing item type\nConvert an HSLA array to RGBA.\n\nWe need to change basis from HSLA to something that can be more easily be\nprojected onto RGBA. We will choose hue and brightness as our first two\ncomponents, and pick a convenient third one ('zest') so that we don't need\nto calculate formal HSBA saturation.", + "line": " src/color/color_conversion.js:125" + }, + { + "message": "Missing item type\nConvert an RGBA array to HSBA.", + "line": " src/color/color_conversion.js:189" + }, + { + "message": "Missing item type\nConvert an RGBA array to HSLA.", + "line": " src/color/color_conversion.js:228" + }, + { + "message": "Missing item type\nHue is the same in HSB and HSL, but the maximum value may be different.\nThis function will return the HSB-normalized saturation when supplied with\nan HSB color object, but will default to the HSL-normalized saturation\notherwise.", + "line": " src/color/p5.Color.js:415" + }, + { + "message": "Missing item type\nSaturation is scaled differently in HSB and HSL. This function will return\nthe HSB saturation when supplied with an HSB color object, but will default\nto the HSL saturation otherwise.", + "line": " src/color/p5.Color.js:446" + }, + { + "message": "Missing item type\nCSS named colors.", + "line": " src/color/p5.Color.js:465" + }, + { + "message": "Missing item type\nThese regular expressions are used to build up the patterns for matching\nviable CSS color strings: fragmenting the regexes in this way increases the\nlegibility and comprehensibility of the code.\n\nNote that RGB values of .9 are not parsed by IE, but are supported here for\ncolor string consistency.", + "line": " src/color/p5.Color.js:618" + }, + { + "message": "Missing item type\nFull color string patterns. The capture groups are necessary.", + "line": " src/color/p5.Color.js:631" + }, + { + "message": "Missing item type\nFor a number of different inputs, returns a color formatted as [r, g, b, a]\narrays, with each component normalized between 0 and 1.", + "line": " src/color/p5.Color.js:768" + }, + { + "message": "Missing item type\nFor HSB and HSL, interpret the gray level as a brightness/lightness\nvalue (they are equivalent when chroma is zero). For RGB, normalize the\ngray level according to the blue maximum.", + "line": " src/color/p5.Color.js:994" + }, + { + "message": "Missing item type\nThis function does 3 things:\n\n 1. Bounds the desired start/stop angles for an arc (in radians) so that:\n\n 0 <= start < TWO_PI ; start <= stop < start + TWO_PI\n\n This means that the arc rendering functions don't have to be concerned\n with what happens if stop is smaller than start, or if the arc 'goes\n round more than once', etc.: they can just start at start and increase\n until stop and the correct arc will be drawn.\n\n 2. Optionally adjusts the angles within each quadrant to counter the naive\n scaling of the underlying ellipse up from the unit circle. Without\n this, the angles become arbitrary when width != height: 45 degrees\n might be drawn at 5 degrees on a 'wide' ellipse, or at 85 degrees on\n a 'tall' ellipse.\n\n 3. Flags up when start and stop correspond to the same place on the\n underlying ellipse. This is useful if you want to do something special\n there (like rendering a whole ellipse instead).", + "line": " src/core/shape/2d_primitives.js:16" + }, + { + "message": "Missing item type\nReturns the current framerate.", + "line": " src/core/environment.js:255" + }, + { + "message": "Missing item type\nSpecifies the number of frames to be displayed every second. For example,\nthe function call frameRate(30) will attempt to refresh 30 times a second.\nIf the processor is not fast enough to maintain the specified rate, the\nframe rate will not be achieved. Setting the frame rate within setup() is\nrecommended. The default rate is 60 frames per second.\n\nCalling frameRate() with no arguments returns the current framerate.", + "line": " src/core/environment.js:265" + }, + { + "message": "Missing item type", + "line": " src/core/error_helpers.js:1" + }, + { + "message": "Missing item type\nValidates parameters\nparam {String} func the name of the function\nparam {Array} args user input arguments\n\nexample:\n var a;\n ellipse(10,10,a,5);\nconsole ouput:\n \"It looks like ellipse received an empty variable in spot #2.\"\n\nexample:\n ellipse(10,\"foo\",5,5);\nconsole output:\n \"ellipse was expecting a number for parameter #1,\n received \"foo\" instead.\"", + "line": " src/core/error_helpers.js:584" + }, + { + "message": "Missing item type\nPrints out all the colors in the color pallete with white text.\nFor color blindness testing.", + "line": " src/core/error_helpers.js:645" + }, + { + "message": "Missing item type", + "line": " src/core/helpers.js:1" + }, + { + "message": "Missing item type\n_globalInit\n\nTODO: ???\nif sketch is on window\nassume \"global\" mode\nand instantiate p5 automatically\notherwise do nothing", + "line": " src/core/init.js:5" + }, + { + "message": "Missing item type", + "line": " src/core/legacy.js:1" + }, + { + "message": "Missing item type\nHelper fxn for sharing pixel methods", + "line": " src/core/p5.Element.js:865" + }, + { + "message": "Missing item type\nResize our canvas element.", + "line": " src/core/p5.Renderer.js:97" + }, + { + "message": "Missing item type\nHelper fxn to check font type (system or otf)", + "line": " src/core/p5.Renderer.js:335" + }, + { + "message": "Missing item type\nHelper fxn to measure ascent and descent.\nAdapted from http://stackoverflow.com/a/25355178", + "line": " src/core/p5.Renderer.js:388" + }, + { + "message": "Missing item type\np5.Renderer2D\nThe 2D graphics canvas renderer class.\nextends p5.Renderer", + "line": " src/core/p5.Renderer2D.js:9" + }, + { + "message": "Missing item type\nGenerate a cubic Bezier representing an arc on the unit circle of total\nangle `size` radians, beginning `start` radians above the x-axis. Up to\nfour of these curves are combined to make a full arc.\n\nSee www.joecridge.me/bezier.pdf for an explanation of the method.", + "line": " src/core/p5.Renderer2D.js:405" + }, + { + "message": "Missing item type\nshim for Uint8ClampedArray.slice\n(allows arrayCopy to work with pixels[])\nwith thanks to http://halfpapstudios.com/blog/tag/html5-canvas/\nEnumerable set to false to protect for...in from\nUint8ClampedArray.prototype pollution.", + "line": " src/core/shim.js:23" + }, + { + "message": "Missing item type\nthis is implementation of Object.assign() which is unavailable in\nIE11 and (non-Chrome) Android browsers.\nThe assign() method is used to copy the values of all enumerable\nown properties from one or more source objects to a target object.\nIt will return the target object.\nModified from https://github.com/ljharb/object.assign", + "line": " src/core/shim.js:45" + }, + { + "message": "Missing item type\nprivate helper function to handle the user passing in objects\nduring construction or calls to create()", + "line": " src/data/p5.TypedDict.js:203" + }, + { + "message": "Missing item type\nprivate helper function to ensure that the user passed in valid\nvalues for the Dictionary type", + "line": " src/data/p5.TypedDict.js:394" + }, + { + "message": "Missing item type\nprivate helper function to ensure that the user passed in valid\nvalues for the Dictionary type", + "line": " src/data/p5.TypedDict.js:437" + }, + { + "message": "Missing item type\nprivate helper function for finding lowest or highest value\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'", + "line": " src/data/p5.TypedDict.js:554" + }, + { + "message": "Missing item type\nprivate helper function for finding lowest or highest key\nthe argument 'flip' is used to flip the comparison arrow\nfrom 'less than' to 'greater than'", + "line": " src/data/p5.TypedDict.js:621" + }, + { + "message": "Missing item type\n_updatePAccelerations updates the pAcceleration values", + "line": " src/events/acceleration.js:124" + }, + { + "message": "Missing item type\nThe onblur function is called when the user is no longer focused\non the p5 element. Because the keyup events will not fire if the user is\nnot focused on the element we must assume all keys currently down have\nbeen released.", + "line": " src/events/keyboard.js:302" + }, + { + "message": "Missing item type\nThe _areDownKeys function returns a boolean true if any keys pressed\nand a false if no keys are currently pressed.\n\nHelps avoid instances where multiple keys are pressed simultaneously and\nreleasing a single key will then switch the\nkeyIsPressed property to true.", + "line": " src/events/keyboard.js:389" + }, + { + "message": "Missing item type\nThis module defines the filters for use with image buffers.\n\nThis module is basically a collection of functions stored in an object\nas opposed to modules. The functions are destructive, modifying\nthe passed in canvas rather than creating a copy.\n\nGenerally speaking users of this module will use the Filters.apply method\non a canvas to create an effect.\n\nA number of functions are borrowed/adapted from\nhttp://www.html5rocks.com/en/tutorials/canvas/imagefilters/\nor the java processing implementation.", + "line": " src/image/filters.js:3" + }, + { + "message": "Missing item type\nReturns the pixel buffer for a canvas", + "line": " src/image/filters.js:26" + }, + { + "message": "Missing item type\nReturns a 32 bit number containing ARGB data at ith pixel in the\n1D array containing pixels data.", + "line": " src/image/filters.js:46" + }, + { + "message": "Missing item type\nModifies pixels RGBA values to values contained in the data object.", + "line": " src/image/filters.js:67" + }, + { + "message": "Missing item type\nReturns the ImageData object for a canvas\nhttps://developer.mozilla.org/en-US/docs/Web/API/ImageData", + "line": " src/image/filters.js:87" + }, + { + "message": "Missing item type\nReturns a blank ImageData object.", + "line": " src/image/filters.js:107" + }, + { + "message": "Missing item type\nApplys a filter function to a canvas.\n\nThe difference between this and the actual filter functions defined below\nis that the filter functions generally modify the pixel buffer but do\nnot actually put that data back to the canvas (where it would actually\nupdate what is visible). By contrast this method does make the changes\nactually visible in the canvas.\n\nThe apply method is the method that callers of this module would generally\nuse. It has been separated from the actual filters to support an advanced\nuse case of creating a filter chain that executes without actually updating\nthe canvas in between everystep.", + "line": " src/image/filters.js:122" + }, + { + "message": "Missing item type\nConverts the image to black and white pixels depending if they are above or\nbelow the threshold defined by the level parameter. The parameter must be\nbetween 0.0 (black) and 1.0 (white). If no level is specified, 0.5 is used.\n\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/", + "line": " src/image/filters.js:175" + }, + { + "message": "Missing item type\nConverts any colors in the image to grayscale equivalents.\nNo parameter is used.\n\nBorrowed from http://www.html5rocks.com/en/tutorials/canvas/imagefilters/", + "line": " src/image/filters.js:209" + }, + { + "message": "Missing item type\nSets the alpha channel to entirely opaque. No parameter is used.", + "line": " src/image/filters.js:232" + }, + { + "message": "Missing item type\nSets each pixel to its inverse value. No parameter is used.", + "line": " src/image/filters.js:248" + }, + { + "message": "Missing item type\nLimits each channel of the image to the number of colors specified as\nthe parameter. The parameter can be set to values between 2 and 255, but\nresults are most noticeable in the lower ranges.\n\nAdapted from java based processing implementation", + "line": " src/image/filters.js:263" + }, + { + "message": "Missing item type\nreduces the bright areas in an image", + "line": " src/image/filters.js:295" + }, + { + "message": "Missing item type\nincreases the bright areas in an image", + "line": " src/image/filters.js:383" + }, + { + "message": "Missing item type\nThis module defines the p5 methods for the p5.Image class\nfor drawing images to the main display canvas.", + "line": " src/image/image.js:8" + }, + { + "message": "Missing item type\nValidates clipping params. Per drawImage spec sWidth and sHight cannot be\nnegative or greater than image intrinsic width and height", + "line": " src/image/loading_displaying.js:110" + }, + { + "message": "Missing item type\nApply the current tint color to the input image, return the resulting\ncanvas.", + "line": " src/image/loading_displaying.js:427" + }, + { + "message": "Missing item type\nThis module defines the p5.Image class and P5 methods for\ndrawing images to the main display canvas.", + "line": " src/image/p5.Image.js:9" + }, + { + "message": "Missing item type\nHelper fxn for sharing pixel methods", + "line": " src/image/p5.Image.js:223" + }, + { + "message": "Missing item type\nGenerate a blob of file data as a url to prepare for download.\nAccepts an array of data, a filename, and an extension (optional).\nThis is a private function because it does not do any formatting,\nbut it is used by saveStrings, saveJSON, saveTable etc.", + "line": " src/io/files.js:1771" + }, + { + "message": "Missing item type\nReturns a file extension, or another string\nif the provided parameter has no extension.", + "line": " src/io/files.js:1840" + }, + { + "message": "Missing item type\nReturns true if the browser is Safari, false if not.\nSafari makes trouble for downloading files.", + "line": " src/io/files.js:1873" + }, + { + "message": "Missing item type\nHelper function, a callback for download that deletes\nan invisible anchor element from the DOM once the file\nhas been automatically downloaded.", + "line": " src/io/files.js:1885" + }, + { + "message": "Missing item type\nTable Options\n

    Generic class for handling tabular data, typically from a\nCSV, TSV, or other sort of spreadsheet file.

    \n

    CSV files are\n\ncomma separated values, often with the data in quotes. TSV\nfiles use tabs as separators, and usually don't bother with the\nquotes.

    \n

    File names should end with .csv if they're comma separated.

    \n

    A rough \"spec\" for CSV can be found\nhere.

    \n

    To load files, use the loadTable method.

    \n

    To save tables to your computer, use the save method\n or the saveTable method.

    \n\nPossible options include:\n
      \n
    • csv - parse the table as comma-separated values\n
    • tsv - parse the table as tab-separated values\n
    • header - this table has a header (title) row\n
    ", + "line": " src/io/p5.Table.js:11" + }, + { + "message": "Missing item type\nMultiplies a vector by a scalar and returns a new vector.", + "line": " src/math/p5.Vector.js:1611" + }, + { + "message": "Missing item type\nDivides a vector by a scalar and returns a new vector.", + "line": " src/math/p5.Vector.js:1638" + }, + { + "message": "Missing item type\nCalculates the dot product of two vectors.", + "line": " src/math/p5.Vector.js:1665" + }, + { + "message": "Missing item type\nCalculates the cross product of two vectors.", + "line": " src/math/p5.Vector.js:1679" + }, + { + "message": "Missing item type\nCalculates the Euclidean distance between two points (considering a\npoint as a vector object).", + "line": " src/math/p5.Vector.js:1693" + }, + { + "message": "Missing item type\nLinear interpolate a vector to another vector and return the result as a\nnew vector.", + "line": " src/math/p5.Vector.js:1708" + }, + { + "message": "Missing item type\nHelper function to measure ascent and descent.", + "line": " src/typography/attributes.js:284" + }, + { + "message": "Missing item type\nReturns the set of opentype glyphs for the supplied string.\n\nNote that there is not a strict one-to-one mapping between characters\nand glyphs, so the list of returned glyphs can be larger or smaller\n than the length of the given string.", + "line": " src/typography/p5.Font.js:255" + }, + { + "message": "Missing item type\nReturns an opentype path for the supplied string and position.", + "line": " src/typography/p5.Font.js:270" + }, + { + "message": "Missing item type", + "line": " src/webgl/3d_primitives.js:260" + }, + { + "message": "Missing item type\nDraws a point, a coordinate in space at the dimension of one pixel,\ngiven x, y and z coordinates. The color of the point is determined\nby the current stroke, while the point size is determined by current\nstroke weight.", + "line": " src/webgl/3d_primitives.js:732" + }, + { + "message": "Missing item type\nDraw a line given two points", + "line": " src/webgl/3d_primitives.js:1155" + }, + { + "message": "Missing item type\nParse OBJ lines into model. For reference, this is what a simple model of a\nsquare might look like:\n\nv -0.5 -0.5 0.5\nv -0.5 -0.5 -0.5\nv -0.5 0.5 -0.5\nv -0.5 0.5 0.5\n\nf 4 3 2 1", + "line": " src/webgl/loading.js:135" + }, + { + "message": "Missing item type", + "line": " src/webgl/material.js:659" + }, + { + "message": "Missing item type", + "line": " src/webgl/material.js:681" + }, + { + "message": "Missing item type\nCreate a 2D array for establishing stroke connections", + "line": " src/webgl/p5.Geometry.js:190" + }, + { + "message": "Missing item type\nCreate 4 vertices for each stroke line, two at the beginning position\nand two at the end position. These vertices are displaced relative to\nthat line's normal on the GPU", + "line": " src/webgl/p5.Geometry.js:211" + }, + { + "message": "Missing item type", + "line": " src/webgl/p5.Matrix.js:1" + }, + { + "message": "Missing item type\nPRIVATE", + "line": " src/webgl/p5.Matrix.js:730" + }, + { + "message": "Missing item type\nWelcome to RendererGL Immediate Mode.\nImmediate mode is used for drawing custom shapes\nfrom a set of vertices. Immediate Mode is activated\nwhen you call beginShape() & de-activated when you call endShape().\nImmediate mode is a style of programming borrowed\nfrom OpenGL's (now-deprecated) immediate mode.\nIt differs from p5.js' default, Retained Mode, which caches\ngeometries and buffers on the CPU to reduce the number of webgl\ndraw calls. Retained mode is more efficient & performative,\nhowever, Immediate Mode is useful for sketching quick\ngeometric ideas.", + "line": " src/webgl/p5.RendererGL.Immediate.js:1" + }, + { + "message": "Missing item type\nEnd shape drawing and render vertices to screen.", + "line": " src/webgl/p5.RendererGL.Immediate.js:133" + }, + { + "message": "Missing item type\ninitializes buffer defaults. runs each time a new geometry is\nregistered", + "line": " src/webgl/p5.RendererGL.Retained.js:8" + }, + { + "message": "Missing item type\ncreateBuffers description", + "line": " src/webgl/p5.RendererGL.Retained.js:47" + }, + { + "message": "Missing item type\nDraws buffers given a geometry key ID", + "line": " src/webgl/p5.RendererGL.Retained.js:196" + }, + { + "message": "Missing item type\nmodel view, projection, & normal\nmatrices", + "line": " src/webgl/p5.RendererGL.js:80" + }, + { + "message": "Missing item type\n[background description]", + "line": " src/webgl/p5.RendererGL.js:456" + }, + { + "message": "Missing item type\n[resize description]", + "line": " src/webgl/p5.RendererGL.js:707" + }, + { + "message": "Missing item type\nclears color and depth buffers\nwith r,g,b,a", + "line": " src/webgl/p5.RendererGL.js:738" + }, + { + "message": "Missing item type\n[translate description]", + "line": " src/webgl/p5.RendererGL.js:771" + }, + { + "message": "Missing item type\nScales the Model View Matrix by a vector", + "line": " src/webgl/p5.RendererGL.js:790" + }, + { + "message": "Missing item type\nturn a two dimensional array into one dimensional array", + "line": " src/webgl/p5.RendererGL.js:1139" + }, + { + "message": "Missing item type\nturn a p5.Vector Array into a one dimensional number array", + "line": " src/webgl/p5.RendererGL.js:1176" + }, + { + "message": "Missing item type\nensures that p5 is using a 3d renderer. throws an error if not.", + "line": " src/webgl/p5.RendererGL.js:1192" + }, + { + "message": "Missing item type\nHelper function for select and selectAll", + "line": " lib/addons/p5.dom.js:168" + }, + { + "message": "Missing item type\nHelper function for getElement and getElements.", + "line": " lib/addons/p5.dom.js:184" + }, + { + "message": "Missing item type\nHelpers for create methods.", + "line": " lib/addons/p5.dom.js:348" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.dom.js:488" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.dom.js:1070" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.dom.js:1159" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.dom.js:1199" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.dom.js:3029" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.dom.js:3095" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.dom.js:3157" + }, + { + "message": "Missing item type\np5.sound \nhttps://p5js.org/reference/#/libraries/p5.sound\n\nFrom the Processing Foundation and contributors\nhttps://github.com/processing/p5.js-sound/graphs/contributors\n\nMIT License (MIT)\nhttps://github.com/processing/p5.js-sound/blob/master/LICENSE\n\nSome of the many audio libraries & resources that inspire p5.sound:\n - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js\n - buzz.js (c) Jay Salvat. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/\n - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0\n - wavesurfer.js https://github.com/katspaugh/wavesurfer.js\n - Web Audio Components by Jordan Santell https://github.com/web-audio-components\n - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound\n\n Web Audio API: http://w3.org/TR/webaudio/", + "line": " lib/addons/p5.sound.js:46" + }, + { + "message": "Missing item type\nDetermine which filetypes are supported (inspired by buzz.js)\nThe audio element (el) will only be used to test browser support for various audio formats", + "line": " lib/addons/p5.sound.js:214" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:363" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:740" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:810" + }, + { + "message": "Missing item type\nMaster contains AudioContext and the master sound output.", + "line": " lib/addons/p5.sound.js:1099" + }, + { + "message": "Missing item type\na silent connection to the DesinationNode\nwhich will ensure that anything connected to it\nwill not be garbage collected", + "line": " lib/addons/p5.sound.js:1194" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:1210" + }, + { + "message": "Missing item type\nUsed by Osc and Envelope to chain signal math", + "line": " lib/addons/p5.sound.js:1415" + }, + { + "message": "Missing item type\nThis is a helper function that the p5.SoundFile calls to load\nitself. Accepts a callback (the name of another function)\nas an optional parameter.", + "line": " lib/addons/p5.sound.js:1813" + }, + { + "message": "Missing item type\nStop playback on all of this soundfile's sources.", + "line": " lib/addons/p5.sound.js:2218" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:2656" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:2934" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4055" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4076" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4135" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4453" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4625" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4783" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4824" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:4881" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:5049" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:5097" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:5128" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:5149" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:5169" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:5879" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:6082" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7750" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7766" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7790" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7816" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7838" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7860" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7906" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7937" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:7955" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:8292" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:8314" + }, + { + "message": "Missing item type\nThe p5.Effect class is built\n \tusing Tone.js CrossFade", + "line": " lib/addons/p5.sound.js:8384" + }, + { + "message": "Missing item type\nIn classes that extend\np5.Effect, connect effect nodes\nto the wet parameter", + "line": " lib/addons/p5.sound.js:8390" + }, + { + "message": "Missing item type\nEQFilter extends p5.Filter with constraints\nnecessary for the p5.EQ", + "line": " lib/addons/p5.sound.js:8779" + }, + { + "message": "Missing item type\nInspired by Simple Reverb by Jordan Santell\nhttps://github.com/web-audio-components/simple-reverb/blob/master/index.js\n\nUtility function for building an impulse response\nbased on the module parameters.", + "line": " lib/addons/p5.sound.js:9889" + }, + { + "message": "Missing item type\nPrivate method to load a buffer as an Impulse Response,\nassign it to the convolverNode, and add to the Array of .impulses.", + "line": " lib/addons/p5.sound.js:10056" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:10240" + }, + { + "message": "Missing item type", + "line": " lib/addons/p5.sound.js:10265" + }, + { + "message": "Missing item type\nmusicalTimeMode variables\nmodify these only when the interval is specified in musicalTime format as a string", + "line": " lib/addons/p5.sound.js:10989" + }, + { + "message": "Missing item type\nDo not initiate the callback if timeFromNow is < 0\nThis ususually occurs for a few milliseconds when the page\nis not fully loaded\n\nThe callback should only be called until maxIterations is reached", + "line": " lib/addons/p5.sound.js:11005" + }, + { + "message": "Missing item type\ncallback invoked when the recording is over", + "line": " lib/addons/p5.sound.js:11495" + }, + { + "message": "Missing item type\ninternal method called on audio process", + "line": " lib/addons/p5.sound.js:11581" + }, + { + "message": "Missing item type\nPrivate method to ensure accurate values of this._voicesInUse\nAny time a new value is scheduled, it is necessary to increment all subsequent\nscheduledValues after attack, and decrement all subsequent\nscheduledValues after release", + "line": " lib/addons/p5.sound.js:12627" + }, + { + "message": "Missing item type\np5.sound \nhttps://p5js.org/reference/#/libraries/p5.sound\n\nFrom the Processing Foundation and contributors\nhttps://github.com/processing/p5.js-sound/graphs/contributors\n\nMIT License (MIT)\nhttps://github.com/processing/p5.js-sound/blob/master/LICENSE\n\nSome of the many audio libraries & resources that inspire p5.sound:\n - TONE.js (c) Yotam Mann. Licensed under The MIT License (MIT). https://github.com/TONEnoTONE/Tone.js\n - buzz.js (c) Jay Salvat. Licensed under The MIT License (MIT). http://buzz.jaysalvat.com/\n - Boris Smus Web Audio API book, 2013. Licensed under the Apache License http://www.apache.org/licenses/LICENSE-2.0\n - wavesurfer.js https://github.com/katspaugh/wavesurfer.js\n - Web Audio Components by Jordan Santell https://github.com/web-audio-components\n - Wilm Thoben's Sound library for Processing https://github.com/processing/processing/tree/master/java/libraries/sound\n\n Web Audio API: http://w3.org/TR/webaudio/", + "line": " lib/addons/p5.sound.min.js:3" + } + ], + "consts": { + "RGB": [ + "p5.colorMode" + ], + "HSB": [ + "p5.colorMode" + ], + "HSL": [ + "p5.colorMode" + ], + "CHORD": [ + "p5.arc" + ], + "PIE": [ + "p5.arc" + ], + "OPEN": [ + "p5.arc" + ], + "CENTER": [ + "p5.ellipseMode", + "p5.rectMode", + "p5.imageMode", + "p5.textAlign" + ], + "RADIUS": [ + "p5.ellipseMode", + "p5.rectMode" + ], + "CORNER": [ + "p5.ellipseMode", + "p5.rectMode", + "p5.imageMode" + ], + "CORNERS": [ + "p5.ellipseMode", + "p5.rectMode", + "p5.imageMode" + ], + "SQUARE": [ + "p5.strokeCap" + ], + "PROJECT": [ + "p5.strokeCap" + ], + "ROUND": [ + "p5.strokeCap", + "p5.strokeJoin" + ], + "MITER": [ + "p5.strokeJoin" + ], + "BEVEL": [ + "p5.strokeJoin" + ], + "POINTS": [ + "p5.beginShape" + ], + "LINES": [ + "p5.beginShape" + ], + "TRIANGLES": [ + "p5.beginShape" + ], + "TRIANGLE_FAN": [ + "p5.beginShape" + ], + "TRIANGLE_STRIP": [ + "p5.beginShape" + ], + "QUADS": [ + "p5.beginShape" + ], + "QUAD_STRIP": [ + "p5.beginShape" + ], + "CLOSE": [ + "p5.endShape" + ], + "ARROW": [ + "p5.cursor" + ], + "CROSS": [ + "p5.cursor" + ], + "HAND": [ + "p5.cursor" + ], + "MOVE": [ + "p5.cursor" + ], + "TEXT": [ + "p5.cursor" + ], + "P2D": [ + "p5.createCanvas", + "p5.createGraphics" + ], + "WEBGL": [ + "p5.createCanvas", + "p5.createGraphics" + ], + "BLEND": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "DARKEST": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "LIGHTEST": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "DIFFERENCE": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "MULTIPLY": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "EXCLUSION": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "SCREEN": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "REPLACE": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "OVERLAY": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "HARD_LIGHT": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "SOFT_LIGHT": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "DODGE": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "BURN": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "ADD": [ + "p5.blendMode", + "p5.Image.blend", + "p5.blend" + ], + "SUBTRACT": [ + "p5.blendMode" + ], + "THRESHOLD": [ + "p5.Image.filter", + "p5.filter" + ], + "GRAY": [ + "p5.Image.filter", + "p5.filter" + ], + "OPAQUE": [ + "p5.Image.filter", + "p5.filter" + ], + "INVERT": [ + "p5.Image.filter", + "p5.filter" + ], + "POSTERIZE": [ + "p5.Image.filter", + "p5.filter" + ], + "BLUR": [ + "p5.Image.filter", + "p5.filter" + ], + "ERODE": [ + "p5.Image.filter", + "p5.filter" + ], + "DILATE": [ + "p5.Image.filter", + "p5.filter" + ], + "NORMAL": [ + "p5.Image.blend", + "p5.blend", + "p5.textStyle", + "p5.textureMode" + ], + "RADIANS": [ + "p5.angleMode" + ], + "DEGREES": [ + "p5.angleMode" + ], + "LEFT": [ + "p5.textAlign" + ], + "RIGHT": [ + "p5.textAlign" + ], + "TOP": [ + "p5.textAlign" + ], + "BOTTOM": [ + "p5.textAlign" + ], + "BASELINE": [ + "p5.textAlign" + ], + "ITALIC": [ + "p5.textStyle" + ], + "BOLD": [ + "p5.textStyle" + ], + "BOLDITALIC": [ + "p5.textStyle" + ], + "IMAGE": [ + "p5.textureMode" + ], + "CLAMP": [ + "p5.textureWrap" + ], + "REPEAT": [ + "p5.textureWrap" + ], + "MIRROR": [ + "p5.textureWrap" + ], + "VIDEO": [ + "p5.createCapture" + ], + "AUDIO": [ + "p5.createCapture" + ] + } +} +},{}],2:[function(_dereq_,module,exports){ +'use strict' + +exports.byteLength = byteLength +exports.toByteArray = toByteArray +exports.fromByteArray = fromByteArray + +var lookup = [] +var revLookup = [] +var Arr = typeof Uint8Array !== 'undefined' ? Uint8Array : Array + +var code = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/' +for (var i = 0, len = code.length; i < len; ++i) { + lookup[i] = code[i] + revLookup[code.charCodeAt(i)] = i +} + +// Support decoding URL-safe base64 strings, as Node.js does. +// See: https://en.wikipedia.org/wiki/Base64#URL_applications +revLookup['-'.charCodeAt(0)] = 62 +revLookup['_'.charCodeAt(0)] = 63 + +function getLens (b64) { + var len = b64.length + + if (len % 4 > 0) { + throw new Error('Invalid string. Length must be a multiple of 4') + } + + // Trim off extra bytes after placeholder bytes are found + // See: https://github.com/beatgammit/base64-js/issues/42 + var validLen = b64.indexOf('=') + if (validLen === -1) validLen = len + + var placeHoldersLen = validLen === len + ? 0 + : 4 - (validLen % 4) + + return [validLen, placeHoldersLen] +} + +// base64 is 4/3 + up to two characters of the original data +function byteLength (b64) { + var lens = getLens(b64) + var validLen = lens[0] + var placeHoldersLen = lens[1] + return ((validLen + placeHoldersLen) * 3 / 4) - placeHoldersLen +} + +function _byteLength (b64, validLen, placeHoldersLen) { + return ((validLen + placeHoldersLen) * 3 / 4) - placeHoldersLen +} + +function toByteArray (b64) { + var tmp + var lens = getLens(b64) + var validLen = lens[0] + var placeHoldersLen = lens[1] + + var arr = new Arr(_byteLength(b64, validLen, placeHoldersLen)) + + var curByte = 0 + + // if there are placeholders, only get up to the last complete 4 chars + var len = placeHoldersLen > 0 + ? validLen - 4 + : validLen + + for (var i = 0; i < len; i += 4) { + tmp = + (revLookup[b64.charCodeAt(i)] << 18) | + (revLookup[b64.charCodeAt(i + 1)] << 12) | + (revLookup[b64.charCodeAt(i + 2)] << 6) | + revLookup[b64.charCodeAt(i + 3)] + arr[curByte++] = (tmp >> 16) & 0xFF + arr[curByte++] = (tmp >> 8) & 0xFF + arr[curByte++] = tmp & 0xFF + } + + if (placeHoldersLen === 2) { + tmp = + (revLookup[b64.charCodeAt(i)] << 2) | + (revLookup[b64.charCodeAt(i + 1)] >> 4) + arr[curByte++] = tmp & 0xFF + } + + if (placeHoldersLen === 1) { + tmp = + (revLookup[b64.charCodeAt(i)] << 10) | + (revLookup[b64.charCodeAt(i + 1)] << 4) | + (revLookup[b64.charCodeAt(i + 2)] >> 2) + arr[curByte++] = (tmp >> 8) & 0xFF + arr[curByte++] = tmp & 0xFF + } + + return arr +} + +function tripletToBase64 (num) { + return lookup[num >> 18 & 0x3F] + + lookup[num >> 12 & 0x3F] + + lookup[num >> 6 & 0x3F] + + lookup[num & 0x3F] +} + +function encodeChunk (uint8, start, end) { + var tmp + var output = [] + for (var i = start; i < end; i += 3) { + tmp = + ((uint8[i] << 16) & 0xFF0000) + + ((uint8[i + 1] << 8) & 0xFF00) + + (uint8[i + 2] & 0xFF) + output.push(tripletToBase64(tmp)) + } + return output.join('') +} + +function fromByteArray (uint8) { + var tmp + var len = uint8.length + var extraBytes = len % 3 // if we have 1 byte left, pad 2 bytes + var parts = [] + var maxChunkLength = 16383 // must be multiple of 3 + + // go through the array every three bytes, we'll deal with trailing stuff later + for (var i = 0, len2 = len - extraBytes; i < len2; i += maxChunkLength) { + parts.push(encodeChunk( + uint8, i, (i + maxChunkLength) > len2 ? len2 : (i + maxChunkLength) + )) + } + + // pad the end with zeros, but make sure to not forget the extra bytes + if (extraBytes === 1) { + tmp = uint8[len - 1] + parts.push( + lookup[tmp >> 2] + + lookup[(tmp << 4) & 0x3F] + + '==' + ) + } else if (extraBytes === 2) { + tmp = (uint8[len - 2] << 8) + uint8[len - 1] + parts.push( + lookup[tmp >> 10] + + lookup[(tmp >> 4) & 0x3F] + + lookup[(tmp << 2) & 0x3F] + + '=' + ) + } + + return parts.join('') +} + +},{}],3:[function(_dereq_,module,exports){ + +},{}],4:[function(_dereq_,module,exports){ +/*! + * The buffer module from node.js, for the browser. + * + * @author Feross Aboukhadijeh + * @license MIT + */ +/* eslint-disable no-proto */ + +'use strict' + +var base64 = _dereq_('base64-js') +var ieee754 = _dereq_('ieee754') + +exports.Buffer = Buffer +exports.SlowBuffer = SlowBuffer +exports.INSPECT_MAX_BYTES = 50 + +var K_MAX_LENGTH = 0x7fffffff +exports.kMaxLength = K_MAX_LENGTH + +/** + * If `Buffer.TYPED_ARRAY_SUPPORT`: + * === true Use Uint8Array implementation (fastest) + * === false Print warning and recommend using `buffer` v4.x which has an Object + * implementation (most compatible, even IE6) + * + * Browsers that support typed arrays are IE 10+, Firefox 4+, Chrome 7+, Safari 5.1+, + * Opera 11.6+, iOS 4.2+. + * + * We report that the browser does not support typed arrays if the are not subclassable + * using __proto__. Firefox 4-29 lacks support for adding new properties to `Uint8Array` + * (See: https://bugzilla.mozilla.org/show_bug.cgi?id=695438). IE 10 lacks support + * for __proto__ and has a buggy typed array implementation. + */ +Buffer.TYPED_ARRAY_SUPPORT = typedArraySupport() + +if (!Buffer.TYPED_ARRAY_SUPPORT && typeof console !== 'undefined' && + typeof console.error === 'function') { + console.error( + 'This browser lacks typed array (Uint8Array) support which is required by ' + + '`buffer` v5.x. Use `buffer` v4.x if you require old browser support.' + ) +} + +function typedArraySupport () { + // Can typed array instances can be augmented? + try { + var arr = new Uint8Array(1) + arr.__proto__ = { __proto__: Uint8Array.prototype, foo: function () { return 42 } } + return arr.foo() === 42 + } catch (e) { + return false + } +} + +Object.defineProperty(Buffer.prototype, 'parent', { + enumerable: true, + get: function () { + if (!Buffer.isBuffer(this)) return undefined + return this.buffer + } +}) + +Object.defineProperty(Buffer.prototype, 'offset', { + enumerable: true, + get: function () { + if (!Buffer.isBuffer(this)) return undefined + return this.byteOffset + } +}) + +function createBuffer (length) { + if (length > K_MAX_LENGTH) { + throw new RangeError('The value "' + length + '" is invalid for option "size"') + } + // Return an augmented `Uint8Array` instance + var buf = new Uint8Array(length) + buf.__proto__ = Buffer.prototype + return buf +} + +/** + * The Buffer constructor returns instances of `Uint8Array` that have their + * prototype changed to `Buffer.prototype`. Furthermore, `Buffer` is a subclass of + * `Uint8Array`, so the returned instances will have all the node `Buffer` methods + * and the `Uint8Array` methods. Square bracket notation works as expected -- it + * returns a single octet. + * + * The `Uint8Array` prototype remains unmodified. + */ + +function Buffer (arg, encodingOrOffset, length) { + // Common case. + if (typeof arg === 'number') { + if (typeof encodingOrOffset === 'string') { + throw new TypeError( + 'The "string" argument must be of type string. Received type number' + ) + } + return allocUnsafe(arg) + } + return from(arg, encodingOrOffset, length) +} + +// Fix subarray() in ES2016. See: https://github.com/feross/buffer/pull/97 +if (typeof Symbol !== 'undefined' && Symbol.species != null && + Buffer[Symbol.species] === Buffer) { + Object.defineProperty(Buffer, Symbol.species, { + value: null, + configurable: true, + enumerable: false, + writable: false + }) +} + +Buffer.poolSize = 8192 // not used by this implementation + +function from (value, encodingOrOffset, length) { + if (typeof value === 'string') { + return fromString(value, encodingOrOffset) + } + + if (ArrayBuffer.isView(value)) { + return fromArrayLike(value) + } + + if (value == null) { + throw TypeError( + 'The first argument must be one of type string, Buffer, ArrayBuffer, Array, ' + + 'or Array-like Object. Received type ' + (typeof value) + ) + } + + if (isInstance(value, ArrayBuffer) || + (value && isInstance(value.buffer, ArrayBuffer))) { + return fromArrayBuffer(value, encodingOrOffset, length) + } + + if (typeof value === 'number') { + throw new TypeError( + 'The "value" argument must not be of type number. Received type number' + ) + } + + var valueOf = value.valueOf && value.valueOf() + if (valueOf != null && valueOf !== value) { + return Buffer.from(valueOf, encodingOrOffset, length) + } + + var b = fromObject(value) + if (b) return b + + if (typeof Symbol !== 'undefined' && Symbol.toPrimitive != null && + typeof value[Symbol.toPrimitive] === 'function') { + return Buffer.from( + value[Symbol.toPrimitive]('string'), encodingOrOffset, length + ) + } + + throw new TypeError( + 'The first argument must be one of type string, Buffer, ArrayBuffer, Array, ' + + 'or Array-like Object. Received type ' + (typeof value) + ) +} + +/** + * Functionally equivalent to Buffer(arg, encoding) but throws a TypeError + * if value is a number. + * Buffer.from(str[, encoding]) + * Buffer.from(array) + * Buffer.from(buffer) + * Buffer.from(arrayBuffer[, byteOffset[, length]]) + **/ +Buffer.from = function (value, encodingOrOffset, length) { + return from(value, encodingOrOffset, length) +} + +// Note: Change prototype *after* Buffer.from is defined to workaround Chrome bug: +// https://github.com/feross/buffer/pull/148 +Buffer.prototype.__proto__ = Uint8Array.prototype +Buffer.__proto__ = Uint8Array + +function assertSize (size) { + if (typeof size !== 'number') { + throw new TypeError('"size" argument must be of type number') + } else if (size < 0) { + throw new RangeError('The value "' + size + '" is invalid for option "size"') + } +} + +function alloc (size, fill, encoding) { + assertSize(size) + if (size <= 0) { + return createBuffer(size) + } + if (fill !== undefined) { + // Only pay attention to encoding if it's a string. This + // prevents accidentally sending in a number that would + // be interpretted as a start offset. + return typeof encoding === 'string' + ? createBuffer(size).fill(fill, encoding) + : createBuffer(size).fill(fill) + } + return createBuffer(size) +} + +/** + * Creates a new filled Buffer instance. + * alloc(size[, fill[, encoding]]) + **/ +Buffer.alloc = function (size, fill, encoding) { + return alloc(size, fill, encoding) +} + +function allocUnsafe (size) { + assertSize(size) + return createBuffer(size < 0 ? 0 : checked(size) | 0) +} + +/** + * Equivalent to Buffer(num), by default creates a non-zero-filled Buffer instance. + * */ +Buffer.allocUnsafe = function (size) { + return allocUnsafe(size) +} +/** + * Equivalent to SlowBuffer(num), by default creates a non-zero-filled Buffer instance. + */ +Buffer.allocUnsafeSlow = function (size) { + return allocUnsafe(size) +} + +function fromString (string, encoding) { + if (typeof encoding !== 'string' || encoding === '') { + encoding = 'utf8' + } + + if (!Buffer.isEncoding(encoding)) { + throw new TypeError('Unknown encoding: ' + encoding) + } + + var length = byteLength(string, encoding) | 0 + var buf = createBuffer(length) + + var actual = buf.write(string, encoding) + + if (actual !== length) { + // Writing a hex string, for example, that contains invalid characters will + // cause everything after the first invalid character to be ignored. (e.g. + // 'abxxcd' will be treated as 'ab') + buf = buf.slice(0, actual) + } + + return buf +} + +function fromArrayLike (array) { + var length = array.length < 0 ? 0 : checked(array.length) | 0 + var buf = createBuffer(length) + for (var i = 0; i < length; i += 1) { + buf[i] = array[i] & 255 + } + return buf +} + +function fromArrayBuffer (array, byteOffset, length) { + if (byteOffset < 0 || array.byteLength < byteOffset) { + throw new RangeError('"offset" is outside of buffer bounds') + } + + if (array.byteLength < byteOffset + (length || 0)) { + throw new RangeError('"length" is outside of buffer bounds') + } + + var buf + if (byteOffset === undefined && length === undefined) { + buf = new Uint8Array(array) + } else if (length === undefined) { + buf = new Uint8Array(array, byteOffset) + } else { + buf = new Uint8Array(array, byteOffset, length) + } + + // Return an augmented `Uint8Array` instance + buf.__proto__ = Buffer.prototype + return buf +} + +function fromObject (obj) { + if (Buffer.isBuffer(obj)) { + var len = checked(obj.length) | 0 + var buf = createBuffer(len) + + if (buf.length === 0) { + return buf + } + + obj.copy(buf, 0, 0, len) + return buf + } + + if (obj.length !== undefined) { + if (typeof obj.length !== 'number' || numberIsNaN(obj.length)) { + return createBuffer(0) + } + return fromArrayLike(obj) + } + + if (obj.type === 'Buffer' && Array.isArray(obj.data)) { + return fromArrayLike(obj.data) + } +} + +function checked (length) { + // Note: cannot use `length < K_MAX_LENGTH` here because that fails when + // length is NaN (which is otherwise coerced to zero.) + if (length >= K_MAX_LENGTH) { + throw new RangeError('Attempt to allocate Buffer larger than maximum ' + + 'size: 0x' + K_MAX_LENGTH.toString(16) + ' bytes') + } + return length | 0 +} + +function SlowBuffer (length) { + if (+length != length) { // eslint-disable-line eqeqeq + length = 0 + } + return Buffer.alloc(+length) +} + +Buffer.isBuffer = function isBuffer (b) { + return b != null && b._isBuffer === true && + b !== Buffer.prototype // so Buffer.isBuffer(Buffer.prototype) will be false +} + +Buffer.compare = function compare (a, b) { + if (isInstance(a, Uint8Array)) a = Buffer.from(a, a.offset, a.byteLength) + if (isInstance(b, Uint8Array)) b = Buffer.from(b, b.offset, b.byteLength) + if (!Buffer.isBuffer(a) || !Buffer.isBuffer(b)) { + throw new TypeError( + 'The "buf1", "buf2" arguments must be one of type Buffer or Uint8Array' + ) + } + + if (a === b) return 0 + + var x = a.length + var y = b.length + + for (var i = 0, len = Math.min(x, y); i < len; ++i) { + if (a[i] !== b[i]) { + x = a[i] + y = b[i] + break + } + } + + if (x < y) return -1 + if (y < x) return 1 + return 0 +} + +Buffer.isEncoding = function isEncoding (encoding) { + switch (String(encoding).toLowerCase()) { + case 'hex': + case 'utf8': + case 'utf-8': + case 'ascii': + case 'latin1': + case 'binary': + case 'base64': + case 'ucs2': + case 'ucs-2': + case 'utf16le': + case 'utf-16le': + return true + default: + return false + } +} + +Buffer.concat = function concat (list, length) { + if (!Array.isArray(list)) { + throw new TypeError('"list" argument must be an Array of Buffers') + } + + if (list.length === 0) { + return Buffer.alloc(0) + } + + var i + if (length === undefined) { + length = 0 + for (i = 0; i < list.length; ++i) { + length += list[i].length + } + } + + var buffer = Buffer.allocUnsafe(length) + var pos = 0 + for (i = 0; i < list.length; ++i) { + var buf = list[i] + if (isInstance(buf, Uint8Array)) { + buf = Buffer.from(buf) + } + if (!Buffer.isBuffer(buf)) { + throw new TypeError('"list" argument must be an Array of Buffers') + } + buf.copy(buffer, pos) + pos += buf.length + } + return buffer +} + +function byteLength (string, encoding) { + if (Buffer.isBuffer(string)) { + return string.length + } + if (ArrayBuffer.isView(string) || isInstance(string, ArrayBuffer)) { + return string.byteLength + } + if (typeof string !== 'string') { + throw new TypeError( + 'The "string" argument must be one of type string, Buffer, or ArrayBuffer. ' + + 'Received type ' + typeof string + ) + } + + var len = string.length + var mustMatch = (arguments.length > 2 && arguments[2] === true) + if (!mustMatch && len === 0) return 0 + + // Use a for loop to avoid recursion + var loweredCase = false + for (;;) { + switch (encoding) { + case 'ascii': + case 'latin1': + case 'binary': + return len + case 'utf8': + case 'utf-8': + return utf8ToBytes(string).length + case 'ucs2': + case 'ucs-2': + case 'utf16le': + case 'utf-16le': + return len * 2 + case 'hex': + return len >>> 1 + case 'base64': + return base64ToBytes(string).length + default: + if (loweredCase) { + return mustMatch ? -1 : utf8ToBytes(string).length // assume utf8 + } + encoding = ('' + encoding).toLowerCase() + loweredCase = true + } + } +} +Buffer.byteLength = byteLength + +function slowToString (encoding, start, end) { + var loweredCase = false + + // No need to verify that "this.length <= MAX_UINT32" since it's a read-only + // property of a typed array. + + // This behaves neither like String nor Uint8Array in that we set start/end + // to their upper/lower bounds if the value passed is out of range. + // undefined is handled specially as per ECMA-262 6th Edition, + // Section 13.3.3.7 Runtime Semantics: KeyedBindingInitialization. + if (start === undefined || start < 0) { + start = 0 + } + // Return early if start > this.length. Done here to prevent potential uint32 + // coercion fail below. + if (start > this.length) { + return '' + } + + if (end === undefined || end > this.length) { + end = this.length + } + + if (end <= 0) { + return '' + } + + // Force coersion to uint32. This will also coerce falsey/NaN values to 0. + end >>>= 0 + start >>>= 0 + + if (end <= start) { + return '' + } + + if (!encoding) encoding = 'utf8' + + while (true) { + switch (encoding) { + case 'hex': + return hexSlice(this, start, end) + + case 'utf8': + case 'utf-8': + return utf8Slice(this, start, end) + + case 'ascii': + return asciiSlice(this, start, end) + + case 'latin1': + case 'binary': + return latin1Slice(this, start, end) + + case 'base64': + return base64Slice(this, start, end) + + case 'ucs2': + case 'ucs-2': + case 'utf16le': + case 'utf-16le': + return utf16leSlice(this, start, end) + + default: + if (loweredCase) throw new TypeError('Unknown encoding: ' + encoding) + encoding = (encoding + '').toLowerCase() + loweredCase = true + } + } +} + +// This property is used by `Buffer.isBuffer` (and the `is-buffer` npm package) +// to detect a Buffer instance. It's not possible to use `instanceof Buffer` +// reliably in a browserify context because there could be multiple different +// copies of the 'buffer' package in use. This method works even for Buffer +// instances that were created from another copy of the `buffer` package. +// See: https://github.com/feross/buffer/issues/154 +Buffer.prototype._isBuffer = true + +function swap (b, n, m) { + var i = b[n] + b[n] = b[m] + b[m] = i +} + +Buffer.prototype.swap16 = function swap16 () { + var len = this.length + if (len % 2 !== 0) { + throw new RangeError('Buffer size must be a multiple of 16-bits') + } + for (var i = 0; i < len; i += 2) { + swap(this, i, i + 1) + } + return this +} + +Buffer.prototype.swap32 = function swap32 () { + var len = this.length + if (len % 4 !== 0) { + throw new RangeError('Buffer size must be a multiple of 32-bits') + } + for (var i = 0; i < len; i += 4) { + swap(this, i, i + 3) + swap(this, i + 1, i + 2) + } + return this +} + +Buffer.prototype.swap64 = function swap64 () { + var len = this.length + if (len % 8 !== 0) { + throw new RangeError('Buffer size must be a multiple of 64-bits') + } + for (var i = 0; i < len; i += 8) { + swap(this, i, i + 7) + swap(this, i + 1, i + 6) + swap(this, i + 2, i + 5) + swap(this, i + 3, i + 4) + } + return this +} + +Buffer.prototype.toString = function toString () { + var length = this.length + if (length === 0) return '' + if (arguments.length === 0) return utf8Slice(this, 0, length) + return slowToString.apply(this, arguments) +} + +Buffer.prototype.toLocaleString = Buffer.prototype.toString + +Buffer.prototype.equals = function equals (b) { + if (!Buffer.isBuffer(b)) throw new TypeError('Argument must be a Buffer') + if (this === b) return true + return Buffer.compare(this, b) === 0 +} + +Buffer.prototype.inspect = function inspect () { + var str = '' + var max = exports.INSPECT_MAX_BYTES + str = this.toString('hex', 0, max).replace(/(.{2})/g, '$1 ').trim() + if (this.length > max) str += ' ... ' + return '' +} + +Buffer.prototype.compare = function compare (target, start, end, thisStart, thisEnd) { + if (isInstance(target, Uint8Array)) { + target = Buffer.from(target, target.offset, target.byteLength) + } + if (!Buffer.isBuffer(target)) { + throw new TypeError( + 'The "target" argument must be one of type Buffer or Uint8Array. ' + + 'Received type ' + (typeof target) + ) + } + + if (start === undefined) { + start = 0 + } + if (end === undefined) { + end = target ? target.length : 0 + } + if (thisStart === undefined) { + thisStart = 0 + } + if (thisEnd === undefined) { + thisEnd = this.length + } + + if (start < 0 || end > target.length || thisStart < 0 || thisEnd > this.length) { + throw new RangeError('out of range index') + } + + if (thisStart >= thisEnd && start >= end) { + return 0 + } + if (thisStart >= thisEnd) { + return -1 + } + if (start >= end) { + return 1 + } + + start >>>= 0 + end >>>= 0 + thisStart >>>= 0 + thisEnd >>>= 0 + + if (this === target) return 0 + + var x = thisEnd - thisStart + var y = end - start + var len = Math.min(x, y) + + var thisCopy = this.slice(thisStart, thisEnd) + var targetCopy = target.slice(start, end) + + for (var i = 0; i < len; ++i) { + if (thisCopy[i] !== targetCopy[i]) { + x = thisCopy[i] + y = targetCopy[i] + break + } + } + + if (x < y) return -1 + if (y < x) return 1 + return 0 +} + +// Finds either the first index of `val` in `buffer` at offset >= `byteOffset`, +// OR the last index of `val` in `buffer` at offset <= `byteOffset`. +// +// Arguments: +// - buffer - a Buffer to search +// - val - a string, Buffer, or number +// - byteOffset - an index into `buffer`; will be clamped to an int32 +// - encoding - an optional encoding, relevant is val is a string +// - dir - true for indexOf, false for lastIndexOf +function bidirectionalIndexOf (buffer, val, byteOffset, encoding, dir) { + // Empty buffer means no match + if (buffer.length === 0) return -1 + + // Normalize byteOffset + if (typeof byteOffset === 'string') { + encoding = byteOffset + byteOffset = 0 + } else if (byteOffset > 0x7fffffff) { + byteOffset = 0x7fffffff + } else if (byteOffset < -0x80000000) { + byteOffset = -0x80000000 + } + byteOffset = +byteOffset // Coerce to Number. + if (numberIsNaN(byteOffset)) { + // byteOffset: it it's undefined, null, NaN, "foo", etc, search whole buffer + byteOffset = dir ? 0 : (buffer.length - 1) + } + + // Normalize byteOffset: negative offsets start from the end of the buffer + if (byteOffset < 0) byteOffset = buffer.length + byteOffset + if (byteOffset >= buffer.length) { + if (dir) return -1 + else byteOffset = buffer.length - 1 + } else if (byteOffset < 0) { + if (dir) byteOffset = 0 + else return -1 + } + + // Normalize val + if (typeof val === 'string') { + val = Buffer.from(val, encoding) + } + + // Finally, search either indexOf (if dir is true) or lastIndexOf + if (Buffer.isBuffer(val)) { + // Special case: looking for empty string/buffer always fails + if (val.length === 0) { + return -1 + } + return arrayIndexOf(buffer, val, byteOffset, encoding, dir) + } else if (typeof val === 'number') { + val = val & 0xFF // Search for a byte value [0-255] + if (typeof Uint8Array.prototype.indexOf === 'function') { + if (dir) { + return Uint8Array.prototype.indexOf.call(buffer, val, byteOffset) + } else { + return Uint8Array.prototype.lastIndexOf.call(buffer, val, byteOffset) + } + } + return arrayIndexOf(buffer, [ val ], byteOffset, encoding, dir) + } + + throw new TypeError('val must be string, number or Buffer') +} + +function arrayIndexOf (arr, val, byteOffset, encoding, dir) { + var indexSize = 1 + var arrLength = arr.length + var valLength = val.length + + if (encoding !== undefined) { + encoding = String(encoding).toLowerCase() + if (encoding === 'ucs2' || encoding === 'ucs-2' || + encoding === 'utf16le' || encoding === 'utf-16le') { + if (arr.length < 2 || val.length < 2) { + return -1 + } + indexSize = 2 + arrLength /= 2 + valLength /= 2 + byteOffset /= 2 + } + } + + function read (buf, i) { + if (indexSize === 1) { + return buf[i] + } else { + return buf.readUInt16BE(i * indexSize) + } + } + + var i + if (dir) { + var foundIndex = -1 + for (i = byteOffset; i < arrLength; i++) { + if (read(arr, i) === read(val, foundIndex === -1 ? 0 : i - foundIndex)) { + if (foundIndex === -1) foundIndex = i + if (i - foundIndex + 1 === valLength) return foundIndex * indexSize + } else { + if (foundIndex !== -1) i -= i - foundIndex + foundIndex = -1 + } + } + } else { + if (byteOffset + valLength > arrLength) byteOffset = arrLength - valLength + for (i = byteOffset; i >= 0; i--) { + var found = true + for (var j = 0; j < valLength; j++) { + if (read(arr, i + j) !== read(val, j)) { + found = false + break + } + } + if (found) return i + } + } + + return -1 +} + +Buffer.prototype.includes = function includes (val, byteOffset, encoding) { + return this.indexOf(val, byteOffset, encoding) !== -1 +} + +Buffer.prototype.indexOf = function indexOf (val, byteOffset, encoding) { + return bidirectionalIndexOf(this, val, byteOffset, encoding, true) +} + +Buffer.prototype.lastIndexOf = function lastIndexOf (val, byteOffset, encoding) { + return bidirectionalIndexOf(this, val, byteOffset, encoding, false) +} + +function hexWrite (buf, string, offset, length) { + offset = Number(offset) || 0 + var remaining = buf.length - offset + if (!length) { + length = remaining + } else { + length = Number(length) + if (length > remaining) { + length = remaining + } + } + + var strLen = string.length + + if (length > strLen / 2) { + length = strLen / 2 + } + for (var i = 0; i < length; ++i) { + var parsed = parseInt(string.substr(i * 2, 2), 16) + if (numberIsNaN(parsed)) return i + buf[offset + i] = parsed + } + return i +} + +function utf8Write (buf, string, offset, length) { + return blitBuffer(utf8ToBytes(string, buf.length - offset), buf, offset, length) +} + +function asciiWrite (buf, string, offset, length) { + return blitBuffer(asciiToBytes(string), buf, offset, length) +} + +function latin1Write (buf, string, offset, length) { + return asciiWrite(buf, string, offset, length) +} + +function base64Write (buf, string, offset, length) { + return blitBuffer(base64ToBytes(string), buf, offset, length) +} + +function ucs2Write (buf, string, offset, length) { + return blitBuffer(utf16leToBytes(string, buf.length - offset), buf, offset, length) +} + +Buffer.prototype.write = function write (string, offset, length, encoding) { + // Buffer#write(string) + if (offset === undefined) { + encoding = 'utf8' + length = this.length + offset = 0 + // Buffer#write(string, encoding) + } else if (length === undefined && typeof offset === 'string') { + encoding = offset + length = this.length + offset = 0 + // Buffer#write(string, offset[, length][, encoding]) + } else if (isFinite(offset)) { + offset = offset >>> 0 + if (isFinite(length)) { + length = length >>> 0 + if (encoding === undefined) encoding = 'utf8' + } else { + encoding = length + length = undefined + } + } else { + throw new Error( + 'Buffer.write(string, encoding, offset[, length]) is no longer supported' + ) + } + + var remaining = this.length - offset + if (length === undefined || length > remaining) length = remaining + + if ((string.length > 0 && (length < 0 || offset < 0)) || offset > this.length) { + throw new RangeError('Attempt to write outside buffer bounds') + } + + if (!encoding) encoding = 'utf8' + + var loweredCase = false + for (;;) { + switch (encoding) { + case 'hex': + return hexWrite(this, string, offset, length) + + case 'utf8': + case 'utf-8': + return utf8Write(this, string, offset, length) + + case 'ascii': + return asciiWrite(this, string, offset, length) + + case 'latin1': + case 'binary': + return latin1Write(this, string, offset, length) + + case 'base64': + // Warning: maxLength not taken into account in base64Write + return base64Write(this, string, offset, length) + + case 'ucs2': + case 'ucs-2': + case 'utf16le': + case 'utf-16le': + return ucs2Write(this, string, offset, length) + + default: + if (loweredCase) throw new TypeError('Unknown encoding: ' + encoding) + encoding = ('' + encoding).toLowerCase() + loweredCase = true + } + } +} + +Buffer.prototype.toJSON = function toJSON () { + return { + type: 'Buffer', + data: Array.prototype.slice.call(this._arr || this, 0) + } +} + +function base64Slice (buf, start, end) { + if (start === 0 && end === buf.length) { + return base64.fromByteArray(buf) + } else { + return base64.fromByteArray(buf.slice(start, end)) + } +} + +function utf8Slice (buf, start, end) { + end = Math.min(buf.length, end) + var res = [] + + var i = start + while (i < end) { + var firstByte = buf[i] + var codePoint = null + var bytesPerSequence = (firstByte > 0xEF) ? 4 + : (firstByte > 0xDF) ? 3 + : (firstByte > 0xBF) ? 2 + : 1 + + if (i + bytesPerSequence <= end) { + var secondByte, thirdByte, fourthByte, tempCodePoint + + switch (bytesPerSequence) { + case 1: + if (firstByte < 0x80) { + codePoint = firstByte + } + break + case 2: + secondByte = buf[i + 1] + if ((secondByte & 0xC0) === 0x80) { + tempCodePoint = (firstByte & 0x1F) << 0x6 | (secondByte & 0x3F) + if (tempCodePoint > 0x7F) { + codePoint = tempCodePoint + } + } + break + case 3: + secondByte = buf[i + 1] + thirdByte = buf[i + 2] + if ((secondByte & 0xC0) === 0x80 && (thirdByte & 0xC0) === 0x80) { + tempCodePoint = (firstByte & 0xF) << 0xC | (secondByte & 0x3F) << 0x6 | (thirdByte & 0x3F) + if (tempCodePoint > 0x7FF && (tempCodePoint < 0xD800 || tempCodePoint > 0xDFFF)) { + codePoint = tempCodePoint + } + } + break + case 4: + secondByte = buf[i + 1] + thirdByte = buf[i + 2] + fourthByte = buf[i + 3] + if ((secondByte & 0xC0) === 0x80 && (thirdByte & 0xC0) === 0x80 && (fourthByte & 0xC0) === 0x80) { + tempCodePoint = (firstByte & 0xF) << 0x12 | (secondByte & 0x3F) << 0xC | (thirdByte & 0x3F) << 0x6 | (fourthByte & 0x3F) + if (tempCodePoint > 0xFFFF && tempCodePoint < 0x110000) { + codePoint = tempCodePoint + } + } + } + } + + if (codePoint === null) { + // we did not generate a valid codePoint so insert a + // replacement char (U+FFFD) and advance only 1 byte + codePoint = 0xFFFD + bytesPerSequence = 1 + } else if (codePoint > 0xFFFF) { + // encode to utf16 (surrogate pair dance) + codePoint -= 0x10000 + res.push(codePoint >>> 10 & 0x3FF | 0xD800) + codePoint = 0xDC00 | codePoint & 0x3FF + } + + res.push(codePoint) + i += bytesPerSequence + } + + return decodeCodePointsArray(res) +} + +// Based on http://stackoverflow.com/a/22747272/680742, the browser with +// the lowest limit is Chrome, with 0x10000 args. +// We go 1 magnitude less, for safety +var MAX_ARGUMENTS_LENGTH = 0x1000 + +function decodeCodePointsArray (codePoints) { + var len = codePoints.length + if (len <= MAX_ARGUMENTS_LENGTH) { + return String.fromCharCode.apply(String, codePoints) // avoid extra slice() + } + + // Decode in chunks to avoid "call stack size exceeded". + var res = '' + var i = 0 + while (i < len) { + res += String.fromCharCode.apply( + String, + codePoints.slice(i, i += MAX_ARGUMENTS_LENGTH) + ) + } + return res +} + +function asciiSlice (buf, start, end) { + var ret = '' + end = Math.min(buf.length, end) + + for (var i = start; i < end; ++i) { + ret += String.fromCharCode(buf[i] & 0x7F) + } + return ret +} + +function latin1Slice (buf, start, end) { + var ret = '' + end = Math.min(buf.length, end) + + for (var i = start; i < end; ++i) { + ret += String.fromCharCode(buf[i]) + } + return ret +} + +function hexSlice (buf, start, end) { + var len = buf.length + + if (!start || start < 0) start = 0 + if (!end || end < 0 || end > len) end = len + + var out = '' + for (var i = start; i < end; ++i) { + out += toHex(buf[i]) + } + return out +} + +function utf16leSlice (buf, start, end) { + var bytes = buf.slice(start, end) + var res = '' + for (var i = 0; i < bytes.length; i += 2) { + res += String.fromCharCode(bytes[i] + (bytes[i + 1] * 256)) + } + return res +} + +Buffer.prototype.slice = function slice (start, end) { + var len = this.length + start = ~~start + end = end === undefined ? len : ~~end + + if (start < 0) { + start += len + if (start < 0) start = 0 + } else if (start > len) { + start = len + } + + if (end < 0) { + end += len + if (end < 0) end = 0 + } else if (end > len) { + end = len + } + + if (end < start) end = start + + var newBuf = this.subarray(start, end) + // Return an augmented `Uint8Array` instance + newBuf.__proto__ = Buffer.prototype + return newBuf +} + +/* + * Need to make sure that buffer isn't trying to write out of bounds. + */ +function checkOffset (offset, ext, length) { + if ((offset % 1) !== 0 || offset < 0) throw new RangeError('offset is not uint') + if (offset + ext > length) throw new RangeError('Trying to access beyond buffer length') +} + +Buffer.prototype.readUIntLE = function readUIntLE (offset, byteLength, noAssert) { + offset = offset >>> 0 + byteLength = byteLength >>> 0 + if (!noAssert) checkOffset(offset, byteLength, this.length) + + var val = this[offset] + var mul = 1 + var i = 0 + while (++i < byteLength && (mul *= 0x100)) { + val += this[offset + i] * mul + } + + return val +} + +Buffer.prototype.readUIntBE = function readUIntBE (offset, byteLength, noAssert) { + offset = offset >>> 0 + byteLength = byteLength >>> 0 + if (!noAssert) { + checkOffset(offset, byteLength, this.length) + } + + var val = this[offset + --byteLength] + var mul = 1 + while (byteLength > 0 && (mul *= 0x100)) { + val += this[offset + --byteLength] * mul + } + + return val +} + +Buffer.prototype.readUInt8 = function readUInt8 (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 1, this.length) + return this[offset] +} + +Buffer.prototype.readUInt16LE = function readUInt16LE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 2, this.length) + return this[offset] | (this[offset + 1] << 8) +} + +Buffer.prototype.readUInt16BE = function readUInt16BE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 2, this.length) + return (this[offset] << 8) | this[offset + 1] +} + +Buffer.prototype.readUInt32LE = function readUInt32LE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 4, this.length) + + return ((this[offset]) | + (this[offset + 1] << 8) | + (this[offset + 2] << 16)) + + (this[offset + 3] * 0x1000000) +} + +Buffer.prototype.readUInt32BE = function readUInt32BE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 4, this.length) + + return (this[offset] * 0x1000000) + + ((this[offset + 1] << 16) | + (this[offset + 2] << 8) | + this[offset + 3]) +} + +Buffer.prototype.readIntLE = function readIntLE (offset, byteLength, noAssert) { + offset = offset >>> 0 + byteLength = byteLength >>> 0 + if (!noAssert) checkOffset(offset, byteLength, this.length) + + var val = this[offset] + var mul = 1 + var i = 0 + while (++i < byteLength && (mul *= 0x100)) { + val += this[offset + i] * mul + } + mul *= 0x80 + + if (val >= mul) val -= Math.pow(2, 8 * byteLength) + + return val +} + +Buffer.prototype.readIntBE = function readIntBE (offset, byteLength, noAssert) { + offset = offset >>> 0 + byteLength = byteLength >>> 0 + if (!noAssert) checkOffset(offset, byteLength, this.length) + + var i = byteLength + var mul = 1 + var val = this[offset + --i] + while (i > 0 && (mul *= 0x100)) { + val += this[offset + --i] * mul + } + mul *= 0x80 + + if (val >= mul) val -= Math.pow(2, 8 * byteLength) + + return val +} + +Buffer.prototype.readInt8 = function readInt8 (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 1, this.length) + if (!(this[offset] & 0x80)) return (this[offset]) + return ((0xff - this[offset] + 1) * -1) +} + +Buffer.prototype.readInt16LE = function readInt16LE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 2, this.length) + var val = this[offset] | (this[offset + 1] << 8) + return (val & 0x8000) ? val | 0xFFFF0000 : val +} + +Buffer.prototype.readInt16BE = function readInt16BE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 2, this.length) + var val = this[offset + 1] | (this[offset] << 8) + return (val & 0x8000) ? val | 0xFFFF0000 : val +} + +Buffer.prototype.readInt32LE = function readInt32LE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 4, this.length) + + return (this[offset]) | + (this[offset + 1] << 8) | + (this[offset + 2] << 16) | + (this[offset + 3] << 24) +} + +Buffer.prototype.readInt32BE = function readInt32BE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 4, this.length) + + return (this[offset] << 24) | + (this[offset + 1] << 16) | + (this[offset + 2] << 8) | + (this[offset + 3]) +} + +Buffer.prototype.readFloatLE = function readFloatLE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 4, this.length) + return ieee754.read(this, offset, true, 23, 4) +} + +Buffer.prototype.readFloatBE = function readFloatBE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 4, this.length) + return ieee754.read(this, offset, false, 23, 4) +} + +Buffer.prototype.readDoubleLE = function readDoubleLE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 8, this.length) + return ieee754.read(this, offset, true, 52, 8) +} + +Buffer.prototype.readDoubleBE = function readDoubleBE (offset, noAssert) { + offset = offset >>> 0 + if (!noAssert) checkOffset(offset, 8, this.length) + return ieee754.read(this, offset, false, 52, 8) +} + +function checkInt (buf, value, offset, ext, max, min) { + if (!Buffer.isBuffer(buf)) throw new TypeError('"buffer" argument must be a Buffer instance') + if (value > max || value < min) throw new RangeError('"value" argument is out of bounds') + if (offset + ext > buf.length) throw new RangeError('Index out of range') +} + +Buffer.prototype.writeUIntLE = function writeUIntLE (value, offset, byteLength, noAssert) { + value = +value + offset = offset >>> 0 + byteLength = byteLength >>> 0 + if (!noAssert) { + var maxBytes = Math.pow(2, 8 * byteLength) - 1 + checkInt(this, value, offset, byteLength, maxBytes, 0) + } + + var mul = 1 + var i = 0 + this[offset] = value & 0xFF + while (++i < byteLength && (mul *= 0x100)) { + this[offset + i] = (value / mul) & 0xFF + } + + return offset + byteLength +} + +Buffer.prototype.writeUIntBE = function writeUIntBE (value, offset, byteLength, noAssert) { + value = +value + offset = offset >>> 0 + byteLength = byteLength >>> 0 + if (!noAssert) { + var maxBytes = Math.pow(2, 8 * byteLength) - 1 + checkInt(this, value, offset, byteLength, maxBytes, 0) + } + + var i = byteLength - 1 + var mul = 1 + this[offset + i] = value & 0xFF + while (--i >= 0 && (mul *= 0x100)) { + this[offset + i] = (value / mul) & 0xFF + } + + return offset + byteLength +} + +Buffer.prototype.writeUInt8 = function writeUInt8 (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 1, 0xff, 0) + this[offset] = (value & 0xff) + return offset + 1 +} + +Buffer.prototype.writeUInt16LE = function writeUInt16LE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 2, 0xffff, 0) + this[offset] = (value & 0xff) + this[offset + 1] = (value >>> 8) + return offset + 2 +} + +Buffer.prototype.writeUInt16BE = function writeUInt16BE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 2, 0xffff, 0) + this[offset] = (value >>> 8) + this[offset + 1] = (value & 0xff) + return offset + 2 +} + +Buffer.prototype.writeUInt32LE = function writeUInt32LE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 4, 0xffffffff, 0) + this[offset + 3] = (value >>> 24) + this[offset + 2] = (value >>> 16) + this[offset + 1] = (value >>> 8) + this[offset] = (value & 0xff) + return offset + 4 +} + +Buffer.prototype.writeUInt32BE = function writeUInt32BE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 4, 0xffffffff, 0) + this[offset] = (value >>> 24) + this[offset + 1] = (value >>> 16) + this[offset + 2] = (value >>> 8) + this[offset + 3] = (value & 0xff) + return offset + 4 +} + +Buffer.prototype.writeIntLE = function writeIntLE (value, offset, byteLength, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) { + var limit = Math.pow(2, (8 * byteLength) - 1) + + checkInt(this, value, offset, byteLength, limit - 1, -limit) + } + + var i = 0 + var mul = 1 + var sub = 0 + this[offset] = value & 0xFF + while (++i < byteLength && (mul *= 0x100)) { + if (value < 0 && sub === 0 && this[offset + i - 1] !== 0) { + sub = 1 + } + this[offset + i] = ((value / mul) >> 0) - sub & 0xFF + } + + return offset + byteLength +} + +Buffer.prototype.writeIntBE = function writeIntBE (value, offset, byteLength, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) { + var limit = Math.pow(2, (8 * byteLength) - 1) + + checkInt(this, value, offset, byteLength, limit - 1, -limit) + } + + var i = byteLength - 1 + var mul = 1 + var sub = 0 + this[offset + i] = value & 0xFF + while (--i >= 0 && (mul *= 0x100)) { + if (value < 0 && sub === 0 && this[offset + i + 1] !== 0) { + sub = 1 + } + this[offset + i] = ((value / mul) >> 0) - sub & 0xFF + } + + return offset + byteLength +} + +Buffer.prototype.writeInt8 = function writeInt8 (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 1, 0x7f, -0x80) + if (value < 0) value = 0xff + value + 1 + this[offset] = (value & 0xff) + return offset + 1 +} + +Buffer.prototype.writeInt16LE = function writeInt16LE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -0x8000) + this[offset] = (value & 0xff) + this[offset + 1] = (value >>> 8) + return offset + 2 +} + +Buffer.prototype.writeInt16BE = function writeInt16BE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -0x8000) + this[offset] = (value >>> 8) + this[offset + 1] = (value & 0xff) + return offset + 2 +} + +Buffer.prototype.writeInt32LE = function writeInt32LE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -0x80000000) + this[offset] = (value & 0xff) + this[offset + 1] = (value >>> 8) + this[offset + 2] = (value >>> 16) + this[offset + 3] = (value >>> 24) + return offset + 4 +} + +Buffer.prototype.writeInt32BE = function writeInt32BE (value, offset, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -0x80000000) + if (value < 0) value = 0xffffffff + value + 1 + this[offset] = (value >>> 24) + this[offset + 1] = (value >>> 16) + this[offset + 2] = (value >>> 8) + this[offset + 3] = (value & 0xff) + return offset + 4 +} + +function checkIEEE754 (buf, value, offset, ext, max, min) { + if (offset + ext > buf.length) throw new RangeError('Index out of range') + if (offset < 0) throw new RangeError('Index out of range') +} + +function writeFloat (buf, value, offset, littleEndian, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) { + checkIEEE754(buf, value, offset, 4, 3.4028234663852886e+38, -3.4028234663852886e+38) + } + ieee754.write(buf, value, offset, littleEndian, 23, 4) + return offset + 4 +} + +Buffer.prototype.writeFloatLE = function writeFloatLE (value, offset, noAssert) { + return writeFloat(this, value, offset, true, noAssert) +} + +Buffer.prototype.writeFloatBE = function writeFloatBE (value, offset, noAssert) { + return writeFloat(this, value, offset, false, noAssert) +} + +function writeDouble (buf, value, offset, littleEndian, noAssert) { + value = +value + offset = offset >>> 0 + if (!noAssert) { + checkIEEE754(buf, value, offset, 8, 1.7976931348623157E+308, -1.7976931348623157E+308) + } + ieee754.write(buf, value, offset, littleEndian, 52, 8) + return offset + 8 +} + +Buffer.prototype.writeDoubleLE = function writeDoubleLE (value, offset, noAssert) { + return writeDouble(this, value, offset, true, noAssert) +} + +Buffer.prototype.writeDoubleBE = function writeDoubleBE (value, offset, noAssert) { + return writeDouble(this, value, offset, false, noAssert) +} + +// copy(targetBuffer, targetStart=0, sourceStart=0, sourceEnd=buffer.length) +Buffer.prototype.copy = function copy (target, targetStart, start, end) { + if (!Buffer.isBuffer(target)) throw new TypeError('argument should be a Buffer') + if (!start) start = 0 + if (!end && end !== 0) end = this.length + if (targetStart >= target.length) targetStart = target.length + if (!targetStart) targetStart = 0 + if (end > 0 && end < start) end = start + + // Copy 0 bytes; we're done + if (end === start) return 0 + if (target.length === 0 || this.length === 0) return 0 + + // Fatal error conditions + if (targetStart < 0) { + throw new RangeError('targetStart out of bounds') + } + if (start < 0 || start >= this.length) throw new RangeError('Index out of range') + if (end < 0) throw new RangeError('sourceEnd out of bounds') + + // Are we oob? + if (end > this.length) end = this.length + if (target.length - targetStart < end - start) { + end = target.length - targetStart + start + } + + var len = end - start + + if (this === target && typeof Uint8Array.prototype.copyWithin === 'function') { + // Use built-in when available, missing from IE11 + this.copyWithin(targetStart, start, end) + } else if (this === target && start < targetStart && targetStart < end) { + // descending copy from end + for (var i = len - 1; i >= 0; --i) { + target[i + targetStart] = this[i + start] + } + } else { + Uint8Array.prototype.set.call( + target, + this.subarray(start, end), + targetStart + ) + } + + return len +} + +// Usage: +// buffer.fill(number[, offset[, end]]) +// buffer.fill(buffer[, offset[, end]]) +// buffer.fill(string[, offset[, end]][, encoding]) +Buffer.prototype.fill = function fill (val, start, end, encoding) { + // Handle string cases: + if (typeof val === 'string') { + if (typeof start === 'string') { + encoding = start + start = 0 + end = this.length + } else if (typeof end === 'string') { + encoding = end + end = this.length + } + if (encoding !== undefined && typeof encoding !== 'string') { + throw new TypeError('encoding must be a string') + } + if (typeof encoding === 'string' && !Buffer.isEncoding(encoding)) { + throw new TypeError('Unknown encoding: ' + encoding) + } + if (val.length === 1) { + var code = val.charCodeAt(0) + if ((encoding === 'utf8' && code < 128) || + encoding === 'latin1') { + // Fast path: If `val` fits into a single byte, use that numeric value. + val = code + } + } + } else if (typeof val === 'number') { + val = val & 255 + } + + // Invalid ranges are not set to a default, so can range check early. + if (start < 0 || this.length < start || this.length < end) { + throw new RangeError('Out of range index') + } + + if (end <= start) { + return this + } + + start = start >>> 0 + end = end === undefined ? this.length : end >>> 0 + + if (!val) val = 0 + + var i + if (typeof val === 'number') { + for (i = start; i < end; ++i) { + this[i] = val + } + } else { + var bytes = Buffer.isBuffer(val) + ? val + : Buffer.from(val, encoding) + var len = bytes.length + if (len === 0) { + throw new TypeError('The value "' + val + + '" is invalid for argument "value"') + } + for (i = 0; i < end - start; ++i) { + this[i + start] = bytes[i % len] + } + } + + return this +} + +// HELPER FUNCTIONS +// ================ + +var INVALID_BASE64_RE = /[^+/0-9A-Za-z-_]/g + +function base64clean (str) { + // Node takes equal signs as end of the Base64 encoding + str = str.split('=')[0] + // Node strips out invalid characters like \n and \t from the string, base64-js does not + str = str.trim().replace(INVALID_BASE64_RE, '') + // Node converts strings with length < 2 to '' + if (str.length < 2) return '' + // Node allows for non-padded base64 strings (missing trailing ===), base64-js does not + while (str.length % 4 !== 0) { + str = str + '=' + } + return str +} + +function toHex (n) { + if (n < 16) return '0' + n.toString(16) + return n.toString(16) +} + +function utf8ToBytes (string, units) { + units = units || Infinity + var codePoint + var length = string.length + var leadSurrogate = null + var bytes = [] + + for (var i = 0; i < length; ++i) { + codePoint = string.charCodeAt(i) + + // is surrogate component + if (codePoint > 0xD7FF && codePoint < 0xE000) { + // last char was a lead + if (!leadSurrogate) { + // no lead yet + if (codePoint > 0xDBFF) { + // unexpected trail + if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD) + continue + } else if (i + 1 === length) { + // unpaired lead + if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD) + continue + } + + // valid lead + leadSurrogate = codePoint + + continue + } + + // 2 leads in a row + if (codePoint < 0xDC00) { + if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD) + leadSurrogate = codePoint + continue + } + + // valid surrogate pair + codePoint = (leadSurrogate - 0xD800 << 10 | codePoint - 0xDC00) + 0x10000 + } else if (leadSurrogate) { + // valid bmp char, but last char was a lead + if ((units -= 3) > -1) bytes.push(0xEF, 0xBF, 0xBD) + } + + leadSurrogate = null + + // encode utf8 + if (codePoint < 0x80) { + if ((units -= 1) < 0) break + bytes.push(codePoint) + } else if (codePoint < 0x800) { + if ((units -= 2) < 0) break + bytes.push( + codePoint >> 0x6 | 0xC0, + codePoint & 0x3F | 0x80 + ) + } else if (codePoint < 0x10000) { + if ((units -= 3) < 0) break + bytes.push( + codePoint >> 0xC | 0xE0, + codePoint >> 0x6 & 0x3F | 0x80, + codePoint & 0x3F | 0x80 + ) + } else if (codePoint < 0x110000) { + if ((units -= 4) < 0) break + bytes.push( + codePoint >> 0x12 | 0xF0, + codePoint >> 0xC & 0x3F | 0x80, + codePoint >> 0x6 & 0x3F | 0x80, + codePoint & 0x3F | 0x80 + ) + } else { + throw new Error('Invalid code point') + } + } + + return bytes +} + +function asciiToBytes (str) { + var byteArray = [] + for (var i = 0; i < str.length; ++i) { + // Node's code seems to be doing this and not & 0x7F.. + byteArray.push(str.charCodeAt(i) & 0xFF) + } + return byteArray +} + +function utf16leToBytes (str, units) { + var c, hi, lo + var byteArray = [] + for (var i = 0; i < str.length; ++i) { + if ((units -= 2) < 0) break + + c = str.charCodeAt(i) + hi = c >> 8 + lo = c % 256 + byteArray.push(lo) + byteArray.push(hi) + } + + return byteArray +} + +function base64ToBytes (str) { + return base64.toByteArray(base64clean(str)) +} + +function blitBuffer (src, dst, offset, length) { + for (var i = 0; i < length; ++i) { + if ((i + offset >= dst.length) || (i >= src.length)) break + dst[i + offset] = src[i] + } + return i +} + +// ArrayBuffer or Uint8Array objects from other contexts (i.e. iframes) do not pass +// the `instanceof` check but they should be treated as of that type. +// See: https://github.com/feross/buffer/issues/166 +function isInstance (obj, type) { + return obj instanceof type || + (obj != null && obj.constructor != null && obj.constructor.name != null && + obj.constructor.name === type.name) +} +function numberIsNaN (obj) { + // For IE11 support + return obj !== obj // eslint-disable-line no-self-compare +} + +},{"base64-js":2,"ieee754":8}],5:[function(_dereq_,module,exports){ +(function (process,global){ +/*! + * @overview es6-promise - a tiny implementation of Promises/A+. + * @copyright Copyright (c) 2014 Yehuda Katz, Tom Dale, Stefan Penner and contributors (Conversion to ES6 API by Jake Archibald) + * @license Licensed under MIT license + * See https://raw.githubusercontent.com/stefanpenner/es6-promise/master/LICENSE + * @version v4.2.6+9869a4bc + */ + +(function (global, factory) { + typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() : + typeof define === 'function' && define.amd ? define(factory) : + (global.ES6Promise = factory()); +}(this, (function () { 'use strict'; + +function objectOrFunction(x) { + var type = typeof x; + return x !== null && (type === 'object' || type === 'function'); +} + +function isFunction(x) { + return typeof x === 'function'; +} + + + +var _isArray = void 0; +if (Array.isArray) { + _isArray = Array.isArray; +} else { + _isArray = function (x) { + return Object.prototype.toString.call(x) === '[object Array]'; + }; +} + +var isArray = _isArray; + +var len = 0; +var vertxNext = void 0; +var customSchedulerFn = void 0; + +var asap = function asap(callback, arg) { + queue[len] = callback; + queue[len + 1] = arg; + len += 2; + if (len === 2) { + // If len is 2, that means that we need to schedule an async flush. + // If additional callbacks are queued before the queue is flushed, they + // will be processed by this flush that we are scheduling. + if (customSchedulerFn) { + customSchedulerFn(flush); + } else { + scheduleFlush(); + } + } +}; + +function setScheduler(scheduleFn) { + customSchedulerFn = scheduleFn; +} + +function setAsap(asapFn) { + asap = asapFn; +} + +var browserWindow = typeof window !== 'undefined' ? window : undefined; +var browserGlobal = browserWindow || {}; +var BrowserMutationObserver = browserGlobal.MutationObserver || browserGlobal.WebKitMutationObserver; +var isNode = typeof self === 'undefined' && typeof process !== 'undefined' && {}.toString.call(process) === '[object process]'; + +// test for web worker but not in IE10 +var isWorker = typeof Uint8ClampedArray !== 'undefined' && typeof importScripts !== 'undefined' && typeof MessageChannel !== 'undefined'; + +// node +function useNextTick() { + // node version 0.10.x displays a deprecation warning when nextTick is used recursively + // see https://github.com/cujojs/when/issues/410 for details + return function () { + return process.nextTick(flush); + }; +} + +// vertx +function useVertxTimer() { + if (typeof vertxNext !== 'undefined') { + return function () { + vertxNext(flush); + }; + } + + return useSetTimeout(); +} + +function useMutationObserver() { + var iterations = 0; + var observer = new BrowserMutationObserver(flush); + var node = document.createTextNode(''); + observer.observe(node, { characterData: true }); + + return function () { + node.data = iterations = ++iterations % 2; + }; +} + +// web worker +function useMessageChannel() { + var channel = new MessageChannel(); + channel.port1.onmessage = flush; + return function () { + return channel.port2.postMessage(0); + }; +} + +function useSetTimeout() { + // Store setTimeout reference so es6-promise will be unaffected by + // other code modifying setTimeout (like sinon.useFakeTimers()) + var globalSetTimeout = setTimeout; + return function () { + return globalSetTimeout(flush, 1); + }; +} + +var queue = new Array(1000); +function flush() { + for (var i = 0; i < len; i += 2) { + var callback = queue[i]; + var arg = queue[i + 1]; + + callback(arg); + + queue[i] = undefined; + queue[i + 1] = undefined; + } + + len = 0; +} + +function attemptVertx() { + try { + var vertx = Function('return this')().require('vertx'); + vertxNext = vertx.runOnLoop || vertx.runOnContext; + return useVertxTimer(); + } catch (e) { + return useSetTimeout(); + } +} + +var scheduleFlush = void 0; +// Decide what async method to use to triggering processing of queued callbacks: +if (isNode) { + scheduleFlush = useNextTick(); +} else if (BrowserMutationObserver) { + scheduleFlush = useMutationObserver(); +} else if (isWorker) { + scheduleFlush = useMessageChannel(); +} else if (browserWindow === undefined && typeof _dereq_ === 'function') { + scheduleFlush = attemptVertx(); +} else { + scheduleFlush = useSetTimeout(); +} + +function then(onFulfillment, onRejection) { + var parent = this; + + var child = new this.constructor(noop); + + if (child[PROMISE_ID] === undefined) { + makePromise(child); + } + + var _state = parent._state; + + + if (_state) { + var callback = arguments[_state - 1]; + asap(function () { + return invokeCallback(_state, child, callback, parent._result); + }); + } else { + subscribe(parent, child, onFulfillment, onRejection); + } + + return child; +} + +/** + `Promise.resolve` returns a promise that will become resolved with the + passed `value`. It is shorthand for the following: + + ```javascript + let promise = new Promise(function(resolve, reject){ + resolve(1); + }); + + promise.then(function(value){ + // value === 1 + }); + ``` + + Instead of writing the above, your code now simply becomes the following: + + ```javascript + let promise = Promise.resolve(1); + + promise.then(function(value){ + // value === 1 + }); + ``` + + @method resolve + @static + @param {Any} value value that the returned promise will be resolved with + Useful for tooling. + @return {Promise} a promise that will become fulfilled with the given + `value` +*/ +function resolve$1(object) { + /*jshint validthis:true */ + var Constructor = this; + + if (object && typeof object === 'object' && object.constructor === Constructor) { + return object; + } + + var promise = new Constructor(noop); + resolve(promise, object); + return promise; +} + +var PROMISE_ID = Math.random().toString(36).substring(2); + +function noop() {} + +var PENDING = void 0; +var FULFILLED = 1; +var REJECTED = 2; + +var TRY_CATCH_ERROR = { error: null }; + +function selfFulfillment() { + return new TypeError("You cannot resolve a promise with itself"); +} + +function cannotReturnOwn() { + return new TypeError('A promises callback cannot return that same promise.'); +} + +function getThen(promise) { + try { + return promise.then; + } catch (error) { + TRY_CATCH_ERROR.error = error; + return TRY_CATCH_ERROR; + } +} + +function tryThen(then$$1, value, fulfillmentHandler, rejectionHandler) { + try { + then$$1.call(value, fulfillmentHandler, rejectionHandler); + } catch (e) { + return e; + } +} + +function handleForeignThenable(promise, thenable, then$$1) { + asap(function (promise) { + var sealed = false; + var error = tryThen(then$$1, thenable, function (value) { + if (sealed) { + return; + } + sealed = true; + if (thenable !== value) { + resolve(promise, value); + } else { + fulfill(promise, value); + } + }, function (reason) { + if (sealed) { + return; + } + sealed = true; + + reject(promise, reason); + }, 'Settle: ' + (promise._label || ' unknown promise')); + + if (!sealed && error) { + sealed = true; + reject(promise, error); + } + }, promise); +} + +function handleOwnThenable(promise, thenable) { + if (thenable._state === FULFILLED) { + fulfill(promise, thenable._result); + } else if (thenable._state === REJECTED) { + reject(promise, thenable._result); + } else { + subscribe(thenable, undefined, function (value) { + return resolve(promise, value); + }, function (reason) { + return reject(promise, reason); + }); + } +} + +function handleMaybeThenable(promise, maybeThenable, then$$1) { + if (maybeThenable.constructor === promise.constructor && then$$1 === then && maybeThenable.constructor.resolve === resolve$1) { + handleOwnThenable(promise, maybeThenable); + } else { + if (then$$1 === TRY_CATCH_ERROR) { + reject(promise, TRY_CATCH_ERROR.error); + TRY_CATCH_ERROR.error = null; + } else if (then$$1 === undefined) { + fulfill(promise, maybeThenable); + } else if (isFunction(then$$1)) { + handleForeignThenable(promise, maybeThenable, then$$1); + } else { + fulfill(promise, maybeThenable); + } + } +} + +function resolve(promise, value) { + if (promise === value) { + reject(promise, selfFulfillment()); + } else if (objectOrFunction(value)) { + handleMaybeThenable(promise, value, getThen(value)); + } else { + fulfill(promise, value); + } +} + +function publishRejection(promise) { + if (promise._onerror) { + promise._onerror(promise._result); + } + + publish(promise); +} + +function fulfill(promise, value) { + if (promise._state !== PENDING) { + return; + } + + promise._result = value; + promise._state = FULFILLED; + + if (promise._subscribers.length !== 0) { + asap(publish, promise); + } +} + +function reject(promise, reason) { + if (promise._state !== PENDING) { + return; + } + promise._state = REJECTED; + promise._result = reason; + + asap(publishRejection, promise); +} + +function subscribe(parent, child, onFulfillment, onRejection) { + var _subscribers = parent._subscribers; + var length = _subscribers.length; + + + parent._onerror = null; + + _subscribers[length] = child; + _subscribers[length + FULFILLED] = onFulfillment; + _subscribers[length + REJECTED] = onRejection; + + if (length === 0 && parent._state) { + asap(publish, parent); + } +} + +function publish(promise) { + var subscribers = promise._subscribers; + var settled = promise._state; + + if (subscribers.length === 0) { + return; + } + + var child = void 0, + callback = void 0, + detail = promise._result; + + for (var i = 0; i < subscribers.length; i += 3) { + child = subscribers[i]; + callback = subscribers[i + settled]; + + if (child) { + invokeCallback(settled, child, callback, detail); + } else { + callback(detail); + } + } + + promise._subscribers.length = 0; +} + +function tryCatch(callback, detail) { + try { + return callback(detail); + } catch (e) { + TRY_CATCH_ERROR.error = e; + return TRY_CATCH_ERROR; + } +} + +function invokeCallback(settled, promise, callback, detail) { + var hasCallback = isFunction(callback), + value = void 0, + error = void 0, + succeeded = void 0, + failed = void 0; + + if (hasCallback) { + value = tryCatch(callback, detail); + + if (value === TRY_CATCH_ERROR) { + failed = true; + error = value.error; + value.error = null; + } else { + succeeded = true; + } + + if (promise === value) { + reject(promise, cannotReturnOwn()); + return; + } + } else { + value = detail; + succeeded = true; + } + + if (promise._state !== PENDING) { + // noop + } else if (hasCallback && succeeded) { + resolve(promise, value); + } else if (failed) { + reject(promise, error); + } else if (settled === FULFILLED) { + fulfill(promise, value); + } else if (settled === REJECTED) { + reject(promise, value); + } +} + +function initializePromise(promise, resolver) { + try { + resolver(function resolvePromise(value) { + resolve(promise, value); + }, function rejectPromise(reason) { + reject(promise, reason); + }); + } catch (e) { + reject(promise, e); + } +} + +var id = 0; +function nextId() { + return id++; +} + +function makePromise(promise) { + promise[PROMISE_ID] = id++; + promise._state = undefined; + promise._result = undefined; + promise._subscribers = []; +} + +function validationError() { + return new Error('Array Methods must be provided an Array'); +} + +var Enumerator = function () { + function Enumerator(Constructor, input) { + this._instanceConstructor = Constructor; + this.promise = new Constructor(noop); + + if (!this.promise[PROMISE_ID]) { + makePromise(this.promise); + } + + if (isArray(input)) { + this.length = input.length; + this._remaining = input.length; + + this._result = new Array(this.length); + + if (this.length === 0) { + fulfill(this.promise, this._result); + } else { + this.length = this.length || 0; + this._enumerate(input); + if (this._remaining === 0) { + fulfill(this.promise, this._result); + } + } + } else { + reject(this.promise, validationError()); + } + } + + Enumerator.prototype._enumerate = function _enumerate(input) { + for (var i = 0; this._state === PENDING && i < input.length; i++) { + this._eachEntry(input[i], i); + } + }; + + Enumerator.prototype._eachEntry = function _eachEntry(entry, i) { + var c = this._instanceConstructor; + var resolve$$1 = c.resolve; + + + if (resolve$$1 === resolve$1) { + var _then = getThen(entry); + + if (_then === then && entry._state !== PENDING) { + this._settledAt(entry._state, i, entry._result); + } else if (typeof _then !== 'function') { + this._remaining--; + this._result[i] = entry; + } else if (c === Promise$1) { + var promise = new c(noop); + handleMaybeThenable(promise, entry, _then); + this._willSettleAt(promise, i); + } else { + this._willSettleAt(new c(function (resolve$$1) { + return resolve$$1(entry); + }), i); + } + } else { + this._willSettleAt(resolve$$1(entry), i); + } + }; + + Enumerator.prototype._settledAt = function _settledAt(state, i, value) { + var promise = this.promise; + + + if (promise._state === PENDING) { + this._remaining--; + + if (state === REJECTED) { + reject(promise, value); + } else { + this._result[i] = value; + } + } + + if (this._remaining === 0) { + fulfill(promise, this._result); + } + }; + + Enumerator.prototype._willSettleAt = function _willSettleAt(promise, i) { + var enumerator = this; + + subscribe(promise, undefined, function (value) { + return enumerator._settledAt(FULFILLED, i, value); + }, function (reason) { + return enumerator._settledAt(REJECTED, i, reason); + }); + }; + + return Enumerator; +}(); + +/** + `Promise.all` accepts an array of promises, and returns a new promise which + is fulfilled with an array of fulfillment values for the passed promises, or + rejected with the reason of the first passed promise to be rejected. It casts all + elements of the passed iterable to promises as it runs this algorithm. + + Example: + + ```javascript + let promise1 = resolve(1); + let promise2 = resolve(2); + let promise3 = resolve(3); + let promises = [ promise1, promise2, promise3 ]; + + Promise.all(promises).then(function(array){ + // The array here would be [ 1, 2, 3 ]; + }); + ``` + + If any of the `promises` given to `all` are rejected, the first promise + that is rejected will be given as an argument to the returned promises's + rejection handler. For example: + + Example: + + ```javascript + let promise1 = resolve(1); + let promise2 = reject(new Error("2")); + let promise3 = reject(new Error("3")); + let promises = [ promise1, promise2, promise3 ]; + + Promise.all(promises).then(function(array){ + // Code here never runs because there are rejected promises! + }, function(error) { + // error.message === "2" + }); + ``` + + @method all + @static + @param {Array} entries array of promises + @param {String} label optional string for labeling the promise. + Useful for tooling. + @return {Promise} promise that is fulfilled when all `promises` have been + fulfilled, or rejected if any of them become rejected. + @static +*/ +function all(entries) { + return new Enumerator(this, entries).promise; +} + +/** + `Promise.race` returns a new promise which is settled in the same way as the + first passed promise to settle. + + Example: + + ```javascript + let promise1 = new Promise(function(resolve, reject){ + setTimeout(function(){ + resolve('promise 1'); + }, 200); + }); + + let promise2 = new Promise(function(resolve, reject){ + setTimeout(function(){ + resolve('promise 2'); + }, 100); + }); + + Promise.race([promise1, promise2]).then(function(result){ + // result === 'promise 2' because it was resolved before promise1 + // was resolved. + }); + ``` + + `Promise.race` is deterministic in that only the state of the first + settled promise matters. For example, even if other promises given to the + `promises` array argument are resolved, but the first settled promise has + become rejected before the other promises became fulfilled, the returned + promise will become rejected: + + ```javascript + let promise1 = new Promise(function(resolve, reject){ + setTimeout(function(){ + resolve('promise 1'); + }, 200); + }); + + let promise2 = new Promise(function(resolve, reject){ + setTimeout(function(){ + reject(new Error('promise 2')); + }, 100); + }); + + Promise.race([promise1, promise2]).then(function(result){ + // Code here never runs + }, function(reason){ + // reason.message === 'promise 2' because promise 2 became rejected before + // promise 1 became fulfilled + }); + ``` + + An example real-world use case is implementing timeouts: + + ```javascript + Promise.race([ajax('foo.json'), timeout(5000)]) + ``` + + @method race + @static + @param {Array} promises array of promises to observe + Useful for tooling. + @return {Promise} a promise which settles in the same way as the first passed + promise to settle. +*/ +function race(entries) { + /*jshint validthis:true */ + var Constructor = this; + + if (!isArray(entries)) { + return new Constructor(function (_, reject) { + return reject(new TypeError('You must pass an array to race.')); + }); + } else { + return new Constructor(function (resolve, reject) { + var length = entries.length; + for (var i = 0; i < length; i++) { + Constructor.resolve(entries[i]).then(resolve, reject); + } + }); + } +} + +/** + `Promise.reject` returns a promise rejected with the passed `reason`. + It is shorthand for the following: + + ```javascript + let promise = new Promise(function(resolve, reject){ + reject(new Error('WHOOPS')); + }); + + promise.then(function(value){ + // Code here doesn't run because the promise is rejected! + }, function(reason){ + // reason.message === 'WHOOPS' + }); + ``` + + Instead of writing the above, your code now simply becomes the following: + + ```javascript + let promise = Promise.reject(new Error('WHOOPS')); + + promise.then(function(value){ + // Code here doesn't run because the promise is rejected! + }, function(reason){ + // reason.message === 'WHOOPS' + }); + ``` + + @method reject + @static + @param {Any} reason value that the returned promise will be rejected with. + Useful for tooling. + @return {Promise} a promise rejected with the given `reason`. +*/ +function reject$1(reason) { + /*jshint validthis:true */ + var Constructor = this; + var promise = new Constructor(noop); + reject(promise, reason); + return promise; +} + +function needsResolver() { + throw new TypeError('You must pass a resolver function as the first argument to the promise constructor'); +} + +function needsNew() { + throw new TypeError("Failed to construct 'Promise': Please use the 'new' operator, this object constructor cannot be called as a function."); +} + +/** + Promise objects represent the eventual result of an asynchronous operation. The + primary way of interacting with a promise is through its `then` method, which + registers callbacks to receive either a promise's eventual value or the reason + why the promise cannot be fulfilled. + + Terminology + ----------- + + - `promise` is an object or function with a `then` method whose behavior conforms to this specification. + - `thenable` is an object or function that defines a `then` method. + - `value` is any legal JavaScript value (including undefined, a thenable, or a promise). + - `exception` is a value that is thrown using the throw statement. + - `reason` is a value that indicates why a promise was rejected. + - `settled` the final resting state of a promise, fulfilled or rejected. + + A promise can be in one of three states: pending, fulfilled, or rejected. + + Promises that are fulfilled have a fulfillment value and are in the fulfilled + state. Promises that are rejected have a rejection reason and are in the + rejected state. A fulfillment value is never a thenable. + + Promises can also be said to *resolve* a value. If this value is also a + promise, then the original promise's settled state will match the value's + settled state. So a promise that *resolves* a promise that rejects will + itself reject, and a promise that *resolves* a promise that fulfills will + itself fulfill. + + + Basic Usage: + ------------ + + ```js + let promise = new Promise(function(resolve, reject) { + // on success + resolve(value); + + // on failure + reject(reason); + }); + + promise.then(function(value) { + // on fulfillment + }, function(reason) { + // on rejection + }); + ``` + + Advanced Usage: + --------------- + + Promises shine when abstracting away asynchronous interactions such as + `XMLHttpRequest`s. + + ```js + function getJSON(url) { + return new Promise(function(resolve, reject){ + let xhr = new XMLHttpRequest(); + + xhr.open('GET', url); + xhr.onreadystatechange = handler; + xhr.responseType = 'json'; + xhr.setRequestHeader('Accept', 'application/json'); + xhr.send(); + + function handler() { + if (this.readyState === this.DONE) { + if (this.status === 200) { + resolve(this.response); + } else { + reject(new Error('getJSON: `' + url + '` failed with status: [' + this.status + ']')); + } + } + }; + }); + } + + getJSON('/posts.json').then(function(json) { + // on fulfillment + }, function(reason) { + // on rejection + }); + ``` + + Unlike callbacks, promises are great composable primitives. + + ```js + Promise.all([ + getJSON('/posts'), + getJSON('/comments') + ]).then(function(values){ + values[0] // => postsJSON + values[1] // => commentsJSON + + return values; + }); + ``` + + @class Promise + @param {Function} resolver + Useful for tooling. + @constructor +*/ + +var Promise$1 = function () { + function Promise(resolver) { + this[PROMISE_ID] = nextId(); + this._result = this._state = undefined; + this._subscribers = []; + + if (noop !== resolver) { + typeof resolver !== 'function' && needsResolver(); + this instanceof Promise ? initializePromise(this, resolver) : needsNew(); + } + } + + /** + The primary way of interacting with a promise is through its `then` method, + which registers callbacks to receive either a promise's eventual value or the + reason why the promise cannot be fulfilled. + ```js + findUser().then(function(user){ + // user is available + }, function(reason){ + // user is unavailable, and you are given the reason why + }); + ``` + Chaining + -------- + The return value of `then` is itself a promise. This second, 'downstream' + promise is resolved with the return value of the first promise's fulfillment + or rejection handler, or rejected if the handler throws an exception. + ```js + findUser().then(function (user) { + return user.name; + }, function (reason) { + return 'default name'; + }).then(function (userName) { + // If `findUser` fulfilled, `userName` will be the user's name, otherwise it + // will be `'default name'` + }); + findUser().then(function (user) { + throw new Error('Found user, but still unhappy'); + }, function (reason) { + throw new Error('`findUser` rejected and we're unhappy'); + }).then(function (value) { + // never reached + }, function (reason) { + // if `findUser` fulfilled, `reason` will be 'Found user, but still unhappy'. + // If `findUser` rejected, `reason` will be '`findUser` rejected and we're unhappy'. + }); + ``` + If the downstream promise does not specify a rejection handler, rejection reasons will be propagated further downstream. + ```js + findUser().then(function (user) { + throw new PedagogicalException('Upstream error'); + }).then(function (value) { + // never reached + }).then(function (value) { + // never reached + }, function (reason) { + // The `PedgagocialException` is propagated all the way down to here + }); + ``` + Assimilation + ------------ + Sometimes the value you want to propagate to a downstream promise can only be + retrieved asynchronously. This can be achieved by returning a promise in the + fulfillment or rejection handler. The downstream promise will then be pending + until the returned promise is settled. This is called *assimilation*. + ```js + findUser().then(function (user) { + return findCommentsByAuthor(user); + }).then(function (comments) { + // The user's comments are now available + }); + ``` + If the assimliated promise rejects, then the downstream promise will also reject. + ```js + findUser().then(function (user) { + return findCommentsByAuthor(user); + }).then(function (comments) { + // If `findCommentsByAuthor` fulfills, we'll have the value here + }, function (reason) { + // If `findCommentsByAuthor` rejects, we'll have the reason here + }); + ``` + Simple Example + -------------- + Synchronous Example + ```javascript + let result; + try { + result = findResult(); + // success + } catch(reason) { + // failure + } + ``` + Errback Example + ```js + findResult(function(result, err){ + if (err) { + // failure + } else { + // success + } + }); + ``` + Promise Example; + ```javascript + findResult().then(function(result){ + // success + }, function(reason){ + // failure + }); + ``` + Advanced Example + -------------- + Synchronous Example + ```javascript + let author, books; + try { + author = findAuthor(); + books = findBooksByAuthor(author); + // success + } catch(reason) { + // failure + } + ``` + Errback Example + ```js + function foundBooks(books) { + } + function failure(reason) { + } + findAuthor(function(author, err){ + if (err) { + failure(err); + // failure + } else { + try { + findBoooksByAuthor(author, function(books, err) { + if (err) { + failure(err); + } else { + try { + foundBooks(books); + } catch(reason) { + failure(reason); + } + } + }); + } catch(error) { + failure(err); + } + // success + } + }); + ``` + Promise Example; + ```javascript + findAuthor(). + then(findBooksByAuthor). + then(function(books){ + // found books + }).catch(function(reason){ + // something went wrong + }); + ``` + @method then + @param {Function} onFulfilled + @param {Function} onRejected + Useful for tooling. + @return {Promise} + */ + + /** + `catch` is simply sugar for `then(undefined, onRejection)` which makes it the same + as the catch block of a try/catch statement. + ```js + function findAuthor(){ + throw new Error('couldn't find that author'); + } + // synchronous + try { + findAuthor(); + } catch(reason) { + // something went wrong + } + // async with promises + findAuthor().catch(function(reason){ + // something went wrong + }); + ``` + @method catch + @param {Function} onRejection + Useful for tooling. + @return {Promise} + */ + + + Promise.prototype.catch = function _catch(onRejection) { + return this.then(null, onRejection); + }; + + /** + `finally` will be invoked regardless of the promise's fate just as native + try/catch/finally behaves + + Synchronous example: + + ```js + findAuthor() { + if (Math.random() > 0.5) { + throw new Error(); + } + return new Author(); + } + + try { + return findAuthor(); // succeed or fail + } catch(error) { + return findOtherAuther(); + } finally { + // always runs + // doesn't affect the return value + } + ``` + + Asynchronous example: + + ```js + findAuthor().catch(function(reason){ + return findOtherAuther(); + }).finally(function(){ + // author was either found, or not + }); + ``` + + @method finally + @param {Function} callback + @return {Promise} + */ + + + Promise.prototype.finally = function _finally(callback) { + var promise = this; + var constructor = promise.constructor; + + if (isFunction(callback)) { + return promise.then(function (value) { + return constructor.resolve(callback()).then(function () { + return value; + }); + }, function (reason) { + return constructor.resolve(callback()).then(function () { + throw reason; + }); + }); + } + + return promise.then(callback, callback); + }; + + return Promise; +}(); + +Promise$1.prototype.then = then; +Promise$1.all = all; +Promise$1.race = race; +Promise$1.resolve = resolve$1; +Promise$1.reject = reject$1; +Promise$1._setScheduler = setScheduler; +Promise$1._setAsap = setAsap; +Promise$1._asap = asap; + +/*global self*/ +function polyfill() { + var local = void 0; + + if (typeof global !== 'undefined') { + local = global; + } else if (typeof self !== 'undefined') { + local = self; + } else { + try { + local = Function('return this')(); + } catch (e) { + throw new Error('polyfill failed because global object is unavailable in this environment'); + } + } + + var P = local.Promise; + + if (P) { + var promiseToString = null; + try { + promiseToString = Object.prototype.toString.call(P.resolve()); + } catch (e) { + // silently ignored + } + + if (promiseToString === '[object Promise]' && !P.cast) { + return; + } + } + + local.Promise = Promise$1; +} + +// Strange compat.. +Promise$1.polyfill = polyfill; +Promise$1.Promise = Promise$1; + +return Promise$1; + +}))); + + + + + +}).call(this,_dereq_('_process'),typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {}) +},{"_process":11}],6:[function(_dereq_,module,exports){ +(function (global, factory) { + if (typeof define === 'function' && define.amd) { + define(['exports', 'module'], factory); + } else if (typeof exports !== 'undefined' && typeof module !== 'undefined') { + factory(exports, module); + } else { + var mod = { + exports: {} + }; + factory(mod.exports, mod); + global.fetchJsonp = mod.exports; + } +})(this, function (exports, module) { + 'use strict'; + + var defaultOptions = { + timeout: 5000, + jsonpCallback: 'callback', + jsonpCallbackFunction: null + }; + + function generateCallbackFunction() { + return 'jsonp_' + Date.now() + '_' + Math.ceil(Math.random() * 100000); + } + + function clearFunction(functionName) { + // IE8 throws an exception when you try to delete a property on window + // http://stackoverflow.com/a/1824228/751089 + try { + delete window[functionName]; + } catch (e) { + window[functionName] = undefined; + } + } + + function removeScript(scriptId) { + var script = document.getElementById(scriptId); + if (script) { + document.getElementsByTagName('head')[0].removeChild(script); + } + } + + function fetchJsonp(_url) { + var options = arguments.length <= 1 || arguments[1] === undefined ? {} : arguments[1]; + + // to avoid param reassign + var url = _url; + var timeout = options.timeout || defaultOptions.timeout; + var jsonpCallback = options.jsonpCallback || defaultOptions.jsonpCallback; + + var timeoutId = undefined; + + return new Promise(function (resolve, reject) { + var callbackFunction = options.jsonpCallbackFunction || generateCallbackFunction(); + var scriptId = jsonpCallback + '_' + callbackFunction; + + window[callbackFunction] = function (response) { + resolve({ + ok: true, + // keep consistent with fetch API + json: function json() { + return Promise.resolve(response); + } + }); + + if (timeoutId) clearTimeout(timeoutId); + + removeScript(scriptId); + + clearFunction(callbackFunction); + }; + + // Check if the user set their own params, and if not add a ? to start a list of params + url += url.indexOf('?') === -1 ? '?' : '&'; + + var jsonpScript = document.createElement('script'); + jsonpScript.setAttribute('src', '' + url + jsonpCallback + '=' + callbackFunction); + if (options.charset) { + jsonpScript.setAttribute('charset', options.charset); + } + jsonpScript.id = scriptId; + document.getElementsByTagName('head')[0].appendChild(jsonpScript); + + timeoutId = setTimeout(function () { + reject(new Error('JSONP request to ' + _url + ' timed out')); + + clearFunction(callbackFunction); + removeScript(scriptId); + window[callbackFunction] = function () { + clearFunction(callbackFunction); + }; + }, timeout); + + // Caught if got 404/500 + jsonpScript.onerror = function () { + reject(new Error('JSONP request to ' + _url + ' failed')); + + clearFunction(callbackFunction); + removeScript(scriptId); + if (timeoutId) clearTimeout(timeoutId); + }; + }); + } + + // export as global function + /* + let local; + if (typeof global !== 'undefined') { + local = global; + } else if (typeof self !== 'undefined') { + local = self; + } else { + try { + local = Function('return this')(); + } catch (e) { + throw new Error('polyfill failed because global object is unavailable in this environment'); + } + } + local.fetchJsonp = fetchJsonp; + */ + + module.exports = fetchJsonp; +}); +},{}],7:[function(_dereq_,module,exports){ +/* FileSaver.js + * A saveAs() FileSaver implementation. + * 1.3.2 + * 2016-06-16 18:25:19 + * + * By Eli Grey, http://eligrey.com + * License: MIT + * See https://github.com/eligrey/FileSaver.js/blob/master/LICENSE.md + */ + +/*global self */ +/*jslint bitwise: true, indent: 4, laxbreak: true, laxcomma: true, smarttabs: true, plusplus: true */ + +/*! @source http://purl.eligrey.com/github/FileSaver.js/blob/master/FileSaver.js */ + +var saveAs = saveAs || (function(view) { + "use strict"; + // IE <10 is explicitly unsupported + if (typeof view === "undefined" || typeof navigator !== "undefined" && /MSIE [1-9]\./.test(navigator.userAgent)) { + return; + } + var + doc = view.document + // only get URL when necessary in case Blob.js hasn't overridden it yet + , get_URL = function() { + return view.URL || view.webkitURL || view; + } + , save_link = doc.createElementNS("http://www.w3.org/1999/xhtml", "a") + , can_use_save_link = "download" in save_link + , click = function(node) { + var event = new MouseEvent("click"); + node.dispatchEvent(event); + } + , is_safari = /constructor/i.test(view.HTMLElement) || view.safari + , is_chrome_ios =/CriOS\/[\d]+/.test(navigator.userAgent) + , throw_outside = function(ex) { + (view.setImmediate || view.setTimeout)(function() { + throw ex; + }, 0); + } + , force_saveable_type = "application/octet-stream" + // the Blob API is fundamentally broken as there is no "downloadfinished" event to subscribe to + , arbitrary_revoke_timeout = 1000 * 40 // in ms + , revoke = function(file) { + var revoker = function() { + if (typeof file === "string") { // file is an object URL + get_URL().revokeObjectURL(file); + } else { // file is a File + file.remove(); + } + }; + setTimeout(revoker, arbitrary_revoke_timeout); + } + , dispatch = function(filesaver, event_types, event) { + event_types = [].concat(event_types); + var i = event_types.length; + while (i--) { + var listener = filesaver["on" + event_types[i]]; + if (typeof listener === "function") { + try { + listener.call(filesaver, event || filesaver); + } catch (ex) { + throw_outside(ex); + } + } + } + } + , auto_bom = function(blob) { + // prepend BOM for UTF-8 XML and text/* types (including HTML) + // note: your browser will automatically convert UTF-16 U+FEFF to EF BB BF + if (/^\s*(?:text\/\S*|application\/xml|\S*\/\S*\+xml)\s*;.*charset\s*=\s*utf-8/i.test(blob.type)) { + return new Blob([String.fromCharCode(0xFEFF), blob], {type: blob.type}); + } + return blob; + } + , FileSaver = function(blob, name, no_auto_bom) { + if (!no_auto_bom) { + blob = auto_bom(blob); + } + // First try a.download, then web filesystem, then object URLs + var + filesaver = this + , type = blob.type + , force = type === force_saveable_type + , object_url + , dispatch_all = function() { + dispatch(filesaver, "writestart progress write writeend".split(" ")); + } + // on any filesys errors revert to saving with object URLs + , fs_error = function() { + if ((is_chrome_ios || (force && is_safari)) && view.FileReader) { + // Safari doesn't allow downloading of blob urls + var reader = new FileReader(); + reader.onloadend = function() { + var url = is_chrome_ios ? reader.result : reader.result.replace(/^data:[^;]*;/, 'data:attachment/file;'); + var popup = view.open(url, '_blank'); + if(!popup) view.location.href = url; + url=undefined; // release reference before dispatching + filesaver.readyState = filesaver.DONE; + dispatch_all(); + }; + reader.readAsDataURL(blob); + filesaver.readyState = filesaver.INIT; + return; + } + // don't create more object URLs than needed + if (!object_url) { + object_url = get_URL().createObjectURL(blob); + } + if (force) { + view.location.href = object_url; + } else { + var opened = view.open(object_url, "_blank"); + if (!opened) { + // Apple does not allow window.open, see https://developer.apple.com/library/safari/documentation/Tools/Conceptual/SafariExtensionGuide/WorkingwithWindowsandTabs/WorkingwithWindowsandTabs.html + view.location.href = object_url; + } + } + filesaver.readyState = filesaver.DONE; + dispatch_all(); + revoke(object_url); + } + ; + filesaver.readyState = filesaver.INIT; + + if (can_use_save_link) { + object_url = get_URL().createObjectURL(blob); + setTimeout(function() { + save_link.href = object_url; + save_link.download = name; + click(save_link); + dispatch_all(); + revoke(object_url); + filesaver.readyState = filesaver.DONE; + }); + return; + } + + fs_error(); + } + , FS_proto = FileSaver.prototype + , saveAs = function(blob, name, no_auto_bom) { + return new FileSaver(blob, name || blob.name || "download", no_auto_bom); + } + ; + // IE 10+ (native saveAs) + if (typeof navigator !== "undefined" && navigator.msSaveOrOpenBlob) { + return function(blob, name, no_auto_bom) { + name = name || blob.name || "download"; + + if (!no_auto_bom) { + blob = auto_bom(blob); + } + return navigator.msSaveOrOpenBlob(blob, name); + }; + } + + FS_proto.abort = function(){}; + FS_proto.readyState = FS_proto.INIT = 0; + FS_proto.WRITING = 1; + FS_proto.DONE = 2; + + FS_proto.error = + FS_proto.onwritestart = + FS_proto.onprogress = + FS_proto.onwrite = + FS_proto.onabort = + FS_proto.onerror = + FS_proto.onwriteend = + null; + + return saveAs; +}( + typeof self !== "undefined" && self + || typeof window !== "undefined" && window + || this.content +)); +// `self` is undefined in Firefox for Android content script context +// while `this` is nsIContentFrameMessageManager +// with an attribute `content` that corresponds to the window + +if (typeof module !== "undefined" && module.exports) { + module.exports.saveAs = saveAs; +} else if ((typeof define !== "undefined" && define !== null) && (define.amd !== null)) { + define("FileSaver.js", function() { + return saveAs; + }); +} + +},{}],8:[function(_dereq_,module,exports){ +exports.read = function (buffer, offset, isLE, mLen, nBytes) { + var e, m + var eLen = (nBytes * 8) - mLen - 1 + var eMax = (1 << eLen) - 1 + var eBias = eMax >> 1 + var nBits = -7 + var i = isLE ? (nBytes - 1) : 0 + var d = isLE ? -1 : 1 + var s = buffer[offset + i] + + i += d + + e = s & ((1 << (-nBits)) - 1) + s >>= (-nBits) + nBits += eLen + for (; nBits > 0; e = (e * 256) + buffer[offset + i], i += d, nBits -= 8) {} + + m = e & ((1 << (-nBits)) - 1) + e >>= (-nBits) + nBits += mLen + for (; nBits > 0; m = (m * 256) + buffer[offset + i], i += d, nBits -= 8) {} + + if (e === 0) { + e = 1 - eBias + } else if (e === eMax) { + return m ? NaN : ((s ? -1 : 1) * Infinity) + } else { + m = m + Math.pow(2, mLen) + e = e - eBias + } + return (s ? -1 : 1) * m * Math.pow(2, e - mLen) +} + +exports.write = function (buffer, value, offset, isLE, mLen, nBytes) { + var e, m, c + var eLen = (nBytes * 8) - mLen - 1 + var eMax = (1 << eLen) - 1 + var eBias = eMax >> 1 + var rt = (mLen === 23 ? Math.pow(2, -24) - Math.pow(2, -77) : 0) + var i = isLE ? 0 : (nBytes - 1) + var d = isLE ? 1 : -1 + var s = value < 0 || (value === 0 && 1 / value < 0) ? 1 : 0 + + value = Math.abs(value) + + if (isNaN(value) || value === Infinity) { + m = isNaN(value) ? 1 : 0 + e = eMax + } else { + e = Math.floor(Math.log(value) / Math.LN2) + if (value * (c = Math.pow(2, -e)) < 1) { + e-- + c *= 2 + } + if (e + eBias >= 1) { + value += rt / c + } else { + value += rt * Math.pow(2, 1 - eBias) + } + if (value * c >= 2) { + e++ + c /= 2 + } + + if (e + eBias >= eMax) { + m = 0 + e = eMax + } else if (e + eBias >= 1) { + m = ((value * c) - 1) * Math.pow(2, mLen) + e = e + eBias + } else { + m = value * Math.pow(2, eBias - 1) * Math.pow(2, mLen) + e = 0 + } + } + + for (; mLen >= 8; buffer[offset + i] = m & 0xff, i += d, m /= 256, mLen -= 8) {} + + e = (e << mLen) | m + eLen += mLen + for (; eLen > 0; buffer[offset + i] = e & 0xff, i += d, e /= 256, eLen -= 8) {} + + buffer[offset + i - d] |= s * 128 +} + +},{}],9:[function(_dereq_,module,exports){ +/* + + Copyright 2000, Silicon Graphics, Inc. All Rights Reserved. + Copyright 2015, Google Inc. All Rights Reserved. + + Permission is hereby granted, free of charge, to any person obtaining a copy + of this software and associated documentation files (the "Software"), to + deal in the Software without restriction, including without limitation the + rights to use, copy, modify, merge, publish, distribute, sublicense, and/or + sell copies of the Software, and to permit persons to whom the Software is + furnished to do so, subject to the following conditions: + + The above copyright notice including the dates of first publication and + either this permission notice or a reference to http://oss.sgi.com/projects/FreeB/ + shall be included in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + SILICON GRAPHICS, INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, + WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR + IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + + Original Code. The Original Code is: OpenGL Sample Implementation, + Version 1.2.1, released January 26, 2000, developed by Silicon Graphics, + Inc. The Original Code is Copyright (c) 1991-2000 Silicon Graphics, Inc. + Copyright in any portions created by third parties is as indicated + elsewhere herein. All Rights Reserved. +*/ +'use strict';var n;function t(a,b){return a.b===b.b&&a.a===b.a}function u(a,b){return a.ba?0:a;c=0>c?0:c;return a<=c?0===c?(b+d)/2:b+a/(a+c)*(d-b):d+c/(a+c)*(b-d)};function ea(a){var b=B(a.b);C(b,a.c);C(b.b,a.c);D(b,a.a);return b}function E(a,b){var c=!1,d=!1;a!==b&&(b.a!==a.a&&(d=!0,F(b.a,a.a)),b.d!==a.d&&(c=!0,G(b.d,a.d)),H(b,a),d||(C(b,a.a),a.a.c=a),c||(D(b,a.d),a.d.a=a))}function I(a){var b=a.b,c=!1;a.d!==a.b.d&&(c=!0,G(a.d,a.b.d));a.c===a?F(a.a,null):(a.b.d.a=J(a),a.a.c=a.c,H(a,J(a)),c||D(a,a.d));b.c===b?(F(b.a,null),G(b.d,null)):(a.d.a=J(b),b.a.c=b.c,H(b,J(b)));fa(a)} +function K(a){var b=B(a),c=b.b;H(b,a.e);b.a=a.b.a;C(c,b.a);b.d=c.d=a.d;b=b.b;H(a.b,J(a.b));H(a.b,b);a.b.a=b.a;b.b.a.c=b.b;b.b.d=a.b.d;b.f=a.f;b.b.f=a.b.f;return b}function L(a,b){var c=!1,d=B(a),e=d.b;b.d!==a.d&&(c=!0,G(b.d,a.d));H(d,a.e);H(e,b);d.a=a.b.a;e.a=b.a;d.d=e.d=a.d;a.d.a=e;c||D(d,a.d);return d}function B(a){var b=new M,c=new M,d=a.b.h;c.h=d;d.b.h=b;b.h=a;a.b.h=c;b.b=c;b.c=b;b.e=c;c.b=b;c.c=c;return c.e=b}function H(a,b){var c=a.c,d=b.c;c.b.e=b;d.b.e=a;a.c=d;b.c=c} +function C(a,b){var c=b.f,d=new N(b,c);c.e=d;b.f=d;c=d.c=a;do c.a=d,c=c.c;while(c!==a)}function D(a,b){var c=b.d,d=new ga(b,c);c.b=d;b.d=d;d.a=a;d.c=b.c;c=a;do c.d=d,c=c.e;while(c!==a)}function fa(a){var b=a.h;a=a.b.h;b.b.h=a;a.b.h=b}function F(a,b){var c=a.c,d=c;do d.a=b,d=d.c;while(d!==c);c=a.f;d=a.e;d.f=c;c.e=d}function G(a,b){var c=a.a,d=c;do d.d=b,d=d.e;while(d!==c);c=a.d;d=a.b;d.d=c;c.b=d};function ha(a){var b=0;Math.abs(a[1])>Math.abs(a[0])&&(b=1);Math.abs(a[2])>Math.abs(a[b])&&(b=2);return b};var O=4*1E150;function P(a,b){a.f+=b.f;a.b.f+=b.b.f}function ia(a,b,c){a=a.a;b=b.a;c=c.a;if(b.b.a===a)return c.b.a===a?u(b.a,c.a)?0>=x(c.b.a,b.a,c.a):0<=x(b.b.a,c.a,b.a):0>=x(c.b.a,a,c.a);if(c.b.a===a)return 0<=x(b.b.a,a,b.a);b=v(b.b.a,a,b.a);a=v(c.b.a,a,c.a);return b>=a}function Q(a){a.a.i=null;var b=a.e;b.a.c=b.c;b.c.a=b.a;a.e=null}function ja(a,b){I(a.a);a.c=!1;a.a=b;b.i=a}function ka(a){var b=a.a.a;do a=R(a);while(a.a.a===b);a.c&&(b=L(S(a).a.b,a.a.e),ja(a,b),a=R(a));return a} +function la(a,b,c){var d=new ma;d.a=c;d.e=na(a.f,b.e,d);return c.i=d}function oa(a,b){switch(a.s){case 100130:return 0!==(b&1);case 100131:return 0!==b;case 100132:return 0b;case 100134:return 2<=b||-2>=b}return!1}function pa(a){var b=a.a,c=b.d;c.c=a.d;c.a=b;Q(a)}function T(a,b,c){a=b;for(b=b.a;a!==c;){a.c=!1;var d=S(a),e=d.a;if(e.a!==b.a){if(!d.c){pa(a);break}e=L(b.c.b,e.b);ja(d,e)}b.c!==e&&(E(J(e),e),E(b,e));pa(a);b=d.a;a=d}return b} +function U(a,b,c,d,e,f){var g=!0;do la(a,b,c.b),c=c.c;while(c!==d);for(null===e&&(e=S(b).a.b.c);;){d=S(b);c=d.a.b;if(c.a!==e.a)break;c.c!==e&&(E(J(c),c),E(J(e),c));d.f=b.f-c.f;d.d=oa(a,d.f);b.b=!0;!g&&qa(a,b)&&(P(c,e),Q(b),I(e));g=!1;b=d;e=c}b.b=!0;f&&ra(a,b)}function sa(a,b,c,d,e){var f=[b.g[0],b.g[1],b.g[2]];b.d=null;b.d=a.o?a.o(f,c,d,a.c)||null:null;null===b.d&&(e?a.n||(V(a,100156),a.n=!0):b.d=c[0])} +function ta(a,b,c){var d=[null,null,null,null];d[0]=b.a.d;d[1]=c.a.d;sa(a,b.a,d,[.5,.5,0,0],!1);E(b,c)}function ua(a,b,c,d,e){var f=Math.abs(b.b-a.b)+Math.abs(b.a-a.a),g=Math.abs(c.b-a.b)+Math.abs(c.a-a.a),h=e+1;d[e]=.5*g/(f+g);d[h]=.5*f/(f+g);a.g[0]+=d[e]*b.g[0]+d[h]*c.g[0];a.g[1]+=d[e]*b.g[1]+d[h]*c.g[1];a.g[2]+=d[e]*b.g[2]+d[h]*c.g[2]} +function qa(a,b){var c=S(b),d=b.a,e=c.a;if(u(d.a,e.a)){if(0=l?W(c,l):u(h[g[l>>1]],h[g[l]])?W(c,l):va(c,l));h[f]=null;k[f]=c.b;c.b=f}else for(c.c[-(f+1)]=null;0x(d.b.a,e.a,d.a))return!1;R(b).b=b.b=!0;K(d.b);E(J(e),d)}return!0} +function wa(a,b){var c=S(b),d=b.a,e=c.a,f=d.a,g=e.a,h=d.b.a,k=e.b.a,l=new N;x(h,a.a,f);x(k,a.a,g);if(f===g||Math.min(f.a,h.a)>Math.max(g.a,k.a))return!1;if(u(f,g)){if(0x(h,g,f))return!1;var r=h,p=f,q=k,y=g,m,w;u(r,p)||(m=r,r=p,p=m);u(q,y)||(m=q,q=y,y=m);u(r,q)||(m=r,r=q,q=m,m=p,p=y,y=m);u(q,p)?u(p,y)?(m=v(r,q,p),w=v(q,p,y),0>m+w&&(m=-m,w=-w),l.b=A(m,q.b,w,p.b)):(m=x(r,q,p),w=-x(r,y,p),0>m+w&&(m=-m,w=-w),l.b=A(m,q.b,w,y.b)):l.b=(q.b+p.b)/2;z(r,p)||(m=r,r=p,p=m);z(q,y)|| +(m=q,q=y,y=m);z(r,q)||(m=r,r=q,q=m,m=p,p=y,y=m);z(q,p)?z(p,y)?(m=aa(r,q,p),w=aa(q,p,y),0>m+w&&(m=-m,w=-w),l.a=A(m,q.a,w,p.a)):(m=ba(r,q,p),w=-ba(r,y,p),0>m+w&&(m=-m,w=-w),l.a=A(m,q.a,w,y.a)):l.a=(q.a+p.a)/2;u(l,a.a)&&(l.b=a.a.b,l.a=a.a.a);r=u(f,g)?f:g;u(r,l)&&(l.b=r.b,l.a=r.a);if(t(l,f)||t(l,g))return qa(a,b),!1;if(!t(h,a.a)&&0<=x(h,a.a,l)||!t(k,a.a)&&0>=x(k,a.a,l)){if(k===a.a)return K(d.b),E(e.b,d),b=ka(b),d=S(b).a,T(a,S(b),c),U(a,b,J(d),d,d,!0),!0;if(h===a.a){K(e.b);E(d.e,J(e));f=c=b;g=f.a.b.a; +do f=R(f);while(f.a.b.a===g);b=f;f=S(b).a.b.c;c.a=J(e);e=T(a,c,null);U(a,b,e.c,d.b.c,f,!0);return!0}0<=x(h,a.a,l)&&(R(b).b=b.b=!0,K(d.b),d.a.b=a.a.b,d.a.a=a.a.a);0>=x(k,a.a,l)&&(b.b=c.b=!0,K(e.b),e.a.b=a.a.b,e.a.a=a.a.a);return!1}K(d.b);K(e.b);E(J(e),d);d.a.b=l.b;d.a.a=l.a;d.a.h=xa(a.e,d.a);d=d.a;e=[0,0,0,0];l=[f.d,h.d,g.d,k.d];d.g[0]=d.g[1]=d.g[2]=0;ua(d,f,h,e,0);ua(d,g,k,e,2);sa(a,d,l,e,!0);R(b).b=b.b=c.b=!0;return!1} +function ra(a,b){for(var c=S(b);;){for(;c.b;)b=c,c=S(c);if(!b.b&&(c=b,b=R(b),null===b||!b.b))break;b.b=!1;var d=b.a,e=c.a,f;if(f=d.b.a!==e.b.a)a:{f=b;var g=S(f),h=f.a,k=g.a,l=void 0;if(u(h.b.a,k.b.a)){if(0>x(h.b.a,k.b.a,h.a)){f=!1;break a}R(f).b=f.b=!0;l=K(h);E(k.b,l);l.d.c=f.d}else{if(0e;++e){var f=a[e];-1E150>f&&(f=-1E150,c=!0);1E150h;++h){var k=a.g[h];kb[h]&&(b[h]=k,c[h]=a)}a=0;b[1]-f[1]>b[0]-f[0]&&(a=1);b[2]-f[2]>b[a]-f[a]&&(a=2);if(f[a]>=b[a])e[0]=0,e[1]=0,e[2]=1;else{b=0;f=g[a];c=c[a];g=[0,0,0];f=[f.g[0]-c.g[0],f.g[1]-c.g[1],f.g[2]-c.g[2]];h=[0,0,0];for(a=d.e;a!==d;a= +a.e)h[0]=a.g[0]-c.g[0],h[1]=a.g[1]-c.g[1],h[2]=a.g[2]-c.g[2],g[0]=f[1]*h[2]-f[2]*h[1],g[1]=f[2]*h[0]-f[0]*h[2],g[2]=f[0]*h[1]-f[1]*h[0],k=g[0]*g[0]+g[1]*g[1]+g[2]*g[2],k>b&&(b=k,e[0]=g[0],e[1]=g[1],e[2]=g[2]);0>=b&&(e[0]=e[1]=e[2]=0,e[ha(f)]=1)}d=!0}g=ha(e);a=this.b.c;b=(g+1)%3;c=(g+2)%3;g=0=b.f)){do e+=(b.a.b-b.b.a.b)*(b.a.a+b.b.a.a),b=b.e;while(b!==a.a)}if(0>e)for(e=this.b.c,d=e.e;d!== +e;d=d.e)d.a=-d.a}this.n=!1;e=this.b.b;for(a=e.h;a!==e;a=d)if(d=a.h,b=a.e,t(a.a,a.b.a)&&a.e.e!==a&&(ta(this,b,a),I(a),a=b,b=a.e),b.e===a){if(b!==a){if(b===d||b===d.b)d=d.h;I(b)}if(a===d||a===d.b)d=d.h;I(a)}this.e=e=new Da;d=this.b.c;for(a=d.e;a!==d;a=a.e)a.h=xa(e,a);Ea(e);this.f=new Aa(this);za(this,-O);for(za(this,O);null!==(e=Fa(this.e));){for(;;){a:if(a=this.e,0===a.a)d=Ga(a.b);else if(d=a.c[a.d[a.a-1]],0!==a.b.a&&(a=Ga(a.b),u(a,d))){d=a;break a}if(null===d||!t(d,e))break;d=Fa(this.e);ta(this,e.c, +d.c)}ya(this,e)}this.a=this.f.a.a.b.a.a;for(e=0;null!==(d=this.f.a.a.b);)d.h||++e,Q(d);this.f=null;e=this.e;e.b=null;e.d=null;this.e=e.c=null;e=this.b;for(a=e.a.b;a!==e.a;a=d)d=a.b,a=a.a,a.e.e===a&&(P(a.c,a),I(a));if(!this.n){e=this.b;if(this.m)for(a=e.b.h;a!==e.b;a=d)d=a.h,a.b.d.c!==a.d.c?a.f=a.d.c?1:-1:I(a);else for(a=e.a.b;a!==e.a;a=d)if(d=a.b,a.c){for(a=a.a;u(a.b.a,a.a);a=a.c.b);for(;u(a.a,a.b.a);a=a.e);b=a.c.b;for(c=void 0;a.e!==b;)if(u(a.b.a,b.a)){for(;b.e!==a&&(ca(b.e)||0>=x(b.a,b.b.a,b.e.b.a));)c= +L(b.e,b),b=c.b;b=b.c.b}else{for(;b.e!==a&&(da(a.c.b)||0<=x(a.b.a,a.a,a.c.b.a));)c=L(a,a.c.b),a=c.b;a=a.e}for(;b.e.e!==a;)c=L(b.e,b),b=c.b}if(this.h||this.i||this.k||this.l)if(this.m)for(e=this.b,d=e.a.b;d!==e.a;d=d.b){if(d.c){this.h&&this.h(2,this.c);a=d.a;do this.k&&this.k(a.a.d,this.c),a=a.e;while(a!==d.a);this.i&&this.i(this.c)}}else{e=this.b;d=!!this.l;a=!1;b=-1;for(c=e.a.d;c!==e.a;c=c.d)if(c.c){a||(this.h&&this.h(4,this.c),a=!0);g=c.a;do d&&(f=g.b.d.c?0:1,b!==f&&(b=f,this.l&&this.l(!!b,this.c))), +this.k&&this.k(g.a.d,this.c),g=g.e;while(g!==c.a)}a&&this.i&&this.i(this.c)}if(this.r){e=this.b;for(a=e.a.b;a!==e.a;a=d)if(d=a.b,!a.c){b=a.a;c=b.e;g=void 0;do g=c,c=g.e,g.d=null,null===g.b.d&&(g.c===g?F(g.a,null):(g.a.c=g.c,H(g,J(g))),f=g.b,f.c===f?F(f.a,null):(f.a.c=f.c,H(f,J(f))),fa(g));while(g!==b);b=a.d;a=a.b;a.d=b;b.b=a}this.r(this.b);this.c=this.b=null;return}}this.b=this.c=null}; +function Z(a,b){if(a.d!==b)for(;a.d!==b;)if(a.dc.f&&(c.f*=2,c.c=Ja(c.c,c.f+1));var e;0===c.b?e=d:(e=c.b,c.b=c.c[c.b]);c.e[e]=b;c.c[e]=d;c.d[d]=e;c.h&&va(c,d);return e}c=a.a++;a.c[c]=b;return-(c+1)} +function Fa(a){if(0===a.a)return Ka(a.b);var b=a.c[a.d[a.a-1]];if(0!==a.b.a&&u(Ga(a.b),b))return Ka(a.b);do--a.a;while(0a.a||u(d[g],d[k])){c[f]=g;e[g]=f;break}c[f]=k;e[k]=f;f=h}}function va(a,b){for(var c=a.d,d=a.e,e=a.c,f=b,g=c[f];;){var h=f>>1,k=c[h];if(0===h||u(d[k],d[g])){c[f]=g;e[g]=f;break}c[f]=k;e[k]=f;f=h}};function ma(){this.e=this.a=null;this.f=0;this.c=this.b=this.h=this.d=!1}function S(a){return a.e.c.b}function R(a){return a.e.a.b};this.libtess={GluTesselator:X,windingRule:{GLU_TESS_WINDING_ODD:100130,GLU_TESS_WINDING_NONZERO:100131,GLU_TESS_WINDING_POSITIVE:100132,GLU_TESS_WINDING_NEGATIVE:100133,GLU_TESS_WINDING_ABS_GEQ_TWO:100134},primitiveType:{GL_LINE_LOOP:2,GL_TRIANGLES:4,GL_TRIANGLE_STRIP:5,GL_TRIANGLE_FAN:6},errorType:{GLU_TESS_MISSING_BEGIN_POLYGON:100151,GLU_TESS_MISSING_END_POLYGON:100153,GLU_TESS_MISSING_BEGIN_CONTOUR:100152,GLU_TESS_MISSING_END_CONTOUR:100154,GLU_TESS_COORD_TOO_LARGE:100155,GLU_TESS_NEED_COMBINE_CALLBACK:100156}, +gluEnum:{GLU_TESS_MESH:100112,GLU_TESS_TOLERANCE:100142,GLU_TESS_WINDING_RULE:100140,GLU_TESS_BOUNDARY_ONLY:100141,GLU_INVALID_ENUM:100900,GLU_INVALID_VALUE:100901,GLU_TESS_BEGIN:100100,GLU_TESS_VERTEX:100101,GLU_TESS_END:100102,GLU_TESS_ERROR:100103,GLU_TESS_EDGE_FLAG:100104,GLU_TESS_COMBINE:100105,GLU_TESS_BEGIN_DATA:100106,GLU_TESS_VERTEX_DATA:100107,GLU_TESS_END_DATA:100108,GLU_TESS_ERROR_DATA:100109,GLU_TESS_EDGE_FLAG_DATA:100110,GLU_TESS_COMBINE_DATA:100111}};X.prototype.gluDeleteTess=X.prototype.x; +X.prototype.gluTessProperty=X.prototype.B;X.prototype.gluGetTessProperty=X.prototype.y;X.prototype.gluTessNormal=X.prototype.A;X.prototype.gluTessCallback=X.prototype.z;X.prototype.gluTessVertex=X.prototype.C;X.prototype.gluTessBeginPolygon=X.prototype.u;X.prototype.gluTessBeginContour=X.prototype.t;X.prototype.gluTessEndContour=X.prototype.v;X.prototype.gluTessEndPolygon=X.prototype.w; if (typeof module !== 'undefined') { module.exports = this.libtess; } + +},{}],10:[function(_dereq_,module,exports){ +(function (Buffer){ +/** + * https://opentype.js.org v0.9.0 | (c) Frederik De Bleser and other contributors | MIT License | Uses tiny-inflate by Devon Govett and string.prototype.codepointat polyfill by Mathias Bynens + */ + +(function (global, factory) { + typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) : + typeof define === 'function' && define.amd ? define(['exports'], factory) : + (factory((global.opentype = {}))); +}(this, (function (exports) { 'use strict'; + + /*! https://mths.be/codepointat v0.2.0 by @mathias */ + if (!String.prototype.codePointAt) { + (function() { + var defineProperty = (function() { + // IE 8 only supports `Object.defineProperty` on DOM elements + try { + var object = {}; + var $defineProperty = Object.defineProperty; + var result = $defineProperty(object, object, object) && $defineProperty; + } catch(error) {} + return result; + }()); + var codePointAt = function(position) { + if (this == null) { + throw TypeError(); + } + var string = String(this); + var size = string.length; + // `ToInteger` + var index = position ? Number(position) : 0; + if (index != index) { // better `isNaN` + index = 0; + } + // Account for out-of-bounds indices: + if (index < 0 || index >= size) { + return undefined; + } + // Get the first code unit + var first = string.charCodeAt(index); + var second; + if ( // check if it’s the start of a surrogate pair + first >= 0xD800 && first <= 0xDBFF && // high surrogate + size > index + 1 // there is a next code unit + ) { + second = string.charCodeAt(index + 1); + if (second >= 0xDC00 && second <= 0xDFFF) { // low surrogate + // https://mathiasbynens.be/notes/javascript-encoding#surrogate-formulae + return (first - 0xD800) * 0x400 + second - 0xDC00 + 0x10000; + } + } + return first; + }; + if (defineProperty) { + defineProperty(String.prototype, 'codePointAt', { + 'value': codePointAt, + 'configurable': true, + 'writable': true + }); + } else { + String.prototype.codePointAt = codePointAt; + } + }()); + } + + var TINF_OK = 0; + var TINF_DATA_ERROR = -3; + + function Tree() { + this.table = new Uint16Array(16); /* table of code length counts */ + this.trans = new Uint16Array(288); /* code -> symbol translation table */ + } + + function Data(source, dest) { + this.source = source; + this.sourceIndex = 0; + this.tag = 0; + this.bitcount = 0; + + this.dest = dest; + this.destLen = 0; + + this.ltree = new Tree(); /* dynamic length/symbol tree */ + this.dtree = new Tree(); /* dynamic distance tree */ + } + + /* --------------------------------------------------- * + * -- uninitialized global data (static structures) -- * + * --------------------------------------------------- */ + + var sltree = new Tree(); + var sdtree = new Tree(); + + /* extra bits and base tables for length codes */ + var length_bits = new Uint8Array(30); + var length_base = new Uint16Array(30); + + /* extra bits and base tables for distance codes */ + var dist_bits = new Uint8Array(30); + var dist_base = new Uint16Array(30); + + /* special ordering of code length codes */ + var clcidx = new Uint8Array([ + 16, 17, 18, 0, 8, 7, 9, 6, + 10, 5, 11, 4, 12, 3, 13, 2, + 14, 1, 15 + ]); + + /* used by tinf_decode_trees, avoids allocations every call */ + var code_tree = new Tree(); + var lengths = new Uint8Array(288 + 32); + + /* ----------------------- * + * -- utility functions -- * + * ----------------------- */ + + /* build extra bits and base tables */ + function tinf_build_bits_base(bits, base, delta, first) { + var i, sum; + + /* build bits table */ + for (i = 0; i < delta; ++i) { bits[i] = 0; } + for (i = 0; i < 30 - delta; ++i) { bits[i + delta] = i / delta | 0; } + + /* build base table */ + for (sum = first, i = 0; i < 30; ++i) { + base[i] = sum; + sum += 1 << bits[i]; + } + } + + /* build the fixed huffman trees */ + function tinf_build_fixed_trees(lt, dt) { + var i; + + /* build fixed length tree */ + for (i = 0; i < 7; ++i) { lt.table[i] = 0; } + + lt.table[7] = 24; + lt.table[8] = 152; + lt.table[9] = 112; + + for (i = 0; i < 24; ++i) { lt.trans[i] = 256 + i; } + for (i = 0; i < 144; ++i) { lt.trans[24 + i] = i; } + for (i = 0; i < 8; ++i) { lt.trans[24 + 144 + i] = 280 + i; } + for (i = 0; i < 112; ++i) { lt.trans[24 + 144 + 8 + i] = 144 + i; } + + /* build fixed distance tree */ + for (i = 0; i < 5; ++i) { dt.table[i] = 0; } + + dt.table[5] = 32; + + for (i = 0; i < 32; ++i) { dt.trans[i] = i; } + } + + /* given an array of code lengths, build a tree */ + var offs = new Uint16Array(16); + + function tinf_build_tree(t, lengths, off, num) { + var i, sum; + + /* clear code length count table */ + for (i = 0; i < 16; ++i) { t.table[i] = 0; } + + /* scan symbol lengths, and sum code length counts */ + for (i = 0; i < num; ++i) { t.table[lengths[off + i]]++; } + + t.table[0] = 0; + + /* compute offset table for distribution sort */ + for (sum = 0, i = 0; i < 16; ++i) { + offs[i] = sum; + sum += t.table[i]; + } + + /* create code->symbol translation table (symbols sorted by code) */ + for (i = 0; i < num; ++i) { + if (lengths[off + i]) { t.trans[offs[lengths[off + i]]++] = i; } + } + } + + /* ---------------------- * + * -- decode functions -- * + * ---------------------- */ + + /* get one bit from source stream */ + function tinf_getbit(d) { + /* check if tag is empty */ + if (!d.bitcount--) { + /* load next tag */ + d.tag = d.source[d.sourceIndex++]; + d.bitcount = 7; + } + + /* shift bit out of tag */ + var bit = d.tag & 1; + d.tag >>>= 1; + + return bit; + } + + /* read a num bit value from a stream and add base */ + function tinf_read_bits(d, num, base) { + if (!num) + { return base; } + + while (d.bitcount < 24) { + d.tag |= d.source[d.sourceIndex++] << d.bitcount; + d.bitcount += 8; + } + + var val = d.tag & (0xffff >>> (16 - num)); + d.tag >>>= num; + d.bitcount -= num; + return val + base; + } + + /* given a data stream and a tree, decode a symbol */ + function tinf_decode_symbol(d, t) { + while (d.bitcount < 24) { + d.tag |= d.source[d.sourceIndex++] << d.bitcount; + d.bitcount += 8; + } + + var sum = 0, cur = 0, len = 0; + var tag = d.tag; + + /* get more bits while code value is above sum */ + do { + cur = 2 * cur + (tag & 1); + tag >>>= 1; + ++len; + + sum += t.table[len]; + cur -= t.table[len]; + } while (cur >= 0); + + d.tag = tag; + d.bitcount -= len; + + return t.trans[sum + cur]; + } + + /* given a data stream, decode dynamic trees from it */ + function tinf_decode_trees(d, lt, dt) { + var hlit, hdist, hclen; + var i, num, length; + + /* get 5 bits HLIT (257-286) */ + hlit = tinf_read_bits(d, 5, 257); + + /* get 5 bits HDIST (1-32) */ + hdist = tinf_read_bits(d, 5, 1); + + /* get 4 bits HCLEN (4-19) */ + hclen = tinf_read_bits(d, 4, 4); + + for (i = 0; i < 19; ++i) { lengths[i] = 0; } + + /* read code lengths for code length alphabet */ + for (i = 0; i < hclen; ++i) { + /* get 3 bits code length (0-7) */ + var clen = tinf_read_bits(d, 3, 0); + lengths[clcidx[i]] = clen; + } + + /* build code length tree */ + tinf_build_tree(code_tree, lengths, 0, 19); + + /* decode code lengths for the dynamic trees */ + for (num = 0; num < hlit + hdist;) { + var sym = tinf_decode_symbol(d, code_tree); + + switch (sym) { + case 16: + /* copy previous code length 3-6 times (read 2 bits) */ + var prev = lengths[num - 1]; + for (length = tinf_read_bits(d, 2, 3); length; --length) { + lengths[num++] = prev; + } + break; + case 17: + /* repeat code length 0 for 3-10 times (read 3 bits) */ + for (length = tinf_read_bits(d, 3, 3); length; --length) { + lengths[num++] = 0; + } + break; + case 18: + /* repeat code length 0 for 11-138 times (read 7 bits) */ + for (length = tinf_read_bits(d, 7, 11); length; --length) { + lengths[num++] = 0; + } + break; + default: + /* values 0-15 represent the actual code lengths */ + lengths[num++] = sym; + break; + } + } + + /* build dynamic trees */ + tinf_build_tree(lt, lengths, 0, hlit); + tinf_build_tree(dt, lengths, hlit, hdist); + } + + /* ----------------------------- * + * -- block inflate functions -- * + * ----------------------------- */ + + /* given a stream and two trees, inflate a block of data */ + function tinf_inflate_block_data(d, lt, dt) { + while (1) { + var sym = tinf_decode_symbol(d, lt); + + /* check for end of block */ + if (sym === 256) { + return TINF_OK; + } + + if (sym < 256) { + d.dest[d.destLen++] = sym; + } else { + var length, dist, offs; + var i; + + sym -= 257; + + /* possibly get more bits from length code */ + length = tinf_read_bits(d, length_bits[sym], length_base[sym]); + + dist = tinf_decode_symbol(d, dt); + + /* possibly get more bits from distance code */ + offs = d.destLen - tinf_read_bits(d, dist_bits[dist], dist_base[dist]); + + /* copy match */ + for (i = offs; i < offs + length; ++i) { + d.dest[d.destLen++] = d.dest[i]; + } + } + } + } + + /* inflate an uncompressed block of data */ + function tinf_inflate_uncompressed_block(d) { + var length, invlength; + var i; + + /* unread from bitbuffer */ + while (d.bitcount > 8) { + d.sourceIndex--; + d.bitcount -= 8; + } + + /* get length */ + length = d.source[d.sourceIndex + 1]; + length = 256 * length + d.source[d.sourceIndex]; + + /* get one's complement of length */ + invlength = d.source[d.sourceIndex + 3]; + invlength = 256 * invlength + d.source[d.sourceIndex + 2]; + + /* check length */ + if (length !== (~invlength & 0x0000ffff)) + { return TINF_DATA_ERROR; } + + d.sourceIndex += 4; + + /* copy block */ + for (i = length; i; --i) + { d.dest[d.destLen++] = d.source[d.sourceIndex++]; } + + /* make sure we start next block on a byte boundary */ + d.bitcount = 0; + + return TINF_OK; + } + + /* inflate stream from source to dest */ + function tinf_uncompress(source, dest) { + var d = new Data(source, dest); + var bfinal, btype, res; + + do { + /* read final block flag */ + bfinal = tinf_getbit(d); + + /* read block type (2 bits) */ + btype = tinf_read_bits(d, 2, 0); + + /* decompress block */ + switch (btype) { + case 0: + /* decompress uncompressed block */ + res = tinf_inflate_uncompressed_block(d); + break; + case 1: + /* decompress block with fixed huffman trees */ + res = tinf_inflate_block_data(d, sltree, sdtree); + break; + case 2: + /* decompress block with dynamic huffman trees */ + tinf_decode_trees(d, d.ltree, d.dtree); + res = tinf_inflate_block_data(d, d.ltree, d.dtree); + break; + default: + res = TINF_DATA_ERROR; + } + + if (res !== TINF_OK) + { throw new Error('Data error'); } + + } while (!bfinal); + + if (d.destLen < d.dest.length) { + if (typeof d.dest.slice === 'function') + { return d.dest.slice(0, d.destLen); } + else + { return d.dest.subarray(0, d.destLen); } + } + + return d.dest; + } + + /* -------------------- * + * -- initialization -- * + * -------------------- */ + + /* build fixed huffman trees */ + tinf_build_fixed_trees(sltree, sdtree); + + /* build extra bits and base tables */ + tinf_build_bits_base(length_bits, length_base, 4, 3); + tinf_build_bits_base(dist_bits, dist_base, 2, 1); + + /* fix a special case */ + length_bits[28] = 0; + length_base[28] = 258; + + var tinyInflate = tinf_uncompress; + + // The Bounding Box object + + function derive(v0, v1, v2, v3, t) { + return Math.pow(1 - t, 3) * v0 + + 3 * Math.pow(1 - t, 2) * t * v1 + + 3 * (1 - t) * Math.pow(t, 2) * v2 + + Math.pow(t, 3) * v3; + } + /** + * A bounding box is an enclosing box that describes the smallest measure within which all the points lie. + * It is used to calculate the bounding box of a glyph or text path. + * + * On initialization, x1/y1/x2/y2 will be NaN. Check if the bounding box is empty using `isEmpty()`. + * + * @exports opentype.BoundingBox + * @class + * @constructor + */ + function BoundingBox() { + this.x1 = Number.NaN; + this.y1 = Number.NaN; + this.x2 = Number.NaN; + this.y2 = Number.NaN; + } + + /** + * Returns true if the bounding box is empty, that is, no points have been added to the box yet. + */ + BoundingBox.prototype.isEmpty = function() { + return isNaN(this.x1) || isNaN(this.y1) || isNaN(this.x2) || isNaN(this.y2); + }; + + /** + * Add the point to the bounding box. + * The x1/y1/x2/y2 coordinates of the bounding box will now encompass the given point. + * @param {number} x - The X coordinate of the point. + * @param {number} y - The Y coordinate of the point. + */ + BoundingBox.prototype.addPoint = function(x, y) { + if (typeof x === 'number') { + if (isNaN(this.x1) || isNaN(this.x2)) { + this.x1 = x; + this.x2 = x; + } + if (x < this.x1) { + this.x1 = x; + } + if (x > this.x2) { + this.x2 = x; + } + } + if (typeof y === 'number') { + if (isNaN(this.y1) || isNaN(this.y2)) { + this.y1 = y; + this.y2 = y; + } + if (y < this.y1) { + this.y1 = y; + } + if (y > this.y2) { + this.y2 = y; + } + } + }; + + /** + * Add a X coordinate to the bounding box. + * This extends the bounding box to include the X coordinate. + * This function is used internally inside of addBezier. + * @param {number} x - The X coordinate of the point. + */ + BoundingBox.prototype.addX = function(x) { + this.addPoint(x, null); + }; + + /** + * Add a Y coordinate to the bounding box. + * This extends the bounding box to include the Y coordinate. + * This function is used internally inside of addBezier. + * @param {number} y - The Y coordinate of the point. + */ + BoundingBox.prototype.addY = function(y) { + this.addPoint(null, y); + }; + + /** + * Add a Bézier curve to the bounding box. + * This extends the bounding box to include the entire Bézier. + * @param {number} x0 - The starting X coordinate. + * @param {number} y0 - The starting Y coordinate. + * @param {number} x1 - The X coordinate of the first control point. + * @param {number} y1 - The Y coordinate of the first control point. + * @param {number} x2 - The X coordinate of the second control point. + * @param {number} y2 - The Y coordinate of the second control point. + * @param {number} x - The ending X coordinate. + * @param {number} y - The ending Y coordinate. + */ + BoundingBox.prototype.addBezier = function(x0, y0, x1, y1, x2, y2, x, y) { + var this$1 = this; + + // This code is based on http://nishiohirokazu.blogspot.com/2009/06/how-to-calculate-bezier-curves-bounding.html + // and https://github.com/icons8/svg-path-bounding-box + + var p0 = [x0, y0]; + var p1 = [x1, y1]; + var p2 = [x2, y2]; + var p3 = [x, y]; + + this.addPoint(x0, y0); + this.addPoint(x, y); + + for (var i = 0; i <= 1; i++) { + var b = 6 * p0[i] - 12 * p1[i] + 6 * p2[i]; + var a = -3 * p0[i] + 9 * p1[i] - 9 * p2[i] + 3 * p3[i]; + var c = 3 * p1[i] - 3 * p0[i]; + + if (a === 0) { + if (b === 0) { continue; } + var t = -c / b; + if (0 < t && t < 1) { + if (i === 0) { this$1.addX(derive(p0[i], p1[i], p2[i], p3[i], t)); } + if (i === 1) { this$1.addY(derive(p0[i], p1[i], p2[i], p3[i], t)); } + } + continue; + } + + var b2ac = Math.pow(b, 2) - 4 * c * a; + if (b2ac < 0) { continue; } + var t1 = (-b + Math.sqrt(b2ac)) / (2 * a); + if (0 < t1 && t1 < 1) { + if (i === 0) { this$1.addX(derive(p0[i], p1[i], p2[i], p3[i], t1)); } + if (i === 1) { this$1.addY(derive(p0[i], p1[i], p2[i], p3[i], t1)); } + } + var t2 = (-b - Math.sqrt(b2ac)) / (2 * a); + if (0 < t2 && t2 < 1) { + if (i === 0) { this$1.addX(derive(p0[i], p1[i], p2[i], p3[i], t2)); } + if (i === 1) { this$1.addY(derive(p0[i], p1[i], p2[i], p3[i], t2)); } + } + } + }; + + /** + * Add a quadratic curve to the bounding box. + * This extends the bounding box to include the entire quadratic curve. + * @param {number} x0 - The starting X coordinate. + * @param {number} y0 - The starting Y coordinate. + * @param {number} x1 - The X coordinate of the control point. + * @param {number} y1 - The Y coordinate of the control point. + * @param {number} x - The ending X coordinate. + * @param {number} y - The ending Y coordinate. + */ + BoundingBox.prototype.addQuad = function(x0, y0, x1, y1, x, y) { + var cp1x = x0 + 2 / 3 * (x1 - x0); + var cp1y = y0 + 2 / 3 * (y1 - y0); + var cp2x = cp1x + 1 / 3 * (x - x0); + var cp2y = cp1y + 1 / 3 * (y - y0); + this.addBezier(x0, y0, cp1x, cp1y, cp2x, cp2y, x, y); + }; + + // Geometric objects + + /** + * A bézier path containing a set of path commands similar to a SVG path. + * Paths can be drawn on a context using `draw`. + * @exports opentype.Path + * @class + * @constructor + */ + function Path() { + this.commands = []; + this.fill = 'black'; + this.stroke = null; + this.strokeWidth = 1; + } + + /** + * @param {number} x + * @param {number} y + */ + Path.prototype.moveTo = function(x, y) { + this.commands.push({ + type: 'M', + x: x, + y: y + }); + }; + + /** + * @param {number} x + * @param {number} y + */ + Path.prototype.lineTo = function(x, y) { + this.commands.push({ + type: 'L', + x: x, + y: y + }); + }; + + /** + * Draws cubic curve + * @function + * curveTo + * @memberof opentype.Path.prototype + * @param {number} x1 - x of control 1 + * @param {number} y1 - y of control 1 + * @param {number} x2 - x of control 2 + * @param {number} y2 - y of control 2 + * @param {number} x - x of path point + * @param {number} y - y of path point + */ + + /** + * Draws cubic curve + * @function + * bezierCurveTo + * @memberof opentype.Path.prototype + * @param {number} x1 - x of control 1 + * @param {number} y1 - y of control 1 + * @param {number} x2 - x of control 2 + * @param {number} y2 - y of control 2 + * @param {number} x - x of path point + * @param {number} y - y of path point + * @see curveTo + */ + Path.prototype.curveTo = Path.prototype.bezierCurveTo = function(x1, y1, x2, y2, x, y) { + this.commands.push({ + type: 'C', + x1: x1, + y1: y1, + x2: x2, + y2: y2, + x: x, + y: y + }); + }; + + /** + * Draws quadratic curve + * @function + * quadraticCurveTo + * @memberof opentype.Path.prototype + * @param {number} x1 - x of control + * @param {number} y1 - y of control + * @param {number} x - x of path point + * @param {number} y - y of path point + */ + + /** + * Draws quadratic curve + * @function + * quadTo + * @memberof opentype.Path.prototype + * @param {number} x1 - x of control + * @param {number} y1 - y of control + * @param {number} x - x of path point + * @param {number} y - y of path point + */ + Path.prototype.quadTo = Path.prototype.quadraticCurveTo = function(x1, y1, x, y) { + this.commands.push({ + type: 'Q', + x1: x1, + y1: y1, + x: x, + y: y + }); + }; + + /** + * Closes the path + * @function closePath + * @memberof opentype.Path.prototype + */ + + /** + * Close the path + * @function close + * @memberof opentype.Path.prototype + */ + Path.prototype.close = Path.prototype.closePath = function() { + this.commands.push({ + type: 'Z' + }); + }; + + /** + * Add the given path or list of commands to the commands of this path. + * @param {Array} pathOrCommands - another opentype.Path, an opentype.BoundingBox, or an array of commands. + */ + Path.prototype.extend = function(pathOrCommands) { + if (pathOrCommands.commands) { + pathOrCommands = pathOrCommands.commands; + } else if (pathOrCommands instanceof BoundingBox) { + var box = pathOrCommands; + this.moveTo(box.x1, box.y1); + this.lineTo(box.x2, box.y1); + this.lineTo(box.x2, box.y2); + this.lineTo(box.x1, box.y2); + this.close(); + return; + } + + Array.prototype.push.apply(this.commands, pathOrCommands); + }; + + /** + * Calculate the bounding box of the path. + * @returns {opentype.BoundingBox} + */ + Path.prototype.getBoundingBox = function() { + var this$1 = this; + + var box = new BoundingBox(); + + var startX = 0; + var startY = 0; + var prevX = 0; + var prevY = 0; + for (var i = 0; i < this.commands.length; i++) { + var cmd = this$1.commands[i]; + switch (cmd.type) { + case 'M': + box.addPoint(cmd.x, cmd.y); + startX = prevX = cmd.x; + startY = prevY = cmd.y; + break; + case 'L': + box.addPoint(cmd.x, cmd.y); + prevX = cmd.x; + prevY = cmd.y; + break; + case 'Q': + box.addQuad(prevX, prevY, cmd.x1, cmd.y1, cmd.x, cmd.y); + prevX = cmd.x; + prevY = cmd.y; + break; + case 'C': + box.addBezier(prevX, prevY, cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y); + prevX = cmd.x; + prevY = cmd.y; + break; + case 'Z': + prevX = startX; + prevY = startY; + break; + default: + throw new Error('Unexpected path command ' + cmd.type); + } + } + if (box.isEmpty()) { + box.addPoint(0, 0); + } + return box; + }; + + /** + * Draw the path to a 2D context. + * @param {CanvasRenderingContext2D} ctx - A 2D drawing context. + */ + Path.prototype.draw = function(ctx) { + var this$1 = this; + + ctx.beginPath(); + for (var i = 0; i < this.commands.length; i += 1) { + var cmd = this$1.commands[i]; + if (cmd.type === 'M') { + ctx.moveTo(cmd.x, cmd.y); + } else if (cmd.type === 'L') { + ctx.lineTo(cmd.x, cmd.y); + } else if (cmd.type === 'C') { + ctx.bezierCurveTo(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y); + } else if (cmd.type === 'Q') { + ctx.quadraticCurveTo(cmd.x1, cmd.y1, cmd.x, cmd.y); + } else if (cmd.type === 'Z') { + ctx.closePath(); + } + } + + if (this.fill) { + ctx.fillStyle = this.fill; + ctx.fill(); + } + + if (this.stroke) { + ctx.strokeStyle = this.stroke; + ctx.lineWidth = this.strokeWidth; + ctx.stroke(); + } + }; + + /** + * Convert the Path to a string of path data instructions + * See http://www.w3.org/TR/SVG/paths.html#PathData + * @param {number} [decimalPlaces=2] - The amount of decimal places for floating-point values + * @return {string} + */ + Path.prototype.toPathData = function(decimalPlaces) { + var this$1 = this; + + decimalPlaces = decimalPlaces !== undefined ? decimalPlaces : 2; + + function floatToString(v) { + if (Math.round(v) === v) { + return '' + Math.round(v); + } else { + return v.toFixed(decimalPlaces); + } + } + + function packValues() { + var arguments$1 = arguments; + + var s = ''; + for (var i = 0; i < arguments.length; i += 1) { + var v = arguments$1[i]; + if (v >= 0 && i > 0) { + s += ' '; + } + + s += floatToString(v); + } + + return s; + } + + var d = ''; + for (var i = 0; i < this.commands.length; i += 1) { + var cmd = this$1.commands[i]; + if (cmd.type === 'M') { + d += 'M' + packValues(cmd.x, cmd.y); + } else if (cmd.type === 'L') { + d += 'L' + packValues(cmd.x, cmd.y); + } else if (cmd.type === 'C') { + d += 'C' + packValues(cmd.x1, cmd.y1, cmd.x2, cmd.y2, cmd.x, cmd.y); + } else if (cmd.type === 'Q') { + d += 'Q' + packValues(cmd.x1, cmd.y1, cmd.x, cmd.y); + } else if (cmd.type === 'Z') { + d += 'Z'; + } + } + + return d; + }; + + /** + * Convert the path to an SVG element, as a string. + * @param {number} [decimalPlaces=2] - The amount of decimal places for floating-point values + * @return {string} + */ + Path.prototype.toSVG = function(decimalPlaces) { + var svg = '= 0 && v <= 255, 'Byte value should be between 0 and 255.'); + return [v]; + }; + /** + * @constant + * @type {number} + */ + sizeOf.BYTE = constant(1); + + /** + * Convert a 8-bit signed integer to a list of 1 byte. + * @param {string} + * @returns {Array} + */ + encode.CHAR = function(v) { + return [v.charCodeAt(0)]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.CHAR = constant(1); + + /** + * Convert an ASCII string to a list of bytes. + * @param {string} + * @returns {Array} + */ + encode.CHARARRAY = function(v) { + var b = []; + for (var i = 0; i < v.length; i += 1) { + b[i] = v.charCodeAt(i); + } + + return b; + }; + + /** + * @param {Array} + * @returns {number} + */ + sizeOf.CHARARRAY = function(v) { + return v.length; + }; + + /** + * Convert a 16-bit unsigned integer to a list of 2 bytes. + * @param {number} + * @returns {Array} + */ + encode.USHORT = function(v) { + return [(v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.USHORT = constant(2); + + /** + * Convert a 16-bit signed integer to a list of 2 bytes. + * @param {number} + * @returns {Array} + */ + encode.SHORT = function(v) { + // Two's complement + if (v >= LIMIT16) { + v = -(2 * LIMIT16 - v); + } + + return [(v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.SHORT = constant(2); + + /** + * Convert a 24-bit unsigned integer to a list of 3 bytes. + * @param {number} + * @returns {Array} + */ + encode.UINT24 = function(v) { + return [(v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.UINT24 = constant(3); + + /** + * Convert a 32-bit unsigned integer to a list of 4 bytes. + * @param {number} + * @returns {Array} + */ + encode.ULONG = function(v) { + return [(v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.ULONG = constant(4); + + /** + * Convert a 32-bit unsigned integer to a list of 4 bytes. + * @param {number} + * @returns {Array} + */ + encode.LONG = function(v) { + // Two's complement + if (v >= LIMIT32) { + v = -(2 * LIMIT32 - v); + } + + return [(v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.LONG = constant(4); + + encode.FIXED = encode.ULONG; + sizeOf.FIXED = sizeOf.ULONG; + + encode.FWORD = encode.SHORT; + sizeOf.FWORD = sizeOf.SHORT; + + encode.UFWORD = encode.USHORT; + sizeOf.UFWORD = sizeOf.USHORT; + + /** + * Convert a 32-bit Apple Mac timestamp integer to a list of 8 bytes, 64-bit timestamp. + * @param {number} + * @returns {Array} + */ + encode.LONGDATETIME = function(v) { + return [0, 0, 0, 0, (v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.LONGDATETIME = constant(8); + + /** + * Convert a 4-char tag to a list of 4 bytes. + * @param {string} + * @returns {Array} + */ + encode.TAG = function(v) { + check.argument(v.length === 4, 'Tag should be exactly 4 ASCII characters.'); + return [v.charCodeAt(0), + v.charCodeAt(1), + v.charCodeAt(2), + v.charCodeAt(3)]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.TAG = constant(4); + + // CFF data types /////////////////////////////////////////////////////////// + + encode.Card8 = encode.BYTE; + sizeOf.Card8 = sizeOf.BYTE; + + encode.Card16 = encode.USHORT; + sizeOf.Card16 = sizeOf.USHORT; + + encode.OffSize = encode.BYTE; + sizeOf.OffSize = sizeOf.BYTE; + + encode.SID = encode.USHORT; + sizeOf.SID = sizeOf.USHORT; + + // Convert a numeric operand or charstring number to a variable-size list of bytes. + /** + * Convert a numeric operand or charstring number to a variable-size list of bytes. + * @param {number} + * @returns {Array} + */ + encode.NUMBER = function(v) { + if (v >= -107 && v <= 107) { + return [v + 139]; + } else if (v >= 108 && v <= 1131) { + v = v - 108; + return [(v >> 8) + 247, v & 0xFF]; + } else if (v >= -1131 && v <= -108) { + v = -v - 108; + return [(v >> 8) + 251, v & 0xFF]; + } else if (v >= -32768 && v <= 32767) { + return encode.NUMBER16(v); + } else { + return encode.NUMBER32(v); + } + }; + + /** + * @param {number} + * @returns {number} + */ + sizeOf.NUMBER = function(v) { + return encode.NUMBER(v).length; + }; + + /** + * Convert a signed number between -32768 and +32767 to a three-byte value. + * This ensures we always use three bytes, but is not the most compact format. + * @param {number} + * @returns {Array} + */ + encode.NUMBER16 = function(v) { + return [28, (v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.NUMBER16 = constant(3); + + /** + * Convert a signed number between -(2^31) and +(2^31-1) to a five-byte value. + * This is useful if you want to be sure you always use four bytes, + * at the expense of wasting a few bytes for smaller numbers. + * @param {number} + * @returns {Array} + */ + encode.NUMBER32 = function(v) { + return [29, (v >> 24) & 0xFF, (v >> 16) & 0xFF, (v >> 8) & 0xFF, v & 0xFF]; + }; + + /** + * @constant + * @type {number} + */ + sizeOf.NUMBER32 = constant(5); + + /** + * @param {number} + * @returns {Array} + */ + encode.REAL = function(v) { + var value = v.toString(); + + // Some numbers use an epsilon to encode the value. (e.g. JavaScript will store 0.0000001 as 1e-7) + // This code converts it back to a number without the epsilon. + var m = /\.(\d*?)(?:9{5,20}|0{5,20})\d{0,2}(?:e(.+)|$)/.exec(value); + if (m) { + var epsilon = parseFloat('1e' + ((m[2] ? +m[2] : 0) + m[1].length)); + value = (Math.round(v * epsilon) / epsilon).toString(); + } + + var nibbles = ''; + for (var i = 0, ii = value.length; i < ii; i += 1) { + var c = value[i]; + if (c === 'e') { + nibbles += value[++i] === '-' ? 'c' : 'b'; + } else if (c === '.') { + nibbles += 'a'; + } else if (c === '-') { + nibbles += 'e'; + } else { + nibbles += c; + } + } + + nibbles += (nibbles.length & 1) ? 'f' : 'ff'; + var out = [30]; + for (var i$1 = 0, ii$1 = nibbles.length; i$1 < ii$1; i$1 += 2) { + out.push(parseInt(nibbles.substr(i$1, 2), 16)); + } + + return out; + }; + + /** + * @param {number} + * @returns {number} + */ + sizeOf.REAL = function(v) { + return encode.REAL(v).length; + }; + + encode.NAME = encode.CHARARRAY; + sizeOf.NAME = sizeOf.CHARARRAY; + + encode.STRING = encode.CHARARRAY; + sizeOf.STRING = sizeOf.CHARARRAY; + + /** + * @param {DataView} data + * @param {number} offset + * @param {number} numBytes + * @returns {string} + */ + decode.UTF8 = function(data, offset, numBytes) { + var codePoints = []; + var numChars = numBytes; + for (var j = 0; j < numChars; j++, offset += 1) { + codePoints[j] = data.getUint8(offset); + } + + return String.fromCharCode.apply(null, codePoints); + }; + + /** + * @param {DataView} data + * @param {number} offset + * @param {number} numBytes + * @returns {string} + */ + decode.UTF16 = function(data, offset, numBytes) { + var codePoints = []; + var numChars = numBytes / 2; + for (var j = 0; j < numChars; j++, offset += 2) { + codePoints[j] = data.getUint16(offset); + } + + return String.fromCharCode.apply(null, codePoints); + }; + + /** + * Convert a JavaScript string to UTF16-BE. + * @param {string} + * @returns {Array} + */ + encode.UTF16 = function(v) { + var b = []; + for (var i = 0; i < v.length; i += 1) { + var codepoint = v.charCodeAt(i); + b[b.length] = (codepoint >> 8) & 0xFF; + b[b.length] = codepoint & 0xFF; + } + + return b; + }; + + /** + * @param {string} + * @returns {number} + */ + sizeOf.UTF16 = function(v) { + return v.length * 2; + }; + + // Data for converting old eight-bit Macintosh encodings to Unicode. + // This representation is optimized for decoding; encoding is slower + // and needs more memory. The assumption is that all opentype.js users + // want to open fonts, but saving a font will be comparatively rare + // so it can be more expensive. Keyed by IANA character set name. + // + // Python script for generating these strings: + // + // s = u''.join([chr(c).decode('mac_greek') for c in range(128, 256)]) + // print(s.encode('utf-8')) + /** + * @private + */ + var eightBitMacEncodings = { + 'x-mac-croatian': // Python: 'mac_croatian' + 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®Š™´¨≠ŽØ∞±≤≥∆µ∂∑∏š∫ªºΩžø' + + '¿¡¬√ƒ≈Ć«Č… ÀÃÕŒœĐ—“”‘’÷◊©⁄€‹›Æ»–·‚„‰ÂćÁčÈÍÎÏÌÓÔđÒÚÛÙıˆ˜¯πË˚¸Êæˇ', + 'x-mac-cyrillic': // Python: 'mac_cyrillic' + 'АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ†°Ґ£§•¶І®©™Ђђ≠Ѓѓ∞±≤≥іµґЈЄєЇїЉљЊњ' + + 'јЅ¬√ƒ≈∆«»… ЋћЌќѕ–—“”‘’÷„ЎўЏџ№Ёёяабвгдежзийклмнопрстуфхцчшщъыьэю', + 'x-mac-gaelic': // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/GAELIC.TXT + 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØḂ±≤≥ḃĊċḊḋḞḟĠġṀæø' + + 'ṁṖṗɼƒſṠ«»… ÀÃÕŒœ–—“”‘’ṡẛÿŸṪ€‹›Ŷŷṫ·Ỳỳ⁊ÂÊÁËÈÍÎÏÌÓÔ♣ÒÚÛÙıÝýŴŵẄẅẀẁẂẃ', + 'x-mac-greek': // Python: 'mac_greek' + 'Ĺ²É³ÖÜ΅àâä΄¨çéèê룙î‰ôö¦€ùûü†ΓΔΘΛΞΠß®©ΣΪ§≠°·Α±≤≥¥ΒΕΖΗΙΚΜΦΫΨΩ' + + 'άΝ¬ΟΡ≈Τ«»… ΥΧΆΈœ–―“”‘’÷ΉΊΌΎέήίόΏύαβψδεφγηιξκλμνοπώρστθωςχυζϊϋΐΰ\u00AD', + 'x-mac-icelandic': // Python: 'mac_iceland' + 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûüÝ°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' + + '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€ÐðÞþý·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ', + 'x-mac-inuit': // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/INUIT.TXT + 'ᐃᐄᐅᐆᐊᐋᐱᐲᐳᐴᐸᐹᑉᑎᑏᑐᑑᑕᑖᑦᑭᑮᑯᑰᑲᑳᒃᒋᒌᒍᒎᒐᒑ°ᒡᒥᒦ•¶ᒧ®©™ᒨᒪᒫᒻᓂᓃᓄᓅᓇᓈᓐᓯᓰᓱᓲᓴᓵᔅᓕᓖᓗ' + + 'ᓘᓚᓛᓪᔨᔩᔪᔫᔭ… ᔮᔾᕕᕖᕗ–—“”‘’ᕘᕙᕚᕝᕆᕇᕈᕉᕋᕌᕐᕿᖀᖁᖂᖃᖄᖅᖏᖐᖑᖒᖓᖔᖕᙱᙲᙳᙴᙵᙶᖖᖠᖡᖢᖣᖤᖥᖦᕼŁł', + 'x-mac-ce': // Python: 'mac_latin2' + 'ÄĀāÉĄÖÜáąČäčĆć鏟ĎíďĒēĖóėôöõúĚěü†°Ę£§•¶ß®©™ę¨≠ģĮįĪ≤≥īĶ∂∑łĻļĽľĹĺŅ' + + 'ņѬ√ńŇ∆«»… ňŐÕőŌ–—“”‘’÷◊ōŔŕŘ‹›řŖŗŠ‚„šŚśÁŤťÍŽžŪÓÔūŮÚůŰűŲųÝýķŻŁżĢˇ', + macintosh: // Python: 'mac_roman' + 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' + + '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›fifl‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ', + 'x-mac-romanian': // Python: 'mac_romanian' + 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ĂȘ∞±≤≥¥µ∂∑∏π∫ªºΩăș' + + '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸ⁄€‹›Țț‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙıˆ˜¯˘˙˚¸˝˛ˇ', + 'x-mac-turkish': // Python: 'mac_turkish' + 'ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø' + + '¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ' + }; + + /** + * Decodes an old-style Macintosh string. Returns either a Unicode JavaScript + * string, or 'undefined' if the encoding is unsupported. For example, we do + * not support Chinese, Japanese or Korean because these would need large + * mapping tables. + * @param {DataView} dataView + * @param {number} offset + * @param {number} dataLength + * @param {string} encoding + * @returns {string} + */ + decode.MACSTRING = function(dataView, offset, dataLength, encoding) { + var table = eightBitMacEncodings[encoding]; + if (table === undefined) { + return undefined; + } + + var result = ''; + for (var i = 0; i < dataLength; i++) { + var c = dataView.getUint8(offset + i); + // In all eight-bit Mac encodings, the characters 0x00..0x7F are + // mapped to U+0000..U+007F; we only need to look up the others. + if (c <= 0x7F) { + result += String.fromCharCode(c); + } else { + result += table[c & 0x7F]; + } + } + + return result; + }; + + // Helper function for encode.MACSTRING. Returns a dictionary for mapping + // Unicode character codes to their 8-bit MacOS equivalent. This table + // is not exactly a super cheap data structure, but we do not care because + // encoding Macintosh strings is only rarely needed in typical applications. + var macEncodingTableCache = typeof WeakMap === 'function' && new WeakMap(); + var macEncodingCacheKeys; + var getMacEncodingTable = function (encoding) { + // Since we use encoding as a cache key for WeakMap, it has to be + // a String object and not a literal. And at least on NodeJS 2.10.1, + // WeakMap requires that the same String instance is passed for cache hits. + if (!macEncodingCacheKeys) { + macEncodingCacheKeys = {}; + for (var e in eightBitMacEncodings) { + /*jshint -W053 */ // Suppress "Do not use String as a constructor." + macEncodingCacheKeys[e] = new String(e); + } + } + + var cacheKey = macEncodingCacheKeys[encoding]; + if (cacheKey === undefined) { + return undefined; + } + + // We can't do "if (cache.has(key)) {return cache.get(key)}" here: + // since garbage collection may run at any time, it could also kick in + // between the calls to cache.has() and cache.get(). In that case, + // we would return 'undefined' even though we do support the encoding. + if (macEncodingTableCache) { + var cachedTable = macEncodingTableCache.get(cacheKey); + if (cachedTable !== undefined) { + return cachedTable; + } + } + + var decodingTable = eightBitMacEncodings[encoding]; + if (decodingTable === undefined) { + return undefined; + } + + var encodingTable = {}; + for (var i = 0; i < decodingTable.length; i++) { + encodingTable[decodingTable.charCodeAt(i)] = i + 0x80; + } + + if (macEncodingTableCache) { + macEncodingTableCache.set(cacheKey, encodingTable); + } + + return encodingTable; + }; + + /** + * Encodes an old-style Macintosh string. Returns a byte array upon success. + * If the requested encoding is unsupported, or if the input string contains + * a character that cannot be expressed in the encoding, the function returns + * 'undefined'. + * @param {string} str + * @param {string} encoding + * @returns {Array} + */ + encode.MACSTRING = function(str, encoding) { + var table = getMacEncodingTable(encoding); + if (table === undefined) { + return undefined; + } + + var result = []; + for (var i = 0; i < str.length; i++) { + var c = str.charCodeAt(i); + + // In all eight-bit Mac encodings, the characters 0x00..0x7F are + // mapped to U+0000..U+007F; we only need to look up the others. + if (c >= 0x80) { + c = table[c]; + if (c === undefined) { + // str contains a Unicode character that cannot be encoded + // in the requested encoding. + return undefined; + } + } + result[i] = c; + // result.push(c); + } + + return result; + }; + + /** + * @param {string} str + * @param {string} encoding + * @returns {number} + */ + sizeOf.MACSTRING = function(str, encoding) { + var b = encode.MACSTRING(str, encoding); + if (b !== undefined) { + return b.length; + } else { + return 0; + } + }; + + // Helper for encode.VARDELTAS + function isByteEncodable(value) { + return value >= -128 && value <= 127; + } + + // Helper for encode.VARDELTAS + function encodeVarDeltaRunAsZeroes(deltas, pos, result) { + var runLength = 0; + var numDeltas = deltas.length; + while (pos < numDeltas && runLength < 64 && deltas[pos] === 0) { + ++pos; + ++runLength; + } + result.push(0x80 | (runLength - 1)); + return pos; + } + + // Helper for encode.VARDELTAS + function encodeVarDeltaRunAsBytes(deltas, offset, result) { + var runLength = 0; + var numDeltas = deltas.length; + var pos = offset; + while (pos < numDeltas && runLength < 64) { + var value = deltas[pos]; + if (!isByteEncodable(value)) { + break; + } + + // Within a byte-encoded run of deltas, a single zero is best + // stored literally as 0x00 value. However, if we have two or + // more zeroes in a sequence, it is better to start a new run. + // Fore example, the sequence of deltas [15, 15, 0, 15, 15] + // becomes 6 bytes (04 0F 0F 00 0F 0F) when storing the zero + // within the current run, but 7 bytes (01 0F 0F 80 01 0F 0F) + // when starting a new run. + if (value === 0 && pos + 1 < numDeltas && deltas[pos + 1] === 0) { + break; + } + + ++pos; + ++runLength; + } + result.push(runLength - 1); + for (var i = offset; i < pos; ++i) { + result.push((deltas[i] + 256) & 0xff); + } + return pos; + } + + // Helper for encode.VARDELTAS + function encodeVarDeltaRunAsWords(deltas, offset, result) { + var runLength = 0; + var numDeltas = deltas.length; + var pos = offset; + while (pos < numDeltas && runLength < 64) { + var value = deltas[pos]; + + // Within a word-encoded run of deltas, it is easiest to start + // a new run (with a different encoding) whenever we encounter + // a zero value. For example, the sequence [0x6666, 0, 0x7777] + // needs 7 bytes when storing the zero inside the current run + // (42 66 66 00 00 77 77), and equally 7 bytes when starting a + // new run (40 66 66 80 40 77 77). + if (value === 0) { + break; + } + + // Within a word-encoded run of deltas, a single value in the + // range (-128..127) should be encoded within the current run + // because it is more compact. For example, the sequence + // [0x6666, 2, 0x7777] becomes 7 bytes when storing the value + // literally (42 66 66 00 02 77 77), but 8 bytes when starting + // a new run (40 66 66 00 02 40 77 77). + if (isByteEncodable(value) && pos + 1 < numDeltas && isByteEncodable(deltas[pos + 1])) { + break; + } + + ++pos; + ++runLength; + } + result.push(0x40 | (runLength - 1)); + for (var i = offset; i < pos; ++i) { + var val = deltas[i]; + result.push(((val + 0x10000) >> 8) & 0xff, (val + 0x100) & 0xff); + } + return pos; + } + + /** + * Encode a list of variation adjustment deltas. + * + * Variation adjustment deltas are used in ‘gvar’ and ‘cvar’ tables. + * They indicate how points (in ‘gvar’) or values (in ‘cvar’) get adjusted + * when generating instances of variation fonts. + * + * @see https://www.microsoft.com/typography/otspec/gvar.htm + * @see https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6gvar.html + * @param {Array} + * @return {Array} + */ + encode.VARDELTAS = function(deltas) { + var pos = 0; + var result = []; + while (pos < deltas.length) { + var value = deltas[pos]; + if (value === 0) { + pos = encodeVarDeltaRunAsZeroes(deltas, pos, result); + } else if (value >= -128 && value <= 127) { + pos = encodeVarDeltaRunAsBytes(deltas, pos, result); + } else { + pos = encodeVarDeltaRunAsWords(deltas, pos, result); + } + } + return result; + }; + + // Convert a list of values to a CFF INDEX structure. + // The values should be objects containing name / type / value. + /** + * @param {Array} l + * @returns {Array} + */ + encode.INDEX = function(l) { + //var offset, offsets, offsetEncoder, encodedOffsets, encodedOffset, data, + // i, v; + // Because we have to know which data type to use to encode the offsets, + // we have to go through the values twice: once to encode the data and + // calculate the offsets, then again to encode the offsets using the fitting data type. + var offset = 1; // First offset is always 1. + var offsets = [offset]; + var data = []; + for (var i = 0; i < l.length; i += 1) { + var v = encode.OBJECT(l[i]); + Array.prototype.push.apply(data, v); + offset += v.length; + offsets.push(offset); + } + + if (data.length === 0) { + return [0, 0]; + } + + var encodedOffsets = []; + var offSize = (1 + Math.floor(Math.log(offset) / Math.log(2)) / 8) | 0; + var offsetEncoder = [undefined, encode.BYTE, encode.USHORT, encode.UINT24, encode.ULONG][offSize]; + for (var i$1 = 0; i$1 < offsets.length; i$1 += 1) { + var encodedOffset = offsetEncoder(offsets[i$1]); + Array.prototype.push.apply(encodedOffsets, encodedOffset); + } + + return Array.prototype.concat(encode.Card16(l.length), + encode.OffSize(offSize), + encodedOffsets, + data); + }; + + /** + * @param {Array} + * @returns {number} + */ + sizeOf.INDEX = function(v) { + return encode.INDEX(v).length; + }; + + /** + * Convert an object to a CFF DICT structure. + * The keys should be numeric. + * The values should be objects containing name / type / value. + * @param {Object} m + * @returns {Array} + */ + encode.DICT = function(m) { + var d = []; + var keys = Object.keys(m); + var length = keys.length; + + for (var i = 0; i < length; i += 1) { + // Object.keys() return string keys, but our keys are always numeric. + var k = parseInt(keys[i], 0); + var v = m[k]; + // Value comes before the key. + d = d.concat(encode.OPERAND(v.value, v.type)); + d = d.concat(encode.OPERATOR(k)); + } + + return d; + }; + + /** + * @param {Object} + * @returns {number} + */ + sizeOf.DICT = function(m) { + return encode.DICT(m).length; + }; + + /** + * @param {number} + * @returns {Array} + */ + encode.OPERATOR = function(v) { + if (v < 1200) { + return [v]; + } else { + return [12, v - 1200]; + } + }; + + /** + * @param {Array} v + * @param {string} + * @returns {Array} + */ + encode.OPERAND = function(v, type) { + var d = []; + if (Array.isArray(type)) { + for (var i = 0; i < type.length; i += 1) { + check.argument(v.length === type.length, 'Not enough arguments given for type' + type); + d = d.concat(encode.OPERAND(v[i], type[i])); + } + } else { + if (type === 'SID') { + d = d.concat(encode.NUMBER(v)); + } else if (type === 'offset') { + // We make it easy for ourselves and always encode offsets as + // 4 bytes. This makes offset calculation for the top dict easier. + d = d.concat(encode.NUMBER32(v)); + } else if (type === 'number') { + d = d.concat(encode.NUMBER(v)); + } else if (type === 'real') { + d = d.concat(encode.REAL(v)); + } else { + throw new Error('Unknown operand type ' + type); + // FIXME Add support for booleans + } + } + + return d; + }; + + encode.OP = encode.BYTE; + sizeOf.OP = sizeOf.BYTE; + + // memoize charstring encoding using WeakMap if available + var wmm = typeof WeakMap === 'function' && new WeakMap(); + + /** + * Convert a list of CharString operations to bytes. + * @param {Array} + * @returns {Array} + */ + encode.CHARSTRING = function(ops) { + // See encode.MACSTRING for why we don't do "if (wmm && wmm.has(ops))". + if (wmm) { + var cachedValue = wmm.get(ops); + if (cachedValue !== undefined) { + return cachedValue; + } + } + + var d = []; + var length = ops.length; + + for (var i = 0; i < length; i += 1) { + var op = ops[i]; + d = d.concat(encode[op.type](op.value)); + } + + if (wmm) { + wmm.set(ops, d); + } + + return d; + }; + + /** + * @param {Array} + * @returns {number} + */ + sizeOf.CHARSTRING = function(ops) { + return encode.CHARSTRING(ops).length; + }; + + // Utility functions //////////////////////////////////////////////////////// + + /** + * Convert an object containing name / type / value to bytes. + * @param {Object} + * @returns {Array} + */ + encode.OBJECT = function(v) { + var encodingFunction = encode[v.type]; + check.argument(encodingFunction !== undefined, 'No encoding function for type ' + v.type); + return encodingFunction(v.value); + }; + + /** + * @param {Object} + * @returns {number} + */ + sizeOf.OBJECT = function(v) { + var sizeOfFunction = sizeOf[v.type]; + check.argument(sizeOfFunction !== undefined, 'No sizeOf function for type ' + v.type); + return sizeOfFunction(v.value); + }; + + /** + * Convert a table object to bytes. + * A table contains a list of fields containing the metadata (name, type and default value). + * The table itself has the field values set as attributes. + * @param {opentype.Table} + * @returns {Array} + */ + encode.TABLE = function(table) { + var d = []; + var length = table.fields.length; + var subtables = []; + var subtableOffsets = []; + + for (var i = 0; i < length; i += 1) { + var field = table.fields[i]; + var encodingFunction = encode[field.type]; + check.argument(encodingFunction !== undefined, 'No encoding function for field type ' + field.type + ' (' + field.name + ')'); + var value = table[field.name]; + if (value === undefined) { + value = field.value; + } + + var bytes = encodingFunction(value); + + if (field.type === 'TABLE') { + subtableOffsets.push(d.length); + d = d.concat([0, 0]); + subtables.push(bytes); + } else { + d = d.concat(bytes); + } + } + + for (var i$1 = 0; i$1 < subtables.length; i$1 += 1) { + var o = subtableOffsets[i$1]; + var offset = d.length; + check.argument(offset < 65536, 'Table ' + table.tableName + ' too big.'); + d[o] = offset >> 8; + d[o + 1] = offset & 0xff; + d = d.concat(subtables[i$1]); + } + + return d; + }; + + /** + * @param {opentype.Table} + * @returns {number} + */ + sizeOf.TABLE = function(table) { + var numBytes = 0; + var length = table.fields.length; + + for (var i = 0; i < length; i += 1) { + var field = table.fields[i]; + var sizeOfFunction = sizeOf[field.type]; + check.argument(sizeOfFunction !== undefined, 'No sizeOf function for field type ' + field.type + ' (' + field.name + ')'); + var value = table[field.name]; + if (value === undefined) { + value = field.value; + } + + numBytes += sizeOfFunction(value); + + // Subtables take 2 more bytes for offsets. + if (field.type === 'TABLE') { + numBytes += 2; + } + } + + return numBytes; + }; + + encode.RECORD = encode.TABLE; + sizeOf.RECORD = sizeOf.TABLE; + + // Merge in a list of bytes. + encode.LITERAL = function(v) { + return v; + }; + + sizeOf.LITERAL = function(v) { + return v.length; + }; + + // Table metadata + + /** + * @exports opentype.Table + * @class + * @param {string} tableName + * @param {Array} fields + * @param {Object} options + * @constructor + */ + function Table(tableName, fields, options) { + var this$1 = this; + + for (var i = 0; i < fields.length; i += 1) { + var field = fields[i]; + this$1[field.name] = field.value; + } + + this.tableName = tableName; + this.fields = fields; + if (options) { + var optionKeys = Object.keys(options); + for (var i$1 = 0; i$1 < optionKeys.length; i$1 += 1) { + var k = optionKeys[i$1]; + var v = options[k]; + if (this$1[k] !== undefined) { + this$1[k] = v; + } + } + } + } + + /** + * Encodes the table and returns an array of bytes + * @return {Array} + */ + Table.prototype.encode = function() { + return encode.TABLE(this); + }; + + /** + * Get the size of the table. + * @return {number} + */ + Table.prototype.sizeOf = function() { + return sizeOf.TABLE(this); + }; + + /** + * @private + */ + function ushortList(itemName, list, count) { + if (count === undefined) { + count = list.length; + } + var fields = new Array(list.length + 1); + fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count}; + for (var i = 0; i < list.length; i++) { + fields[i + 1] = {name: itemName + i, type: 'USHORT', value: list[i]}; + } + return fields; + } + + /** + * @private + */ + function tableList(itemName, records, itemCallback) { + var count = records.length; + var fields = new Array(count + 1); + fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count}; + for (var i = 0; i < count; i++) { + fields[i + 1] = {name: itemName + i, type: 'TABLE', value: itemCallback(records[i], i)}; + } + return fields; + } + + /** + * @private + */ + function recordList(itemName, records, itemCallback) { + var count = records.length; + var fields = []; + fields[0] = {name: itemName + 'Count', type: 'USHORT', value: count}; + for (var i = 0; i < count; i++) { + fields = fields.concat(itemCallback(records[i], i)); + } + return fields; + } + + // Common Layout Tables + + /** + * @exports opentype.Coverage + * @class + * @param {opentype.Table} + * @constructor + * @extends opentype.Table + */ + function Coverage(coverageTable) { + if (coverageTable.format === 1) { + Table.call(this, 'coverageTable', + [{name: 'coverageFormat', type: 'USHORT', value: 1}] + .concat(ushortList('glyph', coverageTable.glyphs)) + ); + } else { + check.assert(false, 'Can\'t create coverage table format 2 yet.'); + } + } + Coverage.prototype = Object.create(Table.prototype); + Coverage.prototype.constructor = Coverage; + + function ScriptList(scriptListTable) { + Table.call(this, 'scriptListTable', + recordList('scriptRecord', scriptListTable, function(scriptRecord, i) { + var script = scriptRecord.script; + var defaultLangSys = script.defaultLangSys; + check.assert(!!defaultLangSys, 'Unable to write GSUB: script ' + scriptRecord.tag + ' has no default language system.'); + return [ + {name: 'scriptTag' + i, type: 'TAG', value: scriptRecord.tag}, + {name: 'script' + i, type: 'TABLE', value: new Table('scriptTable', [ + {name: 'defaultLangSys', type: 'TABLE', value: new Table('defaultLangSys', [ + {name: 'lookupOrder', type: 'USHORT', value: 0}, + {name: 'reqFeatureIndex', type: 'USHORT', value: defaultLangSys.reqFeatureIndex}] + .concat(ushortList('featureIndex', defaultLangSys.featureIndexes)))} + ].concat(recordList('langSys', script.langSysRecords, function(langSysRecord, i) { + var langSys = langSysRecord.langSys; + return [ + {name: 'langSysTag' + i, type: 'TAG', value: langSysRecord.tag}, + {name: 'langSys' + i, type: 'TABLE', value: new Table('langSys', [ + {name: 'lookupOrder', type: 'USHORT', value: 0}, + {name: 'reqFeatureIndex', type: 'USHORT', value: langSys.reqFeatureIndex} + ].concat(ushortList('featureIndex', langSys.featureIndexes)))} + ]; + })))} + ]; + }) + ); + } + ScriptList.prototype = Object.create(Table.prototype); + ScriptList.prototype.constructor = ScriptList; + + /** + * @exports opentype.FeatureList + * @class + * @param {opentype.Table} + * @constructor + * @extends opentype.Table + */ + function FeatureList(featureListTable) { + Table.call(this, 'featureListTable', + recordList('featureRecord', featureListTable, function(featureRecord, i) { + var feature = featureRecord.feature; + return [ + {name: 'featureTag' + i, type: 'TAG', value: featureRecord.tag}, + {name: 'feature' + i, type: 'TABLE', value: new Table('featureTable', [ + {name: 'featureParams', type: 'USHORT', value: feature.featureParams} ].concat(ushortList('lookupListIndex', feature.lookupListIndexes)))} + ]; + }) + ); + } + FeatureList.prototype = Object.create(Table.prototype); + FeatureList.prototype.constructor = FeatureList; + + /** + * @exports opentype.LookupList + * @class + * @param {opentype.Table} + * @param {Object} + * @constructor + * @extends opentype.Table + */ + function LookupList(lookupListTable, subtableMakers) { + Table.call(this, 'lookupListTable', tableList('lookup', lookupListTable, function(lookupTable) { + var subtableCallback = subtableMakers[lookupTable.lookupType]; + check.assert(!!subtableCallback, 'Unable to write GSUB lookup type ' + lookupTable.lookupType + ' tables.'); + return new Table('lookupTable', [ + {name: 'lookupType', type: 'USHORT', value: lookupTable.lookupType}, + {name: 'lookupFlag', type: 'USHORT', value: lookupTable.lookupFlag} + ].concat(tableList('subtable', lookupTable.subtables, subtableCallback))); + })); + } + LookupList.prototype = Object.create(Table.prototype); + LookupList.prototype.constructor = LookupList; + + // Record = same as Table, but inlined (a Table has an offset and its data is further in the stream) + // Don't use offsets inside Records (probable bug), only in Tables. + var table = { + Table: Table, + Record: Table, + Coverage: Coverage, + ScriptList: ScriptList, + FeatureList: FeatureList, + LookupList: LookupList, + ushortList: ushortList, + tableList: tableList, + recordList: recordList, + }; + + // Parsing utility functions + + // Retrieve an unsigned byte from the DataView. + function getByte(dataView, offset) { + return dataView.getUint8(offset); + } + + // Retrieve an unsigned 16-bit short from the DataView. + // The value is stored in big endian. + function getUShort(dataView, offset) { + return dataView.getUint16(offset, false); + } + + // Retrieve a signed 16-bit short from the DataView. + // The value is stored in big endian. + function getShort(dataView, offset) { + return dataView.getInt16(offset, false); + } + + // Retrieve an unsigned 32-bit long from the DataView. + // The value is stored in big endian. + function getULong(dataView, offset) { + return dataView.getUint32(offset, false); + } + + // Retrieve a 32-bit signed fixed-point number (16.16) from the DataView. + // The value is stored in big endian. + function getFixed(dataView, offset) { + var decimal = dataView.getInt16(offset, false); + var fraction = dataView.getUint16(offset + 2, false); + return decimal + fraction / 65535; + } + + // Retrieve a 4-character tag from the DataView. + // Tags are used to identify tables. + function getTag(dataView, offset) { + var tag = ''; + for (var i = offset; i < offset + 4; i += 1) { + tag += String.fromCharCode(dataView.getInt8(i)); + } + + return tag; + } + + // Retrieve an offset from the DataView. + // Offsets are 1 to 4 bytes in length, depending on the offSize argument. + function getOffset(dataView, offset, offSize) { + var v = 0; + for (var i = 0; i < offSize; i += 1) { + v <<= 8; + v += dataView.getUint8(offset + i); + } + + return v; + } + + // Retrieve a number of bytes from start offset to the end offset from the DataView. + function getBytes(dataView, startOffset, endOffset) { + var bytes = []; + for (var i = startOffset; i < endOffset; i += 1) { + bytes.push(dataView.getUint8(i)); + } + + return bytes; + } + + // Convert the list of bytes to a string. + function bytesToString(bytes) { + var s = ''; + for (var i = 0; i < bytes.length; i += 1) { + s += String.fromCharCode(bytes[i]); + } + + return s; + } + + var typeOffsets = { + byte: 1, + uShort: 2, + short: 2, + uLong: 4, + fixed: 4, + longDateTime: 8, + tag: 4 + }; + + // A stateful parser that changes the offset whenever a value is retrieved. + // The data is a DataView. + function Parser(data, offset) { + this.data = data; + this.offset = offset; + this.relativeOffset = 0; + } + + Parser.prototype.parseByte = function() { + var v = this.data.getUint8(this.offset + this.relativeOffset); + this.relativeOffset += 1; + return v; + }; + + Parser.prototype.parseChar = function() { + var v = this.data.getInt8(this.offset + this.relativeOffset); + this.relativeOffset += 1; + return v; + }; + + Parser.prototype.parseCard8 = Parser.prototype.parseByte; + + Parser.prototype.parseUShort = function() { + var v = this.data.getUint16(this.offset + this.relativeOffset); + this.relativeOffset += 2; + return v; + }; + + Parser.prototype.parseCard16 = Parser.prototype.parseUShort; + Parser.prototype.parseSID = Parser.prototype.parseUShort; + Parser.prototype.parseOffset16 = Parser.prototype.parseUShort; + + Parser.prototype.parseShort = function() { + var v = this.data.getInt16(this.offset + this.relativeOffset); + this.relativeOffset += 2; + return v; + }; + + Parser.prototype.parseF2Dot14 = function() { + var v = this.data.getInt16(this.offset + this.relativeOffset) / 16384; + this.relativeOffset += 2; + return v; + }; + + Parser.prototype.parseULong = function() { + var v = getULong(this.data, this.offset + this.relativeOffset); + this.relativeOffset += 4; + return v; + }; + + Parser.prototype.parseOffset32 = Parser.prototype.parseULong; + + Parser.prototype.parseFixed = function() { + var v = getFixed(this.data, this.offset + this.relativeOffset); + this.relativeOffset += 4; + return v; + }; + + Parser.prototype.parseString = function(length) { + var dataView = this.data; + var offset = this.offset + this.relativeOffset; + var string = ''; + this.relativeOffset += length; + for (var i = 0; i < length; i++) { + string += String.fromCharCode(dataView.getUint8(offset + i)); + } + + return string; + }; + + Parser.prototype.parseTag = function() { + return this.parseString(4); + }; + + // LONGDATETIME is a 64-bit integer. + // JavaScript and unix timestamps traditionally use 32 bits, so we + // only take the last 32 bits. + // + Since until 2038 those bits will be filled by zeros we can ignore them. + Parser.prototype.parseLongDateTime = function() { + var v = getULong(this.data, this.offset + this.relativeOffset + 4); + // Subtract seconds between 01/01/1904 and 01/01/1970 + // to convert Apple Mac timestamp to Standard Unix timestamp + v -= 2082844800; + this.relativeOffset += 8; + return v; + }; + + Parser.prototype.parseVersion = function(minorBase) { + var major = getUShort(this.data, this.offset + this.relativeOffset); + + // How to interpret the minor version is very vague in the spec. 0x5000 is 5, 0x1000 is 1 + // Default returns the correct number if minor = 0xN000 where N is 0-9 + // Set minorBase to 1 for tables that use minor = N where N is 0-9 + var minor = getUShort(this.data, this.offset + this.relativeOffset + 2); + this.relativeOffset += 4; + if (minorBase === undefined) { minorBase = 0x1000; } + return major + minor / minorBase / 10; + }; + + Parser.prototype.skip = function(type, amount) { + if (amount === undefined) { + amount = 1; + } + + this.relativeOffset += typeOffsets[type] * amount; + }; + + ///// Parsing lists and records /////////////////////////////// + + // Parse a list of 32 bit unsigned integers. + Parser.prototype.parseULongList = function(count) { + if (count === undefined) { count = this.parseULong(); } + var offsets = new Array(count); + var dataView = this.data; + var offset = this.offset + this.relativeOffset; + for (var i = 0; i < count; i++) { + offsets[i] = dataView.getUint32(offset); + offset += 4; + } + + this.relativeOffset += count * 4; + return offsets; + }; + + // Parse a list of 16 bit unsigned integers. The length of the list can be read on the stream + // or provided as an argument. + Parser.prototype.parseOffset16List = + Parser.prototype.parseUShortList = function(count) { + if (count === undefined) { count = this.parseUShort(); } + var offsets = new Array(count); + var dataView = this.data; + var offset = this.offset + this.relativeOffset; + for (var i = 0; i < count; i++) { + offsets[i] = dataView.getUint16(offset); + offset += 2; + } + + this.relativeOffset += count * 2; + return offsets; + }; + + // Parses a list of 16 bit signed integers. + Parser.prototype.parseShortList = function(count) { + var list = new Array(count); + var dataView = this.data; + var offset = this.offset + this.relativeOffset; + for (var i = 0; i < count; i++) { + list[i] = dataView.getInt16(offset); + offset += 2; + } + + this.relativeOffset += count * 2; + return list; + }; + + // Parses a list of bytes. + Parser.prototype.parseByteList = function(count) { + var list = new Array(count); + var dataView = this.data; + var offset = this.offset + this.relativeOffset; + for (var i = 0; i < count; i++) { + list[i] = dataView.getUint8(offset++); + } + + this.relativeOffset += count; + return list; + }; + + /** + * Parse a list of items. + * Record count is optional, if omitted it is read from the stream. + * itemCallback is one of the Parser methods. + */ + Parser.prototype.parseList = function(count, itemCallback) { + var this$1 = this; + + if (!itemCallback) { + itemCallback = count; + count = this.parseUShort(); + } + var list = new Array(count); + for (var i = 0; i < count; i++) { + list[i] = itemCallback.call(this$1); + } + return list; + }; + + Parser.prototype.parseList32 = function(count, itemCallback) { + var this$1 = this; + + if (!itemCallback) { + itemCallback = count; + count = this.parseULong(); + } + var list = new Array(count); + for (var i = 0; i < count; i++) { + list[i] = itemCallback.call(this$1); + } + return list; + }; + + /** + * Parse a list of records. + * Record count is optional, if omitted it is read from the stream. + * Example of recordDescription: { sequenceIndex: Parser.uShort, lookupListIndex: Parser.uShort } + */ + Parser.prototype.parseRecordList = function(count, recordDescription) { + var this$1 = this; + + // If the count argument is absent, read it in the stream. + if (!recordDescription) { + recordDescription = count; + count = this.parseUShort(); + } + var records = new Array(count); + var fields = Object.keys(recordDescription); + for (var i = 0; i < count; i++) { + var rec = {}; + for (var j = 0; j < fields.length; j++) { + var fieldName = fields[j]; + var fieldType = recordDescription[fieldName]; + rec[fieldName] = fieldType.call(this$1); + } + records[i] = rec; + } + return records; + }; + + Parser.prototype.parseRecordList32 = function(count, recordDescription) { + var this$1 = this; + + // If the count argument is absent, read it in the stream. + if (!recordDescription) { + recordDescription = count; + count = this.parseULong(); + } + var records = new Array(count); + var fields = Object.keys(recordDescription); + for (var i = 0; i < count; i++) { + var rec = {}; + for (var j = 0; j < fields.length; j++) { + var fieldName = fields[j]; + var fieldType = recordDescription[fieldName]; + rec[fieldName] = fieldType.call(this$1); + } + records[i] = rec; + } + return records; + }; + + // Parse a data structure into an object + // Example of description: { sequenceIndex: Parser.uShort, lookupListIndex: Parser.uShort } + Parser.prototype.parseStruct = function(description) { + var this$1 = this; + + if (typeof description === 'function') { + return description.call(this); + } else { + var fields = Object.keys(description); + var struct = {}; + for (var j = 0; j < fields.length; j++) { + var fieldName = fields[j]; + var fieldType = description[fieldName]; + struct[fieldName] = fieldType.call(this$1); + } + return struct; + } + }; + + /** + * Parse a GPOS valueRecord + * https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#value-record + * valueFormat is optional, if omitted it is read from the stream. + */ + Parser.prototype.parseValueRecord = function(valueFormat) { + if (valueFormat === undefined) { + valueFormat = this.parseUShort(); + } + if (valueFormat === 0) { + // valueFormat2 in kerning pairs is most often 0 + // in this case return undefined instead of an empty object, to save space + return; + } + var valueRecord = {}; + + if (valueFormat & 0x0001) { valueRecord.xPlacement = this.parseShort(); } + if (valueFormat & 0x0002) { valueRecord.yPlacement = this.parseShort(); } + if (valueFormat & 0x0004) { valueRecord.xAdvance = this.parseShort(); } + if (valueFormat & 0x0008) { valueRecord.yAdvance = this.parseShort(); } + + // Device table (non-variable font) / VariationIndex table (variable font) not supported + // https://docs.microsoft.com/fr-fr/typography/opentype/spec/chapter2#devVarIdxTbls + if (valueFormat & 0x0010) { valueRecord.xPlaDevice = undefined; this.parseShort(); } + if (valueFormat & 0x0020) { valueRecord.yPlaDevice = undefined; this.parseShort(); } + if (valueFormat & 0x0040) { valueRecord.xAdvDevice = undefined; this.parseShort(); } + if (valueFormat & 0x0080) { valueRecord.yAdvDevice = undefined; this.parseShort(); } + + return valueRecord; + }; + + /** + * Parse a list of GPOS valueRecords + * https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#value-record + * valueFormat and valueCount are read from the stream. + */ + Parser.prototype.parseValueRecordList = function() { + var this$1 = this; + + var valueFormat = this.parseUShort(); + var valueCount = this.parseUShort(); + var values = new Array(valueCount); + for (var i = 0; i < valueCount; i++) { + values[i] = this$1.parseValueRecord(valueFormat); + } + return values; + }; + + Parser.prototype.parsePointer = function(description) { + var structOffset = this.parseOffset16(); + if (structOffset > 0) { + // NULL offset => return undefined + return new Parser(this.data, this.offset + structOffset).parseStruct(description); + } + return undefined; + }; + + Parser.prototype.parsePointer32 = function(description) { + var structOffset = this.parseOffset32(); + if (structOffset > 0) { + // NULL offset => return undefined + return new Parser(this.data, this.offset + structOffset).parseStruct(description); + } + return undefined; + }; + + /** + * Parse a list of offsets to lists of 16-bit integers, + * or a list of offsets to lists of offsets to any kind of items. + * If itemCallback is not provided, a list of list of UShort is assumed. + * If provided, itemCallback is called on each item and must parse the item. + * See examples in tables/gsub.js + */ + Parser.prototype.parseListOfLists = function(itemCallback) { + var this$1 = this; + + var offsets = this.parseOffset16List(); + var count = offsets.length; + var relativeOffset = this.relativeOffset; + var list = new Array(count); + for (var i = 0; i < count; i++) { + var start = offsets[i]; + if (start === 0) { + // NULL offset + // Add i as owned property to list. Convenient with assert. + list[i] = undefined; + continue; + } + this$1.relativeOffset = start; + if (itemCallback) { + var subOffsets = this$1.parseOffset16List(); + var subList = new Array(subOffsets.length); + for (var j = 0; j < subOffsets.length; j++) { + this$1.relativeOffset = start + subOffsets[j]; + subList[j] = itemCallback.call(this$1); + } + list[i] = subList; + } else { + list[i] = this$1.parseUShortList(); + } + } + this.relativeOffset = relativeOffset; + return list; + }; + + ///// Complex tables parsing ////////////////////////////////// + + // Parse a coverage table in a GSUB, GPOS or GDEF table. + // https://www.microsoft.com/typography/OTSPEC/chapter2.htm + // parser.offset must point to the start of the table containing the coverage. + Parser.prototype.parseCoverage = function() { + var this$1 = this; + + var startOffset = this.offset + this.relativeOffset; + var format = this.parseUShort(); + var count = this.parseUShort(); + if (format === 1) { + return { + format: 1, + glyphs: this.parseUShortList(count) + }; + } else if (format === 2) { + var ranges = new Array(count); + for (var i = 0; i < count; i++) { + ranges[i] = { + start: this$1.parseUShort(), + end: this$1.parseUShort(), + index: this$1.parseUShort() + }; + } + return { + format: 2, + ranges: ranges + }; + } + throw new Error('0x' + startOffset.toString(16) + ': Coverage format must be 1 or 2.'); + }; + + // Parse a Class Definition Table in a GSUB, GPOS or GDEF table. + // https://www.microsoft.com/typography/OTSPEC/chapter2.htm + Parser.prototype.parseClassDef = function() { + var startOffset = this.offset + this.relativeOffset; + var format = this.parseUShort(); + if (format === 1) { + return { + format: 1, + startGlyph: this.parseUShort(), + classes: this.parseUShortList() + }; + } else if (format === 2) { + return { + format: 2, + ranges: this.parseRecordList({ + start: Parser.uShort, + end: Parser.uShort, + classId: Parser.uShort + }) + }; + } + throw new Error('0x' + startOffset.toString(16) + ': ClassDef format must be 1 or 2.'); + }; + + ///// Static methods /////////////////////////////////// + // These convenience methods can be used as callbacks and should be called with "this" context set to a Parser instance. + + Parser.list = function(count, itemCallback) { + return function() { + return this.parseList(count, itemCallback); + }; + }; + + Parser.list32 = function(count, itemCallback) { + return function() { + return this.parseList32(count, itemCallback); + }; + }; + + Parser.recordList = function(count, recordDescription) { + return function() { + return this.parseRecordList(count, recordDescription); + }; + }; + + Parser.recordList32 = function(count, recordDescription) { + return function() { + return this.parseRecordList32(count, recordDescription); + }; + }; + + Parser.pointer = function(description) { + return function() { + return this.parsePointer(description); + }; + }; + + Parser.pointer32 = function(description) { + return function() { + return this.parsePointer32(description); + }; + }; + + Parser.tag = Parser.prototype.parseTag; + Parser.byte = Parser.prototype.parseByte; + Parser.uShort = Parser.offset16 = Parser.prototype.parseUShort; + Parser.uShortList = Parser.prototype.parseUShortList; + Parser.uLong = Parser.offset32 = Parser.prototype.parseULong; + Parser.uLongList = Parser.prototype.parseULongList; + Parser.struct = Parser.prototype.parseStruct; + Parser.coverage = Parser.prototype.parseCoverage; + Parser.classDef = Parser.prototype.parseClassDef; + + ///// Script, Feature, Lookup lists /////////////////////////////////////////////// + // https://www.microsoft.com/typography/OTSPEC/chapter2.htm + + var langSysTable = { + reserved: Parser.uShort, + reqFeatureIndex: Parser.uShort, + featureIndexes: Parser.uShortList + }; + + Parser.prototype.parseScriptList = function() { + return this.parsePointer(Parser.recordList({ + tag: Parser.tag, + script: Parser.pointer({ + defaultLangSys: Parser.pointer(langSysTable), + langSysRecords: Parser.recordList({ + tag: Parser.tag, + langSys: Parser.pointer(langSysTable) + }) + }) + })) || []; + }; + + Parser.prototype.parseFeatureList = function() { + return this.parsePointer(Parser.recordList({ + tag: Parser.tag, + feature: Parser.pointer({ + featureParams: Parser.offset16, + lookupListIndexes: Parser.uShortList + }) + })) || []; + }; + + Parser.prototype.parseLookupList = function(lookupTableParsers) { + return this.parsePointer(Parser.list(Parser.pointer(function() { + var lookupType = this.parseUShort(); + check.argument(1 <= lookupType && lookupType <= 9, 'GPOS/GSUB lookup type ' + lookupType + ' unknown.'); + var lookupFlag = this.parseUShort(); + var useMarkFilteringSet = lookupFlag & 0x10; + return { + lookupType: lookupType, + lookupFlag: lookupFlag, + subtables: this.parseList(Parser.pointer(lookupTableParsers[lookupType])), + markFilteringSet: useMarkFilteringSet ? this.parseUShort() : undefined + }; + }))) || []; + }; + + Parser.prototype.parseFeatureVariationsList = function() { + return this.parsePointer32(function() { + var majorVersion = this.parseUShort(); + var minorVersion = this.parseUShort(); + check.argument(majorVersion === 1 && minorVersion < 1, 'GPOS/GSUB feature variations table unknown.'); + var featureVariations = this.parseRecordList32({ + conditionSetOffset: Parser.offset32, + featureTableSubstitutionOffset: Parser.offset32 + }); + return featureVariations; + }) || []; + }; + + var parse = { + getByte: getByte, + getCard8: getByte, + getUShort: getUShort, + getCard16: getUShort, + getShort: getShort, + getULong: getULong, + getFixed: getFixed, + getTag: getTag, + getOffset: getOffset, + getBytes: getBytes, + bytesToString: bytesToString, + Parser: Parser, + }; + + // The `cmap` table stores the mappings from characters to glyphs. + + function parseCmapTableFormat12(cmap, p) { + //Skip reserved. + p.parseUShort(); + + // Length in bytes of the sub-tables. + cmap.length = p.parseULong(); + cmap.language = p.parseULong(); + + var groupCount; + cmap.groupCount = groupCount = p.parseULong(); + cmap.glyphIndexMap = {}; + + for (var i = 0; i < groupCount; i += 1) { + var startCharCode = p.parseULong(); + var endCharCode = p.parseULong(); + var startGlyphId = p.parseULong(); + + for (var c = startCharCode; c <= endCharCode; c += 1) { + cmap.glyphIndexMap[c] = startGlyphId; + startGlyphId++; + } + } + } + + function parseCmapTableFormat4(cmap, p, data, start, offset) { + // Length in bytes of the sub-tables. + cmap.length = p.parseUShort(); + cmap.language = p.parseUShort(); + + // segCount is stored x 2. + var segCount; + cmap.segCount = segCount = p.parseUShort() >> 1; + + // Skip searchRange, entrySelector, rangeShift. + p.skip('uShort', 3); + + // The "unrolled" mapping from character codes to glyph indices. + cmap.glyphIndexMap = {}; + var endCountParser = new parse.Parser(data, start + offset + 14); + var startCountParser = new parse.Parser(data, start + offset + 16 + segCount * 2); + var idDeltaParser = new parse.Parser(data, start + offset + 16 + segCount * 4); + var idRangeOffsetParser = new parse.Parser(data, start + offset + 16 + segCount * 6); + var glyphIndexOffset = start + offset + 16 + segCount * 8; + for (var i = 0; i < segCount - 1; i += 1) { + var glyphIndex = (void 0); + var endCount = endCountParser.parseUShort(); + var startCount = startCountParser.parseUShort(); + var idDelta = idDeltaParser.parseShort(); + var idRangeOffset = idRangeOffsetParser.parseUShort(); + for (var c = startCount; c <= endCount; c += 1) { + if (idRangeOffset !== 0) { + // The idRangeOffset is relative to the current position in the idRangeOffset array. + // Take the current offset in the idRangeOffset array. + glyphIndexOffset = (idRangeOffsetParser.offset + idRangeOffsetParser.relativeOffset - 2); + + // Add the value of the idRangeOffset, which will move us into the glyphIndex array. + glyphIndexOffset += idRangeOffset; + + // Then add the character index of the current segment, multiplied by 2 for USHORTs. + glyphIndexOffset += (c - startCount) * 2; + glyphIndex = parse.getUShort(data, glyphIndexOffset); + if (glyphIndex !== 0) { + glyphIndex = (glyphIndex + idDelta) & 0xFFFF; + } + } else { + glyphIndex = (c + idDelta) & 0xFFFF; + } + + cmap.glyphIndexMap[c] = glyphIndex; + } + } + } + + // Parse the `cmap` table. This table stores the mappings from characters to glyphs. + // There are many available formats, but we only support the Windows format 4 and 12. + // This function returns a `CmapEncoding` object or null if no supported format could be found. + function parseCmapTable(data, start) { + var cmap = {}; + cmap.version = parse.getUShort(data, start); + check.argument(cmap.version === 0, 'cmap table version should be 0.'); + + // The cmap table can contain many sub-tables, each with their own format. + // We're only interested in a "platform 0" (Unicode format) and "platform 3" (Windows format) table. + cmap.numTables = parse.getUShort(data, start + 2); + var offset = -1; + for (var i = cmap.numTables - 1; i >= 0; i -= 1) { + var platformId = parse.getUShort(data, start + 4 + (i * 8)); + var encodingId = parse.getUShort(data, start + 4 + (i * 8) + 2); + if ((platformId === 3 && (encodingId === 0 || encodingId === 1 || encodingId === 10)) || + (platformId === 0 && (encodingId === 0 || encodingId === 1 || encodingId === 2 || encodingId === 3 || encodingId === 4))) { + offset = parse.getULong(data, start + 4 + (i * 8) + 4); + break; + } + } + + if (offset === -1) { + // There is no cmap table in the font that we support. + throw new Error('No valid cmap sub-tables found.'); + } + + var p = new parse.Parser(data, start + offset); + cmap.format = p.parseUShort(); + + if (cmap.format === 12) { + parseCmapTableFormat12(cmap, p); + } else if (cmap.format === 4) { + parseCmapTableFormat4(cmap, p, data, start, offset); + } else { + throw new Error('Only format 4 and 12 cmap tables are supported (found format ' + cmap.format + ').'); + } + + return cmap; + } + + function addSegment(t, code, glyphIndex) { + t.segments.push({ + end: code, + start: code, + delta: -(code - glyphIndex), + offset: 0, + glyphIndex: glyphIndex + }); + } + + function addTerminatorSegment(t) { + t.segments.push({ + end: 0xFFFF, + start: 0xFFFF, + delta: 1, + offset: 0 + }); + } + + // Make cmap table, format 4 by default, 12 if needed only + function makeCmapTable(glyphs) { + // Plan 0 is the base Unicode Plan but emojis, for example are on another plan, and needs cmap 12 format (with 32bit) + var isPlan0Only = true; + var i; + + // Check if we need to add cmap format 12 or if format 4 only is fine + for (i = glyphs.length - 1; i > 0; i -= 1) { + var g = glyphs.get(i); + if (g.unicode > 65535) { + console.log('Adding CMAP format 12 (needed!)'); + isPlan0Only = false; + break; + } + } + + var cmapTable = [ + {name: 'version', type: 'USHORT', value: 0}, + {name: 'numTables', type: 'USHORT', value: isPlan0Only ? 1 : 2}, + + // CMAP 4 header + {name: 'platformID', type: 'USHORT', value: 3}, + {name: 'encodingID', type: 'USHORT', value: 1}, + {name: 'offset', type: 'ULONG', value: isPlan0Only ? 12 : (12 + 8)} + ]; + + if (!isPlan0Only) + { cmapTable = cmapTable.concat([ + // CMAP 12 header + {name: 'cmap12PlatformID', type: 'USHORT', value: 3}, // We encode only for PlatformID = 3 (Windows) because it is supported everywhere + {name: 'cmap12EncodingID', type: 'USHORT', value: 10}, + {name: 'cmap12Offset', type: 'ULONG', value: 0} + ]); } + + cmapTable = cmapTable.concat([ + // CMAP 4 Subtable + {name: 'format', type: 'USHORT', value: 4}, + {name: 'cmap4Length', type: 'USHORT', value: 0}, + {name: 'language', type: 'USHORT', value: 0}, + {name: 'segCountX2', type: 'USHORT', value: 0}, + {name: 'searchRange', type: 'USHORT', value: 0}, + {name: 'entrySelector', type: 'USHORT', value: 0}, + {name: 'rangeShift', type: 'USHORT', value: 0} + ]); + + var t = new table.Table('cmap', cmapTable); + + t.segments = []; + for (i = 0; i < glyphs.length; i += 1) { + var glyph = glyphs.get(i); + for (var j = 0; j < glyph.unicodes.length; j += 1) { + addSegment(t, glyph.unicodes[j], i); + } + + t.segments = t.segments.sort(function (a, b) { + return a.start - b.start; + }); + } + + addTerminatorSegment(t); + + var segCount = t.segments.length; + var segCountToRemove = 0; + + // CMAP 4 + // Set up parallel segment arrays. + var endCounts = []; + var startCounts = []; + var idDeltas = []; + var idRangeOffsets = []; + var glyphIds = []; + + // CMAP 12 + var cmap12Groups = []; + + // Reminder this loop is not following the specification at 100% + // The specification -> find suites of characters and make a group + // Here we're doing one group for each letter + // Doing as the spec can save 8 times (or more) space + for (i = 0; i < segCount; i += 1) { + var segment = t.segments[i]; + + // CMAP 4 + if (segment.end <= 65535 && segment.start <= 65535) { + endCounts = endCounts.concat({name: 'end_' + i, type: 'USHORT', value: segment.end}); + startCounts = startCounts.concat({name: 'start_' + i, type: 'USHORT', value: segment.start}); + idDeltas = idDeltas.concat({name: 'idDelta_' + i, type: 'SHORT', value: segment.delta}); + idRangeOffsets = idRangeOffsets.concat({name: 'idRangeOffset_' + i, type: 'USHORT', value: segment.offset}); + if (segment.glyphId !== undefined) { + glyphIds = glyphIds.concat({name: 'glyph_' + i, type: 'USHORT', value: segment.glyphId}); + } + } else { + // Skip Unicode > 65535 (16bit unsigned max) for CMAP 4, will be added in CMAP 12 + segCountToRemove += 1; + } + + // CMAP 12 + // Skip Terminator Segment + if (!isPlan0Only && segment.glyphIndex !== undefined) { + cmap12Groups = cmap12Groups.concat({name: 'cmap12Start_' + i, type: 'ULONG', value: segment.start}); + cmap12Groups = cmap12Groups.concat({name: 'cmap12End_' + i, type: 'ULONG', value: segment.end}); + cmap12Groups = cmap12Groups.concat({name: 'cmap12Glyph_' + i, type: 'ULONG', value: segment.glyphIndex}); + } + } + + // CMAP 4 Subtable + t.segCountX2 = (segCount - segCountToRemove) * 2; + t.searchRange = Math.pow(2, Math.floor(Math.log((segCount - segCountToRemove)) / Math.log(2))) * 2; + t.entrySelector = Math.log(t.searchRange / 2) / Math.log(2); + t.rangeShift = t.segCountX2 - t.searchRange; + + t.fields = t.fields.concat(endCounts); + t.fields.push({name: 'reservedPad', type: 'USHORT', value: 0}); + t.fields = t.fields.concat(startCounts); + t.fields = t.fields.concat(idDeltas); + t.fields = t.fields.concat(idRangeOffsets); + t.fields = t.fields.concat(glyphIds); + + t.cmap4Length = 14 + // Subtable header + endCounts.length * 2 + + 2 + // reservedPad + startCounts.length * 2 + + idDeltas.length * 2 + + idRangeOffsets.length * 2 + + glyphIds.length * 2; + + if (!isPlan0Only) { + // CMAP 12 Subtable + var cmap12Length = 16 + // Subtable header + cmap12Groups.length * 4; + + t.cmap12Offset = 12 + (2 * 2) + 4 + t.cmap4Length; + t.fields = t.fields.concat([ + {name: 'cmap12Format', type: 'USHORT', value: 12}, + {name: 'cmap12Reserved', type: 'USHORT', value: 0}, + {name: 'cmap12Length', type: 'ULONG', value: cmap12Length}, + {name: 'cmap12Language', type: 'ULONG', value: 0}, + {name: 'cmap12nGroups', type: 'ULONG', value: cmap12Groups.length / 3} + ]); + + t.fields = t.fields.concat(cmap12Groups); + } + + return t; + } + + var cmap = { parse: parseCmapTable, make: makeCmapTable }; + + // Glyph encoding + + var cffStandardStrings = [ + '.notdef', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent', 'ampersand', 'quoteright', + 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash', 'zero', 'one', 'two', + 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less', 'equal', 'greater', + 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', + 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright', 'asciicircum', 'underscore', + 'quoteleft', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', + 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde', 'exclamdown', 'cent', 'sterling', + 'fraction', 'yen', 'florin', 'section', 'currency', 'quotesingle', 'quotedblleft', 'guillemotleft', + 'guilsinglleft', 'guilsinglright', 'fi', 'fl', 'endash', 'dagger', 'daggerdbl', 'periodcentered', 'paragraph', + 'bullet', 'quotesinglbase', 'quotedblbase', 'quotedblright', 'guillemotright', 'ellipsis', 'perthousand', + 'questiondown', 'grave', 'acute', 'circumflex', 'tilde', 'macron', 'breve', 'dotaccent', 'dieresis', 'ring', + 'cedilla', 'hungarumlaut', 'ogonek', 'caron', 'emdash', 'AE', 'ordfeminine', 'Lslash', 'Oslash', 'OE', + 'ordmasculine', 'ae', 'dotlessi', 'lslash', 'oslash', 'oe', 'germandbls', 'onesuperior', 'logicalnot', 'mu', + 'trademark', 'Eth', 'onehalf', 'plusminus', 'Thorn', 'onequarter', 'divide', 'brokenbar', 'degree', 'thorn', + 'threequarters', 'twosuperior', 'registered', 'minus', 'eth', 'multiply', 'threesuperior', 'copyright', + 'Aacute', 'Acircumflex', 'Adieresis', 'Agrave', 'Aring', 'Atilde', 'Ccedilla', 'Eacute', 'Ecircumflex', + 'Edieresis', 'Egrave', 'Iacute', 'Icircumflex', 'Idieresis', 'Igrave', 'Ntilde', 'Oacute', 'Ocircumflex', + 'Odieresis', 'Ograve', 'Otilde', 'Scaron', 'Uacute', 'Ucircumflex', 'Udieresis', 'Ugrave', 'Yacute', + 'Ydieresis', 'Zcaron', 'aacute', 'acircumflex', 'adieresis', 'agrave', 'aring', 'atilde', 'ccedilla', 'eacute', + 'ecircumflex', 'edieresis', 'egrave', 'iacute', 'icircumflex', 'idieresis', 'igrave', 'ntilde', 'oacute', + 'ocircumflex', 'odieresis', 'ograve', 'otilde', 'scaron', 'uacute', 'ucircumflex', 'udieresis', 'ugrave', + 'yacute', 'ydieresis', 'zcaron', 'exclamsmall', 'Hungarumlautsmall', 'dollaroldstyle', 'dollarsuperior', + 'ampersandsmall', 'Acutesmall', 'parenleftsuperior', 'parenrightsuperior', '266 ff', 'onedotenleader', + 'zerooldstyle', 'oneoldstyle', 'twooldstyle', 'threeoldstyle', 'fouroldstyle', 'fiveoldstyle', 'sixoldstyle', + 'sevenoldstyle', 'eightoldstyle', 'nineoldstyle', 'commasuperior', 'threequartersemdash', 'periodsuperior', + 'questionsmall', 'asuperior', 'bsuperior', 'centsuperior', 'dsuperior', 'esuperior', 'isuperior', 'lsuperior', + 'msuperior', 'nsuperior', 'osuperior', 'rsuperior', 'ssuperior', 'tsuperior', 'ff', 'ffi', 'ffl', + 'parenleftinferior', 'parenrightinferior', 'Circumflexsmall', 'hyphensuperior', 'Gravesmall', 'Asmall', + 'Bsmall', 'Csmall', 'Dsmall', 'Esmall', 'Fsmall', 'Gsmall', 'Hsmall', 'Ismall', 'Jsmall', 'Ksmall', 'Lsmall', + 'Msmall', 'Nsmall', 'Osmall', 'Psmall', 'Qsmall', 'Rsmall', 'Ssmall', 'Tsmall', 'Usmall', 'Vsmall', 'Wsmall', + 'Xsmall', 'Ysmall', 'Zsmall', 'colonmonetary', 'onefitted', 'rupiah', 'Tildesmall', 'exclamdownsmall', + 'centoldstyle', 'Lslashsmall', 'Scaronsmall', 'Zcaronsmall', 'Dieresissmall', 'Brevesmall', 'Caronsmall', + 'Dotaccentsmall', 'Macronsmall', 'figuredash', 'hypheninferior', 'Ogoneksmall', 'Ringsmall', 'Cedillasmall', + 'questiondownsmall', 'oneeighth', 'threeeighths', 'fiveeighths', 'seveneighths', 'onethird', 'twothirds', + 'zerosuperior', 'foursuperior', 'fivesuperior', 'sixsuperior', 'sevensuperior', 'eightsuperior', 'ninesuperior', + 'zeroinferior', 'oneinferior', 'twoinferior', 'threeinferior', 'fourinferior', 'fiveinferior', 'sixinferior', + 'seveninferior', 'eightinferior', 'nineinferior', 'centinferior', 'dollarinferior', 'periodinferior', + 'commainferior', 'Agravesmall', 'Aacutesmall', 'Acircumflexsmall', 'Atildesmall', 'Adieresissmall', + 'Aringsmall', 'AEsmall', 'Ccedillasmall', 'Egravesmall', 'Eacutesmall', 'Ecircumflexsmall', 'Edieresissmall', + 'Igravesmall', 'Iacutesmall', 'Icircumflexsmall', 'Idieresissmall', 'Ethsmall', 'Ntildesmall', 'Ogravesmall', + 'Oacutesmall', 'Ocircumflexsmall', 'Otildesmall', 'Odieresissmall', 'OEsmall', 'Oslashsmall', 'Ugravesmall', + 'Uacutesmall', 'Ucircumflexsmall', 'Udieresissmall', 'Yacutesmall', 'Thornsmall', 'Ydieresissmall', '001.000', + '001.001', '001.002', '001.003', 'Black', 'Bold', 'Book', 'Light', 'Medium', 'Regular', 'Roman', 'Semibold']; + + var cffStandardEncoding = [ + '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', + '', '', '', '', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent', 'ampersand', 'quoteright', + 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash', 'zero', 'one', 'two', + 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less', 'equal', 'greater', + 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', + 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright', 'asciicircum', 'underscore', + 'quoteleft', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', + 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde', '', '', '', '', '', '', '', '', + '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', + 'exclamdown', 'cent', 'sterling', 'fraction', 'yen', 'florin', 'section', 'currency', 'quotesingle', + 'quotedblleft', 'guillemotleft', 'guilsinglleft', 'guilsinglright', 'fi', 'fl', '', 'endash', 'dagger', + 'daggerdbl', 'periodcentered', '', 'paragraph', 'bullet', 'quotesinglbase', 'quotedblbase', 'quotedblright', + 'guillemotright', 'ellipsis', 'perthousand', '', 'questiondown', '', 'grave', 'acute', 'circumflex', 'tilde', + 'macron', 'breve', 'dotaccent', 'dieresis', '', 'ring', 'cedilla', '', 'hungarumlaut', 'ogonek', 'caron', + 'emdash', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', 'AE', '', 'ordfeminine', '', '', '', + '', 'Lslash', 'Oslash', 'OE', 'ordmasculine', '', '', '', '', '', 'ae', '', '', '', 'dotlessi', '', '', + 'lslash', 'oslash', 'oe', 'germandbls']; + + var cffExpertEncoding = [ + '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', + '', '', '', '', 'space', 'exclamsmall', 'Hungarumlautsmall', '', 'dollaroldstyle', 'dollarsuperior', + 'ampersandsmall', 'Acutesmall', 'parenleftsuperior', 'parenrightsuperior', 'twodotenleader', 'onedotenleader', + 'comma', 'hyphen', 'period', 'fraction', 'zerooldstyle', 'oneoldstyle', 'twooldstyle', 'threeoldstyle', + 'fouroldstyle', 'fiveoldstyle', 'sixoldstyle', 'sevenoldstyle', 'eightoldstyle', 'nineoldstyle', 'colon', + 'semicolon', 'commasuperior', 'threequartersemdash', 'periodsuperior', 'questionsmall', '', 'asuperior', + 'bsuperior', 'centsuperior', 'dsuperior', 'esuperior', '', '', 'isuperior', '', '', 'lsuperior', 'msuperior', + 'nsuperior', 'osuperior', '', '', 'rsuperior', 'ssuperior', 'tsuperior', '', 'ff', 'fi', 'fl', 'ffi', 'ffl', + 'parenleftinferior', '', 'parenrightinferior', 'Circumflexsmall', 'hyphensuperior', 'Gravesmall', 'Asmall', + 'Bsmall', 'Csmall', 'Dsmall', 'Esmall', 'Fsmall', 'Gsmall', 'Hsmall', 'Ismall', 'Jsmall', 'Ksmall', 'Lsmall', + 'Msmall', 'Nsmall', 'Osmall', 'Psmall', 'Qsmall', 'Rsmall', 'Ssmall', 'Tsmall', 'Usmall', 'Vsmall', 'Wsmall', + 'Xsmall', 'Ysmall', 'Zsmall', 'colonmonetary', 'onefitted', 'rupiah', 'Tildesmall', '', '', '', '', '', '', '', + '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', '', + 'exclamdownsmall', 'centoldstyle', 'Lslashsmall', '', '', 'Scaronsmall', 'Zcaronsmall', 'Dieresissmall', + 'Brevesmall', 'Caronsmall', '', 'Dotaccentsmall', '', '', 'Macronsmall', '', '', 'figuredash', 'hypheninferior', + '', '', 'Ogoneksmall', 'Ringsmall', 'Cedillasmall', '', '', '', 'onequarter', 'onehalf', 'threequarters', + 'questiondownsmall', 'oneeighth', 'threeeighths', 'fiveeighths', 'seveneighths', 'onethird', 'twothirds', '', + '', 'zerosuperior', 'onesuperior', 'twosuperior', 'threesuperior', 'foursuperior', 'fivesuperior', + 'sixsuperior', 'sevensuperior', 'eightsuperior', 'ninesuperior', 'zeroinferior', 'oneinferior', 'twoinferior', + 'threeinferior', 'fourinferior', 'fiveinferior', 'sixinferior', 'seveninferior', 'eightinferior', + 'nineinferior', 'centinferior', 'dollarinferior', 'periodinferior', 'commainferior', 'Agravesmall', + 'Aacutesmall', 'Acircumflexsmall', 'Atildesmall', 'Adieresissmall', 'Aringsmall', 'AEsmall', 'Ccedillasmall', + 'Egravesmall', 'Eacutesmall', 'Ecircumflexsmall', 'Edieresissmall', 'Igravesmall', 'Iacutesmall', + 'Icircumflexsmall', 'Idieresissmall', 'Ethsmall', 'Ntildesmall', 'Ogravesmall', 'Oacutesmall', + 'Ocircumflexsmall', 'Otildesmall', 'Odieresissmall', 'OEsmall', 'Oslashsmall', 'Ugravesmall', 'Uacutesmall', + 'Ucircumflexsmall', 'Udieresissmall', 'Yacutesmall', 'Thornsmall', 'Ydieresissmall']; + + var standardNames = [ + '.notdef', '.null', 'nonmarkingreturn', 'space', 'exclam', 'quotedbl', 'numbersign', 'dollar', 'percent', + 'ampersand', 'quotesingle', 'parenleft', 'parenright', 'asterisk', 'plus', 'comma', 'hyphen', 'period', 'slash', + 'zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'colon', 'semicolon', 'less', + 'equal', 'greater', 'question', 'at', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', + 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'bracketleft', 'backslash', 'bracketright', + 'asciicircum', 'underscore', 'grave', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', + 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'braceleft', 'bar', 'braceright', 'asciitilde', + 'Adieresis', 'Aring', 'Ccedilla', 'Eacute', 'Ntilde', 'Odieresis', 'Udieresis', 'aacute', 'agrave', + 'acircumflex', 'adieresis', 'atilde', 'aring', 'ccedilla', 'eacute', 'egrave', 'ecircumflex', 'edieresis', + 'iacute', 'igrave', 'icircumflex', 'idieresis', 'ntilde', 'oacute', 'ograve', 'ocircumflex', 'odieresis', + 'otilde', 'uacute', 'ugrave', 'ucircumflex', 'udieresis', 'dagger', 'degree', 'cent', 'sterling', 'section', + 'bullet', 'paragraph', 'germandbls', 'registered', 'copyright', 'trademark', 'acute', 'dieresis', 'notequal', + 'AE', 'Oslash', 'infinity', 'plusminus', 'lessequal', 'greaterequal', 'yen', 'mu', 'partialdiff', 'summation', + 'product', 'pi', 'integral', 'ordfeminine', 'ordmasculine', 'Omega', 'ae', 'oslash', 'questiondown', + 'exclamdown', 'logicalnot', 'radical', 'florin', 'approxequal', 'Delta', 'guillemotleft', 'guillemotright', + 'ellipsis', 'nonbreakingspace', 'Agrave', 'Atilde', 'Otilde', 'OE', 'oe', 'endash', 'emdash', 'quotedblleft', + 'quotedblright', 'quoteleft', 'quoteright', 'divide', 'lozenge', 'ydieresis', 'Ydieresis', 'fraction', + 'currency', 'guilsinglleft', 'guilsinglright', 'fi', 'fl', 'daggerdbl', 'periodcentered', 'quotesinglbase', + 'quotedblbase', 'perthousand', 'Acircumflex', 'Ecircumflex', 'Aacute', 'Edieresis', 'Egrave', 'Iacute', + 'Icircumflex', 'Idieresis', 'Igrave', 'Oacute', 'Ocircumflex', 'apple', 'Ograve', 'Uacute', 'Ucircumflex', + 'Ugrave', 'dotlessi', 'circumflex', 'tilde', 'macron', 'breve', 'dotaccent', 'ring', 'cedilla', 'hungarumlaut', + 'ogonek', 'caron', 'Lslash', 'lslash', 'Scaron', 'scaron', 'Zcaron', 'zcaron', 'brokenbar', 'Eth', 'eth', + 'Yacute', 'yacute', 'Thorn', 'thorn', 'minus', 'multiply', 'onesuperior', 'twosuperior', 'threesuperior', + 'onehalf', 'onequarter', 'threequarters', 'franc', 'Gbreve', 'gbreve', 'Idotaccent', 'Scedilla', 'scedilla', + 'Cacute', 'cacute', 'Ccaron', 'ccaron', 'dcroat']; + + /** + * This is the encoding used for fonts created from scratch. + * It loops through all glyphs and finds the appropriate unicode value. + * Since it's linear time, other encodings will be faster. + * @exports opentype.DefaultEncoding + * @class + * @constructor + * @param {opentype.Font} + */ + function DefaultEncoding(font) { + this.font = font; + } + + DefaultEncoding.prototype.charToGlyphIndex = function(c) { + var code = c.codePointAt(0); + var glyphs = this.font.glyphs; + if (glyphs) { + for (var i = 0; i < glyphs.length; i += 1) { + var glyph = glyphs.get(i); + for (var j = 0; j < glyph.unicodes.length; j += 1) { + if (glyph.unicodes[j] === code) { + return i; + } + } + } + } + return null; + }; + + /** + * @exports opentype.CmapEncoding + * @class + * @constructor + * @param {Object} cmap - a object with the cmap encoded data + */ + function CmapEncoding(cmap) { + this.cmap = cmap; + } + + /** + * @param {string} c - the character + * @return {number} The glyph index. + */ + CmapEncoding.prototype.charToGlyphIndex = function(c) { + return this.cmap.glyphIndexMap[c.codePointAt(0)] || 0; + }; + + /** + * @exports opentype.CffEncoding + * @class + * @constructor + * @param {string} encoding - The encoding + * @param {Array} charset - The character set. + */ + function CffEncoding(encoding, charset) { + this.encoding = encoding; + this.charset = charset; + } + + /** + * @param {string} s - The character + * @return {number} The index. + */ + CffEncoding.prototype.charToGlyphIndex = function(s) { + var code = s.codePointAt(0); + var charName = this.encoding[code]; + return this.charset.indexOf(charName); + }; + + /** + * @exports opentype.GlyphNames + * @class + * @constructor + * @param {Object} post + */ + function GlyphNames(post) { + var this$1 = this; + + switch (post.version) { + case 1: + this.names = standardNames.slice(); + break; + case 2: + this.names = new Array(post.numberOfGlyphs); + for (var i = 0; i < post.numberOfGlyphs; i++) { + if (post.glyphNameIndex[i] < standardNames.length) { + this$1.names[i] = standardNames[post.glyphNameIndex[i]]; + } else { + this$1.names[i] = post.names[post.glyphNameIndex[i] - standardNames.length]; + } + } + + break; + case 2.5: + this.names = new Array(post.numberOfGlyphs); + for (var i$1 = 0; i$1 < post.numberOfGlyphs; i$1++) { + this$1.names[i$1] = standardNames[i$1 + post.glyphNameIndex[i$1]]; + } + + break; + case 3: + this.names = []; + break; + default: + this.names = []; + break; + } + } + + /** + * Gets the index of a glyph by name. + * @param {string} name - The glyph name + * @return {number} The index + */ + GlyphNames.prototype.nameToGlyphIndex = function(name) { + return this.names.indexOf(name); + }; + + /** + * @param {number} gid + * @return {string} + */ + GlyphNames.prototype.glyphIndexToName = function(gid) { + return this.names[gid]; + }; + + /** + * @alias opentype.addGlyphNames + * @param {opentype.Font} + */ + function addGlyphNames(font) { + var glyph; + var glyphIndexMap = font.tables.cmap.glyphIndexMap; + var charCodes = Object.keys(glyphIndexMap); + + for (var i = 0; i < charCodes.length; i += 1) { + var c = charCodes[i]; + var glyphIndex = glyphIndexMap[c]; + glyph = font.glyphs.get(glyphIndex); + glyph.addUnicode(parseInt(c)); + } + + for (var i$1 = 0; i$1 < font.glyphs.length; i$1 += 1) { + glyph = font.glyphs.get(i$1); + if (font.cffEncoding) { + if (font.isCIDFont) { + glyph.name = 'gid' + i$1; + } else { + glyph.name = font.cffEncoding.charset[i$1]; + } + } else if (font.glyphNames.names) { + glyph.name = font.glyphNames.glyphIndexToName(i$1); + } + } + } + + // Drawing utility functions. + + // Draw a line on the given context from point `x1,y1` to point `x2,y2`. + function line(ctx, x1, y1, x2, y2) { + ctx.beginPath(); + ctx.moveTo(x1, y1); + ctx.lineTo(x2, y2); + ctx.stroke(); + } + + var draw = { line: line }; + + // The Glyph object + // import glyf from './tables/glyf' Can't be imported here, because it's a circular dependency + + function getPathDefinition(glyph, path) { + var _path = path || new Path(); + return { + configurable: true, + + get: function() { + if (typeof _path === 'function') { + _path = _path(); + } + + return _path; + }, + + set: function(p) { + _path = p; + } + }; + } + /** + * @typedef GlyphOptions + * @type Object + * @property {string} [name] - The glyph name + * @property {number} [unicode] + * @property {Array} [unicodes] + * @property {number} [xMin] + * @property {number} [yMin] + * @property {number} [xMax] + * @property {number} [yMax] + * @property {number} [advanceWidth] + */ + + // A Glyph is an individual mark that often corresponds to a character. + // Some glyphs, such as ligatures, are a combination of many characters. + // Glyphs are the basic building blocks of a font. + // + // The `Glyph` class contains utility methods for drawing the path and its points. + /** + * @exports opentype.Glyph + * @class + * @param {GlyphOptions} + * @constructor + */ + function Glyph(options) { + // By putting all the code on a prototype function (which is only declared once) + // we reduce the memory requirements for larger fonts by some 2% + this.bindConstructorValues(options); + } + + /** + * @param {GlyphOptions} + */ + Glyph.prototype.bindConstructorValues = function(options) { + this.index = options.index || 0; + + // These three values cannot be deferred for memory optimization: + this.name = options.name || null; + this.unicode = options.unicode || undefined; + this.unicodes = options.unicodes || options.unicode !== undefined ? [options.unicode] : []; + + // But by binding these values only when necessary, we reduce can + // the memory requirements by almost 3% for larger fonts. + if (options.xMin) { + this.xMin = options.xMin; + } + + if (options.yMin) { + this.yMin = options.yMin; + } + + if (options.xMax) { + this.xMax = options.xMax; + } + + if (options.yMax) { + this.yMax = options.yMax; + } + + if (options.advanceWidth) { + this.advanceWidth = options.advanceWidth; + } + + // The path for a glyph is the most memory intensive, and is bound as a value + // with a getter/setter to ensure we actually do path parsing only once the + // path is actually needed by anything. + Object.defineProperty(this, 'path', getPathDefinition(this, options.path)); + }; + + /** + * @param {number} + */ + Glyph.prototype.addUnicode = function(unicode) { + if (this.unicodes.length === 0) { + this.unicode = unicode; + } + + this.unicodes.push(unicode); + }; + + /** + * Calculate the minimum bounding box for this glyph. + * @return {opentype.BoundingBox} + */ + Glyph.prototype.getBoundingBox = function() { + return this.path.getBoundingBox(); + }; + + /** + * Convert the glyph to a Path we can draw on a drawing context. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {Object=} options - xScale, yScale to stretch the glyph. + * @param {opentype.Font} if hinting is to be used, the font + * @return {opentype.Path} + */ + Glyph.prototype.getPath = function(x, y, fontSize, options, font) { + x = x !== undefined ? x : 0; + y = y !== undefined ? y : 0; + fontSize = fontSize !== undefined ? fontSize : 72; + var commands; + var hPoints; + if (!options) { options = { }; } + var xScale = options.xScale; + var yScale = options.yScale; + + if (options.hinting && font && font.hinting) { + // in case of hinting, the hinting engine takes care + // of scaling the points (not the path) before hinting. + hPoints = this.path && font.hinting.exec(this, fontSize); + // in case the hinting engine failed hPoints is undefined + // and thus reverts to plain rending + } + + if (hPoints) { + // Call font.hinting.getCommands instead of `glyf.getPath(hPoints).commands` to avoid a circular dependency + commands = font.hinting.getCommands(hPoints); + x = Math.round(x); + y = Math.round(y); + // TODO in case of hinting xyScaling is not yet supported + xScale = yScale = 1; + } else { + commands = this.path.commands; + var scale = 1 / this.path.unitsPerEm * fontSize; + if (xScale === undefined) { xScale = scale; } + if (yScale === undefined) { yScale = scale; } + } + + var p = new Path(); + for (var i = 0; i < commands.length; i += 1) { + var cmd = commands[i]; + if (cmd.type === 'M') { + p.moveTo(x + (cmd.x * xScale), y + (-cmd.y * yScale)); + } else if (cmd.type === 'L') { + p.lineTo(x + (cmd.x * xScale), y + (-cmd.y * yScale)); + } else if (cmd.type === 'Q') { + p.quadraticCurveTo(x + (cmd.x1 * xScale), y + (-cmd.y1 * yScale), + x + (cmd.x * xScale), y + (-cmd.y * yScale)); + } else if (cmd.type === 'C') { + p.curveTo(x + (cmd.x1 * xScale), y + (-cmd.y1 * yScale), + x + (cmd.x2 * xScale), y + (-cmd.y2 * yScale), + x + (cmd.x * xScale), y + (-cmd.y * yScale)); + } else if (cmd.type === 'Z') { + p.closePath(); + } + } + + return p; + }; + + /** + * Split the glyph into contours. + * This function is here for backwards compatibility, and to + * provide raw access to the TrueType glyph outlines. + * @return {Array} + */ + Glyph.prototype.getContours = function() { + var this$1 = this; + + if (this.points === undefined) { + return []; + } + + var contours = []; + var currentContour = []; + for (var i = 0; i < this.points.length; i += 1) { + var pt = this$1.points[i]; + currentContour.push(pt); + if (pt.lastPointOfContour) { + contours.push(currentContour); + currentContour = []; + } + } + + check.argument(currentContour.length === 0, 'There are still points left in the current contour.'); + return contours; + }; + + /** + * Calculate the xMin/yMin/xMax/yMax/lsb/rsb for a Glyph. + * @return {Object} + */ + Glyph.prototype.getMetrics = function() { + var commands = this.path.commands; + var xCoords = []; + var yCoords = []; + for (var i = 0; i < commands.length; i += 1) { + var cmd = commands[i]; + if (cmd.type !== 'Z') { + xCoords.push(cmd.x); + yCoords.push(cmd.y); + } + + if (cmd.type === 'Q' || cmd.type === 'C') { + xCoords.push(cmd.x1); + yCoords.push(cmd.y1); + } + + if (cmd.type === 'C') { + xCoords.push(cmd.x2); + yCoords.push(cmd.y2); + } + } + + var metrics = { + xMin: Math.min.apply(null, xCoords), + yMin: Math.min.apply(null, yCoords), + xMax: Math.max.apply(null, xCoords), + yMax: Math.max.apply(null, yCoords), + leftSideBearing: this.leftSideBearing + }; + + if (!isFinite(metrics.xMin)) { + metrics.xMin = 0; + } + + if (!isFinite(metrics.xMax)) { + metrics.xMax = this.advanceWidth; + } + + if (!isFinite(metrics.yMin)) { + metrics.yMin = 0; + } + + if (!isFinite(metrics.yMax)) { + metrics.yMax = 0; + } + + metrics.rightSideBearing = this.advanceWidth - metrics.leftSideBearing - (metrics.xMax - metrics.xMin); + return metrics; + }; + + /** + * Draw the glyph on the given context. + * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {Object=} options - xScale, yScale to stretch the glyph. + */ + Glyph.prototype.draw = function(ctx, x, y, fontSize, options) { + this.getPath(x, y, fontSize, options).draw(ctx); + }; + + /** + * Draw the points of the glyph. + * On-curve points will be drawn in blue, off-curve points will be drawn in red. + * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + */ + Glyph.prototype.drawPoints = function(ctx, x, y, fontSize) { + function drawCircles(l, x, y, scale) { + var PI_SQ = Math.PI * 2; + ctx.beginPath(); + for (var j = 0; j < l.length; j += 1) { + ctx.moveTo(x + (l[j].x * scale), y + (l[j].y * scale)); + ctx.arc(x + (l[j].x * scale), y + (l[j].y * scale), 2, 0, PI_SQ, false); + } + + ctx.closePath(); + ctx.fill(); + } + + x = x !== undefined ? x : 0; + y = y !== undefined ? y : 0; + fontSize = fontSize !== undefined ? fontSize : 24; + var scale = 1 / this.path.unitsPerEm * fontSize; + + var blueCircles = []; + var redCircles = []; + var path = this.path; + for (var i = 0; i < path.commands.length; i += 1) { + var cmd = path.commands[i]; + if (cmd.x !== undefined) { + blueCircles.push({x: cmd.x, y: -cmd.y}); + } + + if (cmd.x1 !== undefined) { + redCircles.push({x: cmd.x1, y: -cmd.y1}); + } + + if (cmd.x2 !== undefined) { + redCircles.push({x: cmd.x2, y: -cmd.y2}); + } + } + + ctx.fillStyle = 'blue'; + drawCircles(blueCircles, x, y, scale); + ctx.fillStyle = 'red'; + drawCircles(redCircles, x, y, scale); + }; + + /** + * Draw lines indicating important font measurements. + * Black lines indicate the origin of the coordinate system (point 0,0). + * Blue lines indicate the glyph bounding box. + * Green line indicates the advance width of the glyph. + * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + */ + Glyph.prototype.drawMetrics = function(ctx, x, y, fontSize) { + var scale; + x = x !== undefined ? x : 0; + y = y !== undefined ? y : 0; + fontSize = fontSize !== undefined ? fontSize : 24; + scale = 1 / this.path.unitsPerEm * fontSize; + ctx.lineWidth = 1; + + // Draw the origin + ctx.strokeStyle = 'black'; + draw.line(ctx, x, -10000, x, 10000); + draw.line(ctx, -10000, y, 10000, y); + + // This code is here due to memory optimization: by not using + // defaults in the constructor, we save a notable amount of memory. + var xMin = this.xMin || 0; + var yMin = this.yMin || 0; + var xMax = this.xMax || 0; + var yMax = this.yMax || 0; + var advanceWidth = this.advanceWidth || 0; + + // Draw the glyph box + ctx.strokeStyle = 'blue'; + draw.line(ctx, x + (xMin * scale), -10000, x + (xMin * scale), 10000); + draw.line(ctx, x + (xMax * scale), -10000, x + (xMax * scale), 10000); + draw.line(ctx, -10000, y + (-yMin * scale), 10000, y + (-yMin * scale)); + draw.line(ctx, -10000, y + (-yMax * scale), 10000, y + (-yMax * scale)); + + // Draw the advance width + ctx.strokeStyle = 'green'; + draw.line(ctx, x + (advanceWidth * scale), -10000, x + (advanceWidth * scale), 10000); + }; + + // The GlyphSet object + + // Define a property on the glyph that depends on the path being loaded. + function defineDependentProperty(glyph, externalName, internalName) { + Object.defineProperty(glyph, externalName, { + get: function() { + // Request the path property to make sure the path is loaded. + glyph.path; // jshint ignore:line + return glyph[internalName]; + }, + set: function(newValue) { + glyph[internalName] = newValue; + }, + enumerable: true, + configurable: true + }); + } + + /** + * A GlyphSet represents all glyphs available in the font, but modelled using + * a deferred glyph loader, for retrieving glyphs only once they are absolutely + * necessary, to keep the memory footprint down. + * @exports opentype.GlyphSet + * @class + * @param {opentype.Font} + * @param {Array} + */ + function GlyphSet(font, glyphs) { + var this$1 = this; + + this.font = font; + this.glyphs = {}; + if (Array.isArray(glyphs)) { + for (var i = 0; i < glyphs.length; i++) { + this$1.glyphs[i] = glyphs[i]; + } + } + + this.length = (glyphs && glyphs.length) || 0; + } + + /** + * @param {number} index + * @return {opentype.Glyph} + */ + GlyphSet.prototype.get = function(index) { + if (typeof this.glyphs[index] === 'function') { + this.glyphs[index] = this.glyphs[index](); + } + + return this.glyphs[index]; + }; + + /** + * @param {number} index + * @param {Object} + */ + GlyphSet.prototype.push = function(index, loader) { + this.glyphs[index] = loader; + this.length++; + }; + + /** + * @alias opentype.glyphLoader + * @param {opentype.Font} font + * @param {number} index + * @return {opentype.Glyph} + */ + function glyphLoader(font, index) { + return new Glyph({index: index, font: font}); + } + + /** + * Generate a stub glyph that can be filled with all metadata *except* + * the "points" and "path" properties, which must be loaded only once + * the glyph's path is actually requested for text shaping. + * @alias opentype.ttfGlyphLoader + * @param {opentype.Font} font + * @param {number} index + * @param {Function} parseGlyph + * @param {Object} data + * @param {number} position + * @param {Function} buildPath + * @return {opentype.Glyph} + */ + function ttfGlyphLoader(font, index, parseGlyph, data, position, buildPath) { + return function() { + var glyph = new Glyph({index: index, font: font}); + + glyph.path = function() { + parseGlyph(glyph, data, position); + var path = buildPath(font.glyphs, glyph); + path.unitsPerEm = font.unitsPerEm; + return path; + }; + + defineDependentProperty(glyph, 'xMin', '_xMin'); + defineDependentProperty(glyph, 'xMax', '_xMax'); + defineDependentProperty(glyph, 'yMin', '_yMin'); + defineDependentProperty(glyph, 'yMax', '_yMax'); + + return glyph; + }; + } + /** + * @alias opentype.cffGlyphLoader + * @param {opentype.Font} font + * @param {number} index + * @param {Function} parseCFFCharstring + * @param {string} charstring + * @return {opentype.Glyph} + */ + function cffGlyphLoader(font, index, parseCFFCharstring, charstring) { + return function() { + var glyph = new Glyph({index: index, font: font}); + + glyph.path = function() { + var path = parseCFFCharstring(font, glyph, charstring); + path.unitsPerEm = font.unitsPerEm; + return path; + }; + + return glyph; + }; + } + + var glyphset = { GlyphSet: GlyphSet, glyphLoader: glyphLoader, ttfGlyphLoader: ttfGlyphLoader, cffGlyphLoader: cffGlyphLoader }; + + // The `CFF` table contains the glyph outlines in PostScript format. + + // Custom equals function that can also check lists. + function equals(a, b) { + if (a === b) { + return true; + } else if (Array.isArray(a) && Array.isArray(b)) { + if (a.length !== b.length) { + return false; + } + + for (var i = 0; i < a.length; i += 1) { + if (!equals(a[i], b[i])) { + return false; + } + } + + return true; + } else { + return false; + } + } + + // Subroutines are encoded using the negative half of the number space. + // See type 2 chapter 4.7 "Subroutine operators". + function calcCFFSubroutineBias(subrs) { + var bias; + if (subrs.length < 1240) { + bias = 107; + } else if (subrs.length < 33900) { + bias = 1131; + } else { + bias = 32768; + } + + return bias; + } + + // Parse a `CFF` INDEX array. + // An index array consists of a list of offsets, then a list of objects at those offsets. + function parseCFFIndex(data, start, conversionFn) { + var offsets = []; + var objects = []; + var count = parse.getCard16(data, start); + var objectOffset; + var endOffset; + if (count !== 0) { + var offsetSize = parse.getByte(data, start + 2); + objectOffset = start + ((count + 1) * offsetSize) + 2; + var pos = start + 3; + for (var i = 0; i < count + 1; i += 1) { + offsets.push(parse.getOffset(data, pos, offsetSize)); + pos += offsetSize; + } + + // The total size of the index array is 4 header bytes + the value of the last offset. + endOffset = objectOffset + offsets[count]; + } else { + endOffset = start + 2; + } + + for (var i$1 = 0; i$1 < offsets.length - 1; i$1 += 1) { + var value = parse.getBytes(data, objectOffset + offsets[i$1], objectOffset + offsets[i$1 + 1]); + if (conversionFn) { + value = conversionFn(value); + } + + objects.push(value); + } + + return {objects: objects, startOffset: start, endOffset: endOffset}; + } + + // Parse a `CFF` DICT real value. + function parseFloatOperand(parser) { + var s = ''; + var eof = 15; + var lookup = ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '.', 'E', 'E-', null, '-']; + while (true) { + var b = parser.parseByte(); + var n1 = b >> 4; + var n2 = b & 15; + + if (n1 === eof) { + break; + } + + s += lookup[n1]; + + if (n2 === eof) { + break; + } + + s += lookup[n2]; + } + + return parseFloat(s); + } + + // Parse a `CFF` DICT operand. + function parseOperand(parser, b0) { + var b1; + var b2; + var b3; + var b4; + if (b0 === 28) { + b1 = parser.parseByte(); + b2 = parser.parseByte(); + return b1 << 8 | b2; + } + + if (b0 === 29) { + b1 = parser.parseByte(); + b2 = parser.parseByte(); + b3 = parser.parseByte(); + b4 = parser.parseByte(); + return b1 << 24 | b2 << 16 | b3 << 8 | b4; + } + + if (b0 === 30) { + return parseFloatOperand(parser); + } + + if (b0 >= 32 && b0 <= 246) { + return b0 - 139; + } + + if (b0 >= 247 && b0 <= 250) { + b1 = parser.parseByte(); + return (b0 - 247) * 256 + b1 + 108; + } + + if (b0 >= 251 && b0 <= 254) { + b1 = parser.parseByte(); + return -(b0 - 251) * 256 - b1 - 108; + } + + throw new Error('Invalid b0 ' + b0); + } + + // Convert the entries returned by `parseDict` to a proper dictionary. + // If a value is a list of one, it is unpacked. + function entriesToObject(entries) { + var o = {}; + for (var i = 0; i < entries.length; i += 1) { + var key = entries[i][0]; + var values = entries[i][1]; + var value = (void 0); + if (values.length === 1) { + value = values[0]; + } else { + value = values; + } + + if (o.hasOwnProperty(key) && !isNaN(o[key])) { + throw new Error('Object ' + o + ' already has key ' + key); + } + + o[key] = value; + } + + return o; + } + + // Parse a `CFF` DICT object. + // A dictionary contains key-value pairs in a compact tokenized format. + function parseCFFDict(data, start, size) { + start = start !== undefined ? start : 0; + var parser = new parse.Parser(data, start); + var entries = []; + var operands = []; + size = size !== undefined ? size : data.length; + + while (parser.relativeOffset < size) { + var op = parser.parseByte(); + + // The first byte for each dict item distinguishes between operator (key) and operand (value). + // Values <= 21 are operators. + if (op <= 21) { + // Two-byte operators have an initial escape byte of 12. + if (op === 12) { + op = 1200 + parser.parseByte(); + } + + entries.push([op, operands]); + operands = []; + } else { + // Since the operands (values) come before the operators (keys), we store all operands in a list + // until we encounter an operator. + operands.push(parseOperand(parser, op)); + } + } + + return entriesToObject(entries); + } + + // Given a String Index (SID), return the value of the string. + // Strings below index 392 are standard CFF strings and are not encoded in the font. + function getCFFString(strings, index) { + if (index <= 390) { + index = cffStandardStrings[index]; + } else { + index = strings[index - 391]; + } + + return index; + } + + // Interpret a dictionary and return a new dictionary with readable keys and values for missing entries. + // This function takes `meta` which is a list of objects containing `operand`, `name` and `default`. + function interpretDict(dict, meta, strings) { + var newDict = {}; + var value; + + // Because we also want to include missing values, we start out from the meta list + // and lookup values in the dict. + for (var i = 0; i < meta.length; i += 1) { + var m = meta[i]; + + if (Array.isArray(m.type)) { + var values = []; + values.length = m.type.length; + for (var j = 0; j < m.type.length; j++) { + value = dict[m.op] !== undefined ? dict[m.op][j] : undefined; + if (value === undefined) { + value = m.value !== undefined && m.value[j] !== undefined ? m.value[j] : null; + } + if (m.type[j] === 'SID') { + value = getCFFString(strings, value); + } + values[j] = value; + } + newDict[m.name] = values; + } else { + value = dict[m.op]; + if (value === undefined) { + value = m.value !== undefined ? m.value : null; + } + + if (m.type === 'SID') { + value = getCFFString(strings, value); + } + newDict[m.name] = value; + } + } + + return newDict; + } + + // Parse the CFF header. + function parseCFFHeader(data, start) { + var header = {}; + header.formatMajor = parse.getCard8(data, start); + header.formatMinor = parse.getCard8(data, start + 1); + header.size = parse.getCard8(data, start + 2); + header.offsetSize = parse.getCard8(data, start + 3); + header.startOffset = start; + header.endOffset = start + 4; + return header; + } + + var TOP_DICT_META = [ + {name: 'version', op: 0, type: 'SID'}, + {name: 'notice', op: 1, type: 'SID'}, + {name: 'copyright', op: 1200, type: 'SID'}, + {name: 'fullName', op: 2, type: 'SID'}, + {name: 'familyName', op: 3, type: 'SID'}, + {name: 'weight', op: 4, type: 'SID'}, + {name: 'isFixedPitch', op: 1201, type: 'number', value: 0}, + {name: 'italicAngle', op: 1202, type: 'number', value: 0}, + {name: 'underlinePosition', op: 1203, type: 'number', value: -100}, + {name: 'underlineThickness', op: 1204, type: 'number', value: 50}, + {name: 'paintType', op: 1205, type: 'number', value: 0}, + {name: 'charstringType', op: 1206, type: 'number', value: 2}, + { + name: 'fontMatrix', + op: 1207, + type: ['real', 'real', 'real', 'real', 'real', 'real'], + value: [0.001, 0, 0, 0.001, 0, 0] + }, + {name: 'uniqueId', op: 13, type: 'number'}, + {name: 'fontBBox', op: 5, type: ['number', 'number', 'number', 'number'], value: [0, 0, 0, 0]}, + {name: 'strokeWidth', op: 1208, type: 'number', value: 0}, + {name: 'xuid', op: 14, type: [], value: null}, + {name: 'charset', op: 15, type: 'offset', value: 0}, + {name: 'encoding', op: 16, type: 'offset', value: 0}, + {name: 'charStrings', op: 17, type: 'offset', value: 0}, + {name: 'private', op: 18, type: ['number', 'offset'], value: [0, 0]}, + {name: 'ros', op: 1230, type: ['SID', 'SID', 'number']}, + {name: 'cidFontVersion', op: 1231, type: 'number', value: 0}, + {name: 'cidFontRevision', op: 1232, type: 'number', value: 0}, + {name: 'cidFontType', op: 1233, type: 'number', value: 0}, + {name: 'cidCount', op: 1234, type: 'number', value: 8720}, + {name: 'uidBase', op: 1235, type: 'number'}, + {name: 'fdArray', op: 1236, type: 'offset'}, + {name: 'fdSelect', op: 1237, type: 'offset'}, + {name: 'fontName', op: 1238, type: 'SID'} + ]; + + var PRIVATE_DICT_META = [ + {name: 'subrs', op: 19, type: 'offset', value: 0}, + {name: 'defaultWidthX', op: 20, type: 'number', value: 0}, + {name: 'nominalWidthX', op: 21, type: 'number', value: 0} + ]; + + // Parse the CFF top dictionary. A CFF table can contain multiple fonts, each with their own top dictionary. + // The top dictionary contains the essential metadata for the font, together with the private dictionary. + function parseCFFTopDict(data, strings) { + var dict = parseCFFDict(data, 0, data.byteLength); + return interpretDict(dict, TOP_DICT_META, strings); + } + + // Parse the CFF private dictionary. We don't fully parse out all the values, only the ones we need. + function parseCFFPrivateDict(data, start, size, strings) { + var dict = parseCFFDict(data, start, size); + return interpretDict(dict, PRIVATE_DICT_META, strings); + } + + // Returns a list of "Top DICT"s found using an INDEX list. + // Used to read both the usual high-level Top DICTs and also the FDArray + // discovered inside CID-keyed fonts. When a Top DICT has a reference to + // a Private DICT that is read and saved into the Top DICT. + // + // In addition to the expected/optional values as outlined in TOP_DICT_META + // the following values might be saved into the Top DICT. + // + // _subrs [] array of local CFF subroutines from Private DICT + // _subrsBias bias value computed from number of subroutines + // (see calcCFFSubroutineBias() and parseCFFCharstring()) + // _defaultWidthX default widths for CFF characters + // _nominalWidthX bias added to width embedded within glyph description + // + // _privateDict saved copy of parsed Private DICT from Top DICT + function gatherCFFTopDicts(data, start, cffIndex, strings) { + var topDictArray = []; + for (var iTopDict = 0; iTopDict < cffIndex.length; iTopDict += 1) { + var topDictData = new DataView(new Uint8Array(cffIndex[iTopDict]).buffer); + var topDict = parseCFFTopDict(topDictData, strings); + topDict._subrs = []; + topDict._subrsBias = 0; + var privateSize = topDict.private[0]; + var privateOffset = topDict.private[1]; + if (privateSize !== 0 && privateOffset !== 0) { + var privateDict = parseCFFPrivateDict(data, privateOffset + start, privateSize, strings); + topDict._defaultWidthX = privateDict.defaultWidthX; + topDict._nominalWidthX = privateDict.nominalWidthX; + if (privateDict.subrs !== 0) { + var subrOffset = privateOffset + privateDict.subrs; + var subrIndex = parseCFFIndex(data, subrOffset + start); + topDict._subrs = subrIndex.objects; + topDict._subrsBias = calcCFFSubroutineBias(topDict._subrs); + } + topDict._privateDict = privateDict; + } + topDictArray.push(topDict); + } + return topDictArray; + } + + // Parse the CFF charset table, which contains internal names for all the glyphs. + // This function will return a list of glyph names. + // See Adobe TN #5176 chapter 13, "Charsets". + function parseCFFCharset(data, start, nGlyphs, strings) { + var sid; + var count; + var parser = new parse.Parser(data, start); + + // The .notdef glyph is not included, so subtract 1. + nGlyphs -= 1; + var charset = ['.notdef']; + + var format = parser.parseCard8(); + if (format === 0) { + for (var i = 0; i < nGlyphs; i += 1) { + sid = parser.parseSID(); + charset.push(getCFFString(strings, sid)); + } + } else if (format === 1) { + while (charset.length <= nGlyphs) { + sid = parser.parseSID(); + count = parser.parseCard8(); + for (var i$1 = 0; i$1 <= count; i$1 += 1) { + charset.push(getCFFString(strings, sid)); + sid += 1; + } + } + } else if (format === 2) { + while (charset.length <= nGlyphs) { + sid = parser.parseSID(); + count = parser.parseCard16(); + for (var i$2 = 0; i$2 <= count; i$2 += 1) { + charset.push(getCFFString(strings, sid)); + sid += 1; + } + } + } else { + throw new Error('Unknown charset format ' + format); + } + + return charset; + } + + // Parse the CFF encoding data. Only one encoding can be specified per font. + // See Adobe TN #5176 chapter 12, "Encodings". + function parseCFFEncoding(data, start, charset) { + var code; + var enc = {}; + var parser = new parse.Parser(data, start); + var format = parser.parseCard8(); + if (format === 0) { + var nCodes = parser.parseCard8(); + for (var i = 0; i < nCodes; i += 1) { + code = parser.parseCard8(); + enc[code] = i; + } + } else if (format === 1) { + var nRanges = parser.parseCard8(); + code = 1; + for (var i$1 = 0; i$1 < nRanges; i$1 += 1) { + var first = parser.parseCard8(); + var nLeft = parser.parseCard8(); + for (var j = first; j <= first + nLeft; j += 1) { + enc[j] = code; + code += 1; + } + } + } else { + throw new Error('Unknown encoding format ' + format); + } + + return new CffEncoding(enc, charset); + } + + // Take in charstring code and return a Glyph object. + // The encoding is described in the Type 2 Charstring Format + // https://www.microsoft.com/typography/OTSPEC/charstr2.htm + function parseCFFCharstring(font, glyph, code) { + var c1x; + var c1y; + var c2x; + var c2y; + var p = new Path(); + var stack = []; + var nStems = 0; + var haveWidth = false; + var open = false; + var x = 0; + var y = 0; + var subrs; + var subrsBias; + var defaultWidthX; + var nominalWidthX; + if (font.isCIDFont) { + var fdIndex = font.tables.cff.topDict._fdSelect[glyph.index]; + var fdDict = font.tables.cff.topDict._fdArray[fdIndex]; + subrs = fdDict._subrs; + subrsBias = fdDict._subrsBias; + defaultWidthX = fdDict._defaultWidthX; + nominalWidthX = fdDict._nominalWidthX; + } else { + subrs = font.tables.cff.topDict._subrs; + subrsBias = font.tables.cff.topDict._subrsBias; + defaultWidthX = font.tables.cff.topDict._defaultWidthX; + nominalWidthX = font.tables.cff.topDict._nominalWidthX; + } + var width = defaultWidthX; + + function newContour(x, y) { + if (open) { + p.closePath(); + } + + p.moveTo(x, y); + open = true; + } + + function parseStems() { + var hasWidthArg; + + // The number of stem operators on the stack is always even. + // If the value is uneven, that means a width is specified. + hasWidthArg = stack.length % 2 !== 0; + if (hasWidthArg && !haveWidth) { + width = stack.shift() + nominalWidthX; + } + + nStems += stack.length >> 1; + stack.length = 0; + haveWidth = true; + } + + function parse$$1(code) { + var b1; + var b2; + var b3; + var b4; + var codeIndex; + var subrCode; + var jpx; + var jpy; + var c3x; + var c3y; + var c4x; + var c4y; + + var i = 0; + while (i < code.length) { + var v = code[i]; + i += 1; + switch (v) { + case 1: // hstem + parseStems(); + break; + case 3: // vstem + parseStems(); + break; + case 4: // vmoveto + if (stack.length > 1 && !haveWidth) { + width = stack.shift() + nominalWidthX; + haveWidth = true; + } + + y += stack.pop(); + newContour(x, y); + break; + case 5: // rlineto + while (stack.length > 0) { + x += stack.shift(); + y += stack.shift(); + p.lineTo(x, y); + } + + break; + case 6: // hlineto + while (stack.length > 0) { + x += stack.shift(); + p.lineTo(x, y); + if (stack.length === 0) { + break; + } + + y += stack.shift(); + p.lineTo(x, y); + } + + break; + case 7: // vlineto + while (stack.length > 0) { + y += stack.shift(); + p.lineTo(x, y); + if (stack.length === 0) { + break; + } + + x += stack.shift(); + p.lineTo(x, y); + } + + break; + case 8: // rrcurveto + while (stack.length > 0) { + c1x = x + stack.shift(); + c1y = y + stack.shift(); + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + x = c2x + stack.shift(); + y = c2y + stack.shift(); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + } + + break; + case 10: // callsubr + codeIndex = stack.pop() + subrsBias; + subrCode = subrs[codeIndex]; + if (subrCode) { + parse$$1(subrCode); + } + + break; + case 11: // return + return; + case 12: // flex operators + v = code[i]; + i += 1; + switch (v) { + case 35: // flex + // |- dx1 dy1 dx2 dy2 dx3 dy3 dx4 dy4 dx5 dy5 dx6 dy6 fd flex (12 35) |- + c1x = x + stack.shift(); // dx1 + c1y = y + stack.shift(); // dy1 + c2x = c1x + stack.shift(); // dx2 + c2y = c1y + stack.shift(); // dy2 + jpx = c2x + stack.shift(); // dx3 + jpy = c2y + stack.shift(); // dy3 + c3x = jpx + stack.shift(); // dx4 + c3y = jpy + stack.shift(); // dy4 + c4x = c3x + stack.shift(); // dx5 + c4y = c3y + stack.shift(); // dy5 + x = c4x + stack.shift(); // dx6 + y = c4y + stack.shift(); // dy6 + stack.shift(); // flex depth + p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy); + p.curveTo(c3x, c3y, c4x, c4y, x, y); + break; + case 34: // hflex + // |- dx1 dx2 dy2 dx3 dx4 dx5 dx6 hflex (12 34) |- + c1x = x + stack.shift(); // dx1 + c1y = y; // dy1 + c2x = c1x + stack.shift(); // dx2 + c2y = c1y + stack.shift(); // dy2 + jpx = c2x + stack.shift(); // dx3 + jpy = c2y; // dy3 + c3x = jpx + stack.shift(); // dx4 + c3y = c2y; // dy4 + c4x = c3x + stack.shift(); // dx5 + c4y = y; // dy5 + x = c4x + stack.shift(); // dx6 + p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy); + p.curveTo(c3x, c3y, c4x, c4y, x, y); + break; + case 36: // hflex1 + // |- dx1 dy1 dx2 dy2 dx3 dx4 dx5 dy5 dx6 hflex1 (12 36) |- + c1x = x + stack.shift(); // dx1 + c1y = y + stack.shift(); // dy1 + c2x = c1x + stack.shift(); // dx2 + c2y = c1y + stack.shift(); // dy2 + jpx = c2x + stack.shift(); // dx3 + jpy = c2y; // dy3 + c3x = jpx + stack.shift(); // dx4 + c3y = c2y; // dy4 + c4x = c3x + stack.shift(); // dx5 + c4y = c3y + stack.shift(); // dy5 + x = c4x + stack.shift(); // dx6 + p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy); + p.curveTo(c3x, c3y, c4x, c4y, x, y); + break; + case 37: // flex1 + // |- dx1 dy1 dx2 dy2 dx3 dy3 dx4 dy4 dx5 dy5 d6 flex1 (12 37) |- + c1x = x + stack.shift(); // dx1 + c1y = y + stack.shift(); // dy1 + c2x = c1x + stack.shift(); // dx2 + c2y = c1y + stack.shift(); // dy2 + jpx = c2x + stack.shift(); // dx3 + jpy = c2y + stack.shift(); // dy3 + c3x = jpx + stack.shift(); // dx4 + c3y = jpy + stack.shift(); // dy4 + c4x = c3x + stack.shift(); // dx5 + c4y = c3y + stack.shift(); // dy5 + if (Math.abs(c4x - x) > Math.abs(c4y - y)) { + x = c4x + stack.shift(); + } else { + y = c4y + stack.shift(); + } + + p.curveTo(c1x, c1y, c2x, c2y, jpx, jpy); + p.curveTo(c3x, c3y, c4x, c4y, x, y); + break; + default: + console.log('Glyph ' + glyph.index + ': unknown operator ' + 1200 + v); + stack.length = 0; + } + break; + case 14: // endchar + if (stack.length > 0 && !haveWidth) { + width = stack.shift() + nominalWidthX; + haveWidth = true; + } + + if (open) { + p.closePath(); + open = false; + } + + break; + case 18: // hstemhm + parseStems(); + break; + case 19: // hintmask + case 20: // cntrmask + parseStems(); + i += (nStems + 7) >> 3; + break; + case 21: // rmoveto + if (stack.length > 2 && !haveWidth) { + width = stack.shift() + nominalWidthX; + haveWidth = true; + } + + y += stack.pop(); + x += stack.pop(); + newContour(x, y); + break; + case 22: // hmoveto + if (stack.length > 1 && !haveWidth) { + width = stack.shift() + nominalWidthX; + haveWidth = true; + } + + x += stack.pop(); + newContour(x, y); + break; + case 23: // vstemhm + parseStems(); + break; + case 24: // rcurveline + while (stack.length > 2) { + c1x = x + stack.shift(); + c1y = y + stack.shift(); + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + x = c2x + stack.shift(); + y = c2y + stack.shift(); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + } + + x += stack.shift(); + y += stack.shift(); + p.lineTo(x, y); + break; + case 25: // rlinecurve + while (stack.length > 6) { + x += stack.shift(); + y += stack.shift(); + p.lineTo(x, y); + } + + c1x = x + stack.shift(); + c1y = y + stack.shift(); + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + x = c2x + stack.shift(); + y = c2y + stack.shift(); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + break; + case 26: // vvcurveto + if (stack.length % 2) { + x += stack.shift(); + } + + while (stack.length > 0) { + c1x = x; + c1y = y + stack.shift(); + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + x = c2x; + y = c2y + stack.shift(); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + } + + break; + case 27: // hhcurveto + if (stack.length % 2) { + y += stack.shift(); + } + + while (stack.length > 0) { + c1x = x + stack.shift(); + c1y = y; + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + x = c2x + stack.shift(); + y = c2y; + p.curveTo(c1x, c1y, c2x, c2y, x, y); + } + + break; + case 28: // shortint + b1 = code[i]; + b2 = code[i + 1]; + stack.push(((b1 << 24) | (b2 << 16)) >> 16); + i += 2; + break; + case 29: // callgsubr + codeIndex = stack.pop() + font.gsubrsBias; + subrCode = font.gsubrs[codeIndex]; + if (subrCode) { + parse$$1(subrCode); + } + + break; + case 30: // vhcurveto + while (stack.length > 0) { + c1x = x; + c1y = y + stack.shift(); + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + x = c2x + stack.shift(); + y = c2y + (stack.length === 1 ? stack.shift() : 0); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + if (stack.length === 0) { + break; + } + + c1x = x + stack.shift(); + c1y = y; + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + y = c2y + stack.shift(); + x = c2x + (stack.length === 1 ? stack.shift() : 0); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + } + + break; + case 31: // hvcurveto + while (stack.length > 0) { + c1x = x + stack.shift(); + c1y = y; + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + y = c2y + stack.shift(); + x = c2x + (stack.length === 1 ? stack.shift() : 0); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + if (stack.length === 0) { + break; + } + + c1x = x; + c1y = y + stack.shift(); + c2x = c1x + stack.shift(); + c2y = c1y + stack.shift(); + x = c2x + stack.shift(); + y = c2y + (stack.length === 1 ? stack.shift() : 0); + p.curveTo(c1x, c1y, c2x, c2y, x, y); + } + + break; + default: + if (v < 32) { + console.log('Glyph ' + glyph.index + ': unknown operator ' + v); + } else if (v < 247) { + stack.push(v - 139); + } else if (v < 251) { + b1 = code[i]; + i += 1; + stack.push((v - 247) * 256 + b1 + 108); + } else if (v < 255) { + b1 = code[i]; + i += 1; + stack.push(-(v - 251) * 256 - b1 - 108); + } else { + b1 = code[i]; + b2 = code[i + 1]; + b3 = code[i + 2]; + b4 = code[i + 3]; + i += 4; + stack.push(((b1 << 24) | (b2 << 16) | (b3 << 8) | b4) / 65536); + } + } + } + } + + parse$$1(code); + + glyph.advanceWidth = width; + return p; + } + + function parseCFFFDSelect(data, start, nGlyphs, fdArrayCount) { + var fdSelect = []; + var fdIndex; + var parser = new parse.Parser(data, start); + var format = parser.parseCard8(); + if (format === 0) { + // Simple list of nGlyphs elements + for (var iGid = 0; iGid < nGlyphs; iGid++) { + fdIndex = parser.parseCard8(); + if (fdIndex >= fdArrayCount) { + throw new Error('CFF table CID Font FDSelect has bad FD index value ' + fdIndex + ' (FD count ' + fdArrayCount + ')'); + } + fdSelect.push(fdIndex); + } + } else if (format === 3) { + // Ranges + var nRanges = parser.parseCard16(); + var first = parser.parseCard16(); + if (first !== 0) { + throw new Error('CFF Table CID Font FDSelect format 3 range has bad initial GID ' + first); + } + var next; + for (var iRange = 0; iRange < nRanges; iRange++) { + fdIndex = parser.parseCard8(); + next = parser.parseCard16(); + if (fdIndex >= fdArrayCount) { + throw new Error('CFF table CID Font FDSelect has bad FD index value ' + fdIndex + ' (FD count ' + fdArrayCount + ')'); + } + if (next > nGlyphs) { + throw new Error('CFF Table CID Font FDSelect format 3 range has bad GID ' + next); + } + for (; first < next; first++) { + fdSelect.push(fdIndex); + } + first = next; + } + if (next !== nGlyphs) { + throw new Error('CFF Table CID Font FDSelect format 3 range has bad final GID ' + next); + } + } else { + throw new Error('CFF Table CID Font FDSelect table has unsupported format ' + format); + } + return fdSelect; + } + + // Parse the `CFF` table, which contains the glyph outlines in PostScript format. + function parseCFFTable(data, start, font) { + font.tables.cff = {}; + var header = parseCFFHeader(data, start); + var nameIndex = parseCFFIndex(data, header.endOffset, parse.bytesToString); + var topDictIndex = parseCFFIndex(data, nameIndex.endOffset); + var stringIndex = parseCFFIndex(data, topDictIndex.endOffset, parse.bytesToString); + var globalSubrIndex = parseCFFIndex(data, stringIndex.endOffset); + font.gsubrs = globalSubrIndex.objects; + font.gsubrsBias = calcCFFSubroutineBias(font.gsubrs); + + var topDictArray = gatherCFFTopDicts(data, start, topDictIndex.objects, stringIndex.objects); + if (topDictArray.length !== 1) { + throw new Error('CFF table has too many fonts in \'FontSet\' - count of fonts NameIndex.length = ' + topDictArray.length); + } + + var topDict = topDictArray[0]; + font.tables.cff.topDict = topDict; + + if (topDict._privateDict) { + font.defaultWidthX = topDict._privateDict.defaultWidthX; + font.nominalWidthX = topDict._privateDict.nominalWidthX; + } + + if (topDict.ros[0] !== undefined && topDict.ros[1] !== undefined) { + font.isCIDFont = true; + } + + if (font.isCIDFont) { + var fdArrayOffset = topDict.fdArray; + var fdSelectOffset = topDict.fdSelect; + if (fdArrayOffset === 0 || fdSelectOffset === 0) { + throw new Error('Font is marked as a CID font, but FDArray and/or FDSelect information is missing'); + } + fdArrayOffset += start; + var fdArrayIndex = parseCFFIndex(data, fdArrayOffset); + var fdArray = gatherCFFTopDicts(data, start, fdArrayIndex.objects, stringIndex.objects); + topDict._fdArray = fdArray; + fdSelectOffset += start; + topDict._fdSelect = parseCFFFDSelect(data, fdSelectOffset, font.numGlyphs, fdArray.length); + } + + var privateDictOffset = start + topDict.private[1]; + var privateDict = parseCFFPrivateDict(data, privateDictOffset, topDict.private[0], stringIndex.objects); + font.defaultWidthX = privateDict.defaultWidthX; + font.nominalWidthX = privateDict.nominalWidthX; + + if (privateDict.subrs !== 0) { + var subrOffset = privateDictOffset + privateDict.subrs; + var subrIndex = parseCFFIndex(data, subrOffset); + font.subrs = subrIndex.objects; + font.subrsBias = calcCFFSubroutineBias(font.subrs); + } else { + font.subrs = []; + font.subrsBias = 0; + } + + // Offsets in the top dict are relative to the beginning of the CFF data, so add the CFF start offset. + var charStringsIndex = parseCFFIndex(data, start + topDict.charStrings); + font.nGlyphs = charStringsIndex.objects.length; + + var charset = parseCFFCharset(data, start + topDict.charset, font.nGlyphs, stringIndex.objects); + if (topDict.encoding === 0) { + // Standard encoding + font.cffEncoding = new CffEncoding(cffStandardEncoding, charset); + } else if (topDict.encoding === 1) { + // Expert encoding + font.cffEncoding = new CffEncoding(cffExpertEncoding, charset); + } else { + font.cffEncoding = parseCFFEncoding(data, start + topDict.encoding, charset); + } + + // Prefer the CMAP encoding to the CFF encoding. + font.encoding = font.encoding || font.cffEncoding; + + font.glyphs = new glyphset.GlyphSet(font); + for (var i = 0; i < font.nGlyphs; i += 1) { + var charString = charStringsIndex.objects[i]; + font.glyphs.push(i, glyphset.cffGlyphLoader(font, i, parseCFFCharstring, charString)); + } + } + + // Convert a string to a String ID (SID). + // The list of strings is modified in place. + function encodeString(s, strings) { + var sid; + + // Is the string in the CFF standard strings? + var i = cffStandardStrings.indexOf(s); + if (i >= 0) { + sid = i; + } + + // Is the string already in the string index? + i = strings.indexOf(s); + if (i >= 0) { + sid = i + cffStandardStrings.length; + } else { + sid = cffStandardStrings.length + strings.length; + strings.push(s); + } + + return sid; + } + + function makeHeader() { + return new table.Record('Header', [ + {name: 'major', type: 'Card8', value: 1}, + {name: 'minor', type: 'Card8', value: 0}, + {name: 'hdrSize', type: 'Card8', value: 4}, + {name: 'major', type: 'Card8', value: 1} + ]); + } + + function makeNameIndex(fontNames) { + var t = new table.Record('Name INDEX', [ + {name: 'names', type: 'INDEX', value: []} + ]); + t.names = []; + for (var i = 0; i < fontNames.length; i += 1) { + t.names.push({name: 'name_' + i, type: 'NAME', value: fontNames[i]}); + } + + return t; + } + + // Given a dictionary's metadata, create a DICT structure. + function makeDict(meta, attrs, strings) { + var m = {}; + for (var i = 0; i < meta.length; i += 1) { + var entry = meta[i]; + var value = attrs[entry.name]; + if (value !== undefined && !equals(value, entry.value)) { + if (entry.type === 'SID') { + value = encodeString(value, strings); + } + + m[entry.op] = {name: entry.name, type: entry.type, value: value}; + } + } + + return m; + } + + // The Top DICT houses the global font attributes. + function makeTopDict(attrs, strings) { + var t = new table.Record('Top DICT', [ + {name: 'dict', type: 'DICT', value: {}} + ]); + t.dict = makeDict(TOP_DICT_META, attrs, strings); + return t; + } + + function makeTopDictIndex(topDict) { + var t = new table.Record('Top DICT INDEX', [ + {name: 'topDicts', type: 'INDEX', value: []} + ]); + t.topDicts = [{name: 'topDict_0', type: 'TABLE', value: topDict}]; + return t; + } + + function makeStringIndex(strings) { + var t = new table.Record('String INDEX', [ + {name: 'strings', type: 'INDEX', value: []} + ]); + t.strings = []; + for (var i = 0; i < strings.length; i += 1) { + t.strings.push({name: 'string_' + i, type: 'STRING', value: strings[i]}); + } + + return t; + } + + function makeGlobalSubrIndex() { + // Currently we don't use subroutines. + return new table.Record('Global Subr INDEX', [ + {name: 'subrs', type: 'INDEX', value: []} + ]); + } + + function makeCharsets(glyphNames, strings) { + var t = new table.Record('Charsets', [ + {name: 'format', type: 'Card8', value: 0} + ]); + for (var i = 0; i < glyphNames.length; i += 1) { + var glyphName = glyphNames[i]; + var glyphSID = encodeString(glyphName, strings); + t.fields.push({name: 'glyph_' + i, type: 'SID', value: glyphSID}); + } + + return t; + } + + function glyphToOps(glyph) { + var ops = []; + var path = glyph.path; + ops.push({name: 'width', type: 'NUMBER', value: glyph.advanceWidth}); + var x = 0; + var y = 0; + for (var i = 0; i < path.commands.length; i += 1) { + var dx = (void 0); + var dy = (void 0); + var cmd = path.commands[i]; + if (cmd.type === 'Q') { + // CFF only supports bézier curves, so convert the quad to a bézier. + var _13 = 1 / 3; + var _23 = 2 / 3; + + // We're going to create a new command so we don't change the original path. + cmd = { + type: 'C', + x: cmd.x, + y: cmd.y, + x1: _13 * x + _23 * cmd.x1, + y1: _13 * y + _23 * cmd.y1, + x2: _13 * cmd.x + _23 * cmd.x1, + y2: _13 * cmd.y + _23 * cmd.y1 + }; + } + + if (cmd.type === 'M') { + dx = Math.round(cmd.x - x); + dy = Math.round(cmd.y - y); + ops.push({name: 'dx', type: 'NUMBER', value: dx}); + ops.push({name: 'dy', type: 'NUMBER', value: dy}); + ops.push({name: 'rmoveto', type: 'OP', value: 21}); + x = Math.round(cmd.x); + y = Math.round(cmd.y); + } else if (cmd.type === 'L') { + dx = Math.round(cmd.x - x); + dy = Math.round(cmd.y - y); + ops.push({name: 'dx', type: 'NUMBER', value: dx}); + ops.push({name: 'dy', type: 'NUMBER', value: dy}); + ops.push({name: 'rlineto', type: 'OP', value: 5}); + x = Math.round(cmd.x); + y = Math.round(cmd.y); + } else if (cmd.type === 'C') { + var dx1 = Math.round(cmd.x1 - x); + var dy1 = Math.round(cmd.y1 - y); + var dx2 = Math.round(cmd.x2 - cmd.x1); + var dy2 = Math.round(cmd.y2 - cmd.y1); + dx = Math.round(cmd.x - cmd.x2); + dy = Math.round(cmd.y - cmd.y2); + ops.push({name: 'dx1', type: 'NUMBER', value: dx1}); + ops.push({name: 'dy1', type: 'NUMBER', value: dy1}); + ops.push({name: 'dx2', type: 'NUMBER', value: dx2}); + ops.push({name: 'dy2', type: 'NUMBER', value: dy2}); + ops.push({name: 'dx', type: 'NUMBER', value: dx}); + ops.push({name: 'dy', type: 'NUMBER', value: dy}); + ops.push({name: 'rrcurveto', type: 'OP', value: 8}); + x = Math.round(cmd.x); + y = Math.round(cmd.y); + } + + // Contours are closed automatically. + } + + ops.push({name: 'endchar', type: 'OP', value: 14}); + return ops; + } + + function makeCharStringsIndex(glyphs) { + var t = new table.Record('CharStrings INDEX', [ + {name: 'charStrings', type: 'INDEX', value: []} + ]); + + for (var i = 0; i < glyphs.length; i += 1) { + var glyph = glyphs.get(i); + var ops = glyphToOps(glyph); + t.charStrings.push({name: glyph.name, type: 'CHARSTRING', value: ops}); + } + + return t; + } + + function makePrivateDict(attrs, strings) { + var t = new table.Record('Private DICT', [ + {name: 'dict', type: 'DICT', value: {}} + ]); + t.dict = makeDict(PRIVATE_DICT_META, attrs, strings); + return t; + } + + function makeCFFTable(glyphs, options) { + var t = new table.Table('CFF ', [ + {name: 'header', type: 'RECORD'}, + {name: 'nameIndex', type: 'RECORD'}, + {name: 'topDictIndex', type: 'RECORD'}, + {name: 'stringIndex', type: 'RECORD'}, + {name: 'globalSubrIndex', type: 'RECORD'}, + {name: 'charsets', type: 'RECORD'}, + {name: 'charStringsIndex', type: 'RECORD'}, + {name: 'privateDict', type: 'RECORD'} + ]); + + var fontScale = 1 / options.unitsPerEm; + // We use non-zero values for the offsets so that the DICT encodes them. + // This is important because the size of the Top DICT plays a role in offset calculation, + // and the size shouldn't change after we've written correct offsets. + var attrs = { + version: options.version, + fullName: options.fullName, + familyName: options.familyName, + weight: options.weightName, + fontBBox: options.fontBBox || [0, 0, 0, 0], + fontMatrix: [fontScale, 0, 0, fontScale, 0, 0], + charset: 999, + encoding: 0, + charStrings: 999, + private: [0, 999] + }; + + var privateAttrs = {}; + + var glyphNames = []; + var glyph; + + // Skip first glyph (.notdef) + for (var i = 1; i < glyphs.length; i += 1) { + glyph = glyphs.get(i); + glyphNames.push(glyph.name); + } + + var strings = []; + + t.header = makeHeader(); + t.nameIndex = makeNameIndex([options.postScriptName]); + var topDict = makeTopDict(attrs, strings); + t.topDictIndex = makeTopDictIndex(topDict); + t.globalSubrIndex = makeGlobalSubrIndex(); + t.charsets = makeCharsets(glyphNames, strings); + t.charStringsIndex = makeCharStringsIndex(glyphs); + t.privateDict = makePrivateDict(privateAttrs, strings); + + // Needs to come at the end, to encode all custom strings used in the font. + t.stringIndex = makeStringIndex(strings); + + var startOffset = t.header.sizeOf() + + t.nameIndex.sizeOf() + + t.topDictIndex.sizeOf() + + t.stringIndex.sizeOf() + + t.globalSubrIndex.sizeOf(); + attrs.charset = startOffset; + + // We use the CFF standard encoding; proper encoding will be handled in cmap. + attrs.encoding = 0; + attrs.charStrings = attrs.charset + t.charsets.sizeOf(); + attrs.private[1] = attrs.charStrings + t.charStringsIndex.sizeOf(); + + // Recreate the Top DICT INDEX with the correct offsets. + topDict = makeTopDict(attrs, strings); + t.topDictIndex = makeTopDictIndex(topDict); + + return t; + } + + var cff = { parse: parseCFFTable, make: makeCFFTable }; + + // The `head` table contains global information about the font. + + // Parse the header `head` table + function parseHeadTable(data, start) { + var head = {}; + var p = new parse.Parser(data, start); + head.version = p.parseVersion(); + head.fontRevision = Math.round(p.parseFixed() * 1000) / 1000; + head.checkSumAdjustment = p.parseULong(); + head.magicNumber = p.parseULong(); + check.argument(head.magicNumber === 0x5F0F3CF5, 'Font header has wrong magic number.'); + head.flags = p.parseUShort(); + head.unitsPerEm = p.parseUShort(); + head.created = p.parseLongDateTime(); + head.modified = p.parseLongDateTime(); + head.xMin = p.parseShort(); + head.yMin = p.parseShort(); + head.xMax = p.parseShort(); + head.yMax = p.parseShort(); + head.macStyle = p.parseUShort(); + head.lowestRecPPEM = p.parseUShort(); + head.fontDirectionHint = p.parseShort(); + head.indexToLocFormat = p.parseShort(); + head.glyphDataFormat = p.parseShort(); + return head; + } + + function makeHeadTable(options) { + // Apple Mac timestamp epoch is 01/01/1904 not 01/01/1970 + var timestamp = Math.round(new Date().getTime() / 1000) + 2082844800; + var createdTimestamp = timestamp; + + if (options.createdTimestamp) { + createdTimestamp = options.createdTimestamp + 2082844800; + } + + return new table.Table('head', [ + {name: 'version', type: 'FIXED', value: 0x00010000}, + {name: 'fontRevision', type: 'FIXED', value: 0x00010000}, + {name: 'checkSumAdjustment', type: 'ULONG', value: 0}, + {name: 'magicNumber', type: 'ULONG', value: 0x5F0F3CF5}, + {name: 'flags', type: 'USHORT', value: 0}, + {name: 'unitsPerEm', type: 'USHORT', value: 1000}, + {name: 'created', type: 'LONGDATETIME', value: createdTimestamp}, + {name: 'modified', type: 'LONGDATETIME', value: timestamp}, + {name: 'xMin', type: 'SHORT', value: 0}, + {name: 'yMin', type: 'SHORT', value: 0}, + {name: 'xMax', type: 'SHORT', value: 0}, + {name: 'yMax', type: 'SHORT', value: 0}, + {name: 'macStyle', type: 'USHORT', value: 0}, + {name: 'lowestRecPPEM', type: 'USHORT', value: 0}, + {name: 'fontDirectionHint', type: 'SHORT', value: 2}, + {name: 'indexToLocFormat', type: 'SHORT', value: 0}, + {name: 'glyphDataFormat', type: 'SHORT', value: 0} + ], options); + } + + var head = { parse: parseHeadTable, make: makeHeadTable }; + + // The `hhea` table contains information for horizontal layout. + + // Parse the horizontal header `hhea` table + function parseHheaTable(data, start) { + var hhea = {}; + var p = new parse.Parser(data, start); + hhea.version = p.parseVersion(); + hhea.ascender = p.parseShort(); + hhea.descender = p.parseShort(); + hhea.lineGap = p.parseShort(); + hhea.advanceWidthMax = p.parseUShort(); + hhea.minLeftSideBearing = p.parseShort(); + hhea.minRightSideBearing = p.parseShort(); + hhea.xMaxExtent = p.parseShort(); + hhea.caretSlopeRise = p.parseShort(); + hhea.caretSlopeRun = p.parseShort(); + hhea.caretOffset = p.parseShort(); + p.relativeOffset += 8; + hhea.metricDataFormat = p.parseShort(); + hhea.numberOfHMetrics = p.parseUShort(); + return hhea; + } + + function makeHheaTable(options) { + return new table.Table('hhea', [ + {name: 'version', type: 'FIXED', value: 0x00010000}, + {name: 'ascender', type: 'FWORD', value: 0}, + {name: 'descender', type: 'FWORD', value: 0}, + {name: 'lineGap', type: 'FWORD', value: 0}, + {name: 'advanceWidthMax', type: 'UFWORD', value: 0}, + {name: 'minLeftSideBearing', type: 'FWORD', value: 0}, + {name: 'minRightSideBearing', type: 'FWORD', value: 0}, + {name: 'xMaxExtent', type: 'FWORD', value: 0}, + {name: 'caretSlopeRise', type: 'SHORT', value: 1}, + {name: 'caretSlopeRun', type: 'SHORT', value: 0}, + {name: 'caretOffset', type: 'SHORT', value: 0}, + {name: 'reserved1', type: 'SHORT', value: 0}, + {name: 'reserved2', type: 'SHORT', value: 0}, + {name: 'reserved3', type: 'SHORT', value: 0}, + {name: 'reserved4', type: 'SHORT', value: 0}, + {name: 'metricDataFormat', type: 'SHORT', value: 0}, + {name: 'numberOfHMetrics', type: 'USHORT', value: 0} + ], options); + } + + var hhea = { parse: parseHheaTable, make: makeHheaTable }; + + // The `hmtx` table contains the horizontal metrics for all glyphs. + + // Parse the `hmtx` table, which contains the horizontal metrics for all glyphs. + // This function augments the glyph array, adding the advanceWidth and leftSideBearing to each glyph. + function parseHmtxTable(data, start, numMetrics, numGlyphs, glyphs) { + var advanceWidth; + var leftSideBearing; + var p = new parse.Parser(data, start); + for (var i = 0; i < numGlyphs; i += 1) { + // If the font is monospaced, only one entry is needed. This last entry applies to all subsequent glyphs. + if (i < numMetrics) { + advanceWidth = p.parseUShort(); + leftSideBearing = p.parseShort(); + } + + var glyph = glyphs.get(i); + glyph.advanceWidth = advanceWidth; + glyph.leftSideBearing = leftSideBearing; + } + } + + function makeHmtxTable(glyphs) { + var t = new table.Table('hmtx', []); + for (var i = 0; i < glyphs.length; i += 1) { + var glyph = glyphs.get(i); + var advanceWidth = glyph.advanceWidth || 0; + var leftSideBearing = glyph.leftSideBearing || 0; + t.fields.push({name: 'advanceWidth_' + i, type: 'USHORT', value: advanceWidth}); + t.fields.push({name: 'leftSideBearing_' + i, type: 'SHORT', value: leftSideBearing}); + } + + return t; + } + + var hmtx = { parse: parseHmtxTable, make: makeHmtxTable }; + + // The `ltag` table stores IETF BCP-47 language tags. It allows supporting + + function makeLtagTable(tags) { + var result = new table.Table('ltag', [ + {name: 'version', type: 'ULONG', value: 1}, + {name: 'flags', type: 'ULONG', value: 0}, + {name: 'numTags', type: 'ULONG', value: tags.length} + ]); + + var stringPool = ''; + var stringPoolOffset = 12 + tags.length * 4; + for (var i = 0; i < tags.length; ++i) { + var pos = stringPool.indexOf(tags[i]); + if (pos < 0) { + pos = stringPool.length; + stringPool += tags[i]; + } + + result.fields.push({name: 'offset ' + i, type: 'USHORT', value: stringPoolOffset + pos}); + result.fields.push({name: 'length ' + i, type: 'USHORT', value: tags[i].length}); + } + + result.fields.push({name: 'stringPool', type: 'CHARARRAY', value: stringPool}); + return result; + } + + function parseLtagTable(data, start) { + var p = new parse.Parser(data, start); + var tableVersion = p.parseULong(); + check.argument(tableVersion === 1, 'Unsupported ltag table version.'); + // The 'ltag' specification does not define any flags; skip the field. + p.skip('uLong', 1); + var numTags = p.parseULong(); + + var tags = []; + for (var i = 0; i < numTags; i++) { + var tag = ''; + var offset = start + p.parseUShort(); + var length = p.parseUShort(); + for (var j = offset; j < offset + length; ++j) { + tag += String.fromCharCode(data.getInt8(j)); + } + + tags.push(tag); + } + + return tags; + } + + var ltag = { make: makeLtagTable, parse: parseLtagTable }; + + // The `maxp` table establishes the memory requirements for the font. + + // Parse the maximum profile `maxp` table. + function parseMaxpTable(data, start) { + var maxp = {}; + var p = new parse.Parser(data, start); + maxp.version = p.parseVersion(); + maxp.numGlyphs = p.parseUShort(); + if (maxp.version === 1.0) { + maxp.maxPoints = p.parseUShort(); + maxp.maxContours = p.parseUShort(); + maxp.maxCompositePoints = p.parseUShort(); + maxp.maxCompositeContours = p.parseUShort(); + maxp.maxZones = p.parseUShort(); + maxp.maxTwilightPoints = p.parseUShort(); + maxp.maxStorage = p.parseUShort(); + maxp.maxFunctionDefs = p.parseUShort(); + maxp.maxInstructionDefs = p.parseUShort(); + maxp.maxStackElements = p.parseUShort(); + maxp.maxSizeOfInstructions = p.parseUShort(); + maxp.maxComponentElements = p.parseUShort(); + maxp.maxComponentDepth = p.parseUShort(); + } + + return maxp; + } + + function makeMaxpTable(numGlyphs) { + return new table.Table('maxp', [ + {name: 'version', type: 'FIXED', value: 0x00005000}, + {name: 'numGlyphs', type: 'USHORT', value: numGlyphs} + ]); + } + + var maxp = { parse: parseMaxpTable, make: makeMaxpTable }; + + // The `name` naming table. + + // NameIDs for the name table. + var nameTableNames = [ + 'copyright', // 0 + 'fontFamily', // 1 + 'fontSubfamily', // 2 + 'uniqueID', // 3 + 'fullName', // 4 + 'version', // 5 + 'postScriptName', // 6 + 'trademark', // 7 + 'manufacturer', // 8 + 'designer', // 9 + 'description', // 10 + 'manufacturerURL', // 11 + 'designerURL', // 12 + 'license', // 13 + 'licenseURL', // 14 + 'reserved', // 15 + 'preferredFamily', // 16 + 'preferredSubfamily', // 17 + 'compatibleFullName', // 18 + 'sampleText', // 19 + 'postScriptFindFontName', // 20 + 'wwsFamily', // 21 + 'wwsSubfamily' // 22 + ]; + + var macLanguages = { + 0: 'en', + 1: 'fr', + 2: 'de', + 3: 'it', + 4: 'nl', + 5: 'sv', + 6: 'es', + 7: 'da', + 8: 'pt', + 9: 'no', + 10: 'he', + 11: 'ja', + 12: 'ar', + 13: 'fi', + 14: 'el', + 15: 'is', + 16: 'mt', + 17: 'tr', + 18: 'hr', + 19: 'zh-Hant', + 20: 'ur', + 21: 'hi', + 22: 'th', + 23: 'ko', + 24: 'lt', + 25: 'pl', + 26: 'hu', + 27: 'es', + 28: 'lv', + 29: 'se', + 30: 'fo', + 31: 'fa', + 32: 'ru', + 33: 'zh', + 34: 'nl-BE', + 35: 'ga', + 36: 'sq', + 37: 'ro', + 38: 'cz', + 39: 'sk', + 40: 'si', + 41: 'yi', + 42: 'sr', + 43: 'mk', + 44: 'bg', + 45: 'uk', + 46: 'be', + 47: 'uz', + 48: 'kk', + 49: 'az-Cyrl', + 50: 'az-Arab', + 51: 'hy', + 52: 'ka', + 53: 'mo', + 54: 'ky', + 55: 'tg', + 56: 'tk', + 57: 'mn-CN', + 58: 'mn', + 59: 'ps', + 60: 'ks', + 61: 'ku', + 62: 'sd', + 63: 'bo', + 64: 'ne', + 65: 'sa', + 66: 'mr', + 67: 'bn', + 68: 'as', + 69: 'gu', + 70: 'pa', + 71: 'or', + 72: 'ml', + 73: 'kn', + 74: 'ta', + 75: 'te', + 76: 'si', + 77: 'my', + 78: 'km', + 79: 'lo', + 80: 'vi', + 81: 'id', + 82: 'tl', + 83: 'ms', + 84: 'ms-Arab', + 85: 'am', + 86: 'ti', + 87: 'om', + 88: 'so', + 89: 'sw', + 90: 'rw', + 91: 'rn', + 92: 'ny', + 93: 'mg', + 94: 'eo', + 128: 'cy', + 129: 'eu', + 130: 'ca', + 131: 'la', + 132: 'qu', + 133: 'gn', + 134: 'ay', + 135: 'tt', + 136: 'ug', + 137: 'dz', + 138: 'jv', + 139: 'su', + 140: 'gl', + 141: 'af', + 142: 'br', + 143: 'iu', + 144: 'gd', + 145: 'gv', + 146: 'ga', + 147: 'to', + 148: 'el-polyton', + 149: 'kl', + 150: 'az', + 151: 'nn' + }; + + // MacOS language ID → MacOS script ID + // + // Note that the script ID is not sufficient to determine what encoding + // to use in TrueType files. For some languages, MacOS used a modification + // of a mainstream script. For example, an Icelandic name would be stored + // with smRoman in the TrueType naming table, but the actual encoding + // is a special Icelandic version of the normal Macintosh Roman encoding. + // As another example, Inuktitut uses an 8-bit encoding for Canadian Aboriginal + // Syllables but MacOS had run out of available script codes, so this was + // done as a (pretty radical) "modification" of Ethiopic. + // + // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/Readme.txt + var macLanguageToScript = { + 0: 0, // langEnglish → smRoman + 1: 0, // langFrench → smRoman + 2: 0, // langGerman → smRoman + 3: 0, // langItalian → smRoman + 4: 0, // langDutch → smRoman + 5: 0, // langSwedish → smRoman + 6: 0, // langSpanish → smRoman + 7: 0, // langDanish → smRoman + 8: 0, // langPortuguese → smRoman + 9: 0, // langNorwegian → smRoman + 10: 5, // langHebrew → smHebrew + 11: 1, // langJapanese → smJapanese + 12: 4, // langArabic → smArabic + 13: 0, // langFinnish → smRoman + 14: 6, // langGreek → smGreek + 15: 0, // langIcelandic → smRoman (modified) + 16: 0, // langMaltese → smRoman + 17: 0, // langTurkish → smRoman (modified) + 18: 0, // langCroatian → smRoman (modified) + 19: 2, // langTradChinese → smTradChinese + 20: 4, // langUrdu → smArabic + 21: 9, // langHindi → smDevanagari + 22: 21, // langThai → smThai + 23: 3, // langKorean → smKorean + 24: 29, // langLithuanian → smCentralEuroRoman + 25: 29, // langPolish → smCentralEuroRoman + 26: 29, // langHungarian → smCentralEuroRoman + 27: 29, // langEstonian → smCentralEuroRoman + 28: 29, // langLatvian → smCentralEuroRoman + 29: 0, // langSami → smRoman + 30: 0, // langFaroese → smRoman (modified) + 31: 4, // langFarsi → smArabic (modified) + 32: 7, // langRussian → smCyrillic + 33: 25, // langSimpChinese → smSimpChinese + 34: 0, // langFlemish → smRoman + 35: 0, // langIrishGaelic → smRoman (modified) + 36: 0, // langAlbanian → smRoman + 37: 0, // langRomanian → smRoman (modified) + 38: 29, // langCzech → smCentralEuroRoman + 39: 29, // langSlovak → smCentralEuroRoman + 40: 0, // langSlovenian → smRoman (modified) + 41: 5, // langYiddish → smHebrew + 42: 7, // langSerbian → smCyrillic + 43: 7, // langMacedonian → smCyrillic + 44: 7, // langBulgarian → smCyrillic + 45: 7, // langUkrainian → smCyrillic (modified) + 46: 7, // langByelorussian → smCyrillic + 47: 7, // langUzbek → smCyrillic + 48: 7, // langKazakh → smCyrillic + 49: 7, // langAzerbaijani → smCyrillic + 50: 4, // langAzerbaijanAr → smArabic + 51: 24, // langArmenian → smArmenian + 52: 23, // langGeorgian → smGeorgian + 53: 7, // langMoldavian → smCyrillic + 54: 7, // langKirghiz → smCyrillic + 55: 7, // langTajiki → smCyrillic + 56: 7, // langTurkmen → smCyrillic + 57: 27, // langMongolian → smMongolian + 58: 7, // langMongolianCyr → smCyrillic + 59: 4, // langPashto → smArabic + 60: 4, // langKurdish → smArabic + 61: 4, // langKashmiri → smArabic + 62: 4, // langSindhi → smArabic + 63: 26, // langTibetan → smTibetan + 64: 9, // langNepali → smDevanagari + 65: 9, // langSanskrit → smDevanagari + 66: 9, // langMarathi → smDevanagari + 67: 13, // langBengali → smBengali + 68: 13, // langAssamese → smBengali + 69: 11, // langGujarati → smGujarati + 70: 10, // langPunjabi → smGurmukhi + 71: 12, // langOriya → smOriya + 72: 17, // langMalayalam → smMalayalam + 73: 16, // langKannada → smKannada + 74: 14, // langTamil → smTamil + 75: 15, // langTelugu → smTelugu + 76: 18, // langSinhalese → smSinhalese + 77: 19, // langBurmese → smBurmese + 78: 20, // langKhmer → smKhmer + 79: 22, // langLao → smLao + 80: 30, // langVietnamese → smVietnamese + 81: 0, // langIndonesian → smRoman + 82: 0, // langTagalog → smRoman + 83: 0, // langMalayRoman → smRoman + 84: 4, // langMalayArabic → smArabic + 85: 28, // langAmharic → smEthiopic + 86: 28, // langTigrinya → smEthiopic + 87: 28, // langOromo → smEthiopic + 88: 0, // langSomali → smRoman + 89: 0, // langSwahili → smRoman + 90: 0, // langKinyarwanda → smRoman + 91: 0, // langRundi → smRoman + 92: 0, // langNyanja → smRoman + 93: 0, // langMalagasy → smRoman + 94: 0, // langEsperanto → smRoman + 128: 0, // langWelsh → smRoman (modified) + 129: 0, // langBasque → smRoman + 130: 0, // langCatalan → smRoman + 131: 0, // langLatin → smRoman + 132: 0, // langQuechua → smRoman + 133: 0, // langGuarani → smRoman + 134: 0, // langAymara → smRoman + 135: 7, // langTatar → smCyrillic + 136: 4, // langUighur → smArabic + 137: 26, // langDzongkha → smTibetan + 138: 0, // langJavaneseRom → smRoman + 139: 0, // langSundaneseRom → smRoman + 140: 0, // langGalician → smRoman + 141: 0, // langAfrikaans → smRoman + 142: 0, // langBreton → smRoman (modified) + 143: 28, // langInuktitut → smEthiopic (modified) + 144: 0, // langScottishGaelic → smRoman (modified) + 145: 0, // langManxGaelic → smRoman (modified) + 146: 0, // langIrishGaelicScript → smRoman (modified) + 147: 0, // langTongan → smRoman + 148: 6, // langGreekAncient → smRoman + 149: 0, // langGreenlandic → smRoman + 150: 0, // langAzerbaijanRoman → smRoman + 151: 0 // langNynorsk → smRoman + }; + + // While Microsoft indicates a region/country for all its language + // IDs, we omit the region code if it's equal to the "most likely + // region subtag" according to Unicode CLDR. For scripts, we omit + // the subtag if it is equal to the Suppress-Script entry in the + // IANA language subtag registry for IETF BCP 47. + // + // For example, Microsoft states that its language code 0x041A is + // Croatian in Croatia. We transform this to the BCP 47 language code 'hr' + // and not 'hr-HR' because Croatia is the default country for Croatian, + // according to Unicode CLDR. As another example, Microsoft states + // that 0x101A is Croatian (Latin) in Bosnia-Herzegovina. We transform + // this to 'hr-BA' and not 'hr-Latn-BA' because Latin is the default script + // for the Croatian language, according to IANA. + // + // http://www.unicode.org/cldr/charts/latest/supplemental/likely_subtags.html + // http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry + var windowsLanguages = { + 0x0436: 'af', + 0x041C: 'sq', + 0x0484: 'gsw', + 0x045E: 'am', + 0x1401: 'ar-DZ', + 0x3C01: 'ar-BH', + 0x0C01: 'ar', + 0x0801: 'ar-IQ', + 0x2C01: 'ar-JO', + 0x3401: 'ar-KW', + 0x3001: 'ar-LB', + 0x1001: 'ar-LY', + 0x1801: 'ary', + 0x2001: 'ar-OM', + 0x4001: 'ar-QA', + 0x0401: 'ar-SA', + 0x2801: 'ar-SY', + 0x1C01: 'aeb', + 0x3801: 'ar-AE', + 0x2401: 'ar-YE', + 0x042B: 'hy', + 0x044D: 'as', + 0x082C: 'az-Cyrl', + 0x042C: 'az', + 0x046D: 'ba', + 0x042D: 'eu', + 0x0423: 'be', + 0x0845: 'bn', + 0x0445: 'bn-IN', + 0x201A: 'bs-Cyrl', + 0x141A: 'bs', + 0x047E: 'br', + 0x0402: 'bg', + 0x0403: 'ca', + 0x0C04: 'zh-HK', + 0x1404: 'zh-MO', + 0x0804: 'zh', + 0x1004: 'zh-SG', + 0x0404: 'zh-TW', + 0x0483: 'co', + 0x041A: 'hr', + 0x101A: 'hr-BA', + 0x0405: 'cs', + 0x0406: 'da', + 0x048C: 'prs', + 0x0465: 'dv', + 0x0813: 'nl-BE', + 0x0413: 'nl', + 0x0C09: 'en-AU', + 0x2809: 'en-BZ', + 0x1009: 'en-CA', + 0x2409: 'en-029', + 0x4009: 'en-IN', + 0x1809: 'en-IE', + 0x2009: 'en-JM', + 0x4409: 'en-MY', + 0x1409: 'en-NZ', + 0x3409: 'en-PH', + 0x4809: 'en-SG', + 0x1C09: 'en-ZA', + 0x2C09: 'en-TT', + 0x0809: 'en-GB', + 0x0409: 'en', + 0x3009: 'en-ZW', + 0x0425: 'et', + 0x0438: 'fo', + 0x0464: 'fil', + 0x040B: 'fi', + 0x080C: 'fr-BE', + 0x0C0C: 'fr-CA', + 0x040C: 'fr', + 0x140C: 'fr-LU', + 0x180C: 'fr-MC', + 0x100C: 'fr-CH', + 0x0462: 'fy', + 0x0456: 'gl', + 0x0437: 'ka', + 0x0C07: 'de-AT', + 0x0407: 'de', + 0x1407: 'de-LI', + 0x1007: 'de-LU', + 0x0807: 'de-CH', + 0x0408: 'el', + 0x046F: 'kl', + 0x0447: 'gu', + 0x0468: 'ha', + 0x040D: 'he', + 0x0439: 'hi', + 0x040E: 'hu', + 0x040F: 'is', + 0x0470: 'ig', + 0x0421: 'id', + 0x045D: 'iu', + 0x085D: 'iu-Latn', + 0x083C: 'ga', + 0x0434: 'xh', + 0x0435: 'zu', + 0x0410: 'it', + 0x0810: 'it-CH', + 0x0411: 'ja', + 0x044B: 'kn', + 0x043F: 'kk', + 0x0453: 'km', + 0x0486: 'quc', + 0x0487: 'rw', + 0x0441: 'sw', + 0x0457: 'kok', + 0x0412: 'ko', + 0x0440: 'ky', + 0x0454: 'lo', + 0x0426: 'lv', + 0x0427: 'lt', + 0x082E: 'dsb', + 0x046E: 'lb', + 0x042F: 'mk', + 0x083E: 'ms-BN', + 0x043E: 'ms', + 0x044C: 'ml', + 0x043A: 'mt', + 0x0481: 'mi', + 0x047A: 'arn', + 0x044E: 'mr', + 0x047C: 'moh', + 0x0450: 'mn', + 0x0850: 'mn-CN', + 0x0461: 'ne', + 0x0414: 'nb', + 0x0814: 'nn', + 0x0482: 'oc', + 0x0448: 'or', + 0x0463: 'ps', + 0x0415: 'pl', + 0x0416: 'pt', + 0x0816: 'pt-PT', + 0x0446: 'pa', + 0x046B: 'qu-BO', + 0x086B: 'qu-EC', + 0x0C6B: 'qu', + 0x0418: 'ro', + 0x0417: 'rm', + 0x0419: 'ru', + 0x243B: 'smn', + 0x103B: 'smj-NO', + 0x143B: 'smj', + 0x0C3B: 'se-FI', + 0x043B: 'se', + 0x083B: 'se-SE', + 0x203B: 'sms', + 0x183B: 'sma-NO', + 0x1C3B: 'sms', + 0x044F: 'sa', + 0x1C1A: 'sr-Cyrl-BA', + 0x0C1A: 'sr', + 0x181A: 'sr-Latn-BA', + 0x081A: 'sr-Latn', + 0x046C: 'nso', + 0x0432: 'tn', + 0x045B: 'si', + 0x041B: 'sk', + 0x0424: 'sl', + 0x2C0A: 'es-AR', + 0x400A: 'es-BO', + 0x340A: 'es-CL', + 0x240A: 'es-CO', + 0x140A: 'es-CR', + 0x1C0A: 'es-DO', + 0x300A: 'es-EC', + 0x440A: 'es-SV', + 0x100A: 'es-GT', + 0x480A: 'es-HN', + 0x080A: 'es-MX', + 0x4C0A: 'es-NI', + 0x180A: 'es-PA', + 0x3C0A: 'es-PY', + 0x280A: 'es-PE', + 0x500A: 'es-PR', + + // Microsoft has defined two different language codes for + // “Spanish with modern sorting” and “Spanish with traditional + // sorting”. This makes sense for collation APIs, and it would be + // possible to express this in BCP 47 language tags via Unicode + // extensions (eg., es-u-co-trad is Spanish with traditional + // sorting). However, for storing names in fonts, the distinction + // does not make sense, so we give “es” in both cases. + 0x0C0A: 'es', + 0x040A: 'es', + + 0x540A: 'es-US', + 0x380A: 'es-UY', + 0x200A: 'es-VE', + 0x081D: 'sv-FI', + 0x041D: 'sv', + 0x045A: 'syr', + 0x0428: 'tg', + 0x085F: 'tzm', + 0x0449: 'ta', + 0x0444: 'tt', + 0x044A: 'te', + 0x041E: 'th', + 0x0451: 'bo', + 0x041F: 'tr', + 0x0442: 'tk', + 0x0480: 'ug', + 0x0422: 'uk', + 0x042E: 'hsb', + 0x0420: 'ur', + 0x0843: 'uz-Cyrl', + 0x0443: 'uz', + 0x042A: 'vi', + 0x0452: 'cy', + 0x0488: 'wo', + 0x0485: 'sah', + 0x0478: 'ii', + 0x046A: 'yo' + }; + + // Returns a IETF BCP 47 language code, for example 'zh-Hant' + // for 'Chinese in the traditional script'. + function getLanguageCode(platformID, languageID, ltag) { + switch (platformID) { + case 0: // Unicode + if (languageID === 0xFFFF) { + return 'und'; + } else if (ltag) { + return ltag[languageID]; + } + + break; + + case 1: // Macintosh + return macLanguages[languageID]; + + case 3: // Windows + return windowsLanguages[languageID]; + } + + return undefined; + } + + var utf16 = 'utf-16'; + + // MacOS script ID → encoding. This table stores the default case, + // which can be overridden by macLanguageEncodings. + var macScriptEncodings = { + 0: 'macintosh', // smRoman + 1: 'x-mac-japanese', // smJapanese + 2: 'x-mac-chinesetrad', // smTradChinese + 3: 'x-mac-korean', // smKorean + 6: 'x-mac-greek', // smGreek + 7: 'x-mac-cyrillic', // smCyrillic + 9: 'x-mac-devanagai', // smDevanagari + 10: 'x-mac-gurmukhi', // smGurmukhi + 11: 'x-mac-gujarati', // smGujarati + 12: 'x-mac-oriya', // smOriya + 13: 'x-mac-bengali', // smBengali + 14: 'x-mac-tamil', // smTamil + 15: 'x-mac-telugu', // smTelugu + 16: 'x-mac-kannada', // smKannada + 17: 'x-mac-malayalam', // smMalayalam + 18: 'x-mac-sinhalese', // smSinhalese + 19: 'x-mac-burmese', // smBurmese + 20: 'x-mac-khmer', // smKhmer + 21: 'x-mac-thai', // smThai + 22: 'x-mac-lao', // smLao + 23: 'x-mac-georgian', // smGeorgian + 24: 'x-mac-armenian', // smArmenian + 25: 'x-mac-chinesesimp', // smSimpChinese + 26: 'x-mac-tibetan', // smTibetan + 27: 'x-mac-mongolian', // smMongolian + 28: 'x-mac-ethiopic', // smEthiopic + 29: 'x-mac-ce', // smCentralEuroRoman + 30: 'x-mac-vietnamese', // smVietnamese + 31: 'x-mac-extarabic' // smExtArabic + }; + + // MacOS language ID → encoding. This table stores the exceptional + // cases, which override macScriptEncodings. For writing MacOS naming + // tables, we need to emit a MacOS script ID. Therefore, we cannot + // merge macScriptEncodings into macLanguageEncodings. + // + // http://unicode.org/Public/MAPPINGS/VENDORS/APPLE/Readme.txt + var macLanguageEncodings = { + 15: 'x-mac-icelandic', // langIcelandic + 17: 'x-mac-turkish', // langTurkish + 18: 'x-mac-croatian', // langCroatian + 24: 'x-mac-ce', // langLithuanian + 25: 'x-mac-ce', // langPolish + 26: 'x-mac-ce', // langHungarian + 27: 'x-mac-ce', // langEstonian + 28: 'x-mac-ce', // langLatvian + 30: 'x-mac-icelandic', // langFaroese + 37: 'x-mac-romanian', // langRomanian + 38: 'x-mac-ce', // langCzech + 39: 'x-mac-ce', // langSlovak + 40: 'x-mac-ce', // langSlovenian + 143: 'x-mac-inuit', // langInuktitut + 146: 'x-mac-gaelic' // langIrishGaelicScript + }; + + function getEncoding(platformID, encodingID, languageID) { + switch (platformID) { + case 0: // Unicode + return utf16; + + case 1: // Apple Macintosh + return macLanguageEncodings[languageID] || macScriptEncodings[encodingID]; + + case 3: // Microsoft Windows + if (encodingID === 1 || encodingID === 10) { + return utf16; + } + + break; + } + + return undefined; + } + + // Parse the naming `name` table. + // FIXME: Format 1 additional fields are not supported yet. + // ltag is the content of the `ltag' table, such as ['en', 'zh-Hans', 'de-CH-1904']. + function parseNameTable(data, start, ltag) { + var name = {}; + var p = new parse.Parser(data, start); + var format = p.parseUShort(); + var count = p.parseUShort(); + var stringOffset = p.offset + p.parseUShort(); + for (var i = 0; i < count; i++) { + var platformID = p.parseUShort(); + var encodingID = p.parseUShort(); + var languageID = p.parseUShort(); + var nameID = p.parseUShort(); + var property = nameTableNames[nameID] || nameID; + var byteLength = p.parseUShort(); + var offset = p.parseUShort(); + var language = getLanguageCode(platformID, languageID, ltag); + var encoding = getEncoding(platformID, encodingID, languageID); + if (encoding !== undefined && language !== undefined) { + var text = (void 0); + if (encoding === utf16) { + text = decode.UTF16(data, stringOffset + offset, byteLength); + } else { + text = decode.MACSTRING(data, stringOffset + offset, byteLength, encoding); + } + + if (text) { + var translations = name[property]; + if (translations === undefined) { + translations = name[property] = {}; + } + + translations[language] = text; + } + } + } + + var langTagCount = 0; + if (format === 1) { + // FIXME: Also handle Microsoft's 'name' table 1. + langTagCount = p.parseUShort(); + } + + return name; + } + + // {23: 'foo'} → {'foo': 23} + // ['bar', 'baz'] → {'bar': 0, 'baz': 1} + function reverseDict(dict) { + var result = {}; + for (var key in dict) { + result[dict[key]] = parseInt(key); + } + + return result; + } + + function makeNameRecord(platformID, encodingID, languageID, nameID, length, offset) { + return new table.Record('NameRecord', [ + {name: 'platformID', type: 'USHORT', value: platformID}, + {name: 'encodingID', type: 'USHORT', value: encodingID}, + {name: 'languageID', type: 'USHORT', value: languageID}, + {name: 'nameID', type: 'USHORT', value: nameID}, + {name: 'length', type: 'USHORT', value: length}, + {name: 'offset', type: 'USHORT', value: offset} + ]); + } + + // Finds the position of needle in haystack, or -1 if not there. + // Like String.indexOf(), but for arrays. + function findSubArray(needle, haystack) { + var needleLength = needle.length; + var limit = haystack.length - needleLength + 1; + + loop: + for (var pos = 0; pos < limit; pos++) { + for (; pos < limit; pos++) { + for (var k = 0; k < needleLength; k++) { + if (haystack[pos + k] !== needle[k]) { + continue loop; + } + } + + return pos; + } + } + + return -1; + } + + function addStringToPool(s, pool) { + var offset = findSubArray(s, pool); + if (offset < 0) { + offset = pool.length; + var i = 0; + var len = s.length; + for (; i < len; ++i) { + pool.push(s[i]); + } + + } + + return offset; + } + + function makeNameTable(names, ltag) { + var nameID; + var nameIDs = []; + + var namesWithNumericKeys = {}; + var nameTableIds = reverseDict(nameTableNames); + for (var key in names) { + var id = nameTableIds[key]; + if (id === undefined) { + id = key; + } + + nameID = parseInt(id); + + if (isNaN(nameID)) { + throw new Error('Name table entry "' + key + '" does not exist, see nameTableNames for complete list.'); + } + + namesWithNumericKeys[nameID] = names[key]; + nameIDs.push(nameID); + } + + var macLanguageIds = reverseDict(macLanguages); + var windowsLanguageIds = reverseDict(windowsLanguages); + + var nameRecords = []; + var stringPool = []; + + for (var i = 0; i < nameIDs.length; i++) { + nameID = nameIDs[i]; + var translations = namesWithNumericKeys[nameID]; + for (var lang in translations) { + var text = translations[lang]; + + // For MacOS, we try to emit the name in the form that was introduced + // in the initial version of the TrueType spec (in the late 1980s). + // However, this can fail for various reasons: the requested BCP 47 + // language code might not have an old-style Mac equivalent; + // we might not have a codec for the needed character encoding; + // or the name might contain characters that cannot be expressed + // in the old-style Macintosh encoding. In case of failure, we emit + // the name in a more modern fashion (Unicode encoding with BCP 47 + // language tags) that is recognized by MacOS 10.5, released in 2009. + // If fonts were only read by operating systems, we could simply + // emit all names in the modern form; this would be much easier. + // However, there are many applications and libraries that read + // 'name' tables directly, and these will usually only recognize + // the ancient form (silently skipping the unrecognized names). + var macPlatform = 1; // Macintosh + var macLanguage = macLanguageIds[lang]; + var macScript = macLanguageToScript[macLanguage]; + var macEncoding = getEncoding(macPlatform, macScript, macLanguage); + var macName = encode.MACSTRING(text, macEncoding); + if (macName === undefined) { + macPlatform = 0; // Unicode + macLanguage = ltag.indexOf(lang); + if (macLanguage < 0) { + macLanguage = ltag.length; + ltag.push(lang); + } + + macScript = 4; // Unicode 2.0 and later + macName = encode.UTF16(text); + } + + var macNameOffset = addStringToPool(macName, stringPool); + nameRecords.push(makeNameRecord(macPlatform, macScript, macLanguage, + nameID, macName.length, macNameOffset)); + + var winLanguage = windowsLanguageIds[lang]; + if (winLanguage !== undefined) { + var winName = encode.UTF16(text); + var winNameOffset = addStringToPool(winName, stringPool); + nameRecords.push(makeNameRecord(3, 1, winLanguage, + nameID, winName.length, winNameOffset)); + } + } + } + + nameRecords.sort(function(a, b) { + return ((a.platformID - b.platformID) || + (a.encodingID - b.encodingID) || + (a.languageID - b.languageID) || + (a.nameID - b.nameID)); + }); + + var t = new table.Table('name', [ + {name: 'format', type: 'USHORT', value: 0}, + {name: 'count', type: 'USHORT', value: nameRecords.length}, + {name: 'stringOffset', type: 'USHORT', value: 6 + nameRecords.length * 12} + ]); + + for (var r = 0; r < nameRecords.length; r++) { + t.fields.push({name: 'record_' + r, type: 'RECORD', value: nameRecords[r]}); + } + + t.fields.push({name: 'strings', type: 'LITERAL', value: stringPool}); + return t; + } + + var _name = { parse: parseNameTable, make: makeNameTable }; + + // The `OS/2` table contains metrics required in OpenType fonts. + + var unicodeRanges = [ + {begin: 0x0000, end: 0x007F}, // Basic Latin + {begin: 0x0080, end: 0x00FF}, // Latin-1 Supplement + {begin: 0x0100, end: 0x017F}, // Latin Extended-A + {begin: 0x0180, end: 0x024F}, // Latin Extended-B + {begin: 0x0250, end: 0x02AF}, // IPA Extensions + {begin: 0x02B0, end: 0x02FF}, // Spacing Modifier Letters + {begin: 0x0300, end: 0x036F}, // Combining Diacritical Marks + {begin: 0x0370, end: 0x03FF}, // Greek and Coptic + {begin: 0x2C80, end: 0x2CFF}, // Coptic + {begin: 0x0400, end: 0x04FF}, // Cyrillic + {begin: 0x0530, end: 0x058F}, // Armenian + {begin: 0x0590, end: 0x05FF}, // Hebrew + {begin: 0xA500, end: 0xA63F}, // Vai + {begin: 0x0600, end: 0x06FF}, // Arabic + {begin: 0x07C0, end: 0x07FF}, // NKo + {begin: 0x0900, end: 0x097F}, // Devanagari + {begin: 0x0980, end: 0x09FF}, // Bengali + {begin: 0x0A00, end: 0x0A7F}, // Gurmukhi + {begin: 0x0A80, end: 0x0AFF}, // Gujarati + {begin: 0x0B00, end: 0x0B7F}, // Oriya + {begin: 0x0B80, end: 0x0BFF}, // Tamil + {begin: 0x0C00, end: 0x0C7F}, // Telugu + {begin: 0x0C80, end: 0x0CFF}, // Kannada + {begin: 0x0D00, end: 0x0D7F}, // Malayalam + {begin: 0x0E00, end: 0x0E7F}, // Thai + {begin: 0x0E80, end: 0x0EFF}, // Lao + {begin: 0x10A0, end: 0x10FF}, // Georgian + {begin: 0x1B00, end: 0x1B7F}, // Balinese + {begin: 0x1100, end: 0x11FF}, // Hangul Jamo + {begin: 0x1E00, end: 0x1EFF}, // Latin Extended Additional + {begin: 0x1F00, end: 0x1FFF}, // Greek Extended + {begin: 0x2000, end: 0x206F}, // General Punctuation + {begin: 0x2070, end: 0x209F}, // Superscripts And Subscripts + {begin: 0x20A0, end: 0x20CF}, // Currency Symbol + {begin: 0x20D0, end: 0x20FF}, // Combining Diacritical Marks For Symbols + {begin: 0x2100, end: 0x214F}, // Letterlike Symbols + {begin: 0x2150, end: 0x218F}, // Number Forms + {begin: 0x2190, end: 0x21FF}, // Arrows + {begin: 0x2200, end: 0x22FF}, // Mathematical Operators + {begin: 0x2300, end: 0x23FF}, // Miscellaneous Technical + {begin: 0x2400, end: 0x243F}, // Control Pictures + {begin: 0x2440, end: 0x245F}, // Optical Character Recognition + {begin: 0x2460, end: 0x24FF}, // Enclosed Alphanumerics + {begin: 0x2500, end: 0x257F}, // Box Drawing + {begin: 0x2580, end: 0x259F}, // Block Elements + {begin: 0x25A0, end: 0x25FF}, // Geometric Shapes + {begin: 0x2600, end: 0x26FF}, // Miscellaneous Symbols + {begin: 0x2700, end: 0x27BF}, // Dingbats + {begin: 0x3000, end: 0x303F}, // CJK Symbols And Punctuation + {begin: 0x3040, end: 0x309F}, // Hiragana + {begin: 0x30A0, end: 0x30FF}, // Katakana + {begin: 0x3100, end: 0x312F}, // Bopomofo + {begin: 0x3130, end: 0x318F}, // Hangul Compatibility Jamo + {begin: 0xA840, end: 0xA87F}, // Phags-pa + {begin: 0x3200, end: 0x32FF}, // Enclosed CJK Letters And Months + {begin: 0x3300, end: 0x33FF}, // CJK Compatibility + {begin: 0xAC00, end: 0xD7AF}, // Hangul Syllables + {begin: 0xD800, end: 0xDFFF}, // Non-Plane 0 * + {begin: 0x10900, end: 0x1091F}, // Phoenicia + {begin: 0x4E00, end: 0x9FFF}, // CJK Unified Ideographs + {begin: 0xE000, end: 0xF8FF}, // Private Use Area (plane 0) + {begin: 0x31C0, end: 0x31EF}, // CJK Strokes + {begin: 0xFB00, end: 0xFB4F}, // Alphabetic Presentation Forms + {begin: 0xFB50, end: 0xFDFF}, // Arabic Presentation Forms-A + {begin: 0xFE20, end: 0xFE2F}, // Combining Half Marks + {begin: 0xFE10, end: 0xFE1F}, // Vertical Forms + {begin: 0xFE50, end: 0xFE6F}, // Small Form Variants + {begin: 0xFE70, end: 0xFEFF}, // Arabic Presentation Forms-B + {begin: 0xFF00, end: 0xFFEF}, // Halfwidth And Fullwidth Forms + {begin: 0xFFF0, end: 0xFFFF}, // Specials + {begin: 0x0F00, end: 0x0FFF}, // Tibetan + {begin: 0x0700, end: 0x074F}, // Syriac + {begin: 0x0780, end: 0x07BF}, // Thaana + {begin: 0x0D80, end: 0x0DFF}, // Sinhala + {begin: 0x1000, end: 0x109F}, // Myanmar + {begin: 0x1200, end: 0x137F}, // Ethiopic + {begin: 0x13A0, end: 0x13FF}, // Cherokee + {begin: 0x1400, end: 0x167F}, // Unified Canadian Aboriginal Syllabics + {begin: 0x1680, end: 0x169F}, // Ogham + {begin: 0x16A0, end: 0x16FF}, // Runic + {begin: 0x1780, end: 0x17FF}, // Khmer + {begin: 0x1800, end: 0x18AF}, // Mongolian + {begin: 0x2800, end: 0x28FF}, // Braille Patterns + {begin: 0xA000, end: 0xA48F}, // Yi Syllables + {begin: 0x1700, end: 0x171F}, // Tagalog + {begin: 0x10300, end: 0x1032F}, // Old Italic + {begin: 0x10330, end: 0x1034F}, // Gothic + {begin: 0x10400, end: 0x1044F}, // Deseret + {begin: 0x1D000, end: 0x1D0FF}, // Byzantine Musical Symbols + {begin: 0x1D400, end: 0x1D7FF}, // Mathematical Alphanumeric Symbols + {begin: 0xFF000, end: 0xFFFFD}, // Private Use (plane 15) + {begin: 0xFE00, end: 0xFE0F}, // Variation Selectors + {begin: 0xE0000, end: 0xE007F}, // Tags + {begin: 0x1900, end: 0x194F}, // Limbu + {begin: 0x1950, end: 0x197F}, // Tai Le + {begin: 0x1980, end: 0x19DF}, // New Tai Lue + {begin: 0x1A00, end: 0x1A1F}, // Buginese + {begin: 0x2C00, end: 0x2C5F}, // Glagolitic + {begin: 0x2D30, end: 0x2D7F}, // Tifinagh + {begin: 0x4DC0, end: 0x4DFF}, // Yijing Hexagram Symbols + {begin: 0xA800, end: 0xA82F}, // Syloti Nagri + {begin: 0x10000, end: 0x1007F}, // Linear B Syllabary + {begin: 0x10140, end: 0x1018F}, // Ancient Greek Numbers + {begin: 0x10380, end: 0x1039F}, // Ugaritic + {begin: 0x103A0, end: 0x103DF}, // Old Persian + {begin: 0x10450, end: 0x1047F}, // Shavian + {begin: 0x10480, end: 0x104AF}, // Osmanya + {begin: 0x10800, end: 0x1083F}, // Cypriot Syllabary + {begin: 0x10A00, end: 0x10A5F}, // Kharoshthi + {begin: 0x1D300, end: 0x1D35F}, // Tai Xuan Jing Symbols + {begin: 0x12000, end: 0x123FF}, // Cuneiform + {begin: 0x1D360, end: 0x1D37F}, // Counting Rod Numerals + {begin: 0x1B80, end: 0x1BBF}, // Sundanese + {begin: 0x1C00, end: 0x1C4F}, // Lepcha + {begin: 0x1C50, end: 0x1C7F}, // Ol Chiki + {begin: 0xA880, end: 0xA8DF}, // Saurashtra + {begin: 0xA900, end: 0xA92F}, // Kayah Li + {begin: 0xA930, end: 0xA95F}, // Rejang + {begin: 0xAA00, end: 0xAA5F}, // Cham + {begin: 0x10190, end: 0x101CF}, // Ancient Symbols + {begin: 0x101D0, end: 0x101FF}, // Phaistos Disc + {begin: 0x102A0, end: 0x102DF}, // Carian + {begin: 0x1F030, end: 0x1F09F} // Domino Tiles + ]; + + function getUnicodeRange(unicode) { + for (var i = 0; i < unicodeRanges.length; i += 1) { + var range = unicodeRanges[i]; + if (unicode >= range.begin && unicode < range.end) { + return i; + } + } + + return -1; + } + + // Parse the OS/2 and Windows metrics `OS/2` table + function parseOS2Table(data, start) { + var os2 = {}; + var p = new parse.Parser(data, start); + os2.version = p.parseUShort(); + os2.xAvgCharWidth = p.parseShort(); + os2.usWeightClass = p.parseUShort(); + os2.usWidthClass = p.parseUShort(); + os2.fsType = p.parseUShort(); + os2.ySubscriptXSize = p.parseShort(); + os2.ySubscriptYSize = p.parseShort(); + os2.ySubscriptXOffset = p.parseShort(); + os2.ySubscriptYOffset = p.parseShort(); + os2.ySuperscriptXSize = p.parseShort(); + os2.ySuperscriptYSize = p.parseShort(); + os2.ySuperscriptXOffset = p.parseShort(); + os2.ySuperscriptYOffset = p.parseShort(); + os2.yStrikeoutSize = p.parseShort(); + os2.yStrikeoutPosition = p.parseShort(); + os2.sFamilyClass = p.parseShort(); + os2.panose = []; + for (var i = 0; i < 10; i++) { + os2.panose[i] = p.parseByte(); + } + + os2.ulUnicodeRange1 = p.parseULong(); + os2.ulUnicodeRange2 = p.parseULong(); + os2.ulUnicodeRange3 = p.parseULong(); + os2.ulUnicodeRange4 = p.parseULong(); + os2.achVendID = String.fromCharCode(p.parseByte(), p.parseByte(), p.parseByte(), p.parseByte()); + os2.fsSelection = p.parseUShort(); + os2.usFirstCharIndex = p.parseUShort(); + os2.usLastCharIndex = p.parseUShort(); + os2.sTypoAscender = p.parseShort(); + os2.sTypoDescender = p.parseShort(); + os2.sTypoLineGap = p.parseShort(); + os2.usWinAscent = p.parseUShort(); + os2.usWinDescent = p.parseUShort(); + if (os2.version >= 1) { + os2.ulCodePageRange1 = p.parseULong(); + os2.ulCodePageRange2 = p.parseULong(); + } + + if (os2.version >= 2) { + os2.sxHeight = p.parseShort(); + os2.sCapHeight = p.parseShort(); + os2.usDefaultChar = p.parseUShort(); + os2.usBreakChar = p.parseUShort(); + os2.usMaxContent = p.parseUShort(); + } + + return os2; + } + + function makeOS2Table(options) { + return new table.Table('OS/2', [ + {name: 'version', type: 'USHORT', value: 0x0003}, + {name: 'xAvgCharWidth', type: 'SHORT', value: 0}, + {name: 'usWeightClass', type: 'USHORT', value: 0}, + {name: 'usWidthClass', type: 'USHORT', value: 0}, + {name: 'fsType', type: 'USHORT', value: 0}, + {name: 'ySubscriptXSize', type: 'SHORT', value: 650}, + {name: 'ySubscriptYSize', type: 'SHORT', value: 699}, + {name: 'ySubscriptXOffset', type: 'SHORT', value: 0}, + {name: 'ySubscriptYOffset', type: 'SHORT', value: 140}, + {name: 'ySuperscriptXSize', type: 'SHORT', value: 650}, + {name: 'ySuperscriptYSize', type: 'SHORT', value: 699}, + {name: 'ySuperscriptXOffset', type: 'SHORT', value: 0}, + {name: 'ySuperscriptYOffset', type: 'SHORT', value: 479}, + {name: 'yStrikeoutSize', type: 'SHORT', value: 49}, + {name: 'yStrikeoutPosition', type: 'SHORT', value: 258}, + {name: 'sFamilyClass', type: 'SHORT', value: 0}, + {name: 'bFamilyType', type: 'BYTE', value: 0}, + {name: 'bSerifStyle', type: 'BYTE', value: 0}, + {name: 'bWeight', type: 'BYTE', value: 0}, + {name: 'bProportion', type: 'BYTE', value: 0}, + {name: 'bContrast', type: 'BYTE', value: 0}, + {name: 'bStrokeVariation', type: 'BYTE', value: 0}, + {name: 'bArmStyle', type: 'BYTE', value: 0}, + {name: 'bLetterform', type: 'BYTE', value: 0}, + {name: 'bMidline', type: 'BYTE', value: 0}, + {name: 'bXHeight', type: 'BYTE', value: 0}, + {name: 'ulUnicodeRange1', type: 'ULONG', value: 0}, + {name: 'ulUnicodeRange2', type: 'ULONG', value: 0}, + {name: 'ulUnicodeRange3', type: 'ULONG', value: 0}, + {name: 'ulUnicodeRange4', type: 'ULONG', value: 0}, + {name: 'achVendID', type: 'CHARARRAY', value: 'XXXX'}, + {name: 'fsSelection', type: 'USHORT', value: 0}, + {name: 'usFirstCharIndex', type: 'USHORT', value: 0}, + {name: 'usLastCharIndex', type: 'USHORT', value: 0}, + {name: 'sTypoAscender', type: 'SHORT', value: 0}, + {name: 'sTypoDescender', type: 'SHORT', value: 0}, + {name: 'sTypoLineGap', type: 'SHORT', value: 0}, + {name: 'usWinAscent', type: 'USHORT', value: 0}, + {name: 'usWinDescent', type: 'USHORT', value: 0}, + {name: 'ulCodePageRange1', type: 'ULONG', value: 0}, + {name: 'ulCodePageRange2', type: 'ULONG', value: 0}, + {name: 'sxHeight', type: 'SHORT', value: 0}, + {name: 'sCapHeight', type: 'SHORT', value: 0}, + {name: 'usDefaultChar', type: 'USHORT', value: 0}, + {name: 'usBreakChar', type: 'USHORT', value: 0}, + {name: 'usMaxContext', type: 'USHORT', value: 0} + ], options); + } + + var os2 = { parse: parseOS2Table, make: makeOS2Table, unicodeRanges: unicodeRanges, getUnicodeRange: getUnicodeRange }; + + // The `post` table stores additional PostScript information, such as glyph names. + + // Parse the PostScript `post` table + function parsePostTable(data, start) { + var post = {}; + var p = new parse.Parser(data, start); + post.version = p.parseVersion(); + post.italicAngle = p.parseFixed(); + post.underlinePosition = p.parseShort(); + post.underlineThickness = p.parseShort(); + post.isFixedPitch = p.parseULong(); + post.minMemType42 = p.parseULong(); + post.maxMemType42 = p.parseULong(); + post.minMemType1 = p.parseULong(); + post.maxMemType1 = p.parseULong(); + switch (post.version) { + case 1: + post.names = standardNames.slice(); + break; + case 2: + post.numberOfGlyphs = p.parseUShort(); + post.glyphNameIndex = new Array(post.numberOfGlyphs); + for (var i = 0; i < post.numberOfGlyphs; i++) { + post.glyphNameIndex[i] = p.parseUShort(); + } + + post.names = []; + for (var i$1 = 0; i$1 < post.numberOfGlyphs; i$1++) { + if (post.glyphNameIndex[i$1] >= standardNames.length) { + var nameLength = p.parseChar(); + post.names.push(p.parseString(nameLength)); + } + } + + break; + case 2.5: + post.numberOfGlyphs = p.parseUShort(); + post.offset = new Array(post.numberOfGlyphs); + for (var i$2 = 0; i$2 < post.numberOfGlyphs; i$2++) { + post.offset[i$2] = p.parseChar(); + } + + break; + } + return post; + } + + function makePostTable() { + return new table.Table('post', [ + {name: 'version', type: 'FIXED', value: 0x00030000}, + {name: 'italicAngle', type: 'FIXED', value: 0}, + {name: 'underlinePosition', type: 'FWORD', value: 0}, + {name: 'underlineThickness', type: 'FWORD', value: 0}, + {name: 'isFixedPitch', type: 'ULONG', value: 0}, + {name: 'minMemType42', type: 'ULONG', value: 0}, + {name: 'maxMemType42', type: 'ULONG', value: 0}, + {name: 'minMemType1', type: 'ULONG', value: 0}, + {name: 'maxMemType1', type: 'ULONG', value: 0} + ]); + } + + var post = { parse: parsePostTable, make: makePostTable }; + + // The `GSUB` table contains ligatures, among other things. + + var subtableParsers = new Array(9); // subtableParsers[0] is unused + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#SS + subtableParsers[1] = function parseLookup1() { + var start = this.offset + this.relativeOffset; + var substFormat = this.parseUShort(); + if (substFormat === 1) { + return { + substFormat: 1, + coverage: this.parsePointer(Parser.coverage), + deltaGlyphId: this.parseUShort() + }; + } else if (substFormat === 2) { + return { + substFormat: 2, + coverage: this.parsePointer(Parser.coverage), + substitute: this.parseOffset16List() + }; + } + check.assert(false, '0x' + start.toString(16) + ': lookup type 1 format must be 1 or 2.'); + }; + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#MS + subtableParsers[2] = function parseLookup2() { + var substFormat = this.parseUShort(); + check.argument(substFormat === 1, 'GSUB Multiple Substitution Subtable identifier-format must be 1'); + return { + substFormat: substFormat, + coverage: this.parsePointer(Parser.coverage), + sequences: this.parseListOfLists() + }; + }; + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#AS + subtableParsers[3] = function parseLookup3() { + var substFormat = this.parseUShort(); + check.argument(substFormat === 1, 'GSUB Alternate Substitution Subtable identifier-format must be 1'); + return { + substFormat: substFormat, + coverage: this.parsePointer(Parser.coverage), + alternateSets: this.parseListOfLists() + }; + }; + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#LS + subtableParsers[4] = function parseLookup4() { + var substFormat = this.parseUShort(); + check.argument(substFormat === 1, 'GSUB ligature table identifier-format must be 1'); + return { + substFormat: substFormat, + coverage: this.parsePointer(Parser.coverage), + ligatureSets: this.parseListOfLists(function() { + return { + ligGlyph: this.parseUShort(), + components: this.parseUShortList(this.parseUShort() - 1) + }; + }) + }; + }; + + var lookupRecordDesc = { + sequenceIndex: Parser.uShort, + lookupListIndex: Parser.uShort + }; + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#CSF + subtableParsers[5] = function parseLookup5() { + var start = this.offset + this.relativeOffset; + var substFormat = this.parseUShort(); + + if (substFormat === 1) { + return { + substFormat: substFormat, + coverage: this.parsePointer(Parser.coverage), + ruleSets: this.parseListOfLists(function() { + var glyphCount = this.parseUShort(); + var substCount = this.parseUShort(); + return { + input: this.parseUShortList(glyphCount - 1), + lookupRecords: this.parseRecordList(substCount, lookupRecordDesc) + }; + }) + }; + } else if (substFormat === 2) { + return { + substFormat: substFormat, + coverage: this.parsePointer(Parser.coverage), + classDef: this.parsePointer(Parser.classDef), + classSets: this.parseListOfLists(function() { + var glyphCount = this.parseUShort(); + var substCount = this.parseUShort(); + return { + classes: this.parseUShortList(glyphCount - 1), + lookupRecords: this.parseRecordList(substCount, lookupRecordDesc) + }; + }) + }; + } else if (substFormat === 3) { + var glyphCount = this.parseUShort(); + var substCount = this.parseUShort(); + return { + substFormat: substFormat, + coverages: this.parseList(glyphCount, Parser.pointer(Parser.coverage)), + lookupRecords: this.parseRecordList(substCount, lookupRecordDesc) + }; + } + check.assert(false, '0x' + start.toString(16) + ': lookup type 5 format must be 1, 2 or 3.'); + }; + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#CC + subtableParsers[6] = function parseLookup6() { + var start = this.offset + this.relativeOffset; + var substFormat = this.parseUShort(); + if (substFormat === 1) { + return { + substFormat: 1, + coverage: this.parsePointer(Parser.coverage), + chainRuleSets: this.parseListOfLists(function() { + return { + backtrack: this.parseUShortList(), + input: this.parseUShortList(this.parseShort() - 1), + lookahead: this.parseUShortList(), + lookupRecords: this.parseRecordList(lookupRecordDesc) + }; + }) + }; + } else if (substFormat === 2) { + return { + substFormat: 2, + coverage: this.parsePointer(Parser.coverage), + backtrackClassDef: this.parsePointer(Parser.classDef), + inputClassDef: this.parsePointer(Parser.classDef), + lookaheadClassDef: this.parsePointer(Parser.classDef), + chainClassSet: this.parseListOfLists(function() { + return { + backtrack: this.parseUShortList(), + input: this.parseUShortList(this.parseShort() - 1), + lookahead: this.parseUShortList(), + lookupRecords: this.parseRecordList(lookupRecordDesc) + }; + }) + }; + } else if (substFormat === 3) { + return { + substFormat: 3, + backtrackCoverage: this.parseList(Parser.pointer(Parser.coverage)), + inputCoverage: this.parseList(Parser.pointer(Parser.coverage)), + lookaheadCoverage: this.parseList(Parser.pointer(Parser.coverage)), + lookupRecords: this.parseRecordList(lookupRecordDesc) + }; + } + check.assert(false, '0x' + start.toString(16) + ': lookup type 6 format must be 1, 2 or 3.'); + }; + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#ES + subtableParsers[7] = function parseLookup7() { + // Extension Substitution subtable + var substFormat = this.parseUShort(); + check.argument(substFormat === 1, 'GSUB Extension Substitution subtable identifier-format must be 1'); + var extensionLookupType = this.parseUShort(); + var extensionParser = new Parser(this.data, this.offset + this.parseULong()); + return { + substFormat: 1, + lookupType: extensionLookupType, + extension: subtableParsers[extensionLookupType].call(extensionParser) + }; + }; + + // https://www.microsoft.com/typography/OTSPEC/GSUB.htm#RCCS + subtableParsers[8] = function parseLookup8() { + var substFormat = this.parseUShort(); + check.argument(substFormat === 1, 'GSUB Reverse Chaining Contextual Single Substitution Subtable identifier-format must be 1'); + return { + substFormat: substFormat, + coverage: this.parsePointer(Parser.coverage), + backtrackCoverage: this.parseList(Parser.pointer(Parser.coverage)), + lookaheadCoverage: this.parseList(Parser.pointer(Parser.coverage)), + substitutes: this.parseUShortList() + }; + }; + + // https://www.microsoft.com/typography/OTSPEC/gsub.htm + function parseGsubTable(data, start) { + start = start || 0; + var p = new Parser(data, start); + var tableVersion = p.parseVersion(1); + check.argument(tableVersion === 1 || tableVersion === 1.1, 'Unsupported GSUB table version.'); + if (tableVersion === 1) { + return { + version: tableVersion, + scripts: p.parseScriptList(), + features: p.parseFeatureList(), + lookups: p.parseLookupList(subtableParsers) + }; + } else { + return { + version: tableVersion, + scripts: p.parseScriptList(), + features: p.parseFeatureList(), + lookups: p.parseLookupList(subtableParsers), + variations: p.parseFeatureVariationsList() + }; + } + + } + + // GSUB Writing ////////////////////////////////////////////// + var subtableMakers = new Array(9); + + subtableMakers[1] = function makeLookup1(subtable) { + if (subtable.substFormat === 1) { + return new table.Table('substitutionTable', [ + {name: 'substFormat', type: 'USHORT', value: 1}, + {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)}, + {name: 'deltaGlyphID', type: 'USHORT', value: subtable.deltaGlyphId} + ]); + } else { + return new table.Table('substitutionTable', [ + {name: 'substFormat', type: 'USHORT', value: 2}, + {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)} + ].concat(table.ushortList('substitute', subtable.substitute))); + } + check.fail('Lookup type 1 substFormat must be 1 or 2.'); + }; + + subtableMakers[3] = function makeLookup3(subtable) { + check.assert(subtable.substFormat === 1, 'Lookup type 3 substFormat must be 1.'); + return new table.Table('substitutionTable', [ + {name: 'substFormat', type: 'USHORT', value: 1}, + {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)} + ].concat(table.tableList('altSet', subtable.alternateSets, function(alternateSet) { + return new table.Table('alternateSetTable', table.ushortList('alternate', alternateSet)); + }))); + }; + + subtableMakers[4] = function makeLookup4(subtable) { + check.assert(subtable.substFormat === 1, 'Lookup type 4 substFormat must be 1.'); + return new table.Table('substitutionTable', [ + {name: 'substFormat', type: 'USHORT', value: 1}, + {name: 'coverage', type: 'TABLE', value: new table.Coverage(subtable.coverage)} + ].concat(table.tableList('ligSet', subtable.ligatureSets, function(ligatureSet) { + return new table.Table('ligatureSetTable', table.tableList('ligature', ligatureSet, function(ligature) { + return new table.Table('ligatureTable', + [{name: 'ligGlyph', type: 'USHORT', value: ligature.ligGlyph}] + .concat(table.ushortList('component', ligature.components, ligature.components.length + 1)) + ); + })); + }))); + }; + + function makeGsubTable(gsub) { + return new table.Table('GSUB', [ + {name: 'version', type: 'ULONG', value: 0x10000}, + {name: 'scripts', type: 'TABLE', value: new table.ScriptList(gsub.scripts)}, + {name: 'features', type: 'TABLE', value: new table.FeatureList(gsub.features)}, + {name: 'lookups', type: 'TABLE', value: new table.LookupList(gsub.lookups, subtableMakers)} + ]); + } + + var gsub = { parse: parseGsubTable, make: makeGsubTable }; + + // The `GPOS` table contains kerning pairs, among other things. + + // Parse the metadata `meta` table. + // https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6meta.html + function parseMetaTable(data, start) { + var p = new parse.Parser(data, start); + var tableVersion = p.parseULong(); + check.argument(tableVersion === 1, 'Unsupported META table version.'); + p.parseULong(); // flags - currently unused and set to 0 + p.parseULong(); // tableOffset + var numDataMaps = p.parseULong(); + + var tags = {}; + for (var i = 0; i < numDataMaps; i++) { + var tag = p.parseTag(); + var dataOffset = p.parseULong(); + var dataLength = p.parseULong(); + var text = decode.UTF8(data, start + dataOffset, dataLength); + + tags[tag] = text; + } + return tags; + } + + function makeMetaTable(tags) { + var numTags = Object.keys(tags).length; + var stringPool = ''; + var stringPoolOffset = 16 + numTags * 12; + + var result = new table.Table('meta', [ + {name: 'version', type: 'ULONG', value: 1}, + {name: 'flags', type: 'ULONG', value: 0}, + {name: 'offset', type: 'ULONG', value: stringPoolOffset}, + {name: 'numTags', type: 'ULONG', value: numTags} + ]); + + for (var tag in tags) { + var pos = stringPool.length; + stringPool += tags[tag]; + + result.fields.push({name: 'tag ' + tag, type: 'TAG', value: tag}); + result.fields.push({name: 'offset ' + tag, type: 'ULONG', value: stringPoolOffset + pos}); + result.fields.push({name: 'length ' + tag, type: 'ULONG', value: tags[tag].length}); + } + + result.fields.push({name: 'stringPool', type: 'CHARARRAY', value: stringPool}); + + return result; + } + + var meta = { parse: parseMetaTable, make: makeMetaTable }; + + // The `sfnt` wrapper provides organization for the tables in the font. + + function log2(v) { + return Math.log(v) / Math.log(2) | 0; + } + + function computeCheckSum(bytes) { + while (bytes.length % 4 !== 0) { + bytes.push(0); + } + + var sum = 0; + for (var i = 0; i < bytes.length; i += 4) { + sum += (bytes[i] << 24) + + (bytes[i + 1] << 16) + + (bytes[i + 2] << 8) + + (bytes[i + 3]); + } + + sum %= Math.pow(2, 32); + return sum; + } + + function makeTableRecord(tag, checkSum, offset, length) { + return new table.Record('Table Record', [ + {name: 'tag', type: 'TAG', value: tag !== undefined ? tag : ''}, + {name: 'checkSum', type: 'ULONG', value: checkSum !== undefined ? checkSum : 0}, + {name: 'offset', type: 'ULONG', value: offset !== undefined ? offset : 0}, + {name: 'length', type: 'ULONG', value: length !== undefined ? length : 0} + ]); + } + + function makeSfntTable(tables) { + var sfnt = new table.Table('sfnt', [ + {name: 'version', type: 'TAG', value: 'OTTO'}, + {name: 'numTables', type: 'USHORT', value: 0}, + {name: 'searchRange', type: 'USHORT', value: 0}, + {name: 'entrySelector', type: 'USHORT', value: 0}, + {name: 'rangeShift', type: 'USHORT', value: 0} + ]); + sfnt.tables = tables; + sfnt.numTables = tables.length; + var highestPowerOf2 = Math.pow(2, log2(sfnt.numTables)); + sfnt.searchRange = 16 * highestPowerOf2; + sfnt.entrySelector = log2(highestPowerOf2); + sfnt.rangeShift = sfnt.numTables * 16 - sfnt.searchRange; + + var recordFields = []; + var tableFields = []; + + var offset = sfnt.sizeOf() + (makeTableRecord().sizeOf() * sfnt.numTables); + while (offset % 4 !== 0) { + offset += 1; + tableFields.push({name: 'padding', type: 'BYTE', value: 0}); + } + + for (var i = 0; i < tables.length; i += 1) { + var t = tables[i]; + check.argument(t.tableName.length === 4, 'Table name' + t.tableName + ' is invalid.'); + var tableLength = t.sizeOf(); + var tableRecord = makeTableRecord(t.tableName, computeCheckSum(t.encode()), offset, tableLength); + recordFields.push({name: tableRecord.tag + ' Table Record', type: 'RECORD', value: tableRecord}); + tableFields.push({name: t.tableName + ' table', type: 'RECORD', value: t}); + offset += tableLength; + check.argument(!isNaN(offset), 'Something went wrong calculating the offset.'); + while (offset % 4 !== 0) { + offset += 1; + tableFields.push({name: 'padding', type: 'BYTE', value: 0}); + } + } + + // Table records need to be sorted alphabetically. + recordFields.sort(function(r1, r2) { + if (r1.value.tag > r2.value.tag) { + return 1; + } else { + return -1; + } + }); + + sfnt.fields = sfnt.fields.concat(recordFields); + sfnt.fields = sfnt.fields.concat(tableFields); + return sfnt; + } + + // Get the metrics for a character. If the string has more than one character + // this function returns metrics for the first available character. + // You can provide optional fallback metrics if no characters are available. + function metricsForChar(font, chars, notFoundMetrics) { + for (var i = 0; i < chars.length; i += 1) { + var glyphIndex = font.charToGlyphIndex(chars[i]); + if (glyphIndex > 0) { + var glyph = font.glyphs.get(glyphIndex); + return glyph.getMetrics(); + } + } + + return notFoundMetrics; + } + + function average(vs) { + var sum = 0; + for (var i = 0; i < vs.length; i += 1) { + sum += vs[i]; + } + + return sum / vs.length; + } + + // Convert the font object to a SFNT data structure. + // This structure contains all the necessary tables and metadata to create a binary OTF file. + function fontToSfntTable(font) { + var xMins = []; + var yMins = []; + var xMaxs = []; + var yMaxs = []; + var advanceWidths = []; + var leftSideBearings = []; + var rightSideBearings = []; + var firstCharIndex; + var lastCharIndex = 0; + var ulUnicodeRange1 = 0; + var ulUnicodeRange2 = 0; + var ulUnicodeRange3 = 0; + var ulUnicodeRange4 = 0; + + for (var i = 0; i < font.glyphs.length; i += 1) { + var glyph = font.glyphs.get(i); + var unicode = glyph.unicode | 0; + + if (isNaN(glyph.advanceWidth)) { + throw new Error('Glyph ' + glyph.name + ' (' + i + '): advanceWidth is not a number.'); + } + + if (firstCharIndex > unicode || firstCharIndex === undefined) { + // ignore .notdef char + if (unicode > 0) { + firstCharIndex = unicode; + } + } + + if (lastCharIndex < unicode) { + lastCharIndex = unicode; + } + + var position = os2.getUnicodeRange(unicode); + if (position < 32) { + ulUnicodeRange1 |= 1 << position; + } else if (position < 64) { + ulUnicodeRange2 |= 1 << position - 32; + } else if (position < 96) { + ulUnicodeRange3 |= 1 << position - 64; + } else if (position < 123) { + ulUnicodeRange4 |= 1 << position - 96; + } else { + throw new Error('Unicode ranges bits > 123 are reserved for internal usage'); + } + // Skip non-important characters. + if (glyph.name === '.notdef') { continue; } + var metrics = glyph.getMetrics(); + xMins.push(metrics.xMin); + yMins.push(metrics.yMin); + xMaxs.push(metrics.xMax); + yMaxs.push(metrics.yMax); + leftSideBearings.push(metrics.leftSideBearing); + rightSideBearings.push(metrics.rightSideBearing); + advanceWidths.push(glyph.advanceWidth); + } + + var globals = { + xMin: Math.min.apply(null, xMins), + yMin: Math.min.apply(null, yMins), + xMax: Math.max.apply(null, xMaxs), + yMax: Math.max.apply(null, yMaxs), + advanceWidthMax: Math.max.apply(null, advanceWidths), + advanceWidthAvg: average(advanceWidths), + minLeftSideBearing: Math.min.apply(null, leftSideBearings), + maxLeftSideBearing: Math.max.apply(null, leftSideBearings), + minRightSideBearing: Math.min.apply(null, rightSideBearings) + }; + globals.ascender = font.ascender; + globals.descender = font.descender; + + var headTable = head.make({ + flags: 3, // 00000011 (baseline for font at y=0; left sidebearing point at x=0) + unitsPerEm: font.unitsPerEm, + xMin: globals.xMin, + yMin: globals.yMin, + xMax: globals.xMax, + yMax: globals.yMax, + lowestRecPPEM: 3, + createdTimestamp: font.createdTimestamp + }); + + var hheaTable = hhea.make({ + ascender: globals.ascender, + descender: globals.descender, + advanceWidthMax: globals.advanceWidthMax, + minLeftSideBearing: globals.minLeftSideBearing, + minRightSideBearing: globals.minRightSideBearing, + xMaxExtent: globals.maxLeftSideBearing + (globals.xMax - globals.xMin), + numberOfHMetrics: font.glyphs.length + }); + + var maxpTable = maxp.make(font.glyphs.length); + + var os2Table = os2.make({ + xAvgCharWidth: Math.round(globals.advanceWidthAvg), + usWeightClass: font.tables.os2.usWeightClass, + usWidthClass: font.tables.os2.usWidthClass, + usFirstCharIndex: firstCharIndex, + usLastCharIndex: lastCharIndex, + ulUnicodeRange1: ulUnicodeRange1, + ulUnicodeRange2: ulUnicodeRange2, + ulUnicodeRange3: ulUnicodeRange3, + ulUnicodeRange4: ulUnicodeRange4, + fsSelection: font.tables.os2.fsSelection, // REGULAR + // See http://typophile.com/node/13081 for more info on vertical metrics. + // We get metrics for typical characters (such as "x" for xHeight). + // We provide some fallback characters if characters are unavailable: their + // ordering was chosen experimentally. + sTypoAscender: globals.ascender, + sTypoDescender: globals.descender, + sTypoLineGap: 0, + usWinAscent: globals.yMax, + usWinDescent: Math.abs(globals.yMin), + ulCodePageRange1: 1, // FIXME: hard-code Latin 1 support for now + sxHeight: metricsForChar(font, 'xyvw', {yMax: Math.round(globals.ascender / 2)}).yMax, + sCapHeight: metricsForChar(font, 'HIKLEFJMNTZBDPRAGOQSUVWXY', globals).yMax, + usDefaultChar: font.hasChar(' ') ? 32 : 0, // Use space as the default character, if available. + usBreakChar: font.hasChar(' ') ? 32 : 0 // Use space as the break character, if available. + }); + + var hmtxTable = hmtx.make(font.glyphs); + var cmapTable = cmap.make(font.glyphs); + + var englishFamilyName = font.getEnglishName('fontFamily'); + var englishStyleName = font.getEnglishName('fontSubfamily'); + var englishFullName = englishFamilyName + ' ' + englishStyleName; + var postScriptName = font.getEnglishName('postScriptName'); + if (!postScriptName) { + postScriptName = englishFamilyName.replace(/\s/g, '') + '-' + englishStyleName; + } + + var names = {}; + for (var n in font.names) { + names[n] = font.names[n]; + } + + if (!names.uniqueID) { + names.uniqueID = {en: font.getEnglishName('manufacturer') + ':' + englishFullName}; + } + + if (!names.postScriptName) { + names.postScriptName = {en: postScriptName}; + } + + if (!names.preferredFamily) { + names.preferredFamily = font.names.fontFamily; + } + + if (!names.preferredSubfamily) { + names.preferredSubfamily = font.names.fontSubfamily; + } + + var languageTags = []; + var nameTable = _name.make(names, languageTags); + var ltagTable = (languageTags.length > 0 ? ltag.make(languageTags) : undefined); + + var postTable = post.make(); + var cffTable = cff.make(font.glyphs, { + version: font.getEnglishName('version'), + fullName: englishFullName, + familyName: englishFamilyName, + weightName: englishStyleName, + postScriptName: postScriptName, + unitsPerEm: font.unitsPerEm, + fontBBox: [0, globals.yMin, globals.ascender, globals.advanceWidthMax] + }); + + var metaTable = (font.metas && Object.keys(font.metas).length > 0) ? meta.make(font.metas) : undefined; + + // The order does not matter because makeSfntTable() will sort them. + var tables = [headTable, hheaTable, maxpTable, os2Table, nameTable, cmapTable, postTable, cffTable, hmtxTable]; + if (ltagTable) { + tables.push(ltagTable); + } + // Optional tables + if (font.tables.gsub) { + tables.push(gsub.make(font.tables.gsub)); + } + if (metaTable) { + tables.push(metaTable); + } + + var sfntTable = makeSfntTable(tables); + + // Compute the font's checkSum and store it in head.checkSumAdjustment. + var bytes = sfntTable.encode(); + var checkSum = computeCheckSum(bytes); + var tableFields = sfntTable.fields; + var checkSumAdjusted = false; + for (var i$1 = 0; i$1 < tableFields.length; i$1 += 1) { + if (tableFields[i$1].name === 'head table') { + tableFields[i$1].value.checkSumAdjustment = 0xB1B0AFBA - checkSum; + checkSumAdjusted = true; + break; + } + } + + if (!checkSumAdjusted) { + throw new Error('Could not find head table with checkSum to adjust.'); + } + + return sfntTable; + } + + var sfnt = { make: makeSfntTable, fontToTable: fontToSfntTable, computeCheckSum: computeCheckSum }; + + // The Layout object is the prototype of Substitution objects, and provides + + function searchTag(arr, tag) { + /* jshint bitwise: false */ + var imin = 0; + var imax = arr.length - 1; + while (imin <= imax) { + var imid = (imin + imax) >>> 1; + var val = arr[imid].tag; + if (val === tag) { + return imid; + } else if (val < tag) { + imin = imid + 1; + } else { imax = imid - 1; } + } + // Not found: return -1-insertion point + return -imin - 1; + } + + function binSearch(arr, value) { + /* jshint bitwise: false */ + var imin = 0; + var imax = arr.length - 1; + while (imin <= imax) { + var imid = (imin + imax) >>> 1; + var val = arr[imid]; + if (val === value) { + return imid; + } else if (val < value) { + imin = imid + 1; + } else { imax = imid - 1; } + } + // Not found: return -1-insertion point + return -imin - 1; + } + + // binary search in a list of ranges (coverage, class definition) + function searchRange(ranges, value) { + // jshint bitwise: false + var range; + var imin = 0; + var imax = ranges.length - 1; + while (imin <= imax) { + var imid = (imin + imax) >>> 1; + range = ranges[imid]; + var start = range.start; + if (start === value) { + return range; + } else if (start < value) { + imin = imid + 1; + } else { imax = imid - 1; } + } + if (imin > 0) { + range = ranges[imin - 1]; + if (value > range.end) { return 0; } + return range; + } + } + + /** + * @exports opentype.Layout + * @class + */ + function Layout(font, tableName) { + this.font = font; + this.tableName = tableName; + } + + Layout.prototype = { + + /** + * Binary search an object by "tag" property + * @instance + * @function searchTag + * @memberof opentype.Layout + * @param {Array} arr + * @param {string} tag + * @return {number} + */ + searchTag: searchTag, + + /** + * Binary search in a list of numbers + * @instance + * @function binSearch + * @memberof opentype.Layout + * @param {Array} arr + * @param {number} value + * @return {number} + */ + binSearch: binSearch, + + /** + * Get or create the Layout table (GSUB, GPOS etc). + * @param {boolean} create - Whether to create a new one. + * @return {Object} The GSUB or GPOS table. + */ + getTable: function(create) { + var layout = this.font.tables[this.tableName]; + if (!layout && create) { + layout = this.font.tables[this.tableName] = this.createDefaultTable(); + } + return layout; + }, + + /** + * Returns all scripts in the substitution table. + * @instance + * @return {Array} + */ + getScriptNames: function() { + var layout = this.getTable(); + if (!layout) { return []; } + return layout.scripts.map(function(script) { + return script.tag; + }); + }, + + /** + * Returns the best bet for a script name. + * Returns 'DFLT' if it exists. + * If not, returns 'latn' if it exists. + * If neither exist, returns undefined. + */ + getDefaultScriptName: function() { + var layout = this.getTable(); + if (!layout) { return; } + var hasLatn = false; + for (var i = 0; i < layout.scripts.length; i++) { + var name = layout.scripts[i].tag; + if (name === 'DFLT') { return name; } + if (name === 'latn') { hasLatn = true; } + } + if (hasLatn) { return 'latn'; } + }, + + /** + * Returns all LangSysRecords in the given script. + * @instance + * @param {string} [script='DFLT'] + * @param {boolean} create - forces the creation of this script table if it doesn't exist. + * @return {Object} An object with tag and script properties. + */ + getScriptTable: function(script, create) { + var layout = this.getTable(create); + if (layout) { + script = script || 'DFLT'; + var scripts = layout.scripts; + var pos = searchTag(layout.scripts, script); + if (pos >= 0) { + return scripts[pos].script; + } else if (create) { + var scr = { + tag: script, + script: { + defaultLangSys: {reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: []}, + langSysRecords: [] + } + }; + scripts.splice(-1 - pos, 0, scr); + return scr.script; + } + } + }, + + /** + * Returns a language system table + * @instance + * @param {string} [script='DFLT'] + * @param {string} [language='dlft'] + * @param {boolean} create - forces the creation of this langSysTable if it doesn't exist. + * @return {Object} + */ + getLangSysTable: function(script, language, create) { + var scriptTable = this.getScriptTable(script, create); + if (scriptTable) { + if (!language || language === 'dflt' || language === 'DFLT') { + return scriptTable.defaultLangSys; + } + var pos = searchTag(scriptTable.langSysRecords, language); + if (pos >= 0) { + return scriptTable.langSysRecords[pos].langSys; + } else if (create) { + var langSysRecord = { + tag: language, + langSys: {reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: []} + }; + scriptTable.langSysRecords.splice(-1 - pos, 0, langSysRecord); + return langSysRecord.langSys; + } + } + }, + + /** + * Get a specific feature table. + * @instance + * @param {string} [script='DFLT'] + * @param {string} [language='dlft'] + * @param {string} feature - One of the codes listed at https://www.microsoft.com/typography/OTSPEC/featurelist.htm + * @param {boolean} create - forces the creation of the feature table if it doesn't exist. + * @return {Object} + */ + getFeatureTable: function(script, language, feature, create) { + var langSysTable = this.getLangSysTable(script, language, create); + if (langSysTable) { + var featureRecord; + var featIndexes = langSysTable.featureIndexes; + var allFeatures = this.font.tables[this.tableName].features; + // The FeatureIndex array of indices is in arbitrary order, + // even if allFeatures is sorted alphabetically by feature tag. + for (var i = 0; i < featIndexes.length; i++) { + featureRecord = allFeatures[featIndexes[i]]; + if (featureRecord.tag === feature) { + return featureRecord.feature; + } + } + if (create) { + var index = allFeatures.length; + // Automatic ordering of features would require to shift feature indexes in the script list. + check.assert(index === 0 || feature >= allFeatures[index - 1].tag, 'Features must be added in alphabetical order.'); + featureRecord = { + tag: feature, + feature: { params: 0, lookupListIndexes: [] } + }; + allFeatures.push(featureRecord); + featIndexes.push(index); + return featureRecord.feature; + } + } + }, + + /** + * Get the lookup tables of a given type for a script/language/feature. + * @instance + * @param {string} [script='DFLT'] + * @param {string} [language='dlft'] + * @param {string} feature - 4-letter feature code + * @param {number} lookupType - 1 to 9 + * @param {boolean} create - forces the creation of the lookup table if it doesn't exist, with no subtables. + * @return {Object[]} + */ + getLookupTables: function(script, language, feature, lookupType, create) { + var featureTable = this.getFeatureTable(script, language, feature, create); + var tables = []; + if (featureTable) { + var lookupTable; + var lookupListIndexes = featureTable.lookupListIndexes; + var allLookups = this.font.tables[this.tableName].lookups; + // lookupListIndexes are in no particular order, so use naive search. + for (var i = 0; i < lookupListIndexes.length; i++) { + lookupTable = allLookups[lookupListIndexes[i]]; + if (lookupTable.lookupType === lookupType) { + tables.push(lookupTable); + } + } + if (tables.length === 0 && create) { + lookupTable = { + lookupType: lookupType, + lookupFlag: 0, + subtables: [], + markFilteringSet: undefined + }; + var index = allLookups.length; + allLookups.push(lookupTable); + lookupListIndexes.push(index); + return [lookupTable]; + } + } + return tables; + }, + + /** + * Find a glyph in a class definition table + * https://docs.microsoft.com/en-us/typography/opentype/spec/chapter2#class-definition-table + * @param {object} classDefTable - an OpenType Layout class definition table + * @param {number} glyphIndex - the index of the glyph to find + * @returns {number} -1 if not found + */ + getGlyphClass: function(classDefTable, glyphIndex) { + switch (classDefTable.format) { + case 1: + if (classDefTable.startGlyph <= glyphIndex && glyphIndex < classDefTable.startGlyph + classDefTable.classes.length) { + return classDefTable.classes[glyphIndex - classDefTable.startGlyph]; + } + return 0; + case 2: + var range = searchRange(classDefTable.ranges, glyphIndex); + return range ? range.classId : 0; + } + }, + + /** + * Find a glyph in a coverage table + * https://docs.microsoft.com/en-us/typography/opentype/spec/chapter2#coverage-table + * @param {object} coverageTable - an OpenType Layout coverage table + * @param {number} glyphIndex - the index of the glyph to find + * @returns {number} -1 if not found + */ + getCoverageIndex: function(coverageTable, glyphIndex) { + switch (coverageTable.format) { + case 1: + var index = binSearch(coverageTable.glyphs, glyphIndex); + return index >= 0 ? index : -1; + case 2: + var range = searchRange(coverageTable.ranges, glyphIndex); + return range ? range.index + glyphIndex - range.start : -1; + } + }, + + /** + * Returns the list of glyph indexes of a coverage table. + * Format 1: the list is stored raw + * Format 2: compact list as range records. + * @instance + * @param {Object} coverageTable + * @return {Array} + */ + expandCoverage: function(coverageTable) { + if (coverageTable.format === 1) { + return coverageTable.glyphs; + } else { + var glyphs = []; + var ranges = coverageTable.ranges; + for (var i = 0; i < ranges.length; i++) { + var range = ranges[i]; + var start = range.start; + var end = range.end; + for (var j = start; j <= end; j++) { + glyphs.push(j); + } + } + return glyphs; + } + } + + }; + + // The Position object provides utility methods to manipulate + + /** + * @exports opentype.Position + * @class + * @extends opentype.Layout + * @param {opentype.Font} + * @constructor + */ + function Position(font) { + Layout.call(this, font, 'gpos'); + } + + Position.prototype = Layout.prototype; + + /** + * Init some data for faster and easier access later. + */ + Position.prototype.init = function() { + var script = this.getDefaultScriptName(); + this.defaultKerningTables = this.getKerningTables(script); + }; + + /** + * Find a glyph pair in a list of lookup tables of type 2 and retrieve the xAdvance kerning value. + * + * @param {integer} leftIndex - left glyph index + * @param {integer} rightIndex - right glyph index + * @returns {integer} + */ + Position.prototype.getKerningValue = function(kerningLookups, leftIndex, rightIndex) { + var this$1 = this; + + for (var i = 0; i < kerningLookups.length; i++) { + var subtables = kerningLookups[i].subtables; + for (var j = 0; j < subtables.length; j++) { + var subtable = subtables[j]; + var covIndex = this$1.getCoverageIndex(subtable.coverage, leftIndex); + if (covIndex < 0) { continue; } + switch (subtable.posFormat) { + case 1: + // Search Pair Adjustment Positioning Format 1 + var pairSet = subtable.pairSets[covIndex]; + for (var k = 0; k < pairSet.length; k++) { + var pair = pairSet[k]; + if (pair.secondGlyph === rightIndex) { + return pair.value1 && pair.value1.xAdvance || 0; + } + } + break; // left glyph found, not right glyph - try next subtable + case 2: + // Search Pair Adjustment Positioning Format 2 + var class1 = this$1.getGlyphClass(subtable.classDef1, leftIndex); + var class2 = this$1.getGlyphClass(subtable.classDef2, rightIndex); + var pair$1 = subtable.classRecords[class1][class2]; + return pair$1.value1 && pair$1.value1.xAdvance || 0; + } + } + } + return 0; + }; + + /** + * List all kerning lookup tables. + * + * @param {string} [script='DFLT'] - use font.position.getDefaultScriptName() for a better default value + * @param {string} [language='dflt'] + * @return {object[]} The list of kerning lookup tables (may be empty), or undefined if there is no GPOS table (and we should use the kern table) + */ + Position.prototype.getKerningTables = function(script, language) { + if (this.font.tables.gpos) { + return this.getLookupTables(script, language, 'kern', 2); + } + }; + + // The Substitution object provides utility methods to manipulate + + /** + * @exports opentype.Substitution + * @class + * @extends opentype.Layout + * @param {opentype.Font} + * @constructor + */ + function Substitution(font) { + Layout.call(this, font, 'gsub'); + } + + // Check if 2 arrays of primitives are equal. + function arraysEqual(ar1, ar2) { + var n = ar1.length; + if (n !== ar2.length) { return false; } + for (var i = 0; i < n; i++) { + if (ar1[i] !== ar2[i]) { return false; } + } + return true; + } + + // Find the first subtable of a lookup table in a particular format. + function getSubstFormat(lookupTable, format, defaultSubtable) { + var subtables = lookupTable.subtables; + for (var i = 0; i < subtables.length; i++) { + var subtable = subtables[i]; + if (subtable.substFormat === format) { + return subtable; + } + } + if (defaultSubtable) { + subtables.push(defaultSubtable); + return defaultSubtable; + } + return undefined; + } + + Substitution.prototype = Layout.prototype; + + /** + * Create a default GSUB table. + * @return {Object} gsub - The GSUB table. + */ + Substitution.prototype.createDefaultTable = function() { + // Generate a default empty GSUB table with just a DFLT script and dflt lang sys. + return { + version: 1, + scripts: [{ + tag: 'DFLT', + script: { + defaultLangSys: { reserved: 0, reqFeatureIndex: 0xffff, featureIndexes: [] }, + langSysRecords: [] + } + }], + features: [], + lookups: [] + }; + }; + + /** + * List all single substitutions (lookup type 1) for a given script, language, and feature. + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + * @param {string} feature - 4-character feature name ('aalt', 'salt', 'ss01'...) + * @return {Array} substitutions - The list of substitutions. + */ + Substitution.prototype.getSingle = function(feature, script, language) { + var this$1 = this; + + var substitutions = []; + var lookupTables = this.getLookupTables(script, language, feature, 1); + for (var idx = 0; idx < lookupTables.length; idx++) { + var subtables = lookupTables[idx].subtables; + for (var i = 0; i < subtables.length; i++) { + var subtable = subtables[i]; + var glyphs = this$1.expandCoverage(subtable.coverage); + var j = (void 0); + if (subtable.substFormat === 1) { + var delta = subtable.deltaGlyphId; + for (j = 0; j < glyphs.length; j++) { + var glyph = glyphs[j]; + substitutions.push({ sub: glyph, by: glyph + delta }); + } + } else { + var substitute = subtable.substitute; + for (j = 0; j < glyphs.length; j++) { + substitutions.push({ sub: glyphs[j], by: substitute[j] }); + } + } + } + } + return substitutions; + }; + + /** + * List all alternates (lookup type 3) for a given script, language, and feature. + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + * @param {string} feature - 4-character feature name ('aalt', 'salt'...) + * @return {Array} alternates - The list of alternates + */ + Substitution.prototype.getAlternates = function(feature, script, language) { + var this$1 = this; + + var alternates = []; + var lookupTables = this.getLookupTables(script, language, feature, 3); + for (var idx = 0; idx < lookupTables.length; idx++) { + var subtables = lookupTables[idx].subtables; + for (var i = 0; i < subtables.length; i++) { + var subtable = subtables[i]; + var glyphs = this$1.expandCoverage(subtable.coverage); + var alternateSets = subtable.alternateSets; + for (var j = 0; j < glyphs.length; j++) { + alternates.push({ sub: glyphs[j], by: alternateSets[j] }); + } + } + } + return alternates; + }; + + /** + * List all ligatures (lookup type 4) for a given script, language, and feature. + * The result is an array of ligature objects like { sub: [ids], by: id } + * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...) + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + * @return {Array} ligatures - The list of ligatures. + */ + Substitution.prototype.getLigatures = function(feature, script, language) { + var this$1 = this; + + var ligatures = []; + var lookupTables = this.getLookupTables(script, language, feature, 4); + for (var idx = 0; idx < lookupTables.length; idx++) { + var subtables = lookupTables[idx].subtables; + for (var i = 0; i < subtables.length; i++) { + var subtable = subtables[i]; + var glyphs = this$1.expandCoverage(subtable.coverage); + var ligatureSets = subtable.ligatureSets; + for (var j = 0; j < glyphs.length; j++) { + var startGlyph = glyphs[j]; + var ligSet = ligatureSets[j]; + for (var k = 0; k < ligSet.length; k++) { + var lig = ligSet[k]; + ligatures.push({ + sub: [startGlyph].concat(lig.components), + by: lig.ligGlyph + }); + } + } + } + } + return ligatures; + }; + + /** + * Add or modify a single substitution (lookup type 1) + * Format 2, more flexible, is always used. + * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...) + * @param {Object} substitution - { sub: id, delta: number } for format 1 or { sub: id, by: id } for format 2. + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + */ + Substitution.prototype.addSingle = function(feature, substitution, script, language) { + var lookupTable = this.getLookupTables(script, language, feature, 1, true)[0]; + var subtable = getSubstFormat(lookupTable, 2, { // lookup type 1 subtable, format 2, coverage format 1 + substFormat: 2, + coverage: {format: 1, glyphs: []}, + substitute: [] + }); + check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format); + var coverageGlyph = substitution.sub; + var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph); + if (pos < 0) { + pos = -1 - pos; + subtable.coverage.glyphs.splice(pos, 0, coverageGlyph); + subtable.substitute.splice(pos, 0, 0); + } + subtable.substitute[pos] = substitution.by; + }; + + /** + * Add or modify an alternate substitution (lookup type 1) + * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...) + * @param {Object} substitution - { sub: id, by: [ids] } + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + */ + Substitution.prototype.addAlternate = function(feature, substitution, script, language) { + var lookupTable = this.getLookupTables(script, language, feature, 3, true)[0]; + var subtable = getSubstFormat(lookupTable, 1, { // lookup type 3 subtable, format 1, coverage format 1 + substFormat: 1, + coverage: {format: 1, glyphs: []}, + alternateSets: [] + }); + check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format); + var coverageGlyph = substitution.sub; + var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph); + if (pos < 0) { + pos = -1 - pos; + subtable.coverage.glyphs.splice(pos, 0, coverageGlyph); + subtable.alternateSets.splice(pos, 0, 0); + } + subtable.alternateSets[pos] = substitution.by; + }; + + /** + * Add a ligature (lookup type 4) + * Ligatures with more components must be stored ahead of those with fewer components in order to be found + * @param {string} feature - 4-letter feature name ('liga', 'rlig', 'dlig'...) + * @param {Object} ligature - { sub: [ids], by: id } + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + */ + Substitution.prototype.addLigature = function(feature, ligature, script, language) { + var lookupTable = this.getLookupTables(script, language, feature, 4, true)[0]; + var subtable = lookupTable.subtables[0]; + if (!subtable) { + subtable = { // lookup type 4 subtable, format 1, coverage format 1 + substFormat: 1, + coverage: { format: 1, glyphs: [] }, + ligatureSets: [] + }; + lookupTable.subtables[0] = subtable; + } + check.assert(subtable.coverage.format === 1, 'Ligature: unable to modify coverage table format ' + subtable.coverage.format); + var coverageGlyph = ligature.sub[0]; + var ligComponents = ligature.sub.slice(1); + var ligatureTable = { + ligGlyph: ligature.by, + components: ligComponents + }; + var pos = this.binSearch(subtable.coverage.glyphs, coverageGlyph); + if (pos >= 0) { + // ligatureSet already exists + var ligatureSet = subtable.ligatureSets[pos]; + for (var i = 0; i < ligatureSet.length; i++) { + // If ligature already exists, return. + if (arraysEqual(ligatureSet[i].components, ligComponents)) { + return; + } + } + // ligature does not exist: add it. + ligatureSet.push(ligatureTable); + } else { + // Create a new ligatureSet and add coverage for the first glyph. + pos = -1 - pos; + subtable.coverage.glyphs.splice(pos, 0, coverageGlyph); + subtable.ligatureSets.splice(pos, 0, [ligatureTable]); + } + }; + + /** + * List all feature data for a given script and language. + * @param {string} feature - 4-letter feature name + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + * @return {Array} substitutions - The list of substitutions. + */ + Substitution.prototype.getFeature = function(feature, script, language) { + if (/ss\d\d/.test(feature)) { + // ss01 - ss20 + return this.getSingle(feature, script, language); + } + switch (feature) { + case 'aalt': + case 'salt': + return this.getSingle(feature, script, language) + .concat(this.getAlternates(feature, script, language)); + case 'dlig': + case 'liga': + case 'rlig': return this.getLigatures(feature, script, language); + } + return undefined; + }; + + /** + * Add a substitution to a feature for a given script and language. + * @param {string} feature - 4-letter feature name + * @param {Object} sub - the substitution to add (an object like { sub: id or [ids], by: id or [ids] }) + * @param {string} [script='DFLT'] + * @param {string} [language='dflt'] + */ + Substitution.prototype.add = function(feature, sub, script, language) { + if (/ss\d\d/.test(feature)) { + // ss01 - ss20 + return this.addSingle(feature, sub, script, language); + } + switch (feature) { + case 'aalt': + case 'salt': + if (typeof sub.by === 'number') { + return this.addSingle(feature, sub, script, language); + } + return this.addAlternate(feature, sub, script, language); + case 'dlig': + case 'liga': + case 'rlig': + return this.addLigature(feature, sub, script, language); + } + return undefined; + }; + + function isBrowser() { + return typeof window !== 'undefined'; + } + + function nodeBufferToArrayBuffer(buffer) { + var ab = new ArrayBuffer(buffer.length); + var view = new Uint8Array(ab); + for (var i = 0; i < buffer.length; ++i) { + view[i] = buffer[i]; + } + + return ab; + } + + function arrayBufferToNodeBuffer(ab) { + var buffer = new Buffer(ab.byteLength); + var view = new Uint8Array(ab); + for (var i = 0; i < buffer.length; ++i) { + buffer[i] = view[i]; + } + + return buffer; + } + + function checkArgument(expression, message) { + if (!expression) { + throw message; + } + } + + // The `glyf` table describes the glyphs in TrueType outline format. + + // Parse the coordinate data for a glyph. + function parseGlyphCoordinate(p, flag, previousValue, shortVectorBitMask, sameBitMask) { + var v; + if ((flag & shortVectorBitMask) > 0) { + // The coordinate is 1 byte long. + v = p.parseByte(); + // The `same` bit is re-used for short values to signify the sign of the value. + if ((flag & sameBitMask) === 0) { + v = -v; + } + + v = previousValue + v; + } else { + // The coordinate is 2 bytes long. + // If the `same` bit is set, the coordinate is the same as the previous coordinate. + if ((flag & sameBitMask) > 0) { + v = previousValue; + } else { + // Parse the coordinate as a signed 16-bit delta value. + v = previousValue + p.parseShort(); + } + } + + return v; + } + + // Parse a TrueType glyph. + function parseGlyph(glyph, data, start) { + var p = new parse.Parser(data, start); + glyph.numberOfContours = p.parseShort(); + glyph._xMin = p.parseShort(); + glyph._yMin = p.parseShort(); + glyph._xMax = p.parseShort(); + glyph._yMax = p.parseShort(); + var flags; + var flag; + + if (glyph.numberOfContours > 0) { + // This glyph is not a composite. + var endPointIndices = glyph.endPointIndices = []; + for (var i = 0; i < glyph.numberOfContours; i += 1) { + endPointIndices.push(p.parseUShort()); + } + + glyph.instructionLength = p.parseUShort(); + glyph.instructions = []; + for (var i$1 = 0; i$1 < glyph.instructionLength; i$1 += 1) { + glyph.instructions.push(p.parseByte()); + } + + var numberOfCoordinates = endPointIndices[endPointIndices.length - 1] + 1; + flags = []; + for (var i$2 = 0; i$2 < numberOfCoordinates; i$2 += 1) { + flag = p.parseByte(); + flags.push(flag); + // If bit 3 is set, we repeat this flag n times, where n is the next byte. + if ((flag & 8) > 0) { + var repeatCount = p.parseByte(); + for (var j = 0; j < repeatCount; j += 1) { + flags.push(flag); + i$2 += 1; + } + } + } + + check.argument(flags.length === numberOfCoordinates, 'Bad flags.'); + + if (endPointIndices.length > 0) { + var points = []; + var point; + // X/Y coordinates are relative to the previous point, except for the first point which is relative to 0,0. + if (numberOfCoordinates > 0) { + for (var i$3 = 0; i$3 < numberOfCoordinates; i$3 += 1) { + flag = flags[i$3]; + point = {}; + point.onCurve = !!(flag & 1); + point.lastPointOfContour = endPointIndices.indexOf(i$3) >= 0; + points.push(point); + } + + var px = 0; + for (var i$4 = 0; i$4 < numberOfCoordinates; i$4 += 1) { + flag = flags[i$4]; + point = points[i$4]; + point.x = parseGlyphCoordinate(p, flag, px, 2, 16); + px = point.x; + } + + var py = 0; + for (var i$5 = 0; i$5 < numberOfCoordinates; i$5 += 1) { + flag = flags[i$5]; + point = points[i$5]; + point.y = parseGlyphCoordinate(p, flag, py, 4, 32); + py = point.y; + } + } + + glyph.points = points; + } else { + glyph.points = []; + } + } else if (glyph.numberOfContours === 0) { + glyph.points = []; + } else { + glyph.isComposite = true; + glyph.points = []; + glyph.components = []; + var moreComponents = true; + while (moreComponents) { + flags = p.parseUShort(); + var component = { + glyphIndex: p.parseUShort(), + xScale: 1, + scale01: 0, + scale10: 0, + yScale: 1, + dx: 0, + dy: 0 + }; + if ((flags & 1) > 0) { + // The arguments are words + if ((flags & 2) > 0) { + // values are offset + component.dx = p.parseShort(); + component.dy = p.parseShort(); + } else { + // values are matched points + component.matchedPoints = [p.parseUShort(), p.parseUShort()]; + } + + } else { + // The arguments are bytes + if ((flags & 2) > 0) { + // values are offset + component.dx = p.parseChar(); + component.dy = p.parseChar(); + } else { + // values are matched points + component.matchedPoints = [p.parseByte(), p.parseByte()]; + } + } + + if ((flags & 8) > 0) { + // We have a scale + component.xScale = component.yScale = p.parseF2Dot14(); + } else if ((flags & 64) > 0) { + // We have an X / Y scale + component.xScale = p.parseF2Dot14(); + component.yScale = p.parseF2Dot14(); + } else if ((flags & 128) > 0) { + // We have a 2x2 transformation + component.xScale = p.parseF2Dot14(); + component.scale01 = p.parseF2Dot14(); + component.scale10 = p.parseF2Dot14(); + component.yScale = p.parseF2Dot14(); + } + + glyph.components.push(component); + moreComponents = !!(flags & 32); + } + if (flags & 0x100) { + // We have instructions + glyph.instructionLength = p.parseUShort(); + glyph.instructions = []; + for (var i$6 = 0; i$6 < glyph.instructionLength; i$6 += 1) { + glyph.instructions.push(p.parseByte()); + } + } + } + } + + // Transform an array of points and return a new array. + function transformPoints(points, transform) { + var newPoints = []; + for (var i = 0; i < points.length; i += 1) { + var pt = points[i]; + var newPt = { + x: transform.xScale * pt.x + transform.scale01 * pt.y + transform.dx, + y: transform.scale10 * pt.x + transform.yScale * pt.y + transform.dy, + onCurve: pt.onCurve, + lastPointOfContour: pt.lastPointOfContour + }; + newPoints.push(newPt); + } + + return newPoints; + } + + function getContours(points) { + var contours = []; + var currentContour = []; + for (var i = 0; i < points.length; i += 1) { + var pt = points[i]; + currentContour.push(pt); + if (pt.lastPointOfContour) { + contours.push(currentContour); + currentContour = []; + } + } + + check.argument(currentContour.length === 0, 'There are still points left in the current contour.'); + return contours; + } + + // Convert the TrueType glyph outline to a Path. + function getPath(points) { + var p = new Path(); + if (!points) { + return p; + } + + var contours = getContours(points); + + for (var contourIndex = 0; contourIndex < contours.length; ++contourIndex) { + var contour = contours[contourIndex]; + + var prev = null; + var curr = contour[contour.length - 1]; + var next = contour[0]; + + if (curr.onCurve) { + p.moveTo(curr.x, curr.y); + } else { + if (next.onCurve) { + p.moveTo(next.x, next.y); + } else { + // If both first and last points are off-curve, start at their middle. + var start = {x: (curr.x + next.x) * 0.5, y: (curr.y + next.y) * 0.5}; + p.moveTo(start.x, start.y); + } + } + + for (var i = 0; i < contour.length; ++i) { + prev = curr; + curr = next; + next = contour[(i + 1) % contour.length]; + + if (curr.onCurve) { + // This is a straight line. + p.lineTo(curr.x, curr.y); + } else { + var prev2 = prev; + var next2 = next; + + if (!prev.onCurve) { + prev2 = { x: (curr.x + prev.x) * 0.5, y: (curr.y + prev.y) * 0.5 }; + } + + if (!next.onCurve) { + next2 = { x: (curr.x + next.x) * 0.5, y: (curr.y + next.y) * 0.5 }; + } + + p.quadraticCurveTo(curr.x, curr.y, next2.x, next2.y); + } + } + + p.closePath(); + } + return p; + } + + function buildPath(glyphs, glyph) { + if (glyph.isComposite) { + for (var j = 0; j < glyph.components.length; j += 1) { + var component = glyph.components[j]; + var componentGlyph = glyphs.get(component.glyphIndex); + // Force the ttfGlyphLoader to parse the glyph. + componentGlyph.getPath(); + if (componentGlyph.points) { + var transformedPoints = (void 0); + if (component.matchedPoints === undefined) { + // component positioned by offset + transformedPoints = transformPoints(componentGlyph.points, component); + } else { + // component positioned by matched points + if ((component.matchedPoints[0] > glyph.points.length - 1) || + (component.matchedPoints[1] > componentGlyph.points.length - 1)) { + throw Error('Matched points out of range in ' + glyph.name); + } + var firstPt = glyph.points[component.matchedPoints[0]]; + var secondPt = componentGlyph.points[component.matchedPoints[1]]; + var transform = { + xScale: component.xScale, scale01: component.scale01, + scale10: component.scale10, yScale: component.yScale, + dx: 0, dy: 0 + }; + secondPt = transformPoints([secondPt], transform)[0]; + transform.dx = firstPt.x - secondPt.x; + transform.dy = firstPt.y - secondPt.y; + transformedPoints = transformPoints(componentGlyph.points, transform); + } + glyph.points = glyph.points.concat(transformedPoints); + } + } + } + + return getPath(glyph.points); + } + + // Parse all the glyphs according to the offsets from the `loca` table. + function parseGlyfTable(data, start, loca, font) { + var glyphs = new glyphset.GlyphSet(font); + + // The last element of the loca table is invalid. + for (var i = 0; i < loca.length - 1; i += 1) { + var offset = loca[i]; + var nextOffset = loca[i + 1]; + if (offset !== nextOffset) { + glyphs.push(i, glyphset.ttfGlyphLoader(font, i, parseGlyph, data, start + offset, buildPath)); + } else { + glyphs.push(i, glyphset.glyphLoader(font, i)); + } + } + + return glyphs; + } + + var glyf = { getPath: getPath, parse: parseGlyfTable }; + + /* A TrueType font hinting interpreter. + * + * (c) 2017 Axel Kittenberger + * + * This interpreter has been implemented according to this documentation: + * https://developer.apple.com/fonts/TrueType-Reference-Manual/RM05/Chap5.html + * + * According to the documentation F24DOT6 values are used for pixels. + * That means calculation is 1/64 pixel accurate and uses integer operations. + * However, Javascript has floating point operations by default and only + * those are available. One could make a case to simulate the 1/64 accuracy + * exactly by truncating after every division operation + * (for example with << 0) to get pixel exactly results as other TrueType + * implementations. It may make sense since some fonts are pixel optimized + * by hand using DELTAP instructions. The current implementation doesn't + * and rather uses full floating point precision. + * + * xScale, yScale and rotation is currently ignored. + * + * A few non-trivial instructions are missing as I didn't encounter yet + * a font that used them to test a possible implementation. + * + * Some fonts seem to use undocumented features regarding the twilight zone. + * Only some of them are implemented as they were encountered. + * + * The exports.DEBUG statements are removed on the minified distribution file. + */ + + var instructionTable; + var exec; + var execGlyph; + var execComponent; + + /* + * Creates a hinting object. + * + * There ought to be exactly one + * for each truetype font that is used for hinting. + */ + function Hinting(font) { + // the font this hinting object is for + this.font = font; + + this.getCommands = function (hPoints) { + return glyf.getPath(hPoints).commands; + }; + + // cached states + this._fpgmState = + this._prepState = + undefined; + + // errorState + // 0 ... all okay + // 1 ... had an error in a glyf, + // continue working but stop spamming + // the console + // 2 ... error at prep, stop hinting at this ppem + // 3 ... error at fpeg, stop hinting for this font at all + this._errorState = 0; + } + + /* + * Not rounding. + */ + function roundOff(v) { + return v; + } + + /* + * Rounding to grid. + */ + function roundToGrid(v) { + //Rounding in TT is supposed to "symmetrical around zero" + return Math.sign(v) * Math.round(Math.abs(v)); + } + + /* + * Rounding to double grid. + */ + function roundToDoubleGrid(v) { + return Math.sign(v) * Math.round(Math.abs(v * 2)) / 2; + } + + /* + * Rounding to half grid. + */ + function roundToHalfGrid(v) { + return Math.sign(v) * (Math.round(Math.abs(v) + 0.5) - 0.5); + } + + /* + * Rounding to up to grid. + */ + function roundUpToGrid(v) { + return Math.sign(v) * Math.ceil(Math.abs(v)); + } + + /* + * Rounding to down to grid. + */ + function roundDownToGrid(v) { + return Math.sign(v) * Math.floor(Math.abs(v)); + } + + /* + * Super rounding. + */ + var roundSuper = function (v) { + var period = this.srPeriod; + var phase = this.srPhase; + var threshold = this.srThreshold; + var sign = 1; + + if (v < 0) { + v = -v; + sign = -1; + } + + v += threshold - phase; + + v = Math.trunc(v / period) * period; + + v += phase; + + // according to http://xgridfit.sourceforge.net/round.html + if (v < 0) { return phase * sign; } + + return v * sign; + }; + + /* + * Unit vector of x-axis. + */ + var xUnitVector = { + x: 1, + + y: 0, + + axis: 'x', + + // Gets the projected distance between two points. + // o1/o2 ... if true, respective original position is used. + distance: function (p1, p2, o1, o2) { + return (o1 ? p1.xo : p1.x) - (o2 ? p2.xo : p2.x); + }, + + // Moves point p so the moved position has the same relative + // position to the moved positions of rp1 and rp2 than the + // original positions had. + // + // See APPENDIX on INTERPOLATE at the bottom of this file. + interpolate: function (p, rp1, rp2, pv) { + var do1; + var do2; + var doa1; + var doa2; + var dm1; + var dm2; + var dt; + + if (!pv || pv === this) { + do1 = p.xo - rp1.xo; + do2 = p.xo - rp2.xo; + dm1 = rp1.x - rp1.xo; + dm2 = rp2.x - rp2.xo; + doa1 = Math.abs(do1); + doa2 = Math.abs(do2); + dt = doa1 + doa2; + + if (dt === 0) { + p.x = p.xo + (dm1 + dm2) / 2; + return; + } + + p.x = p.xo + (dm1 * doa2 + dm2 * doa1) / dt; + return; + } + + do1 = pv.distance(p, rp1, true, true); + do2 = pv.distance(p, rp2, true, true); + dm1 = pv.distance(rp1, rp1, false, true); + dm2 = pv.distance(rp2, rp2, false, true); + doa1 = Math.abs(do1); + doa2 = Math.abs(do2); + dt = doa1 + doa2; + + if (dt === 0) { + xUnitVector.setRelative(p, p, (dm1 + dm2) / 2, pv, true); + return; + } + + xUnitVector.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true); + }, + + // Slope of line normal to this + normalSlope: Number.NEGATIVE_INFINITY, + + // Sets the point 'p' relative to point 'rp' + // by the distance 'd'. + // + // See APPENDIX on SETRELATIVE at the bottom of this file. + // + // p ... point to set + // rp ... reference point + // d ... distance on projection vector + // pv ... projection vector (undefined = this) + // org ... if true, uses the original position of rp as reference. + setRelative: function (p, rp, d, pv, org) { + if (!pv || pv === this) { + p.x = (org ? rp.xo : rp.x) + d; + return; + } + + var rpx = org ? rp.xo : rp.x; + var rpy = org ? rp.yo : rp.y; + var rpdx = rpx + d * pv.x; + var rpdy = rpy + d * pv.y; + + p.x = rpdx + (p.y - rpdy) / pv.normalSlope; + }, + + // Slope of vector line. + slope: 0, + + // Touches the point p. + touch: function (p) { + p.xTouched = true; + }, + + // Tests if a point p is touched. + touched: function (p) { + return p.xTouched; + }, + + // Untouches the point p. + untouch: function (p) { + p.xTouched = false; + } + }; + + /* + * Unit vector of y-axis. + */ + var yUnitVector = { + x: 0, + + y: 1, + + axis: 'y', + + // Gets the projected distance between two points. + // o1/o2 ... if true, respective original position is used. + distance: function (p1, p2, o1, o2) { + return (o1 ? p1.yo : p1.y) - (o2 ? p2.yo : p2.y); + }, + + // Moves point p so the moved position has the same relative + // position to the moved positions of rp1 and rp2 than the + // original positions had. + // + // See APPENDIX on INTERPOLATE at the bottom of this file. + interpolate: function (p, rp1, rp2, pv) { + var do1; + var do2; + var doa1; + var doa2; + var dm1; + var dm2; + var dt; + + if (!pv || pv === this) { + do1 = p.yo - rp1.yo; + do2 = p.yo - rp2.yo; + dm1 = rp1.y - rp1.yo; + dm2 = rp2.y - rp2.yo; + doa1 = Math.abs(do1); + doa2 = Math.abs(do2); + dt = doa1 + doa2; + + if (dt === 0) { + p.y = p.yo + (dm1 + dm2) / 2; + return; + } + + p.y = p.yo + (dm1 * doa2 + dm2 * doa1) / dt; + return; + } + + do1 = pv.distance(p, rp1, true, true); + do2 = pv.distance(p, rp2, true, true); + dm1 = pv.distance(rp1, rp1, false, true); + dm2 = pv.distance(rp2, rp2, false, true); + doa1 = Math.abs(do1); + doa2 = Math.abs(do2); + dt = doa1 + doa2; + + if (dt === 0) { + yUnitVector.setRelative(p, p, (dm1 + dm2) / 2, pv, true); + return; + } + + yUnitVector.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true); + }, + + // Slope of line normal to this. + normalSlope: 0, + + // Sets the point 'p' relative to point 'rp' + // by the distance 'd' + // + // See APPENDIX on SETRELATIVE at the bottom of this file. + // + // p ... point to set + // rp ... reference point + // d ... distance on projection vector + // pv ... projection vector (undefined = this) + // org ... if true, uses the original position of rp as reference. + setRelative: function (p, rp, d, pv, org) { + if (!pv || pv === this) { + p.y = (org ? rp.yo : rp.y) + d; + return; + } + + var rpx = org ? rp.xo : rp.x; + var rpy = org ? rp.yo : rp.y; + var rpdx = rpx + d * pv.x; + var rpdy = rpy + d * pv.y; + + p.y = rpdy + pv.normalSlope * (p.x - rpdx); + }, + + // Slope of vector line. + slope: Number.POSITIVE_INFINITY, + + // Touches the point p. + touch: function (p) { + p.yTouched = true; + }, + + // Tests if a point p is touched. + touched: function (p) { + return p.yTouched; + }, + + // Untouches the point p. + untouch: function (p) { + p.yTouched = false; + } + }; + + Object.freeze(xUnitVector); + Object.freeze(yUnitVector); + + /* + * Creates a unit vector that is not x- or y-axis. + */ + function UnitVector(x, y) { + this.x = x; + this.y = y; + this.axis = undefined; + this.slope = y / x; + this.normalSlope = -x / y; + Object.freeze(this); + } + + /* + * Gets the projected distance between two points. + * o1/o2 ... if true, respective original position is used. + */ + UnitVector.prototype.distance = function(p1, p2, o1, o2) { + return ( + this.x * xUnitVector.distance(p1, p2, o1, o2) + + this.y * yUnitVector.distance(p1, p2, o1, o2) + ); + }; + + /* + * Moves point p so the moved position has the same relative + * position to the moved positions of rp1 and rp2 than the + * original positions had. + * + * See APPENDIX on INTERPOLATE at the bottom of this file. + */ + UnitVector.prototype.interpolate = function(p, rp1, rp2, pv) { + var dm1; + var dm2; + var do1; + var do2; + var doa1; + var doa2; + var dt; + + do1 = pv.distance(p, rp1, true, true); + do2 = pv.distance(p, rp2, true, true); + dm1 = pv.distance(rp1, rp1, false, true); + dm2 = pv.distance(rp2, rp2, false, true); + doa1 = Math.abs(do1); + doa2 = Math.abs(do2); + dt = doa1 + doa2; + + if (dt === 0) { + this.setRelative(p, p, (dm1 + dm2) / 2, pv, true); + return; + } + + this.setRelative(p, p, (dm1 * doa2 + dm2 * doa1) / dt, pv, true); + }; + + /* + * Sets the point 'p' relative to point 'rp' + * by the distance 'd' + * + * See APPENDIX on SETRELATIVE at the bottom of this file. + * + * p ... point to set + * rp ... reference point + * d ... distance on projection vector + * pv ... projection vector (undefined = this) + * org ... if true, uses the original position of rp as reference. + */ + UnitVector.prototype.setRelative = function(p, rp, d, pv, org) { + pv = pv || this; + + var rpx = org ? rp.xo : rp.x; + var rpy = org ? rp.yo : rp.y; + var rpdx = rpx + d * pv.x; + var rpdy = rpy + d * pv.y; + + var pvns = pv.normalSlope; + var fvs = this.slope; + + var px = p.x; + var py = p.y; + + p.x = (fvs * px - pvns * rpdx + rpdy - py) / (fvs - pvns); + p.y = fvs * (p.x - px) + py; + }; + + /* + * Touches the point p. + */ + UnitVector.prototype.touch = function(p) { + p.xTouched = true; + p.yTouched = true; + }; + + /* + * Returns a unit vector with x/y coordinates. + */ + function getUnitVector(x, y) { + var d = Math.sqrt(x * x + y * y); + + x /= d; + y /= d; + + if (x === 1 && y === 0) { return xUnitVector; } + else if (x === 0 && y === 1) { return yUnitVector; } + else { return new UnitVector(x, y); } + } + + /* + * Creates a point in the hinting engine. + */ + function HPoint( + x, + y, + lastPointOfContour, + onCurve + ) { + this.x = this.xo = Math.round(x * 64) / 64; // hinted x value and original x-value + this.y = this.yo = Math.round(y * 64) / 64; // hinted y value and original y-value + + this.lastPointOfContour = lastPointOfContour; + this.onCurve = onCurve; + this.prevPointOnContour = undefined; + this.nextPointOnContour = undefined; + this.xTouched = false; + this.yTouched = false; + + Object.preventExtensions(this); + } + + /* + * Returns the next touched point on the contour. + * + * v ... unit vector to test touch axis. + */ + HPoint.prototype.nextTouched = function(v) { + var p = this.nextPointOnContour; + + while (!v.touched(p) && p !== this) { p = p.nextPointOnContour; } + + return p; + }; + + /* + * Returns the previous touched point on the contour + * + * v ... unit vector to test touch axis. + */ + HPoint.prototype.prevTouched = function(v) { + var p = this.prevPointOnContour; + + while (!v.touched(p) && p !== this) { p = p.prevPointOnContour; } + + return p; + }; + + /* + * The zero point. + */ + var HPZero = Object.freeze(new HPoint(0, 0)); + + /* + * The default state of the interpreter. + * + * Note: Freezing the defaultState and then deriving from it + * makes the V8 Javascript engine going awkward, + * so this is avoided, albeit the defaultState shouldn't + * ever change. + */ + var defaultState = { + cvCutIn: 17 / 16, // control value cut in + deltaBase: 9, + deltaShift: 0.125, + loop: 1, // loops some instructions + minDis: 1, // minimum distance + autoFlip: true + }; + + /* + * The current state of the interpreter. + * + * env ... 'fpgm' or 'prep' or 'glyf' + * prog ... the program + */ + function State(env, prog) { + this.env = env; + this.stack = []; + this.prog = prog; + + switch (env) { + case 'glyf' : + this.zp0 = this.zp1 = this.zp2 = 1; + this.rp0 = this.rp1 = this.rp2 = 0; + /* fall through */ + case 'prep' : + this.fv = this.pv = this.dpv = xUnitVector; + this.round = roundToGrid; + } + } + + /* + * Executes a glyph program. + * + * This does the hinting for each glyph. + * + * Returns an array of moved points. + * + * glyph: the glyph to hint + * ppem: the size the glyph is rendered for + */ + Hinting.prototype.exec = function(glyph, ppem) { + if (typeof ppem !== 'number') { + throw new Error('Point size is not a number!'); + } + + // Received a fatal error, don't do any hinting anymore. + if (this._errorState > 2) { return; } + + var font = this.font; + var prepState = this._prepState; + + if (!prepState || prepState.ppem !== ppem) { + var fpgmState = this._fpgmState; + + if (!fpgmState) { + // Executes the fpgm state. + // This is used by fonts to define functions. + State.prototype = defaultState; + + fpgmState = + this._fpgmState = + new State('fpgm', font.tables.fpgm); + + fpgmState.funcs = [ ]; + fpgmState.font = font; + + if (exports.DEBUG) { + console.log('---EXEC FPGM---'); + fpgmState.step = -1; + } + + try { + exec(fpgmState); + } catch (e) { + console.log('Hinting error in FPGM:' + e); + this._errorState = 3; + return; + } + } + + // Executes the prep program for this ppem setting. + // This is used by fonts to set cvt values + // depending on to be rendered font size. + + State.prototype = fpgmState; + prepState = + this._prepState = + new State('prep', font.tables.prep); + + prepState.ppem = ppem; + + // Creates a copy of the cvt table + // and scales it to the current ppem setting. + var oCvt = font.tables.cvt; + if (oCvt) { + var cvt = prepState.cvt = new Array(oCvt.length); + var scale = ppem / font.unitsPerEm; + for (var c = 0; c < oCvt.length; c++) { + cvt[c] = oCvt[c] * scale; + } + } else { + prepState.cvt = []; + } + + if (exports.DEBUG) { + console.log('---EXEC PREP---'); + prepState.step = -1; + } + + try { + exec(prepState); + } catch (e) { + if (this._errorState < 2) { + console.log('Hinting error in PREP:' + e); + } + this._errorState = 2; + } + } + + if (this._errorState > 1) { return; } + + try { + return execGlyph(glyph, prepState); + } catch (e) { + if (this._errorState < 1) { + console.log('Hinting error:' + e); + console.log('Note: further hinting errors are silenced'); + } + this._errorState = 1; + return undefined; + } + }; + + /* + * Executes the hinting program for a glyph. + */ + execGlyph = function(glyph, prepState) { + // original point positions + var xScale = prepState.ppem / prepState.font.unitsPerEm; + var yScale = xScale; + var components = glyph.components; + var contours; + var gZone; + var state; + + State.prototype = prepState; + if (!components) { + state = new State('glyf', glyph.instructions); + if (exports.DEBUG) { + console.log('---EXEC GLYPH---'); + state.step = -1; + } + execComponent(glyph, state, xScale, yScale); + gZone = state.gZone; + } else { + var font = prepState.font; + gZone = []; + contours = []; + for (var i = 0; i < components.length; i++) { + var c = components[i]; + var cg = font.glyphs.get(c.glyphIndex); + + state = new State('glyf', cg.instructions); + + if (exports.DEBUG) { + console.log('---EXEC COMP ' + i + '---'); + state.step = -1; + } + + execComponent(cg, state, xScale, yScale); + // appends the computed points to the result array + // post processes the component points + var dx = Math.round(c.dx * xScale); + var dy = Math.round(c.dy * yScale); + var gz = state.gZone; + var cc = state.contours; + for (var pi = 0; pi < gz.length; pi++) { + var p = gz[pi]; + p.xTouched = p.yTouched = false; + p.xo = p.x = p.x + dx; + p.yo = p.y = p.y + dy; + } + + var gLen = gZone.length; + gZone.push.apply(gZone, gz); + for (var j = 0; j < cc.length; j++) { + contours.push(cc[j] + gLen); + } + } + + if (glyph.instructions && !state.inhibitGridFit) { + // the composite has instructions on its own + state = new State('glyf', glyph.instructions); + + state.gZone = state.z0 = state.z1 = state.z2 = gZone; + + state.contours = contours; + + // note: HPZero cannot be used here, since + // the point might be modified + gZone.push( + new HPoint(0, 0), + new HPoint(Math.round(glyph.advanceWidth * xScale), 0) + ); + + if (exports.DEBUG) { + console.log('---EXEC COMPOSITE---'); + state.step = -1; + } + + exec(state); + + gZone.length -= 2; + } + } + + return gZone; + }; + + /* + * Executes the hinting program for a component of a multi-component glyph + * or of the glyph itself for a non-component glyph. + */ + execComponent = function(glyph, state, xScale, yScale) + { + var points = glyph.points || []; + var pLen = points.length; + var gZone = state.gZone = state.z0 = state.z1 = state.z2 = []; + var contours = state.contours = []; + + // Scales the original points and + // makes copies for the hinted points. + var cp; // current point + for (var i = 0; i < pLen; i++) { + cp = points[i]; + + gZone[i] = new HPoint( + cp.x * xScale, + cp.y * yScale, + cp.lastPointOfContour, + cp.onCurve + ); + } + + // Chain links the contours. + var sp; // start point + var np; // next point + + for (var i$1 = 0; i$1 < pLen; i$1++) { + cp = gZone[i$1]; + + if (!sp) { + sp = cp; + contours.push(i$1); + } + + if (cp.lastPointOfContour) { + cp.nextPointOnContour = sp; + sp.prevPointOnContour = cp; + sp = undefined; + } else { + np = gZone[i$1 + 1]; + cp.nextPointOnContour = np; + np.prevPointOnContour = cp; + } + } + + if (state.inhibitGridFit) { return; } + + if (exports.DEBUG) { + console.log('PROCESSING GLYPH', state.stack); + for (var i$2 = 0; i$2 < pLen; i$2++) { + console.log(i$2, gZone[i$2].x, gZone[i$2].y); + } + } + + gZone.push( + new HPoint(0, 0), + new HPoint(Math.round(glyph.advanceWidth * xScale), 0) + ); + + exec(state); + + // Removes the extra points. + gZone.length -= 2; + + if (exports.DEBUG) { + console.log('FINISHED GLYPH', state.stack); + for (var i$3 = 0; i$3 < pLen; i$3++) { + console.log(i$3, gZone[i$3].x, gZone[i$3].y); + } + } + }; + + /* + * Executes the program loaded in state. + */ + exec = function(state) { + var prog = state.prog; + + if (!prog) { return; } + + var pLen = prog.length; + var ins; + + for (state.ip = 0; state.ip < pLen; state.ip++) { + if (exports.DEBUG) { state.step++; } + ins = instructionTable[prog[state.ip]]; + + if (!ins) { + throw new Error( + 'unknown instruction: 0x' + + Number(prog[state.ip]).toString(16) + ); + } + + ins(state); + + // very extensive debugging for each step + /* + if (exports.DEBUG) { + var da; + if (state.gZone) { + da = []; + for (let i = 0; i < state.gZone.length; i++) + { + da.push(i + ' ' + + state.gZone[i].x * 64 + ' ' + + state.gZone[i].y * 64 + ' ' + + (state.gZone[i].xTouched ? 'x' : '') + + (state.gZone[i].yTouched ? 'y' : '') + ); + } + console.log('GZ', da); + } + + if (state.tZone) { + da = []; + for (let i = 0; i < state.tZone.length; i++) { + da.push(i + ' ' + + state.tZone[i].x * 64 + ' ' + + state.tZone[i].y * 64 + ' ' + + (state.tZone[i].xTouched ? 'x' : '') + + (state.tZone[i].yTouched ? 'y' : '') + ); + } + console.log('TZ', da); + } + + if (state.stack.length > 10) { + console.log( + state.stack.length, + '...', state.stack.slice(state.stack.length - 10) + ); + } else { + console.log(state.stack.length, state.stack); + } + } + */ + } + }; + + /* + * Initializes the twilight zone. + * + * This is only done if a SZPx instruction + * refers to the twilight zone. + */ + function initTZone(state) + { + var tZone = state.tZone = new Array(state.gZone.length); + + // no idea if this is actually correct... + for (var i = 0; i < tZone.length; i++) + { + tZone[i] = new HPoint(0, 0); + } + } + + /* + * Skips the instruction pointer ahead over an IF/ELSE block. + * handleElse .. if true breaks on matching ELSE + */ + function skip(state, handleElse) + { + var prog = state.prog; + var ip = state.ip; + var nesting = 1; + var ins; + + do { + ins = prog[++ip]; + if (ins === 0x58) // IF + { nesting++; } + else if (ins === 0x59) // EIF + { nesting--; } + else if (ins === 0x40) // NPUSHB + { ip += prog[ip + 1] + 1; } + else if (ins === 0x41) // NPUSHW + { ip += 2 * prog[ip + 1] + 1; } + else if (ins >= 0xB0 && ins <= 0xB7) // PUSHB + { ip += ins - 0xB0 + 1; } + else if (ins >= 0xB8 && ins <= 0xBF) // PUSHW + { ip += (ins - 0xB8 + 1) * 2; } + else if (handleElse && nesting === 1 && ins === 0x1B) // ELSE + { break; } + } while (nesting > 0); + + state.ip = ip; + } + + /*----------------------------------------------------------* + * And then a lot of instructions... * + *----------------------------------------------------------*/ + + // SVTCA[a] Set freedom and projection Vectors To Coordinate Axis + // 0x00-0x01 + function SVTCA(v, state) { + if (exports.DEBUG) { console.log(state.step, 'SVTCA[' + v.axis + ']'); } + + state.fv = state.pv = state.dpv = v; + } + + // SPVTCA[a] Set Projection Vector to Coordinate Axis + // 0x02-0x03 + function SPVTCA(v, state) { + if (exports.DEBUG) { console.log(state.step, 'SPVTCA[' + v.axis + ']'); } + + state.pv = state.dpv = v; + } + + // SFVTCA[a] Set Freedom Vector to Coordinate Axis + // 0x04-0x05 + function SFVTCA(v, state) { + if (exports.DEBUG) { console.log(state.step, 'SFVTCA[' + v.axis + ']'); } + + state.fv = v; + } + + // SPVTL[a] Set Projection Vector To Line + // 0x06-0x07 + function SPVTL(a, state) { + var stack = state.stack; + var p2i = stack.pop(); + var p1i = stack.pop(); + var p2 = state.z2[p2i]; + var p1 = state.z1[p1i]; + + if (exports.DEBUG) { console.log('SPVTL[' + a + ']', p2i, p1i); } + + var dx; + var dy; + + if (!a) { + dx = p1.x - p2.x; + dy = p1.y - p2.y; + } else { + dx = p2.y - p1.y; + dy = p1.x - p2.x; + } + + state.pv = state.dpv = getUnitVector(dx, dy); + } + + // SFVTL[a] Set Freedom Vector To Line + // 0x08-0x09 + function SFVTL(a, state) { + var stack = state.stack; + var p2i = stack.pop(); + var p1i = stack.pop(); + var p2 = state.z2[p2i]; + var p1 = state.z1[p1i]; + + if (exports.DEBUG) { console.log('SFVTL[' + a + ']', p2i, p1i); } + + var dx; + var dy; + + if (!a) { + dx = p1.x - p2.x; + dy = p1.y - p2.y; + } else { + dx = p2.y - p1.y; + dy = p1.x - p2.x; + } + + state.fv = getUnitVector(dx, dy); + } + + // SPVFS[] Set Projection Vector From Stack + // 0x0A + function SPVFS(state) { + var stack = state.stack; + var y = stack.pop(); + var x = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SPVFS[]', y, x); } + + state.pv = state.dpv = getUnitVector(x, y); + } + + // SFVFS[] Set Freedom Vector From Stack + // 0x0B + function SFVFS(state) { + var stack = state.stack; + var y = stack.pop(); + var x = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SPVFS[]', y, x); } + + state.fv = getUnitVector(x, y); + } + + // GPV[] Get Projection Vector + // 0x0C + function GPV(state) { + var stack = state.stack; + var pv = state.pv; + + if (exports.DEBUG) { console.log(state.step, 'GPV[]'); } + + stack.push(pv.x * 0x4000); + stack.push(pv.y * 0x4000); + } + + // GFV[] Get Freedom Vector + // 0x0C + function GFV(state) { + var stack = state.stack; + var fv = state.fv; + + if (exports.DEBUG) { console.log(state.step, 'GFV[]'); } + + stack.push(fv.x * 0x4000); + stack.push(fv.y * 0x4000); + } + + // SFVTPV[] Set Freedom Vector To Projection Vector + // 0x0E + function SFVTPV(state) { + state.fv = state.pv; + + if (exports.DEBUG) { console.log(state.step, 'SFVTPV[]'); } + } + + // ISECT[] moves point p to the InterSECTion of two lines + // 0x0F + function ISECT(state) + { + var stack = state.stack; + var pa0i = stack.pop(); + var pa1i = stack.pop(); + var pb0i = stack.pop(); + var pb1i = stack.pop(); + var pi = stack.pop(); + var z0 = state.z0; + var z1 = state.z1; + var pa0 = z0[pa0i]; + var pa1 = z0[pa1i]; + var pb0 = z1[pb0i]; + var pb1 = z1[pb1i]; + var p = state.z2[pi]; + + if (exports.DEBUG) { console.log('ISECT[], ', pa0i, pa1i, pb0i, pb1i, pi); } + + // math from + // en.wikipedia.org/wiki/Line%E2%80%93line_intersection#Given_two_points_on_each_line + + var x1 = pa0.x; + var y1 = pa0.y; + var x2 = pa1.x; + var y2 = pa1.y; + var x3 = pb0.x; + var y3 = pb0.y; + var x4 = pb1.x; + var y4 = pb1.y; + + var div = (x1 - x2) * (y3 - y4) - (y1 - y2) * (x3 - x4); + var f1 = x1 * y2 - y1 * x2; + var f2 = x3 * y4 - y3 * x4; + + p.x = (f1 * (x3 - x4) - f2 * (x1 - x2)) / div; + p.y = (f1 * (y3 - y4) - f2 * (y1 - y2)) / div; + } + + // SRP0[] Set Reference Point 0 + // 0x10 + function SRP0(state) { + state.rp0 = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SRP0[]', state.rp0); } + } + + // SRP1[] Set Reference Point 1 + // 0x11 + function SRP1(state) { + state.rp1 = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SRP1[]', state.rp1); } + } + + // SRP1[] Set Reference Point 2 + // 0x12 + function SRP2(state) { + state.rp2 = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SRP2[]', state.rp2); } + } + + // SZP0[] Set Zone Pointer 0 + // 0x13 + function SZP0(state) { + var n = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SZP0[]', n); } + + state.zp0 = n; + + switch (n) { + case 0: + if (!state.tZone) { initTZone(state); } + state.z0 = state.tZone; + break; + case 1 : + state.z0 = state.gZone; + break; + default : + throw new Error('Invalid zone pointer'); + } + } + + // SZP1[] Set Zone Pointer 1 + // 0x14 + function SZP1(state) { + var n = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SZP1[]', n); } + + state.zp1 = n; + + switch (n) { + case 0: + if (!state.tZone) { initTZone(state); } + state.z1 = state.tZone; + break; + case 1 : + state.z1 = state.gZone; + break; + default : + throw new Error('Invalid zone pointer'); + } + } + + // SZP2[] Set Zone Pointer 2 + // 0x15 + function SZP2(state) { + var n = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SZP2[]', n); } + + state.zp2 = n; + + switch (n) { + case 0: + if (!state.tZone) { initTZone(state); } + state.z2 = state.tZone; + break; + case 1 : + state.z2 = state.gZone; + break; + default : + throw new Error('Invalid zone pointer'); + } + } + + // SZPS[] Set Zone PointerS + // 0x16 + function SZPS(state) { + var n = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SZPS[]', n); } + + state.zp0 = state.zp1 = state.zp2 = n; + + switch (n) { + case 0: + if (!state.tZone) { initTZone(state); } + state.z0 = state.z1 = state.z2 = state.tZone; + break; + case 1 : + state.z0 = state.z1 = state.z2 = state.gZone; + break; + default : + throw new Error('Invalid zone pointer'); + } + } + + // SLOOP[] Set LOOP variable + // 0x17 + function SLOOP(state) { + state.loop = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SLOOP[]', state.loop); } + } + + // RTG[] Round To Grid + // 0x18 + function RTG(state) { + if (exports.DEBUG) { console.log(state.step, 'RTG[]'); } + + state.round = roundToGrid; + } + + // RTHG[] Round To Half Grid + // 0x19 + function RTHG(state) { + if (exports.DEBUG) { console.log(state.step, 'RTHG[]'); } + + state.round = roundToHalfGrid; + } + + // SMD[] Set Minimum Distance + // 0x1A + function SMD(state) { + var d = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SMD[]', d); } + + state.minDis = d / 0x40; + } + + // ELSE[] ELSE clause + // 0x1B + function ELSE(state) { + // This instruction has been reached by executing a then branch + // so it just skips ahead until matching EIF. + // + // In case the IF was negative the IF[] instruction already + // skipped forward over the ELSE[] + + if (exports.DEBUG) { console.log(state.step, 'ELSE[]'); } + + skip(state, false); + } + + // JMPR[] JuMP Relative + // 0x1C + function JMPR(state) { + var o = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'JMPR[]', o); } + + // A jump by 1 would do nothing. + state.ip += o - 1; + } + + // SCVTCI[] Set Control Value Table Cut-In + // 0x1D + function SCVTCI(state) { + var n = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SCVTCI[]', n); } + + state.cvCutIn = n / 0x40; + } + + // DUP[] DUPlicate top stack element + // 0x20 + function DUP(state) { + var stack = state.stack; + + if (exports.DEBUG) { console.log(state.step, 'DUP[]'); } + + stack.push(stack[stack.length - 1]); + } + + // POP[] POP top stack element + // 0x21 + function POP(state) { + if (exports.DEBUG) { console.log(state.step, 'POP[]'); } + + state.stack.pop(); + } + + // CLEAR[] CLEAR the stack + // 0x22 + function CLEAR(state) { + if (exports.DEBUG) { console.log(state.step, 'CLEAR[]'); } + + state.stack.length = 0; + } + + // SWAP[] SWAP the top two elements on the stack + // 0x23 + function SWAP(state) { + var stack = state.stack; + + var a = stack.pop(); + var b = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SWAP[]'); } + + stack.push(a); + stack.push(b); + } + + // DEPTH[] DEPTH of the stack + // 0x24 + function DEPTH(state) { + var stack = state.stack; + + if (exports.DEBUG) { console.log(state.step, 'DEPTH[]'); } + + stack.push(stack.length); + } + + // LOOPCALL[] LOOPCALL function + // 0x2A + function LOOPCALL(state) { + var stack = state.stack; + var fn = stack.pop(); + var c = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'LOOPCALL[]', fn, c); } + + // saves callers program + var cip = state.ip; + var cprog = state.prog; + + state.prog = state.funcs[fn]; + + // executes the function + for (var i = 0; i < c; i++) { + exec(state); + + if (exports.DEBUG) { console.log( + ++state.step, + i + 1 < c ? 'next loopcall' : 'done loopcall', + i + ); } + } + + // restores the callers program + state.ip = cip; + state.prog = cprog; + } + + // CALL[] CALL function + // 0x2B + function CALL(state) { + var fn = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'CALL[]', fn); } + + // saves callers program + var cip = state.ip; + var cprog = state.prog; + + state.prog = state.funcs[fn]; + + // executes the function + exec(state); + + // restores the callers program + state.ip = cip; + state.prog = cprog; + + if (exports.DEBUG) { console.log(++state.step, 'returning from', fn); } + } + + // CINDEX[] Copy the INDEXed element to the top of the stack + // 0x25 + function CINDEX(state) { + var stack = state.stack; + var k = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'CINDEX[]', k); } + + // In case of k == 1, it copies the last element after popping + // thus stack.length - k. + stack.push(stack[stack.length - k]); + } + + // MINDEX[] Move the INDEXed element to the top of the stack + // 0x26 + function MINDEX(state) { + var stack = state.stack; + var k = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'MINDEX[]', k); } + + stack.push(stack.splice(stack.length - k, 1)[0]); + } + + // FDEF[] Function DEFinition + // 0x2C + function FDEF(state) { + if (state.env !== 'fpgm') { throw new Error('FDEF not allowed here'); } + var stack = state.stack; + var prog = state.prog; + var ip = state.ip; + + var fn = stack.pop(); + var ipBegin = ip; + + if (exports.DEBUG) { console.log(state.step, 'FDEF[]', fn); } + + while (prog[++ip] !== 0x2D){ } + + state.ip = ip; + state.funcs[fn] = prog.slice(ipBegin + 1, ip); + } + + // MDAP[a] Move Direct Absolute Point + // 0x2E-0x2F + function MDAP(round, state) { + var pi = state.stack.pop(); + var p = state.z0[pi]; + var fv = state.fv; + var pv = state.pv; + + if (exports.DEBUG) { console.log(state.step, 'MDAP[' + round + ']', pi); } + + var d = pv.distance(p, HPZero); + + if (round) { d = state.round(d); } + + fv.setRelative(p, HPZero, d, pv); + fv.touch(p); + + state.rp0 = state.rp1 = pi; + } + + // IUP[a] Interpolate Untouched Points through the outline + // 0x30 + function IUP(v, state) { + var z2 = state.z2; + var pLen = z2.length - 2; + var cp; + var pp; + var np; + + if (exports.DEBUG) { console.log(state.step, 'IUP[' + v.axis + ']'); } + + for (var i = 0; i < pLen; i++) { + cp = z2[i]; // current point + + // if this point has been touched go on + if (v.touched(cp)) { continue; } + + pp = cp.prevTouched(v); + + // no point on the contour has been touched? + if (pp === cp) { continue; } + + np = cp.nextTouched(v); + + if (pp === np) { + // only one point on the contour has been touched + // so simply moves the point like that + + v.setRelative(cp, cp, v.distance(pp, pp, false, true), v, true); + } + + v.interpolate(cp, pp, np, v); + } + } + + // SHP[] SHift Point using reference point + // 0x32-0x33 + function SHP(a, state) { + var stack = state.stack; + var rpi = a ? state.rp1 : state.rp2; + var rp = (a ? state.z0 : state.z1)[rpi]; + var fv = state.fv; + var pv = state.pv; + var loop = state.loop; + var z2 = state.z2; + + while (loop--) + { + var pi = stack.pop(); + var p = z2[pi]; + + var d = pv.distance(rp, rp, false, true); + fv.setRelative(p, p, d, pv); + fv.touch(p); + + if (exports.DEBUG) { + console.log( + state.step, + (state.loop > 1 ? + 'loop ' + (state.loop - loop) + ': ' : + '' + ) + + 'SHP[' + (a ? 'rp1' : 'rp2') + ']', pi + ); + } + } + + state.loop = 1; + } + + // SHC[] SHift Contour using reference point + // 0x36-0x37 + function SHC(a, state) { + var stack = state.stack; + var rpi = a ? state.rp1 : state.rp2; + var rp = (a ? state.z0 : state.z1)[rpi]; + var fv = state.fv; + var pv = state.pv; + var ci = stack.pop(); + var sp = state.z2[state.contours[ci]]; + var p = sp; + + if (exports.DEBUG) { console.log(state.step, 'SHC[' + a + ']', ci); } + + var d = pv.distance(rp, rp, false, true); + + do { + if (p !== rp) { fv.setRelative(p, p, d, pv); } + p = p.nextPointOnContour; + } while (p !== sp); + } + + // SHZ[] SHift Zone using reference point + // 0x36-0x37 + function SHZ(a, state) { + var stack = state.stack; + var rpi = a ? state.rp1 : state.rp2; + var rp = (a ? state.z0 : state.z1)[rpi]; + var fv = state.fv; + var pv = state.pv; + + var e = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SHZ[' + a + ']', e); } + + var z; + switch (e) { + case 0 : z = state.tZone; break; + case 1 : z = state.gZone; break; + default : throw new Error('Invalid zone'); + } + + var p; + var d = pv.distance(rp, rp, false, true); + var pLen = z.length - 2; + for (var i = 0; i < pLen; i++) + { + p = z[i]; + fv.setRelative(p, p, d, pv); + //if (p !== rp) fv.setRelative(p, p, d, pv); + } + } + + // SHPIX[] SHift point by a PIXel amount + // 0x38 + function SHPIX(state) { + var stack = state.stack; + var loop = state.loop; + var fv = state.fv; + var d = stack.pop() / 0x40; + var z2 = state.z2; + + while (loop--) { + var pi = stack.pop(); + var p = z2[pi]; + + if (exports.DEBUG) { + console.log( + state.step, + (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') + + 'SHPIX[]', pi, d + ); + } + + fv.setRelative(p, p, d); + fv.touch(p); + } + + state.loop = 1; + } + + // IP[] Interpolate Point + // 0x39 + function IP(state) { + var stack = state.stack; + var rp1i = state.rp1; + var rp2i = state.rp2; + var loop = state.loop; + var rp1 = state.z0[rp1i]; + var rp2 = state.z1[rp2i]; + var fv = state.fv; + var pv = state.dpv; + var z2 = state.z2; + + while (loop--) { + var pi = stack.pop(); + var p = z2[pi]; + + if (exports.DEBUG) { + console.log( + state.step, + (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') + + 'IP[]', pi, rp1i, '<->', rp2i + ); + } + + fv.interpolate(p, rp1, rp2, pv); + + fv.touch(p); + } + + state.loop = 1; + } + + // MSIRP[a] Move Stack Indirect Relative Point + // 0x3A-0x3B + function MSIRP(a, state) { + var stack = state.stack; + var d = stack.pop() / 64; + var pi = stack.pop(); + var p = state.z1[pi]; + var rp0 = state.z0[state.rp0]; + var fv = state.fv; + var pv = state.pv; + + fv.setRelative(p, rp0, d, pv); + fv.touch(p); + + if (exports.DEBUG) { console.log(state.step, 'MSIRP[' + a + ']', d, pi); } + + state.rp1 = state.rp0; + state.rp2 = pi; + if (a) { state.rp0 = pi; } + } + + // ALIGNRP[] Align to reference point. + // 0x3C + function ALIGNRP(state) { + var stack = state.stack; + var rp0i = state.rp0; + var rp0 = state.z0[rp0i]; + var loop = state.loop; + var fv = state.fv; + var pv = state.pv; + var z1 = state.z1; + + while (loop--) { + var pi = stack.pop(); + var p = z1[pi]; + + if (exports.DEBUG) { + console.log( + state.step, + (state.loop > 1 ? 'loop ' + (state.loop - loop) + ': ' : '') + + 'ALIGNRP[]', pi + ); + } + + fv.setRelative(p, rp0, 0, pv); + fv.touch(p); + } + + state.loop = 1; + } + + // RTG[] Round To Double Grid + // 0x3D + function RTDG(state) { + if (exports.DEBUG) { console.log(state.step, 'RTDG[]'); } + + state.round = roundToDoubleGrid; + } + + // MIAP[a] Move Indirect Absolute Point + // 0x3E-0x3F + function MIAP(round, state) { + var stack = state.stack; + var n = stack.pop(); + var pi = stack.pop(); + var p = state.z0[pi]; + var fv = state.fv; + var pv = state.pv; + var cv = state.cvt[n]; + + if (exports.DEBUG) { + console.log( + state.step, + 'MIAP[' + round + ']', + n, '(', cv, ')', pi + ); + } + + var d = pv.distance(p, HPZero); + + if (round) { + if (Math.abs(d - cv) < state.cvCutIn) { d = cv; } + + d = state.round(d); + } + + fv.setRelative(p, HPZero, d, pv); + + if (state.zp0 === 0) { + p.xo = p.x; + p.yo = p.y; + } + + fv.touch(p); + + state.rp0 = state.rp1 = pi; + } + + // NPUSB[] PUSH N Bytes + // 0x40 + function NPUSHB(state) { + var prog = state.prog; + var ip = state.ip; + var stack = state.stack; + + var n = prog[++ip]; + + if (exports.DEBUG) { console.log(state.step, 'NPUSHB[]', n); } + + for (var i = 0; i < n; i++) { stack.push(prog[++ip]); } + + state.ip = ip; + } + + // NPUSHW[] PUSH N Words + // 0x41 + function NPUSHW(state) { + var ip = state.ip; + var prog = state.prog; + var stack = state.stack; + var n = prog[++ip]; + + if (exports.DEBUG) { console.log(state.step, 'NPUSHW[]', n); } + + for (var i = 0; i < n; i++) { + var w = (prog[++ip] << 8) | prog[++ip]; + if (w & 0x8000) { w = -((w ^ 0xffff) + 1); } + stack.push(w); + } + + state.ip = ip; + } + + // WS[] Write Store + // 0x42 + function WS(state) { + var stack = state.stack; + var store = state.store; + + if (!store) { store = state.store = []; } + + var v = stack.pop(); + var l = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'WS', v, l); } + + store[l] = v; + } + + // RS[] Read Store + // 0x43 + function RS(state) { + var stack = state.stack; + var store = state.store; + + var l = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'RS', l); } + + var v = (store && store[l]) || 0; + + stack.push(v); + } + + // WCVTP[] Write Control Value Table in Pixel units + // 0x44 + function WCVTP(state) { + var stack = state.stack; + + var v = stack.pop(); + var l = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'WCVTP', v, l); } + + state.cvt[l] = v / 0x40; + } + + // RCVT[] Read Control Value Table entry + // 0x45 + function RCVT(state) { + var stack = state.stack; + var cvte = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'RCVT', cvte); } + + stack.push(state.cvt[cvte] * 0x40); + } + + // GC[] Get Coordinate projected onto the projection vector + // 0x46-0x47 + function GC(a, state) { + var stack = state.stack; + var pi = stack.pop(); + var p = state.z2[pi]; + + if (exports.DEBUG) { console.log(state.step, 'GC[' + a + ']', pi); } + + stack.push(state.dpv.distance(p, HPZero, a, false) * 0x40); + } + + // MD[a] Measure Distance + // 0x49-0x4A + function MD(a, state) { + var stack = state.stack; + var pi2 = stack.pop(); + var pi1 = stack.pop(); + var p2 = state.z1[pi2]; + var p1 = state.z0[pi1]; + var d = state.dpv.distance(p1, p2, a, a); + + if (exports.DEBUG) { console.log(state.step, 'MD[' + a + ']', pi2, pi1, '->', d); } + + state.stack.push(Math.round(d * 64)); + } + + // MPPEM[] Measure Pixels Per EM + // 0x4B + function MPPEM(state) { + if (exports.DEBUG) { console.log(state.step, 'MPPEM[]'); } + state.stack.push(state.ppem); + } + + // FLIPON[] set the auto FLIP Boolean to ON + // 0x4D + function FLIPON(state) { + if (exports.DEBUG) { console.log(state.step, 'FLIPON[]'); } + state.autoFlip = true; + } + + // LT[] Less Than + // 0x50 + function LT(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'LT[]', e2, e1); } + + stack.push(e1 < e2 ? 1 : 0); + } + + // LTEQ[] Less Than or EQual + // 0x53 + function LTEQ(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'LTEQ[]', e2, e1); } + + stack.push(e1 <= e2 ? 1 : 0); + } + + // GTEQ[] Greater Than + // 0x52 + function GT(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'GT[]', e2, e1); } + + stack.push(e1 > e2 ? 1 : 0); + } + + // GTEQ[] Greater Than or EQual + // 0x53 + function GTEQ(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'GTEQ[]', e2, e1); } + + stack.push(e1 >= e2 ? 1 : 0); + } + + // EQ[] EQual + // 0x54 + function EQ(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'EQ[]', e2, e1); } + + stack.push(e2 === e1 ? 1 : 0); + } + + // NEQ[] Not EQual + // 0x55 + function NEQ(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'NEQ[]', e2, e1); } + + stack.push(e2 !== e1 ? 1 : 0); + } + + // ODD[] ODD + // 0x56 + function ODD(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'ODD[]', n); } + + stack.push(Math.trunc(n) % 2 ? 1 : 0); + } + + // EVEN[] EVEN + // 0x57 + function EVEN(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'EVEN[]', n); } + + stack.push(Math.trunc(n) % 2 ? 0 : 1); + } + + // IF[] IF test + // 0x58 + function IF(state) { + var test = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'IF[]', test); } + + // if test is true it just continues + // if not the ip is skipped until matching ELSE or EIF + if (!test) { + skip(state, true); + + if (exports.DEBUG) { console.log(state.step, 'EIF[]'); } + } + } + + // EIF[] End IF + // 0x59 + function EIF(state) { + // this can be reached normally when + // executing an else branch. + // -> just ignore it + + if (exports.DEBUG) { console.log(state.step, 'EIF[]'); } + } + + // AND[] logical AND + // 0x5A + function AND(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'AND[]', e2, e1); } + + stack.push(e2 && e1 ? 1 : 0); + } + + // OR[] logical OR + // 0x5B + function OR(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'OR[]', e2, e1); } + + stack.push(e2 || e1 ? 1 : 0); + } + + // NOT[] logical NOT + // 0x5C + function NOT(state) { + var stack = state.stack; + var e = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'NOT[]', e); } + + stack.push(e ? 0 : 1); + } + + // DELTAP1[] DELTA exception P1 + // DELTAP2[] DELTA exception P2 + // DELTAP3[] DELTA exception P3 + // 0x5D, 0x71, 0x72 + function DELTAP123(b, state) { + var stack = state.stack; + var n = stack.pop(); + var fv = state.fv; + var pv = state.pv; + var ppem = state.ppem; + var base = state.deltaBase + (b - 1) * 16; + var ds = state.deltaShift; + var z0 = state.z0; + + if (exports.DEBUG) { console.log(state.step, 'DELTAP[' + b + ']', n, stack); } + + for (var i = 0; i < n; i++) { + var pi = stack.pop(); + var arg = stack.pop(); + var appem = base + ((arg & 0xF0) >> 4); + if (appem !== ppem) { continue; } + + var mag = (arg & 0x0F) - 8; + if (mag >= 0) { mag++; } + if (exports.DEBUG) { console.log(state.step, 'DELTAPFIX', pi, 'by', mag * ds); } + + var p = z0[pi]; + fv.setRelative(p, p, mag * ds, pv); + } + } + + // SDB[] Set Delta Base in the graphics state + // 0x5E + function SDB(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SDB[]', n); } + + state.deltaBase = n; + } + + // SDS[] Set Delta Shift in the graphics state + // 0x5F + function SDS(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SDS[]', n); } + + state.deltaShift = Math.pow(0.5, n); + } + + // ADD[] ADD + // 0x60 + function ADD(state) { + var stack = state.stack; + var n2 = stack.pop(); + var n1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'ADD[]', n2, n1); } + + stack.push(n1 + n2); + } + + // SUB[] SUB + // 0x61 + function SUB(state) { + var stack = state.stack; + var n2 = stack.pop(); + var n1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SUB[]', n2, n1); } + + stack.push(n1 - n2); + } + + // DIV[] DIV + // 0x62 + function DIV(state) { + var stack = state.stack; + var n2 = stack.pop(); + var n1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'DIV[]', n2, n1); } + + stack.push(n1 * 64 / n2); + } + + // MUL[] MUL + // 0x63 + function MUL(state) { + var stack = state.stack; + var n2 = stack.pop(); + var n1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'MUL[]', n2, n1); } + + stack.push(n1 * n2 / 64); + } + + // ABS[] ABSolute value + // 0x64 + function ABS(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'ABS[]', n); } + + stack.push(Math.abs(n)); + } + + // NEG[] NEGate + // 0x65 + function NEG(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'NEG[]', n); } + + stack.push(-n); + } + + // FLOOR[] FLOOR + // 0x66 + function FLOOR(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'FLOOR[]', n); } + + stack.push(Math.floor(n / 0x40) * 0x40); + } + + // CEILING[] CEILING + // 0x67 + function CEILING(state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'CEILING[]', n); } + + stack.push(Math.ceil(n / 0x40) * 0x40); + } + + // ROUND[ab] ROUND value + // 0x68-0x6B + function ROUND(dt, state) { + var stack = state.stack; + var n = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'ROUND[]'); } + + stack.push(state.round(n / 0x40) * 0x40); + } + + // WCVTF[] Write Control Value Table in Funits + // 0x70 + function WCVTF(state) { + var stack = state.stack; + var v = stack.pop(); + var l = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'WCVTF[]', v, l); } + + state.cvt[l] = v * state.ppem / state.font.unitsPerEm; + } + + // DELTAC1[] DELTA exception C1 + // DELTAC2[] DELTA exception C2 + // DELTAC3[] DELTA exception C3 + // 0x73, 0x74, 0x75 + function DELTAC123(b, state) { + var stack = state.stack; + var n = stack.pop(); + var ppem = state.ppem; + var base = state.deltaBase + (b - 1) * 16; + var ds = state.deltaShift; + + if (exports.DEBUG) { console.log(state.step, 'DELTAC[' + b + ']', n, stack); } + + for (var i = 0; i < n; i++) { + var c = stack.pop(); + var arg = stack.pop(); + var appem = base + ((arg & 0xF0) >> 4); + if (appem !== ppem) { continue; } + + var mag = (arg & 0x0F) - 8; + if (mag >= 0) { mag++; } + + var delta = mag * ds; + + if (exports.DEBUG) { console.log(state.step, 'DELTACFIX', c, 'by', delta); } + + state.cvt[c] += delta; + } + } + + // SROUND[] Super ROUND + // 0x76 + function SROUND(state) { + var n = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'SROUND[]', n); } + + state.round = roundSuper; + + var period; + + switch (n & 0xC0) { + case 0x00: + period = 0.5; + break; + case 0x40: + period = 1; + break; + case 0x80: + period = 2; + break; + default: + throw new Error('invalid SROUND value'); + } + + state.srPeriod = period; + + switch (n & 0x30) { + case 0x00: + state.srPhase = 0; + break; + case 0x10: + state.srPhase = 0.25 * period; + break; + case 0x20: + state.srPhase = 0.5 * period; + break; + case 0x30: + state.srPhase = 0.75 * period; + break; + default: throw new Error('invalid SROUND value'); + } + + n &= 0x0F; + + if (n === 0) { state.srThreshold = 0; } + else { state.srThreshold = (n / 8 - 0.5) * period; } + } + + // S45ROUND[] Super ROUND 45 degrees + // 0x77 + function S45ROUND(state) { + var n = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'S45ROUND[]', n); } + + state.round = roundSuper; + + var period; + + switch (n & 0xC0) { + case 0x00: + period = Math.sqrt(2) / 2; + break; + case 0x40: + period = Math.sqrt(2); + break; + case 0x80: + period = 2 * Math.sqrt(2); + break; + default: + throw new Error('invalid S45ROUND value'); + } + + state.srPeriod = period; + + switch (n & 0x30) { + case 0x00: + state.srPhase = 0; + break; + case 0x10: + state.srPhase = 0.25 * period; + break; + case 0x20: + state.srPhase = 0.5 * period; + break; + case 0x30: + state.srPhase = 0.75 * period; + break; + default: + throw new Error('invalid S45ROUND value'); + } + + n &= 0x0F; + + if (n === 0) { state.srThreshold = 0; } + else { state.srThreshold = (n / 8 - 0.5) * period; } + } + + // ROFF[] Round Off + // 0x7A + function ROFF(state) { + if (exports.DEBUG) { console.log(state.step, 'ROFF[]'); } + + state.round = roundOff; + } + + // RUTG[] Round Up To Grid + // 0x7C + function RUTG(state) { + if (exports.DEBUG) { console.log(state.step, 'RUTG[]'); } + + state.round = roundUpToGrid; + } + + // RDTG[] Round Down To Grid + // 0x7D + function RDTG(state) { + if (exports.DEBUG) { console.log(state.step, 'RDTG[]'); } + + state.round = roundDownToGrid; + } + + // SCANCTRL[] SCAN conversion ConTRoL + // 0x85 + function SCANCTRL(state) { + var n = state.stack.pop(); + + // ignored by opentype.js + + if (exports.DEBUG) { console.log(state.step, 'SCANCTRL[]', n); } + } + + // SDPVTL[a] Set Dual Projection Vector To Line + // 0x86-0x87 + function SDPVTL(a, state) { + var stack = state.stack; + var p2i = stack.pop(); + var p1i = stack.pop(); + var p2 = state.z2[p2i]; + var p1 = state.z1[p1i]; + + if (exports.DEBUG) { console.log(state.step, 'SDPVTL[' + a + ']', p2i, p1i); } + + var dx; + var dy; + + if (!a) { + dx = p1.x - p2.x; + dy = p1.y - p2.y; + } else { + dx = p2.y - p1.y; + dy = p1.x - p2.x; + } + + state.dpv = getUnitVector(dx, dy); + } + + // GETINFO[] GET INFOrmation + // 0x88 + function GETINFO(state) { + var stack = state.stack; + var sel = stack.pop(); + var r = 0; + + if (exports.DEBUG) { console.log(state.step, 'GETINFO[]', sel); } + + // v35 as in no subpixel hinting + if (sel & 0x01) { r = 35; } + + // TODO rotation and stretch currently not supported + // and thus those GETINFO are always 0. + + // opentype.js is always gray scaling + if (sel & 0x20) { r |= 0x1000; } + + stack.push(r); + } + + // ROLL[] ROLL the top three stack elements + // 0x8A + function ROLL(state) { + var stack = state.stack; + var a = stack.pop(); + var b = stack.pop(); + var c = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'ROLL[]'); } + + stack.push(b); + stack.push(a); + stack.push(c); + } + + // MAX[] MAXimum of top two stack elements + // 0x8B + function MAX(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'MAX[]', e2, e1); } + + stack.push(Math.max(e1, e2)); + } + + // MIN[] MINimum of top two stack elements + // 0x8C + function MIN(state) { + var stack = state.stack; + var e2 = stack.pop(); + var e1 = stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'MIN[]', e2, e1); } + + stack.push(Math.min(e1, e2)); + } + + // SCANTYPE[] SCANTYPE + // 0x8D + function SCANTYPE(state) { + var n = state.stack.pop(); + // ignored by opentype.js + if (exports.DEBUG) { console.log(state.step, 'SCANTYPE[]', n); } + } + + // INSTCTRL[] INSTCTRL + // 0x8D + function INSTCTRL(state) { + var s = state.stack.pop(); + var v = state.stack.pop(); + + if (exports.DEBUG) { console.log(state.step, 'INSTCTRL[]', s, v); } + + switch (s) { + case 1 : state.inhibitGridFit = !!v; return; + case 2 : state.ignoreCvt = !!v; return; + default: throw new Error('invalid INSTCTRL[] selector'); + } + } + + // PUSHB[abc] PUSH Bytes + // 0xB0-0xB7 + function PUSHB(n, state) { + var stack = state.stack; + var prog = state.prog; + var ip = state.ip; + + if (exports.DEBUG) { console.log(state.step, 'PUSHB[' + n + ']'); } + + for (var i = 0; i < n; i++) { stack.push(prog[++ip]); } + + state.ip = ip; + } + + // PUSHW[abc] PUSH Words + // 0xB8-0xBF + function PUSHW(n, state) { + var ip = state.ip; + var prog = state.prog; + var stack = state.stack; + + if (exports.DEBUG) { console.log(state.ip, 'PUSHW[' + n + ']'); } + + for (var i = 0; i < n; i++) { + var w = (prog[++ip] << 8) | prog[++ip]; + if (w & 0x8000) { w = -((w ^ 0xffff) + 1); } + stack.push(w); + } + + state.ip = ip; + } + + // MDRP[abcde] Move Direct Relative Point + // 0xD0-0xEF + // (if indirect is 0) + // + // and + // + // MIRP[abcde] Move Indirect Relative Point + // 0xE0-0xFF + // (if indirect is 1) + + function MDRP_MIRP(indirect, setRp0, keepD, ro, dt, state) { + var stack = state.stack; + var cvte = indirect && stack.pop(); + var pi = stack.pop(); + var rp0i = state.rp0; + var rp = state.z0[rp0i]; + var p = state.z1[pi]; + + var md = state.minDis; + var fv = state.fv; + var pv = state.dpv; + var od; // original distance + var d; // moving distance + var sign; // sign of distance + var cv; + + d = od = pv.distance(p, rp, true, true); + sign = d >= 0 ? 1 : -1; // Math.sign would be 0 in case of 0 + + // TODO consider autoFlip + d = Math.abs(d); + + if (indirect) { + cv = state.cvt[cvte]; + + if (ro && Math.abs(d - cv) < state.cvCutIn) { d = cv; } + } + + if (keepD && d < md) { d = md; } + + if (ro) { d = state.round(d); } + + fv.setRelative(p, rp, sign * d, pv); + fv.touch(p); + + if (exports.DEBUG) { + console.log( + state.step, + (indirect ? 'MIRP[' : 'MDRP[') + + (setRp0 ? 'M' : 'm') + + (keepD ? '>' : '_') + + (ro ? 'R' : '_') + + (dt === 0 ? 'Gr' : (dt === 1 ? 'Bl' : (dt === 2 ? 'Wh' : ''))) + + ']', + indirect ? + cvte + '(' + state.cvt[cvte] + ',' + cv + ')' : + '', + pi, + '(d =', od, '->', sign * d, ')' + ); + } + + state.rp1 = state.rp0; + state.rp2 = pi; + if (setRp0) { state.rp0 = pi; } + } + + /* + * The instruction table. + */ + instructionTable = [ + /* 0x00 */ SVTCA.bind(undefined, yUnitVector), + /* 0x01 */ SVTCA.bind(undefined, xUnitVector), + /* 0x02 */ SPVTCA.bind(undefined, yUnitVector), + /* 0x03 */ SPVTCA.bind(undefined, xUnitVector), + /* 0x04 */ SFVTCA.bind(undefined, yUnitVector), + /* 0x05 */ SFVTCA.bind(undefined, xUnitVector), + /* 0x06 */ SPVTL.bind(undefined, 0), + /* 0x07 */ SPVTL.bind(undefined, 1), + /* 0x08 */ SFVTL.bind(undefined, 0), + /* 0x09 */ SFVTL.bind(undefined, 1), + /* 0x0A */ SPVFS, + /* 0x0B */ SFVFS, + /* 0x0C */ GPV, + /* 0x0D */ GFV, + /* 0x0E */ SFVTPV, + /* 0x0F */ ISECT, + /* 0x10 */ SRP0, + /* 0x11 */ SRP1, + /* 0x12 */ SRP2, + /* 0x13 */ SZP0, + /* 0x14 */ SZP1, + /* 0x15 */ SZP2, + /* 0x16 */ SZPS, + /* 0x17 */ SLOOP, + /* 0x18 */ RTG, + /* 0x19 */ RTHG, + /* 0x1A */ SMD, + /* 0x1B */ ELSE, + /* 0x1C */ JMPR, + /* 0x1D */ SCVTCI, + /* 0x1E */ undefined, // TODO SSWCI + /* 0x1F */ undefined, // TODO SSW + /* 0x20 */ DUP, + /* 0x21 */ POP, + /* 0x22 */ CLEAR, + /* 0x23 */ SWAP, + /* 0x24 */ DEPTH, + /* 0x25 */ CINDEX, + /* 0x26 */ MINDEX, + /* 0x27 */ undefined, // TODO ALIGNPTS + /* 0x28 */ undefined, + /* 0x29 */ undefined, // TODO UTP + /* 0x2A */ LOOPCALL, + /* 0x2B */ CALL, + /* 0x2C */ FDEF, + /* 0x2D */ undefined, // ENDF (eaten by FDEF) + /* 0x2E */ MDAP.bind(undefined, 0), + /* 0x2F */ MDAP.bind(undefined, 1), + /* 0x30 */ IUP.bind(undefined, yUnitVector), + /* 0x31 */ IUP.bind(undefined, xUnitVector), + /* 0x32 */ SHP.bind(undefined, 0), + /* 0x33 */ SHP.bind(undefined, 1), + /* 0x34 */ SHC.bind(undefined, 0), + /* 0x35 */ SHC.bind(undefined, 1), + /* 0x36 */ SHZ.bind(undefined, 0), + /* 0x37 */ SHZ.bind(undefined, 1), + /* 0x38 */ SHPIX, + /* 0x39 */ IP, + /* 0x3A */ MSIRP.bind(undefined, 0), + /* 0x3B */ MSIRP.bind(undefined, 1), + /* 0x3C */ ALIGNRP, + /* 0x3D */ RTDG, + /* 0x3E */ MIAP.bind(undefined, 0), + /* 0x3F */ MIAP.bind(undefined, 1), + /* 0x40 */ NPUSHB, + /* 0x41 */ NPUSHW, + /* 0x42 */ WS, + /* 0x43 */ RS, + /* 0x44 */ WCVTP, + /* 0x45 */ RCVT, + /* 0x46 */ GC.bind(undefined, 0), + /* 0x47 */ GC.bind(undefined, 1), + /* 0x48 */ undefined, // TODO SCFS + /* 0x49 */ MD.bind(undefined, 0), + /* 0x4A */ MD.bind(undefined, 1), + /* 0x4B */ MPPEM, + /* 0x4C */ undefined, // TODO MPS + /* 0x4D */ FLIPON, + /* 0x4E */ undefined, // TODO FLIPOFF + /* 0x4F */ undefined, // TODO DEBUG + /* 0x50 */ LT, + /* 0x51 */ LTEQ, + /* 0x52 */ GT, + /* 0x53 */ GTEQ, + /* 0x54 */ EQ, + /* 0x55 */ NEQ, + /* 0x56 */ ODD, + /* 0x57 */ EVEN, + /* 0x58 */ IF, + /* 0x59 */ EIF, + /* 0x5A */ AND, + /* 0x5B */ OR, + /* 0x5C */ NOT, + /* 0x5D */ DELTAP123.bind(undefined, 1), + /* 0x5E */ SDB, + /* 0x5F */ SDS, + /* 0x60 */ ADD, + /* 0x61 */ SUB, + /* 0x62 */ DIV, + /* 0x63 */ MUL, + /* 0x64 */ ABS, + /* 0x65 */ NEG, + /* 0x66 */ FLOOR, + /* 0x67 */ CEILING, + /* 0x68 */ ROUND.bind(undefined, 0), + /* 0x69 */ ROUND.bind(undefined, 1), + /* 0x6A */ ROUND.bind(undefined, 2), + /* 0x6B */ ROUND.bind(undefined, 3), + /* 0x6C */ undefined, // TODO NROUND[ab] + /* 0x6D */ undefined, // TODO NROUND[ab] + /* 0x6E */ undefined, // TODO NROUND[ab] + /* 0x6F */ undefined, // TODO NROUND[ab] + /* 0x70 */ WCVTF, + /* 0x71 */ DELTAP123.bind(undefined, 2), + /* 0x72 */ DELTAP123.bind(undefined, 3), + /* 0x73 */ DELTAC123.bind(undefined, 1), + /* 0x74 */ DELTAC123.bind(undefined, 2), + /* 0x75 */ DELTAC123.bind(undefined, 3), + /* 0x76 */ SROUND, + /* 0x77 */ S45ROUND, + /* 0x78 */ undefined, // TODO JROT[] + /* 0x79 */ undefined, // TODO JROF[] + /* 0x7A */ ROFF, + /* 0x7B */ undefined, + /* 0x7C */ RUTG, + /* 0x7D */ RDTG, + /* 0x7E */ POP, // actually SANGW, supposed to do only a pop though + /* 0x7F */ POP, // actually AA, supposed to do only a pop though + /* 0x80 */ undefined, // TODO FLIPPT + /* 0x81 */ undefined, // TODO FLIPRGON + /* 0x82 */ undefined, // TODO FLIPRGOFF + /* 0x83 */ undefined, + /* 0x84 */ undefined, + /* 0x85 */ SCANCTRL, + /* 0x86 */ SDPVTL.bind(undefined, 0), + /* 0x87 */ SDPVTL.bind(undefined, 1), + /* 0x88 */ GETINFO, + /* 0x89 */ undefined, // TODO IDEF + /* 0x8A */ ROLL, + /* 0x8B */ MAX, + /* 0x8C */ MIN, + /* 0x8D */ SCANTYPE, + /* 0x8E */ INSTCTRL, + /* 0x8F */ undefined, + /* 0x90 */ undefined, + /* 0x91 */ undefined, + /* 0x92 */ undefined, + /* 0x93 */ undefined, + /* 0x94 */ undefined, + /* 0x95 */ undefined, + /* 0x96 */ undefined, + /* 0x97 */ undefined, + /* 0x98 */ undefined, + /* 0x99 */ undefined, + /* 0x9A */ undefined, + /* 0x9B */ undefined, + /* 0x9C */ undefined, + /* 0x9D */ undefined, + /* 0x9E */ undefined, + /* 0x9F */ undefined, + /* 0xA0 */ undefined, + /* 0xA1 */ undefined, + /* 0xA2 */ undefined, + /* 0xA3 */ undefined, + /* 0xA4 */ undefined, + /* 0xA5 */ undefined, + /* 0xA6 */ undefined, + /* 0xA7 */ undefined, + /* 0xA8 */ undefined, + /* 0xA9 */ undefined, + /* 0xAA */ undefined, + /* 0xAB */ undefined, + /* 0xAC */ undefined, + /* 0xAD */ undefined, + /* 0xAE */ undefined, + /* 0xAF */ undefined, + /* 0xB0 */ PUSHB.bind(undefined, 1), + /* 0xB1 */ PUSHB.bind(undefined, 2), + /* 0xB2 */ PUSHB.bind(undefined, 3), + /* 0xB3 */ PUSHB.bind(undefined, 4), + /* 0xB4 */ PUSHB.bind(undefined, 5), + /* 0xB5 */ PUSHB.bind(undefined, 6), + /* 0xB6 */ PUSHB.bind(undefined, 7), + /* 0xB7 */ PUSHB.bind(undefined, 8), + /* 0xB8 */ PUSHW.bind(undefined, 1), + /* 0xB9 */ PUSHW.bind(undefined, 2), + /* 0xBA */ PUSHW.bind(undefined, 3), + /* 0xBB */ PUSHW.bind(undefined, 4), + /* 0xBC */ PUSHW.bind(undefined, 5), + /* 0xBD */ PUSHW.bind(undefined, 6), + /* 0xBE */ PUSHW.bind(undefined, 7), + /* 0xBF */ PUSHW.bind(undefined, 8), + /* 0xC0 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 0), + /* 0xC1 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 1), + /* 0xC2 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 2), + /* 0xC3 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 0, 3), + /* 0xC4 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 0), + /* 0xC5 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 1), + /* 0xC6 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 2), + /* 0xC7 */ MDRP_MIRP.bind(undefined, 0, 0, 0, 1, 3), + /* 0xC8 */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 0), + /* 0xC9 */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 1), + /* 0xCA */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 2), + /* 0xCB */ MDRP_MIRP.bind(undefined, 0, 0, 1, 0, 3), + /* 0xCC */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 0), + /* 0xCD */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 1), + /* 0xCE */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 2), + /* 0xCF */ MDRP_MIRP.bind(undefined, 0, 0, 1, 1, 3), + /* 0xD0 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 0), + /* 0xD1 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 1), + /* 0xD2 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 2), + /* 0xD3 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 0, 3), + /* 0xD4 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 0), + /* 0xD5 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 1), + /* 0xD6 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 2), + /* 0xD7 */ MDRP_MIRP.bind(undefined, 0, 1, 0, 1, 3), + /* 0xD8 */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 0), + /* 0xD9 */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 1), + /* 0xDA */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 2), + /* 0xDB */ MDRP_MIRP.bind(undefined, 0, 1, 1, 0, 3), + /* 0xDC */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 0), + /* 0xDD */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 1), + /* 0xDE */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 2), + /* 0xDF */ MDRP_MIRP.bind(undefined, 0, 1, 1, 1, 3), + /* 0xE0 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 0), + /* 0xE1 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 1), + /* 0xE2 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 2), + /* 0xE3 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 0, 3), + /* 0xE4 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 0), + /* 0xE5 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 1), + /* 0xE6 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 2), + /* 0xE7 */ MDRP_MIRP.bind(undefined, 1, 0, 0, 1, 3), + /* 0xE8 */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 0), + /* 0xE9 */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 1), + /* 0xEA */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 2), + /* 0xEB */ MDRP_MIRP.bind(undefined, 1, 0, 1, 0, 3), + /* 0xEC */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 0), + /* 0xED */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 1), + /* 0xEE */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 2), + /* 0xEF */ MDRP_MIRP.bind(undefined, 1, 0, 1, 1, 3), + /* 0xF0 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 0), + /* 0xF1 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 1), + /* 0xF2 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 2), + /* 0xF3 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 0, 3), + /* 0xF4 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 0), + /* 0xF5 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 1), + /* 0xF6 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 2), + /* 0xF7 */ MDRP_MIRP.bind(undefined, 1, 1, 0, 1, 3), + /* 0xF8 */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 0), + /* 0xF9 */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 1), + /* 0xFA */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 2), + /* 0xFB */ MDRP_MIRP.bind(undefined, 1, 1, 1, 0, 3), + /* 0xFC */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 0), + /* 0xFD */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 1), + /* 0xFE */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 2), + /* 0xFF */ MDRP_MIRP.bind(undefined, 1, 1, 1, 1, 3) + ]; + + /***************************** + Mathematical Considerations + ****************************** + + fv ... refers to freedom vector + pv ... refers to projection vector + rp ... refers to reference point + p ... refers to to point being operated on + d ... refers to distance + + SETRELATIVE: + ============ + + case freedom vector == x-axis: + ------------------------------ + + (pv) + .-' + rpd .-' + .-* + d .-'90°' + .-' ' + .-' ' + *-' ' b + rp ' + ' + ' + p *----------*-------------- (fv) + pm + + rpdx = rpx + d * pv.x + rpdy = rpy + d * pv.y + + equation of line b + + y - rpdy = pvns * (x- rpdx) + + y = p.y + + x = rpdx + ( p.y - rpdy ) / pvns + + + case freedom vector == y-axis: + ------------------------------ + + * pm + |\ + | \ + | \ + | \ + | \ + | \ + | \ + | \ + | \ + | \ b + | \ + | \ + | \ .-' (pv) + | 90° \.-' + | .-'* rpd + | .-' + * *-' d + p rp + + rpdx = rpx + d * pv.x + rpdy = rpy + d * pv.y + + equation of line b: + pvns ... normal slope to pv + + y - rpdy = pvns * (x - rpdx) + + x = p.x + + y = rpdy + pvns * (p.x - rpdx) + + + + generic case: + ------------- + + + .'(fv) + .' + .* pm + .' ! + .' . + .' ! + .' . b + .' ! + * . + p ! + 90° . ... (pv) + ...-*-''' + ...---''' rpd + ...---''' d + *--''' + rp + + rpdx = rpx + d * pv.x + rpdy = rpy + d * pv.y + + equation of line b: + pvns... normal slope to pv + + y - rpdy = pvns * (x - rpdx) + + equation of freedom vector line: + fvs ... slope of freedom vector (=fy/fx) + + y - py = fvs * (x - px) + + + on pm both equations are true for same x/y + + y - rpdy = pvns * (x - rpdx) + + y - py = fvs * (x - px) + + form to y and set equal: + + pvns * (x - rpdx) + rpdy = fvs * (x - px) + py + + expand: + + pvns * x - pvns * rpdx + rpdy = fvs * x - fvs * px + py + + switch: + + fvs * x - fvs * px + py = pvns * x - pvns * rpdx + rpdy + + solve for x: + + fvs * x - pvns * x = fvs * px - pvns * rpdx - py + rpdy + + + + fvs * px - pvns * rpdx + rpdy - py + x = ----------------------------------- + fvs - pvns + + and: + + y = fvs * (x - px) + py + + + + INTERPOLATE: + ============ + + Examples of point interpolation. + + The weight of the movement of the reference point gets bigger + the further the other reference point is away, thus the safest + option (that is avoiding 0/0 divisions) is to weight the + original distance of the other point by the sum of both distances. + + If the sum of both distances is 0, then move the point by the + arithmetic average of the movement of both reference points. + + + + + (+6) + rp1o *---->*rp1 + . . (+12) + . . rp2o *---------->* rp2 + . . . . + . . . . + . 10 20 . . + |.........|...................| . + . . . + . . (+8) . + po *------>*p . + . . . + . 12 . 24 . + |...........|.......................| + 36 + + + ------- + + + + (+10) + rp1o *-------->*rp1 + . . (-10) + . . rp2 *<---------* rpo2 + . . . . + . . . . + . 10 . 30 . . + |.........|.............................| + . . + . (+5) . + po *--->* p . + . . . + . . 20 . + |....|..............| + 5 15 + + + ------- + + + (+10) + rp1o *-------->*rp1 + . . + . . + rp2o *-------->*rp2 + + + (+10) + po *-------->* p + + ------- + + + (+10) + rp1o *-------->*rp1 + . . + . .(+30) + rp2o *---------------------------->*rp2 + + + (+25) + po *----------------------->* p + + + + vim: set ts=4 sw=4 expandtab: + *****/ + + // The Font object + + // This code is based on Array.from implementation for strings in https://github.com/mathiasbynens/Array.from + var arrayFromString = Array.from || (function (s) { return s.match(/[\uD800-\uDBFF][\uDC00-\uDFFF]?|[^\uD800-\uDFFF]|./g) || []; }); + + /** + * @typedef FontOptions + * @type Object + * @property {Boolean} empty - whether to create a new empty font + * @property {string} familyName + * @property {string} styleName + * @property {string=} fullName + * @property {string=} postScriptName + * @property {string=} designer + * @property {string=} designerURL + * @property {string=} manufacturer + * @property {string=} manufacturerURL + * @property {string=} license + * @property {string=} licenseURL + * @property {string=} version + * @property {string=} description + * @property {string=} copyright + * @property {string=} trademark + * @property {Number} unitsPerEm + * @property {Number} ascender + * @property {Number} descender + * @property {Number} createdTimestamp + * @property {string=} weightClass + * @property {string=} widthClass + * @property {string=} fsSelection + */ + + /** + * A Font represents a loaded OpenType font file. + * It contains a set of glyphs and methods to draw text on a drawing context, + * or to get a path representing the text. + * @exports opentype.Font + * @class + * @param {FontOptions} + * @constructor + */ + function Font(options) { + options = options || {}; + + if (!options.empty) { + // Check that we've provided the minimum set of names. + checkArgument(options.familyName, 'When creating a new Font object, familyName is required.'); + checkArgument(options.styleName, 'When creating a new Font object, styleName is required.'); + checkArgument(options.unitsPerEm, 'When creating a new Font object, unitsPerEm is required.'); + checkArgument(options.ascender, 'When creating a new Font object, ascender is required.'); + checkArgument(options.descender, 'When creating a new Font object, descender is required.'); + checkArgument(options.descender < 0, 'Descender should be negative (e.g. -512).'); + + // OS X will complain if the names are empty, so we put a single space everywhere by default. + this.names = { + fontFamily: {en: options.familyName || ' '}, + fontSubfamily: {en: options.styleName || ' '}, + fullName: {en: options.fullName || options.familyName + ' ' + options.styleName}, + // postScriptName may not contain any whitespace + postScriptName: {en: options.postScriptName || (options.familyName + options.styleName).replace(/\s/g, '')}, + designer: {en: options.designer || ' '}, + designerURL: {en: options.designerURL || ' '}, + manufacturer: {en: options.manufacturer || ' '}, + manufacturerURL: {en: options.manufacturerURL || ' '}, + license: {en: options.license || ' '}, + licenseURL: {en: options.licenseURL || ' '}, + version: {en: options.version || 'Version 0.1'}, + description: {en: options.description || ' '}, + copyright: {en: options.copyright || ' '}, + trademark: {en: options.trademark || ' '} + }; + this.unitsPerEm = options.unitsPerEm || 1000; + this.ascender = options.ascender; + this.descender = options.descender; + this.createdTimestamp = options.createdTimestamp; + this.tables = { os2: { + usWeightClass: options.weightClass || this.usWeightClasses.MEDIUM, + usWidthClass: options.widthClass || this.usWidthClasses.MEDIUM, + fsSelection: options.fsSelection || this.fsSelectionValues.REGULAR + } }; + } + + this.supported = true; // Deprecated: parseBuffer will throw an error if font is not supported. + this.glyphs = new glyphset.GlyphSet(this, options.glyphs || []); + this.encoding = new DefaultEncoding(this); + this.position = new Position(this); + this.substitution = new Substitution(this); + this.tables = this.tables || {}; + + Object.defineProperty(this, 'hinting', { + get: function() { + if (this._hinting) { return this._hinting; } + if (this.outlinesFormat === 'truetype') { + return (this._hinting = new Hinting(this)); + } + } + }); + } + + /** + * Check if the font has a glyph for the given character. + * @param {string} + * @return {Boolean} + */ + Font.prototype.hasChar = function(c) { + return this.encoding.charToGlyphIndex(c) !== null; + }; + + /** + * Convert the given character to a single glyph index. + * Note that this function assumes that there is a one-to-one mapping between + * the given character and a glyph; for complex scripts this might not be the case. + * @param {string} + * @return {Number} + */ + Font.prototype.charToGlyphIndex = function(s) { + return this.encoding.charToGlyphIndex(s); + }; + + /** + * Convert the given character to a single Glyph object. + * Note that this function assumes that there is a one-to-one mapping between + * the given character and a glyph; for complex scripts this might not be the case. + * @param {string} + * @return {opentype.Glyph} + */ + Font.prototype.charToGlyph = function(c) { + var glyphIndex = this.charToGlyphIndex(c); + var glyph = this.glyphs.get(glyphIndex); + if (!glyph) { + // .notdef + glyph = this.glyphs.get(0); + } + + return glyph; + }; + + /** + * Convert the given text to a list of Glyph objects. + * Note that there is no strict one-to-one mapping between characters and + * glyphs, so the list of returned glyphs can be larger or smaller than the + * length of the given string. + * @param {string} + * @param {GlyphRenderOptions} [options] + * @return {opentype.Glyph[]} + */ + Font.prototype.stringToGlyphs = function(s, options) { + var this$1 = this; + + options = options || this.defaultRenderOptions; + // Get glyph indexes + var chars = arrayFromString(s); + var indexes = []; + for (var i = 0; i < chars.length; i += 1) { + var c = chars[i]; + indexes.push(this$1.charToGlyphIndex(c)); + } + var length = indexes.length; + + // Apply substitutions on glyph indexes + if (options.features) { + var script = options.script || this.substitution.getDefaultScriptName(); + var manyToOne = []; + if (options.features.liga) { manyToOne = manyToOne.concat(this.substitution.getFeature('liga', script, options.language)); } + if (options.features.rlig) { manyToOne = manyToOne.concat(this.substitution.getFeature('rlig', script, options.language)); } + for (var i$1 = 0; i$1 < length; i$1 += 1) { + for (var j = 0; j < manyToOne.length; j++) { + var ligature = manyToOne[j]; + var components = ligature.sub; + var compCount = components.length; + var k = 0; + while (k < compCount && components[k] === indexes[i$1 + k]) { k++; } + if (k === compCount) { + indexes.splice(i$1, compCount, ligature.by); + length = length - compCount + 1; + } + } + } + } + + // convert glyph indexes to glyph objects + var glyphs = new Array(length); + var notdef = this.glyphs.get(0); + for (var i$2 = 0; i$2 < length; i$2 += 1) { + glyphs[i$2] = this$1.glyphs.get(indexes[i$2]) || notdef; + } + return glyphs; + }; + + /** + * @param {string} + * @return {Number} + */ + Font.prototype.nameToGlyphIndex = function(name) { + return this.glyphNames.nameToGlyphIndex(name); + }; + + /** + * @param {string} + * @return {opentype.Glyph} + */ + Font.prototype.nameToGlyph = function(name) { + var glyphIndex = this.nameToGlyphIndex(name); + var glyph = this.glyphs.get(glyphIndex); + if (!glyph) { + // .notdef + glyph = this.glyphs.get(0); + } + + return glyph; + }; + + /** + * @param {Number} + * @return {String} + */ + Font.prototype.glyphIndexToName = function(gid) { + if (!this.glyphNames.glyphIndexToName) { + return ''; + } + + return this.glyphNames.glyphIndexToName(gid); + }; + + /** + * Retrieve the value of the kerning pair between the left glyph (or its index) + * and the right glyph (or its index). If no kerning pair is found, return 0. + * The kerning value gets added to the advance width when calculating the spacing + * between glyphs. + * For GPOS kerning, this method uses the default script and language, which covers + * most use cases. To have greater control, use font.position.getKerningValue . + * @param {opentype.Glyph} leftGlyph + * @param {opentype.Glyph} rightGlyph + * @return {Number} + */ + Font.prototype.getKerningValue = function(leftGlyph, rightGlyph) { + leftGlyph = leftGlyph.index || leftGlyph; + rightGlyph = rightGlyph.index || rightGlyph; + var gposKerning = this.position.defaultKerningTables; + if (gposKerning) { + return this.position.getKerningValue(gposKerning, leftGlyph, rightGlyph); + } + // "kern" table + return this.kerningPairs[leftGlyph + ',' + rightGlyph] || 0; + }; + + /** + * @typedef GlyphRenderOptions + * @type Object + * @property {string} [script] - script used to determine which features to apply. By default, 'DFLT' or 'latn' is used. + * See https://www.microsoft.com/typography/otspec/scripttags.htm + * @property {string} [language='dflt'] - language system used to determine which features to apply. + * See https://www.microsoft.com/typography/developers/opentype/languagetags.aspx + * @property {boolean} [kerning=true] - whether to include kerning values + * @property {object} [features] - OpenType Layout feature tags. Used to enable or disable the features of the given script/language system. + * See https://www.microsoft.com/typography/otspec/featuretags.htm + */ + Font.prototype.defaultRenderOptions = { + kerning: true, + features: { + liga: true, + rlig: true + } + }; + + /** + * Helper function that invokes the given callback for each glyph in the given text. + * The callback gets `(glyph, x, y, fontSize, options)`.* @param {string} text + * @param {string} text - The text to apply. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {GlyphRenderOptions=} options + * @param {Function} callback + */ + Font.prototype.forEachGlyph = function(text, x, y, fontSize, options, callback) { + var this$1 = this; + + x = x !== undefined ? x : 0; + y = y !== undefined ? y : 0; + fontSize = fontSize !== undefined ? fontSize : 72; + options = options || this.defaultRenderOptions; + var fontScale = 1 / this.unitsPerEm * fontSize; + var glyphs = this.stringToGlyphs(text, options); + var kerningLookups; + if (options.kerning) { + var script = options.script || this.position.getDefaultScriptName(); + kerningLookups = this.position.getKerningTables(script, options.language); + } + for (var i = 0; i < glyphs.length; i += 1) { + var glyph = glyphs[i]; + callback.call(this$1, glyph, x, y, fontSize, options); + if (glyph.advanceWidth) { + x += glyph.advanceWidth * fontScale; + } + + if (options.kerning && i < glyphs.length - 1) { + // We should apply position adjustment lookups in a more generic way. + // Here we only use the xAdvance value. + var kerningValue = kerningLookups ? + this$1.position.getKerningValue(kerningLookups, glyph.index, glyphs[i + 1].index) : + this$1.getKerningValue(glyph, glyphs[i + 1]); + x += kerningValue * fontScale; + } + + if (options.letterSpacing) { + x += options.letterSpacing * fontSize; + } else if (options.tracking) { + x += (options.tracking / 1000) * fontSize; + } + } + return x; + }; + + /** + * Create a Path object that represents the given text. + * @param {string} text - The text to create. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {GlyphRenderOptions=} options + * @return {opentype.Path} + */ + Font.prototype.getPath = function(text, x, y, fontSize, options) { + var fullPath = new Path(); + this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) { + var glyphPath = glyph.getPath(gX, gY, gFontSize, options, this); + fullPath.extend(glyphPath); + }); + return fullPath; + }; + + /** + * Create an array of Path objects that represent the glyphs of a given text. + * @param {string} text - The text to create. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {GlyphRenderOptions=} options + * @return {opentype.Path[]} + */ + Font.prototype.getPaths = function(text, x, y, fontSize, options) { + var glyphPaths = []; + this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) { + var glyphPath = glyph.getPath(gX, gY, gFontSize, options, this); + glyphPaths.push(glyphPath); + }); + + return glyphPaths; + }; + + /** + * Returns the advance width of a text. + * + * This is something different than Path.getBoundingBox() as for example a + * suffixed whitespace increases the advanceWidth but not the bounding box + * or an overhanging letter like a calligraphic 'f' might have a quite larger + * bounding box than its advance width. + * + * This corresponds to canvas2dContext.measureText(text).width + * + * @param {string} text - The text to create. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {GlyphRenderOptions=} options + * @return advance width + */ + Font.prototype.getAdvanceWidth = function(text, fontSize, options) { + return this.forEachGlyph(text, 0, 0, fontSize, options, function() {}); + }; + + /** + * Draw the text on the given drawing context. + * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas. + * @param {string} text - The text to create. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {GlyphRenderOptions=} options + */ + Font.prototype.draw = function(ctx, text, x, y, fontSize, options) { + this.getPath(text, x, y, fontSize, options).draw(ctx); + }; + + /** + * Draw the points of all glyphs in the text. + * On-curve points will be drawn in blue, off-curve points will be drawn in red. + * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas. + * @param {string} text - The text to create. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {GlyphRenderOptions=} options + */ + Font.prototype.drawPoints = function(ctx, text, x, y, fontSize, options) { + this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) { + glyph.drawPoints(ctx, gX, gY, gFontSize); + }); + }; + + /** + * Draw lines indicating important font measurements for all glyphs in the text. + * Black lines indicate the origin of the coordinate system (point 0,0). + * Blue lines indicate the glyph bounding box. + * Green line indicates the advance width of the glyph. + * @param {CanvasRenderingContext2D} ctx - A 2D drawing context, like Canvas. + * @param {string} text - The text to create. + * @param {number} [x=0] - Horizontal position of the beginning of the text. + * @param {number} [y=0] - Vertical position of the *baseline* of the text. + * @param {number} [fontSize=72] - Font size in pixels. We scale the glyph units by `1 / unitsPerEm * fontSize`. + * @param {GlyphRenderOptions=} options + */ + Font.prototype.drawMetrics = function(ctx, text, x, y, fontSize, options) { + this.forEachGlyph(text, x, y, fontSize, options, function(glyph, gX, gY, gFontSize) { + glyph.drawMetrics(ctx, gX, gY, gFontSize); + }); + }; + + /** + * @param {string} + * @return {string} + */ + Font.prototype.getEnglishName = function(name) { + var translations = this.names[name]; + if (translations) { + return translations.en; + } + }; + + /** + * Validate + */ + Font.prototype.validate = function() { + var _this = this; + + function assert(predicate, message) { + } + + function assertNamePresent(name) { + var englishName = _this.getEnglishName(name); + assert(englishName && englishName.trim().length > 0, + 'No English ' + name + ' specified.'); + } + + // Identification information + assertNamePresent('fontFamily'); + assertNamePresent('weightName'); + assertNamePresent('manufacturer'); + assertNamePresent('copyright'); + assertNamePresent('version'); + + // Dimension information + assert(this.unitsPerEm > 0, 'No unitsPerEm specified.'); + }; + + /** + * Convert the font object to a SFNT data structure. + * This structure contains all the necessary tables and metadata to create a binary OTF file. + * @return {opentype.Table} + */ + Font.prototype.toTables = function() { + return sfnt.fontToTable(this); + }; + /** + * @deprecated Font.toBuffer is deprecated. Use Font.toArrayBuffer instead. + */ + Font.prototype.toBuffer = function() { + console.warn('Font.toBuffer is deprecated. Use Font.toArrayBuffer instead.'); + return this.toArrayBuffer(); + }; + /** + * Converts a `opentype.Font` into an `ArrayBuffer` + * @return {ArrayBuffer} + */ + Font.prototype.toArrayBuffer = function() { + var sfntTable = this.toTables(); + var bytes = sfntTable.encode(); + var buffer = new ArrayBuffer(bytes.length); + var intArray = new Uint8Array(buffer); + for (var i = 0; i < bytes.length; i++) { + intArray[i] = bytes[i]; + } + + return buffer; + }; + + /** + * Initiate a download of the OpenType font. + */ + Font.prototype.download = function(fileName) { + var familyName = this.getEnglishName('fontFamily'); + var styleName = this.getEnglishName('fontSubfamily'); + fileName = fileName || familyName.replace(/\s/g, '') + '-' + styleName + '.otf'; + var arrayBuffer = this.toArrayBuffer(); + + if (isBrowser()) { + window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem; + window.requestFileSystem(window.TEMPORARY, arrayBuffer.byteLength, function(fs) { + fs.root.getFile(fileName, {create: true}, function(fileEntry) { + fileEntry.createWriter(function(writer) { + var dataView = new DataView(arrayBuffer); + var blob = new Blob([dataView], {type: 'font/opentype'}); + writer.write(blob); + + writer.addEventListener('writeend', function() { + // Navigating to the file will download it. + location.href = fileEntry.toURL(); + }, false); + }); + }); + }, + function(err) { + throw new Error(err.name + ': ' + err.message); + }); + } else { + var fs = _dereq_('fs'); + var buffer = arrayBufferToNodeBuffer(arrayBuffer); + fs.writeFileSync(fileName, buffer); + } + }; + /** + * @private + */ + Font.prototype.fsSelectionValues = { + ITALIC: 0x001, //1 + UNDERSCORE: 0x002, //2 + NEGATIVE: 0x004, //4 + OUTLINED: 0x008, //8 + STRIKEOUT: 0x010, //16 + BOLD: 0x020, //32 + REGULAR: 0x040, //64 + USER_TYPO_METRICS: 0x080, //128 + WWS: 0x100, //256 + OBLIQUE: 0x200 //512 + }; + + /** + * @private + */ + Font.prototype.usWidthClasses = { + ULTRA_CONDENSED: 1, + EXTRA_CONDENSED: 2, + CONDENSED: 3, + SEMI_CONDENSED: 4, + MEDIUM: 5, + SEMI_EXPANDED: 6, + EXPANDED: 7, + EXTRA_EXPANDED: 8, + ULTRA_EXPANDED: 9 + }; + + /** + * @private + */ + Font.prototype.usWeightClasses = { + THIN: 100, + EXTRA_LIGHT: 200, + LIGHT: 300, + NORMAL: 400, + MEDIUM: 500, + SEMI_BOLD: 600, + BOLD: 700, + EXTRA_BOLD: 800, + BLACK: 900 + }; + + // The `fvar` table stores font variation axes and instances. + + function addName(name, names) { + var nameString = JSON.stringify(name); + var nameID = 256; + for (var nameKey in names) { + var n = parseInt(nameKey); + if (!n || n < 256) { + continue; + } + + if (JSON.stringify(names[nameKey]) === nameString) { + return n; + } + + if (nameID <= n) { + nameID = n + 1; + } + } + + names[nameID] = name; + return nameID; + } + + function makeFvarAxis(n, axis, names) { + var nameID = addName(axis.name, names); + return [ + {name: 'tag_' + n, type: 'TAG', value: axis.tag}, + {name: 'minValue_' + n, type: 'FIXED', value: axis.minValue << 16}, + {name: 'defaultValue_' + n, type: 'FIXED', value: axis.defaultValue << 16}, + {name: 'maxValue_' + n, type: 'FIXED', value: axis.maxValue << 16}, + {name: 'flags_' + n, type: 'USHORT', value: 0}, + {name: 'nameID_' + n, type: 'USHORT', value: nameID} + ]; + } + + function parseFvarAxis(data, start, names) { + var axis = {}; + var p = new parse.Parser(data, start); + axis.tag = p.parseTag(); + axis.minValue = p.parseFixed(); + axis.defaultValue = p.parseFixed(); + axis.maxValue = p.parseFixed(); + p.skip('uShort', 1); // reserved for flags; no values defined + axis.name = names[p.parseUShort()] || {}; + return axis; + } + + function makeFvarInstance(n, inst, axes, names) { + var nameID = addName(inst.name, names); + var fields = [ + {name: 'nameID_' + n, type: 'USHORT', value: nameID}, + {name: 'flags_' + n, type: 'USHORT', value: 0} + ]; + + for (var i = 0; i < axes.length; ++i) { + var axisTag = axes[i].tag; + fields.push({ + name: 'axis_' + n + ' ' + axisTag, + type: 'FIXED', + value: inst.coordinates[axisTag] << 16 + }); + } + + return fields; + } + + function parseFvarInstance(data, start, axes, names) { + var inst = {}; + var p = new parse.Parser(data, start); + inst.name = names[p.parseUShort()] || {}; + p.skip('uShort', 1); // reserved for flags; no values defined + + inst.coordinates = {}; + for (var i = 0; i < axes.length; ++i) { + inst.coordinates[axes[i].tag] = p.parseFixed(); + } + + return inst; + } + + function makeFvarTable(fvar, names) { + var result = new table.Table('fvar', [ + {name: 'version', type: 'ULONG', value: 0x10000}, + {name: 'offsetToData', type: 'USHORT', value: 0}, + {name: 'countSizePairs', type: 'USHORT', value: 2}, + {name: 'axisCount', type: 'USHORT', value: fvar.axes.length}, + {name: 'axisSize', type: 'USHORT', value: 20}, + {name: 'instanceCount', type: 'USHORT', value: fvar.instances.length}, + {name: 'instanceSize', type: 'USHORT', value: 4 + fvar.axes.length * 4} + ]); + result.offsetToData = result.sizeOf(); + + for (var i = 0; i < fvar.axes.length; i++) { + result.fields = result.fields.concat(makeFvarAxis(i, fvar.axes[i], names)); + } + + for (var j = 0; j < fvar.instances.length; j++) { + result.fields = result.fields.concat(makeFvarInstance(j, fvar.instances[j], fvar.axes, names)); + } + + return result; + } + + function parseFvarTable(data, start, names) { + var p = new parse.Parser(data, start); + var tableVersion = p.parseULong(); + check.argument(tableVersion === 0x00010000, 'Unsupported fvar table version.'); + var offsetToData = p.parseOffset16(); + // Skip countSizePairs. + p.skip('uShort', 1); + var axisCount = p.parseUShort(); + var axisSize = p.parseUShort(); + var instanceCount = p.parseUShort(); + var instanceSize = p.parseUShort(); + + var axes = []; + for (var i = 0; i < axisCount; i++) { + axes.push(parseFvarAxis(data, start + offsetToData + i * axisSize, names)); + } + + var instances = []; + var instanceStart = start + offsetToData + axisCount * axisSize; + for (var j = 0; j < instanceCount; j++) { + instances.push(parseFvarInstance(data, instanceStart + j * instanceSize, axes, names)); + } + + return {axes: axes, instances: instances}; + } + + var fvar = { make: makeFvarTable, parse: parseFvarTable }; + + // The `GPOS` table contains kerning pairs, among other things. + + var subtableParsers$1 = new Array(10); // subtableParsers[0] is unused + + // https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#lookup-type-1-single-adjustment-positioning-subtable + // this = Parser instance + subtableParsers$1[1] = function parseLookup1() { + var start = this.offset + this.relativeOffset; + var posformat = this.parseUShort(); + if (posformat === 1) { + return { + posFormat: 1, + coverage: this.parsePointer(Parser.coverage), + value: this.parseValueRecord() + }; + } else if (posformat === 2) { + return { + posFormat: 2, + coverage: this.parsePointer(Parser.coverage), + values: this.parseValueRecordList() + }; + } + check.assert(false, '0x' + start.toString(16) + ': GPOS lookup type 1 format must be 1 or 2.'); + }; + + // https://docs.microsoft.com/en-us/typography/opentype/spec/gpos#lookup-type-2-pair-adjustment-positioning-subtable + subtableParsers$1[2] = function parseLookup2() { + var start = this.offset + this.relativeOffset; + var posFormat = this.parseUShort(); + check.assert(posFormat === 1 || posFormat === 2, '0x' + start.toString(16) + ': GPOS lookup type 2 format must be 1 or 2.'); + var coverage = this.parsePointer(Parser.coverage); + var valueFormat1 = this.parseUShort(); + var valueFormat2 = this.parseUShort(); + if (posFormat === 1) { + // Adjustments for Glyph Pairs + return { + posFormat: posFormat, + coverage: coverage, + valueFormat1: valueFormat1, + valueFormat2: valueFormat2, + pairSets: this.parseList(Parser.pointer(Parser.list(function() { + return { // pairValueRecord + secondGlyph: this.parseUShort(), + value1: this.parseValueRecord(valueFormat1), + value2: this.parseValueRecord(valueFormat2) + }; + }))) + }; + } else if (posFormat === 2) { + var classDef1 = this.parsePointer(Parser.classDef); + var classDef2 = this.parsePointer(Parser.classDef); + var class1Count = this.parseUShort(); + var class2Count = this.parseUShort(); + return { + // Class Pair Adjustment + posFormat: posFormat, + coverage: coverage, + valueFormat1: valueFormat1, + valueFormat2: valueFormat2, + classDef1: classDef1, + classDef2: classDef2, + class1Count: class1Count, + class2Count: class2Count, + classRecords: this.parseList(class1Count, Parser.list(class2Count, function() { + return { + value1: this.parseValueRecord(valueFormat1), + value2: this.parseValueRecord(valueFormat2) + }; + })) + }; + } + }; + + subtableParsers$1[3] = function parseLookup3() { return { error: 'GPOS Lookup 3 not supported' }; }; + subtableParsers$1[4] = function parseLookup4() { return { error: 'GPOS Lookup 4 not supported' }; }; + subtableParsers$1[5] = function parseLookup5() { return { error: 'GPOS Lookup 5 not supported' }; }; + subtableParsers$1[6] = function parseLookup6() { return { error: 'GPOS Lookup 6 not supported' }; }; + subtableParsers$1[7] = function parseLookup7() { return { error: 'GPOS Lookup 7 not supported' }; }; + subtableParsers$1[8] = function parseLookup8() { return { error: 'GPOS Lookup 8 not supported' }; }; + subtableParsers$1[9] = function parseLookup9() { return { error: 'GPOS Lookup 9 not supported' }; }; + + // https://docs.microsoft.com/en-us/typography/opentype/spec/gpos + function parseGposTable(data, start) { + start = start || 0; + var p = new Parser(data, start); + var tableVersion = p.parseVersion(1); + check.argument(tableVersion === 1 || tableVersion === 1.1, 'Unsupported GPOS table version ' + tableVersion); + + if (tableVersion === 1) { + return { + version: tableVersion, + scripts: p.parseScriptList(), + features: p.parseFeatureList(), + lookups: p.parseLookupList(subtableParsers$1) + }; + } else { + return { + version: tableVersion, + scripts: p.parseScriptList(), + features: p.parseFeatureList(), + lookups: p.parseLookupList(subtableParsers$1), + variations: p.parseFeatureVariationsList() + }; + } + + } + + // GPOS Writing ////////////////////////////////////////////// + // NOT SUPPORTED + var subtableMakers$1 = new Array(10); + + function makeGposTable(gpos) { + return new table.Table('GPOS', [ + {name: 'version', type: 'ULONG', value: 0x10000}, + {name: 'scripts', type: 'TABLE', value: new table.ScriptList(gpos.scripts)}, + {name: 'features', type: 'TABLE', value: new table.FeatureList(gpos.features)}, + {name: 'lookups', type: 'TABLE', value: new table.LookupList(gpos.lookups, subtableMakers$1)} + ]); + } + + var gpos = { parse: parseGposTable, make: makeGposTable }; + + // The `kern` table contains kerning pairs. + + function parseWindowsKernTable(p) { + var pairs = {}; + // Skip nTables. + p.skip('uShort'); + var subtableVersion = p.parseUShort(); + check.argument(subtableVersion === 0, 'Unsupported kern sub-table version.'); + // Skip subtableLength, subtableCoverage + p.skip('uShort', 2); + var nPairs = p.parseUShort(); + // Skip searchRange, entrySelector, rangeShift. + p.skip('uShort', 3); + for (var i = 0; i < nPairs; i += 1) { + var leftIndex = p.parseUShort(); + var rightIndex = p.parseUShort(); + var value = p.parseShort(); + pairs[leftIndex + ',' + rightIndex] = value; + } + return pairs; + } + + function parseMacKernTable(p) { + var pairs = {}; + // The Mac kern table stores the version as a fixed (32 bits) but we only loaded the first 16 bits. + // Skip the rest. + p.skip('uShort'); + var nTables = p.parseULong(); + //check.argument(nTables === 1, 'Only 1 subtable is supported (got ' + nTables + ').'); + if (nTables > 1) { + console.warn('Only the first kern subtable is supported.'); + } + p.skip('uLong'); + var coverage = p.parseUShort(); + var subtableVersion = coverage & 0xFF; + p.skip('uShort'); + if (subtableVersion === 0) { + var nPairs = p.parseUShort(); + // Skip searchRange, entrySelector, rangeShift. + p.skip('uShort', 3); + for (var i = 0; i < nPairs; i += 1) { + var leftIndex = p.parseUShort(); + var rightIndex = p.parseUShort(); + var value = p.parseShort(); + pairs[leftIndex + ',' + rightIndex] = value; + } + } + return pairs; + } + + // Parse the `kern` table which contains kerning pairs. + function parseKernTable(data, start) { + var p = new parse.Parser(data, start); + var tableVersion = p.parseUShort(); + if (tableVersion === 0) { + return parseWindowsKernTable(p); + } else if (tableVersion === 1) { + return parseMacKernTable(p); + } else { + throw new Error('Unsupported kern table version (' + tableVersion + ').'); + } + } + + var kern = { parse: parseKernTable }; + + // The `loca` table stores the offsets to the locations of the glyphs in the font. + + // Parse the `loca` table. This table stores the offsets to the locations of the glyphs in the font, + // relative to the beginning of the glyphData table. + // The number of glyphs stored in the `loca` table is specified in the `maxp` table (under numGlyphs) + // The loca table has two versions: a short version where offsets are stored as uShorts, and a long + // version where offsets are stored as uLongs. The `head` table specifies which version to use + // (under indexToLocFormat). + function parseLocaTable(data, start, numGlyphs, shortVersion) { + var p = new parse.Parser(data, start); + var parseFn = shortVersion ? p.parseUShort : p.parseULong; + // There is an extra entry after the last index element to compute the length of the last glyph. + // That's why we use numGlyphs + 1. + var glyphOffsets = []; + for (var i = 0; i < numGlyphs + 1; i += 1) { + var glyphOffset = parseFn.call(p); + if (shortVersion) { + // The short table version stores the actual offset divided by 2. + glyphOffset *= 2; + } + + glyphOffsets.push(glyphOffset); + } + + return glyphOffsets; + } + + var loca = { parse: parseLocaTable }; + + // opentype.js + + /** + * The opentype library. + * @namespace opentype + */ + + // File loaders ///////////////////////////////////////////////////////// + /** + * Loads a font from a file. The callback throws an error message as the first parameter if it fails + * and the font as an ArrayBuffer in the second parameter if it succeeds. + * @param {string} path - The path of the file + * @param {Function} callback - The function to call when the font load completes + */ + function loadFromFile(path, callback) { + var fs = _dereq_('fs'); + fs.readFile(path, function(err, buffer) { + if (err) { + return callback(err.message); + } + + callback(null, nodeBufferToArrayBuffer(buffer)); + }); + } + /** + * Loads a font from a URL. The callback throws an error message as the first parameter if it fails + * and the font as an ArrayBuffer in the second parameter if it succeeds. + * @param {string} url - The URL of the font file. + * @param {Function} callback - The function to call when the font load completes + */ + function loadFromUrl(url, callback) { + var request = new XMLHttpRequest(); + request.open('get', url, true); + request.responseType = 'arraybuffer'; + request.onload = function() { + if (request.response) { + return callback(null, request.response); + } else { + return callback('Font could not be loaded: ' + request.statusText); + } + }; + + request.onerror = function () { + callback('Font could not be loaded'); + }; + + request.send(); + } + + // Table Directory Entries ////////////////////////////////////////////// + /** + * Parses OpenType table entries. + * @param {DataView} + * @param {Number} + * @return {Object[]} + */ + function parseOpenTypeTableEntries(data, numTables) { + var tableEntries = []; + var p = 12; + for (var i = 0; i < numTables; i += 1) { + var tag = parse.getTag(data, p); + var checksum = parse.getULong(data, p + 4); + var offset = parse.getULong(data, p + 8); + var length = parse.getULong(data, p + 12); + tableEntries.push({tag: tag, checksum: checksum, offset: offset, length: length, compression: false}); + p += 16; + } + + return tableEntries; + } + + /** + * Parses WOFF table entries. + * @param {DataView} + * @param {Number} + * @return {Object[]} + */ + function parseWOFFTableEntries(data, numTables) { + var tableEntries = []; + var p = 44; // offset to the first table directory entry. + for (var i = 0; i < numTables; i += 1) { + var tag = parse.getTag(data, p); + var offset = parse.getULong(data, p + 4); + var compLength = parse.getULong(data, p + 8); + var origLength = parse.getULong(data, p + 12); + var compression = (void 0); + if (compLength < origLength) { + compression = 'WOFF'; + } else { + compression = false; + } + + tableEntries.push({tag: tag, offset: offset, compression: compression, + compressedLength: compLength, length: origLength}); + p += 20; + } + + return tableEntries; + } + + /** + * @typedef TableData + * @type Object + * @property {DataView} data - The DataView + * @property {number} offset - The data offset. + */ + + /** + * @param {DataView} + * @param {Object} + * @return {TableData} + */ + function uncompressTable(data, tableEntry) { + if (tableEntry.compression === 'WOFF') { + var inBuffer = new Uint8Array(data.buffer, tableEntry.offset + 2, tableEntry.compressedLength - 2); + var outBuffer = new Uint8Array(tableEntry.length); + tinyInflate(inBuffer, outBuffer); + if (outBuffer.byteLength !== tableEntry.length) { + throw new Error('Decompression error: ' + tableEntry.tag + ' decompressed length doesn\'t match recorded length'); + } + + var view = new DataView(outBuffer.buffer, 0); + return {data: view, offset: 0}; + } else { + return {data: data, offset: tableEntry.offset}; + } + } + + // Public API /////////////////////////////////////////////////////////// + + /** + * Parse the OpenType file data (as an ArrayBuffer) and return a Font object. + * Throws an error if the font could not be parsed. + * @param {ArrayBuffer} + * @return {opentype.Font} + */ + function parseBuffer(buffer) { + var indexToLocFormat; + var ltagTable; + + // Since the constructor can also be called to create new fonts from scratch, we indicate this + // should be an empty font that we'll fill with our own data. + var font = new Font({empty: true}); + + // OpenType fonts use big endian byte ordering. + // We can't rely on typed array view types, because they operate with the endianness of the host computer. + // Instead we use DataViews where we can specify endianness. + var data = new DataView(buffer, 0); + var numTables; + var tableEntries = []; + var signature = parse.getTag(data, 0); + if (signature === String.fromCharCode(0, 1, 0, 0) || signature === 'true' || signature === 'typ1') { + font.outlinesFormat = 'truetype'; + numTables = parse.getUShort(data, 4); + tableEntries = parseOpenTypeTableEntries(data, numTables); + } else if (signature === 'OTTO') { + font.outlinesFormat = 'cff'; + numTables = parse.getUShort(data, 4); + tableEntries = parseOpenTypeTableEntries(data, numTables); + } else if (signature === 'wOFF') { + var flavor = parse.getTag(data, 4); + if (flavor === String.fromCharCode(0, 1, 0, 0)) { + font.outlinesFormat = 'truetype'; + } else if (flavor === 'OTTO') { + font.outlinesFormat = 'cff'; + } else { + throw new Error('Unsupported OpenType flavor ' + signature); + } + + numTables = parse.getUShort(data, 12); + tableEntries = parseWOFFTableEntries(data, numTables); + } else { + throw new Error('Unsupported OpenType signature ' + signature); + } + + var cffTableEntry; + var fvarTableEntry; + var glyfTableEntry; + var gposTableEntry; + var gsubTableEntry; + var hmtxTableEntry; + var kernTableEntry; + var locaTableEntry; + var nameTableEntry; + var metaTableEntry; + var p; + + for (var i = 0; i < numTables; i += 1) { + var tableEntry = tableEntries[i]; + var table = (void 0); + switch (tableEntry.tag) { + case 'cmap': + table = uncompressTable(data, tableEntry); + font.tables.cmap = cmap.parse(table.data, table.offset); + font.encoding = new CmapEncoding(font.tables.cmap); + break; + case 'cvt ' : + table = uncompressTable(data, tableEntry); + p = new parse.Parser(table.data, table.offset); + font.tables.cvt = p.parseShortList(tableEntry.length / 2); + break; + case 'fvar': + fvarTableEntry = tableEntry; + break; + case 'fpgm' : + table = uncompressTable(data, tableEntry); + p = new parse.Parser(table.data, table.offset); + font.tables.fpgm = p.parseByteList(tableEntry.length); + break; + case 'head': + table = uncompressTable(data, tableEntry); + font.tables.head = head.parse(table.data, table.offset); + font.unitsPerEm = font.tables.head.unitsPerEm; + indexToLocFormat = font.tables.head.indexToLocFormat; + break; + case 'hhea': + table = uncompressTable(data, tableEntry); + font.tables.hhea = hhea.parse(table.data, table.offset); + font.ascender = font.tables.hhea.ascender; + font.descender = font.tables.hhea.descender; + font.numberOfHMetrics = font.tables.hhea.numberOfHMetrics; + break; + case 'hmtx': + hmtxTableEntry = tableEntry; + break; + case 'ltag': + table = uncompressTable(data, tableEntry); + ltagTable = ltag.parse(table.data, table.offset); + break; + case 'maxp': + table = uncompressTable(data, tableEntry); + font.tables.maxp = maxp.parse(table.data, table.offset); + font.numGlyphs = font.tables.maxp.numGlyphs; + break; + case 'name': + nameTableEntry = tableEntry; + break; + case 'OS/2': + table = uncompressTable(data, tableEntry); + font.tables.os2 = os2.parse(table.data, table.offset); + break; + case 'post': + table = uncompressTable(data, tableEntry); + font.tables.post = post.parse(table.data, table.offset); + font.glyphNames = new GlyphNames(font.tables.post); + break; + case 'prep' : + table = uncompressTable(data, tableEntry); + p = new parse.Parser(table.data, table.offset); + font.tables.prep = p.parseByteList(tableEntry.length); + break; + case 'glyf': + glyfTableEntry = tableEntry; + break; + case 'loca': + locaTableEntry = tableEntry; + break; + case 'CFF ': + cffTableEntry = tableEntry; + break; + case 'kern': + kernTableEntry = tableEntry; + break; + case 'GPOS': + gposTableEntry = tableEntry; + break; + case 'GSUB': + gsubTableEntry = tableEntry; + break; + case 'meta': + metaTableEntry = tableEntry; + break; + } + } + + var nameTable = uncompressTable(data, nameTableEntry); + font.tables.name = _name.parse(nameTable.data, nameTable.offset, ltagTable); + font.names = font.tables.name; + + if (glyfTableEntry && locaTableEntry) { + var shortVersion = indexToLocFormat === 0; + var locaTable = uncompressTable(data, locaTableEntry); + var locaOffsets = loca.parse(locaTable.data, locaTable.offset, font.numGlyphs, shortVersion); + var glyfTable = uncompressTable(data, glyfTableEntry); + font.glyphs = glyf.parse(glyfTable.data, glyfTable.offset, locaOffsets, font); + } else if (cffTableEntry) { + var cffTable = uncompressTable(data, cffTableEntry); + cff.parse(cffTable.data, cffTable.offset, font); + } else { + throw new Error('Font doesn\'t contain TrueType or CFF outlines.'); + } + + var hmtxTable = uncompressTable(data, hmtxTableEntry); + hmtx.parse(hmtxTable.data, hmtxTable.offset, font.numberOfHMetrics, font.numGlyphs, font.glyphs); + addGlyphNames(font); + + if (kernTableEntry) { + var kernTable = uncompressTable(data, kernTableEntry); + font.kerningPairs = kern.parse(kernTable.data, kernTable.offset); + } else { + font.kerningPairs = {}; + } + + if (gposTableEntry) { + var gposTable = uncompressTable(data, gposTableEntry); + font.tables.gpos = gpos.parse(gposTable.data, gposTable.offset); + font.position.init(); + } + + if (gsubTableEntry) { + var gsubTable = uncompressTable(data, gsubTableEntry); + font.tables.gsub = gsub.parse(gsubTable.data, gsubTable.offset); + } + + if (fvarTableEntry) { + var fvarTable = uncompressTable(data, fvarTableEntry); + font.tables.fvar = fvar.parse(fvarTable.data, fvarTable.offset, font.names); + } + + if (metaTableEntry) { + var metaTable = uncompressTable(data, metaTableEntry); + font.tables.meta = meta.parse(metaTable.data, metaTable.offset); + font.metas = font.tables.meta; + } + + return font; + } + + /** + * Asynchronously load the font from a URL or a filesystem. When done, call the callback + * with two arguments `(err, font)`. The `err` will be null on success, + * the `font` is a Font object. + * We use the node.js callback convention so that + * opentype.js can integrate with frameworks like async.js. + * @alias opentype.load + * @param {string} url - The URL of the font to load. + * @param {Function} callback - The callback. + */ + function load(url, callback) { + var isNode$$1 = typeof window === 'undefined'; + var loadFn = isNode$$1 ? loadFromFile : loadFromUrl; + loadFn(url, function(err, arrayBuffer) { + if (err) { + return callback(err); + } + var font; + try { + font = parseBuffer(arrayBuffer); + } catch (e) { + return callback(e, null); + } + return callback(null, font); + }); + } + + /** + * Synchronously load the font from a URL or file. + * When done, returns the font object or throws an error. + * @alias opentype.loadSync + * @param {string} url - The URL of the font to load. + * @return {opentype.Font} + */ + function loadSync(url) { + var fs = _dereq_('fs'); + var buffer = fs.readFileSync(url); + return parseBuffer(nodeBufferToArrayBuffer(buffer)); + } + + exports.Font = Font; + exports.Glyph = Glyph; + exports.Path = Path; + exports.BoundingBox = BoundingBox; + exports._parse = parse; + exports.parse = parseBuffer; + exports.load = load; + exports.loadSync = loadSync; + + Object.defineProperty(exports, '__esModule', { value: true }); + +}))); + + +}).call(this,_dereq_("buffer").Buffer) +},{"buffer":4,"fs":3}],11:[function(_dereq_,module,exports){ +// shim for using process in browser +var process = module.exports = {}; + +// cached from whatever global is present so that test runners that stub it +// don't break things. But we need to wrap it in a try catch in case it is +// wrapped in strict mode code which doesn't define any globals. It's inside a +// function because try/catches deoptimize in certain engines. + +var cachedSetTimeout; +var cachedClearTimeout; + +function defaultSetTimout() { + throw new Error('setTimeout has not been defined'); +} +function defaultClearTimeout () { + throw new Error('clearTimeout has not been defined'); +} +(function () { + try { + if (typeof setTimeout === 'function') { + cachedSetTimeout = setTimeout; + } else { + cachedSetTimeout = defaultSetTimout; + } + } catch (e) { + cachedSetTimeout = defaultSetTimout; + } + try { + if (typeof clearTimeout === 'function') { + cachedClearTimeout = clearTimeout; + } else { + cachedClearTimeout = defaultClearTimeout; + } + } catch (e) { + cachedClearTimeout = defaultClearTimeout; + } +} ()) +function runTimeout(fun) { + if (cachedSetTimeout === setTimeout) { + //normal enviroments in sane situations + return setTimeout(fun, 0); + } + // if setTimeout wasn't available but was latter defined + if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) { + cachedSetTimeout = setTimeout; + return setTimeout(fun, 0); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedSetTimeout(fun, 0); + } catch(e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedSetTimeout.call(null, fun, 0); + } catch(e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error + return cachedSetTimeout.call(this, fun, 0); + } + } + + +} +function runClearTimeout(marker) { + if (cachedClearTimeout === clearTimeout) { + //normal enviroments in sane situations + return clearTimeout(marker); + } + // if clearTimeout wasn't available but was latter defined + if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) { + cachedClearTimeout = clearTimeout; + return clearTimeout(marker); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedClearTimeout(marker); + } catch (e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedClearTimeout.call(null, marker); + } catch (e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error. + // Some versions of I.E. have different rules for clearTimeout vs setTimeout + return cachedClearTimeout.call(this, marker); + } + } + + + +} +var queue = []; +var draining = false; +var currentQueue; +var queueIndex = -1; + +function cleanUpNextTick() { + if (!draining || !currentQueue) { + return; + } + draining = false; + if (currentQueue.length) { + queue = currentQueue.concat(queue); + } else { + queueIndex = -1; + } + if (queue.length) { + drainQueue(); + } +} + +function drainQueue() { + if (draining) { + return; + } + var timeout = runTimeout(cleanUpNextTick); + draining = true; + + var len = queue.length; + while(len) { + currentQueue = queue; + queue = []; + while (++queueIndex < len) { + if (currentQueue) { + currentQueue[queueIndex].run(); + } + } + queueIndex = -1; + len = queue.length; + } + currentQueue = null; + draining = false; + runClearTimeout(timeout); +} + +process.nextTick = function (fun) { + var args = new Array(arguments.length - 1); + if (arguments.length > 1) { + for (var i = 1; i < arguments.length; i++) { + args[i - 1] = arguments[i]; + } + } + queue.push(new Item(fun, args)); + if (queue.length === 1 && !draining) { + runTimeout(drainQueue); + } +}; + +// v8 likes predictible objects +function Item(fun, array) { + this.fun = fun; + this.array = array; +} +Item.prototype.run = function () { + this.fun.apply(null, this.array); +}; +process.title = 'browser'; +process.browser = true; +process.env = {}; +process.argv = []; +process.version = ''; // empty string to avoid regexp issues +process.versions = {}; + +function noop() {} + +process.on = noop; +process.addListener = noop; +process.once = noop; +process.off = noop; +process.removeListener = noop; +process.removeAllListeners = noop; +process.emit = noop; +process.prependListener = noop; +process.prependOnceListener = noop; + +process.listeners = function (name) { return [] } + +process.binding = function (name) { + throw new Error('process.binding is not supported'); +}; + +process.cwd = function () { return '/' }; +process.chdir = function (dir) { + throw new Error('process.chdir is not supported'); +}; +process.umask = function() { return 0; }; + +},{}],12:[function(_dereq_,module,exports){ +(function(self) { + 'use strict'; + + if (self.fetch) { + return + } + + var support = { + searchParams: 'URLSearchParams' in self, + iterable: 'Symbol' in self && 'iterator' in Symbol, + blob: 'FileReader' in self && 'Blob' in self && (function() { + try { + new Blob() + return true + } catch(e) { + return false + } + })(), + formData: 'FormData' in self, + arrayBuffer: 'ArrayBuffer' in self + } + + if (support.arrayBuffer) { + var viewClasses = [ + '[object Int8Array]', + '[object Uint8Array]', + '[object Uint8ClampedArray]', + '[object Int16Array]', + '[object Uint16Array]', + '[object Int32Array]', + '[object Uint32Array]', + '[object Float32Array]', + '[object Float64Array]' + ] + + var isDataView = function(obj) { + return obj && DataView.prototype.isPrototypeOf(obj) + } + + var isArrayBufferView = ArrayBuffer.isView || function(obj) { + return obj && viewClasses.indexOf(Object.prototype.toString.call(obj)) > -1 + } + } + + function normalizeName(name) { + if (typeof name !== 'string') { + name = String(name) + } + if (/[^a-z0-9\-#$%&'*+.\^_`|~]/i.test(name)) { + throw new TypeError('Invalid character in header field name') + } + return name.toLowerCase() + } + + function normalizeValue(value) { + if (typeof value !== 'string') { + value = String(value) + } + return value + } + + // Build a destructive iterator for the value list + function iteratorFor(items) { + var iterator = { + next: function() { + var value = items.shift() + return {done: value === undefined, value: value} + } + } + + if (support.iterable) { + iterator[Symbol.iterator] = function() { + return iterator + } + } + + return iterator + } + + function Headers(headers) { + this.map = {} + + if (headers instanceof Headers) { + headers.forEach(function(value, name) { + this.append(name, value) + }, this) + } else if (Array.isArray(headers)) { + headers.forEach(function(header) { + this.append(header[0], header[1]) + }, this) + } else if (headers) { + Object.getOwnPropertyNames(headers).forEach(function(name) { + this.append(name, headers[name]) + }, this) + } + } + + Headers.prototype.append = function(name, value) { + name = normalizeName(name) + value = normalizeValue(value) + var oldValue = this.map[name] + this.map[name] = oldValue ? oldValue+','+value : value + } + + Headers.prototype['delete'] = function(name) { + delete this.map[normalizeName(name)] + } + + Headers.prototype.get = function(name) { + name = normalizeName(name) + return this.has(name) ? this.map[name] : null + } + + Headers.prototype.has = function(name) { + return this.map.hasOwnProperty(normalizeName(name)) + } + + Headers.prototype.set = function(name, value) { + this.map[normalizeName(name)] = normalizeValue(value) + } + + Headers.prototype.forEach = function(callback, thisArg) { + for (var name in this.map) { + if (this.map.hasOwnProperty(name)) { + callback.call(thisArg, this.map[name], name, this) + } + } + } + + Headers.prototype.keys = function() { + var items = [] + this.forEach(function(value, name) { items.push(name) }) + return iteratorFor(items) + } + + Headers.prototype.values = function() { + var items = [] + this.forEach(function(value) { items.push(value) }) + return iteratorFor(items) + } + + Headers.prototype.entries = function() { + var items = [] + this.forEach(function(value, name) { items.push([name, value]) }) + return iteratorFor(items) + } + + if (support.iterable) { + Headers.prototype[Symbol.iterator] = Headers.prototype.entries + } + + function consumed(body) { + if (body.bodyUsed) { + return Promise.reject(new TypeError('Already read')) + } + body.bodyUsed = true + } + + function fileReaderReady(reader) { + return new Promise(function(resolve, reject) { + reader.onload = function() { + resolve(reader.result) + } + reader.onerror = function() { + reject(reader.error) + } + }) + } + + function readBlobAsArrayBuffer(blob) { + var reader = new FileReader() + var promise = fileReaderReady(reader) + reader.readAsArrayBuffer(blob) + return promise + } + + function readBlobAsText(blob) { + var reader = new FileReader() + var promise = fileReaderReady(reader) + reader.readAsText(blob) + return promise + } + + function readArrayBufferAsText(buf) { + var view = new Uint8Array(buf) + var chars = new Array(view.length) + + for (var i = 0; i < view.length; i++) { + chars[i] = String.fromCharCode(view[i]) + } + return chars.join('') + } + + function bufferClone(buf) { + if (buf.slice) { + return buf.slice(0) + } else { + var view = new Uint8Array(buf.byteLength) + view.set(new Uint8Array(buf)) + return view.buffer + } + } + + function Body() { + this.bodyUsed = false + + this._initBody = function(body) { + this._bodyInit = body + if (!body) { + this._bodyText = '' + } else if (typeof body === 'string') { + this._bodyText = body + } else if (support.blob && Blob.prototype.isPrototypeOf(body)) { + this._bodyBlob = body + } else if (support.formData && FormData.prototype.isPrototypeOf(body)) { + this._bodyFormData = body + } else if (support.searchParams && URLSearchParams.prototype.isPrototypeOf(body)) { + this._bodyText = body.toString() + } else if (support.arrayBuffer && support.blob && isDataView(body)) { + this._bodyArrayBuffer = bufferClone(body.buffer) + // IE 10-11 can't handle a DataView body. + this._bodyInit = new Blob([this._bodyArrayBuffer]) + } else if (support.arrayBuffer && (ArrayBuffer.prototype.isPrototypeOf(body) || isArrayBufferView(body))) { + this._bodyArrayBuffer = bufferClone(body) + } else { + throw new Error('unsupported BodyInit type') + } + + if (!this.headers.get('content-type')) { + if (typeof body === 'string') { + this.headers.set('content-type', 'text/plain;charset=UTF-8') + } else if (this._bodyBlob && this._bodyBlob.type) { + this.headers.set('content-type', this._bodyBlob.type) + } else if (support.searchParams && URLSearchParams.prototype.isPrototypeOf(body)) { + this.headers.set('content-type', 'application/x-www-form-urlencoded;charset=UTF-8') + } + } + } + + if (support.blob) { + this.blob = function() { + var rejected = consumed(this) + if (rejected) { + return rejected + } + + if (this._bodyBlob) { + return Promise.resolve(this._bodyBlob) + } else if (this._bodyArrayBuffer) { + return Promise.resolve(new Blob([this._bodyArrayBuffer])) + } else if (this._bodyFormData) { + throw new Error('could not read FormData body as blob') + } else { + return Promise.resolve(new Blob([this._bodyText])) + } + } + + this.arrayBuffer = function() { + if (this._bodyArrayBuffer) { + return consumed(this) || Promise.resolve(this._bodyArrayBuffer) + } else { + return this.blob().then(readBlobAsArrayBuffer) + } + } + } + + this.text = function() { + var rejected = consumed(this) + if (rejected) { + return rejected + } + + if (this._bodyBlob) { + return readBlobAsText(this._bodyBlob) + } else if (this._bodyArrayBuffer) { + return Promise.resolve(readArrayBufferAsText(this._bodyArrayBuffer)) + } else if (this._bodyFormData) { + throw new Error('could not read FormData body as text') + } else { + return Promise.resolve(this._bodyText) + } + } + + if (support.formData) { + this.formData = function() { + return this.text().then(decode) + } + } + + this.json = function() { + return this.text().then(JSON.parse) + } + + return this + } + + // HTTP methods whose capitalization should be normalized + var methods = ['DELETE', 'GET', 'HEAD', 'OPTIONS', 'POST', 'PUT'] + + function normalizeMethod(method) { + var upcased = method.toUpperCase() + return (methods.indexOf(upcased) > -1) ? upcased : method + } + + function Request(input, options) { + options = options || {} + var body = options.body + + if (input instanceof Request) { + if (input.bodyUsed) { + throw new TypeError('Already read') + } + this.url = input.url + this.credentials = input.credentials + if (!options.headers) { + this.headers = new Headers(input.headers) + } + this.method = input.method + this.mode = input.mode + if (!body && input._bodyInit != null) { + body = input._bodyInit + input.bodyUsed = true + } + } else { + this.url = String(input) + } + + this.credentials = options.credentials || this.credentials || 'omit' + if (options.headers || !this.headers) { + this.headers = new Headers(options.headers) + } + this.method = normalizeMethod(options.method || this.method || 'GET') + this.mode = options.mode || this.mode || null + this.referrer = null + + if ((this.method === 'GET' || this.method === 'HEAD') && body) { + throw new TypeError('Body not allowed for GET or HEAD requests') + } + this._initBody(body) + } + + Request.prototype.clone = function() { + return new Request(this, { body: this._bodyInit }) + } + + function decode(body) { + var form = new FormData() + body.trim().split('&').forEach(function(bytes) { + if (bytes) { + var split = bytes.split('=') + var name = split.shift().replace(/\+/g, ' ') + var value = split.join('=').replace(/\+/g, ' ') + form.append(decodeURIComponent(name), decodeURIComponent(value)) + } + }) + return form + } + + function parseHeaders(rawHeaders) { + var headers = new Headers() + // Replace instances of \r\n and \n followed by at least one space or horizontal tab with a space + // https://tools.ietf.org/html/rfc7230#section-3.2 + var preProcessedHeaders = rawHeaders.replace(/\r?\n[\t ]+/g, ' ') + preProcessedHeaders.split(/\r?\n/).forEach(function(line) { + var parts = line.split(':') + var key = parts.shift().trim() + if (key) { + var value = parts.join(':').trim() + headers.append(key, value) + } + }) + return headers + } + + Body.call(Request.prototype) + + function Response(bodyInit, options) { + if (!options) { + options = {} + } + + this.type = 'default' + this.status = options.status === undefined ? 200 : options.status + this.ok = this.status >= 200 && this.status < 300 + this.statusText = 'statusText' in options ? options.statusText : 'OK' + this.headers = new Headers(options.headers) + this.url = options.url || '' + this._initBody(bodyInit) + } + + Body.call(Response.prototype) + + Response.prototype.clone = function() { + return new Response(this._bodyInit, { + status: this.status, + statusText: this.statusText, + headers: new Headers(this.headers), + url: this.url + }) + } + + Response.error = function() { + var response = new Response(null, {status: 0, statusText: ''}) + response.type = 'error' + return response + } + + var redirectStatuses = [301, 302, 303, 307, 308] + + Response.redirect = function(url, status) { + if (redirectStatuses.indexOf(status) === -1) { + throw new RangeError('Invalid status code') + } + + return new Response(null, {status: status, headers: {location: url}}) + } + + self.Headers = Headers + self.Request = Request + self.Response = Response + + self.fetch = function(input, init) { + return new Promise(function(resolve, reject) { + var request = new Request(input, init) + var xhr = new XMLHttpRequest() + + xhr.onload = function() { + var options = { + status: xhr.status, + statusText: xhr.statusText, + headers: parseHeaders(xhr.getAllResponseHeaders() || '') + } + options.url = 'responseURL' in xhr ? xhr.responseURL : options.headers.get('X-Request-URL') + var body = 'response' in xhr ? xhr.response : xhr.responseText + resolve(new Response(body, options)) + } + + xhr.onerror = function() { + reject(new TypeError('Network request failed')) + } + + xhr.ontimeout = function() { + reject(new TypeError('Network request failed')) + } + + xhr.open(request.method, request.url, true) + + if (request.credentials === 'include') { + xhr.withCredentials = true + } else if (request.credentials === 'omit') { + xhr.withCredentials = false + } + + if ('responseType' in xhr && support.blob) { + xhr.responseType = 'blob' + } + + request.headers.forEach(function(value, name) { + xhr.setRequestHeader(name, value) + }) + + xhr.send(typeof request._bodyInit === 'undefined' ? null : request._bodyInit) + }) + } + self.fetch.polyfill = true +})(typeof self !== 'undefined' ? self : this); + +},{}],13:[function(_dereq_,module,exports){ +'use strict'; + +// core +var p5 = _dereq_('./core/main'); +_dereq_('./core/constants'); +_dereq_('./core/environment'); +_dereq_('./core/error_helpers'); +_dereq_('./core/helpers'); +_dereq_('./core/legacy'); +_dereq_('./core/p5.Element'); +_dereq_('./core/p5.Graphics'); +_dereq_('./core/p5.Renderer'); +_dereq_('./core/p5.Renderer2D'); +_dereq_('./core/rendering'); +_dereq_('./core/shim'); +_dereq_('./core/structure'); +_dereq_('./core/transform'); +_dereq_('./core/shape/2d_primitives'); +_dereq_('./core/shape/attributes'); +_dereq_('./core/shape/curves'); +_dereq_('./core/shape/vertex'); + +// color +_dereq_('./color/color_conversion'); +_dereq_('./color/creating_reading'); +_dereq_('./color/p5.Color'); +_dereq_('./color/setting'); + +// data +_dereq_('./data/p5.TypedDict'); + +// events +_dereq_('./events/acceleration'); +_dereq_('./events/keyboard'); +_dereq_('./events/mouse'); +_dereq_('./events/touch'); + +// image +_dereq_('./image/filters'); +_dereq_('./image/image'); +_dereq_('./image/loading_displaying'); +_dereq_('./image/p5.Image'); +_dereq_('./image/pixels'); + +// io +_dereq_('./io/files'); +_dereq_('./io/p5.Table'); +_dereq_('./io/p5.TableRow'); +_dereq_('./io/p5.XML'); + +// math +_dereq_('./math/calculation'); +_dereq_('./math/math'); +_dereq_('./math/noise'); +_dereq_('./math/p5.Vector'); +_dereq_('./math/random'); +_dereq_('./math/trigonometry'); + +// typography +_dereq_('./typography/attributes'); +_dereq_('./typography/loading_displaying'); +_dereq_('./typography/p5.Font'); + +// utilities +_dereq_('./utilities/array_functions'); +_dereq_('./utilities/conversion'); +_dereq_('./utilities/string_functions'); +_dereq_('./utilities/time_date'); + +// webgl +_dereq_('./webgl/3d_primitives'); +_dereq_('./webgl/interaction'); +_dereq_('./webgl/light'); +_dereq_('./webgl/loading'); +_dereq_('./webgl/material'); +_dereq_('./webgl/p5.Camera'); +_dereq_('./webgl/p5.Geometry'); +_dereq_('./webgl/p5.Matrix'); +_dereq_('./webgl/p5.RendererGL.Immediate'); +_dereq_('./webgl/p5.RendererGL'); +_dereq_('./webgl/p5.RendererGL.Retained'); +_dereq_('./webgl/p5.Shader'); +_dereq_('./webgl/p5.Texture'); +_dereq_('./webgl/text'); + +_dereq_('./core/init'); + +module.exports = p5; + +},{"./color/color_conversion":14,"./color/creating_reading":15,"./color/p5.Color":16,"./color/setting":17,"./core/constants":18,"./core/environment":19,"./core/error_helpers":20,"./core/helpers":21,"./core/init":22,"./core/legacy":23,"./core/main":24,"./core/p5.Element":25,"./core/p5.Graphics":26,"./core/p5.Renderer":27,"./core/p5.Renderer2D":28,"./core/rendering":29,"./core/shape/2d_primitives":30,"./core/shape/attributes":31,"./core/shape/curves":32,"./core/shape/vertex":33,"./core/shim":34,"./core/structure":35,"./core/transform":36,"./data/p5.TypedDict":37,"./events/acceleration":38,"./events/keyboard":39,"./events/mouse":40,"./events/touch":41,"./image/filters":42,"./image/image":43,"./image/loading_displaying":44,"./image/p5.Image":45,"./image/pixels":46,"./io/files":47,"./io/p5.Table":48,"./io/p5.TableRow":49,"./io/p5.XML":50,"./math/calculation":51,"./math/math":52,"./math/noise":53,"./math/p5.Vector":54,"./math/random":55,"./math/trigonometry":56,"./typography/attributes":57,"./typography/loading_displaying":58,"./typography/p5.Font":59,"./utilities/array_functions":60,"./utilities/conversion":61,"./utilities/string_functions":62,"./utilities/time_date":63,"./webgl/3d_primitives":64,"./webgl/interaction":65,"./webgl/light":66,"./webgl/loading":67,"./webgl/material":68,"./webgl/p5.Camera":69,"./webgl/p5.Geometry":70,"./webgl/p5.Matrix":71,"./webgl/p5.RendererGL":74,"./webgl/p5.RendererGL.Immediate":72,"./webgl/p5.RendererGL.Retained":73,"./webgl/p5.Shader":75,"./webgl/p5.Texture":76,"./webgl/text":77}],14:[function(_dereq_,module,exports){ +/** + * @module Color + * @submodule Color Conversion + * @for p5 + * @requires core + */ + +'use strict'; + +/** + * Conversions adapted from . + * + * In these functions, hue is always in the range [0, 1], just like all other + * components are in the range [0, 1]. 'Brightness' and 'value' are used + * interchangeably. + */ + +var p5 = _dereq_('../core/main'); +p5.ColorConversion = {}; + +/** + * Convert an HSBA array to HSLA. + */ +p5.ColorConversion._hsbaToHSLA = function(hsba) { + var hue = hsba[0]; + var sat = hsba[1]; + var val = hsba[2]; + + // Calculate lightness. + var li = (2 - sat) * val / 2; + + // Convert saturation. + if (li !== 0) { + if (li === 1) { + sat = 0; + } else if (li < 0.5) { + sat = sat / (2 - sat); + } else { + sat = sat * val / (2 - li * 2); + } + } + + // Hue and alpha stay the same. + return [hue, sat, li, hsba[3]]; +}; + +/** + * Convert an HSBA array to RGBA. + */ +p5.ColorConversion._hsbaToRGBA = function(hsba) { + var hue = hsba[0] * 6; // We will split hue into 6 sectors. + var sat = hsba[1]; + var val = hsba[2]; + + var RGBA = []; + + if (sat === 0) { + RGBA = [val, val, val, hsba[3]]; // Return early if grayscale. + } else { + var sector = Math.floor(hue); + var tint1 = val * (1 - sat); + var tint2 = val * (1 - sat * (hue - sector)); + var tint3 = val * (1 - sat * (1 + sector - hue)); + var red, green, blue; + if (sector === 1) { + // Yellow to green. + red = tint2; + green = val; + blue = tint1; + } else if (sector === 2) { + // Green to cyan. + red = tint1; + green = val; + blue = tint3; + } else if (sector === 3) { + // Cyan to blue. + red = tint1; + green = tint2; + blue = val; + } else if (sector === 4) { + // Blue to magenta. + red = tint3; + green = tint1; + blue = val; + } else if (sector === 5) { + // Magenta to red. + red = val; + green = tint1; + blue = tint2; + } else { + // Red to yellow (sector could be 0 or 6). + red = val; + green = tint3; + blue = tint1; + } + RGBA = [red, green, blue, hsba[3]]; + } + + return RGBA; +}; + +/** + * Convert an HSLA array to HSBA. + */ +p5.ColorConversion._hslaToHSBA = function(hsla) { + var hue = hsla[0]; + var sat = hsla[1]; + var li = hsla[2]; + + // Calculate brightness. + var val; + if (li < 0.5) { + val = (1 + sat) * li; + } else { + val = li + sat - li * sat; + } + + // Convert saturation. + sat = 2 * (val - li) / val; + + // Hue and alpha stay the same. + return [hue, sat, val, hsla[3]]; +}; + +/** + * Convert an HSLA array to RGBA. + * + * We need to change basis from HSLA to something that can be more easily be + * projected onto RGBA. We will choose hue and brightness as our first two + * components, and pick a convenient third one ('zest') so that we don't need + * to calculate formal HSBA saturation. + */ +p5.ColorConversion._hslaToRGBA = function(hsla) { + var hue = hsla[0] * 6; // We will split hue into 6 sectors. + var sat = hsla[1]; + var li = hsla[2]; + + var RGBA = []; + + if (sat === 0) { + RGBA = [li, li, li, hsla[3]]; // Return early if grayscale. + } else { + // Calculate brightness. + var val; + if (li < 0.5) { + val = (1 + sat) * li; + } else { + val = li + sat - li * sat; + } + + // Define zest. + var zest = 2 * li - val; + + // Implement projection (project onto green by default). + var hzvToRGB = function(hue, zest, val) { + if (hue < 0) { + // Hue must wrap to allow projection onto red and blue. + hue += 6; + } else if (hue >= 6) { + hue -= 6; + } + if (hue < 1) { + // Red to yellow (increasing green). + return zest + (val - zest) * hue; + } else if (hue < 3) { + // Yellow to cyan (greatest green). + return val; + } else if (hue < 4) { + // Cyan to blue (decreasing green). + return zest + (val - zest) * (4 - hue); + } else { + // Blue to red (least green). + return zest; + } + }; + + // Perform projections, offsetting hue as necessary. + RGBA = [ + hzvToRGB(hue + 2, zest, val), + hzvToRGB(hue, zest, val), + hzvToRGB(hue - 2, zest, val), + hsla[3] + ]; + } + + return RGBA; +}; + +/** + * Convert an RGBA array to HSBA. + */ +p5.ColorConversion._rgbaToHSBA = function(rgba) { + var red = rgba[0]; + var green = rgba[1]; + var blue = rgba[2]; + + var val = Math.max(red, green, blue); + var chroma = val - Math.min(red, green, blue); + + var hue, sat; + if (chroma === 0) { + // Return early if grayscale. + hue = 0; + sat = 0; + } else { + sat = chroma / val; + if (red === val) { + // Magenta to yellow. + hue = (green - blue) / chroma; + } else if (green === val) { + // Yellow to cyan. + hue = 2 + (blue - red) / chroma; + } else if (blue === val) { + // Cyan to magenta. + hue = 4 + (red - green) / chroma; + } + if (hue < 0) { + // Confine hue to the interval [0, 1). + hue += 6; + } else if (hue >= 6) { + hue -= 6; + } + } + + return [hue / 6, sat, val, rgba[3]]; +}; + +/** + * Convert an RGBA array to HSLA. + */ +p5.ColorConversion._rgbaToHSLA = function(rgba) { + var red = rgba[0]; + var green = rgba[1]; + var blue = rgba[2]; + + var val = Math.max(red, green, blue); + var min = Math.min(red, green, blue); + var li = val + min; // We will halve this later. + var chroma = val - min; + + var hue, sat; + if (chroma === 0) { + // Return early if grayscale. + hue = 0; + sat = 0; + } else { + if (li < 1) { + sat = chroma / li; + } else { + sat = chroma / (2 - li); + } + if (red === val) { + // Magenta to yellow. + hue = (green - blue) / chroma; + } else if (green === val) { + // Yellow to cyan. + hue = 2 + (blue - red) / chroma; + } else if (blue === val) { + // Cyan to magenta. + hue = 4 + (red - green) / chroma; + } + if (hue < 0) { + // Confine hue to the interval [0, 1). + hue += 6; + } else if (hue >= 6) { + hue -= 6; + } + } + + return [hue / 6, sat, li / 2, rgba[3]]; +}; + +module.exports = p5.ColorConversion; + +},{"../core/main":24}],15:[function(_dereq_,module,exports){ +/** + * @module Color + * @submodule Creating & Reading + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); +_dereq_('./p5.Color'); +_dereq_('../core/error_helpers'); + +/** + * Extracts the alpha value from a color or pixel array. + * + * @method alpha + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the alpha value + * @example + *
    + * + * noStroke(); + * let c = color(0, 126, 255, 102); + * fill(c); + * rect(15, 15, 35, 70); + * let value = alpha(c); // Sets 'value' to 102 + * fill(value); + * rect(50, 15, 35, 70); + * + *
    + * + * @alt + * Left half of canvas light blue and right half light charcoal grey. + * Left half of canvas light purple and right half a royal blue. + * Left half of canvas salmon pink and the right half white. + * Yellow rect in middle right of canvas, with 55 pixel width and height. + * Yellow ellipse in top left canvas, black ellipse in bottom right,both 80x80. + * Bright fuchsia rect in middle of canvas, 60 pixel width and height. + * Two bright green rects on opposite sides of the canvas, both 45x80. + * Four blue rects in each corner of the canvas, each are 35x35. + * Bright sea green rect on left and darker rect on right of canvas, both 45x80. + * Dark green rect on left and light green rect on right of canvas, both 45x80. + * Dark blue rect on left and light teal rect on right of canvas, both 45x80. + * blue rect on left and green on right, both with black outlines & 35x60. + * salmon pink rect on left and black on right, both 35x60. + * 4 rects, tan, brown, brownish purple and purple, with white outlines & 20x60. + * light pastel green rect on left and dark grey rect on right, both 35x60. + * yellow rect on left and red rect on right, both with black outlines & 35x60. + * grey canvas + * deep pink rect on left and grey rect on right, both 35x60. + */ +p5.prototype.alpha = function(c) { + p5._validateParameters('alpha', arguments); + return this.color(c)._getAlpha(); +}; + +/** + * Extracts the blue value from a color or pixel array. + * + * @method blue + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the blue value + * @example + *
    + * + * let c = color(175, 100, 220); // Define color 'c' + * fill(c); // Use color variable 'c' as fill color + * rect(15, 20, 35, 60); // Draw left rectangle + * + * let blueValue = blue(c); // Get blue in 'c' + * print(blueValue); // Prints "220.0" + * fill(0, 0, blueValue); // Use 'blueValue' in new fill + * rect(50, 20, 35, 60); // Draw right rectangle + * + *
    + * + * @alt + * Left half of canvas light purple and right half a royal blue. + * + */ +p5.prototype.blue = function(c) { + p5._validateParameters('blue', arguments); + return this.color(c)._getBlue(); +}; + +/** + * Extracts the HSB brightness value from a color or pixel array. + * + * @method brightness + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the brightness value + * @example + *
    + * + * noStroke(); + * colorMode(HSB, 255); + * let c = color(0, 126, 255); + * fill(c); + * rect(15, 20, 35, 60); + * let value = brightness(c); // Sets 'value' to 255 + * fill(value); + * rect(50, 20, 35, 60); + * + *
    + *
    + * + * noStroke(); + * colorMode(HSB, 255); + * let c = color('hsb(60, 100%, 50%)'); + * fill(c); + * rect(15, 20, 35, 60); + * let value = brightness(c); // A 'value' of 50% is 127.5 + * fill(value); + * rect(50, 20, 35, 60); + * + *
    + * + * @alt + * Left half of canvas salmon pink and the right half white. + * Left half of canvas yellow at half brightness and the right gray . + * + */ +p5.prototype.brightness = function(c) { + p5._validateParameters('brightness', arguments); + return this.color(c)._getBrightness(); +}; + +/** + * Creates colors for storing in variables of the color datatype. The + * parameters are interpreted as RGB or HSB values depending on the + * current colorMode(). The default mode is RGB values from 0 to 255 + * and, therefore, the function call color(255, 204, 0) will return a + * bright yellow color. + *

    + * Note that if only one value is provided to color(), it will be interpreted + * as a grayscale value. Add a second value, and it will be used for alpha + * transparency. When three values are specified, they are interpreted as + * either RGB or HSB values. Adding a fourth value applies alpha + * transparency. + *

    + * If a single string argument is provided, RGB, RGBA and Hex CSS color + * strings and all named color strings are supported. In this case, an alpha + * number value as a second argument is not supported, the RGBA form should be + * used. + * + * @method color + * @param {Number} gray number specifying value between white + * and black. + * @param {Number} [alpha] alpha value relative to current color range + * (default is 0-255) + * @return {p5.Color} resulting color + * + * @example + *
    + * + * let c = color(255, 204, 0); // Define color 'c' + * fill(c); // Use color variable 'c' as fill color + * noStroke(); // Don't draw a stroke around shapes + * rect(30, 20, 55, 55); // Draw rectangle + * + *
    + * + *
    + * + * let c = color(255, 204, 0); // Define color 'c' + * fill(c); // Use color variable 'c' as fill color + * noStroke(); // Don't draw a stroke around shapes + * ellipse(25, 25, 80, 80); // Draw left circle + * + * // Using only one value with color() + * // generates a grayscale value. + * c = color(65); // Update 'c' with grayscale value + * fill(c); // Use updated 'c' as fill color + * ellipse(75, 75, 80, 80); // Draw right circle + * + *
    + * + *
    + * + * // Named SVG & CSS colors may be used, + * let c = color('magenta'); + * fill(c); // Use 'c' as fill color + * noStroke(); // Don't draw a stroke around shapes + * rect(20, 20, 60, 60); // Draw rectangle + * + *
    + * + *
    + * + * // as can hex color codes: + * noStroke(); // Don't draw a stroke around shapes + * let c = color('#0f0'); + * fill(c); // Use 'c' as fill color + * rect(0, 10, 45, 80); // Draw rectangle + * + * c = color('#00ff00'); + * fill(c); // Use updated 'c' as fill color + * rect(55, 10, 45, 80); // Draw rectangle + * + *
    + * + *
    + * + * // RGB and RGBA color strings are also supported: + * // these all set to the same color (solid blue) + * let c; + * noStroke(); // Don't draw a stroke around shapes + * c = color('rgb(0,0,255)'); + * fill(c); // Use 'c' as fill color + * rect(10, 10, 35, 35); // Draw rectangle + * + * c = color('rgb(0%, 0%, 100%)'); + * fill(c); // Use updated 'c' as fill color + * rect(55, 10, 35, 35); // Draw rectangle + * + * c = color('rgba(0, 0, 255, 1)'); + * fill(c); // Use updated 'c' as fill color + * rect(10, 55, 35, 35); // Draw rectangle + * + * c = color('rgba(0%, 0%, 100%, 1)'); + * fill(c); // Use updated 'c' as fill color + * rect(55, 55, 35, 35); // Draw rectangle + * + *
    + * + *
    + * + * // HSL color is also supported and can be specified + * // by value + * let c; + * noStroke(); // Don't draw a stroke around shapes + * c = color('hsl(160, 100%, 50%)'); + * fill(c); // Use 'c' as fill color + * rect(0, 10, 45, 80); // Draw rectangle + * + * c = color('hsla(160, 100%, 50%, 0.5)'); + * fill(c); // Use updated 'c' as fill color + * rect(55, 10, 45, 80); // Draw rectangle + * + *
    + * + *
    + * + * // HSB color is also supported and can be specified + * // by value + * let c; + * noStroke(); // Don't draw a stroke around shapes + * c = color('hsb(160, 100%, 50%)'); + * fill(c); // Use 'c' as fill color + * rect(0, 10, 45, 80); // Draw rectangle + * + * c = color('hsba(160, 100%, 50%, 0.5)'); + * fill(c); // Use updated 'c' as fill color + * rect(55, 10, 45, 80); // Draw rectangle + * + *
    + * + *
    + * + * let c; // Declare color 'c' + * noStroke(); // Don't draw a stroke around shapes + * + * // If no colorMode is specified, then the + * // default of RGB with scale of 0-255 is used. + * c = color(50, 55, 100); // Create a color for 'c' + * fill(c); // Use color variable 'c' as fill color + * rect(0, 10, 45, 80); // Draw left rect + * + * colorMode(HSB, 100); // Use HSB with scale of 0-100 + * c = color(50, 55, 100); // Update 'c' with new color + * fill(c); // Use updated 'c' as fill color + * rect(55, 10, 45, 80); // Draw right rect + * + *
    + * + * @alt + * Yellow rect in middle right of canvas, with 55 pixel width and height. + * Yellow ellipse in top left of canvas, black ellipse in bottom right,both 80x80. + * Bright fuchsia rect in middle of canvas, 60 pixel width and height. + * Two bright green rects on opposite sides of the canvas, both 45x80. + * Four blue rects in each corner of the canvas, each are 35x35. + * Bright sea green rect on left and darker rect on right of canvas, both 45x80. + * Dark green rect on left and lighter green rect on right of canvas, both 45x80. + * Dark blue rect on left and light teal rect on right of canvas, both 45x80. + * + */ +/** + * @method color + * @param {Number} v1 red or hue value relative to + * the current color range + * @param {Number} v2 green or saturation value + * relative to the current color range + * @param {Number} v3 blue or brightness value + * relative to the current color range + * @param {Number} [alpha] + * @return {p5.Color} + */ + +/** + * @method color + * @param {String} value a color string + * @return {p5.Color} + */ +/** + * @method color + * @param {Number[]} values an array containing the red,green,blue & + * and alpha components of the color + * @return {p5.Color} + */ +/** + * @method color + * @param {p5.Color} color + * @return {p5.Color} + */ + +p5.prototype.color = function() { + p5._validateParameters('color', arguments); + if (arguments[0] instanceof p5.Color) { + return arguments[0]; // Do nothing if argument is already a color object. + } + + var args = arguments[0] instanceof Array ? arguments[0] : arguments; + return new p5.Color(this, args); +}; + +/** + * Extracts the green value from a color or pixel array. + * + * @method green + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the green value + * @example + *
    + * + * let c = color(20, 75, 200); // Define color 'c' + * fill(c); // Use color variable 'c' as fill color + * rect(15, 20, 35, 60); // Draw left rectangle + * + * let greenValue = green(c); // Get green in 'c' + * print(greenValue); // Print "75.0" + * fill(0, greenValue, 0); // Use 'greenValue' in new fill + * rect(50, 20, 35, 60); // Draw right rectangle + * + *
    + * + * @alt + * blue rect on left and green on right, both with black outlines & 35x60. + * + */ + +p5.prototype.green = function(c) { + p5._validateParameters('green', arguments); + return this.color(c)._getGreen(); +}; + +/** + * Extracts the hue value from a color or pixel array. + * + * Hue exists in both HSB and HSL. This function will return the + * HSB-normalized hue when supplied with an HSB color object (or when supplied + * with a pixel array while the color mode is HSB), but will default to the + * HSL-normalized hue otherwise. (The values will only be different if the + * maximum hue setting for each system is different.) + * + * @method hue + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the hue + * @example + *
    + * + * noStroke(); + * colorMode(HSB, 255); + * let c = color(0, 126, 255); + * fill(c); + * rect(15, 20, 35, 60); + * let value = hue(c); // Sets 'value' to "0" + * fill(value); + * rect(50, 20, 35, 60); + * + *
    + * + * @alt + * salmon pink rect on left and black on right, both 35x60. + * + */ + +p5.prototype.hue = function(c) { + p5._validateParameters('hue', arguments); + return this.color(c)._getHue(); +}; + +/** + * Blends two colors to find a third color somewhere between them. The amt + * parameter is the amount to interpolate between the two values where 0.0 + * equal to the first color, 0.1 is very near the first color, 0.5 is halfway + * in between, etc. An amount below 0 will be treated as 0. Likewise, amounts + * above 1 will be capped at 1. This is different from the behavior of lerp(), + * but necessary because otherwise numbers outside the range will produce + * strange and unexpected colors. + *

    + * The way that colours are interpolated depends on the current color mode. + * + * @method lerpColor + * @param {p5.Color} c1 interpolate from this color + * @param {p5.Color} c2 interpolate to this color + * @param {Number} amt number between 0 and 1 + * @return {p5.Color} interpolated color + * @example + *
    + * + * colorMode(RGB); + * stroke(255); + * background(51); + * let from = color(218, 165, 32); + * let to = color(72, 61, 139); + * colorMode(RGB); // Try changing to HSB. + * let interA = lerpColor(from, to, 0.33); + * let interB = lerpColor(from, to, 0.66); + * fill(from); + * rect(10, 20, 20, 60); + * fill(interA); + * rect(30, 20, 20, 60); + * fill(interB); + * rect(50, 20, 20, 60); + * fill(to); + * rect(70, 20, 20, 60); + * + *
    + * + * @alt + * 4 rects one tan, brown, brownish purple, purple, with white outlines & 20x60 + * + */ + +p5.prototype.lerpColor = function(c1, c2, amt) { + p5._validateParameters('lerpColor', arguments); + var mode = this._colorMode; + var maxes = this._colorMaxes; + var l0, l1, l2, l3; + var fromArray, toArray; + + if (mode === constants.RGB) { + fromArray = c1.levels.map(function(level) { + return level / 255; + }); + toArray = c2.levels.map(function(level) { + return level / 255; + }); + } else if (mode === constants.HSB) { + c1._getBrightness(); // Cache hsba so it definitely exists. + c2._getBrightness(); + fromArray = c1.hsba; + toArray = c2.hsba; + } else if (mode === constants.HSL) { + c1._getLightness(); // Cache hsla so it definitely exists. + c2._getLightness(); + fromArray = c1.hsla; + toArray = c2.hsla; + } else { + throw new Error(mode + 'cannot be used for interpolation.'); + } + + // Prevent extrapolation. + amt = Math.max(Math.min(amt, 1), 0); + + // Define lerp here itself if user isn't using math module. + // Maintains the definition as found in math/calculation.js + if (typeof this.lerp === 'undefined') { + this.lerp = function(start, stop, amt) { + return amt * (stop - start) + start; + }; + } + + // Perform interpolation. + l0 = this.lerp(fromArray[0], toArray[0], amt); + l1 = this.lerp(fromArray[1], toArray[1], amt); + l2 = this.lerp(fromArray[2], toArray[2], amt); + l3 = this.lerp(fromArray[3], toArray[3], amt); + + // Scale components. + l0 *= maxes[mode][0]; + l1 *= maxes[mode][1]; + l2 *= maxes[mode][2]; + l3 *= maxes[mode][3]; + + return this.color(l0, l1, l2, l3); +}; + +/** + * Extracts the HSL lightness value from a color or pixel array. + * + * @method lightness + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the lightness + * @example + *
    + * + * noStroke(); + * colorMode(HSL); + * let c = color(156, 100, 50, 1); + * fill(c); + * rect(15, 20, 35, 60); + * let value = lightness(c); // Sets 'value' to 50 + * fill(value); + * rect(50, 20, 35, 60); + * + *
    + * + * @alt + * light pastel green rect on left and dark grey rect on right, both 35x60. + * + */ +p5.prototype.lightness = function(c) { + p5._validateParameters('lightness', arguments); + return this.color(c)._getLightness(); +}; + +/** + * Extracts the red value from a color or pixel array. + * + * @method red + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the red value + * @example + *
    + * + * let c = color(255, 204, 0); // Define color 'c' + * fill(c); // Use color variable 'c' as fill color + * rect(15, 20, 35, 60); // Draw left rectangle + * + * let redValue = red(c); // Get red in 'c' + * print(redValue); // Print "255.0" + * fill(redValue, 0, 0); // Use 'redValue' in new fill + * rect(50, 20, 35, 60); // Draw right rectangle + * + *
    + * + *
    + * + * colorMode(RGB, 255); // Sets the range for red, green, and blue to 255 + * let c = color(127, 255, 0); + * colorMode(RGB, 1); // Sets the range for red, green, and blue to 1 + * let myColor = red(c); + * print(myColor); // 0.4980392156862745 + * + *
    + * + * @alt + * yellow rect on left and red rect on right, both with black outlines and 35x60. + * grey canvas + */ +p5.prototype.red = function(c) { + p5._validateParameters('red', arguments); + return this.color(c)._getRed(); +}; + +/** + * Extracts the saturation value from a color or pixel array. + * + * Saturation is scaled differently in HSB and HSL. This function will return + * the HSB saturation when supplied with an HSB color object (or when supplied + * with a pixel array while the color mode is HSB), but will default to the + * HSL saturation otherwise. + * + * @method saturation + * @param {p5.Color|Number[]|String} color p5.Color object, color components, + * or CSS color + * @return {Number} the saturation value + * @example + *
    + * + * noStroke(); + * colorMode(HSB, 255); + * let c = color(0, 126, 255); + * fill(c); + * rect(15, 20, 35, 60); + * let value = saturation(c); // Sets 'value' to 126 + * fill(value); + * rect(50, 20, 35, 60); + * + *
    + * + * @alt + *deep pink rect on left and grey rect on right, both 35x60. + * + */ + +p5.prototype.saturation = function(c) { + p5._validateParameters('saturation', arguments); + return this.color(c)._getSaturation(); +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/error_helpers":20,"../core/main":24,"./p5.Color":16}],16:[function(_dereq_,module,exports){ +/** + * @module Color + * @submodule Creating & Reading + * @for p5 + * @requires core + * @requires constants + * @requires color_conversion + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); +var color_conversion = _dereq_('./color_conversion'); + +/** + * Each color stores the color mode and level maxes that applied at the + * time of its construction. These are used to interpret the input arguments + * (at construction and later for that instance of color) and to format the + * output e.g. when saturation() is requested. + * + * Internally we store an array representing the ideal RGBA values in floating + * point form, normalized from 0 to 1. From this we calculate the closest + * screen color (RGBA levels from 0 to 255) and expose this to the renderer. + * + * We also cache normalized, floating point components of the color in various + * representations as they are calculated. This is done to prevent repeating a + * conversion that has already been performed. + * + * @class p5.Color + */ +p5.Color = function(pInst, vals) { + // Record color mode and maxes at time of construction. + this._storeModeAndMaxes(pInst._colorMode, pInst._colorMaxes); + + // Calculate normalized RGBA values. + if ( + this.mode !== constants.RGB && + this.mode !== constants.HSL && + this.mode !== constants.HSB + ) { + throw new Error(this.mode + ' is an invalid colorMode.'); + } else { + this._array = p5.Color._parseInputs.apply(this, vals); + } + + // Expose closest screen color. + this._calculateLevels(); + return this; +}; + +/** + * This function returns the color formatted as a string. This can be useful + * for debugging, or for using p5.js with other libraries. + * @method toString + * @param {String} [format] How the color string will be formatted. + * Leaving this empty formats the string as rgba(r, g, b, a). + * '#rgb' '#rgba' '#rrggbb' and '#rrggbbaa' format as hexadecimal color codes. + * 'rgb' 'hsb' and 'hsl' return the color formatted in the specified color mode. + * 'rgba' 'hsba' and 'hsla' are the same as above but with alpha channels. + * 'rgb%' 'hsb%' 'hsl%' 'rgba%' 'hsba%' and 'hsla%' format as percentages. + * @return {String} the formatted string + * @example + *
    + * + * let myColor; + * function setup() { + * createCanvas(200, 200); + * stroke(255); + * myColor = color(100, 100, 250); + * fill(myColor); + * } + * + * function draw() { + * rotate(HALF_PI); + * text(myColor.toString(), 0, -5); + * text(myColor.toString('#rrggbb'), 0, -30); + * text(myColor.toString('rgba%'), 0, -55); + * } + * + *
    + * + * @alt + * canvas with text representation of color + */ +p5.Color.prototype.toString = function(format) { + var a = this.levels; + var f = this._array; + var alpha = f[3]; // String representation uses normalized alpha + + switch (format) { + case '#rrggbb': + return '#'.concat( + a[0] < 16 ? '0'.concat(a[0].toString(16)) : a[0].toString(16), + a[1] < 16 ? '0'.concat(a[1].toString(16)) : a[1].toString(16), + a[2] < 16 ? '0'.concat(a[2].toString(16)) : a[2].toString(16) + ); + + case '#rrggbbaa': + return '#'.concat( + a[0] < 16 ? '0'.concat(a[0].toString(16)) : a[0].toString(16), + a[1] < 16 ? '0'.concat(a[1].toString(16)) : a[1].toString(16), + a[2] < 16 ? '0'.concat(a[2].toString(16)) : a[2].toString(16), + a[3] < 16 ? '0'.concat(a[2].toString(16)) : a[3].toString(16) + ); + + case '#rgb': + return '#'.concat( + Math.round(f[0] * 15).toString(16), + Math.round(f[1] * 15).toString(16), + Math.round(f[2] * 15).toString(16) + ); + + case '#rgba': + return '#'.concat( + Math.round(f[0] * 15).toString(16), + Math.round(f[1] * 15).toString(16), + Math.round(f[2] * 15).toString(16), + Math.round(f[3] * 15).toString(16) + ); + + case 'rgb': + return 'rgb('.concat(a[0], ', ', a[1], ', ', a[2], ')'); + + case 'rgb%': + return 'rgb('.concat( + (100 * f[0]).toPrecision(3), + '%, ', + (100 * f[1]).toPrecision(3), + '%, ', + (100 * f[2]).toPrecision(3), + '%)' + ); + + case 'rgba%': + return 'rgba('.concat( + (100 * f[0]).toPrecision(3), + '%, ', + (100 * f[1]).toPrecision(3), + '%, ', + (100 * f[2]).toPrecision(3), + '%, ', + (100 * f[3]).toPrecision(3), + '%)' + ); + + case 'hsb': + case 'hsv': + if (!this.hsba) this.hsba = color_conversion._rgbaToHSBA(this._array); + return 'hsb('.concat( + this.hsba[0] * this.maxes[constants.HSB][0], + ', ', + this.hsba[1] * this.maxes[constants.HSB][1], + ', ', + this.hsba[2] * this.maxes[constants.HSB][2], + ')' + ); + + case 'hsb%': + case 'hsv%': + if (!this.hsba) this.hsba = color_conversion._rgbaToHSBA(this._array); + return 'hsb('.concat( + (100 * this.hsba[0]).toPrecision(3), + '%, ', + (100 * this.hsba[1]).toPrecision(3), + '%, ', + (100 * this.hsba[2]).toPrecision(3), + '%)' + ); + + case 'hsba': + case 'hsva': + if (!this.hsba) this.hsba = color_conversion._rgbaToHSBA(this._array); + return 'hsba('.concat( + this.hsba[0] * this.maxes[constants.HSB][0], + ', ', + this.hsba[1] * this.maxes[constants.HSB][1], + ', ', + this.hsba[2] * this.maxes[constants.HSB][2], + ', ', + alpha, + ')' + ); + + case 'hsba%': + case 'hsva%': + if (!this.hsba) this.hsba = color_conversion._rgbaToHSBA(this._array); + return 'hsba('.concat( + (100 * this.hsba[0]).toPrecision(3), + '%, ', + (100 * this.hsba[1]).toPrecision(3), + '%, ', + (100 * this.hsba[2]).toPrecision(3), + '%, ', + (100 * alpha).toPrecision(3), + '%)' + ); + + case 'hsl': + if (!this.hsla) this.hsla = color_conversion._rgbaToHSLA(this._array); + return 'hsl('.concat( + this.hsla[0] * this.maxes[constants.HSL][0], + ', ', + this.hsla[1] * this.maxes[constants.HSL][1], + ', ', + this.hsla[2] * this.maxes[constants.HSL][2], + ')' + ); + + case 'hsl%': + if (!this.hsla) this.hsla = color_conversion._rgbaToHSLA(this._array); + return 'hsl('.concat( + (100 * this.hsla[0]).toPrecision(3), + '%, ', + (100 * this.hsla[1]).toPrecision(3), + '%, ', + (100 * this.hsla[2]).toPrecision(3), + '%)' + ); + + case 'hsla': + if (!this.hsla) this.hsla = color_conversion._rgbaToHSLA(this._array); + return 'hsla('.concat( + this.hsla[0] * this.maxes[constants.HSL][0], + ', ', + this.hsla[1] * this.maxes[constants.HSL][1], + ', ', + this.hsla[2] * this.maxes[constants.HSL][2], + ', ', + alpha, + ')' + ); + + case 'hsla%': + if (!this.hsla) this.hsla = color_conversion._rgbaToHSLA(this._array); + return 'hsl('.concat( + (100 * this.hsla[0]).toPrecision(3), + '%, ', + (100 * this.hsla[1]).toPrecision(3), + '%, ', + (100 * this.hsla[2]).toPrecision(3), + '%, ', + (100 * alpha).toPrecision(3), + '%)' + ); + + case 'rgba': + default: + return 'rgba('.concat(a[0], ',', a[1], ',', a[2], ',', alpha, ')'); + } +}; + +/** + * @method setRed + * @param {Number} red the new red value + * @example + *
    + * + * let backgroundColor; + * + * function setup() { + * backgroundColor = color(100, 50, 150); + * } + * + * function draw() { + * backgroundColor.setRed(128 + 128 * sin(millis() / 1000)); + * background(backgroundColor); + * } + * + *
    + * + * @alt + * canvas with gradually changing background color + */ +p5.Color.prototype.setRed = function(new_red) { + this._array[0] = new_red / this.maxes[constants.RGB][0]; + this._calculateLevels(); +}; + +/** + * @method setGreen + * @param {Number} green the new green value + * @example + *
    + * + * let backgroundColor; + * + * function setup() { + * backgroundColor = color(100, 50, 150); + * } + * + * function draw() { + * backgroundColor.setGreen(128 + 128 * sin(millis() / 1000)); + * background(backgroundColor); + * } + * + *
    + * + * @alt + * canvas with gradually changing background color + **/ +p5.Color.prototype.setGreen = function(new_green) { + this._array[1] = new_green / this.maxes[constants.RGB][1]; + this._calculateLevels(); +}; + +/** + * @method setBlue + * @param {Number} blue the new blue value + * @example + *
    + * + * let backgroundColor; + * + * function setup() { + * backgroundColor = color(100, 50, 150); + * } + * + * function draw() { + * backgroundColor.setBlue(128 + 128 * sin(millis() / 1000)); + * background(backgroundColor); + * } + * + *
    + * + * @alt + * canvas with gradually changing background color + **/ +p5.Color.prototype.setBlue = function(new_blue) { + this._array[2] = new_blue / this.maxes[constants.RGB][2]; + this._calculateLevels(); +}; + +/** + * @method setAlpha + * @param {Number} alpha the new alpha value + * @example + *
    + * + * let squareColor; + * + * function setup() { + * ellipseMode(CORNERS); + * strokeWeight(4); + * squareColor = color(100, 50, 150); + * } + * + * function draw() { + * background(255); + * + * noFill(); + * stroke(0); + * ellipse(10, 10, width - 10, height - 10); + * + * squareColor.setAlpha(128 + 128 * sin(millis() / 1000)); + * fill(squareColor); + * noStroke(); + * rect(13, 13, width - 26, height - 26); + * } + * + *
    + * + * @alt + * circle behind a square with gradually changing opacity + **/ +p5.Color.prototype.setAlpha = function(new_alpha) { + this._array[3] = new_alpha / this.maxes[this.mode][3]; + this._calculateLevels(); +}; + +// calculates and stores the closest screen levels +p5.Color.prototype._calculateLevels = function() { + var array = this._array; + // (loop backwards for performance) + var levels = (this.levels = new Array(array.length)); + for (var i = array.length - 1; i >= 0; --i) { + levels[i] = Math.round(array[i] * 255); + } +}; + +p5.Color.prototype._getAlpha = function() { + return this._array[3] * this.maxes[this.mode][3]; +}; + +// stores the color mode and maxes in this instance of Color +// for later use (by _parseInputs()) +p5.Color.prototype._storeModeAndMaxes = function(new_mode, new_maxes) { + this.mode = new_mode; + this.maxes = new_maxes; +}; + +p5.Color.prototype._getMode = function() { + return this.mode; +}; + +p5.Color.prototype._getMaxes = function() { + return this.maxes; +}; + +p5.Color.prototype._getBlue = function() { + return this._array[2] * this.maxes[constants.RGB][2]; +}; + +p5.Color.prototype._getBrightness = function() { + if (!this.hsba) { + this.hsba = color_conversion._rgbaToHSBA(this._array); + } + return this.hsba[2] * this.maxes[constants.HSB][2]; +}; + +p5.Color.prototype._getGreen = function() { + return this._array[1] * this.maxes[constants.RGB][1]; +}; + +/** + * Hue is the same in HSB and HSL, but the maximum value may be different. + * This function will return the HSB-normalized saturation when supplied with + * an HSB color object, but will default to the HSL-normalized saturation + * otherwise. + */ +p5.Color.prototype._getHue = function() { + if (this.mode === constants.HSB) { + if (!this.hsba) { + this.hsba = color_conversion._rgbaToHSBA(this._array); + } + return this.hsba[0] * this.maxes[constants.HSB][0]; + } else { + if (!this.hsla) { + this.hsla = color_conversion._rgbaToHSLA(this._array); + } + return this.hsla[0] * this.maxes[constants.HSL][0]; + } +}; + +p5.Color.prototype._getLightness = function() { + if (!this.hsla) { + this.hsla = color_conversion._rgbaToHSLA(this._array); + } + return this.hsla[2] * this.maxes[constants.HSL][2]; +}; + +p5.Color.prototype._getRed = function() { + return this._array[0] * this.maxes[constants.RGB][0]; +}; + +/** + * Saturation is scaled differently in HSB and HSL. This function will return + * the HSB saturation when supplied with an HSB color object, but will default + * to the HSL saturation otherwise. + */ +p5.Color.prototype._getSaturation = function() { + if (this.mode === constants.HSB) { + if (!this.hsba) { + this.hsba = color_conversion._rgbaToHSBA(this._array); + } + return this.hsba[1] * this.maxes[constants.HSB][1]; + } else { + if (!this.hsla) { + this.hsla = color_conversion._rgbaToHSLA(this._array); + } + return this.hsla[1] * this.maxes[constants.HSL][1]; + } +}; + +/** + * CSS named colors. + */ +var namedColors = { + aliceblue: '#f0f8ff', + antiquewhite: '#faebd7', + aqua: '#00ffff', + aquamarine: '#7fffd4', + azure: '#f0ffff', + beige: '#f5f5dc', + bisque: '#ffe4c4', + black: '#000000', + blanchedalmond: '#ffebcd', + blue: '#0000ff', + blueviolet: '#8a2be2', + brown: '#a52a2a', + burlywood: '#deb887', + cadetblue: '#5f9ea0', + chartreuse: '#7fff00', + chocolate: '#d2691e', + coral: '#ff7f50', + cornflowerblue: '#6495ed', + cornsilk: '#fff8dc', + crimson: '#dc143c', + cyan: '#00ffff', + darkblue: '#00008b', + darkcyan: '#008b8b', + darkgoldenrod: '#b8860b', + darkgray: '#a9a9a9', + darkgreen: '#006400', + darkgrey: '#a9a9a9', + darkkhaki: '#bdb76b', + darkmagenta: '#8b008b', + darkolivegreen: '#556b2f', + darkorange: '#ff8c00', + darkorchid: '#9932cc', + darkred: '#8b0000', + darksalmon: '#e9967a', + darkseagreen: '#8fbc8f', + darkslateblue: '#483d8b', + darkslategray: '#2f4f4f', + darkslategrey: '#2f4f4f', + darkturquoise: '#00ced1', + darkviolet: '#9400d3', + deeppink: '#ff1493', + deepskyblue: '#00bfff', + dimgray: '#696969', + dimgrey: '#696969', + dodgerblue: '#1e90ff', + firebrick: '#b22222', + floralwhite: '#fffaf0', + forestgreen: '#228b22', + fuchsia: '#ff00ff', + gainsboro: '#dcdcdc', + ghostwhite: '#f8f8ff', + gold: '#ffd700', + goldenrod: '#daa520', + gray: '#808080', + green: '#008000', + greenyellow: '#adff2f', + grey: '#808080', + honeydew: '#f0fff0', + hotpink: '#ff69b4', + indianred: '#cd5c5c', + indigo: '#4b0082', + ivory: '#fffff0', + khaki: '#f0e68c', + lavender: '#e6e6fa', + lavenderblush: '#fff0f5', + lawngreen: '#7cfc00', + lemonchiffon: '#fffacd', + lightblue: '#add8e6', + lightcoral: '#f08080', + lightcyan: '#e0ffff', + lightgoldenrodyellow: '#fafad2', + lightgray: '#d3d3d3', + lightgreen: '#90ee90', + lightgrey: '#d3d3d3', + lightpink: '#ffb6c1', + lightsalmon: '#ffa07a', + lightseagreen: '#20b2aa', + lightskyblue: '#87cefa', + lightslategray: '#778899', + lightslategrey: '#778899', + lightsteelblue: '#b0c4de', + lightyellow: '#ffffe0', + lime: '#00ff00', + limegreen: '#32cd32', + linen: '#faf0e6', + magenta: '#ff00ff', + maroon: '#800000', + mediumaquamarine: '#66cdaa', + mediumblue: '#0000cd', + mediumorchid: '#ba55d3', + mediumpurple: '#9370db', + mediumseagreen: '#3cb371', + mediumslateblue: '#7b68ee', + mediumspringgreen: '#00fa9a', + mediumturquoise: '#48d1cc', + mediumvioletred: '#c71585', + midnightblue: '#191970', + mintcream: '#f5fffa', + mistyrose: '#ffe4e1', + moccasin: '#ffe4b5', + navajowhite: '#ffdead', + navy: '#000080', + oldlace: '#fdf5e6', + olive: '#808000', + olivedrab: '#6b8e23', + orange: '#ffa500', + orangered: '#ff4500', + orchid: '#da70d6', + palegoldenrod: '#eee8aa', + palegreen: '#98fb98', + paleturquoise: '#afeeee', + palevioletred: '#db7093', + papayawhip: '#ffefd5', + peachpuff: '#ffdab9', + peru: '#cd853f', + pink: '#ffc0cb', + plum: '#dda0dd', + powderblue: '#b0e0e6', + purple: '#800080', + red: '#ff0000', + rosybrown: '#bc8f8f', + royalblue: '#4169e1', + saddlebrown: '#8b4513', + salmon: '#fa8072', + sandybrown: '#f4a460', + seagreen: '#2e8b57', + seashell: '#fff5ee', + sienna: '#a0522d', + silver: '#c0c0c0', + skyblue: '#87ceeb', + slateblue: '#6a5acd', + slategray: '#708090', + slategrey: '#708090', + snow: '#fffafa', + springgreen: '#00ff7f', + steelblue: '#4682b4', + tan: '#d2b48c', + teal: '#008080', + thistle: '#d8bfd8', + tomato: '#ff6347', + turquoise: '#40e0d0', + violet: '#ee82ee', + wheat: '#f5deb3', + white: '#ffffff', + whitesmoke: '#f5f5f5', + yellow: '#ffff00', + yellowgreen: '#9acd32' +}; + +/** + * These regular expressions are used to build up the patterns for matching + * viable CSS color strings: fragmenting the regexes in this way increases the + * legibility and comprehensibility of the code. + * + * Note that RGB values of .9 are not parsed by IE, but are supported here for + * color string consistency. + */ +var WHITESPACE = /\s*/; // Match zero or more whitespace characters. +var INTEGER = /(\d{1,3})/; // Match integers: 79, 255, etc. +var DECIMAL = /((?:\d+(?:\.\d+)?)|(?:\.\d+))/; // Match 129.6, 79, .9, etc. +var PERCENT = new RegExp(DECIMAL.source + '%'); // Match 12.9%, 79%, .9%, etc. + +/** + * Full color string patterns. The capture groups are necessary. + */ +var colorPatterns = { + // Match colors in format #XXX, e.g. #416. + HEX3: /^#([a-f0-9])([a-f0-9])([a-f0-9])$/i, + + // Match colors in format #XXXX, e.g. #5123. + HEX4: /^#([a-f0-9])([a-f0-9])([a-f0-9])([a-f0-9])$/i, + + // Match colors in format #XXXXXX, e.g. #b4d455. + HEX6: /^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i, + + // Match colors in format #XXXXXXXX, e.g. #b4d45535. + HEX8: /^#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})$/i, + + // Match colors in format rgb(R, G, B), e.g. rgb(255, 0, 128). + RGB: new RegExp( + [ + '^rgb\\(', + INTEGER.source, + ',', + INTEGER.source, + ',', + INTEGER.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ), + + // Match colors in format rgb(R%, G%, B%), e.g. rgb(100%, 0%, 28.9%). + RGB_PERCENT: new RegExp( + [ + '^rgb\\(', + PERCENT.source, + ',', + PERCENT.source, + ',', + PERCENT.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ), + + // Match colors in format rgb(R, G, B, A), e.g. rgb(255, 0, 128, 0.25). + RGBA: new RegExp( + [ + '^rgba\\(', + INTEGER.source, + ',', + INTEGER.source, + ',', + INTEGER.source, + ',', + DECIMAL.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ), + + // Match colors in format rgb(R%, G%, B%, A), e.g. rgb(100%, 0%, 28.9%, 0.5). + RGBA_PERCENT: new RegExp( + [ + '^rgba\\(', + PERCENT.source, + ',', + PERCENT.source, + ',', + PERCENT.source, + ',', + DECIMAL.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ), + + // Match colors in format hsla(H, S%, L%), e.g. hsl(100, 40%, 28.9%). + HSL: new RegExp( + [ + '^hsl\\(', + INTEGER.source, + ',', + PERCENT.source, + ',', + PERCENT.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ), + + // Match colors in format hsla(H, S%, L%, A), e.g. hsla(100, 40%, 28.9%, 0.5). + HSLA: new RegExp( + [ + '^hsla\\(', + INTEGER.source, + ',', + PERCENT.source, + ',', + PERCENT.source, + ',', + DECIMAL.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ), + + // Match colors in format hsb(H, S%, B%), e.g. hsb(100, 40%, 28.9%). + HSB: new RegExp( + [ + '^hsb\\(', + INTEGER.source, + ',', + PERCENT.source, + ',', + PERCENT.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ), + + // Match colors in format hsba(H, S%, B%, A), e.g. hsba(100, 40%, 28.9%, 0.5). + HSBA: new RegExp( + [ + '^hsba\\(', + INTEGER.source, + ',', + PERCENT.source, + ',', + PERCENT.source, + ',', + DECIMAL.source, + '\\)$' + ].join(WHITESPACE.source), + 'i' + ) +}; + +/** + * For a number of different inputs, returns a color formatted as [r, g, b, a] + * arrays, with each component normalized between 0 and 1. + * + * @private + * @param {Array} [...args] An 'array-like' object that represents a list of + * arguments + * @return {Number[]} a color formatted as [r, g, b, a] + * Example: + * input ==> output + * g ==> [g, g, g, 255] + * g,a ==> [g, g, g, a] + * r, g, b ==> [r, g, b, 255] + * r, g, b, a ==> [r, g, b, a] + * [g] ==> [g, g, g, 255] + * [g, a] ==> [g, g, g, a] + * [r, g, b] ==> [r, g, b, 255] + * [r, g, b, a] ==> [r, g, b, a] + * @example + *
    + * + * // todo + * + *
    + * + * @alt + * //todo + * + */ +p5.Color._parseInputs = function(r, g, b, a) { + var numArgs = arguments.length; + var mode = this.mode; + var maxes = this.maxes[mode]; + var results = []; + var i; + + if (numArgs >= 3) { + // Argument is a list of component values. + + results[0] = r / maxes[0]; + results[1] = g / maxes[1]; + results[2] = b / maxes[2]; + + // Alpha may be undefined, so default it to 100%. + if (typeof a === 'number') { + results[3] = a / maxes[3]; + } else { + results[3] = 1; + } + + // Constrain components to the range [0,1]. + // (loop backwards for performance) + for (i = results.length - 1; i >= 0; --i) { + var result = results[i]; + if (result < 0) { + results[i] = 0; + } else if (result > 1) { + results[i] = 1; + } + } + + // Convert to RGBA and return. + if (mode === constants.HSL) { + return color_conversion._hslaToRGBA(results); + } else if (mode === constants.HSB) { + return color_conversion._hsbaToRGBA(results); + } else { + return results; + } + } else if (numArgs === 1 && typeof r === 'string') { + var str = r.trim().toLowerCase(); + + // Return if string is a named colour. + if (namedColors[str]) { + return p5.Color._parseInputs.call(this, namedColors[str]); + } + + // Try RGBA pattern matching. + if (colorPatterns.HEX3.test(str)) { + // #rgb + results = colorPatterns.HEX3.exec(str) + .slice(1) + .map(function(color) { + return parseInt(color + color, 16) / 255; + }); + results[3] = 1; + return results; + } else if (colorPatterns.HEX6.test(str)) { + // #rrggbb + results = colorPatterns.HEX6.exec(str) + .slice(1) + .map(function(color) { + return parseInt(color, 16) / 255; + }); + results[3] = 1; + return results; + } else if (colorPatterns.HEX4.test(str)) { + // #rgba + results = colorPatterns.HEX4.exec(str) + .slice(1) + .map(function(color) { + return parseInt(color + color, 16) / 255; + }); + return results; + } else if (colorPatterns.HEX8.test(str)) { + // #rrggbbaa + results = colorPatterns.HEX8.exec(str) + .slice(1) + .map(function(color) { + return parseInt(color, 16) / 255; + }); + return results; + } else if (colorPatterns.RGB.test(str)) { + // rgb(R,G,B) + results = colorPatterns.RGB.exec(str) + .slice(1) + .map(function(color) { + return color / 255; + }); + results[3] = 1; + return results; + } else if (colorPatterns.RGB_PERCENT.test(str)) { + // rgb(R%,G%,B%) + results = colorPatterns.RGB_PERCENT.exec(str) + .slice(1) + .map(function(color) { + return parseFloat(color) / 100; + }); + results[3] = 1; + return results; + } else if (colorPatterns.RGBA.test(str)) { + // rgba(R,G,B,A) + results = colorPatterns.RGBA.exec(str) + .slice(1) + .map(function(color, idx) { + if (idx === 3) { + return parseFloat(color); + } + return color / 255; + }); + return results; + } else if (colorPatterns.RGBA_PERCENT.test(str)) { + // rgba(R%,G%,B%,A%) + results = colorPatterns.RGBA_PERCENT.exec(str) + .slice(1) + .map(function(color, idx) { + if (idx === 3) { + return parseFloat(color); + } + return parseFloat(color) / 100; + }); + return results; + } + + // Try HSLA pattern matching. + if (colorPatterns.HSL.test(str)) { + // hsl(H,S,L) + results = colorPatterns.HSL.exec(str) + .slice(1) + .map(function(color, idx) { + if (idx === 0) { + return parseInt(color, 10) / 360; + } + return parseInt(color, 10) / 100; + }); + results[3] = 1; + } else if (colorPatterns.HSLA.test(str)) { + // hsla(H,S,L,A) + results = colorPatterns.HSLA.exec(str) + .slice(1) + .map(function(color, idx) { + if (idx === 0) { + return parseInt(color, 10) / 360; + } else if (idx === 3) { + return parseFloat(color); + } + return parseInt(color, 10) / 100; + }); + } + results = results.map(function(value) { + return Math.max(Math.min(value, 1), 0); + }); + if (results.length) { + return color_conversion._hslaToRGBA(results); + } + + // Try HSBA pattern matching. + if (colorPatterns.HSB.test(str)) { + // hsb(H,S,B) + results = colorPatterns.HSB.exec(str) + .slice(1) + .map(function(color, idx) { + if (idx === 0) { + return parseInt(color, 10) / 360; + } + return parseInt(color, 10) / 100; + }); + results[3] = 1; + } else if (colorPatterns.HSBA.test(str)) { + // hsba(H,S,B,A) + results = colorPatterns.HSBA.exec(str) + .slice(1) + .map(function(color, idx) { + if (idx === 0) { + return parseInt(color, 10) / 360; + } else if (idx === 3) { + return parseFloat(color); + } + return parseInt(color, 10) / 100; + }); + } + + if (results.length) { + // (loop backwards for performance) + for (i = results.length - 1; i >= 0; --i) { + results[i] = Math.max(Math.min(results[i], 1), 0); + } + + return color_conversion._hsbaToRGBA(results); + } + + // Input did not match any CSS color pattern: default to white. + results = [1, 1, 1, 1]; + } else if ((numArgs === 1 || numArgs === 2) && typeof r === 'number') { + // 'Grayscale' mode. + + /** + * For HSB and HSL, interpret the gray level as a brightness/lightness + * value (they are equivalent when chroma is zero). For RGB, normalize the + * gray level according to the blue maximum. + */ + results[0] = r / maxes[2]; + results[1] = r / maxes[2]; + results[2] = r / maxes[2]; + + // Alpha may be undefined, so default it to 100%. + if (typeof g === 'number') { + results[3] = g / maxes[3]; + } else { + results[3] = 1; + } + + // Constrain components to the range [0,1]. + results = results.map(function(value) { + return Math.max(Math.min(value, 1), 0); + }); + } else { + throw new Error(arguments + 'is not a valid color representation.'); + } + + return results; +}; + +module.exports = p5.Color; + +},{"../core/constants":18,"../core/main":24,"./color_conversion":14}],17:[function(_dereq_,module,exports){ +/** + * @module Color + * @submodule Setting + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); +_dereq_('./p5.Color'); + +/** + * The background() function sets the color used for the background of the + * p5.js canvas. The default background is transparent. This function is + * typically used within draw() to clear the display window at the beginning + * of each frame, but it can be used inside setup() to set the background on + * the first frame of animation or if the background need only be set once. + *

    + * The color is either specified in terms of the RGB, HSB, or HSL color + * depending on the current colorMode. (The default color space is RGB, with + * each value in the range from 0 to 255). The alpha range by default is also 0 to 255. + *

    + * If a single string argument is provided, RGB, RGBA and Hex CSS color strings + * and all named color strings are supported. In this case, an alpha number + * value as a second argument is not supported, the RGBA form should be used. + *

    + * A p5.Color object can also be provided to set the background color. + *

    + * A p5.Image can also be provided to set the background image. + * + * @method background + * @param {p5.Color} color any value created by the color() function + * @chainable + * + * @example + *
    + * + * // Grayscale integer value + * background(51); + * + *
    + * + *
    + * + * // R, G & B integer values + * background(255, 204, 0); + * + *
    + * + *
    + * + * // H, S & B integer values + * colorMode(HSB); + * background(255, 204, 100); + * + *
    + * + *
    + * + * // Named SVG/CSS color string + * background('red'); + * + *
    + * + *
    + * + * // three-digit hexadecimal RGB notation + * background('#fae'); + * + *
    + * + *
    + * + * // six-digit hexadecimal RGB notation + * background('#222222'); + * + *
    + * + *
    + * + * // integer RGB notation + * background('rgb(0,255,0)'); + * + *
    + * + *
    + * + * // integer RGBA notation + * background('rgba(0,255,0, 0.25)'); + * + *
    + * + *
    + * + * // percentage RGB notation + * background('rgb(100%,0%,10%)'); + * + *
    + * + *
    + * + * // percentage RGBA notation + * background('rgba(100%,0%,100%,0.5)'); + * + *
    + * + *
    + * + * // p5 Color object + * background(color(0, 0, 255)); + * + *
    + * + * @alt + * canvas with darkest charcoal grey background. + * canvas with yellow background. + * canvas with royal blue background. + * canvas with red background. + * canvas with pink background. + * canvas with black background. + * canvas with bright green background. + * canvas with soft green background. + * canvas with red background. + * canvas with light purple background. + * canvas with blue background. + */ + +/** + * @method background + * @param {String} colorstring color string, possible formats include: integer + * rgb() or rgba(), percentage rgb() or rgba(), + * 3-digit hex, 6-digit hex + * @param {Number} [a] opacity of the background relative to current + * color range (default is 0-255) + * @chainable + */ + +/** + * @method background + * @param {Number} gray specifies a value between white and black + * @param {Number} [a] + * @chainable + */ + +/** + * @method background + * @param {Number} v1 red or hue value (depending on the current color + * mode) + * @param {Number} v2 green or saturation value (depending on the current + * color mode) + * @param {Number} v3 blue or brightness value (depending on the current + * color mode) + * @param {Number} [a] + * @chainable + */ + +/** + * @method background + * @param {Number[]} values an array containing the red, green, blue + * and alpha components of the color + * @chainable + */ + +/** + * @method background + * @param {p5.Image} image image created with loadImage() or createImage(), + * to set as background + * (must be same size as the sketch window) + * @param {Number} [a] + * @chainable + */ + +p5.prototype.background = function() { + this._renderer.background.apply(this._renderer, arguments); + return this; +}; + +/** + * Clears the pixels within a buffer. This function only clears the canvas. + * It will not clear objects created by createX() methods such as + * createVideo() or createDiv(). + * Unlike the main graphics context, pixels in additional graphics areas created + * with createGraphics() can be entirely + * or partially transparent. This function clears everything to make all of + * the pixels 100% transparent. + * + * @method clear + * @chainable + * @example + *
    + * + * // Clear the screen on mouse press. + * function setup() { + * createCanvas(100, 100); + * } + * + * function draw() { + * ellipse(mouseX, mouseY, 20, 20); + * } + * + * function mousePressed() { + * clear(); + * } + * + *
    + * + * @alt + * 20x20 white ellipses are continually drawn at mouse x and y coordinates. + * + */ + +p5.prototype.clear = function() { + this._renderer.clear(); + return this; +}; + +/** + * colorMode() changes the way p5.js interprets color data. By default, the + * parameters for fill(), stroke(), background(), and color() are defined by + * values between 0 and 255 using the RGB color model. This is equivalent to + * setting colorMode(RGB, 255). Setting colorMode(HSB) lets you use the HSB + * system instead. By default, this is colorMode(HSB, 360, 100, 100, 1). You + * can also use HSL. + *

    + * Note: existing color objects remember the mode that they were created in, + * so you can change modes as you like without affecting their appearance. + * + * + * @method colorMode + * @param {Constant} mode either RGB, HSB or HSL, corresponding to + * Red/Green/Blue and Hue/Saturation/Brightness + * (or Lightness) + * @param {Number} [max] range for all values + * @chainable + * + * @example + *
    + * + * noStroke(); + * colorMode(RGB, 100); + * for (let i = 0; i < 100; i++) { + * for (let j = 0; j < 100; j++) { + * stroke(i, j, 0); + * point(i, j); + * } + * } + * + *
    + * + *
    + * + * noStroke(); + * colorMode(HSB, 100); + * for (let i = 0; i < 100; i++) { + * for (let j = 0; j < 100; j++) { + * stroke(i, j, 100); + * point(i, j); + * } + * } + * + *
    + * + *
    + * + * colorMode(RGB, 255); + * let c = color(127, 255, 0); + * + * colorMode(RGB, 1); + * let myColor = c._getRed(); + * text(myColor, 10, 10, 80, 80); + * + *
    + * + *
    + * + * noFill(); + * colorMode(RGB, 255, 255, 255, 1); + * background(255); + * + * strokeWeight(4); + * stroke(255, 0, 10, 0.3); + * ellipse(40, 40, 50, 50); + * ellipse(50, 50, 40, 40); + * + *
    + * + * @alt + *Green to red gradient from bottom L to top R. shading originates from top left. + *Rainbow gradient from left to right. Brightness increasing to white at top. + *unknown image. + *50x50 ellipse at middle L & 40x40 ellipse at center. Translucent pink outlines. + * + */ +/** + * @method colorMode + * @param {Constant} mode + * @param {Number} max1 range for the red or hue depending on the + * current color mode + * @param {Number} max2 range for the green or saturation depending + * on the current color mode + * @param {Number} max3 range for the blue or brightness/lightness + * depending on the current color mode + * @param {Number} [maxA] range for the alpha + * @chainable + */ +p5.prototype.colorMode = function(mode, max1, max2, max3, maxA) { + p5._validateParameters('colorMode', arguments); + if ( + mode === constants.RGB || + mode === constants.HSB || + mode === constants.HSL + ) { + // Set color mode. + this._colorMode = mode; + + // Set color maxes. + var maxes = this._colorMaxes[mode]; + if (arguments.length === 2) { + maxes[0] = max1; // Red + maxes[1] = max1; // Green + maxes[2] = max1; // Blue + maxes[3] = max1; // Alpha + } else if (arguments.length === 4) { + maxes[0] = max1; // Red + maxes[1] = max2; // Green + maxes[2] = max3; // Blue + } else if (arguments.length === 5) { + maxes[0] = max1; // Red + maxes[1] = max2; // Green + maxes[2] = max3; // Blue + maxes[3] = maxA; // Alpha + } + } + + return this; +}; + +/** + * Sets the color used to fill shapes. For example, if you run + * fill(204, 102, 0), all subsequent shapes will be filled with orange. This + * color is either specified in terms of the RGB or HSB color depending on + * the current colorMode(). (The default color space is RGB, with each value + * in the range from 0 to 255). The alpha range by default is also 0 to 255. + *

    + * If a single string argument is provided, RGB, RGBA and Hex CSS color strings + * and all named color strings are supported. In this case, an alpha number + * value as a second argument is not supported, the RGBA form should be used. + *

    + * A p5 Color object can also be provided to set the fill color. + * + * @method fill + * @param {Number} v1 red or hue value relative to + * the current color range + * @param {Number} v2 green or saturation value + * relative to the current color range + * @param {Number} v3 blue or brightness value + * relative to the current color range + * @param {Number} [alpha] + * @chainable + * @example + *
    + * + * // Grayscale integer value + * fill(51); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // R, G & B integer values + * fill(255, 204, 0); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // H, S & B integer values + * colorMode(HSB); + * fill(255, 204, 100); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // Named SVG/CSS color string + * fill('red'); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // three-digit hexadecimal RGB notation + * fill('#fae'); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // six-digit hexadecimal RGB notation + * fill('#222222'); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // integer RGB notation + * fill('rgb(0,255,0)'); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // integer RGBA notation + * fill('rgba(0,255,0, 0.25)'); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // percentage RGB notation + * fill('rgb(100%,0%,10%)'); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // percentage RGBA notation + * fill('rgba(100%,0%,100%,0.5)'); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // p5 Color object + * fill(color(0, 0, 255)); + * rect(20, 20, 60, 60); + * + *
    + * @alt + * 60x60 dark charcoal grey rect with black outline in center of canvas. + * 60x60 yellow rect with black outline in center of canvas. + * 60x60 royal blue rect with black outline in center of canvas. + * 60x60 red rect with black outline in center of canvas. + * 60x60 pink rect with black outline in center of canvas. + * 60x60 black rect with black outline in center of canvas. + * 60x60 light green rect with black outline in center of canvas. + * 60x60 soft green rect with black outline in center of canvas. + * 60x60 red rect with black outline in center of canvas. + * 60x60 dark fuchsia rect with black outline in center of canvas. + * 60x60 blue rect with black outline in center of canvas. + */ + +/** + * @method fill + * @param {String} value a color string + * @chainable + */ + +/** + * @method fill + * @param {Number} gray a gray value + * @param {Number} [alpha] + * @chainable + */ + +/** + * @method fill + * @param {Number[]} values an array containing the red,green,blue & + * and alpha components of the color + * @chainable + */ + +/** + * @method fill + * @param {p5.Color} color the fill color + * @chainable + */ +p5.prototype.fill = function() { + this._renderer._setProperty('_fillSet', true); + this._renderer._setProperty('_doFill', true); + this._renderer.fill.apply(this._renderer, arguments); + return this; +}; + +/** + * Disables filling geometry. If both noStroke() and noFill() are called, + * nothing will be drawn to the screen. + * + * @method noFill + * @chainable + * @example + *
    + * + * rect(15, 10, 55, 55); + * noFill(); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(0); + * noFill(); + * stroke(100, 100, 240); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * box(45, 45, 45); + * } + * + *
    + * + * @alt + * white rect top middle and noFill rect center. Both 60x60 with black outlines. + * black canvas with purple cube wireframe spinning + */ +p5.prototype.noFill = function() { + this._renderer._setProperty('_doFill', false); + return this; +}; + +/** + * Disables drawing the stroke (outline). If both noStroke() and noFill() + * are called, nothing will be drawn to the screen. + * + * @method noStroke + * @chainable + * @example + *
    + * + * noStroke(); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(0); + * noStroke(); + * fill(240, 150, 150); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * box(45, 45, 45); + * } + * + *
    + * + * @alt + * 60x60 white rect at center. no outline. + * black canvas with pink cube spinning + */ +p5.prototype.noStroke = function() { + this._renderer._setProperty('_doStroke', false); + return this; +}; + +/** + * Sets the color used to draw lines and borders around shapes. This color + * is either specified in terms of the RGB or HSB color depending on the + * current colorMode() (the default color space is RGB, with each value in + * the range from 0 to 255). The alpha range by default is also 0 to 255. + *

    + * If a single string argument is provided, RGB, RGBA and Hex CSS color + * strings and all named color strings are supported. In this case, an alpha + * number value as a second argument is not supported, the RGBA form should be + * used. + *

    + * A p5 Color object can also be provided to set the stroke color. + * + * + * @method stroke + * @param {Number} v1 red or hue value relative to + * the current color range + * @param {Number} v2 green or saturation value + * relative to the current color range + * @param {Number} v3 blue or brightness value + * relative to the current color range + * @param {Number} [alpha] + * @chainable + * + * @example + *
    + * + * // Grayscale integer value + * strokeWeight(4); + * stroke(51); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // R, G & B integer values + * stroke(255, 204, 0); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // H, S & B integer values + * colorMode(HSB); + * strokeWeight(4); + * stroke(255, 204, 100); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // Named SVG/CSS color string + * stroke('red'); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // three-digit hexadecimal RGB notation + * stroke('#fae'); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // six-digit hexadecimal RGB notation + * stroke('#222222'); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // integer RGB notation + * stroke('rgb(0,255,0)'); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // integer RGBA notation + * stroke('rgba(0,255,0,0.25)'); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // percentage RGB notation + * stroke('rgb(100%,0%,10%)'); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // percentage RGBA notation + * stroke('rgba(100%,0%,100%,0.5)'); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + *
    + * + * // p5 Color object + * stroke(color(0, 0, 255)); + * strokeWeight(4); + * rect(20, 20, 60, 60); + * + *
    + * + * @alt + * 60x60 white rect at center. Dark charcoal grey outline. + * 60x60 white rect at center. Yellow outline. + * 60x60 white rect at center. Royal blue outline. + * 60x60 white rect at center. Red outline. + * 60x60 white rect at center. Pink outline. + * 60x60 white rect at center. Black outline. + * 60x60 white rect at center. Bright green outline. + * 60x60 white rect at center. Soft green outline. + * 60x60 white rect at center. Red outline. + * 60x60 white rect at center. Dark fuchsia outline. + * 60x60 white rect at center. Blue outline. + */ + +/** + * @method stroke + * @param {String} value a color string + * @chainable + */ + +/** + * @method stroke + * @param {Number} gray a gray value + * @param {Number} [alpha] + * @chainable + */ + +/** + * @method stroke + * @param {Number[]} values an array containing the red,green,blue & + * and alpha components of the color + * @chainable + */ + +/** + * @method stroke + * @param {p5.Color} color the stroke color + * @chainable + */ + +p5.prototype.stroke = function() { + this._renderer._setProperty('_strokeSet', true); + this._renderer._setProperty('_doStroke', true); + this._renderer.stroke.apply(this._renderer, arguments); + return this; +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/main":24,"./p5.Color":16}],18:[function(_dereq_,module,exports){ +/** + * @module Constants + * @submodule Constants + * @for p5 + */ + +'use strict'; + +var PI = Math.PI; + +module.exports = { + // GRAPHICS RENDERER + /** + * @property {String} P2D + * @final + */ + P2D: 'p2d', + /** + * @property {String} WEBGL + * @final + */ + WEBGL: 'webgl', + + // ENVIRONMENT + /** + * @property {String} ARROW + * @final + */ + ARROW: 'default', + /** + * @property {String} CROSS + * @final + */ + CROSS: 'crosshair', + /** + * @property {String} HAND + * @final + */ + HAND: 'pointer', + /** + * @property {String} MOVE + * @final + */ + MOVE: 'move', + /** + * @property {String} TEXT + * @final + */ + TEXT: 'text', + /** + * @property {String} WAIT + * @final + */ + WAIT: 'wait', + + // TRIGONOMETRY + + /** + * HALF_PI is a mathematical constant with the value + * 1.57079632679489661923. It is half the ratio of the + * circumference of a circle to its diameter. It is useful in + * combination with the trigonometric functions sin() and cos(). + * + * @property {Number} HALF_PI + * @final + * + * @example + *
    + * arc(50, 50, 80, 80, 0, HALF_PI); + *
    + * + * @alt + * 80x80 white quarter-circle with curve toward bottom right of canvas. + * + */ + HALF_PI: PI / 2, + /** + * PI is a mathematical constant with the value + * 3.14159265358979323846. It is the ratio of the circumference + * of a circle to its diameter. It is useful in combination with + * the trigonometric functions sin() and cos(). + * + * @property {Number} PI + * @final + * + * @example + *
    + * arc(50, 50, 80, 80, 0, PI); + *
    + * + * @alt + * white half-circle with curve toward bottom of canvas. + * + */ + PI: PI, + /** + * QUARTER_PI is a mathematical constant with the value 0.7853982. + * It is one quarter the ratio of the circumference of a circle to + * its diameter. It is useful in combination with the trigonometric + * functions sin() and cos(). + * + * @property {Number} QUARTER_PI + * @final + * + * @example + *
    + * arc(50, 50, 80, 80, 0, QUARTER_PI); + *
    + * + * @alt + * white eighth-circle rotated about 40 degrees with curve bottom right canvas. + * + */ + QUARTER_PI: PI / 4, + /** + * TAU is an alias for TWO_PI, a mathematical constant with the + * value 6.28318530717958647693. It is twice the ratio of the + * circumference of a circle to its diameter. It is useful in + * combination with the trigonometric functions sin() and cos(). + * + * @property {Number} TAU + * @final + * + * @example + *
    + * arc(50, 50, 80, 80, 0, TAU); + *
    + * + * @alt + * 80x80 white ellipse shape in center of canvas. + * + */ + TAU: PI * 2, + /** + * TWO_PI is a mathematical constant with the value + * 6.28318530717958647693. It is twice the ratio of the + * circumference of a circle to its diameter. It is useful in + * combination with the trigonometric functions sin() and cos(). + * + * @property {Number} TWO_PI + * @final + * + * @example + *
    + * arc(50, 50, 80, 80, 0, TWO_PI); + *
    + * + * @alt + * 80x80 white ellipse shape in center of canvas. + * + */ + TWO_PI: PI * 2, + /** + * Constant to be used with angleMode() function, to set the mode which + * p5.js interprates and calculates angles (either DEGREES or RADIANS). + * @property {String} DEGREES + * @final + * + * @example + *
    + * function setup() { + * angleMode(DEGREES); + * } + *
    + */ + DEGREES: 'degrees', + /** + * Constant to be used with angleMode() function, to set the mode which + * p5.js interprates and calculates angles (either RADIANS or DEGREES). + * @property {String} RADIANS + * @final + * + * @example + *
    + * function setup() { + * angleMode(RADIANS); + * } + *
    + */ + RADIANS: 'radians', + DEG_TO_RAD: PI / 180.0, + RAD_TO_DEG: 180.0 / PI, + + // SHAPE + /** + * @property {String} CORNER + * @final + */ + CORNER: 'corner', + /** + * @property {String} CORNERS + * @final + */ + CORNERS: 'corners', + /** + * @property {String} RADIUS + * @final + */ + RADIUS: 'radius', + /** + * @property {String} RIGHT + * @final + */ + RIGHT: 'right', + /** + * @property {String} LEFT + * @final + */ + LEFT: 'left', + /** + * @property {String} CENTER + * @final + */ + CENTER: 'center', + /** + * @property {String} TOP + * @final + */ + TOP: 'top', + /** + * @property {String} BOTTOM + * @final + */ + BOTTOM: 'bottom', + /** + * @property {String} BASELINE + * @final + * @default alphabetic + */ + BASELINE: 'alphabetic', + /** + * @property {Number} POINTS + * @final + * @default 0x0000 + */ + POINTS: 0x0000, + /** + * @property {Number} LINES + * @final + * @default 0x0001 + */ + LINES: 0x0001, + /** + * @property {Number} LINE_STRIP + * @final + * @default 0x0003 + */ + LINE_STRIP: 0x0003, + /** + * @property {Number} LINE_LOOP + * @final + * @default 0x0002 + */ + LINE_LOOP: 0x0002, + /** + * @property {Number} TRIANGLES + * @final + * @default 0x0004 + */ + TRIANGLES: 0x0004, + /** + * @property {Number} TRIANGLE_FAN + * @final + * @default 0x0006 + */ + TRIANGLE_FAN: 0x0006, + /** + * @property {Number} TRIANGLE_STRIP + * @final + * @default 0x0005 + */ + TRIANGLE_STRIP: 0x0005, + /** + * @property {String} QUADS + * @final + */ + QUADS: 'quads', + /** + * @property {String} QUAD_STRIP + * @final + * @default quad_strip + */ + QUAD_STRIP: 'quad_strip', + /** + * @property {String} CLOSE + * @final + */ + CLOSE: 'close', + /** + * @property {String} OPEN + * @final + */ + OPEN: 'open', + /** + * @property {String} CHORD + * @final + */ + CHORD: 'chord', + /** + * @property {String} PIE + * @final + */ + PIE: 'pie', + /** + * @property {String} PROJECT + * @final + * @default square + */ + PROJECT: 'square', // PEND: careful this is counterintuitive + /** + * @property {String} SQUARE + * @final + * @default butt + */ + SQUARE: 'butt', + /** + * @property {String} ROUND + * @final + */ + ROUND: 'round', + /** + * @property {String} BEVEL + * @final + */ + BEVEL: 'bevel', + /** + * @property {String} MITER + * @final + */ + MITER: 'miter', + + // COLOR + /** + * @property {String} RGB + * @final + */ + RGB: 'rgb', + /** + * @property {String} HSB + * @final + */ + HSB: 'hsb', + /** + * @property {String} HSL + * @final + */ + HSL: 'hsl', + + // DOM EXTENSION + /** + * AUTO allows us to automatically set the width or height of an element (but not both), + * based on the current height and width of the element. Only one parameter can + * be passed to the size function as AUTO, at a time. + * + * @property {String} AUTO + * @final + */ + AUTO: 'auto', + + // INPUT + ALT: 18, + BACKSPACE: 8, + CONTROL: 17, + DELETE: 46, + DOWN_ARROW: 40, + ENTER: 13, + ESCAPE: 27, + LEFT_ARROW: 37, + OPTION: 18, + RETURN: 13, + RIGHT_ARROW: 39, + SHIFT: 16, + TAB: 9, + UP_ARROW: 38, + + // RENDERING + /** + * @property {String} BLEND + * @final + * @default source-over + */ + BLEND: 'source-over', + /** + * @property {String} ADD + * @final + * @default lighter + */ + ADD: 'lighter', + //ADD: 'add', // + //SUBTRACT: 'subtract', // + /** + * @property {String} DARKEST + * @final + */ + DARKEST: 'darken', + /** + * @property {String} LIGHTEST + * @final + * @default lighten + */ + LIGHTEST: 'lighten', + /** + * @property {String} DIFFERENCE + * @final + */ + DIFFERENCE: 'difference', + /** + * @property {String} SUBTRACT + * @final + */ + SUBTRACT: 'subtract', + /** + * @property {String} EXCLUSION + * @final + */ + EXCLUSION: 'exclusion', + /** + * @property {String} MULTIPLY + * @final + */ + MULTIPLY: 'multiply', + /** + * @property {String} SCREEN + * @final + */ + SCREEN: 'screen', + /** + * @property {String} REPLACE + * @final + * @default copy + */ + REPLACE: 'copy', + /** + * @property {String} OVERLAY + * @final + */ + OVERLAY: 'overlay', + /** + * @property {String} HARD_LIGHT + * @final + */ + HARD_LIGHT: 'hard-light', + /** + * @property {String} SOFT_LIGHT + * @final + */ + SOFT_LIGHT: 'soft-light', + /** + * @property {String} DODGE + * @final + * @default color-dodge + */ + DODGE: 'color-dodge', + /** + * @property {String} BURN + * @final + * @default color-burn + */ + BURN: 'color-burn', + + // FILTERS + /** + * @property {String} THRESHOLD + * @final + */ + THRESHOLD: 'threshold', + /** + * @property {String} GRAY + * @final + */ + GRAY: 'gray', + /** + * @property {String} OPAQUE + * @final + */ + OPAQUE: 'opaque', + /** + * @property {String} INVERT + * @final + */ + INVERT: 'invert', + /** + * @property {String} POSTERIZE + * @final + */ + POSTERIZE: 'posterize', + /** + * @property {String} DILATE + * @final + */ + DILATE: 'dilate', + /** + * @property {String} ERODE + * @final + */ + ERODE: 'erode', + /** + * @property {String} BLUR + * @final + */ + BLUR: 'blur', + + // TYPOGRAPHY + /** + * @property {String} NORMAL + * @final + */ + NORMAL: 'normal', + /** + * @property {String} ITALIC + * @final + */ + ITALIC: 'italic', + /** + * @property {String} BOLD + * @final + */ + BOLD: 'bold', + /** + * @property {String} BOLDITALIC + * @final + */ + BOLDITALIC: 'bold italic', + + // TYPOGRAPHY-INTERNAL + _DEFAULT_TEXT_FILL: '#000000', + _DEFAULT_LEADMULT: 1.25, + _CTX_MIDDLE: 'middle', + + // VERTICES + LINEAR: 'linear', + QUADRATIC: 'quadratic', + BEZIER: 'bezier', + CURVE: 'curve', + + // WEBGL DRAWMODES + STROKE: 'stroke', + FILL: 'fill', + TEXTURE: 'texture', + IMMEDIATE: 'immediate', + + // WEBGL TEXTURE MODE + // NORMAL already exists for typography + /** + * @property {String} IMAGE + * @final + */ + IMAGE: 'image', + + // WEBGL TEXTURE WRAP AND FILTERING + // LINEAR already exists above + NEAREST: 'nearest', + REPEAT: 'repeat', + CLAMP: 'clamp', + MIRROR: 'mirror', + + // DEVICE-ORIENTATION + /** + * @property {String} LANDSCAPE + * @final + */ + LANDSCAPE: 'landscape', + /** + * @property {String} PORTRAIT + * @final + */ + PORTRAIT: 'portrait', + + // DEFAULTS + _DEFAULT_STROKE: '#000000', + _DEFAULT_FILL: '#FFFFFF', + + /** + * @property {String} GRID + * @final + */ + GRID: 'grid', + + /** + * @property {String} AXES + * @final + */ + AXES: 'axes' +}; + +},{}],19:[function(_dereq_,module,exports){ +/** + * @module Environment + * @submodule Environment + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('./main'); +var C = _dereq_('./constants'); + +var standardCursors = [C.ARROW, C.CROSS, C.HAND, C.MOVE, C.TEXT, C.WAIT]; + +p5.prototype._frameRate = 0; +p5.prototype._lastFrameTime = window.performance.now(); +p5.prototype._targetFrameRate = 60; + +var _windowPrint = window.print; + +/** + * The print() function writes to the console area of your browser. + * This function is often helpful for looking at the data a program is + * producing. This function creates a new line of text for each call to + * the function. Individual elements can be + * separated with quotes ("") and joined with the addition operator (+). + * + * Note that calling print() without any arguments invokes the window.print() + * function which opens the browser's print dialog. To print a blank line + * to console you can write print('\n'). + * + * @method print + * @param {Any} contents any combination of Number, String, Object, Boolean, + * Array to print + * @example + *
    + * let x = 10; + * print('The value of x is ' + x); + * // prints "The value of x is 10" + *
    + * @alt + * default grey canvas + */ +p5.prototype.print = function() { + if (!arguments.length) { + _windowPrint(); + } else { + console.log.apply(console, arguments); + } +}; + +/** + * The system variable frameCount contains the number of frames that have + * been displayed since the program started. Inside setup() the value is 0, + * after the first iteration of draw it is 1, etc. + * + * @property {Integer} frameCount + * @readOnly + * @example + *
    + * function setup() { + * frameRate(30); + * textSize(30); + * textAlign(CENTER); + * } + * + * function draw() { + * background(200); + * text(frameCount, width / 2, height / 2); + * } +
    + * + * @alt + * numbers rapidly counting upward with frame count set to 30. + * + */ +p5.prototype.frameCount = 0; + +/** + * Confirms if the window a p5.js program is in is "focused," meaning that + * the sketch will accept mouse or keyboard input. This variable is + * "true" if the window is focused and "false" if not. + * + * @property {Boolean} focused + * @readOnly + * @example + *
    + * // To demonstrate, put two windows side by side. + * // Click on the window that the p5 sketch isn't in! + * function draw() { + * background(200); + * noStroke(); + * fill(0, 200, 0); + * ellipse(25, 25, 50, 50); + * + * if (!focused) { + // or "if (focused === false)" + * stroke(200, 0, 0); + * line(0, 0, 100, 100); + * line(100, 0, 0, 100); + * } + * } + *
    + * + * @alt + * green 50x50 ellipse at top left. Red X covers canvas when page focus changes + * + */ +p5.prototype.focused = document.hasFocus(); + +/** + * Sets the cursor to a predefined symbol or an image, or makes it visible + * if already hidden. If you are trying to set an image as the cursor, the + * recommended size is 16x16 or 32x32 pixels. The values for parameters x and y + * must be less than the dimensions of the image. + * + * @method cursor + * @param {String|Constant} type Built-In: either ARROW, CROSS, HAND, MOVE, TEXT and WAIT + * Native CSS properties: 'grab', 'progress', 'cell' etc. + * External: path for cursor's images + * (Allowed File extensions: .cur, .gif, .jpg, .jpeg, .png) + * For more information on Native CSS cursors and url visit: + * https://developer.mozilla.org/en-US/docs/Web/CSS/cursor + * @param {Number} [x] the horizontal active spot of the cursor (must be less than 32) + * @param {Number} [y] the vertical active spot of the cursor (must be less than 32) + * @example + *
    + * // Move the mouse across the quadrants + * // to see the cursor change + * function draw() { + * line(width / 2, 0, width / 2, height); + * line(0, height / 2, width, height / 2); + * if (mouseX < 50 && mouseY < 50) { + * cursor(CROSS); + * } else if (mouseX > 50 && mouseY < 50) { + * cursor('progress'); + * } else if (mouseX > 50 && mouseY > 50) { + * cursor('https://s3.amazonaws.com/mupublicdata/cursor.cur'); + * } else { + * cursor('grab'); + * } + * } + *
    + * + * @alt + * canvas is divided into four quadrants. cursor on first is a cross, second is a progress, + * third is a custom cursor using path to the cursor and fourth is a grab. + * + */ +p5.prototype.cursor = function(type, x, y) { + var cursor = 'auto'; + var canvas = this._curElement.elt; + if (standardCursors.indexOf(type) > -1) { + // Standard css cursor + cursor = type; + } else if (typeof type === 'string') { + var coords = ''; + if (x && y && (typeof x === 'number' && typeof y === 'number')) { + // Note that x and y values must be unit-less positive integers < 32 + // https://developer.mozilla.org/en-US/docs/Web/CSS/cursor + coords = x + ' ' + y; + } + if ( + type.substring(0, 7) === 'http://' || + type.substring(0, 8) === 'https://' + ) { + // Image (absolute url) + cursor = 'url(' + type + ') ' + coords + ', auto'; + } else if (/\.(cur|jpg|jpeg|gif|png|CUR|JPG|JPEG|GIF|PNG)$/.test(type)) { + // Image file (relative path) - Separated for performance reasons + cursor = 'url(' + type + ') ' + coords + ', auto'; + } else { + // Any valid string for the css cursor property + cursor = type; + } + } + canvas.style.cursor = cursor; +}; + +/** + * Specifies the number of frames to be displayed every second. For example, + * the function call frameRate(30) will attempt to refresh 30 times a second. + * If the processor is not fast enough to maintain the specified rate, the + * frame rate will not be achieved. Setting the frame rate within setup() is + * recommended. The default frame rate is based on the frame rate of the display + * (here also called "refresh rate"), which is set to 60 frames per second on most + * computers. A frame rate of 24 frames per second (usual for movies) or above + * will be enough for smooth animations + * This is the same as setFrameRate(val). + *

    + * Calling frameRate() with no arguments returns the current framerate. The + * draw function must run at least once before it will return a value. This + * is the same as getFrameRate(). + *

    + * Calling frameRate() with arguments that are not of the type numbers + * or are non positive also returns current framerate. + * + * @method frameRate + * @param {Number} fps number of frames to be displayed every second + * @chainable + * + * @example + * + *
    + * let rectX = 0; + * let fr = 30; //starting FPS + * let clr; + * + * function setup() { + * background(200); + * frameRate(fr); // Attempt to refresh at starting FPS + * clr = color(255, 0, 0); + * } + * + * function draw() { + * background(200); + * rectX = rectX += 1; // Move Rectangle + * + * if (rectX >= width) { + // If you go off screen. + * if (fr === 30) { + * clr = color(0, 0, 255); + * fr = 10; + * frameRate(fr); // make frameRate 10 FPS + * } else { + * clr = color(255, 0, 0); + * fr = 30; + * frameRate(fr); // make frameRate 30 FPS + * } + * rectX = 0; + * } + * fill(clr); + * rect(rectX, 40, 20, 20); + * } + *
    + * + * @alt + * blue rect moves left to right, followed by red rect moving faster. Loops. + * + */ +/** + * @method frameRate + * @return {Number} current frameRate + */ +p5.prototype.frameRate = function(fps) { + p5._validateParameters('frameRate', arguments); + if (typeof fps !== 'number' || fps < 0) { + return this._frameRate; + } else { + this._setProperty('_targetFrameRate', fps); + return this; + } +}; +/** + * Returns the current framerate. + * + * @private + * @return {Number} current frameRate + */ +p5.prototype.getFrameRate = function() { + return this.frameRate(); +}; + +/** + * Specifies the number of frames to be displayed every second. For example, + * the function call frameRate(30) will attempt to refresh 30 times a second. + * If the processor is not fast enough to maintain the specified rate, the + * frame rate will not be achieved. Setting the frame rate within setup() is + * recommended. The default rate is 60 frames per second. + * + * Calling frameRate() with no arguments returns the current framerate. + * + * @private + * @param {Number} [fps] number of frames to be displayed every second + */ +p5.prototype.setFrameRate = function(fps) { + return this.frameRate(fps); +}; + +/** + * Hides the cursor from view. + * + * @method noCursor + * @example + *
    + * function setup() { + * noCursor(); + * } + * + * function draw() { + * background(200); + * ellipse(mouseX, mouseY, 10, 10); + * } + *
    + * + * + * @alt + * cursor becomes 10x 10 white ellipse the moves with mouse x and y. + * + */ +p5.prototype.noCursor = function() { + this._curElement.elt.style.cursor = 'none'; +}; + +/** + * System variable that stores the width of the screen display according to The + * default pixelDensity. This is used to run a + * full-screen program on any display size. To return actual screen size, + * multiply this by pixelDensity. + * + * @property {Number} displayWidth + * @readOnly + * @example + *
    + * createCanvas(displayWidth, displayHeight); + *
    + * + * @alt + * cursor becomes 10x 10 white ellipse the moves with mouse x and y. + * + */ +p5.prototype.displayWidth = screen.width; + +/** + * System variable that stores the height of the screen display according to The + * default pixelDensity. This is used to run a + * full-screen program on any display size. To return actual screen size, + * multiply this by pixelDensity. + * + * @property {Number} displayHeight + * @readOnly + * @example + *
    + * createCanvas(displayWidth, displayHeight); + *
    + * + * @alt + * no display. + * + */ +p5.prototype.displayHeight = screen.height; + +/** + * System variable that stores the width of the inner window, it maps to + * window.innerWidth. + * + * @property {Number} windowWidth + * @readOnly + * @example + *
    + * createCanvas(windowWidth, windowHeight); + *
    + * + * @alt + * no display. + * + */ +p5.prototype.windowWidth = getWindowWidth(); +/** + * System variable that stores the height of the inner window, it maps to + * window.innerHeight. + * + * @property {Number} windowHeight + * @readOnly + * @example + *
    + * createCanvas(windowWidth, windowHeight); + *
    + *@alt + * no display. + * + */ +p5.prototype.windowHeight = getWindowHeight(); + +/** + * The windowResized() function is called once every time the browser window + * is resized. This is a good place to resize the canvas or do any other + * adjustments to accommodate the new window size. + * + * @method windowResized + * @example + *
    + * function setup() { + * createCanvas(windowWidth, windowHeight); + * } + * + * function draw() { + * background(0, 100, 200); + * } + * + * function windowResized() { + * resizeCanvas(windowWidth, windowHeight); + * } + *
    + * @alt + * no display. + */ +p5.prototype._onresize = function(e) { + this._setProperty('windowWidth', getWindowWidth()); + this._setProperty('windowHeight', getWindowHeight()); + var context = this._isGlobal ? window : this; + var executeDefault; + if (typeof context.windowResized === 'function') { + executeDefault = context.windowResized(e); + if (executeDefault !== undefined && !executeDefault) { + e.preventDefault(); + } + } +}; + +function getWindowWidth() { + return ( + window.innerWidth || + (document.documentElement && document.documentElement.clientWidth) || + (document.body && document.body.clientWidth) || + 0 + ); +} + +function getWindowHeight() { + return ( + window.innerHeight || + (document.documentElement && document.documentElement.clientHeight) || + (document.body && document.body.clientHeight) || + 0 + ); +} + +/** + * System variable that stores the width of the drawing canvas. This value + * is set by the first parameter of the createCanvas() function. + * For example, the function call createCanvas(320, 240) sets the width + * variable to the value 320. The value of width defaults to 100 if + * createCanvas() is not used in a program. + * + * @property {Number} width + * @readOnly + */ +p5.prototype.width = 0; + +/** + * System variable that stores the height of the drawing canvas. This value + * is set by the second parameter of the createCanvas() function. For + * example, the function call createCanvas(320, 240) sets the height + * variable to the value 240. The value of height defaults to 100 if + * createCanvas() is not used in a program. + * + * @property {Number} height + * @readOnly + */ +p5.prototype.height = 0; + +/** + * If argument is given, sets the sketch to fullscreen or not based on the + * value of the argument. If no argument is given, returns the current + * fullscreen state. Note that due to browser restrictions this can only + * be called on user input, for example, on mouse press like the example + * below. + * + * @method fullscreen + * @param {Boolean} [val] whether the sketch should be in fullscreen mode + * or not + * @return {Boolean} current fullscreen state + * @example + *
    + * + * // Clicking in the box toggles fullscreen on and off. + * function setup() { + * background(200); + * } + * function mousePressed() { + * if (mouseX > 0 && mouseX < 100 && mouseY > 0 && mouseY < 100) { + * let fs = fullscreen(); + * fullscreen(!fs); + * } + * } + * + *
    + * + * @alt + * no display. + * + */ +p5.prototype.fullscreen = function(val) { + p5._validateParameters('fullscreen', arguments); + // no arguments, return fullscreen or not + if (typeof val === 'undefined') { + return ( + document.fullscreenElement || + document.webkitFullscreenElement || + document.mozFullScreenElement || + document.msFullscreenElement + ); + } else { + // otherwise set to fullscreen or not + if (val) { + launchFullscreen(document.documentElement); + } else { + exitFullscreen(); + } + } +}; + +/** + * Sets the pixel scaling for high pixel density displays. By default + * pixel density is set to match display density, call pixelDensity(1) + * to turn this off. Calling pixelDensity() with no arguments returns + * the current pixel density of the sketch. + * + * @method pixelDensity + * @param {Number} val whether or how much the sketch should scale + * @chainable + * @example + *
    + * + * function setup() { + * pixelDensity(1); + * createCanvas(100, 100); + * background(200); + * ellipse(width / 2, height / 2, 50, 50); + * } + * + *
    + *
    + * + * function setup() { + * pixelDensity(3.0); + * createCanvas(100, 100); + * background(200); + * ellipse(width / 2, height / 2, 50, 50); + * } + * + *
    + * + * @alt + * fuzzy 50x50 white ellipse with black outline in center of canvas. + * sharp 50x50 white ellipse with black outline in center of canvas. + */ +/** + * @method pixelDensity + * @returns {Number} current pixel density of the sketch + */ +p5.prototype.pixelDensity = function(val) { + p5._validateParameters('pixelDensity', arguments); + var returnValue; + if (typeof val === 'number') { + if (val !== this._pixelDensity) { + this._pixelDensity = val; + this._pixelsDirty = true; + } + returnValue = this; + this.resizeCanvas(this.width, this.height, true); // as a side effect, it will clear the canvas + } else { + returnValue = this._pixelDensity; + } + return returnValue; +}; + +/** + * Returns the pixel density of the current display the sketch is running on. + * + * @method displayDensity + * @returns {Number} current pixel density of the display + * @example + *
    + * + * function setup() { + * let density = displayDensity(); + * pixelDensity(density); + * createCanvas(100, 100); + * background(200); + * ellipse(width / 2, height / 2, 50, 50); + * } + * + *
    + * + * @alt + * 50x50 white ellipse with black outline in center of canvas. + */ +p5.prototype.displayDensity = function() { + return window.devicePixelRatio; +}; + +function launchFullscreen(element) { + var enabled = + document.fullscreenEnabled || + document.webkitFullscreenEnabled || + document.mozFullScreenEnabled || + document.msFullscreenEnabled; + if (!enabled) { + throw new Error('Fullscreen not enabled in this browser.'); + } + if (element.requestFullscreen) { + element.requestFullscreen(); + } else if (element.mozRequestFullScreen) { + element.mozRequestFullScreen(); + } else if (element.webkitRequestFullscreen) { + element.webkitRequestFullscreen(); + } else if (element.msRequestFullscreen) { + element.msRequestFullscreen(); + } +} + +function exitFullscreen() { + if (document.exitFullscreen) { + document.exitFullscreen(); + } else if (document.mozCancelFullScreen) { + document.mozCancelFullScreen(); + } else if (document.webkitExitFullscreen) { + document.webkitExitFullscreen(); + } else if (document.msExitFullscreen) { + document.msExitFullscreen(); + } +} + +/** + * Gets the current URL. + * @method getURL + * @return {String} url + * @example + *
    + * + * let url; + * let x = 100; + * + * function setup() { + * fill(0); + * noStroke(); + * url = getURL(); + * } + * + * function draw() { + * background(200); + * text(url, x, height / 2); + * x--; + * } + * + *
    + * + * @alt + * current url (http://p5js.org/reference/#/p5/getURL) moves right to left. + * + */ +p5.prototype.getURL = function() { + return location.href; +}; +/** + * Gets the current URL path as an array. + * @method getURLPath + * @return {String[]} path components + * @example + *
    + * function setup() { + * let urlPath = getURLPath(); + * for (let i = 0; i < urlPath.length; i++) { + * text(urlPath[i], 10, i * 20 + 20); + * } + * } + *
    + * + * @alt + *no display + * + */ +p5.prototype.getURLPath = function() { + return location.pathname.split('/').filter(function(v) { + return v !== ''; + }); +}; +/** + * Gets the current URL params as an Object. + * @method getURLParams + * @return {Object} URL params + * @example + *
    + * + * // Example: http://p5js.org?year=2014&month=May&day=15 + * + * function setup() { + * let params = getURLParams(); + * text(params.day, 10, 20); + * text(params.month, 10, 40); + * text(params.year, 10, 60); + * } + * + *
    + * @alt + * no display. + * + */ +p5.prototype.getURLParams = function() { + var re = /[?&]([^&=]+)(?:[&=])([^&=]+)/gim; + var m; + var v = {}; + while ((m = re.exec(location.search)) != null) { + if (m.index === re.lastIndex) { + re.lastIndex++; + } + v[m[1]] = m[2]; + } + return v; +}; + +module.exports = p5; + +},{"./constants":18,"./main":24}],20:[function(_dereq_,module,exports){ +/** + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('./main'); +var constants = _dereq_('./constants'); + +// p5.js blue, p5.js orange, auto dark green; fallback p5.js darkened magenta +// See testColors below for all the color codes and names +var typeColors = ['#2D7BB6', '#EE9900', '#4DB200', '#C83C00']; + +if (typeof IS_MINIFIED !== 'undefined') { + p5._validateParameters = p5._friendlyFileLoadError = p5._friendlyError = function() {}; +} else { + var doFriendlyWelcome = false; // TEMP until we get it all working LM + // for parameter validation + var dataDoc = _dereq_('../../docs/reference/data.json'); + var arrDoc = JSON.parse(JSON.stringify(dataDoc)); + + // -- Borrowed from jQuery 1.11.3 -- + var class2type = {}; + var toString = class2type.toString; + var names = [ + 'Boolean', + 'Number', + 'String', + 'Function', + 'Array', + 'Date', + 'RegExp', + 'Object', + 'Error' + ]; + for (var n = 0; n < names.length; n++) { + class2type['[object ' + names[n] + ']'] = names[n].toLowerCase(); + } + var getType = function(obj) { + if (obj == null) { + return obj + ''; + } + return typeof obj === 'object' || typeof obj === 'function' + ? class2type[toString.call(obj)] || 'object' + : typeof obj; + }; + + // -- End borrow -- + + var friendlyWelcome = function() { + // p5.js brand - magenta: #ED225D + //var astrixBgColor = 'transparent'; + //var astrixTxtColor = '#ED225D'; + //var welcomeBgColor = '#ED225D'; + //var welcomeTextColor = 'white'; + console.log( + ' _ \n' + + ' /\\| |/\\ \n' + + " \\ ` ' / \n" + + ' / , . \\ \n' + + ' \\/|_|\\/ ' + + '\n\n> p5.js says: Welcome! ' + + 'This is your friendly debugger. ' + + 'To turn me off switch to using “p5.min.js”.' + ); + }; + + /** + * Prints out a fancy, colorful message to the console log + * + * @method report + * @private + * @param {String} message the words to be said + * @param {String} func the name of the function to link + * @param {Number|String} color CSS color string or error type + * + * @return console logs + */ + var report = function(message, func, color) { + if (doFriendlyWelcome) { + friendlyWelcome(); + doFriendlyWelcome = false; + } + if ('undefined' === getType(color)) { + color = '#B40033'; // dark magenta + } else if (getType(color) === 'number') { + // Type to color + color = typeColors[color]; + } + if (func === 'loadX') { + console.log('> p5.js says: ' + message); + } else if (func.substring(0, 4) === 'load') { + console.log( + '> p5.js says: ' + + message + + '[https://github.com/processing/p5.js/wiki/Local-server]' + ); + } else { + console.log( + '> p5.js says: ' + + message + + ' [http://p5js.org/reference/#p5/' + + func + + ']' + ); + } + }; + + var errorCases = { + '0': { + fileType: 'image', + method: 'loadImage', + message: ' hosting the image online,' + }, + '1': { + fileType: 'XML file', + method: 'loadXML' + }, + '2': { + fileType: 'table file', + method: 'loadTable' + }, + '3': { + fileType: 'text file', + method: 'loadStrings' + }, + '4': { + fileType: 'font', + method: 'loadFont', + message: ' hosting the font online,' + }, + '5': { + fileType: 'json', + method: 'loadJSON' + }, + '6': { + fileType: 'file', + method: 'loadBytes' + }, + '7': { + method: 'loadX', + message: + "In case your large file isn't fetched successfully," + + 'we recommend splitting the file into smaller segments and fetching those.' + } + }; + + /** + * This is called internally if there is a error during file loading. + * + * @method _friendlyFileLoadError + * @private + * @param {Number} errorType + * @param {String} filePath + */ + p5._friendlyFileLoadError = function(errorType, filePath) { + var errorInfo = errorCases[errorType]; + var message; + if (errorType === 7) { + message = errorInfo.message; + } else { + message = + 'It looks like there was a problem' + + ' loading your ' + + errorInfo.fileType + + '.' + + ' Try checking if the file path [' + + filePath + + '] is correct,' + + (errorInfo.message || '') + + ' or running a local server.'; + } + report(message, errorInfo.method, 3); + }; + + /** + * This is a generic method that can be called from anywhere in the p5 + * library to alert users to a common error. + * + * @method _friendlyError + * @private + * @param {Number} message message to be printed + * @param {String} method name of method + */ + p5._friendlyError = function(message, method) { + report(message, method); + }; + + var docCache = {}; + var builtinTypes = [ + 'null', + 'number', + 'string', + 'boolean', + 'constant', + 'function', + 'any', + 'integer' + ]; + + // validateParameters() helper functions: + // lookupParamDoc() for querying data.json + var lookupParamDoc = function(func) { + // look for the docs in the `data.json` datastructure + + var ichDot = func.lastIndexOf('.'); + var funcName = func.substr(ichDot + 1); + var funcClass = func.substr(0, ichDot) || 'p5'; + + var queryResult; + var classitems = arrDoc.classitems; + for (var ici = 0; ici < classitems.length; ici++) { + var x = classitems[ici]; + if (x.name === funcName && x.class === funcClass) { + queryResult = x; + break; + } + } + + // different JSON structure for funct with multi-format + var overloads = []; + if (queryResult.hasOwnProperty('overloads')) { + // add all the overloads + for (var i = 0; i < queryResult.overloads.length; i++) { + overloads.push({ formats: queryResult.overloads[i].params }); + } + } else { + // no overloads, just add the main method definition + overloads.push({ formats: queryResult.params || [] }); + } + + // parse the parameter types for each overload + var mapConstants = {}; + var maxParams = 0; + overloads.forEach(function(overload) { + var formats = overload.formats; + + // keep a record of the maximum number of arguments + // this method requires. + if (maxParams < formats.length) { + maxParams = formats.length; + } + + // calculate the minimum number of arguments + // this overload requires. + var minParams = formats.length; + while (minParams > 0 && formats[minParams - 1].optional) { + minParams--; + } + overload.minParams = minParams; + + // loop through each parameter position, and parse its types + formats.forEach(function(format) { + // split this parameter's types + format.types = format.type.split('|').map(function ct(type) { + // array + if (type.substr(type.length - 2, 2) === '[]') { + return { + name: type, + array: ct(type.substr(0, type.length - 2)) + }; + } + + var lowerType = type.toLowerCase(); + + // contant + if (lowerType === 'constant') { + var constant; + if (mapConstants.hasOwnProperty(format.name)) { + constant = mapConstants[format.name]; + } else { + // parse possible constant values from description + var myRe = /either\s+(?:[A-Z0-9_]+\s*,?\s*(?:or)?\s*)+/g; + var values = {}; + var names = []; + + constant = mapConstants[format.name] = { + values: values, + names: names + }; + + var myArray = myRe.exec(format.description); + if (func === 'endShape' && format.name === 'mode') { + values[constants.CLOSE] = true; + names.push('CLOSE'); + } else { + var match = myArray[0]; + var reConst = /[A-Z0-9_]+/g; + var matchConst; + while ((matchConst = reConst.exec(match)) !== null) { + var name = matchConst[0]; + if (constants.hasOwnProperty(name)) { + values[constants[name]] = true; + names.push(name); + } + } + } + } + return { + name: type, + builtin: lowerType, + names: constant.names, + values: constant.values + }; + } + + // function + if (lowerType.substr(0, 'function'.length) === 'function') { + lowerType = 'function'; + } + // builtin + if (builtinTypes.indexOf(lowerType) >= 0) { + return { name: type, builtin: lowerType }; + } + + // find type's prototype + var t = window; + var typeParts = type.split('.'); + + // special-case 'p5' since it may be non-global + if (typeParts[0] === 'p5') { + t = p5; + typeParts.shift(); + } + + typeParts.forEach(function(p) { + t = t && t[p]; + }); + if (t) { + return { name: type, prototype: t }; + } + + return { name: type, type: lowerType }; + }); + }); + }); + return { + overloads: overloads, + maxParams: maxParams + }; + }; + + var isNumber = function(param) { + switch (typeof param) { + case 'number': + return true; + case 'string': + return !isNaN(param); + default: + return false; + } + }; + + var testParamType = function(param, type) { + var isArray = param instanceof Array; + var matches = true; + if (type.array && isArray) { + for (var i = 0; i < param.length; i++) { + var error = testParamType(param[i], type.array); + if (error) return error / 2; // half error for elements + } + } else if (type.prototype) { + matches = param instanceof type.prototype; + } else if (type.builtin) { + switch (type.builtin) { + case 'number': + matches = isNumber(param); + break; + case 'integer': + matches = isNumber(param) && Number(param) === Math.floor(param); + break; + case 'boolean': + case 'any': + matches = true; + break; + case 'array': + matches = isArray; + break; + case 'string': + matches = /*typeof param === 'number' ||*/ typeof param === 'string'; + break; + case 'constant': + matches = type.values.hasOwnProperty(param); + break; + case 'function': + matches = param instanceof Function; + break; + case 'null': + matches = param === null; + break; + } + } else { + matches = typeof param === type.t; + } + return matches ? 0 : 1; + }; + + // testType() for non-object type parameter validation + var testParamTypes = function(param, types) { + var minScore = 9999; + for (var i = 0; minScore > 0 && i < types.length; i++) { + var score = testParamType(param, types[i]); + if (minScore > score) minScore = score; + } + return minScore; + }; + + // generate a score (higher is worse) for applying these args to + // this overload. + var scoreOverload = function(args, argCount, overload, minScore) { + var score = 0; + var formats = overload.formats; + var minParams = overload.minParams; + + // check for too few/many args + // the score is double number of extra/missing args + if (argCount < minParams) { + score = (minParams - argCount) * 2; + } else if (argCount > formats.length) { + score = (argCount - formats.length) * 2; + } + + // loop through the formats, adding up the error score for each arg. + // quit early if the score gets higher than the previous best overload. + for (var p = 0; score <= minScore && p < formats.length; p++) { + var arg = args[p]; + var format = formats[p]; + // '== null' checks for 'null' and typeof 'undefined' + if (arg == null) { + // handle non-optional and non-trailing undefined args + if (!format.optional || p < minParams || p < argCount) { + score += 1; + } + } else { + score += testParamTypes(arg, format.types); + } + } + return score; + }; + + // gets a list of errors for this overload + var getOverloadErrors = function(args, argCount, overload) { + var formats = overload.formats; + var minParams = overload.minParams; + + // check for too few/many args + if (argCount < minParams) { + return [ + { + type: 'TOO_FEW_ARGUMENTS', + argCount: argCount, + minParams: minParams + } + ]; + } else if (argCount > formats.length) { + return [ + { + type: 'TOO_MANY_ARGUMENTS', + argCount: argCount, + maxParams: formats.length + } + ]; + } + + var errorArray = []; + for (var p = 0; p < formats.length; p++) { + var arg = args[p]; + var format = formats[p]; + // '== null' checks for 'null' and typeof 'undefined' + if (arg == null) { + // handle non-optional and non-trailing undefined args + if (!format.optional || p < minParams || p < argCount) { + errorArray.push({ + type: 'EMPTY_VAR', + position: p, + format: format + }); + } + } else if (testParamTypes(arg, format.types) > 0) { + errorArray.push({ + type: 'WRONG_TYPE', + position: p, + format: format, + arg: arg + }); + } + } + + return errorArray; + }; + + // a custom error type, used by the mocha + // tests when expecting validation errors + p5.ValidationError = (function(name) { + var err = function(message, func) { + this.message = message; + this.func = func; + if ('captureStackTrace' in Error) Error.captureStackTrace(this, err); + else this.stack = new Error().stack; + }; + err.prototype = Object.create(Error.prototype); + err.prototype.name = name; + err.prototype.constructor = err; + return err; + })('ValidationError'); + + // function for generating console.log() msg + p5._friendlyParamError = function(errorObj, func) { + var message; + + function formatType() { + var format = errorObj.format; + return format.types + .map(function(type) { + return type.names ? type.names.join('|') : type.name; + }) + .join('|'); + } + + switch (errorObj.type) { + case 'EMPTY_VAR': + message = + func + + '() was expecting ' + + formatType() + + ' for parameter #' + + errorObj.position + + ' (zero-based index), received an empty variable instead.' + + ' If not intentional, this is often a problem with scope:' + + ' [https://p5js.org/examples/data-variable-scope.html]'; + break; + case 'WRONG_TYPE': + var arg = errorObj.arg; + var argType = + arg instanceof Array + ? 'array' + : arg === null ? 'null' : arg.name || typeof arg; + message = + func + + '() was expecting ' + + formatType() + + ' for parameter #' + + errorObj.position + + ' (zero-based index), received ' + + argType + + ' instead'; + break; + case 'TOO_FEW_ARGUMENTS': + message = + func + + '() was expecting at least ' + + errorObj.minParams + + ' arguments, but received only ' + + errorObj.argCount; + break; + case 'TOO_MANY_ARGUMENTS': + message = + func + + '() was expecting no more than ' + + errorObj.maxParams + + ' arguments, but received ' + + errorObj.argCount; + break; + } + + if (message) { + if (p5._throwValidationErrors) { + throw new p5.ValidationError(message); + } + + try { + var re = /Function\.validateParameters.*[\r\n].*[\r\n].*\(([^)]*)/; + var location = re.exec(new Error().stack)[1]; + if (location) { + message += ' at ' + location; + } + } catch (err) {} + + report(message + '.', func, 3); + } + }; + + /** + * Validates parameters + * param {String} func the name of the function + * param {Array} args user input arguments + * + * example: + * var a; + * ellipse(10,10,a,5); + * console ouput: + * "It looks like ellipse received an empty variable in spot #2." + * + * example: + * ellipse(10,"foo",5,5); + * console output: + * "ellipse was expecting a number for parameter #1, + * received "foo" instead." + */ + p5._validateParameters = function validateParameters(func, args) { + if (p5.disableFriendlyErrors) { + return; // skip FES + } + + // lookup the docs in the 'data.json' file + var docs = docCache[func] || (docCache[func] = lookupParamDoc(func)); + var overloads = docs.overloads; + + // ignore any trailing `undefined` arguments + var argCount = args.length; + // '== null' checks for 'null' and typeof 'undefined' + while (argCount > 0 && args[argCount - 1] == null) argCount--; + + // find the overload with the best score + var minScore = 99999; + var minOverload; + for (var i = 0; i < overloads.length; i++) { + var score = scoreOverload(args, argCount, overloads[i], minScore); + if (score === 0) { + return; // done! + } else if (minScore > score) { + // this score is better that what we have so far... + minScore = score; + minOverload = i; + } + } + + // this should _always_ be true here... + if (minScore > 0) { + // get the errors for the best overload + var errorArray = getOverloadErrors( + args, + argCount, + overloads[minOverload] + ); + + // generate err msg + for (var n = 0; n < errorArray.length; n++) { + p5._friendlyParamError(errorArray[n], func); + } + } + }; + + /** + * Prints out all the colors in the color pallete with white text. + * For color blindness testing. + */ + /* function testColors() { + var str = 'A box of biscuits, a box of mixed biscuits and a biscuit mixer'; + report(str, 'print', '#ED225D'); // p5.js magenta + report(str, 'print', '#2D7BB6'); // p5.js blue + report(str, 'print', '#EE9900'); // p5.js orange + report(str, 'print', '#A67F59'); // p5.js light brown + report(str, 'print', '#704F21'); // p5.js gold + report(str, 'print', '#1CC581'); // auto cyan + report(str, 'print', '#FF6625'); // auto orange + report(str, 'print', '#79EB22'); // auto green + report(str, 'print', '#B40033'); // p5.js darkened magenta + report(str, 'print', '#084B7F'); // p5.js darkened blue + report(str, 'print', '#945F00'); // p5.js darkened orange + report(str, 'print', '#6B441D'); // p5.js darkened brown + report(str, 'print', '#2E1B00'); // p5.js darkened gold + report(str, 'print', '#008851'); // auto dark cyan + report(str, 'print', '#C83C00'); // auto dark orange + report(str, 'print', '#4DB200'); // auto dark green + } */ + + p5.prototype._validateParameters = p5.validateParameters; +} + +// This is a lazily-defined list of p5 symbols that may be +// misused by beginners at top-level code, outside of setup/draw. We'd like +// to detect these errors and help the user by suggesting they move them +// into setup/draw. +// +// For more details, see https://github.com/processing/p5.js/issues/1121. +var misusedAtTopLevelCode = null; +var FAQ_URL = + 'https://github.com/processing/p5.js/wiki/p5.js-overview' + + '#why-cant-i-assign-variables-using-p5-functions-and-' + + 'variables-before-setup'; + +var defineMisusedAtTopLevelCode = function() { + var uniqueNamesFound = {}; + + var getSymbols = function(obj) { + return Object.getOwnPropertyNames(obj) + .filter(function(name) { + if (name[0] === '_') { + return false; + } + if (name in uniqueNamesFound) { + return false; + } + + uniqueNamesFound[name] = true; + + return true; + }) + .map(function(name) { + var type; + + if (typeof obj[name] === 'function') { + type = 'function'; + } else if (name === name.toUpperCase()) { + type = 'constant'; + } else { + type = 'variable'; + } + + return { name: name, type: type }; + }); + }; + + misusedAtTopLevelCode = [].concat( + getSymbols(p5.prototype), + // At present, p5 only adds its constants to p5.prototype during + // construction, which may not have happened at the time a + // ReferenceError is thrown, so we'll manually add them to our list. + getSymbols(_dereq_('./constants')) + ); + + // This will ultimately ensure that we report the most specific error + // possible to the user, e.g. advising them about HALF_PI instead of PI + // when their code misuses the former. + misusedAtTopLevelCode.sort(function(a, b) { + return b.name.length - a.name.length; + }); +}; + +var helpForMisusedAtTopLevelCode = function(e, log) { + if (!log) { + log = console.log.bind(console); + } + + if (!misusedAtTopLevelCode) { + defineMisusedAtTopLevelCode(); + } + + // If we find that we're logging lots of false positives, we can + // uncomment the following code to avoid displaying anything if the + // user's code isn't likely to be using p5's global mode. (Note that + // setup/draw are more likely to be defined due to JS function hoisting.) + // + //if (!('setup' in window || 'draw' in window)) { + // return; + //} + + misusedAtTopLevelCode.some(function(symbol) { + // Note that while just checking for the occurrence of the + // symbol name in the error message could result in false positives, + // a more rigorous test is difficult because different browsers + // log different messages, and the format of those messages may + // change over time. + // + // For example, if the user uses 'PI' in their code, it may result + // in any one of the following messages: + // + // * 'PI' is undefined (Microsoft Edge) + // * ReferenceError: PI is undefined (Firefox) + // * Uncaught ReferenceError: PI is not defined (Chrome) + + if (e.message && e.message.match('\\W?' + symbol.name + '\\W') !== null) { + log( + "Did you just try to use p5.js's " + + symbol.name + + (symbol.type === 'function' ? '() ' : ' ') + + symbol.type + + '? If so, you may want to ' + + "move it into your sketch's setup() function.\n\n" + + 'For more details, see: ' + + FAQ_URL + ); + return true; + } + }); +}; + +// Exposing this primarily for unit testing. +p5.prototype._helpForMisusedAtTopLevelCode = helpForMisusedAtTopLevelCode; + +if (document.readyState !== 'complete') { + window.addEventListener('error', helpForMisusedAtTopLevelCode, false); + + // Our job is only to catch ReferenceErrors that are thrown when + // global (non-instance mode) p5 APIs are used at the top-level + // scope of a file, so we'll unbind our error listener now to make + // sure we don't log false positives later. + window.addEventListener('load', function() { + window.removeEventListener('error', helpForMisusedAtTopLevelCode, false); + }); +} + +module.exports = p5; + +},{"../../docs/reference/data.json":1,"./constants":18,"./main":24}],21:[function(_dereq_,module,exports){ +/** + * @requires constants + */ + +'use strict'; + +var constants = _dereq_('./constants'); + +module.exports = { + modeAdjust: function(a, b, c, d, mode) { + if (mode === constants.CORNER) { + return { x: a, y: b, w: c, h: d }; + } else if (mode === constants.CORNERS) { + return { x: a, y: b, w: c - a, h: d - b }; + } else if (mode === constants.RADIUS) { + return { x: a - c, y: b - d, w: 2 * c, h: 2 * d }; + } else if (mode === constants.CENTER) { + return { x: a - c * 0.5, y: b - d * 0.5, w: c, h: d }; + } + } +}; + +},{"./constants":18}],22:[function(_dereq_,module,exports){ +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * _globalInit + * + * TODO: ??? + * if sketch is on window + * assume "global" mode + * and instantiate p5 automatically + * otherwise do nothing + * + * @private + * @return {Undefined} + */ +var _globalInit = function() { + if (!window.mocha) { + // If there is a setup or draw function on the window + // then instantiate p5 in "global" mode + if ( + ((window.setup && typeof window.setup === 'function') || + (window.draw && typeof window.draw === 'function')) && + !p5.instance + ) { + new p5(); + } + } +}; + +// TODO: ??? + +// if the page is ready, initialize p5 immediately +if (document.readyState === 'complete') { + _globalInit(); + // if the page is still loading, add an event listener + // and initialize p5 as soon as it finishes loading +} else { + window.addEventListener('load', _globalInit, false); +} + +},{"../core/main":24}],23:[function(_dereq_,module,exports){ +/** + * @for p5 + * @requires core + * These are functions that are part of the Processing API but are not part of + * the p5.js API. In some cases they have a new name, in others, they are + * removed completely. Not all unsupported Processing functions are listed here + * but we try to include ones that a user coming from Processing might likely + * call. + */ + +'use strict'; + +var p5 = _dereq_('./main'); + +p5.prototype.pushStyle = function() { + throw new Error('pushStyle() not used, see push()'); +}; + +p5.prototype.popStyle = function() { + throw new Error('popStyle() not used, see pop()'); +}; + +p5.prototype.popMatrix = function() { + throw new Error('popMatrix() not used, see pop()'); +}; + +p5.prototype.printMatrix = function() { + throw new Error( + 'printMatrix() is not implemented in p5.js, ' + + 'refer to [https://simonsarris.com/a-transformation-class-for-canvas-to-keep-track-of-the-transformation-matrix/] ' + + 'to add your own implementation.' + ); +}; + +p5.prototype.pushMatrix = function() { + throw new Error('pushMatrix() not used, see push()'); +}; + +module.exports = p5; + +},{"./main":24}],24:[function(_dereq_,module,exports){ +/** + * @module Structure + * @submodule Structure + * @for p5 + * @requires constants + */ + +'use strict'; + +_dereq_('./shim'); + +// Core needs the PVariables object +var constants = _dereq_('./constants'); + +/** + * This is the p5 instance constructor. + * + * A p5 instance holds all the properties and methods related to + * a p5 sketch. It expects an incoming sketch closure and it can also + * take an optional node parameter for attaching the generated p5 canvas + * to a node. The sketch closure takes the newly created p5 instance as + * its sole argument and may optionally set preload(), setup(), and/or + * draw() properties on it for running a sketch. + * + * A p5 sketch can run in "global" or "instance" mode: + * "global" - all properties and methods are attached to the window + * "instance" - all properties and methods are bound to this p5 object + * + * @class p5 + * @constructor + * @param {function} sketch a closure that can set optional preload(), + * setup(), and/or draw() properties on the + * given p5 instance + * @param {HTMLElement|Boolean} [node] element to attach canvas to, if a + * boolean is passed in use it as sync + * @param {Boolean} [sync] start synchronously (optional) + * @return {p5} a p5 instance + */ +var p5 = function(sketch, node, sync) { + if (typeof node === 'boolean' && typeof sync === 'undefined') { + sync = node; + node = undefined; + } + + ////////////////////////////////////////////// + // PUBLIC p5 PROPERTIES AND METHODS + ////////////////////////////////////////////// + + /** + * Called directly before setup(), the preload() function is used to handle + * asynchronous loading of external files in a blocking way. If a preload + * function is defined, setup() will wait until any load calls within have + * finished. Nothing besides load calls (loadImage, loadJSON, loadFont, + * loadStrings, etc.) should be inside the preload function. If asynchronous + * loading is preferred, the load methods can instead be called in setup() + * or anywhere else with the use of a callback parameter. + *

    + * By default the text "loading..." will be displayed. To make your own + * loading page, include an HTML element with id "p5_loading" in your + * page. More information here. + * + * @method preload + * @example + *
    + * let img; + * let c; + * function preload() { + * // preload() runs once + * img = loadImage('assets/laDefense.jpg'); + * } + * + * function setup() { + * // setup() waits until preload() is done + * img.loadPixels(); + * // get color of middle pixel + * c = img.get(img.width / 2, img.height / 2); + * } + * + * function draw() { + * background(c); + * image(img, 25, 25, 50, 50); + * } + *
    + * + * @alt + * nothing displayed + * + */ + + /** + * The setup() function is called once when the program starts. It's used to + * define initial environment properties such as screen size and background + * color and to load media such as images and fonts as the program starts. + * There can only be one setup() function for each program and it shouldn't + * be called again after its initial execution. + *

    + * Note: Variables declared within setup() are not accessible within other + * functions, including draw(). + * + * @method setup + * @example + *
    + * let a = 0; + * + * function setup() { + * background(0); + * noStroke(); + * fill(102); + * } + * + * function draw() { + * rect(a++ % width, 10, 2, 80); + * } + *
    + * + * @alt + * nothing displayed + * + */ + + /** + * Called directly after setup(), the draw() function continuously executes + * the lines of code contained inside its block until the program is stopped + * or noLoop() is called. Note if noLoop() is called in setup(), draw() will + * still be executed once before stopping. draw() is called automatically and + * should never be called explicitly. + *

    + * It should always be controlled with noLoop(), redraw() and loop(). After + * noLoop() stops the code in draw() from executing, redraw() causes the + * code inside draw() to execute once, and loop() will cause the code + * inside draw() to resume executing continuously. + *

    + * The number of times draw() executes in each second may be controlled with + * the frameRate() function. + *

    + * There can only be one draw() function for each sketch, and draw() must + * exist if you want the code to run continuously, or to process events such + * as mousePressed(). Sometimes, you might have an empty call to draw() in + * your program, as shown in the above example. + *

    + * It is important to note that the drawing coordinate system will be reset + * at the beginning of each draw() call. If any transformations are performed + * within draw() (ex: scale, rotate, translate), their effects will be + * undone at the beginning of draw(), so transformations will not accumulate + * over time. On the other hand, styling applied (ex: fill, stroke, etc) will + * remain in effect. + * + * @method draw + * @example + *
    + * let yPos = 0; + * function setup() { + * // setup() runs once + * frameRate(30); + * } + * function draw() { + * // draw() loops forever, until stopped + * background(204); + * yPos = yPos - 1; + * if (yPos < 0) { + * yPos = height; + * } + * line(0, yPos, width, yPos); + * } + *
    + * + * @alt + * nothing displayed + * + */ + + ////////////////////////////////////////////// + // PRIVATE p5 PROPERTIES AND METHODS + ////////////////////////////////////////////// + + this._setupDone = false; + // for handling hidpi + this._pixelDensity = Math.ceil(window.devicePixelRatio) || 1; + this._userNode = node; + this._curElement = null; + this._elements = []; + this._glAttributes = null; + this._requestAnimId = 0; + this._preloadCount = 0; + this._isGlobal = false; + this._loop = true; + this._initializeInstanceVariables(); + this._defaultCanvasSize = { + width: 100, + height: 100 + }; + this._events = { + // keep track of user-events for unregistering later + mousemove: null, + mousedown: null, + mouseup: null, + dragend: null, + dragover: null, + click: null, + dblclick: null, + mouseover: null, + mouseout: null, + keydown: null, + keyup: null, + keypress: null, + touchstart: null, + touchmove: null, + touchend: null, + resize: null, + blur: null + }; + + this._events.wheel = null; + this._loadingScreenId = 'p5_loading'; + + // Allows methods to be registered on an instance that + // are instance-specific. + this._registeredMethods = {}; + var methods = Object.getOwnPropertyNames(p5.prototype._registeredMethods); + for (var i = 0; i < methods.length; i++) { + var prop = methods[i]; + this._registeredMethods[prop] = p5.prototype._registeredMethods[ + prop + ].slice(); + } + + if (window.DeviceOrientationEvent) { + this._events.deviceorientation = null; + } + if (window.DeviceMotionEvent && !window._isNodeWebkit) { + this._events.devicemotion = null; + } + + this._start = function() { + // Find node if id given + if (this._userNode) { + if (typeof this._userNode === 'string') { + this._userNode = document.getElementById(this._userNode); + } + } + + var context = this._isGlobal ? window : this; + var userPreload = context.preload; + if (userPreload) { + // Setup loading screen + // Set loading screen into dom if not present + // Otherwise displays and removes user provided loading screen + var loadingScreen = document.getElementById(this._loadingScreenId); + if (!loadingScreen) { + loadingScreen = document.createElement('div'); + loadingScreen.innerHTML = 'Loading...'; + loadingScreen.style.position = 'absolute'; + loadingScreen.id = this._loadingScreenId; + var node = this._userNode || document.body; + node.appendChild(loadingScreen); + } + var methods = this._preloadMethods; + for (var method in methods) { + // default to p5 if no object defined + methods[method] = methods[method] || p5; + var obj = methods[method]; + //it's p5, check if it's global or instance + if (obj === p5.prototype || obj === p5) { + if (this._isGlobal) { + window[method] = this._wrapPreload(this, method); + } + obj = this; + } + this._registeredPreloadMethods[method] = obj[method]; + obj[method] = this._wrapPreload(obj, method); + } + + userPreload(); + this._runIfPreloadsAreDone(); + } else { + this._setup(); + this._draw(); + } + }.bind(this); + + this._runIfPreloadsAreDone = function() { + var context = this._isGlobal ? window : this; + if (context._preloadCount === 0) { + var loadingScreen = document.getElementById(context._loadingScreenId); + if (loadingScreen) { + loadingScreen.parentNode.removeChild(loadingScreen); + } + context._setup(); + context._draw(); + } + }; + + this._decrementPreload = function() { + var context = this._isGlobal ? window : this; + if (typeof context.preload === 'function') { + context._setProperty('_preloadCount', context._preloadCount - 1); + context._runIfPreloadsAreDone(); + } + }; + + this._wrapPreload = function(obj, fnName) { + return function() { + //increment counter + this._incrementPreload(); + //call original function + return this._registeredPreloadMethods[fnName].apply(obj, arguments); + }.bind(this); + }; + + this._incrementPreload = function() { + var context = this._isGlobal ? window : this; + context._setProperty('_preloadCount', context._preloadCount + 1); + }; + + this._setup = function() { + // Always create a default canvas. + // Later on if the user calls createCanvas, this default one + // will be replaced + this.createCanvas( + this._defaultCanvasSize.width, + this._defaultCanvasSize.height, + 'p2d' + ); + + // return preload functions to their normal vals if switched by preload + var context = this._isGlobal ? window : this; + if (typeof context.preload === 'function') { + for (var f in this._preloadMethods) { + context[f] = this._preloadMethods[f][f]; + if (context[f] && this) { + context[f] = context[f].bind(this); + } + } + } + + // Short-circuit on this, in case someone used the library in "global" + // mode earlier + if (typeof context.setup === 'function') { + context.setup(); + } + + // unhide any hidden canvases that were created + var canvases = document.getElementsByTagName('canvas'); + for (var i = 0; i < canvases.length; i++) { + var k = canvases[i]; + if (k.dataset.hidden === 'true') { + k.style.visibility = ''; + delete k.dataset.hidden; + } + } + this._setupDone = true; + }.bind(this); + + this._draw = function() { + var now = window.performance.now(); + var time_since_last = now - this._lastFrameTime; + var target_time_between_frames = 1000 / this._targetFrameRate; + + // only draw if we really need to; don't overextend the browser. + // draw if we're within 5ms of when our next frame should paint + // (this will prevent us from giving up opportunities to draw + // again when it's really about time for us to do so). fixes an + // issue where the frameRate is too low if our refresh loop isn't + // in sync with the browser. note that we have to draw once even + // if looping is off, so we bypass the time delay if that + // is the case. + var epsilon = 5; + if ( + !this._loop || + time_since_last >= target_time_between_frames - epsilon + ) { + //mandatory update values(matrixs and stack) + + this.redraw(); + this._frameRate = 1000.0 / (now - this._lastFrameTime); + this._lastFrameTime = now; + + // If the user is actually using mouse module, then update + // coordinates, otherwise skip. We can test this by simply + // checking if any of the mouse functions are available or not. + // NOTE : This reflects only in complete build or modular build. + if (typeof this._updateMouseCoords !== 'undefined') { + this._updateMouseCoords(); + } + } + + // get notified the next time the browser gives us + // an opportunity to draw. + if (this._loop) { + this._requestAnimId = window.requestAnimationFrame(this._draw); + } + }.bind(this); + + this._setProperty = function(prop, value) { + this[prop] = value; + if (this._isGlobal) { + window[prop] = value; + } + }.bind(this); + + /** + * Removes the entire p5 sketch. This will remove the canvas and any + * elements created by p5.js. It will also stop the draw loop and unbind + * any properties or methods from the window global scope. It will + * leave a variable p5 in case you wanted to create a new p5 sketch. + * If you like, you can set p5 = null to erase it. While all functions and + * variables and objects created by the p5 library will be removed, any + * other global variables created by your code will remain. + * + * @method remove + * @example + *
    + * function draw() { + * ellipse(50, 50, 10, 10); + * } + * + * function mousePressed() { + * remove(); // remove whole sketch on mouse press + * } + *
    + * + * @alt + * nothing displayed + * + */ + this.remove = function() { + var loadingScreen = document.getElementById(this._loadingScreenId); + if (loadingScreen) { + loadingScreen.parentNode.removeChild(loadingScreen); + // Add 1 to preload counter to prevent the sketch ever executing setup() + this._incrementPreload(); + } + if (this._curElement) { + // stop draw + this._loop = false; + if (this._requestAnimId) { + window.cancelAnimationFrame(this._requestAnimId); + } + + // unregister events sketch-wide + for (var ev in this._events) { + window.removeEventListener(ev, this._events[ev]); + } + + // remove DOM elements created by p5, and listeners + for (var i = 0; i < this._elements.length; i++) { + var e = this._elements[i]; + if (e.elt.parentNode) { + e.elt.parentNode.removeChild(e.elt); + } + for (var elt_ev in e._events) { + e.elt.removeEventListener(elt_ev, e._events[elt_ev]); + } + } + + // call any registered remove functions + var self = this; + this._registeredMethods.remove.forEach(function(f) { + if (typeof f !== 'undefined') { + f.call(self); + } + }); + } + // remove window bound properties and methods + if (this._isGlobal) { + for (var p in p5.prototype) { + try { + delete window[p]; + } catch (x) { + window[p] = undefined; + } + } + for (var p2 in this) { + if (this.hasOwnProperty(p2)) { + try { + delete window[p2]; + } catch (x) { + window[p2] = undefined; + } + } + } + p5.instance = null; + } + }.bind(this); + + // call any registered init functions + this._registeredMethods.init.forEach(function(f) { + if (typeof f !== 'undefined') { + f.call(this); + } + }, this); + + var friendlyBindGlobal = this._createFriendlyGlobalFunctionBinder(); + + // If the user has created a global setup or draw function, + // assume "global" mode and make everything global (i.e. on the window) + if (!sketch) { + this._isGlobal = true; + p5.instance = this; + // Loop through methods on the prototype and attach them to the window + for (var p in p5.prototype) { + if (typeof p5.prototype[p] === 'function') { + var ev = p.substring(2); + if (!this._events.hasOwnProperty(ev)) { + if (Math.hasOwnProperty(p) && Math[p] === p5.prototype[p]) { + // Multiple p5 methods are just native Math functions. These can be + // called without any binding. + friendlyBindGlobal(p, p5.prototype[p]); + } else { + friendlyBindGlobal(p, p5.prototype[p].bind(this)); + } + } + } else { + friendlyBindGlobal(p, p5.prototype[p]); + } + } + // Attach its properties to the window + for (var p2 in this) { + if (this.hasOwnProperty(p2)) { + friendlyBindGlobal(p2, this[p2]); + } + } + } else { + // Else, the user has passed in a sketch closure that may set + // user-provided 'setup', 'draw', etc. properties on this instance of p5 + sketch(this); + } + + // Bind events to window (not using container div bc key events don't work) + + for (var e in this._events) { + var f = this['_on' + e]; + if (f) { + var m = f.bind(this); + window.addEventListener(e, m, { passive: false }); + this._events[e] = m; + } + } + + var focusHandler = function() { + this._setProperty('focused', true); + }.bind(this); + var blurHandler = function() { + this._setProperty('focused', false); + }.bind(this); + window.addEventListener('focus', focusHandler); + window.addEventListener('blur', blurHandler); + this.registerMethod('remove', function() { + window.removeEventListener('focus', focusHandler); + window.removeEventListener('blur', blurHandler); + }); + + if (sync) { + this._start(); + } else { + if (document.readyState === 'complete') { + this._start(); + } else { + window.addEventListener('load', this._start.bind(this), false); + } + } +}; + +p5.prototype._initializeInstanceVariables = function() { + this._styles = []; + + this._bezierDetail = 20; + this._curveDetail = 20; + + this._colorMode = constants.RGB; + this._colorMaxes = { + rgb: [255, 255, 255, 255], + hsb: [360, 100, 100, 1], + hsl: [360, 100, 100, 1] + }; + + this._pixelsDirty = true; + + this._downKeys = {}; //Holds the key codes of currently pressed keys +}; + +// This is a pointer to our global mode p5 instance, if we're in +// global mode. +p5.instance = null; + +/** + * Allows for the friendly error system (FES) to be turned off when creating a sketch, + * which can give a significant boost to performance when needed. + * See + * disabling the friendly error system. + * + * @property {Boolean} disableFriendlyErrors + * @example + *
    + * p5.disableFriendlyErrors = true; + * + * function setup() { + * createCanvas(100, 50); + * } + *
    + */ +p5.disableFriendlyErrors = false; + +// attach constants to p5 prototype +for (var k in constants) { + p5.prototype[k] = constants[k]; +} + +// functions that cause preload to wait +// more can be added by using registerPreloadMethod(func) +p5.prototype._preloadMethods = { + loadJSON: p5.prototype, + loadImage: p5.prototype, + loadStrings: p5.prototype, + loadXML: p5.prototype, + loadBytes: p5.prototype, + loadTable: p5.prototype, + loadFont: p5.prototype, + loadModel: p5.prototype, + loadShader: p5.prototype +}; + +p5.prototype._registeredMethods = { init: [], pre: [], post: [], remove: [] }; + +p5.prototype._registeredPreloadMethods = {}; + +p5.prototype.registerPreloadMethod = function(fnString, obj) { + // obj = obj || p5.prototype; + if (!p5.prototype._preloadMethods.hasOwnProperty(fnString)) { + p5.prototype._preloadMethods[fnString] = obj; + } +}; + +p5.prototype.registerMethod = function(name, m) { + var target = this || p5.prototype; + if (!target._registeredMethods.hasOwnProperty(name)) { + target._registeredMethods[name] = []; + } + target._registeredMethods[name].push(m); +}; + +// create a function which provides a standardized process for binding +// globals; this is implemented as a factory primarily so that there's a +// way to redefine what "global" means for the binding function so it +// can be used in scenarios like unit testing where the window object +// might not exist +p5.prototype._createFriendlyGlobalFunctionBinder = function(options) { + options = options || {}; + + var globalObject = options.globalObject || window; + var log = options.log || console.log.bind(console); + var propsToForciblyOverwrite = { + // p5.print actually always overwrites an existing global function, + // albeit one that is very unlikely to be used: + // + // https://developer.mozilla.org/en-US/docs/Web/API/Window/print + print: true + }; + + return function(prop, value) { + if ( + !p5.disableFriendlyErrors && + typeof IS_MINIFIED === 'undefined' && + typeof value === 'function' && + !(prop in p5.prototype._preloadMethods) + ) { + try { + // Because p5 has so many common function names, it's likely + // that users may accidentally overwrite global p5 functions with + // their own variables. Let's allow this but log a warning to + // help users who may be doing this unintentionally. + // + // For more information, see: + // + // https://github.com/processing/p5.js/issues/1317 + + if (prop in globalObject && !(prop in propsToForciblyOverwrite)) { + throw new Error('global "' + prop + '" already exists'); + } + + // It's possible that this might throw an error because there + // are a lot of edge-cases in which `Object.defineProperty` might + // not succeed; since this functionality is only intended to + // help beginners anyways, we'll just catch such an exception + // if it occurs, and fall back to legacy behavior. + Object.defineProperty(globalObject, prop, { + configurable: true, + enumerable: true, + get: function() { + return value; + }, + set: function(newValue) { + Object.defineProperty(globalObject, prop, { + configurable: true, + enumerable: true, + value: newValue, + writable: true + }); + log( + 'You just changed the value of "' + + prop + + '", which was ' + + "a p5 function. This could cause problems later if you're " + + 'not careful.' + ); + } + }); + } catch (e) { + log( + 'p5 had problems creating the global function "' + + prop + + '", ' + + 'possibly because your code is already using that name as ' + + 'a variable. You may want to rename your variable to something ' + + 'else.' + ); + globalObject[prop] = value; + } + } else { + globalObject[prop] = value; + } + }; +}; + +module.exports = p5; + +},{"./constants":18,"./shim":34}],25:[function(_dereq_,module,exports){ +/** + * @module DOM + * @submodule DOM + * @for p5.Element + */ + +'use strict'; + +var p5 = _dereq_('./main'); + +/** + * Base class for all elements added to a sketch, including canvas, + * graphics buffers, and other HTML elements. Methods in blue are + * included in the core functionality, methods in brown are added + * with the p5.dom + * library. + * It is not called directly, but p5.Element + * objects are created by calling createCanvas, createGraphics, + * or in the p5.dom library, createDiv, createImg, createInput, etc. + * + * @class p5.Element + * @param {String} elt DOM node that is wrapped + * @param {p5} [pInst] pointer to p5 instance + */ +p5.Element = function(elt, pInst) { + /** + * Underlying HTML element. All normal HTML methods can be called on this. + * @example + *
    + * + * function setup() { + * let c = createCanvas(50, 50); + * c.elt.style.border = '5px solid red'; + * } + * + * function draw() { + * background(220); + * } + * + *
    + * + * @property elt + * @readOnly + */ + this.elt = elt; + this._pInst = this._pixelsState = pInst; + this._events = {}; + this.width = this.elt.offsetWidth; + this.height = this.elt.offsetHeight; +}; + +/** + * + * Attaches the element to the parent specified. A way of setting + * the container for the element. Accepts either a string ID, DOM + * node, or p5.Element. If no arguments given, parent node is returned. + * For more ways to position the canvas, see the + * + * positioning the canvas wiki page. + * + * All above examples except for the first one require the inclusion of + * the p5.dom library in your index.html. See the + * using a library + * section for information on how to include this library. + * + * @method parent + * @param {String|p5.Element|Object} parent the ID, DOM node, or p5.Element + * of desired parent element + * @chainable + * + * @example + *
    + * // in the html file: + * // <div id="myContainer"></div> + * + * // in the js file: + * let cnv = createCanvas(100, 100); + * cnv.parent('myContainer'); + *
    + *
    + * let div0 = createDiv('this is the parent'); + * let div1 = createDiv('this is the child'); + * div1.parent(div0); // use p5.Element + *
    + *
    + * let div0 = createDiv('this is the parent'); + * div0.id('apples'); + * let div1 = createDiv('this is the child'); + * div1.parent('apples'); // use id + *
    + *
    + * let elt = document.getElementById('myParentDiv'); + * let div1 = createDiv('this is the child'); + * div1.parent(elt); // use element from page + *
    + * + * @alt + * no display. + */ +/** + * @method parent + * @return {p5.Element} + * + */ +p5.Element.prototype.parent = function(p) { + if (typeof p === 'undefined') { + return this.elt.parentNode; + } + + if (typeof p === 'string') { + if (p[0] === '#') { + p = p.substring(1); + } + p = document.getElementById(p); + } else if (p instanceof p5.Element) { + p = p.elt; + } + p.appendChild(this.elt); + return this; +}; + +/** + * + * Sets the ID of the element. If no ID argument is passed in, it instead + * returns the current ID of the element. + * Note that only one element can have a particular id in a page. + * The .class() function can be used + * to identify multiple elements with the same class name. + * + * @method id + * @param {String} id ID of the element + * @chainable + * + * @example + *
    + * function setup() { + * let cnv = createCanvas(100, 100); + * // Assigns a CSS selector ID to + * // the canvas element. + * cnv.id('mycanvas'); + * } + *
    + * + * @alt + * no display. + */ +/** + * @method id + * @return {String} the id of the element + */ +p5.Element.prototype.id = function(id) { + if (typeof id === 'undefined') { + return this.elt.id; + } + + this.elt.id = id; + this.width = this.elt.offsetWidth; + this.height = this.elt.offsetHeight; + return this; +}; + +/** + * + * Adds given class to the element. If no class argument is passed in, it + * instead returns a string containing the current class(es) of the element. + * + * @method class + * @param {String} class class to add + * @chainable + * + * @example + *
    + * function setup() { + * let cnv = createCanvas(100, 100); + * // Assigns a CSS selector class 'small' + * // to the canvas element. + * cnv.class('small'); + * } + *
    + * + * @alt + * no display. + */ +/** + * @method class + * @return {String} the class of the element + */ +p5.Element.prototype.class = function(c) { + if (typeof c === 'undefined') { + return this.elt.className; + } + + this.elt.className = c; + return this; +}; + +/** + * The .mousePressed() function is called once after every time a + * mouse button is pressed over the element. + * Some mobile browsers may also trigger this event on a touch screen, + * if the user performs a quick tap. + * This can be used to attach element specific event listeners. + * + * @method mousePressed + * @param {Function|Boolean} fxn function to be fired when mouse is + * pressed over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d; + * let g; + * function setup() { + * cnv = createCanvas(100, 100); + * cnv.mousePressed(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 click anywhere + * function mousePressed() { + * d = d + 10; + * } + * + * // this function fires only when cnv is clicked + * function changeGray() { + * g = random(0, 255); + * } + *
    + * + * @alt + * no display. + * + */ +p5.Element.prototype.mousePressed = function(fxn) { + // Prepend the mouse property setters to the event-listener. + // This is required so that mouseButton is set correctly prior to calling the callback (fxn). + // For details, see https://github.com/processing/p5.js/issues/3087. + var eventPrependedFxn = function(event) { + this._pInst._setProperty('mouseIsPressed', true); + this._pInst._setMouseButton(event); + // Pass along the return-value of the callback: + return fxn.call(this); + }; + // Pass along the event-prepended form of the callback. + p5.Element._adjustListener('mousedown', eventPrependedFxn, this); + return this; +}; + +/** + * The .doubleClicked() function is called once after every time a + * mouse button is pressed twice over the element. This can be used to + * attach element and action specific event listeners. + * + * @method doubleClicked + * @param {Function|Boolean} fxn function to be fired when mouse is + * double clicked over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @return {p5.Element} + * @example + *
    + * let cnv; + * let d; + * let g; + * function setup() { + * cnv = createCanvas(100, 100); + * cnv.doubleClicked(changeGray); // attach listener for + * // canvas double click only + * d = 10; + * g = 100; + * } + * + * function draw() { + * background(g); + * ellipse(width / 2, height / 2, d, d); + * } + * + * // this function fires with any double click anywhere + * function doubleClicked() { + * d = d + 10; + * } + * + * // this function fires only when cnv is double clicked + * function changeGray() { + * g = random(0, 255); + * } + *
    + * + * @alt + * no display. + * + */ +p5.Element.prototype.doubleClicked = function(fxn) { + p5.Element._adjustListener('dblclick', fxn, this); + return this; +}; + +/** + * The .mouseWheel() function is called once after every time a + * mouse wheel is scrolled over the element. This can be used to + * attach element specific event listeners. + *

    + * The function accepts a callback function as argument which will be executed + * when the `wheel` event is triggered on the element, the callback function is + * passed one argument `event`. The `event.deltaY` property returns negative + * values if the mouse wheel is rotated up or away from the user and positive + * in the other direction. The `event.deltaX` does the same as `event.deltaY` + * except it reads the horizontal wheel scroll of the mouse wheel. + *

    + * On OS X with "natural" scrolling enabled, the `event.deltaY` values are + * reversed. + * + * @method mouseWheel + * @param {Function|Boolean} fxn function to be fired when mouse is + * scrolled over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d; + * let g; + * function setup() { + * cnv = createCanvas(100, 100); + * cnv.mouseWheel(changeSize); // attach listener for + * // activity on canvas only + * d = 10; + * g = 100; + * } + * + * function draw() { + * background(g); + * ellipse(width / 2, height / 2, d, d); + * } + * + * // this function fires with mousewheel movement + * // anywhere on screen + * function mouseWheel() { + * g = g + 10; + * } + * + * // this function fires with mousewheel movement + * // over canvas only + * function changeSize(event) { + * if (event.deltaY > 0) { + * d = d + 10; + * } else { + * d = d - 10; + * } + * } + *
    + * + * + * @alt + * no display. + * + */ +p5.Element.prototype.mouseWheel = function(fxn) { + p5.Element._adjustListener('wheel', fxn, this); + return this; +}; + +/** + * The .mouseReleased() function is called once after every time a + * mouse button is released over the element. + * Some mobile browsers may also trigger this event on a touch screen, + * if the user performs a quick tap. + * This can be used to attach element specific event listeners. + * + * @method mouseReleased + * @param {Function|Boolean} fxn function to be fired when mouse is + * released over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d; + * let g; + * function setup() { + * cnv = createCanvas(100, 100); + * cnv.mouseReleased(changeGray); // attach listener for + * // activity on canvas only + * d = 10; + * g = 100; + * } + * + * function draw() { + * background(g); + * ellipse(width / 2, height / 2, d, d); + * } + * + * // this function fires after the mouse has been + * // released + * function mouseReleased() { + * d = d + 10; + * } + * + * // this function fires after the mouse has been + * // released while on canvas + * function changeGray() { + * g = random(0, 255); + * } + *
    + * + * + * @alt + * no display. + * + */ +p5.Element.prototype.mouseReleased = function(fxn) { + p5.Element._adjustListener('mouseup', fxn, this); + return this; +}; + +/** + * The .mouseClicked() function is called once after a mouse button is + * pressed and released over the element. + * Some mobile browsers may also trigger this event on a touch screen, + * if the user performs a quick tap. + * This can be used to attach element specific event listeners. + * + * @method mouseClicked + * @param {Function|Boolean} fxn function to be fired when mouse is + * clicked over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * + * let cnv; + * let d; + * let g; + * + * function setup() { + * cnv = createCanvas(100, 100); + * cnv.mouseClicked(changeGray); // attach listener for + * // activity on canvas only + * d = 10; + * g = 100; + * } + * + * function draw() { + * background(g); + * ellipse(width / 2, height / 2, d, d); + * } + * + * // this function fires after the mouse has been + * // clicked anywhere + * function mouseClicked() { + * d = d + 10; + * } + * + * // this function fires after the mouse has been + * // clicked on canvas + * function changeGray() { + * g = random(0, 255); + * } + * + *
    + * + * @alt + * no display. + * + */ +p5.Element.prototype.mouseClicked = function(fxn) { + p5.Element._adjustListener('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|Boolean} fxn function to be fired when a mouse moves + * over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d = 30; + * let 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) { + p5.Element._adjustListener('mousemove', 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|Boolean} fxn function to be fired when a mouse moves + * onto the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d; + * 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) { + p5.Element._adjustListener('mouseover', 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|Boolean} fxn function to be fired when a mouse + * moves off of an element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d; + * 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) { + p5.Element._adjustListener('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|Boolean} fxn function to be fired when a touch + * starts over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d; + * let 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) { + p5.Element._adjustListener('touchstart', 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|Boolean} fxn function to be fired when a touch moves over + * the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let 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) { + p5.Element._adjustListener('touchmove', 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|Boolean} fxn function to be fired when a touch ends + * over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * let cnv; + * let d; + * let 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) { + p5.Element._adjustListener('touchend', 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|Boolean} fxn function to be fired when a file is + * dragged over the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * // To test this sketch, simply drag a + * // file over the canvas + * function setup() { + * let c = createCanvas(100, 100); + * background(200); + * textAlign(CENTER); + * text('Drag file', width / 2, height / 2); + * c.dragOver(dragOverCallback); + * } + * + * // This function will be called whenever + * // a file is dragged over the canvas + * function dragOverCallback() { + * background(240); + * text('Dragged over', width / 2, height / 2); + * } + *
    + * @alt + * nothing displayed + */ +p5.Element.prototype.dragOver = function(fxn) { + p5.Element._adjustListener('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|Boolean} fxn function to be fired when a file is + * dragged off the element. + * if `false` is passed instead, the previously + * firing function will no longer fire. + * @chainable + * @example + *
    + * // To test this sketch, simply drag a file + * // over and then out of the canvas area + * function setup() { + * let c = createCanvas(100, 100); + * background(200); + * textAlign(CENTER); + * text('Drag file', width / 2, height / 2); + * c.dragLeave(dragLeaveCallback); + * } + * + * // This function will be called whenever + * // a file is dragged out of the canvas + * function dragLeaveCallback() { + * background(240); + * text('Dragged off', width / 2, height / 2); + * } + *
    + * @alt + * nothing displayed + */ +p5.Element.prototype.dragLeave = function(fxn) { + p5.Element._adjustListener('dragleave', fxn, this); + return this; +}; + +// General handler for event attaching and detaching +p5.Element._adjustListener = function(ev, fxn, ctx) { + if (fxn === false) { + p5.Element._detachListener(ev, ctx); + } else { + p5.Element._attachListener(ev, fxn, ctx); + } + return this; +}; + +p5.Element._attachListener = function(ev, fxn, ctx) { + // detach the old listener if there was one + if (ctx._events[ev]) { + p5.Element._detachListener(ev, ctx); + } + var f = fxn.bind(ctx); + ctx.elt.addEventListener(ev, f, false); + ctx._events[ev] = f; +}; + +p5.Element._detachListener = function(ev, ctx) { + var f = ctx._events[ev]; + ctx.elt.removeEventListener(ev, f, false); + ctx._events[ev] = null; +}; + +/** + * Helper fxn for sharing pixel methods + * + */ +p5.Element.prototype._setProperty = function(prop, value) { + this[prop] = value; +}; + +module.exports = p5.Element; + +},{"./main":24}],26:[function(_dereq_,module,exports){ +/** + * @module Rendering + * @submodule Rendering + * @for p5 + */ + +'use strict'; + +var p5 = _dereq_('./main'); +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 + * @extends p5.Element + * @param {Number} w width + * @param {Number} h height + * @param {Constant} renderer the renderer to use, either P2D or WEBGL + * @param {p5} [pInst] pointer to p5 instance + */ +p5.Graphics = function(w, h, renderer, pInst) { + var r = renderer || constants.P2D; + + this.canvas = document.createElement('canvas'); + var node = pInst._userNode || document.body; + node.appendChild(this.canvas); + + p5.Element.call(this, this.canvas, pInst); + + // bind methods and props of p5 to the new object + for (var p in p5.prototype) { + if (!this[p]) { + if (typeof p5.prototype[p] === 'function') { + this[p] = p5.prototype[p].bind(this); + } else { + this[p] = p5.prototype[p]; + } + } + } + + p5.prototype._initializeInstanceVariables.apply(this); + this.width = w; + this.height = h; + this._pixelDensity = pInst._pixelDensity; + + if (r === constants.WEBGL) { + this._renderer = new p5.RendererGL(this.canvas, this, false); + } else { + this._renderer = new p5.Renderer2D(this.canvas, this, false); + } + pInst._elements.push(this); + + this._renderer.resize(w, h); + this._renderer._applyDefaults(); + return this; +}; + +p5.Graphics.prototype = Object.create(p5.Element.prototype); + +/** + * Resets certain values such as those modified by functions in the Transform category + * and in the Lights category that are not automatically reset + * with graphics buffer objects. Calling this in draw() will copy the behavior + * of the standard canvas. + * + * @method reset + * @example + * + *
    + * let pg; + * function setup() { + * createCanvas(100, 100); + * background(0); + * pg = createGraphics(50, 100); + * pg.fill(0); + * frameRate(5); + * } + * function draw() { + * image(pg, width / 2, 0); + * pg.background(255); + * // p5.Graphics object behave a bit differently in some cases + * // The normal canvas on the left resets the translate + * // with every loop through draw() + * // the graphics object on the right doesn't automatically reset + * // so translate() is additive and it moves down the screen + * rect(0, 0, width / 2, 5); + * pg.rect(0, 0, width / 2, 5); + * translate(0, 5, 0); + * pg.translate(0, 5, 0); + * } + * function mouseClicked() { + * // if you click you will see that + * // reset() resets the translate back to the initial state + * // of the Graphics object + * pg.reset(); + * } + *
    + * + * @alt + * A white line on a black background stays still on the top-left half. + * A black line animates from top to bottom on a white background on the right half. + * When clicked, the black line starts back over at the top. + * + */ +p5.Graphics.prototype.reset = function() { + this._renderer.resetMatrix(); + if (this._renderer.isP3D) { + this._renderer._update(); + } +}; + +/** + * Removes a Graphics object from the page and frees any resources + * associated with it. + * + * @method remove + * + * @example + *
    + * let bg; + * function setup() { + * bg = createCanvas(100, 100); + * bg.background(0); + * image(bg, 0, 0); + * bg.remove(); + * } + *
    + * + *
    + * let bg; + * function setup() { + * pixelDensity(1); + * createCanvas(100, 100); + * stroke(255); + * fill(0); + * + * // create and draw the background image + * bg = createGraphics(100, 100); + * bg.background(200); + * bg.ellipse(50, 50, 80, 80); + * } + * function draw() { + * let t = millis() / 1000; + * // draw the background + * if (bg) { + * image(bg, frameCount % 100, 0); + * image(bg, frameCount % 100 - 100, 0); + * } + * // draw the foreground + * let p = p5.Vector.fromAngle(t, 35).add(50, 50); + * ellipse(p.x, p.y, 30); + * } + * function mouseClicked() { + * // remove the background + * if (bg) { + * bg.remove(); + * bg = null; + * } + * } + *
    + * + * @alt + * no image + * a multi-colored circle moving back and forth over a scrolling background. + * + */ +p5.Graphics.prototype.remove = function() { + if (this.elt.parentNode) { + this.elt.parentNode.removeChild(this.elt); + } + var idx = this._pInst._elements.indexOf(this); + if (idx !== -1) { + this._pInst._elements.splice(idx, 1); + } + for (var elt_ev in this._events) { + this.elt.removeEventListener(elt_ev, this._events[elt_ev]); + } +}; + +module.exports = p5.Graphics; + +},{"./constants":18,"./main":24}],27:[function(_dereq_,module,exports){ +/** + * @module Rendering + * @submodule Rendering + * @for p5 + */ + +'use strict'; + +var p5 = _dereq_('./main'); +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 {p5} [pInst] pointer to p5 instance + * @param {Boolean} [isMainCanvas] whether we're using it as main canvas + */ +p5.Renderer = function(elt, pInst, isMainCanvas) { + p5.Element.call(this, elt, pInst); + this.canvas = elt; + this._pixelsState = 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._textAlign = constants.LEFT; + this._textBaseline = constants.BASELINE; + + 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; +}; + +p5.Renderer.prototype = Object.create(p5.Element.prototype); + +// the renderer should return a 'style' object that it wishes to +// store on the push stack. +p5.Renderer.prototype.push = function() { + return { + properties: { + _doStroke: this._doStroke, + _strokeSet: this._strokeSet, + _doFill: this._doFill, + _fillSet: this._fillSet, + _tint: this._tint, + _imageMode: this._imageMode, + _rectMode: this._rectMode, + _ellipseMode: this._ellipseMode, + _textFont: this._textFont, + _textLeading: this._textLeading, + _textSize: this._textSize, + _textAlign: this._textAlign, + _textBaseline: this._textBaseline, + _textStyle: this._textStyle + } + }; +}; + +// a pop() operation is in progress +// the renderer is passed the 'style' object that it returned +// from its push() method. +p5.Renderer.prototype.pop = function(style) { + if (style.properties) { + // copy the style properties back into the renderer + Object.assign(this, style.properties); + } +}; + +/** + * Resize our canvas element. + */ +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.get = function(x, y, w, h) { + var pixelsState = this._pixelsState; + var pd = pixelsState._pixelDensity; + var canvas = this.canvas; + + if (typeof x === 'undefined' && typeof y === 'undefined') { + // get() + x = y = 0; + w = pixelsState.width; + h = pixelsState.height; + } else { + x *= pd; + y *= pd; + + if (typeof w === 'undefined' && typeof h === 'undefined') { + // get(x,y) + if (x < 0 || y < 0 || x >= canvas.width || y >= canvas.height) { + return [0, 0, 0, 0]; + } + + return this._getPixel(x, y); + } + // get(x,y,w,h) + } + + var region = new p5.Image(w, h); + region.canvas + .getContext('2d') + .drawImage(canvas, x, y, w * pd, h * pd, 0, 0, w, h); + + return region; +}; + +p5.Renderer.prototype.textLeading = function(l) { + if (typeof l === 'number') { + this._setProperty('_textLeading', l); + return this._pInst; + } + + return this._textLeading; +}; + +p5.Renderer.prototype.textSize = function(s) { + if (typeof s === 'number') { + this._setProperty('_textSize', s); + this._setProperty('_textLeading', s * constants._DEFAULT_LEADMULT); + return this._applyTextProperties(); + } + + return this._textSize; +}; + +p5.Renderer.prototype.textStyle = function(s) { + if (s) { + if ( + s === constants.NORMAL || + s === constants.ITALIC || + s === constants.BOLD || + s === constants.BOLDITALIC + ) { + 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.textAlign = function(h, v) { + if (typeof h !== 'undefined') { + this._setProperty('_textAlign', h); + + if (typeof v !== 'undefined') { + this._setProperty('_textBaseline', v); + } + + return this._applyTextProperties(); + } else { + return { + horizontal: this._textAlign, + vertical: this._textBaseline + }; + } +}; + +p5.Renderer.prototype.text = function(str, x, y, maxWidth, maxHeight) { + var p = this._pInst, + cars, + n, + ii, + jj, + line, + testLine, + testWidth, + words, + totalHeight, + finalMaxHeight = Number.MAX_VALUE; + + if (!(this._doFill || this._doStroke)) { + return; + } + + if (typeof str === 'undefined') { + return; + } else if (typeof str !== 'string') { + str = str.toString(); + } + + str = str.replace(/(\t)/g, ' '); + cars = str.split('\n'); + + if (typeof maxWidth !== 'undefined') { + totalHeight = 0; + for (ii = 0; ii < cars.length; ii++) { + line = ''; + words = cars[ii].split(' '); + for (n = 0; n < words.length; n++) { + testLine = line + words[n] + ' '; + testWidth = this.textWidth(testLine); + if (testWidth > maxWidth) { + line = words[n] + ' '; + totalHeight += p.textLeading(); + } else { + line = testLine; + } + } + } + + if (this._rectMode === constants.CENTER) { + x -= maxWidth / 2; + y -= maxHeight / 2; + } + + switch (this._textAlign) { + case constants.CENTER: + x += maxWidth / 2; + break; + case constants.RIGHT: + x += maxWidth; + break; + } + + var baselineHacked = false; + if (typeof maxHeight !== 'undefined') { + switch (this._textBaseline) { + case constants.BOTTOM: + y += maxHeight - totalHeight; + break; + case constants.CENTER: + y += (maxHeight - totalHeight) / 2; + break; + case constants.BASELINE: + baselineHacked = true; + this._textBaseline = constants.TOP; + break; + } + + // remember the max-allowed y-position for any line (fix to #928) + finalMaxHeight = y + maxHeight - p.textAscent(); + } + + for (ii = 0; ii < cars.length; ii++) { + line = ''; + words = cars[ii].split(' '); + for (n = 0; n < words.length; n++) { + testLine = line + words[n] + ' '; + testWidth = this.textWidth(testLine); + if (testWidth > maxWidth && line.length > 0) { + this._renderText(p, line, x, y, finalMaxHeight); + line = words[n] + ' '; + y += p.textLeading(); + } else { + line = testLine; + } + } + + this._renderText(p, line, x, y, finalMaxHeight); + y += p.textLeading(); + + if (baselineHacked) { + this._textBaseline = constants.BASELINE; + } + } + } else { + // Offset to account for vertically centering multiple lines of text - no + // need to adjust anything for vertical align top or baseline + var offset = 0, + vAlign = p.textAlign().vertical; + if (vAlign === constants.CENTER) { + offset = (cars.length - 1) * p.textLeading() / 2; + } else if (vAlign === constants.BOTTOM) { + offset = (cars.length - 1) * p.textLeading(); + } + + for (jj = 0; jj < cars.length; jj++) { + this._renderText(p, cars[jj], x, y - offset, finalMaxHeight); + y += p.textLeading(); + } + } + + return p; +}; + +p5.Renderer.prototype._applyDefaults = function() { + return this; +}; + +/** + * 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":18,"./main":24}],28:[function(_dereq_,module,exports){ +'use strict'; + +var p5 = _dereq_('./main'); +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._cachedFillStyle = this._cachedStrokeStyle = undefined; + this._setFill(constants._DEFAULT_FILL); + this._setStroke(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.resetMatrix(); + + if (arguments[0] instanceof p5.Image) { + this._pInst.image(arguments[0], 0, 0, this.width, this.height); + } else { + var curFill = this._getFill(); + // create background rect + var color = this._pInst.color.apply(this._pInst, arguments); + var newFill = color.toString(); + this._setFill(newFill); + this.drawingContext.fillRect(0, 0, this.width, this.height); + // reset fill + this._setFill(curFill); + } + this.drawingContext.restore(); + + this._pixelsState._pixelsDirty = true; +}; + +p5.Renderer2D.prototype.clear = function() { + this.drawingContext.save(); + this.resetMatrix(); + this.drawingContext.clearRect(0, 0, this.width, this.height); + this.drawingContext.restore(); + + this._pixelsState._pixelsDirty = true; +}; + +p5.Renderer2D.prototype.fill = function() { + var color = this._pInst.color.apply(this._pInst, arguments); + this._setFill(color.toString()); +}; + +p5.Renderer2D.prototype.stroke = function() { + var color = this._pInst.color.apply(this._pInst, arguments); + this._setStroke(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; + } + var s = 1; + if (img.width && img.width > 0) { + s = cnv.width / img.width; + } + this.drawingContext.drawImage( + cnv, + s * sx, + s * sy, + s * sWidth, + s * sHeight, + dx, + dy, + dWidth, + dHeight + ); + } catch (e) { + if (e.name !== 'NS_ERROR_NOT_AVAILABLE') { + throw e; + } + } + + this._pixelsState._pixelsDirty = true; +}; + +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) { + if (mode === constants.SUBTRACT) { + console.warn('blendMode(SUBTRACT) only works in WEBGL mode.'); + } else 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 + ) { + this.drawingContext.globalCompositeOperation = mode; + } else { + throw new Error('Mode ' + mode + ' not recognized.'); + } +}; + +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(this, srcImage, sx, sy, sw, sh, dx, dy, dw, dh); + + this._pixelsState._pixelsDirty = true; +}; + +p5.Renderer2D._copyHelper = function( + dstImage, + srcImage, + sx, + sy, + sw, + sh, + dx, + dy, + dw, + dh +) { + srcImage.loadPixels(); + var s = srcImage.canvas.width / srcImage.width; + dstImage.drawingContext.drawImage( + srcImage.canvas, + s * sx, + s * sy, + s * sw, + s * sh, + dx, + dy, + dw, + dh + ); +}; + +// p5.Renderer2D.prototype.get = p5.Renderer.prototype.get; +// .get() is not overridden + +// x,y are canvas-relative (pre-scaled by _pixelDensity) +p5.Renderer2D.prototype._getPixel = function(x, y) { + var pixelsState = this._pixelsState; + var imageData, index; + if (pixelsState._pixelsDirty) { + imageData = this.drawingContext.getImageData(x, y, 1, 1).data; + index = 0; + } else { + imageData = pixelsState.pixels; + index = (Math.floor(x) + Math.floor(y) * this.canvas.width) * 4; + } + return [ + imageData[index + 0], + imageData[index + 1], + imageData[index + 2], + imageData[index + 3] + ]; +}; + +p5.Renderer2D.prototype.loadPixels = function() { + var pixelsState = this._pixelsState; // if called by p5.Image + if (!pixelsState._pixelsDirty) return; + pixelsState._pixelsDirty = false; + + var pd = pixelsState._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. + pixelsState._setProperty('imageData', imageData); + pixelsState._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); + var pixelsState = this._pixelsState; + if (imgOrCol instanceof p5.Image) { + this.drawingContext.save(); + this.drawingContext.setTransform(1, 0, 0, 1, 0, 0); + this.drawingContext.scale( + pixelsState._pixelDensity, + pixelsState._pixelDensity + ); + this.drawingContext.drawImage(imgOrCol.canvas, x, y); + this.drawingContext.restore(); + pixelsState._pixelsDirty = true; + } else { + var r = 0, + g = 0, + b = 0, + a = 0; + var idx = + 4 * + (y * + pixelsState._pixelDensity * + (this.width * pixelsState._pixelDensity) + + x * pixelsState._pixelDensity); + if (!pixelsState.imageData || pixelsState._pixelsDirty) { + pixelsState.loadPixels.call(pixelsState); + } + if (typeof imgOrCol === 'number') { + if (idx < pixelsState.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 < pixelsState.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 < pixelsState.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 < pixelsState._pixelDensity; i++) { + for (var j = 0; j < pixelsState._pixelDensity; j++) { + // loop over + idx = + 4 * + ((y * pixelsState._pixelDensity + j) * + this.width * + pixelsState._pixelDensity + + (x * pixelsState._pixelDensity + i)); + pixelsState.pixels[idx] = r; + pixelsState.pixels[idx + 1] = g; + pixelsState.pixels[idx + 2] = b; + pixelsState.pixels[idx + 3] = a; + } + } + } +}; + +p5.Renderer2D.prototype.updatePixels = function(x, y, w, h) { + var pixelsState = this._pixelsState; + var pd = pixelsState._pixelDensity; + if ( + x === undefined && + y === undefined && + w === undefined && + h === undefined + ) { + x = 0; + y = 0; + w = this.width; + h = this.height; + } + w *= pd; + h *= pd; + + this.drawingContext.putImageData(pixelsState.imageData, x, y, 0, 0, w, h); + + if (x !== 0 || y !== 0 || w !== this.width || h !== this.height) { + pixelsState._pixelsDirty = true; + } +}; + +////////////////////////////////////////////// +// 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 +) { + // Evaluate 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).toFixed(7), + ay: Math.sin(start).toFixed(7), + bx: (lambda * cos_phi + mu * sin_phi).toFixed(7), + by: (lambda * sin_phi - mu * cos_phi).toFixed(7), + cx: (lambda * cos_phi - mu * sin_phi).toFixed(7), + cy: (lambda * sin_phi + mu * cos_phi).toFixed(7), + dx: Math.cos(start + size).toFixed(7), + dy: Math.sin(start + size).toFixed(7) + }; +}; + +/* + * This function requires that: + * + * 0 <= start < TWO_PI + * + * start <= stop < start + TWO_PI + */ +p5.Renderer2D.prototype.arc = function(x, y, w, h, start, stop, mode) { + var ctx = this.drawingContext; + var rx = w / 2.0; + var ry = h / 2.0; + var epsilon = 0.00001; // Smallest visible angle on displays up to 4K. + var arcToDraw = 0; + var curves = []; + + x += rx; + y += ry; + + // Create curves + while (stop - start >= epsilon) { + 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(x + curve.ax * rx, y + curve.ay * ry); + } + // prettier-ignore + ctx.bezierCurveTo(x + curve.bx * rx, y + curve.by * ry, + x + curve.cx * rx, y + curve.cy * ry, + x + curve.dx * rx, y + curve.dy * ry); + }); + if (mode === constants.PIE || mode == null) { + ctx.lineTo(x, y); + } + ctx.closePath(); + ctx.fill(); + this._pixelsState._pixelsDirty = true; + } + + // Stroke curves + if (this._doStroke) { + ctx.beginPath(); + curves.forEach(function(curve, index) { + if (index === 0) { + ctx.moveTo(x + curve.ax * rx, y + curve.ay * ry); + } + // prettier-ignore + ctx.bezierCurveTo(x + curve.bx * rx, y + curve.by * ry, + x + curve.cx * rx, y + curve.cy * ry, + x + curve.dx * rx, y + curve.dy * ry); + }); + if (mode === constants.PIE) { + ctx.lineTo(x, y); + ctx.closePath(); + } else if (mode === constants.CHORD) { + ctx.closePath(); + } + ctx.stroke(); + this._pixelsState._pixelsDirty = true; + } + 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 (this._getFill() === styleEmpty) { + return this; + } + } else if (!doFill && doStroke) { + if (this._getStroke() === styleEmpty) { + return this; + } + } + var kappa = 0.5522847498, + ox = w / 2 * kappa, // control point offset horizontal + oy = h / 2 * kappa, // control point offset vertical + xe = x + w, // x-end + ye = y + h, // y-end + xm = x + w / 2, // x-middle + ym = y + h / 2; // y-middle + 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(); + this._pixelsState._pixelsDirty = true; + } + if (doStroke) { + ctx.stroke(); + this._pixelsState._pixelsDirty = true; + } +}; + +p5.Renderer2D.prototype.line = function(x1, y1, x2, y2) { + var ctx = this.drawingContext; + if (!this._doStroke) { + return this; + } else if (this._getStroke() === styleEmpty) { + return this; + } + ctx.beginPath(); + ctx.moveTo(x1, y1); + ctx.lineTo(x2, y2); + ctx.stroke(); + this._pixelsState._pixelsDirty = true; + return this; +}; + +p5.Renderer2D.prototype.point = function(x, y) { + var ctx = this.drawingContext; + if (!this._doStroke) { + return this; + } else if (this._getStroke() === styleEmpty) { + return this; + } + var s = this._getStroke(); + var f = this._getFill(); + x = Math.round(x); + y = Math.round(y); + // swapping fill color to stroke and back after for correct point rendering + this._setFill(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); + } + this._setFill(f); + this._pixelsState._pixelsDirty = true; +}; + +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 (this._getFill() === styleEmpty) { + return this; + } + } else if (!doFill && doStroke) { + if (this._getStroke() === 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(); + } + this._pixelsState._pixelsDirty = true; + 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 (this._getFill() === styleEmpty) { + return this; + } + } else if (!doFill && doStroke) { + if (this._getStroke() === styleEmpty) { + return this; + } + } + 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(); + } + this._pixelsState._pixelsDirty = true; + 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 (this._getFill() === styleEmpty) { + return this; + } + } else if (!doFill && doStroke) { + if (this._getStroke() === styleEmpty) { + return this; + } + } + ctx.beginPath(); + ctx.moveTo(x1, y1); + ctx.lineTo(x2, y2); + ctx.lineTo(x3, y3); + ctx.closePath(); + if (doFill) { + ctx.fill(); + this._pixelsState._pixelsDirty = true; + } + if (doStroke) { + ctx.stroke(); + this._pixelsState._pixelsDirty = true; + } +}; + +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(closeShape); + } + } 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(closeShape); + } 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(vertices[i][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(closeShape); + } 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.closePath(); + 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(); + } + } + } 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(closeShape); + } + } else if (shapeKind === constants.TRIANGLE_FAN) { + if (numVerts > 2) { + // For performance reasons, try to batch as many of the + // fill and stroke calls as possible. + this.drawingContext.beginPath(); + for (i = 2; i < numVerts; i++) { + v = vertices[i]; + 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]); + this.drawingContext.lineTo(vertices[0][0], vertices[0][1]); + // If the next colour is going to be different, stroke / fill now + if (i < numVerts - 1) { + if ( + (this._doFill && v[5] !== vertices[i + 1][5]) || + (this._doStroke && v[6] !== vertices[i + 1][6]) + ) { + if (this._doFill) { + this._pInst.fill(v[5]); + this.drawingContext.fill(); + this._pInst.fill(vertices[i + 1][5]); + } + if (this._doStroke) { + this._pInst.stroke(v[6]); + this.drawingContext.stroke(); + this._pInst.stroke(vertices[i + 1][6]); + } + this.drawingContext.closePath(); + this.drawingContext.beginPath(); // Begin the next one + } + } + } + this._doFillStrokeClose(closeShape); + } + } 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(closeShape); + } + } 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(closeShape); + } + } + } 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(closeShape); + } + } + isCurve = false; + isBezier = false; + isQuadratic = false; + isContour = false; + if (closeShape) { + vertices.pop(); + } + + this._pixelsState._pixelsDirty = true; + return this; +}; +////////////////////////////////////////////// +// SHAPE | Attributes +////////////////////////////////////////////// + +p5.Renderer2D.prototype.strokeCap = function(cap) { + if ( + cap === constants.ROUND || + cap === constants.SQUARE || + cap === constants.PROJECT + ) { + this.drawingContext.lineCap = cap; + } + return this; +}; + +p5.Renderer2D.prototype.strokeJoin = function(join) { + if ( + join === constants.ROUND || + join === constants.BEVEL || + join === constants.MITER + ) { + this.drawingContext.lineJoin = join; + } + return this; +}; + +p5.Renderer2D.prototype.strokeWeight = function(w) { + if (typeof w === 'undefined' || w === 0) { + // hack because lineWidth 0 doesn't work + this.drawingContext.lineWidth = 0.0001; + } else { + this.drawingContext.lineWidth = w; + } + return this; +}; + +p5.Renderer2D.prototype._getFill = function() { + if (!this._cachedFillStyle) { + this._cachedFillStyle = this.drawingContext.fillStyle; + } + return this._cachedFillStyle; +}; + +p5.Renderer2D.prototype._setFill = function(fillStyle) { + if (fillStyle !== this._cachedFillStyle) { + this.drawingContext.fillStyle = fillStyle; + this._cachedFillStyle = fillStyle; + } +}; + +p5.Renderer2D.prototype._getStroke = function() { + if (!this._cachedStrokeStyle) { + this._cachedStrokeStyle = this.drawingContext.strokeStyle; + } + return this._cachedStrokeStyle; +}; + +p5.Renderer2D.prototype._setStroke = function(strokeStyle) { + if (strokeStyle !== this._cachedStrokeStyle) { + this.drawingContext.strokeStyle = strokeStyle; + this._cachedStrokeStyle = strokeStyle; + } +}; + +////////////////////////////////////////////// +// SHAPE | Curves +////////////////////////////////////////////// +p5.Renderer2D.prototype.bezier = function(x1, y1, x2, y2, x3, y3, x4, y4) { + this._pInst.beginShape(); + this._pInst.vertex(x1, y1); + this._pInst.bezierVertex(x2, y2, x3, y3, x4, y4); + this._pInst.endShape(); + return this; +}; + +p5.Renderer2D.prototype.curve = function(x1, y1, x2, y2, x3, y3, x4, y4) { + this._pInst.beginShape(); + this._pInst.curveVertex(x1, y1); + this._pInst.curveVertex(x2, y2); + this._pInst.curveVertex(x3, y3); + this._pInst.curveVertex(x4, y4); + this._pInst.endShape(); + return this; +}; + +////////////////////////////////////////////// +// SHAPE | Vertex +////////////////////////////////////////////// + +p5.Renderer2D.prototype._doFillStrokeClose = function(closeShape) { + if (closeShape) { + this.drawingContext.closePath(); + } + if (this._doFill) { + this.drawingContext.fill(); + } + if (this._doStroke) { + this.drawingContext.stroke(); + } + + this._pixelsState._pixelsDirty = true; +}; + +////////////////////////////////////////////// +// TRANSFORM +////////////////////////////////////////////// + +p5.Renderer2D.prototype.applyMatrix = function(a, b, c, d, e, f) { + this.drawingContext.transform(a, b, c, d, e, f); +}; + +p5.Renderer2D.prototype.resetMatrix = function() { + this.drawingContext.setTransform(1, 0, 0, 1, 0, 0); + this.drawingContext.scale( + this._pInst._pixelDensity, + this._pInst._pixelDensity + ); + return this; +}; + +p5.Renderer2D.prototype.rotate = function(rad) { + this.drawingContext.rotate(rad); +}; + +p5.Renderer2D.prototype.scale = function(x, y) { + this.drawingContext.scale(x, y); + return this; +}; + +p5.Renderer2D.prototype.translate = function(x, y) { + // support passing a vector as the 1st parameter + if (x instanceof p5.Vector) { + y = x.y; + x = x.x; + } + this.drawingContext.translate(x, y); + return this; +}; + +////////////////////////////////////////////// +// TYPOGRAPHY +// +////////////////////////////////////////////// + +p5.Renderer2D.prototype.text = function(str, x, y, maxWidth, maxHeight) { + var baselineHacked; + + // baselineHacked: (HACK) + // A temporary fix to conform to Processing's implementation + // of BASELINE vertical alignment in a bounding box + + if (typeof maxWidth !== 'undefined' && typeof maxHeight !== 'undefined') { + if (this.drawingContext.textBaseline === constants.BASELINE) { + baselineHacked = true; + this.drawingContext.textBaseline = constants.TOP; + } + } + + var p = p5.Renderer.prototype.text.apply(this, arguments); + + if (baselineHacked) { + this.drawingContext.textBaseline = constants.BASELINE; + } + + return p; +}; + +p5.Renderer2D.prototype._renderText = function(p, line, x, y, maxY) { + if (y >= maxY) { + return; // don't render lines beyond our maxY position + } + + p.push(); // fix to #803 + + if (!this._isOpenType()) { + // a system/browser font + + // no stroke unless specified by user + if (this._doStroke && this._strokeSet) { + this.drawingContext.strokeText(line, x, y); + } + + if (this._doFill) { + // if fill hasn't been set by user, use default text fill + if (!this._fillSet) { + this._setFill(constants._DEFAULT_TEXT_FILL); + } + + this.drawingContext.fillText(line, x, y); + } + } else { + // an opentype font, let it handle the rendering + + this._textFont._renderPath(line, x, y, { renderer: this }); + } + + p.pop(); + + this._pixelsState._pixelsDirty = true; + return p; +}; + +p5.Renderer2D.prototype.textWidth = function(s) { + if (this._isOpenType()) { + return this._textFont._textWidth(s, this._textSize); + } + + return this.drawingContext.measureText(s).width; +}; + +p5.Renderer2D.prototype._applyTextProperties = function() { + var font, + p = this._pInst; + + this._setProperty('_textAscent', null); + this._setProperty('_textDescent', null); + + font = this._textFont; + + if (this._isOpenType()) { + font = this._textFont.font.familyName; + this._setProperty('_textStyle', this._textFont.font.styleName); + } + + this.drawingContext.font = + (this._textStyle || 'normal') + + ' ' + + (this._textSize || 12) + + 'px ' + + (font || 'sans-serif'); + + this.drawingContext.textAlign = this._textAlign; + if (this._textBaseline === constants.CENTER) { + this.drawingContext.textBaseline = constants._CTX_MIDDLE; + } else { + this.drawingContext.textBaseline = this._textBaseline; + } + + return p; +}; + +////////////////////////////////////////////// +// STRUCTURE +////////////////////////////////////////////// + +// a push() operation is in progress. +// the renderer should return a 'style' object that it wishes to +// store on the push stack. +// derived renderers should call the base class' push() method +// to fetch the base style object. +p5.Renderer2D.prototype.push = function() { + this.drawingContext.save(); + + // get the base renderer style + return p5.Renderer.prototype.push.apply(this); +}; + +// a pop() operation is in progress +// the renderer is passed the 'style' object that it returned +// from its push() method. +// derived renderers should pass this object to their base +// class' pop method +p5.Renderer2D.prototype.pop = function(style) { + this.drawingContext.restore(); + // Re-cache the fill / stroke state + this._cachedFillStyle = this.drawingContext.fillStyle; + this._cachedStrokeStyle = this.drawingContext.strokeStyle; + + p5.Renderer.prototype.pop.call(this, style); +}; + +module.exports = p5.Renderer2D; + +},{"../image/filters":42,"./constants":18,"./main":24,"./p5.Renderer":27}],29:[function(_dereq_,module,exports){ +/** + * @module Rendering + * @submodule Rendering + * @for p5 + */ + +'use strict'; + +var p5 = _dereq_('./main'); +var constants = _dereq_('./constants'); +_dereq_('./p5.Graphics'); +_dereq_('./p5.Renderer2D'); +_dereq_('../webgl/p5.RendererGL'); +var defaultId = 'defaultCanvas0'; // this gets set again in createCanvas +var defaultClass = 'p5Canvas'; + +/** + * Creates a canvas element in the document, and sets the dimensions of it + * in pixels. This method should be called only once at the start of setup. + * Calling createCanvas more than once in a sketch will result in very + * unpredictable behavior. If you want more than one drawing canvas + * you could use createGraphics (hidden by default but it can be shown). + *

    + * The system variables width and height are set by the parameters passed + * to this function. If createCanvas() is not used, the window will be + * given a default size of 100x100 pixels. + *

    + * For more ways to position the canvas, see the + * + * positioning the canvas wiki page. + * + * @method createCanvas + * @param {Number} w width of the canvas + * @param {Number} h height of the canvas + * @param {Constant} [renderer] either P2D or WEBGL + * @return {p5.Renderer} + * @example + *
    + * + * function setup() { + * createCanvas(100, 50); + * background(153); + * line(0, 0, width, height); + * } + * + *
    + * + * @alt + * Black line extending from top-left of canvas to bottom right. + * + */ + +p5.prototype.createCanvas = function(w, h, renderer) { + p5._validateParameters('createCanvas', arguments); + //optional: renderer, otherwise defaults to p2d + var r = renderer || constants.P2D; + var c; + + if (r === constants.WEBGL) { + c = document.getElementById(defaultId); + if (c) { + //if defaultCanvas already exists + c.parentNode.removeChild(c); //replace the existing defaultCanvas + var thisRenderer = this._renderer; + this._elements = this._elements.filter(function(e) { + return e !== thisRenderer; + }); + } + c = document.createElement('canvas'); + c.id = defaultId; + c.classList.add(defaultClass); + } else { + if (!this._defaultGraphicsCreated) { + c = document.createElement('canvas'); + var i = 0; + while (document.getElementById('defaultCanvas' + i)) { + i++; + } + defaultId = 'defaultCanvas' + i; + c.id = defaultId; + c.classList.add(defaultClass); + } else { + // resize the default canvas if new one is created + c = this.canvas; + } + } + + // set to invisible if still in setup (to prevent flashing with manipulate) + if (!this._setupDone) { + c.dataset.hidden = true; // tag to show later + c.style.visibility = 'hidden'; + } + + if (this._userNode) { + // user input node case + this._userNode.appendChild(c); + } else { + document.body.appendChild(c); + } + + // Init our graphics renderer + //webgl mode + if (r === constants.WEBGL) { + this._setProperty('_renderer', new p5.RendererGL(c, this, true)); + this._elements.push(this._renderer); + } else { + //P2D mode + if (!this._defaultGraphicsCreated) { + this._setProperty('_renderer', new p5.Renderer2D(c, this, true)); + this._defaultGraphicsCreated = true; + this._elements.push(this._renderer); + } + } + this._renderer.resize(w, h); + this._renderer._applyDefaults(); + return this._renderer; +}; + +/** + * Resizes the canvas to given width and height. The canvas will be cleared + * and draw will be called immediately, allowing the sketch to re-render itself + * in the resized canvas. + * @method resizeCanvas + * @param {Number} w width of the canvas + * @param {Number} h height of the canvas + * @param {Boolean} [noRedraw] don't redraw the canvas immediately + * @example + *
    + * function setup() { + * createCanvas(windowWidth, windowHeight); + * } + * + * function draw() { + * background(0, 100, 200); + * } + * + * function windowResized() { + * resizeCanvas(windowWidth, windowHeight); + * } + *
    + * + * @alt + * No image displayed. + * + */ +p5.prototype.resizeCanvas = function(w, h, noRedraw) { + p5._validateParameters('resizeCanvas', arguments); + if (this._renderer) { + // save canvas properties + var props = {}; + for (var key in this.drawingContext) { + var val = this.drawingContext[key]; + if (typeof val !== 'object' && typeof val !== 'function') { + props[key] = val; + } + } + this._renderer.resize(w, h); + this.width = w; + this.height = h; + // reset canvas properties + for (var savedKey in props) { + try { + this.drawingContext[savedKey] = props[savedKey]; + } catch (err) { + // ignore read-only property errors + } + } + if (!noRedraw) { + this.redraw(); + } + } +}; + +/** + * Removes the default canvas for a p5 sketch that doesn't + * require a canvas + * @method noCanvas + * @example + *
    + * + * function setup() { + * noCanvas(); + * } + * + *
    + * + * @alt + * no image displayed + * + */ +p5.prototype.noCanvas = function() { + if (this.canvas) { + this.canvas.parentNode.removeChild(this.canvas); + } +}; + +/** + * Creates and returns a new p5.Renderer object. Use this class if you need + * to draw into an off-screen graphics buffer. The two parameters define the + * width and height in pixels. + * + * @method createGraphics + * @param {Number} w width of the offscreen graphics buffer + * @param {Number} h height of the offscreen graphics buffer + * @param {Constant} [renderer] either P2D or WEBGL + * undefined defaults to p2d + * @return {p5.Graphics} offscreen graphics buffer + * @example + *
    + * + * let pg; + * function setup() { + * createCanvas(100, 100); + * pg = createGraphics(100, 100); + * } + * function draw() { + * background(200); + * pg.background(100); + * pg.noStroke(); + * pg.ellipse(pg.width / 2, pg.height / 2, 50, 50); + * image(pg, 50, 50); + * image(pg, 0, 0, 50, 50); + * } + * + *
    + * + * @alt + * 4 grey squares alternating light and dark grey. White quarter circle mid-left. + * + */ +p5.prototype.createGraphics = function(w, h, renderer) { + p5._validateParameters('createGraphics', arguments); + return new p5.Graphics(w, h, renderer, this); +}; + +/** + * Blends the pixels in the display window according to the defined mode. + * There is a choice of the following modes to blend the source pixels (A) + * with the ones of pixels already in the display window (B): + *
      + *
    • BLEND - linear interpolation of colours: C = + * A\*factor + B. This is the default blending mode.
      • + *
    • ADD - sum of A and 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. (2D)
      • + *
    • HARD_LIGHT - SCREEN when greater than 50% + * gray, MULTIPLY when lower. (2D)
      • + *
    • SOFT_LIGHT - mix of DARKEST and + * LIGHTEST. Works like OVERLAY, but not as harsh. (2D) + *
      • + *
    • DODGE - lightens light tones and increases contrast, + * ignores darks. (2D)
      • + *
    • BURN - darker areas are applied, increasing contrast, + * ignores lights. (2D)
      • + *
    • SUBTRACT - remainder of A and B (3D)
      • + *
    + *

    + * (2D) indicates that this blend mode only works in the 2D renderer.
    + * (3D) indicates that this blend mode only works in the WEBGL renderer. + * + * + * @method blendMode + * @param {Constant} mode blend mode to set for canvas. + * either BLEND, DARKEST, LIGHTEST, DIFFERENCE, MULTIPLY, + * EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT, + * SOFT_LIGHT, DODGE, BURN, ADD, or SUBTRACT + * @example + *
    + * + * blendMode(LIGHTEST); + * strokeWeight(30); + * stroke(80, 150, 255); + * line(25, 25, 75, 75); + * stroke(255, 50, 50); + * line(75, 25, 25, 75); + * + *
    + *
    + * + * blendMode(MULTIPLY); + * strokeWeight(30); + * stroke(80, 150, 255); + * line(25, 25, 75, 75); + * stroke(255, 50, 50); + * line(75, 25, 25, 75); + * + *
    + * @alt + * translucent image thick red & blue diagonal rounded lines intersecting center + * Thick red & blue diagonal rounded lines intersecting center. dark at overlap + * + */ +p5.prototype.blendMode = function(mode) { + p5._validateParameters('blendMode', arguments); + if (mode === constants.NORMAL) { + // Warning added 3/26/19, can be deleted in future (1.0 release?) + console.warn( + 'NORMAL has been deprecated for use in blendMode. defaulting to BLEND instead.' + ); + mode = constants.BLEND; + } + this._renderer.blendMode(mode); +}; + +module.exports = p5; + +},{"../webgl/p5.RendererGL":74,"./constants":18,"./main":24,"./p5.Graphics":26,"./p5.Renderer2D":28}],30:[function(_dereq_,module,exports){ +/** + * @module Shape + * @submodule 2D Primitives + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../main'); +var constants = _dereq_('../constants'); +var canvas = _dereq_('../helpers'); +_dereq_('../error_helpers'); + +/** + * This function does 3 things: + * + * 1. Bounds the desired start/stop angles for an arc (in radians) so that: + * + * 0 <= start < TWO_PI ; start <= stop < start + TWO_PI + * + * This means that the arc rendering functions don't have to be concerned + * with what happens if stop is smaller than start, or if the arc 'goes + * round more than once', etc.: they can just start at start and increase + * until stop and the correct arc will be drawn. + * + * 2. Optionally adjusts the angles within each quadrant to counter the naive + * scaling of the underlying ellipse up from the unit circle. Without + * this, the angles become arbitrary when width != height: 45 degrees + * might be drawn at 5 degrees on a 'wide' ellipse, or at 85 degrees on + * a 'tall' ellipse. + * + * 3. Flags up when start and stop correspond to the same place on the + * underlying ellipse. This is useful if you want to do something special + * there (like rendering a whole ellipse instead). + */ +p5.prototype._normalizeArcAngles = function( + start, + stop, + width, + height, + correctForScaling +) { + var epsilon = 0.00001; // Smallest visible angle on displays up to 4K. + var separation; + + // The order of the steps is important here: each one builds upon the + // adjustments made in the steps that precede it. + + // Constrain both start and stop to [0,TWO_PI). + start = start - constants.TWO_PI * Math.floor(start / constants.TWO_PI); + stop = stop - constants.TWO_PI * Math.floor(stop / constants.TWO_PI); + + // Get the angular separation between the requested start and stop points. + // + // Technically this separation only matches what gets drawn if + // correctForScaling is enabled. We could add a more complicated calculation + // for when the scaling is uncorrected (in which case the drawn points could + // end up pushed together or pulled apart quite dramatically relative to what + // was requested), but it would make things more opaque for little practical + // benefit. + // + // (If you do disable correctForScaling and find that correspondToSamePoint + // is set too aggressively, the easiest thing to do is probably to just make + // epsilon smaller...) + separation = Math.min( + Math.abs(start - stop), + constants.TWO_PI - Math.abs(start - stop) + ); + + // Optionally adjust the angles to counter linear scaling. + if (correctForScaling) { + if (start <= constants.HALF_PI) { + start = Math.atan(width / height * Math.tan(start)); + } else if (start > constants.HALF_PI && start <= 3 * constants.HALF_PI) { + start = Math.atan(width / height * Math.tan(start)) + constants.PI; + } else { + start = Math.atan(width / height * Math.tan(start)) + constants.TWO_PI; + } + if (stop <= constants.HALF_PI) { + stop = Math.atan(width / height * Math.tan(stop)); + } else if (stop > constants.HALF_PI && stop <= 3 * constants.HALF_PI) { + stop = Math.atan(width / height * Math.tan(stop)) + constants.PI; + } else { + stop = Math.atan(width / height * Math.tan(stop)) + constants.TWO_PI; + } + } + + // Ensure that start <= stop < start + TWO_PI. + if (start > stop) { + stop += constants.TWO_PI; + } + + return { + start: start, + stop: stop, + correspondToSamePoint: separation < epsilon + }; +}; + +/** + * Draw an arc to the screen. If called with only x, y, w, h, start, and + * stop, the arc will be drawn and filled as an open pie segment. If a mode parameter is provided, the arc + * will be filled like an open semi-circle (OPEN) , a closed semi-circle (CHORD), or as a closed pie segment (PIE). The + * origin may be changed with the ellipseMode() function.

    + * The arc is always drawn clockwise from wherever start falls to wherever stop falls on the ellipse. + * Adding or subtracting TWO_PI to either angle does not change where they fall. + * If both start and stop fall at the same place, a full ellipse will be drawn. + * + * @method arc + * @param {Number} x x-coordinate of the arc's ellipse + * @param {Number} y y-coordinate of the arc's ellipse + * @param {Number} w width of the arc's ellipse by default + * @param {Number} h height of the arc's ellipse by default + * @param {Number} start angle to start the arc, specified in radians + * @param {Number} stop angle to stop the arc, specified in radians + * @param {Constant} [mode] optional parameter to determine the way of drawing + * the arc. either CHORD, PIE or OPEN + * @param {Number} [detail] optional parameter for WebGL mode only. This is to + * specify the number of vertices that makes up the + * perimeter of the arc. Default value is 25. + * + * @chainable + * @example + *
    + * + * arc(50, 55, 50, 50, 0, HALF_PI); + * noFill(); + * arc(50, 55, 60, 60, HALF_PI, PI); + * arc(50, 55, 70, 70, PI, PI + QUARTER_PI); + * arc(50, 55, 80, 80, PI + QUARTER_PI, TWO_PI); + * + *
    + * + *
    + * + * arc(50, 50, 80, 80, 0, PI + QUARTER_PI); + * + *
    + * + *
    + * + * arc(50, 50, 80, 80, 0, PI + QUARTER_PI, OPEN); + * + *
    + * + *
    + * + * arc(50, 50, 80, 80, 0, PI + QUARTER_PI, CHORD); + * + *
    + * + *
    + * + * arc(50, 50, 80, 80, 0, PI + QUARTER_PI, PIE); + * + *
    + * + * @alt + *shattered outline of an ellipse with a quarter of a white circle bottom-right. + *white ellipse with top right quarter missing. + *white ellipse with black outline with top right missing. + *white ellipse with top right missing with black outline around shape. + *white ellipse with top right quarter missing with black outline around the shape. + * + */ +p5.prototype.arc = function(x, y, w, h, start, stop, mode, detail) { + p5._validateParameters('arc', arguments); + + // if the current stroke and fill settings wouldn't result in something + // visible, exit immediately + if (!this._renderer._doStroke && !this._renderer._doFill) { + return this; + } + + start = this._toRadians(start); + stop = this._toRadians(stop); + + // p5 supports negative width and heights for ellipses + w = Math.abs(w); + h = Math.abs(h); + + var vals = canvas.modeAdjust(x, y, w, h, this._renderer._ellipseMode); + var angles = this._normalizeArcAngles(start, stop, vals.w, vals.h, true); + + if (angles.correspondToSamePoint) { + // If the arc starts and ends at (near enough) the same place, we choose to + // draw an ellipse instead. This is preferable to faking an ellipse (by + // making stop ever-so-slightly less than start + TWO_PI) because the ends + // join up to each other rather than at a vertex at the centre (leaving + // an unwanted spike in the stroke/fill). + this._renderer.ellipse([vals.x, vals.y, vals.w, vals.h, detail]); + } else { + this._renderer.arc( + vals.x, + vals.y, + vals.w, + vals.h, + angles.start, // [0, TWO_PI) + angles.stop, // [start, start + TWO_PI) + mode, + detail + ); + } + + return this; +}; + +/** + * Draws an ellipse (oval) to the screen. An ellipse with equal width and + * height is a circle. By default, the first two parameters set the location, + * and the third and fourth parameters set the shape's width and height. If + * no height is specified, the value of width is used for both the width and + * height. If a negative height or width is specified, the absolute value is taken. + * The origin may be changed with the ellipseMode() function. + * + * @method ellipse + * @param {Number} x x-coordinate of the ellipse. + * @param {Number} y y-coordinate of the ellipse. + * @param {Number} w width of the ellipse. + * @param {Number} [h] height of the ellipse. + * @chainable + * @example + *
    + * + * ellipse(56, 46, 55, 55); + * + *
    + * + * @alt + *white ellipse with black outline in middle-right of canvas that is 55x55. + * + */ +/** + * @method ellipse + * @param {Number} x + * @param {Number} y + * @param {Number} w + * @param {Number} h + * @param {Integer} detail number of radial sectors to draw (for WebGL mode) + */ +p5.prototype.ellipse = function(x, y, w, h, detailX) { + p5._validateParameters('ellipse', arguments); + + // if the current stroke and fill settings wouldn't result in something + // visible, exit immediately + if (!this._renderer._doStroke && !this._renderer._doFill) { + return this; + } + + // p5 supports negative width and heights for rects + if (w < 0) { + w = Math.abs(w); + } + + if (typeof h === 'undefined') { + // Duplicate 3rd argument if only 3 given. + h = w; + } else if (h < 0) { + h = Math.abs(h); + } + + var vals = canvas.modeAdjust(x, y, w, h, this._renderer._ellipseMode); + this._renderer.ellipse([vals.x, vals.y, vals.w, vals.h, detailX]); + + return this; +}; + +/** + * Draws a circle to the screen. A circle is a simple closed shape. + * It is the set of all points in a plane that are at a given distance from a given point, the centre. + * This function is a special case of the ellipse() function, where the width and height of the ellipse are the same. + * Height and width of the ellipse correspond to the diameter of the circle. + * By default, the first two parameters set the location of the centre of the circle, the third sets the diameter of the circle. + * + * @method circle + * @param {Number} x x-coordinate of the centre of the circle. + * @param {Number} y y-coordinate of the centre of the circle. + * @param {Number} d diameter of the circle. + * @chainable + * @example + *
    + * + * // Draw a circle at location (30, 30) with a diameter of 20. + * circle(30, 30, 20); + * + *
    + * + * @alt + * white circle with black outline in mid of canvas that is 55x55. + */ +p5.prototype.circle = function() { + var args = Array.prototype.slice.call(arguments, 0, 2); + args.push(arguments[2]); + args.push(arguments[2]); + return this.ellipse.apply(this, args); +}; + +/** + * Draws a line (a direct path between two points) to the screen. The version + * of line() with four parameters draws the line in 2D. To color a line, use + * the stroke() function. A line cannot be filled, therefore the fill() + * function will not affect the color of a line. 2D lines are drawn with a + * width of one pixel by default, but this can be changed with the + * strokeWeight() function. + * + * @method line + * @param {Number} x1 the x-coordinate of the first point + * @param {Number} y1 the y-coordinate of the first point + * @param {Number} x2 the x-coordinate of the second point + * @param {Number} y2 the y-coordinate of the second point + * @chainable + * @example + *
    + * + * line(30, 20, 85, 75); + * + *
    + * + *
    + * + * line(30, 20, 85, 20); + * stroke(126); + * line(85, 20, 85, 75); + * stroke(255); + * line(85, 75, 30, 75); + * + *
    + * + * @alt + *line 78 pixels long running from mid-top to bottom-right of canvas. + *3 lines of various stroke sizes. Form top, bottom and right sides of a square. + * + */ +/** + * @method line + * @param {Number} x1 + * @param {Number} y1 + * @param {Number} z1 the z-coordinate of the first point + * @param {Number} x2 + * @param {Number} y2 + * @param {Number} z2 the z-coordinate of the second point + * @chainable + */ +p5.prototype.line = function() { + p5._validateParameters('line', arguments); + + if (this._renderer._doStroke) { + this._renderer.line.apply(this._renderer, arguments); + } + + return this; +}; + +/** + * Draws a point, a coordinate in space at the dimension of one pixel. + * The first parameter is the horizontal value for the point, the second + * value is the vertical value for the point. The color of the point is + * determined by the current stroke. + * + * @method point + * @param {Number} x the x-coordinate + * @param {Number} y the y-coordinate + * @param {Number} [z] the z-coordinate (for WebGL mode) + * @chainable + * @example + *
    + * + * point(30, 20); + * point(85, 20); + * point(85, 75); + * point(30, 75); + * + *
    + * + * @alt + *4 points centered in the middle-right of the canvas. + * + */ +p5.prototype.point = function() { + p5._validateParameters('point', arguments); + + if (this._renderer._doStroke) { + this._renderer.point.apply(this._renderer, arguments); + } + + return this; +}; + +/** + * Draw a quad. A quad is a quadrilateral, a four sided polygon. It is + * similar to a rectangle, but the angles between its edges are not + * constrained to ninety degrees. The first pair of parameters (x1,y1) + * sets the first vertex and the subsequent pairs should proceed + * clockwise or counter-clockwise around the defined shape. + * z-arguments only work when quad() is used in WEBGL mode. + * + * + * @method quad + * @param {Number} x1 the x-coordinate of the first point + * @param {Number} y1 the y-coordinate of the first point + * @param {Number} x2 the x-coordinate of the second point + * @param {Number} y2 the y-coordinate of the second point + * @param {Number} x3 the x-coordinate of the third point + * @param {Number} y3 the y-coordinate of the third point + * @param {Number} x4 the x-coordinate of the fourth point + * @param {Number} y4 the y-coordinate of the fourth point + * @chainable + * @example + *
    + * + * quad(38, 31, 86, 20, 69, 63, 30, 76); + * + *
    + * + * @alt + *irregular white quadrilateral shape with black outline mid-right of canvas. + * + */ +/** + * @method quad + * @param {Number} x1 + * @param {Number} y1 + * @param {Number} z1 the z-coordinate of the first point + * @param {Number} x2 + * @param {Number} y2 + * @param {Number} z2 the z-coordinate of the second point + * @param {Number} x3 + * @param {Number} y3 + * @param {Number} z3 the z-coordinate of the third point + * @param {Number} x4 + * @param {Number} y4 + * @param {Number} z4 the z-coordinate of the fourth point + * @chainable + */ +p5.prototype.quad = function() { + p5._validateParameters('quad', arguments); + + if (this._renderer._doStroke || this._renderer._doFill) { + if (this._renderer.isP3D && arguments.length !== 12) { + // if 3D and we weren't passed 12 args, assume Z is 0 + // prettier-ignore + this._renderer.quad.call( + this._renderer, + arguments[0], arguments[1], 0, + arguments[2], arguments[3], 0, + arguments[4], arguments[5], 0, + arguments[6], arguments[7], 0); + } else { + this._renderer.quad.apply(this._renderer, arguments); + } + } + + return this; +}; + +/** + * Draws a rectangle to the screen. A rectangle is a four-sided shape with + * every angle at ninety degrees. By default, the first two parameters set + * the location of the upper-left corner, the third sets the width, and the + * fourth sets the height. The way these parameters are interpreted, however, + * may be changed with the rectMode() function. + *

    + * The fifth, sixth, seventh and eighth parameters, if specified, + * determine corner radius for the top-left, top-right, lower-right and + * lower-left corners, respectively. An omitted corner radius parameter is set + * to the value of the previously specified radius value in the parameter list. + * + * @method rect + * @param {Number} x x-coordinate of the rectangle. + * @param {Number} y y-coordinate of the rectangle. + * @param {Number} w width of the rectangle. + * @param {Number} h height of the rectangle. + * @param {Number} [tl] optional radius of top-left corner. + * @param {Number} [tr] optional radius of top-right corner. + * @param {Number} [br] optional radius of bottom-right corner. + * @param {Number} [bl] optional radius of bottom-left corner. + * @chainable + * @example + *
    + * + * // Draw a rectangle at location (30, 20) with a width and height of 55. + * rect(30, 20, 55, 55); + * + *
    + * + *
    + * + * // Draw a rectangle with rounded corners, each having a radius of 20. + * rect(30, 20, 55, 55, 20); + * + *
    + * + *
    + * + * // Draw a rectangle with rounded corners having the following radii: + * // top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5. + * rect(30, 20, 55, 55, 20, 15, 10, 5); + * + *
    + * + * @alt + * 55x55 white rect with black outline in mid-right of canvas. + * 55x55 white rect with black outline and rounded edges in mid-right of canvas. + * 55x55 white rect with black outline and rounded edges of different radii. + */ +/** + * @method rect + * @param {Number} x + * @param {Number} y + * @param {Number} w + * @param {Number} h + * @param {Integer} [detailX] number of segments in the x-direction (for WebGL mode) + * @param {Integer} [detailY] number of segments in the y-direction (for WebGL mode) + * @chainable + */ +p5.prototype.rect = function() { + p5._validateParameters('rect', arguments); + + if (this._renderer._doStroke || this._renderer._doFill) { + var vals = canvas.modeAdjust( + arguments[0], + arguments[1], + arguments[2], + arguments[3], + this._renderer._rectMode + ); + var args = [vals.x, vals.y, vals.w, vals.h]; + // append the additional arguments (either cornder radii, or + // segment details) to the argument list + for (var i = 4; i < arguments.length; i++) { + args[i] = arguments[i]; + } + this._renderer.rect(args); + } + + return this; +}; + +/** + * Draws a square to the screen. A square is a four-sided shape with + * every angle at ninety degrees, and equal side size. + * This function is a special case of the rect() function, where the width and height are the same, and the parameter is called "s" for side size. + * By default, the first two parameters set the location of the upper-left corner, the third sets the side size of the square. + * The way these parameters are interpreted, however, + * may be changed with the rectMode() function. + *

    + * The fourth, fifth, sixth and seventh parameters, if specified, + * determine corner radius for the top-left, top-right, lower-right and + * lower-left corners, respectively. An omitted corner radius parameter is set + * to the value of the previously specified radius value in the parameter list. + * + * @method square + * @param {Number} x x-coordinate of the square. + * @param {Number} y y-coordinate of the square. + * @param {Number} s side size of the square. + * @param {Number} [tl] optional radius of top-left corner. + * @param {Number} [tr] optional radius of top-right corner. + * @param {Number} [br] optional radius of bottom-right corner. + * @param {Number} [bl] optional radius of bottom-left corner. + * @chainable + * @example + *
    + * + * // Draw a square at location (30, 20) with a side size of 55. + * square(30, 20, 55); + * + *
    + * + *
    + * + * // Draw a square with rounded corners, each having a radius of 20. + * square(30, 20, 55, 20); + * + *
    + * + *
    + * + * // Draw a square with rounded corners having the following radii: + * // top-left = 20, top-right = 15, bottom-right = 10, bottom-left = 5. + * square(30, 20, 55, 20, 15, 10, 5); + * + *
    + * + * @alt + * 55x55 white square with black outline in mid-right of canvas. + * 55x55 white square with black outline and rounded edges in mid-right of canvas. + * 55x55 white square with black outline and rounded edges of different radii. + */ +p5.prototype.square = function(x, y, s, tl, tr, br, bl) { + return this.rect(x, y, s, s, tl, tr, br, bl); +}; + +/** + * A triangle is a plane created by connecting three points. The first two + * arguments specify the first point, the middle two arguments specify the + * second point, and the last two arguments specify the third point. + * + * @method triangle + * @param {Number} x1 x-coordinate of the first point + * @param {Number} y1 y-coordinate of the first point + * @param {Number} x2 x-coordinate of the second point + * @param {Number} y2 y-coordinate of the second point + * @param {Number} x3 x-coordinate of the third point + * @param {Number} y3 y-coordinate of the third point + * @chainable + * @example + *
    + * + * triangle(30, 75, 58, 20, 86, 75); + * + *
    + * + *@alt + * white triangle with black outline in mid-right of canvas. + * + */ +p5.prototype.triangle = function() { + p5._validateParameters('triangle', arguments); + + if (this._renderer._doStroke || this._renderer._doFill) { + this._renderer.triangle(arguments); + } + + return this; +}; + +module.exports = p5; + +},{"../constants":18,"../error_helpers":20,"../helpers":21,"../main":24}],31:[function(_dereq_,module,exports){ +/** + * @module Shape + * @submodule Attributes + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../main'); +var constants = _dereq_('../constants'); + +/** + * Modifies the location from which ellipses are drawn by changing the way + * in which parameters given to ellipse() are interpreted. + *

    + * The default mode is ellipseMode(CENTER), which interprets the first two + * parameters of ellipse() as the shape's center point, while the third and + * fourth parameters are its width and height. + *

    + * ellipseMode(RADIUS) also uses the first two parameters of ellipse() as + * the shape's center point, but uses the third and fourth parameters to + * specify half of the shapes's width and height. + *

    + * ellipseMode(CORNER) interprets the first two parameters of ellipse() as + * the upper-left corner of the shape, while the third and fourth parameters + * are its width and height. + *

    + * ellipseMode(CORNERS) interprets the first two parameters of ellipse() as + * the location of one corner of the ellipse's bounding box, and the third + * and fourth parameters as the location of the opposite corner. + *

    + * The parameter must be written in ALL CAPS because Javascript is a + * case-sensitive language. + * + * @method ellipseMode + * @param {Constant} mode either CENTER, RADIUS, CORNER, or CORNERS + * @chainable + * @example + *
    + * + * ellipseMode(RADIUS); // Set ellipseMode to RADIUS + * fill(255); // Set fill to white + * ellipse(50, 50, 30, 30); // Draw white ellipse using RADIUS mode + * + * ellipseMode(CENTER); // Set ellipseMode to CENTER + * fill(100); // Set fill to gray + * ellipse(50, 50, 30, 30); // Draw gray ellipse using CENTER mode + * + *
    + * + *
    + * + * ellipseMode(CORNER); // Set ellipseMode is CORNER + * fill(255); // Set fill to white + * ellipse(25, 25, 50, 50); // Draw white ellipse using CORNER mode + * + * ellipseMode(CORNERS); // Set ellipseMode to CORNERS + * fill(100); // Set fill to gray + * ellipse(25, 25, 50, 50); // Draw gray ellipse using CORNERS mode + * + *
    + * + * @alt + * 60x60 white ellipse and 30x30 grey ellipse with black outlines at center. + * 60x60 white ellipse @center and 30x30 grey ellipse top-right, black outlines. + * + */ +p5.prototype.ellipseMode = function(m) { + p5._validateParameters('ellipseMode', arguments); + if ( + m === constants.CORNER || + m === constants.CORNERS || + m === constants.RADIUS || + m === constants.CENTER + ) { + this._renderer._ellipseMode = m; + } + return this; +}; + +/** + * Draws all geometry with jagged (aliased) edges. Note that smooth() is + * active by default in 2D mode, so it is necessary to call noSmooth() to disable + * smoothing of geometry, images, and fonts. In 3D mode, noSmooth() is enabled + * by default, so it is necessary to call smooth() if you would like + * smooth (antialiased) edges on your geometry. + * + * @method noSmooth + * @chainable + * @example + *
    + * + * background(0); + * noStroke(); + * smooth(); + * ellipse(30, 48, 36, 36); + * noSmooth(); + * ellipse(70, 48, 36, 36); + * + *
    + * + * @alt + * 2 pixelated 36x36 white ellipses to left & right of center, black background + * + */ +p5.prototype.noSmooth = function() { + this.setAttributes('antialias', false); + if ('imageSmoothingEnabled' in this.drawingContext) { + this.drawingContext.imageSmoothingEnabled = false; + } + return this; +}; + +/** + * Modifies the location from which rectangles are drawn by changing the way + * in which parameters given to rect() are interpreted. + *

    + * The default mode is rectMode(CORNER), which interprets the first two + * parameters of rect() as the upper-left corner of the shape, while the + * third and fourth parameters are its width and height. + *

    + * rectMode(CORNERS) interprets the first two parameters of rect() as the + * location of one corner, and the third and fourth parameters as the + * location of the opposite corner. + *

    + * rectMode(CENTER) interprets the first two parameters of rect() as the + * shape's center point, while the third and fourth parameters are its + * width and height. + *

    + * rectMode(RADIUS) also uses the first two parameters of rect() as the + * shape's center point, but uses the third and fourth parameters to specify + * half of the shapes's width and height. + *

    + * The parameter must be written in ALL CAPS because Javascript is a + * case-sensitive language. + * + * @method rectMode + * @param {Constant} mode either CORNER, CORNERS, CENTER, or RADIUS + * @chainable + * @example + *
    + * + * rectMode(CORNER); // Default rectMode is CORNER + * fill(255); // Set fill to white + * rect(25, 25, 50, 50); // Draw white rect using CORNER mode + * + * rectMode(CORNERS); // Set rectMode to CORNERS + * fill(100); // Set fill to gray + * rect(25, 25, 50, 50); // Draw gray rect using CORNERS mode + * + *
    + * + *
    + * + * rectMode(RADIUS); // Set rectMode to RADIUS + * fill(255); // Set fill to white + * rect(50, 50, 30, 30); // Draw white rect using RADIUS mode + * + * rectMode(CENTER); // Set rectMode to CENTER + * fill(100); // Set fill to gray + * rect(50, 50, 30, 30); // Draw gray rect using CENTER mode + * + *
    + * + * @alt + * 50x50 white rect at center and 25x25 grey rect in the top left of the other. + * 50x50 white rect at center and 25x25 grey rect in the center of the other. + * + */ +p5.prototype.rectMode = function(m) { + p5._validateParameters('rectMode', arguments); + if ( + m === constants.CORNER || + m === constants.CORNERS || + m === constants.RADIUS || + m === constants.CENTER + ) { + this._renderer._rectMode = m; + } + return this; +}; + +/** + * Draws all geometry with smooth (anti-aliased) edges. smooth() will also + * improve image quality of resized images. Note that smooth() is active by + * default in 2D mode; noSmooth() can be used to disable smoothing of geometry, + * images, and fonts. In 3D mode, noSmooth() is enabled + * by default, so it is necessary to call smooth() if you would like + * smooth (antialiased) edges on your geometry. + * + * @method smooth + * @chainable + * @example + *
    + * + * background(0); + * noStroke(); + * smooth(); + * ellipse(30, 48, 36, 36); + * noSmooth(); + * ellipse(70, 48, 36, 36); + * + *
    + * + * @alt + * 2 pixelated 36x36 white ellipses one left one right of center. On black. + * + */ +p5.prototype.smooth = function() { + this.setAttributes('antialias', true); + if ('imageSmoothingEnabled' in this.drawingContext) { + this.drawingContext.imageSmoothingEnabled = true; + } + return this; +}; + +/** + * Sets the style for rendering line endings. These ends are either squared, + * extended, or rounded, each of which specified with the corresponding + * parameters: SQUARE, PROJECT, and ROUND. The default cap is ROUND. + * + * @method strokeCap + * @param {Constant} cap either SQUARE, PROJECT, or ROUND + * @chainable + * @example + *
    + * + * strokeWeight(12.0); + * strokeCap(ROUND); + * line(20, 30, 80, 30); + * strokeCap(SQUARE); + * line(20, 50, 80, 50); + * strokeCap(PROJECT); + * line(20, 70, 80, 70); + * + *
    + * + * @alt + * 3 lines. Top line: rounded ends, mid: squared, bottom:longer squared ends. + * + */ +p5.prototype.strokeCap = function(cap) { + p5._validateParameters('strokeCap', arguments); + if ( + cap === constants.ROUND || + cap === constants.SQUARE || + cap === constants.PROJECT + ) { + this._renderer.strokeCap(cap); + } + return this; +}; + +/** + * Sets the style of the joints which connect line segments. These joints + * are either mitered, beveled, or rounded and specified with the + * corresponding parameters MITER, BEVEL, and ROUND. The default joint is + * MITER. + * + * @method strokeJoin + * @param {Constant} join either MITER, BEVEL, ROUND + * @chainable + * @example + *
    + * + * noFill(); + * strokeWeight(10.0); + * strokeJoin(MITER); + * beginShape(); + * vertex(35, 20); + * vertex(65, 50); + * vertex(35, 80); + * endShape(); + * + *
    + * + *
    + * + * noFill(); + * strokeWeight(10.0); + * strokeJoin(BEVEL); + * beginShape(); + * vertex(35, 20); + * vertex(65, 50); + * vertex(35, 80); + * endShape(); + * + *
    + * + *
    + * + * noFill(); + * strokeWeight(10.0); + * strokeJoin(ROUND); + * beginShape(); + * vertex(35, 20); + * vertex(65, 50); + * vertex(35, 80); + * endShape(); + * + *
    + * + * @alt + * Right-facing arrowhead shape with pointed tip in center of canvas. + * Right-facing arrowhead shape with flat tip in center of canvas. + * Right-facing arrowhead shape with rounded tip in center of canvas. + * + */ +p5.prototype.strokeJoin = function(join) { + p5._validateParameters('strokeJoin', arguments); + if ( + join === constants.ROUND || + join === constants.BEVEL || + join === constants.MITER + ) { + this._renderer.strokeJoin(join); + } + return this; +}; + +/** + * Sets the width of the stroke used for lines, points, and the border + * around shapes. All widths are set in units of pixels. + * + * @method strokeWeight + * @param {Number} weight the weight (in pixels) of the stroke + * @chainable + * @example + *
    + * + * strokeWeight(1); // Default + * line(20, 20, 80, 20); + * strokeWeight(4); // Thicker + * line(20, 40, 80, 40); + * strokeWeight(10); // Beastly + * line(20, 70, 80, 70); + * + *
    + * + * @alt + * 3 horizontal black lines. Top line: thin, mid: medium, bottom:thick. + * + */ +p5.prototype.strokeWeight = function(w) { + p5._validateParameters('strokeWeight', arguments); + this._renderer.strokeWeight(w); + return this; +}; + +module.exports = p5; + +},{"../constants":18,"../main":24}],32:[function(_dereq_,module,exports){ +/** + * @module Shape + * @submodule Curves + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../main'); +_dereq_('../error_helpers'); + +/** + * Draws a cubic Bezier curve on the screen. These curves are defined by a + * series of anchor and control points. The first two parameters specify + * the first anchor point and the last two parameters specify the other + * anchor point, which become the first and last points on the curve. The + * middle parameters specify the two control points which define the shape + * of the curve. Approximately speaking, control points "pull" the curve + * towards them.

    Bezier curves were developed by French + * automotive engineer Pierre Bezier, and are commonly used in computer + * graphics to define gently sloping curves. See also curve(). + * + * @method bezier + * @param {Number} x1 x-coordinate for the first anchor point + * @param {Number} y1 y-coordinate for the first anchor point + * @param {Number} x2 x-coordinate for the first control point + * @param {Number} y2 y-coordinate for the first control point + * @param {Number} x3 x-coordinate for the second control point + * @param {Number} y3 y-coordinate for the second control point + * @param {Number} x4 x-coordinate for the second anchor point + * @param {Number} y4 y-coordinate for the second anchor point + * @chainable + * @example + *
    + * + * noFill(); + * stroke(255, 102, 0); + * line(85, 20, 10, 10); + * line(90, 90, 15, 80); + * stroke(0, 0, 0); + * bezier(85, 20, 10, 10, 90, 90, 15, 80); + * + *
    + * + *
    + * + * background(0, 0, 0); + * noFill(); + * stroke(255); + * bezier(250, 250, 0, 100, 100, 0, 100, 0, 0, 0, 100, 0); + * + *
    + * + * @alt + * stretched black s-shape in center with orange lines extending from end points. + * stretched black s-shape with 10 5x5 white ellipses along the shape. + * stretched black s-shape with 7 5x5 ellipses and orange lines along the shape. + * stretched black s-shape with 17 small orange lines extending from under shape. + * horseshoe shape with orange ends facing left and black curved center. + * horseshoe shape with orange ends facing left and black curved center. + * Line shaped like right-facing arrow,points move with mouse-x and warp shape. + * horizontal line that hooks downward on the right and 13 5x5 ellipses along it. + * right curving line mid-right of canvas with 7 short lines radiating from it. + */ +/** + * @method bezier + * @param {Number} x1 + * @param {Number} y1 + * @param {Number} z1 z-coordinate for the first anchor point + * @param {Number} x2 + * @param {Number} y2 + * @param {Number} z2 z-coordinate for the first control point + * @param {Number} x3 + * @param {Number} y3 + * @param {Number} z3 z-coordinate for the second control point + * @param {Number} x4 + * @param {Number} y4 + * @param {Number} z4 z-coordinate for the second anchor point + * @chainable + */ +p5.prototype.bezier = function() { + p5._validateParameters('bezier', arguments); + + // if the current stroke and fill settings wouldn't result in something + // visible, exit immediately + if (!this._renderer._doStroke && !this._renderer._doFill) { + return this; + } + + this._renderer.bezier.apply(this._renderer, arguments); + + return this; +}; + +/** + * Sets the resolution at which Beziers display. + * + * The default value is 20. + * + * This function is only useful when using the WEBGL renderer + * as the default canvas renderer does not use this information. + * + * @method bezierDetail + * @param {Number} detail resolution of the curves + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * noFill(); + * + * bezierDetail(5); + * } + * + * function draw() { + * background(200); + * + * // prettier-ignore + * bezier(-40, -40, 0, + * 90, -40, 0, + * -90, 40, 0, + * 40, 40, 0); + * } + * + *
    + * + * @alt + * stretched black s-shape with a low level of bezier detail + * + */ +p5.prototype.bezierDetail = function(d) { + p5._validateParameters('bezierDetail', arguments); + this._bezierDetail = d; + return this; +}; + +/** + * Evaluates the Bezier at position t for points a, b, c, d. + * The parameters a and d are the first and last points + * on the curve, and b and c are the control points. + * The final parameter t varies between 0 and 1. + * This can be done once with the x coordinates and a second time + * with the y coordinates to get the location of a bezier curve at t. + * + * @method bezierPoint + * @param {Number} a coordinate of first point on the curve + * @param {Number} b coordinate of first control point + * @param {Number} c coordinate of second control point + * @param {Number} d coordinate of second point on the curve + * @param {Number} t value between 0 and 1 + * @return {Number} the value of the Bezier at position t + * @example + *
    + * + * noFill(); + * let x1 = 85, + x2 = 10, + x3 = 90, + x4 = 15; + * let y1 = 20, + y2 = 10, + y3 = 90, + y4 = 80; + * bezier(x1, y1, x2, y2, x3, y3, x4, y4); + * fill(255); + * let steps = 10; + * for (let i = 0; i <= steps; i++) { + * let t = i / steps; + * let x = bezierPoint(x1, x2, x3, x4, t); + * let y = bezierPoint(y1, y2, y3, y4, t); + * ellipse(x, y, 5, 5); + * } + * + *
    + * + * @alt + * stretched black s-shape with 17 small orange lines extending from under shape. + * + */ +p5.prototype.bezierPoint = function(a, b, c, d, t) { + p5._validateParameters('bezierPoint', arguments); + + var adjustedT = 1 - t; + return ( + Math.pow(adjustedT, 3) * a + + 3 * Math.pow(adjustedT, 2) * t * b + + 3 * adjustedT * Math.pow(t, 2) * c + + Math.pow(t, 3) * d + ); +}; + +/** + * Evaluates the tangent to the Bezier at position t for points a, b, c, d. + * The parameters a and d are the first and last points + * on the curve, and b and c are the control points. + * The final parameter t varies between 0 and 1. + * + * @method bezierTangent + * @param {Number} a coordinate of first point on the curve + * @param {Number} b coordinate of first control point + * @param {Number} c coordinate of second control point + * @param {Number} d coordinate of second point on the curve + * @param {Number} t value between 0 and 1 + * @return {Number} the tangent at position t + * @example + *
    + * + * noFill(); + * bezier(85, 20, 10, 10, 90, 90, 15, 80); + * let steps = 6; + * fill(255); + * for (let i = 0; i <= steps; i++) { + * let t = i / steps; + * // Get the location of the point + * let x = bezierPoint(85, 10, 90, 15, t); + * let y = bezierPoint(20, 10, 90, 80, t); + * // Get the tangent points + * let tx = bezierTangent(85, 10, 90, 15, t); + * let ty = bezierTangent(20, 10, 90, 80, t); + * // Calculate an angle from the tangent points + * let a = atan2(ty, tx); + * a += PI; + * stroke(255, 102, 0); + * line(x, y, cos(a) * 30 + x, sin(a) * 30 + y); + * // The following line of code makes a line + * // inverse of the above line + * //line(x, y, cos(a)*-30 + x, sin(a)*-30 + y); + * stroke(0); + * ellipse(x, y, 5, 5); + * } + * + *
    + * + *
    + * + * noFill(); + * bezier(85, 20, 10, 10, 90, 90, 15, 80); + * stroke(255, 102, 0); + * let steps = 16; + * for (let i = 0; i <= steps; i++) { + * let t = i / steps; + * let x = bezierPoint(85, 10, 90, 15, t); + * let y = bezierPoint(20, 10, 90, 80, t); + * let tx = bezierTangent(85, 10, 90, 15, t); + * let ty = bezierTangent(20, 10, 90, 80, t); + * let a = atan2(ty, tx); + * a -= HALF_PI; + * line(x, y, cos(a) * 8 + x, sin(a) * 8 + y); + * } + * + *
    + * + * @alt + * s-shaped line with 17 short orange lines extending from underside of shape + * + */ +p5.prototype.bezierTangent = function(a, b, c, d, t) { + p5._validateParameters('bezierTangent', arguments); + + var adjustedT = 1 - t; + return ( + 3 * d * Math.pow(t, 2) - + 3 * c * Math.pow(t, 2) + + 6 * c * adjustedT * t - + 6 * b * adjustedT * t + + 3 * b * Math.pow(adjustedT, 2) - + 3 * a * Math.pow(adjustedT, 2) + ); +}; + +/** + * Draws a curved line on the screen between two points, given as the + * middle four parameters. The first two parameters are a control point, as + * if the curve came from this point even though it's not drawn. The last + * two parameters similarly describe the other control point.

    + * Longer curves can be created by putting a series of curve() functions + * together or using curveVertex(). An additional function called + * curveTightness() provides control for the visual quality of the curve. + * The curve() function is an implementation of Catmull-Rom splines. + * + * @method curve + * @param {Number} x1 x-coordinate for the beginning control point + * @param {Number} y1 y-coordinate for the beginning control point + * @param {Number} x2 x-coordinate for the first point + * @param {Number} y2 y-coordinate for the first point + * @param {Number} x3 x-coordinate for the second point + * @param {Number} y3 y-coordinate for the second point + * @param {Number} x4 x-coordinate for the ending control point + * @param {Number} y4 y-coordinate for the ending control point + * @chainable + * @example + *
    + * + * noFill(); + * stroke(255, 102, 0); + * curve(5, 26, 5, 26, 73, 24, 73, 61); + * stroke(0); + * curve(5, 26, 73, 24, 73, 61, 15, 65); + * stroke(255, 102, 0); + * curve(73, 24, 73, 61, 15, 65, 15, 65); + * + *
    + *
    + * + * // Define the curve points as JavaScript objects + * let p1 = { x: 5, y: 26 }, + p2 = { x: 73, y: 24 }; + * let p3 = { x: 73, y: 61 }, + p4 = { x: 15, y: 65 }; + * noFill(); + * stroke(255, 102, 0); + * curve(p1.x, p1.y, p1.x, p1.y, p2.x, p2.y, p3.x, p3.y); + * stroke(0); + * curve(p1.x, p1.y, p2.x, p2.y, p3.x, p3.y, p4.x, p4.y); + * stroke(255, 102, 0); + * curve(p2.x, p2.y, p3.x, p3.y, p4.x, p4.y, p4.x, p4.y); + * + *
    + *
    + * + * noFill(); + * stroke(255, 102, 0); + * curve(5, 26, 0, 5, 26, 0, 73, 24, 0, 73, 61, 0); + * stroke(0); + * curve(5, 26, 0, 73, 24, 0, 73, 61, 0, 15, 65, 0); + * stroke(255, 102, 0); + * curve(73, 24, 0, 73, 61, 0, 15, 65, 0, 15, 65, 0); + * + *
    + * + * @alt + * horseshoe shape with orange ends facing left and black curved center. + * horseshoe shape with orange ends facing left and black curved center. + * curving black and orange lines. + */ +/** + * @method curve + * @param {Number} x1 + * @param {Number} y1 + * @param {Number} z1 z-coordinate for the beginning control point + * @param {Number} x2 + * @param {Number} y2 + * @param {Number} z2 z-coordinate for the first point + * @param {Number} x3 + * @param {Number} y3 + * @param {Number} z3 z-coordinate for the second point + * @param {Number} x4 + * @param {Number} y4 + * @param {Number} z4 z-coordinate for the ending control point + * @chainable + */ +p5.prototype.curve = function() { + p5._validateParameters('curve', arguments); + + if (this._renderer._doStroke) { + this._renderer.curve.apply(this._renderer, arguments); + } + + return this; +}; + +/** + * Sets the resolution at which curves display. + * + * The default value is 20 while the minimum value is 3. + * + * This function is only useful when using the WEBGL renderer + * as the default canvas renderer does not use this + * information. + * + * @method curveDetail + * @param {Number} resolution resolution of the curves + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * + * curveDetail(5); + * } + * function draw() { + * background(200); + * + * curve(250, 600, 0, -30, 40, 0, 30, 30, 0, -250, 600, 0); + * } + * + *
    + * + * @alt + * white arch shape with a low level of curve detail. + * + */ +p5.prototype.curveDetail = function(d) { + p5._validateParameters('curveDetail', arguments); + if (d < 3) { + this._curveDetail = 3; + } else { + this._curveDetail = d; + } + return this; +}; + +/** + * Modifies the quality of forms created with curve() and curveVertex(). + * The parameter tightness determines how the curve fits to the vertex + * points. The value 0.0 is the default value for tightness (this value + * defines the curves to be Catmull-Rom splines) and the value 1.0 connects + * all the points with straight lines. Values within the range -5.0 and 5.0 + * will deform the curves but will leave them recognizable and as values + * increase in magnitude, they will continue to deform. + * + * @method curveTightness + * @param {Number} amount amount of deformation from the original vertices + * @chainable + * @example + *
    + * + * // Move the mouse left and right to see the curve change + * + * function setup() { + * createCanvas(100, 100); + * noFill(); + * } + * + * function draw() { + * background(204); + * let t = map(mouseX, 0, width, -5, 5); + * curveTightness(t); + * beginShape(); + * curveVertex(10, 26); + * curveVertex(10, 26); + * curveVertex(83, 24); + * curveVertex(83, 61); + * curveVertex(25, 65); + * curveVertex(25, 65); + * endShape(); + * } + * + *
    + * + * @alt + * Line shaped like right-facing arrow,points move with mouse-x and warp shape. + */ +p5.prototype.curveTightness = function(t) { + p5._validateParameters('curveTightness', arguments); + this._renderer._curveTightness = t; + return this; +}; + +/** + * Evaluates the curve at position t for points a, b, c, d. + * The parameter t varies between 0 and 1, a and d are control points + * of the curve, and b and c are the start and end points of the curve. + * This can be done once with the x coordinates and a second time + * with the y coordinates to get the location of a curve at t. + * + * @method curvePoint + * @param {Number} a coordinate of first control point of the curve + * @param {Number} b coordinate of first point + * @param {Number} c coordinate of second point + * @param {Number} d coordinate of second control point + * @param {Number} t value between 0 and 1 + * @return {Number} bezier value at position t + * @example + *
    + * + * noFill(); + * curve(5, 26, 5, 26, 73, 24, 73, 61); + * curve(5, 26, 73, 24, 73, 61, 15, 65); + * fill(255); + * ellipseMode(CENTER); + * let steps = 6; + * for (let i = 0; i <= steps; i++) { + * let t = i / steps; + * let x = curvePoint(5, 5, 73, 73, t); + * let y = curvePoint(26, 26, 24, 61, t); + * ellipse(x, y, 5, 5); + * x = curvePoint(5, 73, 73, 15, t); + * y = curvePoint(26, 24, 61, 65, t); + * ellipse(x, y, 5, 5); + * } + * + *
    + * + *line hooking down to right-bottom with 13 5x5 white ellipse points + */ +p5.prototype.curvePoint = function(a, b, c, d, t) { + p5._validateParameters('curvePoint', arguments); + + var t3 = t * t * t, + t2 = t * t, + f1 = -0.5 * t3 + t2 - 0.5 * t, + f2 = 1.5 * t3 - 2.5 * t2 + 1.0, + f3 = -1.5 * t3 + 2.0 * t2 + 0.5 * t, + f4 = 0.5 * t3 - 0.5 * t2; + return a * f1 + b * f2 + c * f3 + d * f4; +}; + +/** + * Evaluates the tangent to the curve at position t for points a, b, c, d. + * The parameter t varies between 0 and 1, a and d are points on the curve, + * and b and c are the control points. + * + * @method curveTangent + * @param {Number} a coordinate of first point on the curve + * @param {Number} b coordinate of first control point + * @param {Number} c coordinate of second control point + * @param {Number} d coordinate of second point on the curve + * @param {Number} t value between 0 and 1 + * @return {Number} the tangent at position t + * @example + *
    + * + * noFill(); + * curve(5, 26, 73, 24, 73, 61, 15, 65); + * let steps = 6; + * for (let i = 0; i <= steps; i++) { + * let t = i / steps; + * let x = curvePoint(5, 73, 73, 15, t); + * let y = curvePoint(26, 24, 61, 65, t); + * //ellipse(x, y, 5, 5); + * let tx = curveTangent(5, 73, 73, 15, t); + * let ty = curveTangent(26, 24, 61, 65, t); + * let a = atan2(ty, tx); + * a -= PI / 2.0; + * line(x, y, cos(a) * 8 + x, sin(a) * 8 + y); + * } + * + *
    + * + * @alt + *right curving line mid-right of canvas with 7 short lines radiating from it. + */ +p5.prototype.curveTangent = function(a, b, c, d, t) { + p5._validateParameters('curveTangent', arguments); + + var t2 = t * t, + f1 = -3 * t2 / 2 + 2 * t - 0.5, + f2 = 9 * t2 / 2 - 5 * t, + f3 = -9 * t2 / 2 + 4 * t + 0.5, + f4 = 3 * t2 / 2 - t; + return a * f1 + b * f2 + c * f3 + d * f4; +}; + +module.exports = p5; + +},{"../error_helpers":20,"../main":24}],33:[function(_dereq_,module,exports){ +/** + * @module Shape + * @submodule Vertex + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../main'); +var constants = _dereq_('../constants'); +var shapeKind = null; +var vertices = []; +var contourVertices = []; +var isBezier = false; +var isCurve = false; +var isQuadratic = false; +var isContour = false; +var isFirstContour = true; + +/** + * Use the beginContour() and endContour() functions to create negative + * shapes within shapes such as the center of the letter 'O'. beginContour() + * begins recording vertices for the shape and endContour() stops recording. + * The vertices that define a negative shape must "wind" in the opposite + * direction from the exterior shape. First draw vertices for the exterior + * clockwise order, then for internal shapes, draw vertices + * shape in counter-clockwise. + *

    + * These functions can only be used within a beginShape()/endShape() pair and + * transformations such as translate(), rotate(), and scale() do not work + * within a beginContour()/endContour() pair. It is also not possible to use + * other shapes, such as ellipse() or rect() within. + * + * @method beginContour + * @chainable + * @example + *
    + * + * translate(50, 50); + * stroke(255, 0, 0); + * beginShape(); + * // Exterior part of shape, clockwise winding + * vertex(-40, -40); + * vertex(40, -40); + * vertex(40, 40); + * vertex(-40, 40); + * // Interior part of shape, counter-clockwise winding + * beginContour(); + * vertex(-20, -20); + * vertex(-20, 20); + * vertex(20, 20); + * vertex(20, -20); + * endContour(); + * endShape(CLOSE); + * + *
    + * + * @alt + * white rect and smaller grey rect with red outlines in center of canvas. + * + */ +p5.prototype.beginContour = function() { + contourVertices = []; + isContour = true; + return this; +}; + +/** + * Using the beginShape() and endShape() functions allow creating more + * complex forms. beginShape() begins recording vertices for a shape and + * endShape() stops recording. The value of the kind parameter tells it which + * types of shapes to create from the provided vertices. With no mode + * specified, the shape can be any irregular polygon. + *

    + * The parameters available for beginShape() are POINTS, LINES, TRIANGLES, + * TRIANGLE_FAN, TRIANGLE_STRIP, QUADS, and QUAD_STRIP. After calling the + * beginShape() function, a series of vertex() commands must follow. To stop + * drawing the shape, call endShape(). Each shape will be outlined with the + * current stroke color and filled with the fill color. + *

    + * Transformations such as translate(), rotate(), and scale() do not work + * within beginShape(). It is also not possible to use other shapes, such as + * ellipse() or rect() within beginShape(). + * + * @method beginShape + * @param {Constant} [kind] either POINTS, LINES, TRIANGLES, TRIANGLE_FAN + * TRIANGLE_STRIP, QUADS, or QUAD_STRIP + * @chainable + * @example + *
    + * + * beginShape(); + * vertex(30, 20); + * vertex(85, 20); + * vertex(85, 75); + * vertex(30, 75); + * endShape(CLOSE); + * + *
    + * + *
    + * + * beginShape(POINTS); + * vertex(30, 20); + * vertex(85, 20); + * vertex(85, 75); + * vertex(30, 75); + * endShape(); + * + *
    + * + *
    + * + * beginShape(LINES); + * vertex(30, 20); + * vertex(85, 20); + * vertex(85, 75); + * vertex(30, 75); + * endShape(); + * + *
    + * + *
    + * + * noFill(); + * beginShape(); + * vertex(30, 20); + * vertex(85, 20); + * vertex(85, 75); + * vertex(30, 75); + * endShape(); + * + *
    + * + *
    + * + * noFill(); + * beginShape(); + * vertex(30, 20); + * vertex(85, 20); + * vertex(85, 75); + * vertex(30, 75); + * endShape(CLOSE); + * + *
    + * + *
    + * + * beginShape(TRIANGLES); + * vertex(30, 75); + * vertex(40, 20); + * vertex(50, 75); + * vertex(60, 20); + * vertex(70, 75); + * vertex(80, 20); + * endShape(); + * + *
    + * + *
    + * + * beginShape(TRIANGLE_STRIP); + * vertex(30, 75); + * vertex(40, 20); + * vertex(50, 75); + * vertex(60, 20); + * vertex(70, 75); + * vertex(80, 20); + * vertex(90, 75); + * endShape(); + * + *
    + * + *
    + * + * beginShape(TRIANGLE_FAN); + * vertex(57.5, 50); + * vertex(57.5, 15); + * vertex(92, 50); + * vertex(57.5, 85); + * vertex(22, 50); + * vertex(57.5, 15); + * endShape(); + * + *
    + * + *
    + * + * beginShape(QUADS); + * vertex(30, 20); + * vertex(30, 75); + * vertex(50, 75); + * vertex(50, 20); + * vertex(65, 20); + * vertex(65, 75); + * vertex(85, 75); + * vertex(85, 20); + * endShape(); + * + *
    + * + *
    + * + * beginShape(QUAD_STRIP); + * vertex(30, 20); + * vertex(30, 75); + * vertex(50, 20); + * vertex(50, 75); + * vertex(65, 20); + * vertex(65, 75); + * vertex(85, 20); + * vertex(85, 75); + * endShape(); + * + *
    + * + *
    + * + * beginShape(); + * vertex(20, 20); + * vertex(40, 20); + * vertex(40, 40); + * vertex(60, 40); + * vertex(60, 60); + * vertex(20, 60); + * endShape(CLOSE); + * + *
    + * @alt + * white square-shape with black outline in middle-right of canvas. + * 4 black points in a square shape in middle-right of canvas. + * 2 horizontal black lines. In the top-right and bottom-right of canvas. + * 3 line shape with horizontal on top, vertical in middle and horizontal bottom. + * square line shape in middle-right of canvas. + * 2 white triangle shapes mid-right canvas. left one pointing up and right down. + * 5 horizontal interlocking and alternating white triangles in mid-right canvas. + * 4 interlocking white triangles in 45 degree rotated square-shape. + * 2 white rectangle shapes in mid-right canvas. Both 20x55. + * 3 side-by-side white rectangles center rect is smaller in mid-right canvas. + * Thick white l-shape with black outline mid-top-left of canvas. + * + */ +p5.prototype.beginShape = function(kind) { + p5._validateParameters('beginShape', arguments); + if (this._renderer.isP3D) { + this._renderer.beginShape.apply(this._renderer, arguments); + } else { + if ( + kind === constants.POINTS || + kind === constants.LINES || + kind === constants.TRIANGLES || + kind === constants.TRIANGLE_FAN || + kind === constants.TRIANGLE_STRIP || + kind === constants.QUADS || + kind === constants.QUAD_STRIP + ) { + shapeKind = kind; + } else { + shapeKind = null; + } + + 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. For WebGL mode bezierVertex() can be used in 2D + * as well as 3D mode. 2D mode expects 6 parameters, while 3D mode + * expects 9 parameters (including z coordinates). + *

    + * The first time bezierVertex() is used within a beginShape() + * call, it must be prefaced with a call to vertex() to set the first anchor + * point. This function must be used between beginShape() and endShape() + * and only when there is no MODE or POINTS parameter specified to + * beginShape(). + * + * @method bezierVertex + * @param {Number} x2 x-coordinate for the first control point + * @param {Number} y2 y-coordinate for the first control point + * @param {Number} x3 x-coordinate for the second control point + * @param {Number} y3 y-coordinate for the second control point + * @param {Number} x4 x-coordinate for the anchor point + * @param {Number} y4 y-coordinate for the anchor point + * @chainable + * + * @example + *
    + * + * noFill(); + * beginShape(); + * vertex(30, 20); + * bezierVertex(80, 0, 80, 75, 30, 75); + * endShape(); + * + *
    + * + * @alt + * crescent-shaped line in middle of canvas. Points facing left. + * + * @example + *
    + * + * beginShape(); + * vertex(30, 20); + * bezierVertex(80, 0, 80, 75, 30, 75); + * bezierVertex(50, 80, 60, 25, 30, 20); + * endShape(); + * + *
    + * + * @alt + * white crescent shape in middle of canvas. Points facing left. + * + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * setAttributes('antialias', true); + * } + * function draw() { + * orbitControl(); + * background(50); + * strokeWeight(4); + * stroke(255); + * point(-25, 30); + * point(25, 30); + * point(25, -30); + * point(-25, -30); + * + * strokeWeight(1); + * noFill(); + * + * beginShape(); + * vertex(-25, 30); + * bezierVertex(25, 30, 25, -30, -25, -30); + * endShape(); + * + * beginShape(); + * vertex(-25, 30, 20); + * bezierVertex(25, 30, 20, 25, -30, 20, -25, -30, 20); + * endShape(); + * } + * + *
    + * + * @alt + * crescent shape in middle of canvas with another crescent shape on positive z-axis. + */ + +/** + * @method bezierVertex + * @param {Number} x2 + * @param {Number} y2 + * @param {Number} z2 z-coordinate for the first control point (for WebGL mode) + * @param {Number} x3 + * @param {Number} y3 + * @param {Number} z3 z-coordinate for the second control point (for WebGL mode) + * @param {Number} x4 + * @param {Number} y4 + * @param {Number} z4 z-coordinate for the anchor point (for WebGL mode) + * @chainable + */ +p5.prototype.bezierVertex = function() { + p5._validateParameters('bezierVertex', arguments); + if (this._renderer.isP3D) { + this._renderer.bezierVertex.apply(this._renderer, arguments); + } else { + if (vertices.length === 0) { + p5._friendlyError( + 'vertex() must be used once before calling bezierVertex()', + '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(). + * For WebGL mode curveVertex() can be used in 2D as well as 3D mode. + * 2D mode expects 2 parameters, while 3D mode expects 3 parameters. + *

    + * The first and last points in a series of curveVertex() lines will be used to + * guide the beginning and end of a the curve. A minimum of four + * points is required to draw a tiny curve between the second and + * third points. Adding a fifth point with curveVertex() will draw + * the curve between the second, third, and fourth points. The + * curveVertex() function is an implementation of Catmull-Rom + * splines. + * + * @method curveVertex + * @param {Number} x x-coordinate of the vertex + * @param {Number} y y-coordinate of the vertex + * @chainable + * @example + *
    + * + * strokeWeight(5); + * point(84, 91); + * point(68, 19); + * point(21, 17); + * point(32, 91); + * strokeWeight(1); + * + * noFill(); + * beginShape(); + * curveVertex(84, 91); + * curveVertex(84, 91); + * curveVertex(68, 19); + * curveVertex(21, 17); + * curveVertex(32, 91); + * curveVertex(32, 91); + * endShape(); + * + *
    + * + * + * @alt + * Upside-down u-shape line, mid canvas. left point extends beyond canvas view. + */ +/** + * @method curveVertex + * @param {Number} x + * @param {Number} y + * @param {Number} [z] z-coordinate of the vertex (for WebGL mode) + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * setAttributes('antialias', true); + * } + * function draw() { + * orbitControl(); + * background(50); + * strokeWeight(4); + * stroke(255); + * + * point(-25, 25); + * point(-25, 25); + * point(-25, -25); + * point(25, -25); + * point(25, 25); + * point(25, 25); + * + * strokeWeight(1); + * noFill(); + * + * beginShape(); + * curveVertex(-25, 25); + * curveVertex(-25, 25); + * curveVertex(-25, -25); + * curveVertex(25, -25); + * curveVertex(25, 25); + * curveVertex(25, 25); + * endShape(); + * + * beginShape(); + * curveVertex(-25, 25, 20); + * curveVertex(-25, 25, 20); + * curveVertex(-25, -25, 20); + * curveVertex(25, -25, 20); + * curveVertex(25, 25, 20); + * curveVertex(25, 25, 20); + * endShape(); + * } + * + *
    + * + * @alt + * Upside-down u-shape line, mid canvas with the same shape in positive z-axis. + * + */ +p5.prototype.curveVertex = function() { + p5._validateParameters('curveVertex', arguments); + if (this._renderer.isP3D) { + this._renderer.curveVertex.apply(this._renderer, arguments); + } else { + isCurve = true; + this.vertex(arguments[0], arguments[1]); + } + return this; +}; + +/** + * Use the beginContour() and endContour() functions to create negative + * shapes within shapes such as the center of the letter 'O'. beginContour() + * begins recording vertices for the shape and endContour() stops recording. + * The vertices that define a negative shape must "wind" in the opposite + * direction from the exterior shape. First draw vertices for the exterior + * clockwise order, then for internal shapes, draw vertices + * shape in counter-clockwise. + *

    + * These functions can only be used within a beginShape()/endShape() pair and + * transformations such as translate(), rotate(), and scale() do not work + * within a beginContour()/endContour() pair. It is also not possible to use + * other shapes, such as ellipse() or rect() within. + * + * @method endContour + * @chainable + * @example + *
    + * + * translate(50, 50); + * stroke(255, 0, 0); + * beginShape(); + * // Exterior part of shape, clockwise winding + * vertex(-40, -40); + * vertex(40, -40); + * vertex(40, 40); + * vertex(-40, 40); + * // Interior part of shape, counter-clockwise winding + * beginContour(); + * vertex(-20, -20); + * vertex(-20, 20); + * vertex(20, 20); + * vertex(20, -20); + * endContour(); + * endShape(CLOSE); + * + *
    + * + * @alt + * white rect and smaller grey rect with red outlines in center of canvas. + * + */ +p5.prototype.endContour = function() { + var vert = contourVertices[0].slice(); // copy all data + vert.isVert = contourVertices[0].isVert; + vert.moveTo = false; + contourVertices.push(vert); + + // 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 + * @chainable + * @example + *
    + * + * noFill(); + * + * beginShape(); + * vertex(20, 20); + * vertex(45, 20); + * vertex(45, 80); + * endShape(CLOSE); + * + * beginShape(); + * vertex(50, 20); + * vertex(75, 20); + * vertex(75, 80); + * endShape(); + * + *
    + * + * @alt + * Triangle line shape with smallest interior angle on bottom and upside-down L. + * + */ +p5.prototype.endShape = function(mode) { + p5._validateParameters('endShape', arguments); + if (this._renderer.isP3D) { + this._renderer.endShape( + mode, + isCurve, + isBezier, + isQuadratic, + isContour, + shapeKind + ); + } else { + if (vertices.length === 0) { + return this; + } + 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. + * For WebGL mode quadraticVertex() can be used in 2D as well as 3D mode. + * 2D mode expects 4 parameters, while 3D mode expects 6 parameters + * (including z coordinates). + *

    + * This function must be used between beginShape() and endShape() + * and only when there is no MODE or POINTS parameter specified to + * beginShape(). + * + * @method quadraticVertex + * @param {Number} cx x-coordinate for the control point + * @param {Number} cy y-coordinate for the control point + * @param {Number} x3 x-coordinate for the anchor point + * @param {Number} y3 y-coordinate for the anchor point + * @chainable + * + * @example + *
    + * + * strokeWeight(5); + * point(20, 20); + * point(80, 20); + * point(50, 50); + * + * noFill(); + * strokeWeight(1); + * beginShape(); + * vertex(20, 20); + * quadraticVertex(80, 20, 50, 50); + * endShape(); + * + *
    + * + *
    + * + * strokeWeight(5); + * point(20, 20); + * point(80, 20); + * point(50, 50); + * + * point(20, 80); + * point(80, 80); + * point(80, 60); + * + * noFill(); + * strokeWeight(1); + * beginShape(); + * vertex(20, 20); + * quadraticVertex(80, 20, 50, 50); + * quadraticVertex(20, 80, 80, 80); + * vertex(80, 60); + * endShape(); + * + *
    + * + * @alt + * arched-shaped black line with 4 pixel thick stroke weight. + * backwards s-shaped black line with 4 pixel thick stroke weight. + * + */ + +/** + * @method quadraticVertex + * @param {Number} cx + * @param {Number} cy + * @param {Number} cz z-coordinate for the control point (for WebGL mode) + * @param {Number} x3 + * @param {Number} y3 + * @param {Number} z3 z-coordinate for the anchor point (for WebGL mode) + * @chainable + * + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * setAttributes('antialias', true); + * } + * function draw() { + * orbitControl(); + * background(50); + * strokeWeight(4); + * stroke(255); + * + * point(-35, -35); + * point(35, -35); + * point(0, 0); + * point(-35, 35); + * point(35, 35); + * point(35, 10); + * + * strokeWeight(1); + * noFill(); + * + * beginShape(); + * vertex(-35, -35); + * quadraticVertex(35, -35, 0, 0); + * quadraticVertex(-35, 35, 35, 35); + * vertex(35, 10); + * endShape(); + * + * beginShape(); + * vertex(-35, -35, 20); + * quadraticVertex(35, -35, 20, 0, 0, 20); + * quadraticVertex(-35, 35, 20, 35, 35, 20); + * vertex(35, 10, 20); + * endShape(); + * } + * + *
    + * + * @alt + * backwards s-shaped black line with the same s-shaped line in postive z-axis. + */ +p5.prototype.quadraticVertex = function() { + p5._validateParameters('quadraticVertex', arguments); + if (this._renderer.isP3D) { + this._renderer.quadraticVertex.apply(this._renderer, arguments); + } else { + //if we're drawing a contour, put the points into an + // array for inside drawing + if (this._contourInited) { + var pt = {}; + pt.x = arguments[0]; + pt.y = arguments[1]; + pt.x3 = arguments[2]; + pt.y3 = arguments[3]; + pt.type = constants.QUADRATIC; + this._contourVertices.push(pt); + + return this; + } + if (vertices.length > 0) { + isQuadratic = true; + var vert = []; + for (var i = 0; i < arguments.length; i++) { + vert[i] = arguments[i]; + } + vert.isVert = false; + if (isContour) { + contourVertices.push(vert); + } else { + vertices.push(vert); + } + } else { + p5._friendlyError( + 'vertex() must be used once before calling quadraticVertex()', + '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 + * @chainable + * @example + *
    + * + * strokeWeight(3); + * beginShape(POINTS); + * vertex(30, 20); + * vertex(85, 20); + * vertex(85, 75); + * vertex(30, 75); + * endShape(); + * + *
    + * + * @alt + * 4 black points in a square shape in middle-right of canvas. + * + *
    + * + * createCanvas(100, 100, WEBGL); + * background(240, 240, 240); + * fill(237, 34, 93); + * noStroke(); + * beginShape(); + * vertex(0, 35); + * vertex(35, 0); + * vertex(0, -35); + * vertex(-35, 0); + * endShape(); + * + *
    + * + * @alt + * 4 points making a diamond shape + * + *
    + * + * createCanvas(100, 100, WEBGL); + * background(240, 240, 240); + * fill(237, 34, 93); + * noStroke(); + * beginShape(); + * vertex(-10, 10); + * vertex(0, 35); + * vertex(10, 10); + * vertex(35, 0); + * vertex(10, -8); + * vertex(0, -35); + * vertex(-10, -8); + * vertex(-35, 0); + * endShape(); + * + *
    + * + * @alt + * 8 points making a star + * + *
    + * + * strokeWeight(3); + * stroke(237, 34, 93); + * beginShape(LINES); + * vertex(10, 35); + * vertex(90, 35); + * vertex(10, 65); + * vertex(90, 65); + * vertex(35, 10); + * vertex(35, 90); + * vertex(65, 10); + * vertex(65, 90); + * endShape(); + * + *
    + * + * @alt + * 8 points making 4 lines + * + */ +/** + * @method vertex + * @param {Number} x + * @param {Number} y + * @param {Number} z z-coordinate of the vertex + * @param {Number} [u] the vertex's texture u-coordinate + * @param {Number} [v] the vertex's texture v-coordinate + * @chainable + */ +p5.prototype.vertex = function(x, y, moveTo, u, v) { + if (this._renderer.isP3D) { + this._renderer.vertex.apply(this._renderer, arguments); + } else { + 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":18,"../main":24}],34:[function(_dereq_,module,exports){ +'use strict'; + +// requestAnim shim layer by Paul Irish +// 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 +window.requestAnimationFrame = (function() { + return ( + window.requestAnimationFrame || + window.webkitRequestAnimationFrame || + window.mozRequestAnimationFrame || + window.oRequestAnimationFrame || + window.msRequestAnimationFrame || + function(callback, element) { + // should '60' here be framerate? + window.setTimeout(callback, 1000 / 60); + } + ); +})(); + +/** + * shim for Uint8ClampedArray.slice + * (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 + }); + } +})(); + +/** + * this is implementation of Object.assign() which is unavailable in + * IE11 and (non-Chrome) Android browsers. + * The assign() method is used to copy the values of all enumerable + * own properties from one or more source objects to a target object. + * It will return the target object. + * Modified from https://github.com/ljharb/object.assign + */ +(function() { + 'use strict'; + if (!Object.assign) { + var keys = Object.keys; + var defineProperty = Object.defineProperty; + var canBeObject = function(obj) { + return typeof obj !== 'undefined' && obj !== null; + }; + var hasSymbols = + typeof Symbol === 'function' && typeof Symbol() === 'symbol'; + var propIsEnumerable = Object.prototype.propertyIsEnumerable; + var isEnumerableOn = function(obj) { + return function isEnumerable(prop) { + return propIsEnumerable.call(obj, prop); + }; + }; + + // per ES6 spec, this function has to have a length of 2 + var assignShim = function assign(target, source1) { + if (!canBeObject(target)) { + throw new TypeError('target must be an object'); + } + var objTarget = Object(target); + var s, source, i, props; + for (s = 1; s < arguments.length; ++s) { + source = Object(arguments[s]); + props = keys(source); + if (hasSymbols && Object.getOwnPropertySymbols) { + props.push.apply( + props, + Object.getOwnPropertySymbols(source).filter(isEnumerableOn(source)) + ); + } + for (i = 0; i < props.length; ++i) { + objTarget[props[i]] = source[props[i]]; + } + } + return objTarget; + }; + + defineProperty(Object, 'assign', { + value: assignShim, + configurable: true, + enumerable: false, + writable: true + }); + } +})(); + +},{}],35:[function(_dereq_,module,exports){ +/** + * @module Structure + * @submodule Structure + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('./main'); + +/** + * 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); + * } + *
    + * + *
    + * let 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(). + * + * Avoid calling loop() from inside setup(). + * + * @method loop + * @example + *
    + * let 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() { + if (!this._loop) { + this._loop = true; + if (this._setupDone) { + 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(), textSize(), textLeading(). + *

    + * In WEBGL mode additional style settings are stored. These are controlled by the following functions: setCamera(), ambientLight(), directionalLight(), + * pointLight(), texture(), specularMaterial(), shininess(), normalMaterial() + * and shader(). + * + * @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._styles.push({ + props: { + _colorMode: this._colorMode + }, + renderer: this._renderer.push() + }); +}; + +/** + * The push() function saves the current drawing style settings and + * transformations, while pop() restores these settings. Note that these + * 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(), textSize(), textLeading(). + *

    + * In WEBGL mode additional style settings are stored. These are controlled by the following functions: setCamera(), ambientLight(), directionalLight(), + * pointLight(), texture(), specularMaterial(), shininess(), normalMaterial() + * and shader(). + * + * @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() { + var style = this._styles.pop(); + if (style) { + this._renderer.pop(style.renderer); + Object.assign(this, style.props); + } else { + console.warn('pop() was called without matching push()'); + } +}; + +/** + * + * 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 + *
    + * let x = 0; + * + * function setup() { + * createCanvas(100, 100); + * noLoop(); + * } + * + * function draw() { + * background(204); + * line(x, 0, x, height); + * } + * + * function mousePressed() { + * x += 1; + * redraw(); + * } + *
    + * + *
    + * let 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(n) { + if (this._inUserDraw || !this._setupDone) { + return; + } + + var numberOfRedraws = parseInt(n); + if (isNaN(numberOfRedraws) || numberOfRedraws < 1) { + numberOfRedraws = 1; + } + + var context = this._isGlobal ? window : this; + var userSetup = context.setup; + var userDraw = context.draw; + if (typeof userDraw === 'function') { + if (typeof userSetup === 'undefined') { + context.scale(context._pixelDensity, context._pixelDensity); + } + var callMethod = function(f) { + f.call(context); + }; + for (var idxRedraw = 0; idxRedraw < numberOfRedraws; idxRedraw++) { + context.resetMatrix(); + if (context._renderer.isP3D) { + context._renderer._update(); + } + context._setProperty('frameCount', context.frameCount + 1); + context._registeredMethods.pre.forEach(callMethod); + this._inUserDraw = true; + try { + userDraw(); + } finally { + this._inUserDraw = false; + } + context._registeredMethods.post.forEach(callMethod); + } + } +}; + +module.exports = p5; + +},{"./main":24}],36:[function(_dereq_,module,exports){ +/** + * @module Transform + * @submodule Transform + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('./main'); + +/** + * Multiplies the current matrix by the one specified through the parameters. + * This is a powerful operation that can perform the equivalent of translate, + * scale, shear and rotate all at once. You can learn more about transformation + * matrices on + * Wikipedia. + * + * The naming of the arguments here follows the naming of the + * WHATWG specification and corresponds to a + * transformation matrix of the + * form: + * + * > The transformation matrix used when applyMatrix is called + * + * @method applyMatrix + * @param {Number} a numbers which define the 2x3 matrix to be multiplied + * @param {Number} b numbers which define the 2x3 matrix to be multiplied + * @param {Number} c numbers which define the 2x3 matrix to be multiplied + * @param {Number} d numbers which define the 2x3 matrix to be multiplied + * @param {Number} e numbers which define the 2x3 matrix to be multiplied + * @param {Number} f numbers which define the 2x3 matrix to be multiplied + * @chainable + * @example + *
    + * + * function setup() { + * frameRate(10); + * rectMode(CENTER); + * } + * + * function draw() { + * var step = frameCount % 20; + * background(200); + * // Equivalent to translate(x, y); + * applyMatrix(1, 0, 0, 1, 40 + step, 50); + * rect(0, 0, 50, 50); + * } + * + *
    + *
    + * + * function setup() { + * frameRate(10); + * rectMode(CENTER); + * } + * + * function draw() { + * var step = frameCount % 20; + * background(200); + * translate(50, 50); + * // Equivalent to scale(x, y); + * applyMatrix(1 / step, 0, 0, 1 / step, 0, 0); + * rect(0, 0, 50, 50); + * } + * + *
    + *
    + * + * function setup() { + * frameRate(10); + * rectMode(CENTER); + * } + * + * function draw() { + * var step = frameCount % 20; + * var angle = map(step, 0, 20, 0, TWO_PI); + * var cos_a = cos(angle); + * var sin_a = sin(angle); + * background(200); + * translate(50, 50); + * // Equivalent to rotate(angle); + * applyMatrix(cos_a, sin_a, -sin_a, cos_a, 0, 0); + * rect(0, 0, 50, 50); + * } + * + *
    + *
    + * + * function setup() { + * frameRate(10); + * rectMode(CENTER); + * } + * + * function draw() { + * var step = frameCount % 20; + * var angle = map(step, 0, 20, -PI / 4, PI / 4); + * background(200); + * translate(50, 50); + * // equivalent to shearX(angle); + * var shear_factor = 1 / tan(PI / 2 - angle); + * applyMatrix(1, 0, shear_factor, 1, 0, 0); + * rect(0, 0, 50, 50); + * } + * + *
    + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * noFill(); + * } + * + * function draw() { + * background(200); + * rotateY(PI / 6); + * stroke(153); + * box(35); + * var rad = millis() / 1000; + * // Set rotation angles + * var ct = cos(rad); + * var st = sin(rad); + * // Matrix for rotation around the Y axis + * // prettier-ignore + * applyMatrix( ct, 0.0, st, 0.0, + * 0.0, 1.0, 0.0, 0.0, + * -st, 0.0, ct, 0.0, + * 0.0, 0.0, 0.0, 1.0); + * stroke(255); + * box(50); + * } + * + *
    + * + * @alt + * A rectangle translating to the right + * A rectangle shrinking to the center + * A rectangle rotating clockwise about the center + * A rectangle shearing + * + */ +p5.prototype.applyMatrix = function(a, b, c, d, e, f) { + this._renderer.applyMatrix.apply(this._renderer, arguments); + return this; +}; + +/** + * Replaces the current matrix with the identity matrix. + * + * @method resetMatrix + * @chainable + * @example + *
    + * + * translate(50, 50); + * applyMatrix(0.5, 0.5, -0.5, 0.5, 0, 0); + * rect(0, 0, 20, 20); + * // Note that the translate is also reset. + * resetMatrix(); + * rect(0, 0, 20, 20); + * + *
    + * + * @alt + * A rotated retangle in the center with another at the top left corner + * + */ +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 + * @param {p5.Vector|Number[]} [axis] (in 3d) the axis to rotate around + * @chainable + * @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 + * + */ +p5.prototype.rotate = function(angle, axis) { + p5._validateParameters('rotate', arguments); + this._renderer.rotate(this._toRadians(angle), axis); + return this; +}; + +/** + * Rotates around X axis. + * @method rotateX + * @param {Number} angle the angle of rotation, specified in radians + * or degrees, depending on current angleMode + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(255); + * rotateX(millis() / 1000); + * box(); + * } + * + *
    + * + * @alt + * 3d box rotating around the x axis. + */ +p5.prototype.rotateX = function(angle) { + this._assert3d('rotateX'); + p5._validateParameters('rotateX', arguments); + this._renderer.rotateX(this._toRadians(angle)); + return this; +}; + +/** + * Rotates around Y axis. + * @method rotateY + * @param {Number} angle the angle of rotation, specified in radians + * or degrees, depending on current angleMode + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(255); + * rotateY(millis() / 1000); + * box(); + * } + * + *
    + * + * @alt + * 3d box rotating around the y axis. + */ +p5.prototype.rotateY = function(angle) { + this._assert3d('rotateY'); + p5._validateParameters('rotateY', arguments); + this._renderer.rotateY(this._toRadians(angle)); + return this; +}; + +/** + * Rotates around Z axis. Webgl mode only. + * @method rotateZ + * @param {Number} angle the angle of rotation, specified in radians + * or degrees, depending on current angleMode + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(255); + * rotateZ(millis() / 1000); + * box(); + * } + * + *
    + * + * @alt + * 3d box rotating around the z axis. + */ +p5.prototype.rotateZ = function(angle) { + this._assert3d('rotateZ'); + p5._validateParameters('rotateZ', arguments); + this._renderer.rotateZ(this._toRadians(angle)); + 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|Number[]} 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) + * @chainable + * @example + *
    + * + * rect(30, 20, 50, 50); + * scale(0.5); + * rect(30, 20, 50, 50); + * + *
    + * + *
    + * + * 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 + * + */ +/** + * @method scale + * @param {p5.Vector|Number[]} scales per-axis percents to scale the object + * @chainable + */ +p5.prototype.scale = function(x, y, z) { + p5._validateParameters('scale', arguments); + // Only check for Vector argument type if Vector is available + if (x instanceof p5.Vector) { + var v = x; + x = v.x; + y = v.y; + z = v.z; + } else if (x instanceof Array) { + var rg = x; + x = rg[0]; + y = rg[1]; + z = rg[2] || 1; + } + if (isNaN(y)) { + y = z = x; + } else if (isNaN(z)) { + z = 1; + } + + this._renderer.scale.call(this._renderer, x, y, z); + + return this; +}; + +/** + * Shears a shape around the x-axis the amount specified by the angle + * parameter. Angles should be specified in the current angleMode. + * Objects are always sheared around their relative position to the origin + * and positive numbers shear objects in a clockwise direction. + *

    + * Transformations apply to everything that happens after and subsequent + * calls to the function accumulates the effect. For example, calling + * shearX(PI/2) and then shearX(PI/2) is the same as shearX(PI). + * If shearX() is called within the draw(), the transformation is reset when + * the loop begins again. + *

    + * Technically, shearX() multiplies the current transformation matrix by a + * rotation matrix. This function can be further controlled by the + * push() and pop() functions. + * + * @method shearX + * @param {Number} angle angle of shear specified in radians or degrees, + * depending on current angleMode + * @chainable + * @example + *
    + * + * translate(width / 4, height / 4); + * shearX(PI / 4.0); + * rect(0, 0, 30, 30); + * + *
    + * + * @alt + * white irregular quadrilateral with black outline at top middle. + * + */ +p5.prototype.shearX = function(angle) { + p5._validateParameters('shearX', arguments); + var rad = this._toRadians(angle); + this._renderer.applyMatrix(1, 0, Math.tan(rad), 1, 0, 0); + return this; +}; + +/** + * Shears a shape around the y-axis the amount specified by the angle + * parameter. Angles should be specified in the current angleMode. Objects + * are always sheared around their relative position to the origin and + * positive numbers shear objects in a clockwise direction. + *

    + * Transformations apply to everything that happens after and subsequent + * calls to the function accumulates the effect. For example, calling + * shearY(PI/2) and then shearY(PI/2) is the same as shearY(PI). If + * shearY() is called within the draw(), the transformation is reset when + * the loop begins again. + *

    + * Technically, shearY() multiplies the current transformation matrix by a + * rotation matrix. This function can be further controlled by the + * push() and pop() functions. + * + * @method shearY + * @param {Number} angle angle of shear specified in radians or degrees, + * depending on current angleMode + * @chainable + * @example + *
    + * + * translate(width / 4, height / 4); + * shearY(PI / 4.0); + * rect(0, 0, 30, 30); + * + *
    + * + * @alt + * white irregular quadrilateral with black outline at middle bottom. + * + */ +p5.prototype.shearY = function(angle) { + p5._validateParameters('shearY', arguments); + var rad = this._toRadians(angle); + this._renderer.applyMatrix(1, Math.tan(rad), 0, 1, 0, 0); + return this; +}; + +/** + * Specifies an amount to displace objects within the display window. + * The x parameter specifies left/right translation, the y parameter + * specifies up/down translation. + *

    + * Transformations are cumulative and apply to everything that happens after + * and subsequent calls to the function accumulates the effect. For example, + * calling translate(50, 0) and then translate(20, 0) is the same as + * translate(70, 0). If translate() is called within draw(), the + * transformation is reset when the loop begins again. This function can be + * further controlled by using push() and pop(). + * + * @method translate + * @param {Number} x left/right translation + * @param {Number} y up/down translation + * @param {Number} [z] forward/backward translation (webgl only) + * @chainable + * @example + *
    + * + * translate(30, 20); + * rect(0, 0, 55, 55); + * + *
    + * + *
    + * + * rect(0, 0, 55, 55); // Draw rect at original 0,0 + * translate(30, 20); + * rect(0, 0, 55, 55); // Draw rect at new 0,0 + * translate(14, 14); + * rect(0, 0, 55, 55); // Draw rect at new 0,0 + * + *
    + * + + *
    + * + * function draw() { + * background(200); + * rectMode(CENTER); + * translate(width / 2, height / 2); + * translate(p5.Vector.fromAngle(millis() / 1000, 40)); + * rect(0, 0, 20, 20); + * } + * + *
    + * + * @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. + * a 20x20 white rect moving in a circle around the canvas + * + */ +/** + * @method translate + * @param {p5.Vector} vector the vector to translate by + * @chainable + */ +p5.prototype.translate = function(x, y, z) { + p5._validateParameters('translate', arguments); + if (this._renderer.isP3D) { + this._renderer.translate(x, y, z); + } else { + this._renderer.translate(x, y); + } + return this; +}; + +module.exports = p5; + +},{"./main":24}],37:[function(_dereq_,module,exports){ +/** + * @module Data + * @submodule Dictionary + * @for p5.TypedDict + * @requires core + * + * This module defines the p5 methods for the p5 Dictionary classes. + * The classes StringDict and NumberDict are for storing and working + * with key-value pairs. + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * + * Creates a new instance of p5.StringDict using the key-value pair + * or the object you provide. + * + * @method createStringDict + * @for p5 + * @param {String} key + * @param {String} value + * @return {p5.StringDict} + * + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * print(myDictionary.hasKey('p5')); // logs true to console + * + * let anotherDictionary = createStringDict({ happy: 'coding' }); + * print(anotherDictionary.hasKey('happy')); // logs true to console + * } + *
    + */ +/** + * @method createStringDict + * @param {Object} object object + * @return {p5.StringDict} + */ + +p5.prototype.createStringDict = function(key, value) { + p5._validateParameters('createStringDict', arguments); + return new p5.StringDict(key, value); +}; + +/** + * + * Creates a new instance of p5.NumberDict using the key-value pair + * or object you provide. + * + * @method createNumberDict + * @for p5 + * @param {Number} key + * @param {Number} value + * @return {p5.NumberDict} + * + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict(100, 42); + * print(myDictionary.hasKey(100)); // logs true to console + * + * let anotherDictionary = createNumberDict({ 200: 84 }); + * print(anotherDictionary.hasKey(200)); // logs true to console + * } + *
    + */ +/** + * @method createNumberDict + * @param {Object} object object + * @return {p5.NumberDict} + */ + +p5.prototype.createNumberDict = function(key, value) { + p5._validateParameters('createNumberDict', arguments); + return new p5.NumberDict(key, value); +}; + +/** + * + * Base class for all p5.Dictionary types. Specifically + * typed Dictionary classes inherit from this class. + * + * @class p5.TypedDict + * + */ + +p5.TypedDict = function(key, value) { + if (key instanceof Object) { + this.data = key; + } else { + this.data = {}; + this.data[key] = value; + } + return this; +}; + +/** + * Returns the number of key-value pairs currently stored in the Dictionary. + * + * @method size + * @return {Integer} the number of key-value pairs in the Dictionary + * + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict(1, 10); + * myDictionary.create(2, 20); + * myDictionary.create(3, 30); + * print(myDictionary.size()); // logs 3 to the console + * } + *
    + * + */ +p5.TypedDict.prototype.size = function() { + return Object.keys(this.data).length; +}; + +/** + * Returns true if the given key exists in the Dictionary, + * otherwise returns false. + * + * @method hasKey + * @param {Number|String} key that you want to look up + * @return {Boolean} whether that key exists in Dictionary + * + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * print(myDictionary.hasKey('p5')); // logs true to console + * } + *
    + * + */ + +p5.TypedDict.prototype.hasKey = function(key) { + return this.data.hasOwnProperty(key); +}; + +/** + * Returns the value stored at the given key. + * + * @method get + * @param {Number|String} the key you want to access + * @return {Number|String} the value stored at that key + * + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * let myValue = myDictionary.get('p5'); + * print(myValue === 'js'); // logs true to console + * } + *
    + * + */ + +p5.TypedDict.prototype.get = function(key) { + if (this.data.hasOwnProperty(key)) { + return this.data[key]; + } else { + console.log(key + ' does not exist in this Dictionary'); + } +}; + +/** + * Updates the value associated with the given key in case it already exists + * in the Dictionary. Otherwise a new key-value pair is added. + * + * @method set + * @param {Number|String} key + * @param {Number|String} value + * + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * myDictionary.set('p5', 'JS'); + * myDictionary.print(); // logs "key: p5 - value: JS" to console + * } + *
    + * + */ + +p5.TypedDict.prototype.set = function(key, value) { + if (this._validate(value)) { + this.data[key] = value; + } else { + console.log('Those values dont work for this dictionary type.'); + } +}; + +/** + * private helper function to handle the user passing in objects + * during construction or calls to create() + */ + +p5.TypedDict.prototype._addObj = function(obj) { + for (var key in obj) { + this.set(key, obj[key]); + } +}; + +/** + * Creates a new key-value pair in the Dictionary. + * + * @method create + * @param {Number|String} key + * @param {Number|String} value + * + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * myDictionary.create('happy', 'coding'); + * myDictionary.print(); + * // above logs "key: p5 - value: js, key: happy - value: coding" to console + * } + *
    + */ +/** + * @method create + * @param {Object} obj key/value pair + */ + +p5.TypedDict.prototype.create = function(key, value) { + if (key instanceof Object && typeof value === 'undefined') { + this._addObj(key); + } else if (typeof key !== 'undefined') { + this.set(key, value); + } else { + console.log( + 'In order to create a new Dictionary entry you must pass ' + + 'an object or a key, value pair' + ); + } +}; + +/** + * Removes all previously stored key-value pairs from the Dictionary. + * + * @method clear + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * print(myDictionary.hasKey('p5')); // prints 'true' + * myDictionary.clear(); + * print(myDictionary.hasKey('p5')); // prints 'false' + * } + * + *
    + */ + +p5.TypedDict.prototype.clear = function() { + this.data = {}; +}; + +/** + * Removes the key-value pair stored at the given key from the Dictionary. + * + * @method remove + * @param {Number|String} key for the pair to remove + * + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * myDictionary.create('happy', 'coding'); + * myDictionary.print(); + * // above logs "key: p5 - value: js, key: happy - value: coding" to console + * myDictionary.remove('p5'); + * myDictionary.print(); + * // above logs "key: happy value: coding" to console + * } + *
    + * + */ + +p5.TypedDict.prototype.remove = function(key) { + if (this.data.hasOwnProperty(key)) { + delete this.data[key]; + } else { + throw new Error(key + ' does not exist in this Dictionary'); + } +}; + +/** + * Logs the set of items currently stored in the Dictionary to the console. + * + * @method print + * + * @example + *
    + * + * function setup() { + * let myDictionary = createStringDict('p5', 'js'); + * myDictionary.create('happy', 'coding'); + * myDictionary.print(); + * // above logs "key: p5 - value: js, key: happy - value: coding" to console + * } + * + *
    + */ + +p5.TypedDict.prototype.print = function() { + for (var item in this.data) { + console.log('key:' + item + ' value:' + this.data[item]); + } +}; + +/** + * Converts the Dictionary into a CSV file for local download. + * + * @method saveTable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100); + * background(200); + * text('click here to save', 10, 10, 70, 80); + * } + * + * function mousePressed() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * createStringDict({ + * john: 1940, + * paul: 1942, + * george: 1943, + * ringo: 1940 + * }).saveTable('beatles'); + * } + * } + * + *
    + */ + +p5.TypedDict.prototype.saveTable = function(filename) { + var output = ''; + + for (var key in this.data) { + output += key + ',' + this.data[key] + '\n'; + } + + var blob = new Blob([output], { type: 'text/csv' }); + p5.prototype.downloadFile(blob, filename || 'mycsv', 'csv'); +}; + +/** + * Converts the Dictionary into a JSON file for local download. + * + * @method saveJSON + * @example + *
    + * + * function setup() { + * createCanvas(100, 100); + * background(200); + * text('click here to save', 10, 10, 70, 80); + * } + * + * function mousePressed() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * createStringDict({ + * john: 1940, + * paul: 1942, + * george: 1943, + * ringo: 1940 + * }).saveJSON('beatles'); + * } + * } + * + *
    + */ + +p5.TypedDict.prototype.saveJSON = function(filename, opt) { + p5.prototype.saveJSON(this.data, filename, opt); +}; + +/** + * private helper function to ensure that the user passed in valid + * values for the Dictionary type + */ + +p5.TypedDict.prototype._validate = function(value) { + return true; +}; + +/** + * + * A simple Dictionary class for Strings. + * + * @class p5.StringDict + * @extends p5.TypedDict + * + */ + +p5.StringDict = function() { + p5.TypedDict.apply(this, arguments); +}; + +p5.StringDict.prototype = Object.create(p5.TypedDict.prototype); + +p5.StringDict.prototype._validate = function(value) { + return typeof value === 'string'; +}; + +/** + * + * A simple Dictionary class for Numbers. + * + * @class p5.NumberDict + * @extends p5.TypedDict + * + */ + +p5.NumberDict = function() { + p5.TypedDict.apply(this, arguments); +}; + +p5.NumberDict.prototype = Object.create(p5.TypedDict.prototype); + +/** + * private helper function to ensure that the user passed in valid + * values for the Dictionary type + */ + +p5.NumberDict.prototype._validate = function(value) { + return typeof value === 'number'; +}; + +/** + * Add the given number to the value currently stored at the given key. + * The sum then replaces the value previously stored in the Dictionary. + * + * @method add + * @param {Number} Key for the value you wish to add to + * @param {Number} Number to add to the value + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict(2, 5); + * myDictionary.add(2, 2); + * print(myDictionary.get(2)); // logs 7 to console. + * } + *
    + * + * + */ + +p5.NumberDict.prototype.add = function(key, amount) { + if (this.data.hasOwnProperty(key)) { + this.data[key] += amount; + } else { + console.log('The key - ' + key + ' does not exist in this dictionary.'); + } +}; + +/** + * Subtract the given number from the value currently stored at the given key. + * The difference then replaces the value previously stored in the Dictionary. + * + * @method sub + * @param {Number} Key for the value you wish to subtract from + * @param {Number} Number to subtract from the value + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict(2, 5); + * myDictionary.sub(2, 2); + * print(myDictionary.get(2)); // logs 3 to console. + * } + *
    + * + * + */ + +p5.NumberDict.prototype.sub = function(key, amount) { + this.add(key, -amount); +}; + +/** + * Multiply the given number with the value currently stored at the given key. + * The product then replaces the value previously stored in the Dictionary. + * + * @method mult + * @param {Number} Key for value you wish to multiply + * @param {Number} Amount to multiply the value by + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict(2, 4); + * myDictionary.mult(2, 2); + * print(myDictionary.get(2)); // logs 8 to console. + * } + *
    + * + * + */ + +p5.NumberDict.prototype.mult = function(key, amount) { + if (this.data.hasOwnProperty(key)) { + this.data[key] *= amount; + } else { + console.log('The key - ' + key + ' does not exist in this dictionary.'); + } +}; + +/** + * Divide the given number with the value currently stored at the given key. + * The quotient then replaces the value previously stored in the Dictionary. + * + * @method div + * @param {Number} Key for value you wish to divide + * @param {Number} Amount to divide the value by + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict(2, 8); + * myDictionary.div(2, 2); + * print(myDictionary.get(2)); // logs 4 to console. + * } + *
    + * + * + */ + +p5.NumberDict.prototype.div = function(key, amount) { + if (this.data.hasOwnProperty(key)) { + this.data[key] /= amount; + } else { + console.log('The key - ' + key + ' does not exist in this dictionary.'); + } +}; + +/** + * private helper function for finding lowest or highest value + * the argument 'flip' is used to flip the comparison arrow + * from 'less than' to 'greater than' + * + */ + +p5.NumberDict.prototype._valueTest = function(flip) { + if (Object.keys(this.data).length === 0) { + throw new Error( + 'Unable to search for a minimum or maximum value on an empty NumberDict' + ); + } else if (Object.keys(this.data).length === 1) { + return this.data[Object.keys(this.data)[0]]; + } else { + var result = this.data[Object.keys(this.data)[0]]; + for (var key in this.data) { + if (this.data[key] * flip < result * flip) { + result = this.data[key]; + } + } + return result; + } +}; + +/** + * Return the lowest number currently stored in the Dictionary. + * + * @method minValue + * @return {Number} + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 }); + * let lowestValue = myDictionary.minValue(); // value is -10 + * print(lowestValue); + * } + *
    + * + */ + +p5.NumberDict.prototype.minValue = function() { + return this._valueTest(1); +}; + +/** + * Return the highest number currently stored in the Dictionary. + * + * @method maxValue + * @return {Number} + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict({ 2: -10, 4: 0.65, 1.2: 3 }); + * let highestValue = myDictionary.maxValue(); // value is 3 + * print(highestValue); + * } + *
    + * + */ + +p5.NumberDict.prototype.maxValue = function() { + return this._valueTest(-1); +}; + +/** + * private helper function for finding lowest or highest key + * the argument 'flip' is used to flip the comparison arrow + * from 'less than' to 'greater than' + * + */ + +p5.NumberDict.prototype._keyTest = function(flip) { + if (Object.keys(this.data).length === 0) { + throw new Error('Unable to use minValue on an empty NumberDict'); + } else if (Object.keys(this.data).length === 1) { + return Object.keys(this.data)[0]; + } else { + var result = Object.keys(this.data)[0]; + for (var i = 1; i < Object.keys(this.data).length; i++) { + if (Object.keys(this.data)[i] * flip < result * flip) { + result = Object.keys(this.data)[i]; + } + } + return result; + } +}; + +/** + * Return the lowest key currently used in the Dictionary. + * + * @method minKey + * @return {Number} + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 }); + * let lowestKey = myDictionary.minKey(); // value is 1.2 + * print(lowestKey); + * } + *
    + * + */ + +p5.NumberDict.prototype.minKey = function() { + return this._keyTest(1); +}; + +/** + * Return the highest key currently used in the Dictionary. + * + * @method maxKey + * @return {Number} + * @example + *
    + * + * function setup() { + * let myDictionary = createNumberDict({ 2: 4, 4: 6, 1.2: 3 }); + * let highestKey = myDictionary.maxKey(); // value is 4 + * print(highestKey); + * } + *
    + * + */ + +p5.NumberDict.prototype.maxKey = function() { + return this._keyTest(-1); +}; + +module.exports = p5.TypedDict; + +},{"../core/main":24}],38:[function(_dereq_,module,exports){ +/** + * @module Events + * @submodule Acceleration + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * 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'. + * either LANDSCAPE or PORTRAIT. + * + * @property {Constant} deviceOrientation + * @readOnly + */ +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 {Number} accelerationX + * @readOnly + * @example + *
    + * + * // Move a touchscreen device to register + * // acceleration changes. + * function draw() { + * background(220, 50); + * fill('magenta'); + * ellipse(width / 2, height / 2, accelerationX); + * } + * + *
    + * @alt + * Magnitude of device acceleration is displayed as ellipse size + */ +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 {Number} accelerationY + * @readOnly + * @example + *
    + * + * // Move a touchscreen device to register + * // acceleration changes. + * function draw() { + * background(220, 50); + * fill('magenta'); + * ellipse(width / 2, height / 2, accelerationY); + * } + * + *
    + * @alt + * Magnitude of device acceleration is displayed as ellipse size + */ +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 {Number} accelerationZ + * @readOnly + * + * @example + *
    + * + * // Move a touchscreen device to register + * // acceleration changes. + * function draw() { + * background(220, 50); + * fill('magenta'); + * ellipse(width / 2, height / 2, accelerationZ); + * } + * + *
    + * + * @alt + * Magnitude of device acceleration is displayed as ellipse size + */ +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 {Number} pAccelerationX + * @readOnly + */ +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 {Number} pAccelerationY + * @readOnly + */ +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 {Number} pAccelerationZ + * @readOnly + */ +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. + * + * @property {Number} rotationX + * @readOnly + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * //rotateZ(radians(rotationZ)); + * rotateX(radians(rotationX)); + * //rotateY(radians(rotationY)); + * box(200, 200, 200); + * } + * + *
    + * @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. + * + * @property {Number} rotationY + * @readOnly + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * //rotateZ(radians(rotationZ)); + * //rotateX(radians(rotationX)); + * rotateY(radians(rotationY)); + * box(200, 200, 200); + * } + * + *
    + * @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 {Number} rotationZ + * @readOnly + * + * @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. + * let rotateDirection = 'clockwise'; + * + * // Simple range conversion to make things simpler. + * // This is not absolutely necessary but the logic + * // will be different in that case. + * + * let rX = rotationX + 180; + * let 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'; + * } + * + * print(rotateDirection); + * + *
    + * + * @alt + * no image to display. + * + * + * @property {Number} pRotationX + * @readOnly + */ +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. + * let rotateDirection = 'clockwise'; + * + * // Simple range conversion to make things simpler. + * // This is not absolutely necessary but the logic + * // will be different in that case. + * + * let rY = rotationY + 180; + * let 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'; + * } + * print(rotateDirection); + * + *
    + * + * @alt + * no image to display. + * + * + * @property {Number} pRotationY + * @readOnly + */ +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. + * let 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'; + * } + * print(rotateDirection); + * + *
    + * + * @alt + * no image to display. + * + * + * @property {Number} pRotationZ + * @readOnly + */ +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); +}; + +/** + * When a device is rotated, the axis that triggers the deviceTurned() + * method is stored in the turnAxis variable. The turnAxis variable is only defined within + * the scope of deviceTurned(). + * @property {String} turnAxis + * @readOnly + * @example + *
    + * + * // 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 + */ +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 + * @example + *
    + * + * // Run this example on a mobile device + * // You will need to move the device incrementally further + * // the closer the square's color gets to white in order to change the value. + * + * let value = 0; + * let threshold = 0.5; + * function setup() { + * setMoveThreshold(threshold); + * } + * function draw() { + * fill(value); + * rect(25, 25, 50, 50); + * } + * function deviceMoved() { + * value = value + 5; + * threshold = threshold + 0.1; + * if (value > 255) { + * value = 0; + * threshold = 30; + * } + * setMoveThreshold(threshold); + * } + * + *
    + * + * @alt + * 50x50 black rect in center of canvas. turns white on mobile when device moves + */ + +p5.prototype.setMoveThreshold = function(val) { + p5._validateParameters('setMoveThreshold', arguments); + move_threshold = val; +}; + +/** + * The setShakeThreshold() function is used to set the movement threshold for + * the deviceShaken() function. The default threshold is set to 30. + * + * @method setShakeThreshold + * @param {number} value The threshold value + * @example + *
    + * + * // Run this example on a mobile device + * // You will need to shake the device more firmly + * // the closer the box's fill gets to white in order to change the value. + * + * let value = 0; + * let threshold = 30; + * function setup() { + * setShakeThreshold(threshold); + * } + * function draw() { + * fill(value); + * rect(25, 25, 50, 50); + * } + * function deviceMoved() { + * value = value + 5; + * threshold = threshold + 5; + * if (value > 255) { + * value = 0; + * threshold = 30; + * } + * setShakeThreshold(threshold); + * } + * + *
    + * + * @alt + * 50x50 black rect in center of canvas. turns white on mobile when device + * is being shaked + */ + +p5.prototype.setShakeThreshold = function(val) { + p5._validateParameters('setShakeThreshold', arguments); + 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. + * The threshold value can be changed using setMoveThreshold(). + * + * @method deviceMoved + * @example + *
    + * + * // Run this example on a mobile device + * // Move the device around + * // to change the value. + * + * let 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. + * + * let 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. + * + * let 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. + * The threshold value can be changed using setShakeThreshold(). + * + * @method deviceShaken + * @example + *
    + * + * // Run this example on a mobile device + * // Shake the device to change the value. + * + * let 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/main":24}],39:[function(_dereq_,module,exports){ +/** + * @module Events + * @submodule Keyboard + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * The boolean system variable keyIsPressed is true if any key is pressed + * and false if no keys are pressed. + * + * @property {Boolean} keyIsPressed + * @readOnly + * @example + *
    + * + * 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 {String} key + * @readOnly + * @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 {Integer} keyCode + * @readOnly + * @example + *
    + * let 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 + * } + *
    + *
    + * function draw() {} + * function keyPressed() { + * background('yellow'); + * text(`${key} ${keyCode}`, 10, 40); + * print(key, ' ', keyCode); + * return false; // prevent default + * } + *
    + * @alt + * Grey rect center. turns white when up arrow pressed and black when down + * Display key pressed and its keyCode in a yellow box + */ +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, the key 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 + *
    + * + * let value = 0; + * function draw() { + * fill(value); + * rect(25, 25, 50, 50); + * } + * function keyPressed() { + * if (value === 0) { + * value = 255; + * } else { + * value = 0; + * } + * } + * + *
    + *
    + * + * let 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 (this._downKeys[e.which]) { + // prevent multiple firings + return; + } + this._setProperty('isKeyPressed', true); + this._setProperty('keyIsPressed', true); + this._setProperty('keyCode', e.which); + this._downKeys[e.which] = true; + this._setProperty('key', e.key || String.fromCharCode(e.which) || e.which); + var keyPressed = this.keyPressed || window.keyPressed; + if (typeof keyPressed === 'function' && !e.charCode) { + var executeDefault = keyPressed(e); + if (executeDefault === false) { + 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 + *
    + * + * let 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; + this._downKeys[e.which] = false; + + if (!this._areDownKeys()) { + this._setProperty('isKeyPressed', false); + this._setProperty('keyIsPressed', false); + } + + this._setProperty('_lastKeyCodeTyped', null); + + this._setProperty('key', e.key || String.fromCharCode(e.which) || e.which); + this._setProperty('keyCode', e.which); + if (typeof keyReleased === 'function') { + var executeDefault = keyReleased(e); + if (executeDefault === false) { + 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 + *
    + * + * let 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) { + this._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 + *
    + * let x = 100; + * let y = 100; + * + * function setup() { + * createCanvas(512, 512); + * fill(255, 0, 0); + * } + * + * 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(); + * ellipse(x, y, 50, 50); + * } + *
    + * + *
    + * let diameter = 50; + * + * function setup() { + * createCanvas(512, 512); + * } + * + * function draw() { + * // 107 and 187 are keyCodes for "+" + * if (keyIsDown(107) || keyIsDown(187)) { + * diameter += 1; + * } + * + * // 109 and 189 are keyCodes for "-" + * if (keyIsDown(109) || keyIsDown(189)) { + * diameter -= 1; + * } + * + * clear(); + * fill(255, 0, 0); + * ellipse(50, 50, diameter, diameter); + * } + *
    + * + * @alt + * 50x50 red ellipse moves left, right, up and down with arrow presses. + * 50x50 red ellipse gets bigger or smaller when + or - are pressed. + * + */ +p5.prototype.keyIsDown = function(code) { + p5._validateParameters('keyIsDown', arguments); + return this._downKeys[code]; +}; + +/** + * The _areDownKeys function returns a boolean true if any keys pressed + * and a false if no keys are currently pressed. + + * Helps avoid instances where multiple keys are pressed simultaneously and + * releasing a single key will then switch the + * keyIsPressed property to true. + * @private +**/ +p5.prototype._areDownKeys = function() { + for (var key in this._downKeys) { + if (this._downKeys.hasOwnProperty(key) && this._downKeys[key] === true) { + return true; + } + } + return false; +}; + +module.exports = p5; + +},{"../core/main":24}],40:[function(_dereq_,module,exports){ +/** + * @module Events + * @submodule Mouse + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +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 {Number} mouseX + * @readOnly + * + * @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 {Number} mouseY + * @readOnly + * + * @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. Note: pmouseX will be reset to the current mouseX + * value at the start of each touch event. + * + * @property {Number} pmouseX + * @readOnly + * + * @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. Note: pmouseY will be reset to the current mouseY + * value at the start of each touch event. + * + * @property {Number} pmouseY + * @readOnly + * + * @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, fuchsia 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 {Number} winMouseX + * @readOnly + * + * @example + *
    + * + * let myCanvas; + * + * function setup() { + * //use a variable to store a pointer to the canvas + * myCanvas = createCanvas(100, 100); + * const body = document.getElementsByTagName('body')[0]; + * myCanvas.parent(body); + * } + * + * 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 fuchsia 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 {Number} winMouseY + * @readOnly + * + * @example + *
    + * + * let myCanvas; + * + * function setup() { + * //use a variable to store a pointer to the canvas + * myCanvas = createCanvas(100, 100); + * const body = document.getElementsByTagName('body')[0]; + * myCanvas.parent(body); + * } + * + * 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 fuchsia 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. Note: pwinMouseX will be reset to the current winMouseX + * value at the start of each touch event. + * + * @property {Number} pwinMouseX + * @readOnly + * + * @example + *
    + * + * let 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 + * let 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 + * fuchsia 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. Note: pwinMouseY will be reset to the current winMouseY + * value at the start of each touch event. + * + * @property {Number} pwinMouseY + * @readOnly + * + * + * @example + *
    + * + * let 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 + * let 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 + * fuchsia 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 {Constant} mouseButton + * @readOnly + * + * @example + *
    + * + * function draw() { + * background(237, 34, 93); + * fill(0); + * + * if (mouseIsPressed) { + * if (mouseButton === LEFT) { + * ellipse(50, 50, 50, 50); + * } + * if (mouseButton === RIGHT) { + * rect(25, 25, 50, 50); + * } + * if (mouseButton === CENTER) { + * triangle(23, 75, 50, 20, 78, 75); + * } + * } + * + * print(mouseButton); + * } + * + *
    + * + * @alt + * 50x50 black ellipse appears on center of fuchsia 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 {Boolean} mouseIsPressed + * @readOnly + * + * @example + *
    + * + * function draw() { + * background(237, 34, 93); + * fill(0); + * + * if (mouseIsPressed) { + * ellipse(50, 50, 50, 50); + * } else { + * rect(25, 25, 50, 50); + * } + * + * print(mouseIsPressed); + * } + * + *
    + * + * @alt + * black 50x50 rect becomes ellipse with mouse click/press. fuchsia background. + * + */ +p5.prototype.mouseIsPressed = false; + +p5.prototype._updateNextMouseCoords = function(e) { + if (this._curElement !== null && (!e.touches || e.touches.length > 0)) { + var mousePos = getMousePos( + this._curElement.elt, + this.width, + this.height, + e + ); + 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); + + this._setProperty('_pmouseWheelDeltaY', this._mouseWheelDeltaY); +}; + +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 + * @param {Object} [event] optional MouseEvent callback argument. + * @example + *
    + * + * // Move the mouse across the page + * // to change its value + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a MouseEvent object + * // as a callback argument + * function mouseMoved(event) { + * console.log(event); + * } + * + *
    + * + * @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 + * @param {Object} [event] optional MouseEvent callback argument. + * @example + *
    + * + * // Drag the mouse across the page + * // to change its value + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a MouseEvent object + * // as a callback argument + * function mouseDragged(event) { + * console.log(event); + * } + * + *
    + * + * @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.mouseIsPressed) { + 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 + * @param {Object} [event] optional MouseEvent callback argument. + * @example + *
    + * + * // Click within the image to change + * // the value of the rectangle + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a MouseEvent object + * // as a callback argument + * function mousePressed(event) { + * console.log(event); + * } + * + *
    + * + * @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('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 + * @param {Object} [event] optional MouseEvent callback argument. + * @example + *
    + * + * // Click within the image to change + * // the value of the rectangle + * // after the mouse has been clicked + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a MouseEvent object + * // as a callback argument + * function mouseReleased(event) { + * console.log(event); + * } + * + *
    + * + * @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('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 handle clicks differently, so this function is only guaranteed to be + * run when the left mouse button is clicked. To handle other mouse buttons + * being pressed or released, see mousePressed() or mouseReleased().

    + * 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 + * @param {Object} [event] optional MouseEvent callback argument. + * @example + *
    + * + * // Click within the image to change + * // the value of the rectangle + * // after the mouse has been clicked + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a MouseEvent object + * // as a callback argument + * function mouseClicked(event) { + * console.log(event); + * } + * + *
    + * + * @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 doubleClicked() function is executed every time a event + * listener has detected a dblclick event which is a part of the + * DOM L3 specification. The doubleClicked event is fired when a + * pointing device button (usually a mouse's primary button) + * is clicked twice on a single element. For more info on the + * dblclick event refer to mozilla's documentation here: + * https://developer.mozilla.org/en-US/docs/Web/Events/dblclick + * + * @method doubleClicked + * @param {Object} [event] optional MouseEvent callback argument. + * @example + *
    + * + * // Click within the image to change + * // the value of the rectangle + * // after the mouse has been double clicked + * + * let value = 0; + * function draw() { + * fill(value); + * rect(25, 25, 50, 50); + * } + * + * function doubleClicked() { + * if (value === 0) { + * value = 255; + * } else { + * value = 0; + * } + * } + * + *
    + * + *
    + * + * function doubleClicked() { + * ellipse(mouseX, mouseY, 5, 5); + * // prevent default + * return false; + * } + * + *
    + * + *
    + * + * // returns a MouseEvent object + * // as a callback argument + * function doubleClicked(event) { + * console.log(event); + * } + * + *
    + * + * @alt + * black 50x50 rect turns white with mouse doubleClick/press. + * no image displayed + */ + +p5.prototype._ondblclick = function(e) { + var context = this._isGlobal ? window : this; + if (typeof context.doubleClicked === 'function') { + var executeDefault = context.doubleClicked(e); + if (executeDefault === false) { + e.preventDefault(); + } + } +}; + +/** + * For use with WebGL orbitControl. + * @property {Number} _mouseWheelDeltaY + * @readOnly + * @private + */ +p5.prototype._mouseWheelDeltaY = 0; + +/** + * For use with WebGL orbitControl. + * @property {Number} _pmouseWheelDeltaY + * @readOnly + * @private + */ +p5.prototype._pmouseWheelDeltaY = 0; + +/** + * The function mouseWheel() is executed every time a vertical mouse wheel + * event is detected either triggered by an actual mouse wheel or by a + * touchpad.

    + * The event.delta property returns the amount the mouse wheel + * 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 + * @param {Object} [event] optional WheelEvent callback argument. + * + * @example + *
    + * + * let 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. fuchsia background + * + */ +p5.prototype._onwheel = function(e) { + var context = this._isGlobal ? window : this; + this._setProperty('_mouseWheelDeltaY', e.deltaY); + if (typeof context.mouseWheel === 'function') { + e.delta = e.deltaY; + var executeDefault = context.mouseWheel(e); + if (executeDefault === false) { + e.preventDefault(); + } + } +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/main":24}],41:[function(_dereq_,module,exports){ +/** + * @module Events + * @submodule Touch + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * 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. + * + * The touches[] array is not supported on Safari and IE on touch-based + * desktops (laptops). + * + * @property {Object[]} touches + * @readOnly + * + * @example + *
    + * + * // On a touchscreen device, touch + * // the canvas using one or more fingers + * // at the same time + * function draw() { + * clear(); + * let display = touches.length + ' touches'; + * text(display, 5, 10); + * } + * + *
    + * + * @alt + * Number of touches currently registered are displayed on the canvas + */ +p5.prototype.touches = []; + +p5.prototype._updateTouchCoords = function(e) { + if (this._curElement !== null) { + var touches = []; + for (var i = 0; i < e.touches.length; i++) { + touches[i] = getTouchInfo( + this._curElement.elt, + this.width, + this.height, + e, + i + ); + } + 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 + * @param {Object} [event] optional TouchEvent callback argument. + * @example + *
    + * + * // Touch within the image to change + * // the value of the rectangle + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a TouchEvent object + * // as a callback argument + * function touchStarted(event) { + * console.log(event); + * } + * + *
    + * + * @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._setProperty('mouseIsPressed', true); + this._updateTouchCoords(e); + this._updateNextMouseCoords(e); + this._updateMouseCoords(); // reset pmouseXY at the start of each touch event + 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(); + } + } +}; + +/** + * 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 + * @param {Object} [event] optional TouchEvent callback argument. + * @example + *
    + * + * // Move your finger across the page + * // to change its value + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a TouchEvent object + * // as a callback argument + * function touchMoved(event) { + * console.log(event); + * } + * + *
    + * + * @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 + * @param {Object} [event] optional TouchEvent callback argument. + * @example + *
    + * + * // Release touch within the image to + * // change the value of the rectangle + * + * let 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; + * } + * + *
    + * + *
    + * + * // returns a TouchEvent object + * // as a callback argument + * function touchEnded(event) { + * console.log(event); + * } + * + *
    + * + * @alt + * 50x50 black rect turns white with touch. + * no image displayed + * + */ +p5.prototype._ontouchend = function(e) { + this._setProperty('mouseIsPressed', false); + this._updateTouchCoords(e); + this._updateNextMouseCoords(e); + 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(); + } + } +}; + +module.exports = p5; + +},{"../core/main":24}],42:[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. + * + * @private + * @param {HTMLCanvasElement} canvas [description] + * @param {function(ImageData,Object)} func [description] + * @param {Object} filterParam [description] + */ +Filters.apply = function(canvas, func, filterParam) { + var pixelsState = canvas.getContext('2d'); + var imageData = pixelsState.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) { + pixelsState.putImageData( + newImageData, + 0, + 0, + 0, + 0, + canvas.width, + canvas.height + ); + } else { + pixelsState.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/ + * + * @private + * @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/ + * + * @private + * @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. + * + * @private + * @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. + * @private + * @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 + * + * @private + * @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 + * @private + * @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; + var colRight, colLeft, colUp, colDown; + var 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 + * @private + * @param {Canvas} canvas + * + */ +Filters.erode = function(canvas) { + var pixels = Filters._toPixels(canvas); + var currIdx = 0; + var maxIdx = pixels.length ? pixels.length / 4 : 0; + var out = new Int32Array(maxIdx); + var currRowIdx, maxRowIdx, colOrig, colOut, currLum; + var idxRight, idxLeft, idxUp, idxDown; + var colRight, colLeft, colUp, colDown; + var lumRight, lumLeft, lumUp, lumDown; + + while (currIdx < maxIdx) { + currRowIdx = currIdx; + maxRowIdx = currIdx + canvas.width; + while (currIdx < maxRowIdx) { + 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; + +},{}],43:[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/main'); +// This is not global, but ESLint is not aware that +// this module is implicitly enclosed with Browserify: this overrides the +// redefined-global error and permits using the name "frames" for the array +// of saved animation frames. + +/* global frames:true */ 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 + *
    + * + * let img = createImage(66, 66); + * img.loadPixels(); + * for (let i = 0; i < img.width; i++) { + * for (let j = 0; j < img.height; j++) { + * img.set(i, j, color(0, 90, 102)); + * } + * } + * img.updatePixels(); + * image(img, 17, 17); + * + *
    + * + *
    + * + * let img = createImage(66, 66); + * img.loadPixels(); + * for (let i = 0; i < img.width; i++) { + * for (let 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); + * + *
    + * + *
    + * + * let pink = color(255, 102, 204); + * let img = createImage(66, 66); + * img.loadPixels(); + * let d = pixelDensity(); + * let halfImage = 4 * (img.width * d) * (img.height / 2 * d); + * for (let 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) { + p5._validateParameters('createImage', arguments); + return new p5.Image(width, height); +}; + +/** + * Save the current canvas as an image. The browser will either save the + * file immediately, or prompt the user with a dialogue window. + * + * @method saveCanvas + * @param {p5.Element|HTMLCanvasElement} selectedCanvas a variable + * representing a specific html5 canvas (optional) + * @param {String} [filename] + * @param {String} [extension] 'jpg' or 'png' + * + * @example + *
    + * function setup() { + * let 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() { + * let c = createCanvas(100, 100); + * background(255, 0, 0); + * saveCanvas('myCanvas', 'jpg'); + * + * // all of the following are valid + * saveCanvas(c, 'myCanvas', 'jpg'); + * saveCanvas(c, 'myCanvas.jpg'); + * saveCanvas(c, 'myCanvas'); + * saveCanvas(c); + * saveCanvas('myCanvas', 'png'); + * saveCanvas('myCanvas'); + * saveCanvas(); + * } + *
    + * + * @alt + * no image displayed + * no image displayed + * no image displayed + */ +/** + * @method saveCanvas + * @param {String} [filename] + * @param {String} [extension] + */ +p5.prototype.saveCanvas = function() { + p5._validateParameters('saveCanvas', arguments); + + // copy arguments to array + var args = [].slice.call(arguments); + var htmlCanvas, filename, extension; + + if (arguments[0] instanceof HTMLCanvasElement) { + htmlCanvas = arguments[0]; + args.shift(); + } else if (arguments[0] instanceof p5.Element) { + htmlCanvas = arguments[0].elt; + args.shift(); + } else { + htmlCanvas = this._curElement && this._curElement.elt; + } + + if (args.length >= 1) { + filename = args[0]; + } + if (args.length >= 2) { + extension = args[1]; + } + + extension = + extension || + p5.prototype._checkFileExtension(filename, extension)[1] || + 'png'; + + var mimeType; + switch (extension) { + default: + //case 'png': + mimeType = 'image/png'; + break; + case 'jpeg': + case 'jpg': + mimeType = 'image/jpeg'; + break; + } + + htmlCanvas.toBlob(function(blob) { + p5.prototype.downloadFile(blob, filename, extension); + }, mimeType); +}; + +/** + * 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. + * + * Note that saveFrames() will only save the first 15 frames of an animation. + * To export longer animations, you might look into a library like + * ccapture.js. + * + * @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(Array)} [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, data => { + * print(data); + * }); + * } +
    + * + * @alt + * canvas background goes from light to dark with mouse x. + * + */ +p5.prototype.saveFrames = function(fName, ext, _duration, _fps, callback) { + p5._validateParameters('saveFrames', arguments); + var duration = _duration || 3; + duration = p5.prototype.constrain(duration, 0, 15); + duration = duration * 1000; + 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/main":24}],44:[function(_dereq_,module,exports){ +/** + * @module Image + * @submodule Loading & Displaying + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var Filters = _dereq_('./filters'); +var canvas = _dereq_('../core/helpers'); +var constants = _dereq_('../core/constants'); + +_dereq_('../core/error_helpers'); + +/** + * Loads an image from a path and creates a p5.Image from it. + *

    + * 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 image 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 + *
    + * + * let 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', 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) { + p5._validateParameters('loadImage', arguments); + var img = new Image(); + var pImg = new p5.Image(1, 1, this); + + var self = this; + 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); + pImg.modified = true; + + if (typeof successCallback === 'function') { + successCallback(pImg); + } + + self._decrementPreload(); + }; + img.onerror = function(e) { + p5._friendlyFileLoadError(0, img.src); + if (typeof failureCallback === 'function') { + failureCallback(e); + } else { + console.error(e); + } + }; + + // Set crossOrigin in case image is served with CORS headers. + // This will let us draw to the canvas without tainting it. + // See https://developer.mozilla.org/en-US/docs/HTML/CORS_Enabled_Image + // When using data-uris the file will be loaded locally + // so we don't need to worry about crossOrigin with base64 file types. + if (path.indexOf('data:image/') !== 0) { + 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 p5.js canvas. + * + * This function can be used with different numbers of parameters. The + * simplest use requires only three parameters: img, x, and y—where (x, y) is + * the position of the image. Two more parameters can optionally be added to + * specify the width and height of the image. + * + * This function can also be used with all eight Number parameters. To + * differentiate between all these parameters, p5.js uses the language of + * "destination rectangle" (which corresponds to "dx", "dy", etc.) and "source + * image" (which corresponds to "sx", "sy", etc.) below. Specifying the + * "source image" dimensions can be useful when you want to display a + * subsection of the source image instead of the whole thing. Here's a diagram + * to explain further: + * + * + * @method image + * @param {p5.Image|p5.Element} img the image to display + * @param {Number} x the x-coordinate of the top-left corner of the image + * @param {Number} y the y-coordinate of the top-left corner of the image + * @param {Number} [width] the width to draw the image + * @param {Number} [height] the height to draw the image + * @example + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/laDefense.jpg'); + * } + * function setup() { + * // Top-left corner of the img is at (0, 0) + * // Width and height are the img's original width and height + * image(img, 0, 0); + * } + * + *
    + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/laDefense.jpg'); + * } + * function setup() { + * background(50); + * // Top-left corner of the img is at (10, 10) + * // Width and height are 50 x 50 + * image(img, 10, 10, 50, 50); + * } + * + *
    + *
    + * + * function setup() { + * // Here, we use a callback to display the image after loading + * loadImage('assets/laDefense.jpg', img => { + * image(img, 0, 0); + * }); + * } + * + *
    + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/gradient.png'); + * } + * function setup() { + * // 1. Background image + * // Top-left corner of the img is at (0, 0) + * // Width and height are the img's original width and height, 100 x 100 + * image(img, 0, 0); + * // 2. Top right image + * // Top-left corner of destination rectangle is at (50, 0) + * // Destination rectangle width and height are 40 x 20 + * // The next parameters are relative to the source image: + * // - Starting at position (50, 50) on the source image, capture a 50 x 50 + * // subsection + * // - Draw this subsection to fill the dimensions of the destination rectangle + * image(img, 50, 0, 40, 20, 50, 50, 50, 50); + * } + * + *
    + * @alt + * image of the underside of a white umbrella and gridded ceiling above + * image of the underside of a white umbrella and gridded ceiling above + * + */ +/** + * @method image + * @param {p5.Image|p5.Element} img + * @param {Number} dx the x-coordinate of the destination + * rectangle in which to draw the source image + * @param {Number} dy the y-coordinate of the destination + * rectangle in which to draw the source image + * @param {Number} dWidth the width of the destination rectangle + * @param {Number} dHeight the height of the destination rectangle + * @param {Number} sx the x-coordinate of the subsection of the source + * image to draw into the destination rectangle + * @param {Number} sy the y-coordinate of the subsection of the source + * image to draw into the destination rectangle + * @param {Number} [sWidth] the width of the subsection of the + * source image to draw into the destination + * rectangle + * @param {Number} [sHeight] the height of the subsection of the + * source image to draw into the destination rectangle + */ +p5.prototype.image = function( + img, + dx, + dy, + dWidth, + dHeight, + sx, + sy, + sWidth, + sHeight +) { + // set defaults per spec: https://goo.gl/3ykfOq + + p5._validateParameters('image', arguments); + + var defW = img.width; + var defH = img.height; + + if (img.elt && img.elt.videoWidth && !img.canvas) { + // video no canvas + defW = img.elt.videoWidth; + defH = img.elt.videoHeight; + } + + 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.canvas && img.elt.style.width) { + //if img is video and img.elt.size() has been used and + //no width passed to image() + if (img.elt.videoWidth && !dWidth) { + pd = img.elt.videoWidth; + } else { + //all other cases + pd = img.elt.width; + } + pd /= 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} v1 red or hue value relative to + * the current color range + * @param {Number} v2 green or saturation value + * relative to the current color range + * @param {Number} v3 blue or brightness value + * relative to the current color range + * @param {Number} [alpha] + * + * @example + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/laDefense.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * tint(0, 153, 204); // Tint blue + * image(img, 50, 0); + * } + * + *
    + * + *
    + * + * let 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); + * } + * + *
    + * + *
    + * + * let 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 + * + */ + +/** + * @method tint + * @param {String} value a color string + */ + +/** + * @method tint + * @param {Number} gray a gray value + * @param {Number} [alpha] + */ + +/** + * @method tint + * @param {Number[]} values an array containing the red,green,blue & + * and alpha components of the color + */ + +/** + * @method tint + * @param {p5.Color} color the tint color + */ +p5.prototype.tint = function() { + p5._validateParameters('tint', arguments); + var c = this.color.apply(this, arguments); + this._renderer._tint = c.levels; +}; + +/** + * Removes the current fill value for displaying images and reverts to + * displaying images with their original hues. + * + * @method noTint + * @example + *
    + * + * let 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. + * + * @private + * @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 + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * imageMode(CORNER); + * image(img, 10, 10, 50, 50); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * imageMode(CORNERS); + * image(img, 10, 10, 90, 40); + * } + * + *
    + * + *
    + * + * let 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) { + p5._validateParameters('imageMode', arguments); + if ( + m === constants.CORNER || + m === constants.CORNERS || + m === constants.CENTER + ) { + this._renderer._imageMode = m; + } +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/error_helpers":20,"../core/helpers":21,"../core/main":24,"./filters":42}],45:[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/main'); +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. + * @example + *
    + * function setup() { + * let img = createImage(100, 100); // same as new p5.Image(100, 100); + * img.loadPixels(); + * createCanvas(100, 100); + * background(0); + * + * // helper for writing color to array + * function writeColor(image, x, y, red, green, blue, alpha) { + * let index = (x + y * width) * 4; + * image.pixels[index] = red; + * image.pixels[index + 1] = green; + * image.pixels[index + 2] = blue; + * image.pixels[index + 3] = alpha; + * } + * + * let x, y; + * // fill with random colors + * for (y = 0; y < img.height; y++) { + * for (x = 0; x < img.width; x++) { + * let red = random(255); + * let green = random(255); + * let blue = random(255); + * let alpha = 255; + * writeColor(img, x, y, red, green, blue, alpha); + * } + * } + * + * // draw a red line + * y = 0; + * for (x = 0; x < img.width; x++) { + * writeColor(img, x, y, 255, 0, 0, 255); + * } + * + * // draw a green line + * y = img.height - 1; + * for (x = 0; x < img.width; x++) { + * writeColor(img, x, y, 0, 255, 0, 255); + * } + * + * img.updatePixels(); + * image(img, 0, 0); + * } + *
    + * + * + * @class p5.Image + * @param {Number} width + * @param {Number} height + */ +p5.Image = function(width, height) { + /** + * Image width. + * @property {Number} width + * @readOnly + * @example + *
    + * let img; + * function preload() { + * img = loadImage('assets/rockies.jpg'); + * } + * + * function setup() { + * createCanvas(100, 100); + * image(img, 0, 0); + * for (let i = 0; i < img.width; i++) { + * let 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 {Number} height + * @readOnly + * @example + *
    + * let img; + * function preload() { + * img = loadImage('assets/rockies.jpg'); + * } + * + * function setup() { + * createCanvas(100, 100); + * image(img, 0, 0); + * for (let i = 0; i < img.height; i++) { + * let 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._pixelsState = this; + this._pixelDensity = 1; + //used for webgl texturing only + this._modified = false; + this._pixelsDirty = true; + /** + * Array containing the values for all the pixels in the display window. + * These values are numbers. This array is the size (include an appropriate + * factor for pixelDensity) of the display window x4, + * representing the R, G, B, A values in order for each pixel, moving from + * left to right across each row, then down each column. Retina and other + * high denisty displays may have more pixels (by a factor of + * 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 + * let d = pixelDensity(); + * for (let i = 0; i < d; i++) { + * for (let j = 0; j < d; j++) { + * // loop over + * index = 4 * ((y * d + j) * width * d + (x * d + i)); + * pixels[index] = r; + * pixels[index+1] = g; + * pixels[index+2] = b; + * pixels[index+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 + *
    + * + * let img = createImage(66, 66); + * img.loadPixels(); + * for (let i = 0; i < img.width; i++) { + * for (let j = 0; j < img.height; j++) { + * img.set(i, j, color(0, 90, 102)); + * } + * } + * img.updatePixels(); + * image(img, 17, 17); + * + *
    + *
    + * + * let pink = color(255, 102, 204); + * let img = createImage(66, 66); + * img.loadPixels(); + * for (let 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; + this.setModified(true); +}; + +/** + * Loads the pixels data for this image into the [pixels] attribute. + * + * @method loadPixels + * @example + *
    + * let myImage; + * let halfImage; + * + * function preload() { + * myImage = loadImage('assets/rockies.jpg'); + * } + * + * function setup() { + * myImage.loadPixels(); + * halfImage = 4 * myImage.width * myImage.height / 2; + * for (let i = 0; i < halfImage; i++) { + * myImage.pixels[i + halfImage] = myImage.pixels[i]; + * } + * myImage.updatePixels(); + * } + * + * function draw() { + * image(myImage, 0, 0, width, height); + * } + *
    + * + * @alt + * 2 images of rocky mountains vertically stacked + * + */ +p5.Image.prototype.loadPixels = function() { + p5.Renderer2D.prototype.loadPixels.call(this); + this.setModified(true); +}; + +/** + * Updates the backing canvas for this image with the contents of + * the [pixels] array. + * + * @method updatePixels + * @param {Integer} x x-offset of the target update area for the + * underlying canvas + * @param {Integer} y y-offset of the target update area for the + * underlying canvas + * @param {Integer} w height of the target update area for the + * underlying canvas + * @param {Integer} h height of the target update area for the + * underlying canvas + * @example + *
    + * let myImage; + * let halfImage; + * + * function preload() { + * myImage = loadImage('assets/rockies.jpg'); + * } + * + * function setup() { + * myImage.loadPixels(); + * halfImage = 4 * myImage.width * myImage.height / 2; + * for (let i = 0; i < halfImage; i++) { + * myImage.pixels[i + halfImage] = myImage.pixels[i]; + * } + * myImage.updatePixels(); + * } + * + * function draw() { + * image(myImage, 0, 0, width, height); + * } + *
    + * + * @alt + * 2 images of rocky mountains vertically stacked + * + */ +/** + * @method updatePixels + */ +p5.Image.prototype.updatePixels = function(x, y, w, h) { + p5.Renderer2D.prototype.updatePixels.call(this, x, y, w, h); + this.setModified(true); +}; + +/** + * Get a region of pixels from an image. + * + * If no params are passed, the 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. + * + * @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 {p5.Image} the rectangle p5.Image + * @example + *
    + * let myImage; + * let 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 + * + */ +/** + * @method get + * @return {p5.Image} the whole p5.Image + */ +/** + * @method get + * @param {Number} x + * @param {Number} y + * @return {Number[]} color of pixel at x,y in array format [R, G, B, A] + */ +p5.Image.prototype.get = function(x, y, w, h) { + p5._validateParameters('p5.Image.get', arguments); + return p5.Renderer2D.prototype.get.apply(this, arguments); +}; + +p5.Image.prototype._getPixel = p5.Renderer2D.prototype._getPixel; + +/** + * 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|Number[]|Object} a grayscale value | pixel array | + * a p5.Color | image to copy + * @example + *
    + * + * let img = createImage(66, 66); + * img.loadPixels(); + * for (let i = 0; i < img.width; i++) { + * for (let 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); + this.setModified(true); +}; + +/** + * 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 + *
    + * let img; + * + * function preload() { + * 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; + // prettier-ignore + tempCanvas.getContext('2d').drawImage( + this.canvas, + 0, 0, this.canvas.width, this.canvas.height, + 0, 0, tempCanvas.width, tempCanvas.height + ); + + // Resize the original canvas, which will clear its contents + this.canvas.width = this.width = width; + this.canvas.height = this.height = height; + + //Copy the image back + + // prettier-ignore + this.drawingContext.drawImage( + tempCanvas, + 0, 0, width, height, + 0, 0, width, height + ); + + if (this.pixels.length > 0) { + this.loadPixels(); + } + + this.setModified(true); + this._pixelsDirty = true; +}; + +/** + * 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|p5.Element} srcImage source image + * @param {Integer} sx X coordinate of the source's upper left corner + * @param {Integer} sy Y coordinate of the source's upper left corner + * @param {Integer} sw source image width + * @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 + *
    + * let photo; + * let bricks; + * let x; + * let 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 + * + */ +/** + * @method copy + * @param {Integer} sx + * @param {Integer} sy + * @param {Integer} sw + * @param {Integer} sh + * @param {Integer} dx + * @param {Integer} dy + * @param {Integer} dw + * @param {Integer} dh + */ +p5.Image.prototype.copy = function() { + var srcImage, sx, sy, sw, sh, dx, dy, dw, dh; + if (arguments.length === 9) { + srcImage = arguments[0]; + sx = arguments[1]; + sy = arguments[2]; + sw = arguments[3]; + sh = arguments[4]; + dx = arguments[5]; + dy = arguments[6]; + dw = arguments[7]; + dh = arguments[8]; + } else if (arguments.length === 8) { + srcImage = this; + sx = arguments[0]; + sy = arguments[1]; + sw = arguments[2]; + sh = arguments[3]; + dx = arguments[4]; + dy = arguments[5]; + dw = arguments[6]; + dh = arguments[7]; + } else { + throw new Error('Signature not supported'); + } + p5.Renderer2D._copyHelper(this, srcImage, sx, sy, sw, sh, dx, dy, dw, dh); + this._pixelsDirty = true; +}; + +/** + * 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 + *
    + * let 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; + this.setModified(true); +}; + +/** + * Applies an image filter to a p5.Image + * + * @method filter + * @param {Constant} filterType either THRESHOLD, GRAY, OPAQUE, INVERT, + * POSTERIZE, BLUR, ERODE, DILATE or BLUR. + * See Filters.js for docs on + * each available filter + * @param {Number} [filterParam] an optional parameter unique + * to each filter, see above + * @example + *
    + * let photo1; + * let 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], value); + this.setModified(true); +}; + +/** + * Copies a region of pixels from one image to another, using a specified + * blend mode to do the operation. + * + * @method blend + * @param {p5.Image} srcImage source image + * @param {Integer} sx X coordinate of the source's upper left corner + * @param {Integer} sy Y coordinate of the source's upper left corner + * @param {Integer} sw source image width + * @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 {Constant} blendMode the blend mode. either + * BLEND, DARKEST, LIGHTEST, DIFFERENCE, + * MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT, + * SOFT_LIGHT, DODGE, BURN, ADD or NORMAL. + * + * Available blend modes are: normal | multiply | screen | overlay | + * darken | lighten | color-dodge | color-burn | hard-light | + * soft-light | difference | exclusion | hue | saturation | + * color | luminosity + * + * + * http://blogs.adobe.com/webplatform/2013/01/28/blending-features-in-canvas/ + * @example + *
    + * let mountains; + * let 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); + * } + *
    + *
    + * let mountains; + * let 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); + * } + *
    + *
    + * let mountains; + * let 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 + * + */ +/** + * @method blend + * @param {Integer} sx + * @param {Integer} sy + * @param {Integer} sw + * @param {Integer} sh + * @param {Integer} dx + * @param {Integer} dy + * @param {Integer} dw + * @param {Integer} dh + * @param {Constant} blendMode + */ +p5.Image.prototype.blend = function() { + p5.prototype.blend.apply(this, arguments); + this.setModified(true); +}; + +/** + * helper method for web GL mode to indicate that an image has been + * changed or unchanged since last upload. gl texture upload will + * set this value to false after uploading the texture. + * @method setModified + * @param {boolean} val sets whether or not the image has been + * modified. + * @private + */ +p5.Image.prototype.setModified = function(val) { + this._modified = val; //enforce boolean? +}; + +/** + * helper method for web GL mode to figure out if the image + * has been modified and might need to be re-uploaded to texture + * memory between frames. + * @method isModified + * @private + * @return {boolean} a boolean indicating whether or not the + * image has been updated or modified since last texture upload. + */ +p5.Image.prototype.isModified = function() { + return this._modified; +}; + +/** + * 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 + *
    + * let 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) { + p5.prototype.saveCanvas(this.canvas, filename, extension); +}; + +module.exports = p5.Image; + +},{"../core/main":24,"./filters":42}],46:[function(_dereq_,module,exports){ +/** + * @module Image + * @submodule Pixels + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +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 density 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 + * let d = pixelDensity(); + * for (let i = 0; i < d; i++) { + * for (let j = 0; j < d; j++) { + * // loop over + * index = 4 * ((y * d + j) * width * d + (x * d + i)); + * pixels[index] = r; + * pixels[index+1] = g; + * pixels[index+2] = b; + * pixels[index+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 + *
    + * + * let pink = color(255, 102, 204); + * loadPixels(); + * let d = pixelDensity(); + * let halfImage = 4 * (width * d) * (height / 2 * d); + * for (let 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. + * + * @method blend + * @param {p5.Image} srcImage source image + * @param {Integer} sx X coordinate of the source's upper left corner + * @param {Integer} sy Y coordinate of the source's upper left corner + * @param {Integer} sw source image width + * @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 {Constant} blendMode the blend mode. either + * BLEND, DARKEST, LIGHTEST, DIFFERENCE, + * MULTIPLY, EXCLUSION, SCREEN, REPLACE, OVERLAY, HARD_LIGHT, + * SOFT_LIGHT, DODGE, BURN, ADD or NORMAL. + * + * @example + *
    + * let img0; + * let 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); + * } + *
    + *
    + * let img0; + * let 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); + * } + *
    + *
    + * let img0; + * let 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 + * + * + */ +/** + * @method blend + * @param {Integer} sx + * @param {Integer} sy + * @param {Integer} sw + * @param {Integer} sh + * @param {Integer} dx + * @param {Integer} dy + * @param {Integer} dw + * @param {Integer} dh + * @param {Constant} blendMode + */ +p5.prototype.blend = function() { + p5._validateParameters('blend', arguments); + if (this._renderer) { + this._renderer.blend.apply(this._renderer, arguments); + } else { + 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|p5.Element} srcImage source image + * @param {Integer} sx X coordinate of the source's upper left corner + * @param {Integer} sy Y coordinate of the source's upper left corner + * @param {Integer} sw source image width + * @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 + *
    + * let 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 + * + */ +/** + * @method copy + * @param {Integer} sx + * @param {Integer} sy + * @param {Integer} sw + * @param {Integer} sh + * @param {Integer} dx + * @param {Integer} dy + * @param {Integer} dw + * @param {Integer} dh + */ +p5.prototype.copy = function() { + p5._validateParameters('copy', arguments); + p5.Renderer2D.prototype.copy.apply(this._renderer, arguments); +}; + +/** + * 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 Gaussian blur with the level parameter specifying the extent + * of the blurring. If no parameter is used, the blur is equivalent to + * Gaussian 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 either THRESHOLD, GRAY, OPAQUE, INVERT, + * POSTERIZE, BLUR, ERODE, DILATE or BLUR. + * See Filters.js for docs on + * each available filter + * @param {Number} [filterParam] an optional parameter unique + * to each filter, see above + * + * @example + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * filter(THRESHOLD); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * filter(GRAY); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * filter(OPAQUE); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * filter(INVERT); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * filter(POSTERIZE, 3); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * filter(DILATE); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/bricks.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * filter(BLUR, 3); + * } + * + *
    + * + *
    + * + * let 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) { + p5._validateParameters('filter', arguments); + if (this.canvas !== undefined) { + Filters.apply(this.canvas, Filters[operation], value); + } else { + Filters.apply(this.elt, Filters[operation], value); + } +}; + +/** + * Get a region of pixels, or a single pixel, from the canvas. + * + * 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(). + *

    + * To get the color components 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 + * ```javascript + * let x, y, d; // set these to the coordinates + * let off = (y * width + x) * d * 4; + * let components = [ + * pixels[off], + * pixels[off + 1], + * pixels[off + 2], + * pixels[off + 3] + * ]; + * print(components); + * ``` + *

    + * + * See the reference for pixels[] for more information. + * + * If you want to extract an array of colors or a subimage from an p5.Image object, + * take a look at p5.Image.get() + * + * @method get + * @param {Number} x x-coordinate of the pixel + * @param {Number} y y-coordinate of the pixel + * @param {Number} w width + * @param {Number} h height + * @return {p5.Image} the rectangle p5.Image + * @example + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/rockies.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * let c = get(); + * image(c, width / 2, 0); + * } + * + *
    + * + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/rockies.jpg'); + * } + * function setup() { + * image(img, 0, 0); + * let 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 + * + */ +/** + * @method get + * @return {p5.Image} the whole p5.Image + */ +/** + * @method get + * @param {Number} x + * @param {Number} y + * @return {Number[]} color of pixel at x,y in array format [R, G, B, A] + */ +p5.prototype.get = function(x, y, w, h) { + p5._validateParameters('get', arguments); + return this._renderer.get.apply(this._renderer, arguments); +}; + +/** + * Loads the pixel data for the display window into the pixels[] array. This + * function must always be called before reading from or writing to pixels[]. + * Note that only changes made with set() or direct manipulation of pixels[] + * will occur. + * + * @method loadPixels + * @example + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/rockies.jpg'); + * } + * + * function setup() { + * image(img, 0, 0, width, height); + * let d = pixelDensity(); + * let halfImage = 4 * (width * d) * (height * d / 2); + * loadPixels(); + * for (let 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() { + p5._validateParameters('loadPixels', arguments); + 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|Number[]|Object} c insert a grayscale value | a pixel array | + * a p5.Color object | a p5.Image to copy + * @example + *
    + * + * let black = color(0); + * set(30, 20, black); + * set(85, 20, black); + * set(85, 75, black); + * set(30, 75, black); + * updatePixels(); + * + *
    + * + *
    + * + * for (let i = 30; i < width - 15; i++) { + * for (let j = 20; j < height - 25; j++) { + * let c = color(204 - j, 153 - i, 0); + * set(i, j, c); + * } + * } + * updatePixels(); + * + *
    + * + *
    + * + * let 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, and only changes made with + * set() or direct changes to pixels[] will occur. + * + * @method updatePixels + * @param {Number} [x] x-coordinate of the upper-left corner of region + * 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 + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/rockies.jpg'); + * } + * + * function setup() { + * image(img, 0, 0, width, height); + * let d = pixelDensity(); + * let halfImage = 4 * (width * d) * (height * d / 2); + * loadPixels(); + * for (let 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) { + p5._validateParameters('updatePixels', arguments); + // graceful fail - if loadPixels() or set() has not been called, pixel + // array will be empty, ignore call to updatePixels() + if (this.pixels.length === 0) { + return; + } + this._renderer.updatePixels(x, y, w, h); +}; + +module.exports = p5; + +},{"../color/p5.Color":16,"../core/main":24,"./filters":42}],47:[function(_dereq_,module,exports){ +/** + * @module IO + * @submodule Input + * @for p5 + * @requires core + */ + +/* globals Request: false */ +/* globals Headers: false */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +_dereq_('whatwg-fetch'); +_dereq_('es6-promise').polyfill(); +var fetchJsonp = _dereq_('fetch-jsonp'); +_dereq_('../core/error_helpers'); + +/** + * Loads a JSON file from a file or a URL, and returns an Object. + * Note that even if the JSON file contains an Array, an Object will be + * returned with index numbers as keys. + * + * 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. + * + * This method is suitable for fetching files up to size of 64MB. + * @method loadJSON + * @param {String} path name of the file or url to load + * @param {Object} [jsonpOptions] options object for jsonp related settings + * @param {String} [datatype] "json" or "jsonp" + * @param {function} [callback] function to be executed after + * loadJSON() completes, data is passed + * 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.

    + * + *
    + * // Examples use USGS Earthquake API: + * // https://earthquake.usgs.gov/fdsnws/event/1/#methods + * let earthquakes; + * function preload() { + * // Get the most recent earthquake in the database + * let url = + 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' + + * 'summary/all_day.geojson'; + * earthquakes = loadJSON(url); + * } + * + * function setup() { + * noLoop(); + * } + * + * function draw() { + * background(200); + * // Get the magnitude and name of the earthquake out of the loaded JSON + * let earthquakeMag = earthquakes.features[0].properties.mag; + * let earthquakeName = earthquakes.features[0].properties.place; + * ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10); + * textAlign(CENTER); + * text(earthquakeName, 0, height - 30, width, 30); + * } + *
    + * + * + *

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

    + *
    + * function setup() { + * noLoop(); + * let url = + 'https://earthquake.usgs.gov/earthquakes/feed/v1.0/' + + * 'summary/all_day.geojson'; + * loadJSON(url, drawEarthquake); + * } + * + * function draw() { + * background(200); + * } + * + * function drawEarthquake(earthquakes) { + * // Get the magnitude and name of the earthquake out of the loaded JSON + * let earthquakeMag = earthquakes.features[0].properties.mag; + * let earthquakeName = earthquakes.features[0].properties.place; + * ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10); + * textAlign(CENTER); + * text(earthquakeName, 0, height - 30, width, 30); + * } + *
    + * + * @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 + * + */ +/** + * @method loadJSON + * @param {String} path + * @param {String} datatype + * @param {function} [callback] + * @param {function} [errorCallback] + * @return {Object|Array} + */ +/** + * @method loadJSON + * @param {String} path + * @param {function} callback + * @param {function} [errorCallback] + * @return {Object|Array} + */ +p5.prototype.loadJSON = function() { + p5._validateParameters('loadJSON', arguments); + var path = arguments[0]; + var callback; + var errorCallback; + var options; + + 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; + } + } + + var self = this; + this.httpDo( + path, + 'GET', + options, + t, + function(resp) { + for (var k in resp) { + ret[k] = resp[k]; + } + if (typeof callback !== 'undefined') { + callback(resp); + } + + self._decrementPreload(); + }, + function(err) { + // Error handling + p5._friendlyFileLoadError(5, path); + + if (errorCallback) { + errorCallback(err); + } else { + throw err; + } + } + ); + + 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. + * + * This method is suitable for fetching files up to size of 64MB. + * @method loadStrings + * @param {String} filename name of the file or url to load + * @param {function} [callback] function to be executed after loadStrings() + * 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 {String[]} Array of Strings + * @example + * + *

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

    + * + *
    + * let result; + * function preload() { + * result = loadStrings('assets/test.txt'); + * } + + * function setup() { + * background(200); + * let 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); + * let 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() { + p5._validateParameters('loadStrings', arguments); + + var ret = []; + var callback, errorCallback; + + for (var i = 1; i < arguments.length; i++) { + var arg = arguments[i]; + if (typeof arg === 'function') { + if (typeof callback === 'undefined') { + callback = arg; + } else if (typeof errorCallback === 'undefined') { + errorCallback = arg; + } + } + } + + var self = this; + p5.prototype.httpDo.call( + this, + arguments[0], + 'GET', + 'text', + function(data) { + // split lines handling mac/windows/linux endings + var lines = data + .replace(/\r\n/g, '\r') + .replace(/\n/g, '\r') + .split(/\r/); + Array.prototype.push.apply(ret, lines); + + if (typeof callback !== 'undefined') { + callback(ret); + } + + self._decrementPreload(); + }, + function(err) { + // Error handling + p5._friendlyFileLoadError(3, arguments[0]); + + if (errorCallback) { + errorCallback(err); + } else { + throw err; + } + } + ); + + 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:

    + *

    + * + * This method is suitable for fetching files up to size of 64MB. + * @method loadTable + * @param {String} filename name of the file or URL to load + * @param {String} options "header" "csv" "tsv" + * @param {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 + * + * let 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 (let r = 0; r < table.getRowCount(); r++) + * for (let 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" + * + */ +/** + * @method loadTable + * @param {String} filename + * @param {function} [callback] + * @param {function} [errorCallback] + * @return {Object} + */ +p5.prototype.loadTable = function(path) { + var callback; + var errorCallback; + var options = []; + var header = false; + var ext = path.substring(path.lastIndexOf('.') + 1, path.length); + var sep = ','; + var separatorSet = false; + + if (ext === 'tsv') { + //Only need to check extension is tsv because csv is default + sep = '\t'; + } + + for (var i = 1; i < arguments.length; i++) { + if (typeof arguments[i] === 'function') { + if (typeof callback === 'undefined') { + callback = arguments[i]; + } else if (typeof errorCallback === 'undefined') { + 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(); + + var self = this; + this.httpDo( + path, + 'GET', + 'table', + function(resp) { + var state = {}; + + // define constants + var PRE_TOKEN = 0, + MID_TOKEN = 1, + POST_TOKEN = 2, + POST_RECORD = 4; + + var QUOTE = '"', + CR = '\r', + LF = '\n'; + + var records = []; + var offset = 0; + var currentRecord = null; + var currentChar; + + var tokenBegin = function() { + state.currentState = PRE_TOKEN; + state.token = ''; + }; + + var tokenEnd = function() { + currentRecord.push(state.token); + tokenBegin(); + }; + + var recordBegin = function() { + state.escaped = false; + currentRecord = []; + tokenBegin(); + }; + + var recordEnd = function() { + state.currentState = POST_RECORD; + records.push(currentRecord); + currentRecord = null; + }; + + for (;;) { + 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 if (currentChar === CR) { + continue; + } else { + state.token += currentChar; + } + continue; + } + + // fall-through: mid-token or post-token, not escaped + if (currentChar === CR) { + if (resp[offset] === LF) { + offset++; + } + 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 (records[i].length === 1) { + if (records[i][0] === 'undefined' || records[i][0] === '') { + continue; + } + } + row = new p5.TableRow(); + row.arr = records[i]; + row.obj = makeObject(records[i], t.columns); + t.addRow(row); + } + if (typeof callback === 'function') { + callback(t); + } + + self._decrementPreload(); + }, + function(err) { + // Error handling + p5._friendlyFileLoadError(2, path); + + if (errorCallback) { + errorCallback(err); + } else { + console.error(err); + } + } + ); + + 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; +} + +/** + * 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. + * + * This method is suitable for fetching files up to size of 64MB. + * @method loadXML + * @param {String} filename name of the file or URL to load + * @param {function} [callback] function to be executed after loadXML() + * 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 + * @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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let children = xml.getChildren('animal'); + * + * for (let i = 0; i < children.length; i++) { + * let id = children[i].getNum('id'); + * let coloring = children[i].getString('species'); + * let 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.prototype.loadXML = function() { + var ret = new p5.XML(); + var callback, errorCallback; + + for (var i = 1; i < arguments.length; i++) { + var arg = arguments[i]; + if (typeof arg === 'function') { + if (typeof callback === 'undefined') { + callback = arg; + } else if (typeof errorCallback === 'undefined') { + errorCallback = arg; + } + } + } + + var self = this; + this.httpDo( + arguments[0], + 'GET', + 'xml', + function(xml) { + for (var key in xml) { + ret[key] = xml[key]; + } + if (typeof callback !== 'undefined') { + callback(ret); + } + + self._decrementPreload(); + }, + function(err) { + // Error handling + p5._friendlyFileLoadError(1, arguments[0]); + + if (errorCallback) { + errorCallback(err); + } else { + throw err; + } + } + ); + + return ret; +}; + +/** + * This method is suitable for fetching files up to size of 64MB. + * @method loadBytes + * @param {string} file name of the file or URL to load + * @param {function} [callback] function to be executed after loadBytes() + * completes + * @param {function} [errorCallback] function to be executed if there + * is an error + * @returns {Object} an object whose 'bytes' property will be the loaded buffer + * + * @example + *
    + * let data; + * + * function preload() { + * data = loadBytes('assets/mammals.xml'); + * } + * + * function setup() { + * for (let i = 0; i < 5; i++) { + * console.log(data.bytes[i].toString(16)); + * } + * } + *
    + * + * @alt + * no image displayed + * + */ +p5.prototype.loadBytes = function(file, callback, errorCallback) { + var ret = {}; + + var self = this; + this.httpDo( + file, + 'GET', + 'arrayBuffer', + function(arrayBuffer) { + ret.bytes = new Uint8Array(arrayBuffer); + + if (typeof callback === 'function') { + callback(ret); + } + + self._decrementPreload(); + }, + function(err) { + // Error handling + p5._friendlyFileLoadError(6, file); + + if (errorCallback) { + errorCallback(err); + } else { + throw err; + } + } + ); + return ret; +}; + +/** + * Method for executing an HTTP GET request. If data type is not specified, + * p5 will try to guess based on the URL, defaulting to text. This is equivalent to + * calling httpDo(path, 'GET'). The 'binary' datatype will return + * a Blob object, and the 'arrayBuffer' datatype will return an ArrayBuffer + * which can be used to initialize typed arrays (such as Uint8Array). + * + * @method httpGet + * @param {String} path name of the file or url to load + * @param {String} [datatype] "json", "jsonp", "binary", "arrayBuffer", + * "xml", or "text" + * @param {Object|Boolean} [data] param data passed sent with request + * @param {function} [callback] function to be executed after + * httpGet() completes, data is passed in + * as first argument + * @param {function} [errorCallback] function to be executed if + * there is an error, response is passed + * in as first argument + * @return {Promise} A promise that resolves with the data when the operation + * completes successfully or rejects with the error after + * one occurs. + * @example + *
    + * // Examples use USGS Earthquake API: + * // https://earthquake.usgs.gov/fdsnws/event/1/#methods + * let earthquakes; + * function preload() { + * // Get the most recent earthquake in the database + * let url = + 'https://earthquake.usgs.gov/fdsnws/event/1/query?' + + * 'format=geojson&limit=1&orderby=time'; + * httpGet(url, 'jsonp', false, function(response) { + * // when the HTTP request completes, populate the variable that holds the + * // earthquake data used in the visualization. + * earthquakes = response; + * }); + * } + * + * function draw() { + * if (!earthquakes) { + * // Wait until the earthquake data has loaded before drawing. + * return; + * } + * background(200); + * // Get the magnitude and name of the earthquake out of the loaded JSON + * let earthquakeMag = earthquakes.features[0].properties.mag; + * let earthquakeName = earthquakes.features[0].properties.place; + * ellipse(width / 2, height / 2, earthquakeMag * 10, earthquakeMag * 10); + * textAlign(CENTER); + * text(earthquakeName, 0, height - 30, width, 30); + * noLoop(); + * } + *
    + */ +/** + * @method httpGet + * @param {String} path + * @param {Object|Boolean} data + * @param {function} [callback] + * @param {function} [errorCallback] + * @return {Promise} + */ +/** + * @method httpGet + * @param {String} path + * @param {function} callback + * @param {function} [errorCallback] + * @return {Promise} + */ +p5.prototype.httpGet = function() { + p5._validateParameters('httpGet', arguments); + + var args = Array.prototype.slice.call(arguments); + args.splice(1, 0, 'GET'); + return 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". + * If omitted, httpPost() will guess. + * @param {Object|Boolean} [data] param data passed sent with request + * @param {function} [callback] function to be executed after + * httpPost() completes, data is passed in + * as first argument + * @param {function} [errorCallback] function to be executed if + * there is an error, response is passed + * in as first argument + * @return {Promise} A promise that resolves with the data when the operation + * completes successfully or rejects with the error after + * one occurs. + * + * @example + *
    + * + * // Examples use jsonplaceholder.typicode.com for a Mock Data API + * + * let url = 'https://jsonplaceholder.typicode.com/posts'; + * let postData = { userId: 1, title: 'p5 Clicked!', body: 'p5.js is way cool.' }; + * + * function setup() { + * createCanvas(800, 800); + * } + * + * function mousePressed() { + * // Pick new random color values + * let r = random(255); + * let g = random(255); + * let b = random(255); + * + * httpPost(url, 'json', postData, function(result) { + * strokeWeight(2); + * stroke(r, g, b); + * fill(r, g, b, 127); + * ellipse(mouseX, mouseY, 200, 200); + * text(result.body, mouseX, mouseY); + * }); + * } + * + *
    + * + * + *
    + * let url = 'https://invalidURL'; // A bad URL that will cause errors + * let postData = { title: 'p5 Clicked!', body: 'p5.js is way cool.' }; + * + * function setup() { + * createCanvas(800, 800); + * } + * + * function mousePressed() { + * // Pick new random color values + * let r = random(255); + * let g = random(255); + * let b = random(255); + * + * httpPost( + * url, + * 'json', + * postData, + * function(result) { + * // ... won't be called + * }, + * function(error) { + * strokeWeight(2); + * stroke(r, g, b); + * fill(r, g, b, 127); + * text(error.toString(), mouseX, mouseY); + * } + * ); + * } + *
    + * + */ +/** + * @method httpPost + * @param {String} path + * @param {Object|Boolean} data + * @param {function} [callback] + * @param {function} [errorCallback] + * @return {Promise} + */ +/** + * @method httpPost + * @param {String} path + * @param {function} callback + * @param {function} [errorCallback] + * @return {Promise} + */ +p5.prototype.httpPost = function() { + p5._validateParameters('httpPost', arguments); + + var args = Array.prototype.slice.call(arguments); + args.splice(1, 0, 'POST'); + return 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. + * This method is suitable for fetching files up to size of 64MB when "GET" is used. + * + * @method httpDo + * @param {String} path name of the file or url to load + * @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 + * @return {Promise} A promise that resolves with the data when the operation + * completes successfully or rejects with the error after + * one occurs. + * + * @example + *
    + * + * // Examples use USGS Earthquake API: + * // https://earthquake.usgs.gov/fdsnws/event/1/#methods + * + * // displays an animation of all USGS earthquakes + * let earthquakes; + * let eqFeatureIndex = 0; + * + * function preload() { + * let url = 'https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson'; + * httpDo( + * url, + * { + * method: 'GET', + * // Other Request options, like special headers for apis + * headers: { authorization: 'Bearer secretKey' } + * }, + * function(res) { + * earthquakes = res; + * } + * ); + * } + * + * function draw() { + * // wait until the data is loaded + * if (!earthquakes || !earthquakes.features[eqFeatureIndex]) { + * return; + * } + * clear(); + * + * let feature = earthquakes.features[eqFeatureIndex]; + * let mag = feature.properties.mag; + * let rad = mag / 11 * ((width + height) / 2); + * fill(255, 0, 0, 100); + * ellipse(width / 2 + random(-2, 2), height / 2 + random(-2, 2), rad, rad); + * + * if (eqFeatureIndex >= earthquakes.features.length) { + * eqFeatureIndex = 0; + * } else { + * eqFeatureIndex += 1; + * } + * } + * + *
    + */ +/** + * @method httpDo + * @param {String} path + * @param {Object} options Request object options as documented in the + * "fetch" API + * reference + * @param {function} [callback] + * @param {function} [errorCallback] + * @return {Promise} + */ +p5.prototype.httpDo = function() { + var type; + var callback; + var errorCallback; + var request; + var promise; + var jsonpOptions = {}; + var cbCount = 0; + var contentType = 'text/plain'; + // Trim the callbacks off the end to get an idea of how many arguments are passed + for (var i = arguments.length - 1; i > 0; i--) { + if (typeof arguments[i] === 'function') { + cbCount++; + } else { + break; + } + } + // The number of arguments minus callbacks + var argsCount = arguments.length - cbCount; + var path = arguments[0]; + if ( + argsCount === 2 && + typeof path === 'string' && + typeof arguments[1] === 'object' + ) { + // Intended for more advanced use, pass in Request parameters directly + request = new Request(path, arguments[1]); + callback = arguments[2]; + errorCallback = arguments[3]; + } else { + // Provided with arguments + 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 === 'binary' || + a === 'arrayBuffer' || + a === 'xml' || + a === 'text' || + a === 'table' + ) { + type = a; + } else { + data = a; + } + } else if (typeof a === 'number') { + data = a.toString(); + } else if (typeof a === 'object') { + if (a.hasOwnProperty('jsonpCallback')) { + for (var attr in a) { + jsonpOptions[attr] = a[attr]; + } + } else if (a instanceof p5.XML) { + data = a.serialize(); + contentType = 'application/xml'; + } else { + data = JSON.stringify(a); + contentType = 'application/json'; + } + } else if (typeof a === 'function') { + if (!callback) { + callback = a; + } else { + errorCallback = a; + } + } + } + + request = new Request(path, { + method: method, + mode: 'cors', + body: data, + headers: new Headers({ + 'Content-Type': contentType + }) + }); + } + // do some sort of smart type checking + if (!type) { + if (path.indexOf('json') !== -1) { + type = 'json'; + } else if (path.indexOf('xml') !== -1) { + type = 'xml'; + } else { + type = 'text'; + } + } + + if (type === 'jsonp') { + promise = fetchJsonp(path, jsonpOptions); + } else { + promise = fetch(request); + } + promise = promise.then(function(res) { + if (!res.ok) { + var err = new Error(res.body); + err.status = res.status; + err.ok = false; + throw err; + } else { + var fileSize = 0; + if (type !== 'jsonp') { + fileSize = res.headers.get('content-length'); + } + if (fileSize && fileSize > 64000000) { + p5._friendlyFileLoadError(7, path); + } + switch (type) { + case 'json': + case 'jsonp': + return res.json(); + case 'binary': + return res.blob(); + case 'arrayBuffer': + return res.arrayBuffer(); + case 'xml': + return res.text().then(function(text) { + var parser = new DOMParser(); + var xml = parser.parseFromString(text, 'text/xml'); + return new p5.XML(xml.documentElement); + }); + default: + return res.text(); + } + } + }); + promise.then(callback || function() {}); + promise.catch(errorCallback || console.error); + return promise; +}; + +/** + * @module IO + * @submodule Output + * @for p5 + */ + +window.URL = window.URL || window.webkitURL; + +// private array of p5.PrintWriter objects +p5.prototype._pWriters = []; + +/** + * @method createWriter + * @param {String} name name of the file to be created + * @param {String} [extension] + * @return {p5.PrintWriter} + * @example + *
    + * + * function setup() { + * createCanvas(100, 100); + * background(200); + * text('click here to save', 10, 10, 70, 80); + * } + * + * function mousePressed() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * var writer = createWriter('squares.txt'); + * for (let i = 0; i < 10; i++) { + * writer.print(i * i); + * } + * writer.close(); + * writer.clear(); + * } + * } + * + *
    + */ +p5.prototype.createWriter = function(name, extension) { + var newPW; + // check that it doesn't already exist + for (var i in p5.prototype._pWriters) { + 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 + this.millis(), extension); + p5.prototype._pWriters.push(newPW); + return newPW; + } + } + newPW = new p5.PrintWriter(name, extension); + p5.prototype._pWriters.push(newPW); + return newPW; +}; + +/** + * @class p5.PrintWriter + * @param {String} filename + * @param {String} [extension] + */ +p5.PrintWriter = function(filename, extension) { + var self = this; + this.name = filename; + this.content = ''; + //Changed to write because it was being overloaded by function below. + /** + * Writes data to the PrintWriter stream + * @method write + * @param {Array} data all data to be written by the PrintWriter + * @example + *
    + * + * // creates a file called 'newFile.txt' + * let writer = createWriter('newFile.txt'); + * // write 'Hello world!'' to the file + * writer.write(['Hello world!']); + * // close the PrintWriter and save the file + * writer.close(); + * + *
    + *
    + * + * // creates a file called 'newFile2.txt' + * let writer = createWriter('newFile2.txt'); + * // write 'apples,bananas,123' to the file + * writer.write(['apples', 'bananas', 123]); + * // close the PrintWriter and save the file + * writer.close(); + * + *
    + *
    + * + * // creates a file called 'newFile3.txt' + * let writer = createWriter('newFile3.txt'); + * // write 'My name is: Teddy' to the file + * writer.write('My name is:'); + * writer.write(' Teddy'); + * // close the PrintWriter and save the file + * writer.close(); + * + *
    + */ + this.write = function(data) { + this.content += data; + }; + /** + * Writes data to the PrintWriter stream, and adds a new line at the end + * @method print + * @param {Array} data all data to be printed by the PrintWriter + * @example + *
    + * + * // creates a file called 'newFile.txt' + * let writer = createWriter('newFile.txt'); + * // creates a file containing + * // My name is: + * // Teddy + * writer.print('My name is:'); + * writer.print('Teddy'); + * // close the PrintWriter and save the file + * writer.close(); + * + *
    + *
    + * + * let writer; + * + * function setup() { + * createCanvas(400, 400); + * // create a PrintWriter + * writer = createWriter('newFile.txt'); + * } + * + * function draw() { + * // print all mouseX and mouseY coordinates to the stream + * writer.print([mouseX, mouseY]); + * } + * + * function mouseClicked() { + * // close the PrintWriter and save the file + * writer.close(); + * } + * + *
    + */ + this.print = function(data) { + this.content += data + '\n'; + }; + /** + * Clears the data already written to the PrintWriter object + * @method clear + * @example + *
    + * // create writer object + * let writer = createWriter('newFile.txt'); + * writer.write(['clear me']); + * // clear writer object here + * writer.clear(); + * // close writer + * writer.close(); + *
    + * + */ + this.clear = function() { + this.content = ''; + }; + /** + * Closes the PrintWriter + * @method close + * @example + *
    + * + * // create a file called 'newFile.txt' + * let writer = createWriter('newFile.txt'); + * // close the PrintWriter and save the file + * writer.close(); + * + *
    + *
    + * + * // create a file called 'newFile2.txt' + * let writer = createWriter('newFile2.txt'); + * // write some data to the file + * writer.write([100, 101, 102]); + * // close the PrintWriter and save the file + * writer.close(); + * + *
    + */ + this.close = function() { + // convert String to Array for the writeFile Blob + var arr = []; + arr.push(this.content); + 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.clear(); + self = {}; + }; +}; + +/** + * @module IO + * @submodule Output + * @for p5 + */ + +// object, filename, options --> saveJSON, saveStrings, +// filename, [extension] [canvas] --> saveImage + +/** + *

    Save an image, text, json, csv, wav, or html. Prompts download to + * the client's computer. Note that it is not recommended to call save() + * within draw if it's looping, as the save() function will open a new save + * 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 parameters. For example:

    + * + * 
    
+ * // Saves canvas as an image
+ * save('myCanvas.jpg');
+ *
+ * // Saves pImage as a png image
+ * let img = createImage(10, 10);
+ * save(img, 'my.png');
+ *
+ * // Saves canvas as an image
+ * let cnv = createCanvas(100, 100);
+ * save(cnv, 'myCanvas.jpg');
+ *
+ * // Saves p5.Renderer object as an image
+ * let gb = createGraphics(100, 100);
+ * save(gb, 'myGraphics.jpg');
+ *
+ * let myTable = new p5.Table();
+ *
+ * // Saves table as html file
+ * save(myTable, 'myTable.html');
+ *
+ * // Comma Separated Values
+ * save(myTable, 'myTable.csv');
+ *
+ * // Tab Separated Values
+ * save(myTable, 'myTable.tsv');
+ *
+ * let myJSON = { a: 1, b: true };
+ *
+ * // Saves pretty JSON
+ * save(myJSON, 'my.json');
+ *
+ * // Optimizes JSON filesize
+ * save(myJSON, 'my.json', true);
+ *
+ * // Saves array of strings to a text file with line breaks after each item
+ * let arrayOfStrings = ['a', 'b'];
+ * save(arrayOfStrings, 'my.txt');
+ *
    + * + * @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 ? this._curElement.elt : this.elt; + if (args.length === 0) { + p5.prototype.saveCanvas(cnv); + return; + } else if (args[0] instanceof p5.Renderer || args[0] instanceof p5.Graphics) { + // otherwise, parse the arguments + + // if first param is a p5Graphics, then saveCanvas + p5.prototype.saveCanvas(args[0].elt, args[1], args[2]); + return; + } else if (args.length === 1 && typeof args[0] === 'string') { + // if 1st param is String and only one arg, assume it is canvas filename + p5.prototype.saveCanvas(cnv, args[0]); + } else { + // ================================================= + // OPTION 2: extension clarifies saveStrings vs. saveJSON + 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]); + } 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 + *
    + * let json = {}; // new JSON Object + * + * json.id = 0; + * json.species = 'Panthera leo'; + * json.name = 'Lion'; + * + * function setup() { + * createCanvas(100, 100); + * background(200); + * text('click here to save', 10, 10, 70, 80); + * } + * + * function mousePressed() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * 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) { + p5._validateParameters('saveJSON', arguments); + var stringify; + if (opt) { + stringify = JSON.stringify(json); + } else { + stringify = JSON.stringify(json, undefined, 2); + } + this.saveStrings(stringify.split('\n'), filename, 'json'); +}; + +p5.prototype.saveJSONObject = p5.prototype.saveJSON; +p5.prototype.saveJSONArray = p5.prototype.saveJSON; + +/** + * Writes an array of Strings to a text file, one line per String. + * The file saving process and location of the saved file will + * vary between web browsers. + * + * @method saveStrings + * @param {String[]} list string array to be written + * @param {String} filename filename for output + * @param {String} [extension] the filename's extension + * @example + *
    + * let words = 'apple bear cat dog'; + * + * // .split() outputs an Array + * let list = split(words, ' '); + * + * function setup() { + * createCanvas(100, 100); + * background(200); + * text('click here to save', 10, 10, 70, 80); + * } + * + * function mousePressed() { + * if (mouseX > 0 && mouseX < width && mouseY > 0 && mouseY < height) { + * 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) { + p5._validateParameters('saveStrings', arguments); + 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.clear(); +}; + +// ======= +// 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 + *
    + * let table; + * + * function setup() { + * table = new p5.Table(); + * + * table.addColumn('id'); + * table.addColumn('species'); + * table.addColumn('name'); + * + * let 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) { + p5._validateParameters('saveTable', arguments); + var ext; + if (options === undefined) { + ext = filename.substring(filename.lastIndexOf('.') + 1, filename.length); + } else { + ext = options; + } + var pWriter = this.createWriter(filename, ext); + + var header = table.columns; + + var sep = ','; // default to CSV + if (ext === 'tsv') { + sep = '\t'; + } + if (ext !== '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.write(header[h] + sep); + } else { + pWriter.write(header[h]); + } + } + pWriter.write('\n'); + } + + // 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.write(table.rows[i].arr[j] + sep); + } else if (i < table.rows.length - 1) { + pWriter.write(table.rows[i].arr[j]); + } else { + pWriter.write(table.rows[i].arr[j]); + } + } + pWriter.write('\n'); + } + } else { + // otherwise, make HTML + 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 clear the pWriter + pWriter.close(); + pWriter.clear(); +}; // end saveTable() + +/** + * Generate a blob of file data as a url to prepare for download. + * Accepts an array of data, a filename, and an extension (optional). + * This is a private function because it does not do any formatting, + * but it is used by saveStrings, saveJSON, saveTable etc. + * + * @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 + }); + p5.prototype.downloadFile(blob, filename, extension); +}; + +/** + * Forces download. Accepts a url to filedata/blob, a filename, + * and an extension (optional). + * This is a private function because it does not do any formatting, + * but it is used by saveStrings, saveJSON, saveTable etc. + * + * @method downloadFile + * @private + * @param {String|Blob} data either an href generated by createObjectURL, + * or a Blob object containing the data + * @param {String} [filename] + * @param {String} [extension] + */ +p5.prototype.downloadFile = function(data, fName, extension) { + var fx = _checkFileExtension(fName, extension); + var filename = fx[0]; + + if (data instanceof Blob) { + var fileSaver = _dereq_('file-saver'); + fileSaver.saveAs(data, filename); + return; + } + + var a = document.createElement('a'); + a.href = data; + 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: ."' + fx[1] + '"'; + alert(aText); + } + a.click(); +}; + +/** + * Returns a file extension, or another string + * if the provided parameter has no extension. + * + * @param {String} filename + * @param {String} [extension] + * @return {String[]} [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/error_helpers":20,"../core/main":24,"es6-promise":5,"fetch-jsonp":6,"file-saver":7,"whatwg-fetch":12}],48:[function(_dereq_,module,exports){ +/** + * @module IO + * @submodule Table + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * 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 {p5.TableRow[]} [rows] An array of p5.TableRow objects + */ +p5.Table = function(rows) { + /** + * @property columns {String[]} + */ + this.columns = []; + + /** + * @property rows {p5.TableRow[]} + */ + 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 + * @return {p5.TableRow} the row that was added + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 + * let newRow = table.addRow(); + * newRow.setString('id', table.getRowCount() - 1); + * newRow.setString('species', 'Canis Lupus'); + * newRow.setString('name', 'Wolf'); + * + * //print the results + * for (let r = 0; r < table.getRowCount(); r++) + * for (let 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 new Error('invalid TableRow: ' + r); + } + r.table = this; + this.rows.push(r); + return r; +}; + +/** + * Removes a row from the table object. + * + * @method removeRow + * @param {Integer} id ID number of the row to remove + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let table; + * + * function preload() { + * //my table is comma separated value "csv" + * //and has a header specifying the columns labels + * table = loadTable('assets/mammals.csv', 'csv', 'header'); + * } + * + * function setup() { + * //remove the first row + * table.removeRow(0); + * + * //print the results + * for (let r = 0; r < table.getRowCount(); r++) + * for (let 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 {Integer} rowID ID number of the row to get + * @return {p5.TableRow} p5.TableRow object + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let row = table.getRow(1); + * //print it column by column + * //note: a row is an object, not an array + * for (let 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 {p5.TableRow[]} Array of p5.TableRows + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let rows = table.getRows(); + * + * //warning: rows is an array of objects + * for (let r = 0; r < rows.length; r++) { + * rows[r].set('name', 'Unicorn'); + * } + * + * //print the results + * for (let r = 0; r < table.getRowCount(); r++) + * for (let 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 {Integer|String} column ID number or title of the + * column to search + * @return {p5.TableRow} + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 + * let 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]; + } + } + } else { + // try the Array + 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 {Integer|String} column ID number or title of the + * column to search + * @return {p5.TableRow[]} An Array of TableRow objects + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 + * let 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 + * let 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]); + } + } + } else { + // try the Array + for (var j = 0; j < this.rows.length; j++) { + if (this.rows[j].arr[column] === value) { + ret.push(this.rows[j]); + } + } + } + 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} regexp The regular expression to match + * @param {String|Integer} column The column ID (number) or + * title (string) + * @return {p5.TableRow} TableRow object + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let table; + * + * function preload() { + * //my table is comma separated value "csv" + * //and has a header specifying the columns labels + * table = loadTable('assets/mammals.csv', 'csv', 'header'); + * } + * + * function setup() { + * //Search using specified regex on a given column, return TableRow object + * let mammal = table.matchRow(new RegExp('ant'), 1); + * print(mammal.getString(1)); + * //Output "Panthera pardus" + * } + * + *
    + * + */ +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|Integer} [column] The column ID (number) or + * title (string) + * @return {p5.TableRow[]} An Array of TableRow objects + * @example + *
    + * + * let table; + * + * function setup() { + * table = new p5.Table(); + * + * table.addColumn('name'); + * table.addColumn('type'); + * + * let 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'); + * + * let rows = table.matchRows('R.*', 'type'); + * for (let 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 + * + * let 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 + * + * let 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 + * + * let 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 (let r = 0; r < table.getRowCount(); r++) + * for (let 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. + * + * @method getColumnCount + * @return {Integer} Number of columns in this table + * @example + *
    + * + * // given the cvs file "blobs.csv" in /assets directory + * // ID, Name, Flavor, Shape, Color + * // Blob1, Blobby, Sweet, Blob, Pink + * // Blob2, Saddy, Savory, Blob, Blue + * + * let table; + * + * function preload() { + * table = loadTable('assets/blobs.csv'); + * } + * + * function setup() { + * createCanvas(200, 100); + * textAlign(CENTER); + * background(255); + * } + * + * function draw() { + * let numOfColumn = table.getColumnCount(); + * text('There are ' + numOfColumn + ' columns in the table.', 100, 50); + * } + * + *
    + */ +p5.Table.prototype.getColumnCount = function() { + return this.columns.length; +}; + +/** + * Returns the total number of rows in a Table. + * + * @method getRowCount + * @return {Integer} Number of rows in this table + * @example + *
    + * + * // given the cvs file "blobs.csv" in /assets directory + * // + * // ID, Name, Flavor, Shape, Color + * // Blob1, Blobby, Sweet, Blob, Pink + * // Blob2, Saddy, Savory, Blob, Blue + * + * let table; + * + * function preload() { + * table = loadTable('assets/blobs.csv'); + * } + * + * function setup() { + * createCanvas(200, 100); + * textAlign(CENTER); + * background(255); + * } + * + * function draw() { + * text('There are ' + table.getRowCount() + ' rows in the table.', 100, 50); + * } + * + *
    + */ +p5.Table.prototype.getRowCount = function() { + return this.rows.length; +}; + +/** + *

    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|Integer} [column] Column ID (number) + * or name (string) + * + * @example + *
    + * function setup() { + * let table = new p5.Table(); + * + * table.addColumn('name'); + * table.addColumn('type'); + * + * let newRow = table.addRow(); + * newRow.setString('name', ' $Lion ,'); + * newRow.setString('type', ',,,Mammal'); + * + * newRow = table.addRow(); + * newRow.setString('name', '$Snake '); + * newRow.setString('type', ',,,Reptile'); + * + * table.removeTokens(',$ '); + * print(table.getArray()); + * } + * + * // prints: + * // 0 "Lion" "Mamal" + * // 1 "Snake" "Reptile" + *
    + */ +p5.Table.prototype.removeTokens = function(chars, column) { + var escape = function(s) { + return s.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&'); + }; + var 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|Integer} [column] Column ID (number) + * or name (string) + * @example + *
    + * function setup() { + * let table = new p5.Table(); + * + * table.addColumn('name'); + * table.addColumn('type'); + * + * let newRow = table.addRow(); + * newRow.setString('name', ' Lion ,'); + * newRow.setString('type', ' Mammal '); + * + * newRow = table.addRow(); + * newRow.setString('name', ' Snake '); + * newRow.setString('type', ' Reptile '); + * + * table.trim(); + * print(table.getArray()); + * } + * + * // prints: + * // 0 "Lion" "Mamal" + * // 1 "Snake" "Reptile" + *
    + */ +p5.Table.prototype.trim = function(column) { + var regex = new RegExp(' ', 'g'); + + 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|Integer} column columnName (string) or ID (number) + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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); + } 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 {Integer} row row ID + * @param {String|Integer} column column ID (Number) + * or title (String) + * @param {String|Number} value value to assign + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 (let r = 0; r < table.getRowCount(); r++) + * for (let 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 {Integer} row row ID + * @param {String|Integer} column column ID (Number) + * or title (String) + * @param {Number} value value to assign + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 {Integer} row row ID + * @param {String|Integer} column column ID (Number) + * or title (String) + * @param {String} value value to assign + * @example + *
    + * // Given the CSV file "mammals.csv" in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 + * let newRow = table.addRow(); + * newRow.setString('id', table.getRowCount() - 1); + * newRow.setString('species', 'Canis Lupus'); + * newRow.setString('name', 'Wolf'); + * + * print(table.getArray()); + * } + *
    + * + * @alt + * no image displayed + */ +p5.Table.prototype.setString = function(row, column, value) { + 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 {Integer} row row ID + * @param {String|Integer} column columnName (string) or + * ID (number) + * @return {String|Number} + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 {Integer} row row ID + * @param {String|Integer} column columnName (string) or + * ID (number) + * @return {Number} + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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 {Integer} row row ID + * @param {String|Integer} column columnName (string) or + * ID (number) + * @return {String} + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let table; + * + * function preload() { + * // table is comma separated value "CSV" + * // and has specifiying header for column labels + * table = loadTable('assets/mammals.csv', 'csv', 'header'); + * } + * + * function setup() { + * print(table.getString(0, 0)); // 0 + * print(table.getString(0, 1)); // Capra hircus + * print(table.getString(0, 2)); // Goat + * print(table.getString(1, 0)); // 1 + * print(table.getString(1, 1)); // Panthera pardus + * print(table.getString(1, 2)); // Leopard + * print(table.getString(2, 0)); // 2 + * print(table.getString(2, 1)); // Equus zebra + * print(table.getString(2, 2)); // Zebra + * } + * + *
    + * + *@alt + * no image displayed + * + */ + +p5.Table.prototype.getString = function(row, column) { + return this.rows[row].getString(column); +}; + +/** + * 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 + * + * let 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() { + * let 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 new Error( + '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} + * + * @example + *
    + * + * // Given the CSV file "mammals.csv" + * // in the project's "assets" folder + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leoperd + * // 2,Equus zebra,Zebra + * + * let table; + * + * function preload() { + * // table is comma separated value "CSV" + * // and has specifiying header for column labels + * table = loadTable('assets/mammals.csv', 'csv', 'header'); + * } + * + * function setup() { + * let tableArray = table.getArray(); + * for (let i = 0; i < tableArray.length; i++) { + * print(tableArray[i]); + * } + * } + * + *
    + * + *@alt + * no image displayed + * + */ +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; + +},{"../core/main":24}],49:[function(_dereq_,module,exports){ +/** + * @module IO + * @submodule Table + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * 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|Integer} column Column ID (Number) + * or Title (String) + * @param {String|Number} value The value to be stored + * + * @example + *
    + * // Given the CSV file "mammals.csv" in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let rows = table.getRows(); + * for (let r = 0; r < rows.length; r++) { + * rows[r].set('name', 'Unicorn'); + * } + * + * //print the results + * print(table.getArray()); + * } + *
    + * + * @alt + * no image displayed + */ +p5.TableRow.prototype.set = function(column, value) { + // if typeof column is string, use .obj + if (typeof column === 'string') { + var cPos = this.table.columns.indexOf(column); // index of columnID + if (cPos >= 0) { + this.obj[column] = value; + this.arr[cPos] = value; + } else { + throw new Error('This table has no column named "' + column + '"'); + } + } else { + // if typeof column is number, use .arr + if (column < this.table.columns.length) { + this.arr[column] = value; + var cTitle = this.table.columns[column]; + this.obj[cTitle] = value; + } else { + throw new Error( + 'Column #' + column + ' is out of the range of this table' + ); + } + } +}; + +/** + * Stores a Float value in the TableRow's specified column. + * The column may be specified by either its ID or title. + * + * @method setNum + * @param {String|Integer} column Column ID (Number) + * or Title (String) + * @param {Number|String} value The value to be stored + * as a Float + * @example + *
    + * // Given the CSV file "mammals.csv" in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let rows = table.getRows(); + * for (let r = 0; r < rows.length; r++) { + * rows[r].setNum('id', r + 10); + * } + * + * print(table.getArray()); + * } + *
    + * + * @alt + * no image displayed + */ +p5.TableRow.prototype.setNum = function(column, value) { + var floatVal = parseFloat(value); + this.set(column, floatVal); +}; + +/** + * Stores a String value in the TableRow's specified column. + * The column may be specified by either its ID or title. + * + * @method setString + * @param {String|Integer} column Column ID (Number) + * or Title (String) + * @param {String|Number|Boolean|Object} value The value to be stored + * as a String + * @example + *
    + * // Given the CSV file "mammals.csv" in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let rows = table.getRows(); + * for (let r = 0; r < rows.length; r++) { + * let name = rows[r].getString('name'); + * rows[r].setString('name', 'A ' + name + ' named George'); + * } + * + * print(table.getArray()); + * } + *
    + * + * @alt + * no image displayed + */ +p5.TableRow.prototype.setString = function(column, value) { + 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|Integer} column columnName (string) or + * ID (number) + * @return {String|Number} + * + * @example + *
    + * // Given the CSV file "mammals.csv" in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let names = []; + * let rows = table.getRows(); + * for (let r = 0; r < rows.length; r++) { + * names.push(rows[r].get('name')); + * } + * + * print(names); + * } + *
    + * + * @alt + * no image displayed + */ +p5.TableRow.prototype.get = function(column) { + if (typeof column === 'string') { + 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|Integer} column columnName (string) or + * ID (number) + * @return {Number} Float Floating point number + * @example + *
    + * // Given the CSV file "mammals.csv" in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let rows = table.getRows(); + * let minId = Infinity; + * let maxId = -Infinity; + * for (let r = 0; r < rows.length; r++) { + * let id = rows[r].getNum('id'); + * minId = min(minId, id); + * maxId = min(maxId, id); + * } + * print('minimum id = ' + minId + ', maximum id = ' + maxId); + * } + *
    + * + * @alt + * no image displayed + */ +p5.TableRow.prototype.getNum = function(column) { + var ret; + if (typeof column === 'string') { + ret = parseFloat(this.obj[column]); + } else { + ret = parseFloat(this.arr[column]); + } + + if (ret.toString() === 'NaN') { + throw 'Error: ' + this.obj[column] + ' is NaN (Not a Number)'; + } + 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|Integer} column columnName (string) or + * ID (number) + * @return {String} String + * @example + *
    + * // Given the CSV file "mammals.csv" in the project's "assets" folder: + * // + * // id,species,name + * // 0,Capra hircus,Goat + * // 1,Panthera pardus,Leopard + * // 2,Equus zebra,Zebra + * + * let 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() { + * let rows = table.getRows(); + * let longest = ''; + * for (let r = 0; r < rows.length; r++) { + * let species = rows[r].getString('species'); + * if (longest.length < species.length) { + * longest = species; + * } + * } + * + * print('longest: ' + longest); + * } + *
    + * + * @alt + * no image displayed + */ +p5.TableRow.prototype.getString = function(column) { + if (typeof column === 'string') { + return this.obj[column].toString(); + } else { + return this.arr[column].toString(); + } +}; + +module.exports = p5; + +},{"../core/main":24}],50:[function(_dereq_,module,exports){ +/** + * @module IO + * @submodule XML + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * XML is a representation of an XML object, able to parse XML code. Use + * loadXML() to load external XML files and create XML objects. + * + * @class p5.XML + * @constructor + * @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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let children = xml.getChildren('animal'); + * + * for (let i = 0; i < children.length; i++) { + * let id = children[i].getNum('id'); + * let coloring = children[i].getString('species'); + * let 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(DOM) { + if (!DOM) { + var xmlDoc = document.implementation.createDocument(null, 'doc'); + this.DOM = xmlDoc.createElement('root'); + } else { + this.DOM = DOM; + } +}; + +/** + * Gets a copy of the element's parent. Returns the parent as another + * p5.XML object. + * + * @method getParent + * @return {p5.XML} 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let children = xml.getChildren('animal'); + * let parent = children[1].getParent(); + * print(parent.getName()); + * } + * + * // Sketch prints: + * // mammals + *
    + */ +p5.XML.prototype.getParent = function() { + return new p5.XML(this.DOM.parentElement); +}; + +/** + * 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * print(xml.getName()); + * } + * + * // Sketch prints: + * // mammals + *
    + */ +p5.XML.prototype.getName = function() { + return this.DOM.tagName; +}; + +/** + * 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> + * + * let 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) { + var content = this.DOM.innerHTML; + var attributes = this.DOM.attributes; + var xmlDoc = document.implementation.createDocument(null, 'default'); + var newDOM = xmlDoc.createElement(name); + newDOM.innerHTML = content; + for (var i = 0; i < attributes.length; i++) { + newDOM.setAttribute(attributes[i].nodeName, attributes.nodeValue); + } + this.DOM = newDOM; +}; + +/** + * 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * print(xml.hasChildren()); + * } + * + * // Sketch prints: + * // true + *
    + */ +p5.XML.prototype.hasChildren = function() { + return this.DOM.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 {String[]} 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * print(xml.listChildren()); + * } + * + * // Sketch prints: + * // ["animal", "animal", "animal"] + *
    + */ +p5.XML.prototype.listChildren = function() { + var arr = []; + for (var i = 0; i < this.DOM.childNodes.length; i++) { + arr.push(this.DOM.childNodes[i].nodeName); + } + return arr; +}; + +/** + * 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 {p5.XML[]} 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let animals = xml.getChildren('animal'); + * + * for (let i = 0; i < animals.length; i++) { + * print(animals[i].getContent()); + * } + * } + * + * // Sketch prints: + * // "Goat" + * // "Leopard" + * // "Zebra" + *
    + */ +p5.XML.prototype.getChildren = function(param) { + if (param) { + return elementsToP5XML(this.DOM.getElementsByTagName(param)); + } else { + return elementsToP5XML(this.DOM.children); + } +}; + +function elementsToP5XML(elements) { + var arr = []; + for (var i = 0; i < elements.length; i++) { + arr.push(new p5.XML(elements[i])); + } + return arr; +} + +/** + * 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|Integer} 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let firstChild = xml.getChild('animal'); + * print(firstChild.getContent()); + * } + * + * // Sketch prints: + * // "Goat" + *
    + *
    + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let secondChild = xml.getChild(1); + * print(secondChild.getContent()); + * } + * + * // Sketch prints: + * // "Leopard" + *
    + */ +p5.XML.prototype.getChild = function(param) { + if (typeof param === 'string') { + for (var i = 0; i < this.DOM.children.length; i++) { + var child = this.DOM.children[i]; + if (child.tagName === param) return new p5.XML(child); + } + } else { + return new p5.XML(this.DOM.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 {p5.XML} node a p5.XML Object which will be the child to be added + * @example + *
    + * // The following short XML file called "mammals.xml" is parsed + * // in the code below. + * // + * // + * // <mammals> + * // <animal id="0" species="Capra hircus">Goat</animal> + * // <animal id="1" species="Panthera pardus">Leopard</animal> + * // <animal id="2" species="Equus zebra">Zebra</animal> + * // </mammals> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let child = new p5.XML(); + * child.setName('animal'); + * child.setAttribute('id', '3'); + * child.setAttribute('species', 'Ornithorhynchus anatinus'); + * child.setContent('Platypus'); + * xml.addChild(child); + * + * let animals = xml.getChildren('animal'); + * print(animals[animals.length - 1].getContent()); + * } + * + * // Sketch prints: + * // "Goat" + * // "Leopard" + * // "Zebra" + *
    + */ +p5.XML.prototype.addChild = function(node) { + if (node instanceof p5.XML) { + this.DOM.appendChild(node.DOM); + } else { + // PEND + } +}; + +/** + * Removes the element specified by name or index. + * + * @method removeChild + * @param {String|Integer} 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * xml.removeChild('animal'); + * let children = xml.getChildren(); + * for (let i = 0; i < children.length; i++) { + * print(children[i].getContent()); + * } + * } + * + * // Sketch prints: + * // "Leopard" + * // "Zebra" + *
    + *
    + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * xml.removeChild(1); + * let children = xml.getChildren(); + * for (let i = 0; i < children.length; i++) { + * print(children[i].getContent()); + * } + * } + * + * // Sketch prints: + * // "Goat" + * // "Zebra" + *
    + */ +p5.XML.prototype.removeChild = function(param) { + var ind = -1; + if (typeof param === 'string') { + for (var i = 0; i < this.DOM.children.length; i++) { + if (this.DOM.children[i].tagName === param) { + ind = i; + break; + } + } + } else { + ind = param; + } + if (ind !== -1) { + this.DOM.removeChild(this.DOM.children[ind]); + } +}; + +/** + * Counts the specified element's number of attributes, returned as an Number. + * + * @method getAttributeCount + * @return {Integer} + * @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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let firstChild = xml.getChild('animal'); + * print(firstChild.getAttributeCount()); + * } + * + * // Sketch prints: + * // 2 + *
    + */ +p5.XML.prototype.getAttributeCount = function() { + return this.DOM.attributes.length; +}; + +/** + * Gets all of the specified element's attributes, and returns them as an + * array of Strings. + * + * @method listAttributes + * @return {String[]} 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let firstChild = xml.getChild('animal'); + * print(firstChild.listAttributes()); + * } + * + * // Sketch prints: + * // ["id", "species"] + *
    + */ +p5.XML.prototype.listAttributes = function() { + var arr = []; + for (var i = 0; i < this.DOM.attributes.length; i++) { + var attribute = this.DOM.attributes[i]; + arr.push(attribute.nodeName); + } + return arr; +}; + +/** + * 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let firstChild = xml.getChild('animal'); + * print(firstChild.hasAttribute('species')); + * print(firstChild.hasAttribute('color')); + * } + * + * // Sketch prints: + * // true + * // false + *
    + */ +p5.XML.prototype.hasAttribute = function(name) { + var obj = {}; + for (var i = 0; i < this.DOM.attributes.length; i++) { + var attribute = this.DOM.attributes[i]; + obj[attribute.nodeName] = attribute.nodeValue; + } + return obj[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 getNum + * @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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let firstChild = xml.getChild('animal'); + * print(firstChild.getNum('id')); + * } + * + * // Sketch prints: + * // 0 + *
    + */ +p5.XML.prototype.getNum = function(name, defaultValue) { + var obj = {}; + for (var i = 0; i < this.DOM.attributes.length; i++) { + var attribute = this.DOM.attributes[i]; + obj[attribute.nodeName] = attribute.nodeValue; + } + return Number(obj[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 {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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let firstChild = xml.getChild('animal'); + * print(firstChild.getString('species')); + * } + * + * // Sketch prints: + * // "Capra hircus" + *
    + */ +p5.XML.prototype.getString = function(name, defaultValue) { + var obj = {}; + for (var i = 0; i < this.DOM.attributes.length; i++) { + var attribute = this.DOM.attributes[i]; + obj[attribute.nodeName] = attribute.nodeValue; + } + return obj[name] ? String(obj[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|String|Boolean} 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let 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) { + this.DOM.setAttribute(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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let firstChild = xml.getChild('animal'); + * print(firstChild.getContent()); + * } + * + * // Sketch prints: + * // "Goat" + *
    + */ +p5.XML.prototype.getContent = function(defaultValue) { + var str; + str = this.DOM.textContent; + str = str.replace(/\s\s+/g, ','); + return str || 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> + * + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * let 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.DOM.children.length) { + this.DOM.textContent = content; + } +}; + +/** + * Serializes the element into a string. This function is useful for preparing + * the content to be sent over a http request or saved to file. + * + * @method serialize + * @return {String} Serialized string of the element + * @example + *
    + * let xml; + * + * function preload() { + * xml = loadXML('assets/mammals.xml'); + * } + * + * function setup() { + * print(xml.serialize()); + * } + * + * // Sketch prints: + * // + * // Goat + * // Leopard + * // Zebra + * // + *
    + */ +p5.XML.prototype.serialize = function() { + var xmlSerializer = new XMLSerializer(); + return xmlSerializer.serializeToString(this.DOM); +}; + +module.exports = p5; + +},{"../core/main":24}],51:[function(_dereq_,module,exports){ +/** + * @module Math + * @submodule Calculation + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * 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() { + * let x = -3; + * let 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 {Integer} rounded up number + * @example + *
    + * function draw() { + * background(200); + * // map, mouseX between 0 and 5. + * let ax = map(mouseX, 0, 100, 0, 5); + * let ay = 66; + * + * //Get the ceiling of the mapped number. + * let bx = ceil(map(mouseX, 0, 100, 0, 5)); + * let 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), ax, ay - 5); + * text(nfc(bx, 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); + * + * let leftWall = 25; + * let rightWall = 75; + * + * // xm is just the mouseX, while + * // xc is the mouseX, but constrained + * // between the leftWall and rightWall! + * let xm = mouseX; + * let 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) { + p5._validateParameters('constrain', arguments); + 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} x2 x-coordinate of the second point + * @param {Number} y2 y-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); + * + * let x1 = 10; + * let y1 = 90; + * let x2 = mouseX; + * let 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. + * let 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), 0, -5); + * pop(); + * // Fancy! + * } + *
    + * + * @alt + * 2 ellipses joined by line. 1 ellipse moves with mouse X&Y. Distance displayed. + */ +/** + * @method dist + * @param {Number} x1 + * @param {Number} y1 + * @param {Number} z1 z-coordinate of the first point + * @param {Number} x2 + * @param {Number} y2 + * @param {Number} z2 z-coordinate of the second point + * @return {Number} distance between the two points + */ +p5.prototype.dist = function() { + p5._validateParameters('dist', arguments); + if (arguments.length === 4) { + //2D + return hypot(arguments[2] - arguments[0], arguments[3] - arguments[1]); + } else if (arguments.length === 6) { + //3D + return hypot( + arguments[3] - arguments[0], + arguments[4] - arguments[1], + arguments[5] - arguments[2] + ); + } +}; + +/** + * 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 + * let xValue = map(mouseX, 0, width, 0, 2); + * let yValue = exp(xValue); + * + * let y = map(yValue, 0, 8, height, 0); + * + * let 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 (let 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 {Integer} rounded down number + * @example + *
    + * function draw() { + * background(200); + * //map, mouseX between 0 and 5. + * let ax = map(mouseX, 0, 100, 0, 5); + * let ay = 66; + * + * //Get the floor of the mapped number. + * let bx = floor(map(mouseX, 0, 100, 0, 5)); + * let 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), ax, ay - 5); + * text(nfc(bx, 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, and 1.0 is equal to the second point. If the + * value of amt is more than 1.0 or less than 0.0, the number will be + * calculated accordingly in the ratio of the two given numbers. 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 + * @return {Number} lerped value + * @example + *
    + * function setup() { + * background(200); + * let a = 20; + * let b = 80; + * let c = lerp(a, b, 0.2); + * let d = lerp(a, b, 0.5); + * let e = lerp(a, b, 0.8); + * + * let 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) { + p5._validateParameters('lerp', arguments); + 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); + * let maxX = 2.8; + * let maxY = 1.5; + * + * // Compute the natural log of a value between 0 and maxX + * let xValue = map(mouseX, 0, width, 0, maxX); + * let yValue, y; + * if (xValue > 0) { + // Cannot take the log of a negative number. + * yValue = log(xValue); + * y = map(yValue, -maxY, maxY, height, 0); + * + * // Display the calculation occurring. + * let 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 (let 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() { + * let x1 = 20; + * let x2 = 80; + * let y1 = 30; + * let 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) { + p5._validateParameters('mag', arguments); + 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 + * @param {Boolean} [withinBounds] constrain the value to the newly mapped range + * @return {Number} remapped number + * @example + *
    + * let value = 25; + * let m = map(value, 0, 100, 0, width); + * ellipse(m, 50, 10, 10); +
    + * + *
    + * function setup() { + * noStroke(); + * } + * + * function draw() { + * background(204); + * let x1 = map(mouseX, 0, width, 25, 75); + * ellipse(x1, 25, 25, 25); + * //This ellipse is constrained to the 0-100 range + * //after setting withinBounds to true + * let x2 = map(mouseX, 0, width, 0, 100, true); + * ellipse(x2, 75, 25, 25); + * } +
    + * + * @alt + * 10 by 10 white ellipse with in mid left canvas + * 2 25 by 25 white ellipses move with mouse x. Bottom has more range from X + * + */ +p5.prototype.map = function(n, start1, stop1, start2, stop2, withinBounds) { + p5._validateParameters('map', arguments); + var newval = (n - start1) / (stop1 - start1) * (stop2 - start2) + start2; + if (!withinBounds) { + return newval; + } + if (start2 < stop2) { + return this.constrain(newval, start2, stop2); + } else { + return this.constrain(newval, stop2, 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} n0 Number to compare + * @param {Number} n1 Number to compare + * @return {Number} maximum Number + * @example + *
    + * function setup() { + * // Change the elements in the array and run the sketch + * // to show how max() works! + * let numArray = [2, 1, 5, 4, 8, 9]; + * fill(0); + * noStroke(); + * text('Array Elements', 0, 10); + * // Draw all numbers in the array + * let spacing = 15; + * let elemsY = 25; + * for (let i = 0; i < numArray.length; i++) { + * text(numArray[i], i * spacing, elemsY); + * } + * let maxX = 33; + * let 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 + * + */ +/** + * @method max + * @param {Number[]} nums Numbers to compare + * @return {Number} + */ +p5.prototype.max = function() { + p5._validateParameters('max', arguments); + if (arguments[0] instanceof Array) { + return Math.max.apply(null, arguments[0]); + } 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} n0 Number to compare + * @param {Number} n1 Number to compare + * @return {Number} minimum Number + * @example + *
    + * function setup() { + * // Change the elements in the array and run the sketch + * // to show how min() works! + * let numArray = [2, 1, 5, 4, 8, 9]; + * fill(0); + * noStroke(); + * text('Array Elements', 0, 10); + * // Draw all numbers in the array + * let spacing = 15; + * let elemsY = 25; + * for (let i = 0; i < numArray.length; i++) { + * text(numArray[i], i * spacing, elemsY); + * } + * let maxX = 33; + * let 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 + * + */ +/** + * @method min + * @param {Number[]} nums Numbers to compare + * @return {Number} + */ +p5.prototype.min = function() { + p5._validateParameters('min', arguments); + if (arguments[0] instanceof Array) { + return Math.min.apply(null, arguments[0]); + } 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 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); + * let currentNum = mouseX; + * let lowerBound = 0; + * let upperBound = width; //100; + * let normalized = norm(currentNum, lowerBound, upperBound); + * let lineY = 70; + * stroke(3); + * line(0, lineY, width, lineY); + * //Draw an ellipse mapped to the non-normalized value. + * noStroke(); + * fill(50); + * let s = 7; // ellipse size + * ellipse(currentNum, lineY, s, s); + * + * // Draw the guide + * let guideY = lineY + 15; + * text('0', 0, guideY); + * textAlign(RIGHT); + * text('100', width, guideY); + * + * // Draw the normalized value + * textAlign(LEFT); + * fill(0); + * textSize(32); + * let normalY = 40; + * let 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) { + p5._validateParameters('norm', arguments); + 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. + * let eSize = 3; // Original Size + * let 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 {Integer} rounded number + * @example + *
    + * function draw() { + * background(200); + * //map, mouseX between 0 and 5. + * let ax = map(mouseX, 0, 100, 0, 5); + * let ay = 66; + * + * // Round the mapped number. + * let bx = round(map(mouseX, 0, 100, 0, 5)); + * let 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), ax, ay - 5); + * text(nfc(bx, 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); + * let eSize = 7; + * let x1 = map(mouseX, 0, width, 0, 10); + * let y1 = 80; + * let x2 = sq(x1); + * let 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. + * let 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); + * let eSize = 7; + * let x1 = mouseX; + * let y1 = 80; + * let x2 = sqrt(x1); + * let 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); + * let 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/main":24}],52:[function(_dereq_,module,exports){ +/** + * @module Math + * @submodule Math + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * 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 + * @return {p5.Vector} + * @example + *
    + * function setup() { + * createCanvas(100, 100, WEBGL); + * noStroke(); + * fill(255, 102, 204); + * } + * + * function draw() { + * background(255); + * pointLight(color(255), createVector(sin(millis() / 1000) * 20, -40, -10)); + * scale(0.75); + * sphere(); + * } + *
    + * + * @alt + * a purple sphere lit by a point light oscillating horizontally + */ +p5.prototype.createVector = function(x, y, z) { + if (this instanceof p5) { + return new p5.Vector(this, arguments); + } else { + return new p5.Vector(x, y, z); + } +}; + +module.exports = p5; + +},{"../core/main":24}],53:[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/main'); + +var PERLIN_YWRAPB = 4; +var PERLIN_YWRAP = 1 << PERLIN_YWRAPB; +var PERLIN_ZWRAPB = 8; +var PERLIN_ZWRAP = 1 << PERLIN_ZWRAPB; +var PERLIN_SIZE = 4095; + +var perlin_octaves = 4; // default to medium smooth +var perlin_amp_falloff = 0.5; // 50% reduction/octave + +var scaled_cosine = function(i) { + return 0.5 * (1.0 - Math.cos(i * Math.PI)); +}; + +var perlin; // will be initialized lazily by noise() or noiseSeed() + +/** + * Returns the Perlin noise value at specified coordinates. Perlin noise is + * a random sequence generator producing a more natural ordered, harmonic + * succession of numbers compared to the standard random() function. + * It was invented by Ken Perlin in the 1980s and been used since in + * graphical applications to produce procedural textures, natural motion, + * shapes, terrains etc.

    The main difference to the + * random() function is that Perlin noise is defined in an infinite + * n-dimensional space where each pair of coordinates corresponds to a + * fixed semi-random value (fixed only for the lifespan of the program; 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 + *
    + * + * let xoff = 0.0; + * + * function draw() { + * background(204); + * xoff = xoff + 0.01; + * let n = noise(xoff) * width; + * line(n, 0, n, height); + * } + * + *
    + *
    + * let noiseScale=0.02; + * + * function draw() { + * background(0); + * for (let x=0; x < width; x++) { + * let 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 < perlin_octaves; o++) { + var of = xi + (yi << PERLIN_YWRAPB) + (zi << PERLIN_ZWRAPB); + + rxf = scaled_cosine(xf); + ryf = scaled_cosine(yf); + + n1 = perlin[of & PERLIN_SIZE]; + n1 += rxf * (perlin[(of + 1) & PERLIN_SIZE] - n1); + n2 = perlin[(of + PERLIN_YWRAP) & PERLIN_SIZE]; + n2 += rxf * (perlin[(of + PERLIN_YWRAP + 1) & PERLIN_SIZE] - n2); + n1 += ryf * (n2 - n1); + + of += PERLIN_ZWRAP; + n2 = perlin[of & PERLIN_SIZE]; + n2 += rxf * (perlin[(of + 1) & PERLIN_SIZE] - n2); + n3 = perlin[(of + PERLIN_YWRAP) & PERLIN_SIZE]; + n3 += rxf * (perlin[(of + PERLIN_YWRAP + 1) & PERLIN_SIZE] - n3); + n2 += ryf * (n3 - n2); + + n1 += scaled_cosine(zf) * (n2 - n1); + + r += n1 * ampl; + ampl *= perlin_amp_falloff; + xi <<= 1; + xf *= 2; + yi <<= 1; + yf *= 2; + zi <<= 1; + zf *= 2; + + if (xf >= 1.0) { + xi++; + xf--; + } + if (yf >= 1.0) { + yi++; + yf--; + } + if (zf >= 1.0) { + zi++; + zf--; + } + } + return r; +}; + +/** + * + * Adjusts the character and level of detail produced by the Perlin noise + * 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 + *
    + * + * let noiseVal; + * let noiseScale = 0.02; + * + * function setup() { + * createCanvas(100, 100); + * } + * + * function draw() { + * background(0); + * for (let y = 0; y < height; y++) { + * for (let 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 + *
    + * let xoff = 0.0; + * + * function setup() { + * noiseSeed(99); + * stroke(0, 10); + * } + * + * function draw() { + * xoff = xoff + .01; + * let 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 + var a = 1664525; + // c and m should be co-prime + var c = 1013904223; + var 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/main":24}],54:[function(_dereq_,module,exports){ +/** + * @module Math + * @submodule Math + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +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 + * @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 + *
    + * + * let v1 = createVector(40, 50); + * let 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 Vector() { + 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 {Number} + */ + this.x = x; + /** + * The y component of the vector + * @property y {Number} + */ + this.y = y; + /** + * The z component of the vector + * @property z {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 + * @return {String} + * @example + *
    + * + * function setup() { + * let v = createVector(20, 30); + * print(String(v)); // prints "p5.Vector Object : [20, 30, 0]" + * } + * + *
    + * + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(0, 0); + * let v1 = createVector(mouseX, mouseY); + * drawArrow(v0, v1, 'black'); + * + * noStroke(); + * text(v1.toString(), 10, 25, 90, 75); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.toString = function p5VectorToString() { + return 'p5.Vector Object : [' + this.x + ', ' + this.y + ', ' + this.z + ']'; +}; + +/** + * 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} [x] the x component of the vector + * @param {Number} [y] the y component of the vector + * @param {Number} [z] the z component of the vector + * @chainable + * @example + *
    + * + * function setup() { + * let v = createVector(1, 2, 3); + * v.set(4, 5, 6); // Sets vector to [4, 5, 6] + * + * let v1 = createVector(0, 0, 0); + * let arr = [1, 2, 3]; + * v1.set(arr); // Sets vector to [1, 2, 3] + * } + * + *
    + * + *
    + * + * let v0, v1; + * function setup() { + * createCanvas(100, 100); + * + * v0 = createVector(0, 0); + * v1 = createVector(50, 50); + * } + * + * function draw() { + * background(240); + * + * drawArrow(v0, v1, 'black'); + * v1.set(v1.x + random(-1, 1), v1.y + random(-1, 1)); + * + * noStroke(); + * text('x: ' + round(v1.x) + ' y: ' + round(v1.y), 20, 90); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +/** + * @method set + * @param {p5.Vector|Number[]} value the vector to set + * @chainable + */ +p5.Vector.prototype.set = function set(x, y, z) { + if (x instanceof p5.Vector) { + this.x = x.x || 0; + this.y = x.y || 0; + 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 + *
    + * + * let v1 = createVector(1, 2, 3); + * let v2 = v1.copy(); + * print(v1.x === v2.x && v1.y === v2.y && v1.z === v2.z); + * // Prints "true" + * + *
    + */ +p5.Vector.prototype.copy = function copy() { + 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 + * @param {Number} x the x component of the vector to be added + * @param {Number} [y] the y component of the vector to be added + * @param {Number} [z] the z component of the vector to be added + * @chainable + * @example + *
    + * + * let v = createVector(1, 2, 3); + * v.add(4, 5, 6); + * // v's components are set to [5, 7, 9] + * + *
    + * + *
    + * + * // Static method + * let v1 = createVector(1, 2, 3); + * let v2 = createVector(2, 3, 4); + * + * let v3 = p5.Vector.add(v1, v2); + * // v3 has components [3, 5, 7] + * print(v3); + * + *
    + * + *
    + * + * // red vector + blue vector = purple vector + * function draw() { + * background(240); + * + * let v0 = createVector(0, 0); + * let v1 = createVector(mouseX, mouseY); + * drawArrow(v0, v1, 'red'); + * + * let v2 = createVector(-30, 20); + * drawArrow(v1, v2, 'blue'); + * + * let v3 = p5.Vector.add(v1, v2); + * drawArrow(v0, v3, 'purple'); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +/** + * @method add + * @param {p5.Vector|Number[]} value the vector to add + * @chainable + */ +p5.Vector.prototype.add = function add(x, y, z) { + if (x instanceof p5.Vector) { + this.x += x.x || 0; + this.y += x.y || 0; + 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 + * @param {Number} x the x component of the vector to subtract + * @param {Number} [y] the y component of the vector to subtract + * @param {Number} [z] the z component of the vector to subtract + * @chainable + * @example + *
    + * + * let v = createVector(4, 5, 6); + * v.sub(1, 1, 1); + * // v's components are set to [3, 4, 5] + * + *
    + * + *
    + * + * // Static method + * let v1 = createVector(2, 3, 4); + * let v2 = createVector(1, 2, 3); + * + * let v3 = p5.Vector.sub(v1, v2); + * // v3 has components [1, 1, 1] + * print(v3); + * + *
    + * + *
    + * + * // red vector - blue vector = purple vector + * function draw() { + * background(240); + * + * let v0 = createVector(0, 0); + * let v1 = createVector(70, 50); + * drawArrow(v0, v1, 'red'); + * + * let v2 = createVector(mouseX, mouseY); + * drawArrow(v0, v2, 'blue'); + * + * let v3 = p5.Vector.sub(v1, v2); + * drawArrow(v2, v3, 'purple'); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +/** + * @method sub + * @param {p5.Vector|Number[]} value the vector to subtract + * @chainable + */ +p5.Vector.prototype.sub = function sub(x, y, z) { + if (x instanceof p5.Vector) { + this.x -= x.x || 0; + this.y -= x.y || 0; + 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 + * @param {Number} n the number to multiply with the vector + * @chainable + * @example + *
    + * + * let v = createVector(1, 2, 3); + * v.mult(2); + * // v's components are set to [2, 4, 6] + * + *
    + * + *
    + * + * // Static method + * let v1 = createVector(1, 2, 3); + * let v2 = p5.Vector.mult(v1, 2); + * // v2 has components [2, 4, 6] + * print(v2); + * + *
    + * + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(50, 50); + * let v1 = createVector(25, -25); + * drawArrow(v0, v1, 'red'); + * + * let num = map(mouseX, 0, width, -2, 2, true); + * let v2 = p5.Vector.mult(v1, num); + * drawArrow(v0, v2, 'blue'); + * + * noStroke(); + * text('multiplied by ' + num.toFixed(2), 5, 90); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.mult = function mult(n) { + if (!(typeof n === 'number' && isFinite(n))) { + console.warn( + 'p5.Vector.prototype.mult:', + 'n is undefined or not a finite number' + ); + return this; + } + this.x *= n; + this.y *= n; + this.z *= n; + return this; +}; + +/** + * Divide the vector by a scalar. The static version of this method creates a + * new p5.Vector while the non static version acts on the vector directly. + * See the examples for more context. + * + * @method div + * @param {number} n the number to divide the vector by + * @chainable + * @example + *
    + * + * let v = createVector(6, 4, 2); + * v.div(2); //v's components are set to [3, 2, 1] + * + *
    + * + *
    + * + * // Static method + * let v1 = createVector(6, 4, 2); + * let v2 = p5.Vector.div(v1, 2); + * // v2 has components [3, 2, 1] + * print(v2); + * + *
    + * + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(0, 100); + * let v1 = createVector(50, -50); + * drawArrow(v0, v1, 'red'); + * + * let num = map(mouseX, 0, width, 10, 0.5, true); + * let v2 = p5.Vector.div(v1, num); + * drawArrow(v0, v2, 'blue'); + * + * noStroke(); + * text('divided by ' + num.toFixed(2), 10, 90); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.div = function div(n) { + if (!(typeof n === 'number' && isFinite(n))) { + console.warn( + 'p5.Vector.prototype.div:', + 'n is undefined or not a finite number' + ); + return this; + } + if (n === 0) { + console.warn('p5.Vector.prototype.div:', 'divide by 0'); + return this; + } + this.x /= n; + this.y /= n; + this.z /= n; + 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 + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(0, 0); + * let v1 = createVector(mouseX, mouseY); + * drawArrow(v0, v1, 'black'); + * + * noStroke(); + * text('vector length: ' + v1.mag().toFixed(2), 10, 70, 90, 30); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + *
    + * + * let v = createVector(20.0, 30.0, 40.0); + * let m = v.mag(); + * print(m); // Prints "53.85164807134504" + * + *
    + */ +p5.Vector.prototype.mag = function mag() { + 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 + * let v1 = createVector(6, 4, 2); + * print(v1.magSq()); // Prints "56" + * + *
    + * + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(0, 0); + * let v1 = createVector(mouseX, mouseY); + * drawArrow(v0, v1, 'black'); + * + * noStroke(); + * text('vector length squared: ' + v1.magSq().toFixed(2), 10, 45, 90, 55); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.magSq = function magSq() { + var x = this.x; + var y = this.y; + var z = this.z; + return x * x + y * y + z * z; +}; + +/** + * 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} x x component of the vector + * @param {Number} [y] y component of the vector + * @param {Number} [z] z component of the vector + * @return {Number} the dot product + * + * @example + *
    + * + * let v1 = createVector(1, 2, 3); + * let v2 = createVector(2, 3, 4); + * + * print(v1.dot(v2)); // Prints "20" + * + *
    + * + *
    + * + * //Static method + * let v1 = createVector(1, 2, 3); + * let v2 = createVector(3, 2, 1); + * print(p5.Vector.dot(v1, v2)); // Prints "10" + * + *
    + */ +/** + * @method dot + * @param {p5.Vector} value value component of the vector or a p5.Vector + * @return {Number} + */ +p5.Vector.prototype.dot = function dot(x, y, z) { + if (x instanceof p5.Vector) { + return this.dot(x.x, x.y, x.z); + } + return this.x * (x || 0) + this.y * (y || 0) + this.z * (z || 0); +}; + +/** + * 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 + *
    + * + * let v1 = createVector(1, 2, 3); + * let v2 = createVector(1, 2, 3); + * + * v1.cross(v2); // v's components are [0, 0, 0] + * + *
    + * + *
    + * + * // Static method + * let v1 = createVector(1, 0, 0); + * let v2 = createVector(0, 1, 0); + * + * let crossProduct = p5.Vector.cross(v1, v2); + * // crossProduct has components [0, 0, 1] + * print(crossProduct); + * + *
    + */ +p5.Vector.prototype.cross = function cross(v) { + var x = this.y * v.z - this.z * v.y; + var y = this.z * v.x - this.x * v.z; + var z = this.x * v.y - this.y * v.x; + if (this.p5) { + return new p5.Vector(this.p5, [x, y, z]); + } 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 + *
    + * + * let v1 = createVector(1, 0, 0); + * let v2 = createVector(0, 1, 0); + * + * let distance = v1.dist(v2); // distance is 1.4142... + * print(distance); + * + *
    + * + *
    + * + * // Static method + * let v1 = createVector(1, 0, 0); + * let v2 = createVector(0, 1, 0); + * + * let distance = p5.Vector.dist(v1, v2); + * // distance is 1.4142... + * print(distance); + * + *
    + * + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(0, 0); + * + * let v1 = createVector(70, 50); + * drawArrow(v0, v1, 'red'); + * + * let v2 = createVector(mouseX, mouseY); + * drawArrow(v0, v2, 'blue'); + * + * noStroke(); + * text('distance between vectors: ' + v2.dist(v1).toFixed(2), 5, 50, 95, 50); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.dist = function dist(v) { + return v + .copy() + .sub(this) + .mag(); +}; + +/** + * Normalize the vector to length 1 (make it a unit vector). + * + * @method normalize + * @return {p5.Vector} normalized p5.Vector + * @example + *
    + * + * let 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] + * + *
    + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(50, 50); + * let v1 = createVector(mouseX - 50, mouseY - 50); + * + * drawArrow(v0, v1, 'red'); + * v1.normalize(); + * drawArrow(v0, v1.mult(35), 'blue'); + * + * noFill(); + * ellipse(50, 50, 35 * 2); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.normalize = function normalize() { + var len = this.mag(); + // here we multiply by the reciprocal instead of calling 'div()' + // since div duplicates this zero check. + if (len !== 0) this.mult(1 / len); + return this; +}; + +/** + * 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 + * @chainable + * @example + *
    + * + * let 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] + * + *
    + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(50, 50); + * let v1 = createVector(mouseX - 50, mouseY - 50); + * + * drawArrow(v0, v1, 'red'); + * drawArrow(v0, v1.limit(35), 'blue'); + * + * noFill(); + * ellipse(50, 50, 35 * 2); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.limit = function limit(max) { + var mSq = this.magSq(); + if (mSq > max * max) { + this.div(Math.sqrt(mSq)) //normalize it + .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 + * @chainable + * @example + *
    + * + * let 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] + * + *
    + * + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(0, 0); + * let v1 = createVector(50, 50); + * + * drawArrow(v0, v1, 'red'); + * + * let length = map(mouseX, 0, width, 0, 141, true); + * v1.setMag(length); + * drawArrow(v0, v1, 'blue'); + * + * noStroke(); + * text('magnitude set to: ' + length.toFixed(2), 10, 70, 90, 30); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.setMag = function setMag(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() { + * let v1 = createVector(30, 50); + * print(v1.heading()); // 1.0303768265243125 + * + * v1 = createVector(40, 50); + * print(v1.heading()); // 0.8960553845713439 + * + * v1 = createVector(30, 70); + * print(v1.heading()); // 1.1659045405098132 + * } + * + *
    + * + *
    + * + * function draw() { + * background(240); + * + * let v0 = createVector(50, 50); + * let v1 = createVector(mouseX - 50, mouseY - 50); + * + * drawArrow(v0, v1, 'black'); + * + * let myHeading = v1.heading(); + * noStroke(); + * text( + * 'vector heading: ' + + * myHeading.toFixed(2) + + * ' radians or ' + + * degrees(myHeading).toFixed(2) + + * ' degrees', + * 10, + * 50, + * 90, + * 50 + * ); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.heading = function heading() { + var h = Math.atan2(this.y, this.x); + if (this.p5) return this.p5._fromRadians(h); + return h; +}; + +/** + * Rotate the vector by an angle (only 2D vectors), magnitude remains the + * same + * + * @method rotate + * @param {number} angle the angle of rotation + * @chainable + * @example + *
    + * + * let 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] + * + *
    + * + *
    + * + * let angle = 0; + * function draw() { + * background(240); + * + * let v0 = createVector(50, 50); + * let v1 = createVector(50, 0); + * + * drawArrow(v0, v1.rotate(angle), 'black'); + * angle += 0.01; + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.rotate = function rotate(a) { + var newHeading = this.heading() + a; + if (this.p5) newHeading = this.p5._toRadians(newHeading); + var mag = this.mag(); + this.x = Math.cos(newHeading) * mag; + this.y = Math.sin(newHeading) * mag; + return this; +}; + +/** + * Calculates and returns the angle (in radians) between two vectors. + * @method angleBetween + * @param {p5.Vector} the x, y, and z components of a p5.Vector + * @return {Number} the angle between (in radians) + * @example + *
    + * + * let v1 = createVector(1, 0, 0); + * let v2 = createVector(0, 1, 0); + * + * let angle = v1.angleBetween(v2); + * // angle is PI/2 + * print(angle); + * + *
    + * + *
    + * + * function draw() { + * background(240); + * let v0 = createVector(50, 50); + * + * let v1 = createVector(50, 0); + * drawArrow(v0, v1, 'red'); + * + * let v2 = createVector(mouseX - 50, mouseY - 50); + * drawArrow(v0, v2, 'blue'); + * + * let angleBetween = v1.angleBetween(v2); + * noStroke(); + * text( + * 'angle between: ' + + * angleBetween.toFixed(2) + + * ' radians or ' + + * degrees(angleBetween).toFixed(2) + + * ' degrees', + * 10, + * 50, + * 90, + * 50 + * ); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.prototype.angleBetween = function angleBetween(v) { + var dotmagmag = this.dot(v) / (this.mag() * v.mag()); + // Mathematically speaking: the dotmagmag variable will be between -1 and 1 + // inclusive. Practically though it could be slightly outside this range due + // to floating-point rounding issues. This can make Math.acos return NaN. + // + // Solution: we'll clamp the value to the -1,1 range + var angle = Math.acos(Math.min(1, Math.max(-1, dotmagmag))); + if (this.p5) return this.p5._fromRadians(angle); + return angle; +}; + +/** + * Linear interpolate the vector to another vector + * + * @method lerp + * @param {Number} x the x component + * @param {Number} y the y component + * @param {Number} z the z component + * @param {Number} amt the amount of interpolation; some value between 0.0 + * (old vector) and 1.0 (new vector). 0.9 is very near + * the new vector. 0.5 is halfway in between. + * @chainable + * + * @example + *
    + * + * let v = createVector(1, 1, 0); + * + * v.lerp(3, 3, 0, 0.5); // v now has components [2,2,0] + * + *
    + * + *
    + * + * let v1 = createVector(0, 0, 0); + * let v2 = createVector(100, 100, 0); + * + * let v3 = p5.Vector.lerp(v1, v2, 0.5); + * // v3 has components [50,50,0] + * print(v3); + * + *
    + * + *
    + * + * let step = 0.01; + * let amount = 0; + * + * function draw() { + * background(240); + * let v0 = createVector(0, 0); + * + * let v1 = createVector(mouseX, mouseY); + * drawArrow(v0, v1, 'red'); + * + * let v2 = createVector(90, 90); + * drawArrow(v0, v2, 'blue'); + * + * if (amount > 1 || amount < 0) { + * step *= -1; + * } + * amount += step; + * let v3 = p5.Vector.lerp(v1, v2, amount); + * + * drawArrow(v0, v3, 'purple'); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +/** + * @method lerp + * @param {p5.Vector} v the p5.Vector to lerp to + * @param {Number} amt + * @chainable + */ +p5.Vector.prototype.lerp = function lerp(x, y, z, amt) { + if (x instanceof p5.Vector) { + return this.lerp(x.x, x.y, x.z, y); + } + 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 {Number[]} an Array with the 3 values + * @example + *
    + * + * function setup() { + * let v = createVector(20, 30); + * print(v.array()); // Prints : Array [20, 30, 0] + * } + * + *
    + * + *
    + * + * let v = createVector(10.0, 20.0, 30.0); + * let 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 array() { + return [this.x || 0, this.y || 0, this.z || 0]; +}; + +/** + * Equality check against a p5.Vector + * + * @method equals + * @param {Number} [x] the x component of the vector + * @param {Number} [y] the y component of the vector + * @param {Number} [z] the z component of the vector + * @return {Boolean} whether the vectors are equals + * @example + *
    + * + * let v1 = createVector(5, 10, 20); + * let v2 = createVector(5, 10, 20); + * let 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 + * + *
    + * + *
    + * + * let v1 = createVector(10.0, 20.0, 30.0); + * let v2 = createVector(10.0, 20.0, 30.0); + * let v3 = createVector(0.0, 0.0, 0.0); + * print(v1.equals(v2)); // true + * print(v1.equals(v3)); // false + * + *
    + */ +/** + * @method equals + * @param {p5.Vector|Array} value the vector to compare + * @return {Boolean} + */ +p5.Vector.prototype.equals = function equals(x, y, z) { + var a, b, c; + if (x instanceof p5.Vector) { + a = x.x || 0; + 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 vector from an angle + * + * @method fromAngle + * @static + * @param {Number} angle the desired angle, in radians + * @param {Number} [length] the length of the new vector (defaults to 1) + * @return {p5.Vector} the new p5.Vector object + * @example + *
    + * + * function draw() { + * background(200); + * + * // Create a variable, proportional to the mouseX, + * // varying from 0-360, to represent an angle in degrees. + * angleMode(DEGREES); + * let 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.) + * let readout = 'angle = ' + nfc(myDegrees, 1) + '\xB0'; + * noStroke(); + * fill(0); + * text(readout, 5, 15); + * + * // Create a p5.Vector using the fromAngle function, + * // and extract its x and y components. + * let v = p5.Vector.fromAngle(radians(myDegrees), 30); + * let vx = v.x; + * let vy = v.y; + * + * push(); + * translate(width / 2, height / 2); + * noFill(); + * stroke(150); + * line(0, 0, 30, 0); + * stroke(0); + * line(0, 0, vx, vy); + * pop(); + * } + * + *
    + */ +p5.Vector.fromAngle = function fromAngle(angle, length) { + if (typeof length === 'undefined') { + length = 1; + } + return new p5.Vector(length * Math.cos(angle), length * Math.sin(angle), 0); +}; + +/** + * Make a new 3D vector from a pair of ISO spherical angles + * + * @method fromAngles + * @static + * @param {Number} theta the polar angle, in radians (zero is up) + * @param {Number} phi the azimuthal angle, in radians + * (zero is out of the screen) + * @param {Number} [length] the length of the new vector (defaults to 1) + * @return {p5.Vector} the new p5.Vector object + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * fill(255); + * noStroke(); + * } + * function draw() { + * background(255); + * + * let t = millis() / 1000; + * + * // add three point lights + * pointLight(color('#f00'), p5.Vector.fromAngles(t * 1.0, t * 1.3, 100)); + * pointLight(color('#0f0'), p5.Vector.fromAngles(t * 1.1, t * 1.2, 100)); + * pointLight(color('#00f'), p5.Vector.fromAngles(t * 1.2, t * 1.1, 100)); + * + * sphere(35); + * } + * + *
    + */ +p5.Vector.fromAngles = function(theta, phi, length) { + if (typeof length === 'undefined') { + length = 1; + } + var cosPhi = Math.cos(phi); + var sinPhi = Math.sin(phi); + var cosTheta = Math.cos(theta); + var sinTheta = Math.sin(theta); + + return new p5.Vector( + length * sinTheta * sinPhi, + -length * cosTheta, + length * sinTheta * cosPhi + ); +}; + +/** + * Make a new 2D unit vector from a random angle + * + * @method random2D + * @static + * @return {p5.Vector} the new p5.Vector object + * @example + *
    + * + * let 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] + * print(v); + * + *
    + * + *
    + * + * function setup() { + * frameRate(1); + * } + * + * function draw() { + * background(240); + * + * let v0 = createVector(50, 50); + * let v1 = p5.Vector.random2D(); + * drawArrow(v0, v1.mult(50), 'black'); + * } + * + * // draw an arrow for a vector at a given base position + * function drawArrow(base, vec, myColor) { + * push(); + * stroke(myColor); + * strokeWeight(3); + * fill(myColor); + * translate(base.x, base.y); + * line(0, 0, vec.x, vec.y); + * rotate(vec.heading()); + * let arrowSize = 7; + * translate(vec.mag() - arrowSize, 0); + * triangle(0, arrowSize / 2, 0, -arrowSize / 2, arrowSize, 0); + * pop(); + * } + * + *
    + */ +p5.Vector.random2D = function random2D() { + return this.fromAngle(Math.random() * constants.TWO_PI); +}; + +/** + * Make a new random 3D unit vector. + * + * @method random3D + * @static + * @return {p5.Vector} the new p5.Vector object + * @example + *
    + * + * let 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] + * print(v); + * + *
    + */ +p5.Vector.random3D = function random3D() { + var angle = Math.random() * constants.TWO_PI; + var vz = Math.random() * 2 - 1; + var vzBase = Math.sqrt(1 - vz * vz); + var vx = vzBase * Math.cos(angle); + var vy = vzBase * Math.sin(angle); + return new p5.Vector(vx, vy, vz); +}; + +// Adds two vectors together and returns a new one. +/** + * @method add + * @static + * @param {p5.Vector} v1 a p5.Vector to add + * @param {p5.Vector} v2 a p5.Vector to add + * @param {p5.Vector} target the vector to receive the result + */ +/** + * @method add + * @static + * @param {p5.Vector} v1 + * @param {p5.Vector} v2 + * @return {p5.Vector} the resulting p5.Vector + * + */ + +p5.Vector.add = function add(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. + */ +/** + * @method sub + * @static + * @param {p5.Vector} v1 a p5.Vector to subtract from + * @param {p5.Vector} v2 a p5.Vector to subtract + * @param {p5.Vector} target if undefined a new vector will be created + */ +/** + * @method sub + * @static + * @param {p5.Vector} v1 + * @param {p5.Vector} v2 + * @return {p5.Vector} the resulting p5.Vector + */ + +p5.Vector.sub = function sub(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. + */ +/** + * @method mult + * @static + * @param {p5.Vector} v the vector to multiply + * @param {Number} n + * @param {p5.Vector} target if undefined a new vector will be created + */ +/** + * @method mult + * @static + * @param {p5.Vector} v + * @param {Number} n + * @return {p5.Vector} the resulting new p5.Vector + */ +p5.Vector.mult = function mult(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. + */ +/** + * @method div + * @static + * @param {p5.Vector} v the vector to divide + * @param {Number} n + * @param {p5.Vector} target if undefined a new vector will be created + */ +/** + * @method div + * @static + * @param {p5.Vector} v + * @param {Number} n + * @return {p5.Vector} the resulting new p5.Vector + */ +p5.Vector.div = function div(v, n, target) { + if (!target) { + target = v.copy(); + } else { + target.set(v); + } + target.div(n); + return target; +}; + +/** + * Calculates the dot product of two vectors. + */ +/** + * @method dot + * @static + * @param {p5.Vector} v1 the first p5.Vector + * @param {p5.Vector} v2 the second p5.Vector + * @return {Number} the dot product + */ +p5.Vector.dot = function dot(v1, v2) { + return v1.dot(v2); +}; + +/** + * Calculates the cross product of two vectors. + */ +/** + * @method cross + * @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 cross(v1, v2) { + return v1.cross(v2); +}; + +/** + * Calculates the Euclidean distance between two points (considering a + * point as a vector object). + */ +/** + * @method dist + * @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 dist(v1, v2) { + return v1.dist(v2); +}; + +/** + * Linear interpolate a vector to another vector and return the result as a + * new vector. + */ +/** + * @method lerp + * @static + * @param {p5.Vector} v1 + * @param {p5.Vector} v2 + * @param {Number} amt + * @param {p5.Vector} target if undefined a new vector will be created + */ +/** + * @method lerp + * @static + * @param {p5.Vector} v1 + * @param {p5.Vector} v2 + * @param {Number} amt + * @return {Number} the lerped value + */ +p5.Vector.lerp = function lerp(v1, v2, amt, target) { + if (!target) { + target = v1.copy(); + } else { + target.set(v1); + } + target.lerp(v2, amt); + return target; +}; + +/** + * @method mag + * @param {p5.Vector} vecT the vector to return the magnitude of + * @return {Number} the magnitude of vecT + * @static + */ +p5.Vector.mag = function mag(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":18,"../core/main":24}],55:[function(_dereq_,module,exports){ +/** + * @module Math + * @submodule Random + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +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 (let i = 0; i < 100; i++) { + * let 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 (let i = 0; i < 100; i++) { + * let r = random(50); + * stroke(r * 5); + * line(50, i, 50 + r, i); + * } + * + *
    + *
    + * + * for (let i = 0; i < 100; i++) { + * let r = random(-50, 50); + * line(50, i, 50 + r, i); + * } + * + *
    + *
    + * + * // Get a random element from an array using the random(Array) syntax + * let words = ['apple', 'bear', 'cat', 'dog']; + * let 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 (let y = 0; y < 100; y++) { + * let x = randomGaussian(50, 15); + * line(50, y, x, y); + * } + * + *
    + *
    + * + * let distribution = new Array(360); + * + * function setup() { + * createCanvas(100, 100); + * for (let i = 0; i < distribution.length; i++) { + * distribution[i] = floor(randomGaussian(0, 15)); + * } + * } + * + * function draw() { + * background(204); + * + * translate(width / 2, width / 2); + * + * for (let i = 0; i < distribution.length; i++) { + * rotate(TWO_PI / distribution.length); + * stroke(0); + * let 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/main":24}],56:[function(_dereq_,module,exports){ +/** + * @module Math + * @submodule Trigonometry + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); + +/* + * all DEGREES/RADIANS conversion should be done in the p5 instance + * if possible, using the p5._toRadians(), p5._fromRadians() methods. + */ +p5.prototype._angleMode = constants.RADIANS; + +/** + * The inverse of cos(), returns the arc cosine of a value. This function + * 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 + *
    + * + * let a = PI; + * let c = cos(a); + * let ac = acos(c); + * // Prints: "3.1415927 : -1.0 : 3.1415927" + * print(a + ' : ' + c + ' : ' + ac); + * + *
    + * + *
    + * + * let a = PI + PI / 4.0; + * let c = cos(a); + * let ac = acos(c); + * // Prints: "3.926991 : -0.70710665 : 2.3561943" + * print(a + ' : ' + c + ' : ' + ac); + * + *
    + */ +p5.prototype.acos = function(ratio) { + return this._fromRadians(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 + *
    + * + * let a = PI + PI / 3; + * let s = sin(a); + * let as = asin(s); + * // Prints: "1.0471976 : 0.86602545 : 1.0471976" + * print(a + ' : ' + s + ' : ' + as); + * + *
    + * + *
    + * + * let a = PI + PI / 3.0; + * let s = sin(a); + * let as = asin(s); + * // Prints: "4.1887903 : -0.86602545 : -1.0471976" + * print(a + ' : ' + s + ' : ' + as); + * + *
    + * + */ +p5.prototype.asin = function(ratio) { + return this._fromRadians(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 + *
    + * + * let a = PI + PI / 3; + * let t = tan(a); + * let at = atan(t); + * // Prints: "1.0471976 : 1.7320509 : 1.0471976" + * print(a + ' : ' + t + ' : ' + at); + * + *
    + * + *
    + * + * let a = PI + PI / 3.0; + * let t = tan(a); + * let at = atan(t); + * // Prints: "4.1887903 : 1.7320513 : 1.0471977" + * print(a + ' : ' + t + ' : ' + at); + * + *
    + * + */ +p5.prototype.atan = function(ratio) { + return this._fromRadians(Math.atan(ratio)); +}; + +/** + * Calculates the angle (in radians) from a specified point to the coordinate + * origin as measured from the positive x-axis. Values are returned as a + * float in the range from PI to -PI. The atan2() function is most often used + * 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); + * let 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) { + return this._fromRadians(Math.atan2(y, x)); +}; + +/** + * Calculates the cosine of an angle. This function takes into account the + * current angleMode. Values are returned in the range -1 to 1. + * + * @method cos + * @param {Number} angle the angle + * @return {Number} the cosine of the angle + * + * @example + *
    + * + * let a = 0.0; + * let inc = TWO_PI / 25.0; + * for (let 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) { + return Math.cos(this._toRadians(angle)); +}; + +/** + * Calculates the sine of an angle. This function takes into account the + * current angleMode. Values are returned in the range -1 to 1. + * + * @method sin + * @param {Number} angle the angle + * @return {Number} the sine of the angle + * + * @example + *
    + * + * let a = 0.0; + * let inc = TWO_PI / 25.0; + * for (let 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) { + return Math.sin(this._toRadians(angle)); +}; + +/** + * Calculates the tangent of an angle. This function takes into account + * the current angleMode. Values are returned in the range -1 to 1. + * + * @method tan + * @param {Number} angle the angle + * @return {Number} the tangent of the angle + * + * @example + *
    + * + * let a = 0.0; + * let inc = TWO_PI / 50.0; + * for (let 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) { + return Math.tan(this._toRadians(angle)); +}; + +/** + * Converts a radian measurement to its corresponding value in degrees. + * Radians and degrees are two ways of measuring the same thing. There are + * 360 degrees in a circle and 2*PI radians in a circle. For example, + * 90° = PI/2 = 1.5707964. This function does not take into account the + * current angleMode. + * + * @method degrees + * @param {Number} radians the radians value to convert to degrees + * @return {Number} the converted angle + * + * + * @example + *
    + * + * let rad = PI / 4; + * let deg = degrees(rad); + * print(rad + ' radians is ' + deg + ' degrees'); + * // Prints: 0.7853981633974483 radians is 45 degrees + * + *
    + * + */ +p5.prototype.degrees = function(angle) { + return angle * constants.RAD_TO_DEG; +}; + +/** + * Converts a degree measurement to its corresponding value in radians. + * Radians and degrees are two ways of measuring the same thing. There are + * 360 degrees in a circle and 2*PI radians in a circle. For example, + * 90° = PI/2 = 1.5707964. This function does not take into account the + * current angleMode. + * + * @method radians + * @param {Number} degrees the degree value to convert to radians + * @return {Number} the converted angle + * + * @example + *
    + * + * let deg = 45.0; + * let rad = radians(deg); + * print(deg + ' degrees is ' + rad + ' radians'); + * // Prints: 45 degrees is 0.7853981633974483 radians + * + *
    + */ +p5.prototype.radians = function(angle) { + return angle * constants.DEG_TO_RAD; +}; + +/** + * 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 + * let 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); // variable 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; + } +}; + +/** + * converts angles from the current angleMode to RADIANS + * + * @method _toRadians + * @private + * @param {Number} angle + * @returns {Number} + */ +p5.prototype._toRadians = function(angle) { + if (this._angleMode === constants.DEGREES) { + return angle * constants.DEG_TO_RAD; + } + return angle; +}; + +/** + * converts angles from the current angleMode to DEGREES + * + * @method _toDegrees + * @private + * @param {Number} angle + * @returns {Number} + */ +p5.prototype._toDegrees = function(angle) { + if (this._angleMode === constants.RADIANS) { + return angle * constants.RAD_TO_DEG; + } + return angle; +}; + +/** + * converts angles from RADIANS into the current angleMode + * + * @method _fromRadians + * @private + * @param {Number} angle + * @returns {Number} + */ +p5.prototype._fromRadians = function(angle) { + if (this._angleMode === constants.DEGREES) { + return angle * constants.RAD_TO_DEG; + } + return angle; +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/main":24}],57:[function(_dereq_,module,exports){ +/** + * @module Typography + * @submodule Attributes + * @for p5 + * @requires core + * @requires constants + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * 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 + * @chainable + * @example + *
    + * + * textSize(16); + * textAlign(RIGHT); + * text('ABCD', 50, 30); + * textAlign(CENTER); + * text('EFGH', 50, 50); + * textAlign(LEFT); + * text('IJKL', 50, 70); + * + *
    + * + *
    + * + * textSize(16); + * strokeWeight(0.5); + * + * line(0, 12, width, 12); + * textAlign(CENTER, TOP); + * text('TOP', 0, 12, width); + * + * line(0, 37, width, 37); + * textAlign(CENTER, CENTER); + * text('CENTER', 0, 37, width); + * + * line(0, 62, width, 62); + * textAlign(CENTER, BASELINE); + * text('BASELINE', 0, 62, width); + * + * line(0, 87, width, 87); + * textAlign(CENTER, BOTTOM); + * text('BOTTOM', 0, 87, width); + * + *
    + * + * @alt + *Letters ABCD displayed at top right, EFGH at center and IJKL at bottom left. + * The names of the four vertical alignments rendered each showing that alignment's placement relative to a horizontal line. + * + */ +/** + * @method textAlign + * @return {Object} + */ +p5.prototype.textAlign = function(horizAlign, vertAlign) { + p5._validateParameters('textAlign', arguments); + return this._renderer.textAlign.apply(this._renderer, arguments); +}; + +/** + * Sets/gets the spacing, in pixels, between lines of text. This + * setting will be used in all subsequent calls to the text() function. + * + * @method textLeading + * @param {Number} leading the size in pixels for spacing between lines + * @chainable + * + * @example + *
    + * + * // Text to display. The "\n" is a "new line" character + * let 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 + */ +/** + * @method textLeading + * @return {Number} + */ +p5.prototype.textLeading = function(theLeading) { + p5._validateParameters('textLeading', arguments); + return this._renderer.textLeading.apply(this._renderer, arguments); +}; + +/** + * Sets/gets the current font size. This size will be used in all subsequent + * calls to the text() function. Font size is measured in pixels. + * + * @method textSize + * @param {Number} theSize the size of the letters in units of pixels + * @chainable + * + * @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 + */ +/** + * @method textSize + * @return {Number} + */ +p5.prototype.textSize = function(theSize) { + p5._validateParameters('textSize', arguments); + return this._renderer.textSize.apply(this._renderer, arguments); +}; + +/** + * Sets/gets the style of the text for system fonts to NORMAL, ITALIC, BOLD or BOLDITALIC. + * Note: this may be is overridden by CSS styling. For non-system fonts + * (opentype, truetype, etc.) please load styled fonts instead. + * + * @method textStyle + * @param {Constant} theStyle styling for text, either NORMAL, + * ITALIC, BOLD or BOLDITALIC + * @chainable + * @example + *
    + * + * strokeWeight(0); + * textSize(12); + * textStyle(NORMAL); + * text('Font Style Normal', 10, 15); + * textStyle(ITALIC); + * text('Font Style Italic', 10, 40); + * textStyle(BOLD); + * text('Font Style Bold', 10, 65); + * textStyle(BOLDITALIC); + * text('Font Style Bold Italic', 10, 90); + * + *
    + * + * @alt + *words Font Style Normal displayed normally, Italic in italic, bold in bold and bold italic in bold italics. + */ +/** + * @method textStyle + * @return {String} + */ +p5.prototype.textStyle = function(theStyle) { + p5._validateParameters('textStyle', arguments); + 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); + * + * let aChar = 'P'; + * let cWidth = textWidth(aChar); + * text(aChar, 0, 40); + * line(cWidth, 0, cWidth, 50); + * + * let aString = 'p5.js'; + * let 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) { + p5._validateParameters('textWidth', arguments); + 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. + * @method textAscent + * @return {Number} + * @example + *
    + * + * let base = height * 0.75; + * let scalar = 0.8; // Different for each font + * + * textSize(32); // Set initial text size + * let 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() { + p5._validateParameters('textAscent', arguments); + 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. + * @method textDescent + * @return {Number} + * @example + *
    + * + * let base = height * 0.75; + * let scalar = 0.8; // Different for each font + * + * textSize(32); // Set initial text size + * let 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() { + p5._validateParameters('textDescent', arguments); + return this._renderer.textDescent(); +}; + +/** + * Helper function to measure ascent and descent. + */ +p5.prototype._updateTextMetrics = function() { + return this._renderer._updateTextMetrics(); +}; + +module.exports = p5; + +},{"../core/main":24}],58:[function(_dereq_,module,exports){ +/** + * @module Typography + * @submodule Loading & Displaying + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); +var opentype = _dereq_('opentype.js'); + +_dereq_('../core/error_helpers'); + +/** + * 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 fonts 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 + * @param {Function} [onError] function to be executed if + * an error occurs + * @return {p5.Font} p5.Font object + * @example + * + *

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

    + * + *
    + * let myFont; + * function preload() { + * myFont = loadFont('assets/inconsolata.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/inconsolata.otf', drawText); + * } + * + * function drawText(font) { + * fill('#ED225D'); + * textFont(font, 36); + * text('p5*js', 10, 50); + * } + *
    + * + *

    You can also use the font filename string (without the file extension) to style other HTML + * elements.

    + * + *
    + * function preload() { + * loadFont('assets/inconsolata.otf'); + * } + * + * function setup() { + * let myDiv = createDiv('hello there'); + * myDiv.style('font-family', 'Inconsolata'); + * } + *
    + * + * @alt + * p5*js in p5's theme dark pink + * p5*js in p5's theme dark pink + * + */ +p5.prototype.loadFont = function(path, onSuccess, onError) { + p5._validateParameters('loadFont', arguments); + var p5Font = new p5.Font(this); + + var self = this; + opentype.load(path, function(err, font) { + if (err) { + p5._friendlyFileLoadError(4, path); + if (typeof onError !== 'undefined') { + return onError(err); + } + console.error(err, path); + return; + } + + p5Font.font = font; + + if (typeof onSuccess !== 'undefined') { + onSuccess(p5Font); + } + + self._decrementPreload(); + + // check that we have an acceptable font type + var validFontTypes = ['ttf', 'otf', 'woff', 'woff2'], + fileNoPath = path + .split('\\') + .pop() + .split('/') + .pop(), + lastDotIdx = fileNoPath.lastIndexOf('.'), + fontFamily, + newStyle, + 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; +}; + +/** + * 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. If x2 and y2 are not specified, the baseline alignment is the + * default, which means that the text will be drawn upwards from x and y. + *

    + * WEBGL: Only opentype/truetype fonts are supported. You must load a font using the + * loadFont() method (see the example above). + * stroke() currently has no effect in webgl mode. + * + * @method text + * @param {String|Object|Array|Number|Boolean} str the alphanumeric + * symbols to be displayed + * @param {Number} x x-coordinate of text + * @param {Number} y y-coordinate of text + * @param {Number} [x2] by default, the width of the text box, + * see rectMode() for more info + * @param {Number} [y2] by default, the height of the text box, + * see rectMode() for more info + * @chainable + * @example + *
    + * + * textSize(32); + * text('word', 10, 30); + * fill(0, 102, 153); + * text('word', 10, 60); + * fill(0, 102, 153, 51); + * text('word', 10, 90); + * + *
    + *
    + * + * let s = 'The quick brown fox jumped over the lazy dog.'; + * fill(50); + * text(s, 10, 10, 70, 80); // Text wraps within text box + * + *
    + * + *
    + * + * let inconsolata; + * function preload() { + * inconsolata = loadFont('assets/inconsolata.otf'); + * } + * function setup() { + * createCanvas(100, 100, WEBGL); + * textFont(inconsolata); + * textSize(width / 3); + * textAlign(CENTER, CENTER); + * } + * function draw() { + * background(0); + * let time = millis(); + * rotateX(time / 1000); + * rotateZ(time / 1234); + * text('p5.js', 0, 0); + * } + * + *
    + * + * @alt + *'word' displayed 3 times going from black, blue to translucent blue + * The quick brown fox jumped over the lazy dog. + * the text 'p5.js' spinning in 3d + * + */ +p5.prototype.text = function(str, x, y, maxWidth, maxHeight) { + p5._validateParameters('text', arguments); + return !(this._renderer._doFill || this._renderer._doStroke) + ? this + : this._renderer.text.apply(this._renderer, arguments); +}; + +/** + * Sets the current font that will be drawn with the text() function. + *

    + * WEBGL: Only fonts loaded via loadFont() are supported. + * + * @method textFont + * @return {Object} the current font + * + * @example + *
    + * + * fill(0); + * textSize(12); + * textFont('Georgia'); + * text('Georgia', 12, 30); + * textFont('Helvetica'); + * text('Helvetica', 12, 60); + * + *
    + *
    + * + * let 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 + */ +/** + * @method textFont + * @param {Object|String} font a font loaded via loadFont(), or a String + * representing a web safe font (a font + * that is generally available across all systems) + * @param {Number} [size] the font size to use + * @chainable + */ +p5.prototype.textFont = function(theFont, theSize) { + p5._validateParameters('textFont', arguments); + if (arguments.length) { + if (!theFont) { + throw new Error('null font passed to textFont'); + } + + this._renderer._setProperty('_textFont', theFont); + + if (theSize) { + this._renderer._setProperty('_textSize', theSize); + this._renderer._setProperty( + '_textLeading', + theSize * constants._DEFAULT_LEADMULT + ); + } + + return this._renderer._applyTextProperties(); + } + + return this._renderer._textFont; +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/error_helpers":20,"../core/main":24,"opentype.js":10}],59:[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/main'); +var constants = _dereq_('../core/constants'); + +/** + * Base class for font handling + * @class p5.Font + * @param {p5} [pInst] pointer to p5 instance + */ +p5.Font = function(p) { + this.parent = p; + + this.cache = {}; + + /** + * Underlying opentype font implementation + * @property font + */ + this.font = undefined; +}; + +/** + * 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) Default is 12. + * @param {Object} [options] opentype options (optional) + * opentype fonts contains alignment and baseline options. + * Default is 'LEFT' and 'alphabetic' + * + * + * @return {Object} a rectangle object with properties: x, y, w, h + * + * @example + *
    + * + * let font; + * let textString = 'Lorem ipsum dolor sit amet.'; + * function preload() { + * font = loadFont('./assets/Regular.otf'); + * } + * function setup() { + * background(210); + * + * let 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, opts) { + x = x !== undefined ? x : 0; + y = y !== undefined ? y : 0; + + // 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 = (opts && opts.renderer && opts.renderer._pInst) || this.parent, + ctx = p._renderer.drawingContext, + alignment = ctx.textAlign || constants.LEFT, + baseline = ctx.textBaseline || constants.BASELINE, + cacheResults = false, + result, + key; + + fontSize = fontSize || p._renderer._textSize; + + // NOTE: cache disabled for now pending further discussion of #3436 + if (cacheResults) { + key = cacheKey('textBounds', str, x, y, fontSize, alignment, baseline); + result = this.cache[key]; + } + + if (!result) { + var minX, + minY, + maxX, + maxY, + pos, + xCoords = [], + yCoords = [], + scale = this._scale(fontSize); + + this.font.forEachGlyph(str, x, y, fontSize, opts, function( + glyph, + gX, + gY, + gFontSize + ) { + var gm = glyph.getMetrics(); + xCoords.push(gX + gm.xMin * scale); + xCoords.push(gX + gm.xMax * scale); + yCoords.push(gY + -gm.yMin * scale); + yCoords.push(gY + -gm.yMax * scale); + }); + + minX = Math.min.apply(null, xCoords); + minY = Math.min.apply(null, yCoords); + 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 + pos = this._handleAlignment( + p._renderer, + str, + result.x, + result.y, + result.w + result.advance + ); + + result.x = pos.x; + result.y = pos.y; + + if (cacheResults) { + this.cache[key] = result; + } + } + + return result; +}; + +/** + * Computes an array of points following the path for specified text + * + * @method textToPoints + * @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=.1); 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) + * @example + *
    + * + * let font; + * function preload() { + * font = loadFont('assets/inconsolata.otf'); + * } + * + * let points; + * let bounds; + * function setup() { + * createCanvas(100, 100); + * stroke(0); + * fill(255, 104, 204); + * + * points = font.textToPoints('p5', 0, 0, 10, { + * sampleFactor: 5, + * simplifyThreshold: 0 + * }); + * bounds = font.textBounds(' p5 ', 0, 0, 10); + * } + * + * function draw() { + * background(255); + * beginShape(); + * translate(-bounds.x * width / bounds.w, -bounds.y * height / bounds.h); + * for (let i = 0; i < points.length; i++) { + * let p = points[i]; + * vertex( + * p.x * width / bounds.w + + * sin(20 * p.y / bounds.h + millis() / 1000) * width / 30, + * p.y * height / bounds.h + * ); + * } + * endShape(CLOSE); + * } + * + *
    + * + */ +p5.Font.prototype.textToPoints = function(txt, x, y, fontSize, options) { + var xoff = 0, + result = [], + glyphs = this._getGlyphs(txt); + + function isSpace(i) { + return ( + (glyphs[i].name && glyphs[i].name === 'space') || + (txt.length === glyphs.length && txt[i] === ' ') || + (glyphs[i].index && glyphs[i].index === 3) + ); + } + + fontSize = fontSize || this.parent._renderer._textSize; + + for (var i = 0; i < glyphs.length; i++) { + if (!isSpace(i)) { + // fix to #1817, #2069 + + var gpath = glyphs[i].getPath(x, y, fontSize), + paths = splitPaths(gpath.commands); + + for (var j = 0; j < paths.length; j++) { + var pts = pathToPoints(paths[j], options); + + for (var k = 0; k < pts.length; k++) { + 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. + * + * @private + * @param {String} str the string to be converted + * @return {Array} the opentype glyphs + */ +p5.Font.prototype._getGlyphs = function(str) { + return this.font.stringToGlyphs(str); +}; + +/** + * Returns an opentype path for the supplied string and position. + * + * @private + * @param {String} line a line of text + * @param {Number} x x-position + * @param {Number} y y-position + * @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, + renderer = p._renderer, + pos = this._handleAlignment(renderer, line, x, y); + + return this.font.getPath(line, pos.x, pos.y, 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); + } else if (typeof x === 'object') { + // handle options specified in 2nd arg + options = x; + } + + // handle svg arguments + if (options && typeof options.decimals === 'number') { + decimals = options.decimals; + } + + 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); + } else if (typeof x === 'object') { + // handle options specified in 2nd arg + 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 {p5.Font} 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 + if (!pg._fillSet) { + pg._setFill(constants._DEFAULT_TEXT_FILL); + } + ctx.fill(); + } + + return this; +}; + +p5.Font.prototype._textWidth = function(str, fontSize) { + return this.font.getAdvanceWidth(str, fontSize); +}; + +p5.Font.prototype._textAscent = function(fontSize) { + return this.font.ascender * this._scale(fontSize); +}; + +p5.Font.prototype._textDescent = function(fontSize) { + return -this.font.descender * this._scale(fontSize); +}; + +p5.Font.prototype._scale = function(fontSize) { + return ( + 1 / this.font.unitsPerEm * (fontSize || this.parent._renderer._textSize) + ); +}; + +p5.Font.prototype._handleAlignment = function(renderer, line, x, y, textWidth) { + var fontSize = renderer._textSize; + + if (typeof textWidth === 'undefined') { + textWidth = this._textWidth(line, fontSize); + } + + switch (renderer._textAlign) { + case constants.CENTER: + x -= textWidth / 2; + break; + case constants.RIGHT: + x -= textWidth; + break; + } + + switch (renderer._textBaseline) { + case constants.TOP: + y += this._textAscent(fontSize); + break; + case constants.CENTER: + y += this._textAscent(fontSize) / 2; + break; + case constants.BOTTOM: + y -= this._textDescent(fontSize); + break; + } + + return { x: x, y: y }; +}; + +// 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) { + simplify(pts, opts.simplifyThreshold); + } + + 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) { + // console.warn("Unexpected state: undefined pathArray"); // shouldn't happen + return res; + } + 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); + var attrs = { x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null }; + var attrs2 = { x: 0, y: 0, bx: 0, by: 0, X: 0, Y: 0, qx: null, qy: null }; + var pcoms1 = []; // path commands of original path p + var pcoms2 = []; // path commands of original path p2 + var ii; + + var processPath = function(path, d, pcom) { + var nx, + ny, + tq = { T: 1, Q: 1 }; + if (!path) { + return ['C', d.x, d.y, d.x, d.y, d.x, d.y]; + } + if (!(path[0] in tq)) { + d.qx = d.qy = null; + } + switch (path[0]) { + case 'M': + d.X = path[1]; + 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); + } + }; + + var pfirst = ''; // temporary holder for original path command + var pcom = ''; // holder for previous path command of original path + + ii = Math.max(p.length, (p2 && p2.length) || 0); + for (var i = 0; i < ii; i++) { + if (p[i]) { + pfirst = p[i][0]; + } // save current path command + + if (pfirst !== 'C') { + pcoms1[i] = pfirst; // Save current path command + if (i) { + pcom = pcoms1[i - 1]; + } // Get previous path command pcom + } + 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; + var k = + (lac === sweep_flag ? -1 : 1) * + Math.sqrt( + Math.abs( + (rx2 * ry2 - rx2 * y * y - ry2 * x * x) / (rx2 * y * y + ry2 * x * x) + ) + ); + + cx = k * rx * y / ry + (x1 + x2) / 2; + cy = k * -ry * x / rx + (y1 + y2) / 2; + 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; + var n = 12; + var Tvalues = [ + -0.1252, + 0.1252, + -0.3678, + 0.3678, + -0.5873, + 0.5873, + -0.7699, + 0.7699, + -0.9041, + 0.9041, + -0.9816, + 0.9816 + ]; + + var sum = 0; + var Cvalues = [ + 0.2491, + 0.2491, + 0.2335, + 0.2335, + 0.2032, + 0.2032, + 0.1601, + 0.1601, + 0.1069, + 0.1069, + 0.0472, + 0.0472 + ]; + + for (var i = 0; i < n; i++) { + var ct = z2 * Tvalues[i] + z2, + xbase = base3(ct, x1, x2, x3, x4), + 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 hash = ''; + for (var i = arguments.length - 1; i >= 0; --i) { + hash += '？' + arguments[i]; + } + return hash; +} + +module.exports = p5; + +},{"../core/constants":18,"../core/main":24}],60:[function(_dereq_,module,exports){ +/** + * @module Data + * @submodule Array Functions + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * Adds a value to the end of an array. Extends the length of + * the array by one. Maps to Array.push(). + * + * @method append + * @deprecated Use array.push(value) instead. + * @param {Array} array Array to append + * @param {any} value to be added to the Array + * @return {Array} the array that was appended to + * @example + *
    + * function setup() { + * var myArray = ['Mango', 'Apple', 'Papaya']; + * print(myArray); // ['Mango', 'Apple', 'Papaya'] + * + * 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 + * @deprecated + * @param {Array} src the source Array + * @param {Integer} srcPosition starting position in the source Array + * @param {Array} dst the destination Array + * @param {Integer} dstPosition starting position in the destination Array + * @param {Integer} length number of Array elements to be copied + * + * @example + *
    + * var src = ['A', 'B', 'C']; + * var dst = [1, 2, 3]; + * var srcPosition = 1; + * var dstPosition = 0; + * var length = 2; + * + * print(src); // ['A', 'B', 'C'] + * print(dst); // [ 1 , 2 , 3 ] + * + * arrayCopy(src, srcPosition, dst, dstPosition, length); + * print(dst); // ['B', 'C', 3] + *
    + */ +/** + * @method arrayCopy + * @deprecated Use arr1.copyWithin(arr2) instead. + * @param {Array} src + * @param {Array} dst + * @param {Integer} [length] + */ +p5.prototype.arrayCopy = function(src, srcPosition, dst, dstPosition, length) { + // the index to begin splicing from dst array + var start; + var end; + + if (typeof length !== 'undefined') { + end = Math.min(length, src.length); + start = dstPosition; + src = src.slice(srcPosition, end + srcPosition); + } else { + if (typeof dst !== 'undefined') { + // src, dst, length + // 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 + * @deprecated Use arr1.concat(arr2) instead. + * @param {Array} a first Array to concatenate + * @param {Array} b second Array to concatenate + * @return {Array} concatenated array + * + * @example + *
    + * function setup() { + * var arr1 = ['A', 'B', 'C']; + * var arr2 = [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 + * @deprecated Use array.reverse() instead. + * @param {Array} list Array to reverse + * @return {Array} the reversed list + * @example + *
    + * function setup() { + * var myArray = ['A', 'B', 'C']; + * print(myArray); // ['A','B','C'] + * + * reverse(myArray); + * print(myArray); // ['C','B','A'] + * } + *
    + */ +p5.prototype.reverse = function(list) { + return list.reverse(); +}; + +/** + * Decreases an array by one element and returns the shortened array, + * maps to Array.pop(). + * + * @method shorten + * @deprecated Use array.pop() instead. + * @param {Array} list Array to shorten + * @return {Array} shortened Array + * @example + *
    + * function setup() { + * var myArray = ['A', 'B', 'C']; + * print(myArray); // ['A', 'B', 'C'] + * var newArray = shorten(myArray); + * print(myArray); // ['A','B','C'] + * print(newArray); // ['A','B'] + * } + *
    + */ +p5.prototype.shorten = function(list) { + list.pop(); + return list; +}; + +/** + * Randomizes the order of the elements of an array. Implements + * + * Fisher-Yates Shuffle Algorithm. + * + * @method shuffle + * @param {Array} array Array to shuffle + * @param {Boolean} [bool] modify passed array + * @return {Array} shuffled Array + * @example + *
    + * function setup() { + * var regularArr = ['ABC', 'def', createVector(), TAU, Math.E]; + * print(regularArr); + * shuffle(regularArr, true); // force modifications to passed array + * print(regularArr); + * + * // By default shuffle() returns a shuffled cloned array: + * var newArr = shuffle(regularArr); + * print(regularArr); + * print(newArr); + * } + *
    + */ +p5.prototype.shuffle = function(arr, bool) { + var isView = ArrayBuffer && ArrayBuffer.isView && ArrayBuffer.isView(arr); + arr = bool || isView ? arr : arr.slice(); + + var rnd, + tmp, + idx = arr.length; + while (idx > 1) { + rnd = (Math.random() * idx) | 0; + + tmp = arr[--idx]; + arr[idx] = arr[rnd]; + arr[rnd] = tmp; + } + + return arr; +}; + +/** + * Sorts an array of numbers from smallest to largest, or puts an array of + * words in alphabetical order. The original array is not modified; a + * re-ordered array is returned. The count parameter states the number of + * elements to sort. For example, if there are 12 elements in an array and + * count is set to 5, only the first 5 elements in the array will be sorted. + * + * @method sort + * @deprecated Use array.sort() instead. + * @param {Array} list Array to sort + * @param {Integer} [count] number of elements to sort, starting from 0 + * @return {Array} the sorted list + * + * @example + *
    + * function setup() { + * var words = ['banana', 'apple', 'pear', 'lime']; + * print(words); // ['banana', 'apple', 'pear', 'lime'] + * var count = 4; // length of array + * + * words = sort(words, count); + * print(words); // ['apple', 'banana', 'lime', 'pear'] + * } + *
    + *
    + * function setup() { + * var numbers = [2, 6, 1, 5, 14, 9, 8, 12]; + * print(numbers); // [2, 6, 1, 5, 14, 9, 8, 12] + * var count = 5; // Less than the length of the array + * + * numbers = sort(numbers, count); + * print(numbers); // [1,2,5,6,14,9,8,12] + * } + *
    + */ +p5.prototype.sort = function(list, count) { + var arr = count ? list.slice(0, Math.min(count, list.length)) : list; + var rest = count ? list.slice(Math.min(count, list.length)) : []; + if (typeof arr[0] === 'string') { + arr = arr.sort(); + } else { + arr = arr.sort(function(a, b) { + return a - b; + }); + } + return arr.concat(rest); +}; + +/** + * Inserts a value or an array of values into an existing array. The first + * parameter specifies the initial array to be modified, and the second + * parameter defines the data to be inserted. The third parameter is an index + * value which specifies the array position from which to insert data. + * (Remember that array index numbering starts at zero, so the first position + * is 0, the second position is 1, and so on.) + * + * @method splice + * @deprecated Use array.splice() instead. + * @param {Array} list Array to splice into + * @param {any} value value to be spliced in + * @param {Integer} position in the array from which to insert data + * @return {Array} the list + * + * @example + *
    + * function setup() { + * var myArray = [0, 1, 2, 3, 4]; + * var insArray = ['A', 'B', 'C']; + * print(myArray); // [0, 1, 2, 3, 4] + * print(insArray); // ['A','B','C'] + * + * splice(myArray, insArray, 3); + * print(myArray); // [0,1,2,'A','B','C',3,4] + * } + *
    + */ +p5.prototype.splice = function(list, value, index) { + // note that splice returns spliced elements and not an array + Array.prototype.splice.apply(list, [index, 0].concat(value)); + + return list; +}; + +/** + * Extracts an array of elements from an existing array. The list parameter + * defines the array from which the elements will be copied, and the start + * and count parameters specify which elements to extract. If no count is + * given, elements will be extracted from the start to the end of the array. + * When specifying the start, remember that the first array element is 0. + * This function does not change the source array. + * + * @method subset + * @deprecated Use array.slice() instead. + * @param {Array} list Array to extract from + * @param {Integer} start position to begin + * @param {Integer} [count] number of values to extract + * @return {Array} Array of extracted elements + * + * @example + *
    + * function setup() { + * var myArray = [1, 2, 3, 4, 5]; + * print(myArray); // [1, 2, 3, 4, 5] + * + * var sub1 = subset(myArray, 0, 3); + * var sub2 = subset(myArray, 2, 2); + * print(sub1); // [1,2,3] + * print(sub2); // [3,4] + * } + *
    + */ +p5.prototype.subset = function(list, start, count) { + if (typeof count !== 'undefined') { + return list.slice(start, start + count); + } else { + return list.slice(start, list.length); + } +}; + +module.exports = p5; + +},{"../core/main":24}],61:[function(_dereq_,module,exports){ +/** + * @module Data + * @submodule Conversion + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * Converts a string to its floating point representation. The contents of a + * string must resemble a number, or NaN (not a number) will be returned. + * For example, float("1234.56") evaluates to 1234.56, but float("giraffe") + * will return NaN. + * + * When an array of values is passed in, then an array of floats of the same + * length is returned. + * + * @method float + * @param {String} str float string to parse + * @return {Number} floating point representation of string + * @example + *
    + * var str = '20'; + * var diameter = float(str); + * ellipse(width / 2, height / 2, diameter, diameter); + *
    + *
    + * print(float('10.31')); // 10.31 + * print(float('Infinity')); // Infinity + * print(float('-Infinity')); // -Infinity + *
    + * + * @alt + * 20 by 20 white ellipse in the center of the canvas + * + */ +p5.prototype.float = function(str) { + if (str instanceof Array) { + return str.map(parseFloat); + } + return parseFloat(str); +}; + +/** + * Converts a boolean, string, or float to its integer representation. + * When an array of values is passed in, then an int array of the same length + * is returned. + * + * @method int + * @param {String|Boolean|Number} n value to parse + * @param {Integer} [radix] the radix to convert to (default: 10) + * @return {Number} integer representation of value + * + * @example + *
    + * print(int('10')); // 10 + * print(int(10.31)); // 10 + * print(int(-10)); // -10 + * print(int(true)); // 1 + * print(int(false)); // 0 + * print(int([false, true, '10.3', 9.8])); // [0, 1, 10, 9] + * print(int(Infinity)); // Infinity + * print(int('-Infinity')); // -Infinity + *
    + */ +/** + * @method int + * @param {Array} ns values to parse + * @return {Number[]} integer representation of values + */ +p5.prototype.int = function(n, radix) { + radix = radix || 10; + if (n === Infinity || n === 'Infinity') { + return Infinity; + } else if (n === -Infinity || n === '-Infinity') { + return -Infinity; + } else 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, true] + *
    + */ +p5.prototype.boolean = function(n) { + if (typeof n === 'number') { + return n !== 0; + } else if (typeof n === 'string') { + return n.toLowerCase() === 'true'; + } else if (typeof n === 'boolean') { + return n; + } else if (n instanceof Array) { + return n.map(p5.prototype.boolean); + } +}; + +/** + * Converts a number, string representation of a number, or boolean to its byte + * representation. A byte can be only a whole number between -128 and 127, so + * when a value outside of this range is converted, it wraps around to the + * corresponding byte representation. When an array of number, string or boolean + * values is passed in, then an array of bytes the same length is returned. + * + * @method byte + * @param {String|Boolean|Number} n value to parse + * @return {Number} byte representation of value + * + * @example + *
    + * print(byte(127)); // 127 + * print(byte(128)); // -128 + * print(byte(23.4)); // 23 + * print(byte('23.4')); // 23 + * print(byte('hello')); // NaN + * print(byte(true)); // 1 + * print(byte([0, 255, '100'])); // [0, -1, 100] + *
    + */ +/** + * @method byte + * @param {Array} ns values to parse + * @return {Number[]} array of byte representation of values + */ +p5.prototype.byte = function(n) { + var nn = p5.prototype.int(n, 10); + if (typeof nn === 'number') { + return (nn + 128) % 256 - 128; + } else if (nn instanceof Array) { + return nn.map(p5.prototype.byte); + } +}; + +/** + * Converts a number or string to its corresponding single-character + * string representation. If a string parameter is provided, it is first + * parsed as an integer and then translated into a single-character string. + * When an array of number or string values is passed in, then an array of + * single-character strings of the same length is returned. + * + * @method char + * @param {String|Number} n value to parse + * @return {String} string representation of value + * + * @example + *
    + * print(char(65)); // "A" + * print(char('65')); // "A" + * print(char([65, 66, 67])); // [ "A", "B", "C" ] + * print(join(char([65, 66, 67]), '')); // "ABC" + *
    + */ +/** + * @method char + * @param {Array} ns values to parse + * @return {String[]} array of string representation of values + */ +p5.prototype.char = function(n) { + if (typeof n === 'number' && !isNaN(n)) { + return String.fromCharCode(n); + } else if (n instanceof Array) { + return n.map(p5.prototype.char); + } else if (typeof n === 'string') { + return p5.prototype.char(parseInt(n, 10)); + } +}; + +/** + * Converts a single-character string to its corresponding integer + * representation. When an array of single-character string values is passed + * in, then an array of integers of the same length is returned. + * + * @method unchar + * @param {String} n value to parse + * @return {Number} integer representation of value + * + * @example + *
    + * print(unchar('A')); // 65 + * print(unchar(['A', 'B', 'C'])); // [ 65, 66, 67 ] + * print(unchar(split('ABC', ''))); // [ 65, 66, 67 ] + *
    + */ +/** + * @method unchar + * @param {Array} ns values to parse + * @return {Number[]} integer representation of values + */ +p5.prototype.unchar = function(n) { + if (typeof n === 'string' && n.length === 1) { + return n.charCodeAt(0); + } else if (n instanceof Array) { + return n.map(p5.prototype.unchar); + } +}; + +/** + * Converts a number to a string in its equivalent hexadecimal notation. If a + * second parameter is passed, it is used to set the number of characters to + * generate in the hexadecimal notation. When an array is passed in, an + * array of strings in hexadecimal notation of the same length is returned. + * + * @method hex + * @param {Number} n value to parse + * @param {Number} [digits] + * @return {String} hexadecimal string representation of value + * + * @example + *
    + * print(hex(255)); // "000000FF" + * print(hex(255, 6)); // "0000FF" + * print(hex([0, 127, 255], 6)); // [ "000000", "00007F", "0000FF" ] + * print(Infinity); // "FFFFFFFF" + * print(-Infinity); // "00000000" + *
    + */ +/** + * @method hex + * @param {Number[]} ns array of values to parse + * @param {Number} [digits] + * @return {String[]} hexadecimal string representation of values + */ +p5.prototype.hex = function(n, digits) { + digits = digits === undefined || digits === null ? (digits = 8) : digits; + if (n instanceof Array) { + return n.map(function(n) { + return p5.prototype.hex(n, digits); + }); + } else if (n === Infinity || n === -Infinity) { + var c = n === Infinity ? 'F' : '0'; + return c.repeat(digits); + } else if (typeof n === 'number') { + if (n < 0) { + n = 0xffffffff + n + 1; + } + var hex = Number(n) + .toString(16) + .toUpperCase(); + while (hex.length < digits) { + hex = '0' + hex; + } + if (hex.length >= digits) { + hex = hex.substring(hex.length - digits, hex.length); + } + return hex; + } +}; + +/** + * Converts a string representation of a hexadecimal number to its equivalent + * integer value. When an array of strings in hexadecimal notation is passed + * in, an array of integers of the same length is returned. + * + * @method unhex + * @param {String} n value to parse + * @return {Number} integer representation of hexadecimal value + * + * @example + *
    + * print(unhex('A')); // 10 + * print(unhex('FF')); // 255 + * print(unhex(['FF', 'AA', '00'])); // [ 255, 170, 0 ] + *
    + */ +/** + * @method unhex + * @param {Array} ns values to parse + * @return {Number[]} integer representations of hexadecimal value + */ +p5.prototype.unhex = function(n) { + if (n instanceof Array) { + return n.map(p5.prototype.unhex); + } else { + return parseInt('0x' + n, 16); + } +}; + +module.exports = p5; + +},{"../core/main":24}],62:[function(_dereq_,module,exports){ +/** + * @module Data + * @submodule String Functions + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +_dereq_('../core/error_helpers'); + +//return p5; //LM is this a mistake? + +/** + * Combines an array of Strings into one String, each separated by the + * character(s) used for the separator parameter. To join arrays of ints or + * floats, it's necessary to first convert them to Strings using nf() or + * nfs(). + * + * @method join + * @param {Array} list array of Strings to be joined + * @param {String} separator String to be placed between each item + * @return {String} joined String + * @example + *
    + * + * var array = ['Hello', 'world!']; + * var separator = ' '; + * var message = join(array, separator); + * text(message, 5, 50); + * + *
    + * + * @alt + * "hello world!" displayed middle left of canvas. + * + */ +p5.prototype.join = function(list, separator) { + p5._validateParameters('join', arguments); + 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 {String[]} Array of Strings found + * @example + *
    + * + * var string = 'Hello p5js*!'; + * var regexp = 'p5js\\*'; + * var m = match(string, regexp); + * text(m, 5, 50); + * + *
    + * + * @alt + * "p5js*" displayed middle left of canvas. + * + */ +p5.prototype.match = function(str, reg) { + p5._validateParameters('match', arguments); + 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 {String[]} 2d Array of Strings found + * @example + *
    + * + * var string = 'Hello p5js*! Hello world!'; + * var regexp = 'Hello'; + * matchAll(string, regexp); + * + *
    + */ +p5.prototype.matchAll = function(str, reg) { + p5._validateParameters('matchAll', arguments); + var re = new RegExp(reg, 'g'); + var match = re.exec(str); + var matches = []; + while (match !== null) { + matches.push(match); + // matched text: match[0] + // match start: match.index + // capturing group n: match[n] + match = re.exec(str); + } + return matches; +}; + +/** + * 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. + * (NOTE): Be cautious when using left and right parameters as it prepends numbers of 0's if the parameter + * if greater than the current length of the number. + * For example if number is 123.2 and left parameter passed is 4 which is greater than length of 123 + * (integer part) i.e 3 than result will be 0123.2. Same case for right parameter i.e. if right is 3 than + * the result will be 123.200. + * + * @method nf + * @param {Number|String} num the Number to format + * @param {Integer|String} [left] number of digits to the left of the + * decimal point + * @param {Integer|String} [right] number of digits to the right of the + * decimal point + * @return {String} formatted String + * + * @example + *
    + * + * var myFont; + * function preload() { + * myFont = loadFont('assets/fonts/inconsolata.ttf'); + * } + * function setup() { + * background(200); + * var num1 = 321; + * var num2 = -1321; + * + * noStroke(); + * fill(0); + * textFont(myFont); + * textSize(22); + * + * text(nf(num1, 4, 2), 10, 30); + * text(nf(num2, 4, 2), 10, 80); + * // Draw dividing line + * stroke(120); + * line(0, 50, width, 50); + * } + * + *
    + * + * @alt + * "0321.00" middle top, -1321.00" middle bottom canvas + */ +/** + * @method nf + * @param {Array} nums the Numbers to format + * @param {Integer|String} [left] + * @param {Integer|String} [right] + * @return {String[]} formatted Strings + */ +p5.prototype.nf = function(nums, left, right) { + p5._validateParameters('nf', arguments); + if (nums instanceof Array) { + return nums.map(function(x) { + return doNf(x, left, right); + }); + } else { + var typeOfFirst = Object.prototype.toString.call(nums); + if (typeOfFirst === '[object Arguments]') { + if (nums.length === 3) { + return this.nf(nums[0], nums[1], nums[2]); + } else if (nums.length === 2) { + return this.nf(nums[0], nums[1]); + } else { + return this.nf(nums[0]); + } + } else { + return doNf(nums, left, right); + } + } +}; + +function doNf(num, left, right) { + var neg = num < 0; + var n = neg ? num.toString().substring(1) : num.toString(); + var decimalInd = n.indexOf('.'); + var intPart = decimalInd !== -1 ? n.substring(0, decimalInd) : n; + var decPart = decimalInd !== -1 ? n.substring(decimalInd + 1) : ''; + var str = neg ? '-' : ''; + if (typeof right !== 'undefined') { + var decimal = ''; + if (decimalInd !== -1 || right - decPart.length > 0) { + decimal = '.'; + } + if (decPart.length > right) { + decPart = decPart.substring(0, right); + } + for (var i = 0; i < left - intPart.length; i++) { + str += '0'; + } + str += intPart; + str += decimal; + str += decPart; + for (var j = 0; j < right - decPart.length; j++) { + str += '0'; + } + return str; + } else { + for (var k = 0; k < Math.max(left - intPart.length, 0); k++) { + str += '0'; + } + str += n; + return str; + } +} + +/** + * Utility function for formatting numbers into strings and placing + * appropriate commas to mark units of 1000. There are two versions: one + * for formatting ints, and one for formatting an array of ints. The value + * for the right parameter should always be a positive integer. + * + * @method nfc + * @param {Number|String} num the Number to format + * @param {Integer|String} [right] number of digits to the right of the + * decimal point + * @return {String} formatted String + * + * @example + *
    + * + * function setup() { + * background(200); + * var num = 11253106.115; + * var numArr = [1, 1, 2]; + * + * noStroke(); + * fill(0); + * textSize(12); + * + * // Draw formatted numbers + * text(nfc(num, 4), 10, 30); + * text(nfc(numArr, 2), 10, 80); + * + * // Draw dividing line + * stroke(120); + * line(0, 50, width, 50); + * } + * + *
    + * + * @alt + * "11,253,106.115" top middle and "1.00,1.00,2.00" displayed bottom mid + */ +/** + * @method nfc + * @param {Array} nums the Numbers to format + * @param {Integer|String} [right] + * @return {String[]} formatted Strings + */ +p5.prototype.nfc = function(num, right) { + p5._validateParameters('nfc', arguments); + if (num instanceof Array) { + return num.map(function(x) { + return doNfc(x, right); + }); + } else { + return doNfc(num, right); + } +}; +function doNfc(num, right) { + num = num.toString(); + var dec = num.indexOf('.'); + var rem = dec !== -1 ? num.substring(dec) : ''; + var n = dec !== -1 ? num.substring(0, dec) : num; + n = n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ','); + if (right === 0) { + rem = ''; + } else if (typeof right !== 'undefined') { + if (right > rem.length) { + rem += dec === -1 ? '.' : ''; + var len = right - rem.length + 1; + for (var i = 0; i < len; i++) { + rem += '0'; + } + } else { + rem = rem.substring(0, right + 1); + } + } + return n + rem; +} + +/** + * Utility function for formatting numbers into strings. Similar to nf() but + * puts a "+" in front of positive numbers and a "-" in front of negative + * numbers. There are two versions: one for formatting floats, and one for + * formatting ints. The values for left, and right parameters + * should always be positive integers. + * + * @method nfp + * @param {Number} num the Number to format + * @param {Integer} [left] number of digits to the left of the decimal + * point + * @param {Integer} [right] number of digits to the right of the + * decimal point + * @return {String} formatted String + * + * @example + *
    + * + * function setup() { + * 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 + */ +/** + * @method nfp + * @param {Number[]} nums the Numbers to format + * @param {Integer} [left] + * @param {Integer} [right] + * @return {String[]} formatted Strings + */ +p5.prototype.nfp = function() { + p5._validateParameters('nfp', arguments); + var nfRes = p5.prototype.nf.apply(this, arguments); + if (nfRes instanceof Array) { + return nfRes.map(addNfp); + } else { + return addNfp(nfRes); + } +}; + +function addNfp(num) { + return parseFloat(num) > 0 ? '+' + num.toString() : num.toString(); +} + +/** + * Utility function for formatting numbers into strings. Similar to nf() but + * puts an additional "_" (space) in front of positive numbers just in case to align it with negative + * numbers which includes "-" (minus) sign. + * The main usecase of nfs() can be seen when one wants to align the digits (place values) of a positive + * number with some negative number (See the example to get a clear picture). + * There are two versions: one for formatting float, and one for formatting int. + * The values for the digits, left, and right parameters should always be positive integers. + * (IMP): The result on the canvas basically the expected alignment can vary based on the typeface you are using. + * (NOTE): Be cautious when using left and right parameters as it prepends numbers of 0's if the parameter + * if greater than the current length of the number. + * For example if number is 123.2 and left parameter passed is 4 which is greater than length of 123 + * (integer part) i.e 3 than result will be 0123.2. Same case for right parameter i.e. if right is 3 than + * the result will be 123.200. + * + * @method nfs + * @param {Number} num the Number to format + * @param {Integer} [left] number of digits to the left of the decimal + * point + * @param {Integer} [right] number of digits to the right of the + * decimal point + * @return {String} formatted String + * + * @example + *
    + * + * var myFont; + * function preload() { + * myFont = loadFont('assets/fonts/inconsolata.ttf'); + * } + * function setup() { + * background(200); + * var num1 = 321; + * var num2 = -1321; + * + * noStroke(); + * fill(0); + * textFont(myFont); + * textSize(22); + * + * // nfs() aligns num1 (positive number) with num2 (negative number) by + * // adding a blank space in front of the num1 (positive number) + * // [left = 4] in num1 add one 0 in front, to align the digits with num2 + * // [right = 2] in num1 and num2 adds two 0's after both numbers + * // To see the differences check the example of nf() too. + * 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 + * "0321.00" top middle and "-1321.00" displayed bottom middle + */ +/** + * @method nfs + * @param {Array} nums the Numbers to format + * @param {Integer} [left] + * @param {Integer} [right] + * @return {String[]} formatted Strings + */ +p5.prototype.nfs = function() { + p5._validateParameters('nfs', arguments); + var nfRes = p5.prototype.nf.apply(this, arguments); + if (nfRes instanceof Array) { + return nfRes.map(addNfs); + } else { + return addNfs(nfRes); + } +}; + +function addNfs(num) { + return parseFloat(num) > 0 ? ' ' + num.toString() : num.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 {String[]} 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) { + p5._validateParameters('split', arguments); + 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 {String[]} 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(value, delims) { + p5._validateParameters('splitTokens', arguments); + var d; + if (typeof delims !== 'undefined') { + var str = delims; + var sqc = /\]/g.exec(str); + var sqo = /\[/g.exec(str); + if (sqo && sqc) { + str = str.slice(0, sqc.index) + str.slice(sqc.index + 1); + sqo = /\[/g.exec(str); + str = str.slice(0, sqo.index) + str.slice(sqo.index + 1); + d = new RegExp('[\\[' + str + '\\]]', 'g'); + } else if (sqc) { + str = str.slice(0, sqc.index) + str.slice(sqc.index + 1); + d = new RegExp('[' + str + '\\]]', 'g'); + } else if (sqo) { + str = str.slice(0, sqo.index) + str.slice(sqo.index + 1); + d = new RegExp('[' + str + '\\[]', 'g'); + } else { + d = new RegExp('[' + str + ']', 'g'); + } + } else { + d = /\s/g; + } + return value.split(d).filter(function(n) { + return n; + }); +}; + +/** + * Removes whitespace characters from the beginning and end of a String. In + * addition to standard whitespace characters such as space, carriage return, + * and tab, this function also removes the Unicode "nbsp" character. + * + * @method trim + * @param {String} str a String to be trimmed + * @return {String} a trimmed String + * + * @example + *
    + * + * var string = trim(' No new lines\n '); + * text(string + ' here', 2, 50); + * + *
    + * + * @alt + * "No new lines here" displayed center canvas + */ +/** + * @method trim + * @param {Array} strs an Array of Strings to be trimmed + * @return {String[]} an Array of trimmed Strings + */ +p5.prototype.trim = function(str) { + p5._validateParameters('trim', arguments); + if (str instanceof Array) { + return str.map(this.trim); + } else { + return str.trim(); + } +}; + +module.exports = p5; + +},{"../core/error_helpers":20,"../core/main":24}],63:[function(_dereq_,module,exports){ +/** + * @module IO + * @submodule Time & Date + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * p5.js communicates with the clock on your computer. The day() function + * returns the current day as a value from 1 - 31. + * + * @method day + * @return {Integer} 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 {Integer} 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 {Integer} 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 {Integer} 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 {Integer} 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 {Integer} 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/main":24}],64:[function(_dereq_,module,exports){ +/** + * @module Shape + * @submodule 3D Primitives + * @for p5 + * @requires core + * @requires p5.Geometry + */ + +'use strict'; +var p5 = _dereq_('../core/main'); +_dereq_('./p5.Geometry'); +var constants = _dereq_('../core/constants'); + +/** + * Draw a plane with given a width and height + * @method plane + * @param {Number} [width] width of the plane + * @param {Number} [height] height of the plane + * @param {Integer} [detailX] Optional number of triangle + * subdivisions in x-dimension + * @param {Integer} [detailY] Optional number of triangle + * subdivisions in y-dimension + * @chainable + * @example + *
    + * + * // draw a plane + * // with width 50 and height 50 + * 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(width, height, detailX, detailY) { + this._assert3d('plane'); + p5._validateParameters('plane', arguments); + if (typeof width === 'undefined') { + width = 50; + } + if (typeof height === 'undefined') { + height = width; + } + + if (typeof detailX === 'undefined') { + detailX = 1; + } + if (typeof detailY === 'undefined') { + detailY = 1; + } + + var gId = 'plane|' + detailX + '|' + detailY; + + if (!this._renderer.geometryInHash(gId)) { + var _plane = function() { + var u, v, p; + for (var i = 0; i <= this.detailY; i++) { + v = i / this.detailY; + for (var j = 0; j <= this.detailX; j++) { + u = j / this.detailX; + p = new p5.Vector(u - 0.5, v - 0.5, 0); + this.vertices.push(p); + this.uvs.push(u, v); + } + } + }; + var planeGeom = new p5.Geometry(detailX, detailY, _plane); + planeGeom.computeFaces().computeNormals(); + if (detailX <= 1 && detailY <= 1) { + planeGeom._makeTriangleEdges()._edgesToVertices(); + } else { + console.log( + 'Cannot draw stroke on plane objects with more' + + ' than 1 detailX or 1 detailY' + ); + } + this._renderer.createBuffers(gId, planeGeom); + } + + this._renderer.drawBuffersScaled(gId, width, height, 1); + return this; +}; + +/** + * Draw a box with given width, height and depth + * @method box + * @param {Number} [width] width of the box + * @param {Number} [Height] height of the box + * @param {Number} [depth] depth of the box + * @param {Integer} [detailX] Optional number of triangle + * subdivisions in x-dimension + * @param {Integer} [detailY] Optional number of triangle + * subdivisions in y-dimension + * @chainable + * @example + *
    + * + * // draw a spinning box + * // with width, height and depth of 50 + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * box(50); + * } + * + *
    + */ +p5.prototype.box = function(width, height, depth, detailX, detailY) { + this._assert3d('box'); + p5._validateParameters('box', arguments); + if (typeof width === 'undefined') { + width = 50; + } + if (typeof height === 'undefined') { + height = width; + } + if (typeof depth === 'undefined') { + depth = height; + } + + var perPixelLighting = + this._renderer.attributes && this._renderer.attributes.perPixelLighting; + if (typeof detailX === 'undefined') { + detailX = perPixelLighting ? 1 : 4; + } + if (typeof detailY === 'undefined') { + detailY = perPixelLighting ? 1 : 4; + } + + var gId = 'box|' + detailX + '|' + detailY; + if (!this._renderer.geometryInHash(gId)) { + var _box = function() { + var cubeIndices = [ + [0, 4, 2, 6], // -1, 0, 0],// -x + [1, 3, 5, 7], // +1, 0, 0],// +x + [0, 1, 4, 5], // 0, -1, 0],// -y + [2, 6, 3, 7], // 0, +1, 0],// +y + [0, 2, 1, 3], // 0, 0, -1],// -z + [4, 5, 6, 7] // 0, 0, +1] // +z + ]; + //using strokeIndices instead of faces for strokes + //to avoid diagonal stroke lines across face of box + this.strokeIndices = [ + [0, 1], + [1, 3], + [3, 2], + [6, 7], + [8, 9], + [9, 11], + [14, 15], + [16, 17], + [17, 19], + [18, 19], + [20, 21], + [22, 23] + ]; + for (var i = 0; i < cubeIndices.length; i++) { + var cubeIndex = cubeIndices[i]; + var v = i * 4; + for (var j = 0; j < 4; j++) { + var d = cubeIndex[j]; + //inspired by lightgl: + //https://github.com/evanw/lightgl.js + //octants:https://en.wikipedia.org/wiki/Octant_(solid_geometry) + var octant = new p5.Vector( + ((d & 1) * 2 - 1) / 2, + ((d & 2) - 1) / 2, + ((d & 4) / 2 - 1) / 2 + ); + this.vertices.push(octant); + this.uvs.push(j & 1, (j & 2) / 2); + } + this.faces.push([v, v + 1, v + 2]); + this.faces.push([v + 2, v + 1, v + 3]); + } + }; + var boxGeom = new p5.Geometry(detailX, detailY, _box); + boxGeom.computeNormals(); + if (detailX <= 4 && detailY <= 4) { + boxGeom._makeTriangleEdges()._edgesToVertices(); + } else { + console.log( + 'Cannot draw stroke on box objects with more' + + ' than 4 detailX or 4 detailY' + ); + } + //initialize our geometry buffer with + //the key val pair: + //geometry Id, Geom object + this._renderer.createBuffers(gId, boxGeom); + } + this._renderer.drawBuffersScaled(gId, width, height, depth); + + return this; +}; + +/** + * Draw a sphere with given radius + * @method sphere + * @param {Number} [radius] radius of circle + * @param {Integer} [detailX] number of segments, + * the more segments the smoother geometry + * default is 24 + * @param {Integer} [detailY] number of segments, + * the more segments the smoother geometry + * default is 16 + * @chainable + * @example + *
    + * + * // draw a sphere with radius 40 + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * sphere(40); + * } + * + *
    + */ +p5.prototype.sphere = function(radius, detailX, detailY) { + this._assert3d('sphere'); + p5._validateParameters('sphere', arguments); + if (typeof radius === 'undefined') { + radius = 50; + } + if (typeof detailX === 'undefined') { + detailX = 24; + } + if (typeof detailY === 'undefined') { + detailY = 16; + } + + this.ellipsoid(radius, radius, radius, detailX, detailY); + + return this; +}; + +/** + * @private + * Helper function for creating both cones and cyllinders + * Will only generate well-defined geometry when bottomRadius, height > 0 + * and topRadius >= 0 + * If topRadius == 0, topCap should be false + */ +var _truncatedCone = function( + bottomRadius, + topRadius, + height, + detailX, + detailY, + bottomCap, + topCap +) { + bottomRadius = bottomRadius <= 0 ? 1 : bottomRadius; + topRadius = topRadius < 0 ? 0 : topRadius; + height = height <= 0 ? bottomRadius : height; + detailX = detailX < 3 ? 3 : detailX; + detailY = detailY < 1 ? 1 : detailY; + bottomCap = bottomCap === undefined ? true : bottomCap; + topCap = topCap === undefined ? topRadius !== 0 : topCap; + var start = bottomCap ? -2 : 0; + var end = detailY + (topCap ? 2 : 0); + //ensure constant slant for interior vertex normals + var slant = Math.atan2(bottomRadius - topRadius, height); + var sinSlant = Math.sin(slant); + var cosSlant = Math.cos(slant); + var yy, ii, jj; + for (yy = start; yy <= end; ++yy) { + var v = yy / detailY; + var y = height * v; + var ringRadius; + if (yy < 0) { + //for the bottomCap edge + y = 0; + v = 0; + ringRadius = bottomRadius; + } else if (yy > detailY) { + //for the topCap edge + y = height; + v = 1; + ringRadius = topRadius; + } else { + //for the middle + ringRadius = bottomRadius + (topRadius - bottomRadius) * v; + } + if (yy === -2 || yy === detailY + 2) { + //center of bottom or top caps + ringRadius = 0; + } + + y -= height / 2; //shift coordiate origin to the center of object + for (ii = 0; ii < detailX; ++ii) { + var u = ii / detailX; + var ur = 2 * Math.PI * u; + var sur = Math.sin(ur); + var cur = Math.cos(ur); + + //VERTICES + this.vertices.push(new p5.Vector(sur * ringRadius, y, cur * ringRadius)); + + //VERTEX NORMALS + var vertexNormal; + if (yy < 0) { + vertexNormal = new p5.Vector(0, -1, 0); + } else if (yy > detailY && topRadius) { + vertexNormal = new p5.Vector(0, 1, 0); + } else { + vertexNormal = new p5.Vector(sur * cosSlant, sinSlant, cur * cosSlant); + } + this.vertexNormals.push(vertexNormal); + //UVs + this.uvs.push(u, v); + } + } + + var startIndex = 0; + if (bottomCap) { + for (jj = 0; jj < detailX; ++jj) { + var nextjj = (jj + 1) % detailX; + this.faces.push([ + startIndex + jj, + startIndex + detailX + nextjj, + startIndex + detailX + jj + ]); + } + startIndex += detailX * 2; + } + for (yy = 0; yy < detailY; ++yy) { + for (ii = 0; ii < detailX; ++ii) { + var nextii = (ii + 1) % detailX; + this.faces.push([ + startIndex + ii, + startIndex + nextii, + startIndex + detailX + nextii + ]); + this.faces.push([ + startIndex + ii, + startIndex + detailX + nextii, + startIndex + detailX + ii + ]); + } + startIndex += detailX; + } + if (topCap) { + startIndex += detailX; + for (ii = 0; ii < detailX; ++ii) { + this.faces.push([ + startIndex + ii, + startIndex + (ii + 1) % detailX, + startIndex + detailX + ]); + } + } +}; + +/** + * Draw a cylinder with given radius and height + * @method cylinder + * @param {Number} [radius] radius of the surface + * @param {Number} [height] height of the cylinder + * @param {Integer} [detailX] number of segments, + * the more segments the smoother geometry + * default is 24 + * @param {Integer} [detailY] number of segments in y-dimension, + * the more segments the smoother geometry + * default is 1 + * @param {Boolean} [bottomCap] whether to draw the bottom of the cylinder + * @param {Boolean} [topCap] whether to draw the top of the cylinder + * @chainable + * @example + *
    + * + * // draw a spinning cylinder + * // with radius 20 and height 50 + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * rotateX(frameCount * 0.01); + * rotateZ(frameCount * 0.01); + * cylinder(20, 50); + * } + * + *
    + */ +p5.prototype.cylinder = function( + radius, + height, + detailX, + detailY, + bottomCap, + topCap +) { + this._assert3d('cylinder'); + p5._validateParameters('cylinder', arguments); + if (typeof radius === 'undefined') { + radius = 50; + } + if (typeof height === 'undefined') { + height = radius; + } + if (typeof detailX === 'undefined') { + detailX = 24; + } + if (typeof detailY === 'undefined') { + detailY = 1; + } + if (typeof topCap === 'undefined') { + topCap = true; + } + if (typeof bottomCap === 'undefined') { + bottomCap = true; + } + + var gId = + 'cylinder|' + detailX + '|' + detailY + '|' + bottomCap + '|' + topCap; + if (!this._renderer.geometryInHash(gId)) { + var cylinderGeom = new p5.Geometry(detailX, detailY); + _truncatedCone.call( + cylinderGeom, + 1, + 1, + 1, + detailX, + detailY, + bottomCap, + topCap + ); + // normals are computed in call to _truncatedCone + if (detailX <= 24 && detailY <= 16) { + cylinderGeom._makeTriangleEdges()._edgesToVertices(); + } else { + console.log( + 'Cannot draw stroke on cylinder objects with more' + + ' than 24 detailX or 16 detailY' + ); + } + this._renderer.createBuffers(gId, cylinderGeom); + } + + this._renderer.drawBuffersScaled(gId, radius, height, radius); + + 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 {Integer} [detailX] number of segments, + * the more segments the smoother geometry + * default is 24 + * @param {Integer} [detailY] number of segments, + * the more segments the smoother geometry + * default is 1 + * @param {Boolean} [cap] whether to draw the base of the cone + * @chainable + * @example + *
    + * + * // draw a spinning cone + * // with radius 40 and height 70 + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * rotateX(frameCount * 0.01); + * rotateZ(frameCount * 0.01); + * cone(40, 70); + * } + * + *
    + */ +p5.prototype.cone = function(radius, height, detailX, detailY, cap) { + this._assert3d('cone'); + p5._validateParameters('cone', arguments); + if (typeof radius === 'undefined') { + radius = 50; + } + if (typeof height === 'undefined') { + height = radius; + } + if (typeof detailX === 'undefined') { + detailX = 24; + } + if (typeof detailY === 'undefined') { + detailY = 1; + } + if (typeof cap === 'undefined') { + cap = true; + } + + var gId = 'cone|' + detailX + '|' + detailY + '|' + cap; + if (!this._renderer.geometryInHash(gId)) { + var coneGeom = new p5.Geometry(detailX, detailY); + _truncatedCone.call(coneGeom, 1, 0, 1, detailX, detailY, cap, false); + if (detailX <= 24 && detailY <= 16) { + coneGeom._makeTriangleEdges()._edgesToVertices(); + } else { + console.log( + 'Cannot draw stroke on cone objects with more' + + ' than 24 detailX or 16 detailY' + ); + } + this._renderer.createBuffers(gId, coneGeom); + } + + this._renderer.drawBuffersScaled(gId, radius, height, radius); + + return this; +}; + +/** + * Draw an ellipsoid with given radius + * @method ellipsoid + * @param {Number} [radiusx] x-radius of ellipsoid + * @param {Number} [radiusy] y-radius of ellipsoid + * @param {Number} [radiusz] z-radius of ellipsoid + * @param {Integer} [detailX] number of segments, + * the more segments the smoother geometry + * default is 24. Avoid detail number above + * 150, it may crash the browser. + * @param {Integer} [detailY] number of segments, + * the more segments the smoother geometry + * default is 16. Avoid detail number above + * 150, it may crash the browser. + * @chainable + * @example + *
    + * + * // draw an ellipsoid + * // with radius 30, 40 and 40. + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * ellipsoid(30, 40, 40); + * } + * + *
    + */ +p5.prototype.ellipsoid = function(radiusX, radiusY, radiusZ, detailX, detailY) { + this._assert3d('ellipsoid'); + p5._validateParameters('ellipsoid', arguments); + if (typeof radiusX === 'undefined') { + radiusX = 50; + } + if (typeof radiusY === 'undefined') { + radiusY = radiusX; + } + if (typeof radiusZ === 'undefined') { + radiusZ = radiusX; + } + + if (typeof detailX === 'undefined') { + detailX = 24; + } + if (typeof detailY === 'undefined') { + detailY = 16; + } + + var gId = 'ellipsoid|' + detailX + '|' + detailY; + + if (!this._renderer.geometryInHash(gId)) { + var _ellipsoid = function() { + for (var i = 0; i <= this.detailY; i++) { + var v = i / this.detailY; + var phi = Math.PI * v - Math.PI / 2; + var cosPhi = Math.cos(phi); + var sinPhi = Math.sin(phi); + + for (var j = 0; j <= this.detailX; j++) { + var u = j / this.detailX; + var theta = 2 * Math.PI * u; + var cosTheta = Math.cos(theta); + var sinTheta = Math.sin(theta); + var p = new p5.Vector(cosPhi * sinTheta, sinPhi, cosPhi * cosTheta); + this.vertices.push(p); + this.vertexNormals.push(p); + this.uvs.push(u, v); + } + } + }; + var ellipsoidGeom = new p5.Geometry(detailX, detailY, _ellipsoid); + ellipsoidGeom.computeFaces(); + if (detailX <= 24 && detailY <= 24) { + ellipsoidGeom._makeTriangleEdges()._edgesToVertices(); + } else { + console.log( + 'Cannot draw stroke on ellipsoids with more' + + ' than 24 detailX or 24 detailY' + ); + } + this._renderer.createBuffers(gId, ellipsoidGeom); + } + + this._renderer.drawBuffersScaled(gId, radiusX, radiusY, radiusZ); + + return this; +}; + +/** + * Draw a torus with given radius and tube radius + * @method torus + * @param {Number} [radius] radius of the whole ring + * @param {Number} [tubeRadius] radius of the tube + * @param {Integer} [detailX] number of segments in x-dimension, + * the more segments the smoother geometry + * default is 24 + * @param {Integer} [detailY] number of segments in y-dimension, + * the more segments the smoother geometry + * default is 16 + * @chainable + * @example + *
    + * + * // draw a spinning torus + * // with ring radius 30 and tube radius 15 + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * torus(30, 15); + * } + * + *
    + */ +p5.prototype.torus = function(radius, tubeRadius, detailX, detailY) { + this._assert3d('torus'); + p5._validateParameters('torus', arguments); + if (typeof radius === 'undefined') { + radius = 50; + } else if (!radius) { + return; // nothing to draw + } + + if (typeof tubeRadius === 'undefined') { + tubeRadius = 10; + } else if (!tubeRadius) { + return; // nothing to draw + } + + if (typeof detailX === 'undefined') { + detailX = 24; + } + if (typeof detailY === 'undefined') { + detailY = 16; + } + + var tubeRatio = (tubeRadius / radius).toPrecision(4); + var gId = 'torus|' + tubeRatio + '|' + detailX + '|' + detailY; + + if (!this._renderer.geometryInHash(gId)) { + var _torus = function() { + for (var i = 0; i <= this.detailY; i++) { + var v = i / this.detailY; + var phi = 2 * Math.PI * v; + var cosPhi = Math.cos(phi); + var sinPhi = Math.sin(phi); + var r = 1 + tubeRatio * cosPhi; + + for (var j = 0; j <= this.detailX; j++) { + var u = j / this.detailX; + var theta = 2 * Math.PI * u; + var cosTheta = Math.cos(theta); + var sinTheta = Math.sin(theta); + + var p = new p5.Vector(r * cosTheta, r * sinTheta, tubeRatio * sinPhi); + + var n = new p5.Vector(cosPhi * cosTheta, cosPhi * sinTheta, sinPhi); + + this.vertices.push(p); + this.vertexNormals.push(n); + this.uvs.push(u, v); + } + } + }; + var torusGeom = new p5.Geometry(detailX, detailY, _torus); + torusGeom.computeFaces(); + if (detailX <= 24 && detailY <= 16) { + torusGeom._makeTriangleEdges()._edgesToVertices(); + } else { + console.log( + 'Cannot draw strokes on torus object with more' + + ' than 24 detailX or 16 detailY' + ); + } + this._renderer.createBuffers(gId, torusGeom); + } + this._renderer.drawBuffersScaled(gId, radius, radius, radius); + + return this; +}; + +/////////////////////// +/// 2D primitives +///////////////////////// + +/** + * Draws a point, a coordinate in space at the dimension of one pixel, + * given x, y and z coordinates. The color of the point is determined + * by the current stroke, while the point size is determined by current + * stroke weight. + * @private + * @param {Number} x x-coordinate of point + * @param {Number} y y-coordinate of point + * @param {Number} z z-coordinate of point + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(50); + * stroke(255); + * strokeWeight(4); + * point(25, 0); + * strokeWeight(3); + * point(-25, 0); + * strokeWeight(2); + * point(0, 25); + * strokeWeight(1); + * point(0, -25); + * } + * + *
    + */ +p5.RendererGL.prototype.point = function(x, y, z) { + if (typeof z === 'undefined') { + z = 0; + } + + var _vertex = []; + _vertex.push(new p5.Vector(x, y, z)); + this._drawPoints(_vertex, this._pointVertexBuffer); + + return this; +}; + +p5.RendererGL.prototype.triangle = function(args) { + var x1 = args[0], + y1 = args[1]; + var x2 = args[2], + y2 = args[3]; + var x3 = args[4], + y3 = args[5]; + + var gId = 'tri'; + if (!this.geometryInHash(gId)) { + var _triangle = function() { + var vertices = []; + vertices.push(new p5.Vector(0, 0, 0)); + vertices.push(new p5.Vector(0, 1, 0)); + vertices.push(new p5.Vector(1, 0, 0)); + this.strokeIndices = [[0, 1], [1, 2], [2, 0]]; + this.vertices = vertices; + this.faces = [[0, 1, 2]]; + this.uvs = [0, 0, 0, 1, 1, 1]; + }; + var triGeom = new p5.Geometry(1, 1, _triangle); + triGeom._makeTriangleEdges()._edgesToVertices(); + triGeom.computeNormals(); + this.createBuffers(gId, triGeom); + } + + // only one triangle is cached, one point is at the origin, and the + // two adjacent sides are tne unit vectors along the X & Y axes. + // + // this matrix multiplication transforms those two unit vectors + // onto the required vector prior to rendering, and moves the + // origin appropriately. + var uMVMatrix = this.uMVMatrix.copy(); + try { + // prettier-ignore + var mult = new p5.Matrix([ + x2 - x1, y2 - y1, 0, 0, // the resulting unit X-axis + x3 - x1, y3 - y1, 0, 0, // the resulting unit Y-axis + 0, 0, 1, 0, // the resulting unit Z-axis (unchanged) + x1, y1, 0, 1 // the resulting origin + ]).mult(this.uMVMatrix); + + this.uMVMatrix = mult; + + this.drawBuffers(gId); + } finally { + this.uMVMatrix = uMVMatrix; + } + + return this; +}; + +p5.RendererGL.prototype.ellipse = function(args) { + this.arc( + args[0], + args[1], + args[2], + args[3], + 0, + constants.TWO_PI, + constants.OPEN, + args[4] + ); +}; + +p5.RendererGL.prototype.arc = function(args) { + var x = arguments[0]; + var y = arguments[1]; + var width = arguments[2]; + var height = arguments[3]; + var start = arguments[4]; + var stop = arguments[5]; + var mode = arguments[6]; + var detail = arguments[7] || 25; + + var shape; + var gId; + + // check if it is an ellipse or an arc + if (Math.abs(stop - start) >= constants.TWO_PI) { + shape = 'ellipse'; + gId = shape + '|' + detail + '|'; + } else { + shape = 'arc'; + gId = shape + '|' + start + '|' + stop + '|' + mode + '|' + detail + '|'; + } + + if (!this.geometryInHash(gId)) { + var _arc = function() { + this.strokeIndices = []; + + // if the start and stop angles are not the same, push vertices to the array + if (start.toFixed(10) !== stop.toFixed(10)) { + // if the mode specified is PIE or null, push the mid point of the arc in vertices + if (mode === constants.PIE || typeof mode === 'undefined') { + this.vertices.push(new p5.Vector(0.5, 0.5, 0)); + this.uvs.push([0.5, 0.5]); + } + + // vertices for the perimeter of the circle + for (var i = 0; i <= detail; i++) { + var u = i / detail; + var theta = (stop - start) * u + start; + + var _x = 0.5 + Math.cos(theta) / 2; + var _y = 0.5 + Math.sin(theta) / 2; + + this.vertices.push(new p5.Vector(_x, _y, 0)); + this.uvs.push([_x, _y]); + + if (i < detail - 1) { + this.faces.push([0, i + 1, i + 2]); + this.strokeIndices.push([i + 1, i + 2]); + } + } + + // check the mode specified in order to push vertices and faces, different for each mode + switch (mode) { + case constants.PIE: + this.faces.push([ + 0, + this.vertices.length - 2, + this.vertices.length - 1 + ]); + this.strokeIndices.push([0, 1]); + this.strokeIndices.push([ + this.vertices.length - 2, + this.vertices.length - 1 + ]); + this.strokeIndices.push([0, this.vertices.length - 1]); + break; + + case constants.CHORD: + this.strokeIndices.push([0, 1]); + this.strokeIndices.push([0, this.vertices.length - 1]); + break; + + case constants.OPEN: + this.strokeIndices.push([0, 1]); + break; + + default: + this.faces.push([ + 0, + this.vertices.length - 2, + this.vertices.length - 1 + ]); + this.strokeIndices.push([ + this.vertices.length - 2, + this.vertices.length - 1 + ]); + } + } + }; + + var arcGeom = new p5.Geometry(detail, 1, _arc); + arcGeom.computeNormals(); + + if (detail <= 50) { + arcGeom._makeTriangleEdges()._edgesToVertices(arcGeom); + } else { + console.log('Cannot stroke ' + shape + ' with more than 50 detail'); + } + + this.createBuffers(gId, arcGeom); + } + + var uMVMatrix = this.uMVMatrix.copy(); + + try { + this.uMVMatrix.translate([x, y, 0]); + this.uMVMatrix.scale(width, height, 1); + + this.drawBuffers(gId); + } finally { + this.uMVMatrix = uMVMatrix; + } + + return this; +}; + +p5.RendererGL.prototype.rect = function(args) { + var perPixelLighting = this._pInst._glAttributes.perPixelLighting; + var x = args[0]; + var y = args[1]; + var width = args[2]; + var height = args[3]; + var detailX = args[4] || (perPixelLighting ? 1 : 24); + var detailY = args[5] || (perPixelLighting ? 1 : 16); + var gId = 'rect|' + detailX + '|' + detailY; + if (!this.geometryInHash(gId)) { + var _rect = function() { + for (var i = 0; i <= this.detailY; i++) { + var v = i / this.detailY; + for (var j = 0; j <= this.detailX; j++) { + var u = j / this.detailX; + var p = new p5.Vector(u, v, 0); + this.vertices.push(p); + this.uvs.push(u, v); + } + } + // using stroke indices to avoid stroke over face(s) of rectangle + if (detailX > 0 && detailY > 0) { + this.strokeIndices = [ + [0, detailX], + [detailX, (detailX + 1) * (detailY + 1) - 1], + [(detailX + 1) * (detailY + 1) - 1, (detailX + 1) * detailY], + [(detailX + 1) * detailY, 0] + ]; + } + }; + var rectGeom = new p5.Geometry(detailX, detailY, _rect); + rectGeom + .computeFaces() + .computeNormals() + ._makeTriangleEdges() + ._edgesToVertices(); + this.createBuffers(gId, rectGeom); + } + + // only a single rectangle (of a given detail) is cached: a square with + // opposite corners at (0,0) & (1,1). + // + // before rendering, this square is scaled & moved to the required location. + var uMVMatrix = this.uMVMatrix.copy(); + try { + this.uMVMatrix.translate([x, y, 0]); + this.uMVMatrix.scale(width, height, 1); + + this.drawBuffers(gId); + } finally { + this.uMVMatrix = uMVMatrix; + } + return this; +}; + +// prettier-ignore +p5.RendererGL.prototype.quad = function(x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4) { + var gId = + 'quad|' + + x1 + + '|' + + y1 + + '|' + + z1 + + '|' + + x2 + + '|' + + y2 + + '|' + + z2 + + '|' + + x3 + + '|' + + y3 + + '|' + + z3 + + '|' + + x4 + + '|' + + y4 + + '|' + + z4; + if (!this.geometryInHash(gId)) { + var _quad = function() { + this.vertices.push(new p5.Vector(x1, y1, z1)); + this.vertices.push(new p5.Vector(x2, y2, z2)); + this.vertices.push(new p5.Vector(x3, y3, z3)); + this.vertices.push(new p5.Vector(x4, y4, z4)); + this.uvs.push(0, 0, 1, 0, 1, 1, 0, 1); + this.strokeIndices = [[0, 1], [1, 2], [2, 3], [3, 0]]; + }; + var quadGeom = new p5.Geometry(2, 2, _quad); + quadGeom + .computeNormals() + ._makeTriangleEdges() + ._edgesToVertices(); + quadGeom.faces = [[0, 1, 2], [2, 3, 0]]; + this.createBuffers(gId, quadGeom); + } + this.drawBuffers(gId); + return this; +}; + +//this implementation of bezier curve +//is based on Bernstein polynomial +// pretier-ignore +p5.RendererGL.prototype.bezier = function( + x1, + y1, + z1, // x2 + x2, // y2 + y2, // x3 + z2, // y3 + x3, // x4 + y3, // y4 + z3, + x4, + y4, + z4 +) { + if (arguments.length === 8) { + y4 = y3; + x4 = x3; + y3 = z2; + x3 = y2; + y2 = x2; + x2 = z1; + z1 = z2 = z3 = z4 = 0; + } + var bezierDetail = this._pInst._bezierDetail || 20; //value of Bezier detail + this.beginShape(); + for (var i = 0; i <= bezierDetail; i++) { + var c1 = Math.pow(1 - i / bezierDetail, 3); + var c2 = 3 * (i / bezierDetail) * Math.pow(1 - i / bezierDetail, 2); + var c3 = 3 * Math.pow(i / bezierDetail, 2) * (1 - i / bezierDetail); + var c4 = Math.pow(i / bezierDetail, 3); + this.vertex( + x1 * c1 + x2 * c2 + x3 * c3 + x4 * c4, + y1 * c1 + y2 * c2 + y3 * c3 + y4 * c4, + z1 * c1 + z2 * c2 + z3 * c3 + z4 * c4 + ); + } + this.endShape(); + return this; +}; + +// pretier-ignore +p5.RendererGL.prototype.curve = function( + x1, + y1, + z1, // x2 + x2, // y2 + y2, // x3 + z2, // y3 + x3, // x4 + y3, // y4 + z3, + x4, + y4, + z4 +) { + if (arguments.length === 8) { + x4 = x3; + y4 = y3; + x3 = y2; + y3 = x2; + x2 = z1; + y2 = x2; + z1 = z2 = z3 = z4 = 0; + } + var curveDetail = this._pInst._curveDetail; + this.beginShape(); + for (var i = 0; i <= curveDetail; i++) { + var c1 = Math.pow(i / curveDetail, 3) * 0.5; + var c2 = Math.pow(i / curveDetail, 2) * 0.5; + var c3 = i / curveDetail * 0.5; + var c4 = 0.5; + var vx = + c1 * (-x1 + 3 * x2 - 3 * x3 + x4) + + c2 * (2 * x1 - 5 * x2 + 4 * x3 - x4) + + c3 * (-x1 + x3) + + c4 * (2 * x2); + var vy = + c1 * (-y1 + 3 * y2 - 3 * y3 + y4) + + c2 * (2 * y1 - 5 * y2 + 4 * y3 - y4) + + c3 * (-y1 + y3) + + c4 * (2 * y2); + var vz = + c1 * (-z1 + 3 * z2 - 3 * z3 + z4) + + c2 * (2 * z1 - 5 * z2 + 4 * z3 - z4) + + c3 * (-z1 + z3) + + c4 * (2 * z2); + this.vertex(vx, vy, vz); + } + this.endShape(); + return this; +}; + +/** + * Draw a line given two points + * @private + * @param {Number} x0 x-coordinate of first vertex + * @param {Number} y0 y-coordinate of first vertex + * @param {Number} z0 z-coordinate of first vertex + * @param {Number} x1 x-coordinate of second vertex + * @param {Number} y1 y-coordinate of second vertex + * @param {Number} z1 z-coordinate of second vertex + * @chainable + * @example + *
    + * + * //draw a line + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * // Use fill instead of stroke to change the color of shape. + * fill(255, 0, 0); + * line(10, 10, 0, 60, 60, 20); + * } + * + *
    + */ +p5.RendererGL.prototype.line = function() { + if (arguments.length === 6) { + this.beginShape(); + this.vertex(arguments[0], arguments[1], arguments[2]); + this.vertex(arguments[3], arguments[4], arguments[5]); + this.endShape(); + } else if (arguments.length === 4) { + this.beginShape(); + this.vertex(arguments[0], arguments[1], 0); + this.vertex(arguments[2], arguments[3], 0); + this.endShape(); + } + return this; +}; + +p5.RendererGL.prototype.bezierVertex = function() { + if (this.immediateMode._bezierVertex.length === 0) { + throw Error('vertex() must be used once before calling bezierVertex()'); + } else { + var w_x = []; + var w_y = []; + var w_z = []; + var t, _x, _y, _z, i; + var argLength = arguments.length; + + t = 0; + + if ( + this._lookUpTableBezier.length === 0 || + this._lutBezierDetail !== this._pInst._curveDetail + ) { + this._lookUpTableBezier = []; + this._lutBezierDetail = this._pInst._curveDetail; + var step = 1 / this._lutBezierDetail; + var start = 0; + var end = 1; + var j = 0; + while (start < 1) { + t = parseFloat(start.toFixed(6)); + this._lookUpTableBezier[j] = this._bezierCoefficients(t); + if (end.toFixed(6) === step.toFixed(6)) { + t = parseFloat(end.toFixed(6)) + parseFloat(start.toFixed(6)); + ++j; + this._lookUpTableBezier[j] = this._bezierCoefficients(t); + break; + } + start += step; + end -= step; + ++j; + } + } + + var LUTLength = this._lookUpTableBezier.length; + + if (argLength === 6) { + this.isBezier = true; + + w_x = [ + this.immediateMode._bezierVertex[0], + arguments[0], + arguments[2], + arguments[4] + ]; + w_y = [ + this.immediateMode._bezierVertex[1], + arguments[1], + arguments[3], + arguments[5] + ]; + + for (i = 0; i < LUTLength; i++) { + _x = + w_x[0] * this._lookUpTableBezier[i][0] + + w_x[1] * this._lookUpTableBezier[i][1] + + w_x[2] * this._lookUpTableBezier[i][2] + + w_x[3] * this._lookUpTableBezier[i][3]; + _y = + w_y[0] * this._lookUpTableBezier[i][0] + + w_y[1] * this._lookUpTableBezier[i][1] + + w_y[2] * this._lookUpTableBezier[i][2] + + w_y[3] * this._lookUpTableBezier[i][3]; + this.vertex(_x, _y); + } + this.immediateMode._bezierVertex[0] = arguments[4]; + this.immediateMode._bezierVertex[1] = arguments[5]; + } else if (argLength === 9) { + this.isBezier = true; + + w_x = [ + this.immediateMode._bezierVertex[0], + arguments[0], + arguments[3], + arguments[6] + ]; + w_y = [ + this.immediateMode._bezierVertex[1], + arguments[1], + arguments[4], + arguments[7] + ]; + w_z = [ + this.immediateMode._bezierVertex[2], + arguments[2], + arguments[5], + arguments[8] + ]; + for (i = 0; i < LUTLength; i++) { + _x = + w_x[0] * this._lookUpTableBezier[i][0] + + w_x[1] * this._lookUpTableBezier[i][1] + + w_x[2] * this._lookUpTableBezier[i][2] + + w_x[3] * this._lookUpTableBezier[i][3]; + _y = + w_y[0] * this._lookUpTableBezier[i][0] + + w_y[1] * this._lookUpTableBezier[i][1] + + w_y[2] * this._lookUpTableBezier[i][2] + + w_y[3] * this._lookUpTableBezier[i][3]; + _z = + w_z[0] * this._lookUpTableBezier[i][0] + + w_z[1] * this._lookUpTableBezier[i][1] + + w_z[2] * this._lookUpTableBezier[i][2] + + w_z[3] * this._lookUpTableBezier[i][3]; + this.vertex(_x, _y, _z); + } + this.immediateMode._bezierVertex[0] = arguments[6]; + this.immediateMode._bezierVertex[1] = arguments[7]; + this.immediateMode._bezierVertex[2] = arguments[8]; + } + } +}; + +p5.RendererGL.prototype.quadraticVertex = function() { + if (this.immediateMode._quadraticVertex.length === 0) { + throw Error('vertex() must be used once before calling quadraticVertex()'); + } else { + var w_x = []; + var w_y = []; + var w_z = []; + var t, _x, _y, _z, i; + var argLength = arguments.length; + + t = 0; + + if ( + this._lookUpTableQuadratic.length === 0 || + this._lutQuadraticDetail !== this._pInst._curveDetail + ) { + this._lookUpTableQuadratic = []; + this._lutQuadraticDetail = this._pInst._curveDetail; + var step = 1 / this._lutQuadraticDetail; + var start = 0; + var end = 1; + var j = 0; + while (start < 1) { + t = parseFloat(start.toFixed(6)); + this._lookUpTableQuadratic[j] = this._quadraticCoefficients(t); + if (end.toFixed(6) === step.toFixed(6)) { + t = parseFloat(end.toFixed(6)) + parseFloat(start.toFixed(6)); + ++j; + this._lookUpTableQuadratic[j] = this._quadraticCoefficients(t); + break; + } + start += step; + end -= step; + ++j; + } + } + + var LUTLength = this._lookUpTableQuadratic.length; + + if (argLength === 4) { + this.isQuadratic = true; + + w_x = [ + this.immediateMode._quadraticVertex[0], + arguments[0], + arguments[2] + ]; + w_y = [ + this.immediateMode._quadraticVertex[1], + arguments[1], + arguments[3] + ]; + + for (i = 0; i < LUTLength; i++) { + _x = + w_x[0] * this._lookUpTableQuadratic[i][0] + + w_x[1] * this._lookUpTableQuadratic[i][1] + + w_x[2] * this._lookUpTableQuadratic[i][2]; + _y = + w_y[0] * this._lookUpTableQuadratic[i][0] + + w_y[1] * this._lookUpTableQuadratic[i][1] + + w_y[2] * this._lookUpTableQuadratic[i][2]; + this.vertex(_x, _y); + } + + this.immediateMode._quadraticVertex[0] = arguments[2]; + this.immediateMode._quadraticVertex[1] = arguments[3]; + } else if (argLength === 6) { + this.isQuadratic = true; + + w_x = [ + this.immediateMode._quadraticVertex[0], + arguments[0], + arguments[3] + ]; + w_y = [ + this.immediateMode._quadraticVertex[1], + arguments[1], + arguments[4] + ]; + w_z = [ + this.immediateMode._quadraticVertex[2], + arguments[2], + arguments[5] + ]; + + for (i = 0; i < LUTLength; i++) { + _x = + w_x[0] * this._lookUpTableQuadratic[i][0] + + w_x[1] * this._lookUpTableQuadratic[i][1] + + w_x[2] * this._lookUpTableQuadratic[i][2]; + _y = + w_y[0] * this._lookUpTableQuadratic[i][0] + + w_y[1] * this._lookUpTableQuadratic[i][1] + + w_y[2] * this._lookUpTableQuadratic[i][2]; + _z = + w_z[0] * this._lookUpTableQuadratic[i][0] + + w_z[1] * this._lookUpTableQuadratic[i][1] + + w_z[2] * this._lookUpTableQuadratic[i][2]; + this.vertex(_x, _y, _z); + } + + this.immediateMode._quadraticVertex[0] = arguments[3]; + this.immediateMode._quadraticVertex[1] = arguments[4]; + this.immediateMode._quadraticVertex[2] = arguments[5]; + } + } +}; + +p5.RendererGL.prototype.curveVertex = function() { + var w_x = []; + var w_y = []; + var w_z = []; + var t, _x, _y, _z, i; + t = 0; + var argLength = arguments.length; + + if ( + this._lookUpTableBezier.length === 0 || + this._lutBezierDetail !== this._pInst._curveDetail + ) { + this._lookUpTableBezier = []; + this._lutBezierDetail = this._pInst._curveDetail; + var step = 1 / this._lutBezierDetail; + var start = 0; + var end = 1; + var j = 0; + while (start < 1) { + t = parseFloat(start.toFixed(6)); + this._lookUpTableBezier[j] = this._bezierCoefficients(t); + if (end.toFixed(6) === step.toFixed(6)) { + t = parseFloat(end.toFixed(6)) + parseFloat(start.toFixed(6)); + ++j; + this._lookUpTableBezier[j] = this._bezierCoefficients(t); + break; + } + start += step; + end -= step; + ++j; + } + } + + var LUTLength = this._lookUpTableBezier.length; + + if (argLength === 2) { + this.immediateMode._curveVertex.push(arguments[0]); + this.immediateMode._curveVertex.push(arguments[1]); + if (this.immediateMode._curveVertex.length === 8) { + this.isCurve = true; + w_x = this._bezierToCatmull([ + this.immediateMode._curveVertex[0], + this.immediateMode._curveVertex[2], + this.immediateMode._curveVertex[4], + this.immediateMode._curveVertex[6] + ]); + w_y = this._bezierToCatmull([ + this.immediateMode._curveVertex[1], + this.immediateMode._curveVertex[3], + this.immediateMode._curveVertex[5], + this.immediateMode._curveVertex[7] + ]); + for (i = 0; i < LUTLength; i++) { + _x = + w_x[0] * this._lookUpTableBezier[i][0] + + w_x[1] * this._lookUpTableBezier[i][1] + + w_x[2] * this._lookUpTableBezier[i][2] + + w_x[3] * this._lookUpTableBezier[i][3]; + _y = + w_y[0] * this._lookUpTableBezier[i][0] + + w_y[1] * this._lookUpTableBezier[i][1] + + w_y[2] * this._lookUpTableBezier[i][2] + + w_y[3] * this._lookUpTableBezier[i][3]; + this.vertex(_x, _y); + } + for (i = 0; i < argLength; i++) { + this.immediateMode._curveVertex.shift(); + } + } + } else if (argLength === 3) { + this.immediateMode._curveVertex.push(arguments[0]); + this.immediateMode._curveVertex.push(arguments[1]); + this.immediateMode._curveVertex.push(arguments[2]); + if (this.immediateMode._curveVertex.length === 12) { + this.isCurve = true; + w_x = this._bezierToCatmull([ + this.immediateMode._curveVertex[0], + this.immediateMode._curveVertex[3], + this.immediateMode._curveVertex[6], + this.immediateMode._curveVertex[9] + ]); + w_y = this._bezierToCatmull([ + this.immediateMode._curveVertex[1], + this.immediateMode._curveVertex[4], + this.immediateMode._curveVertex[7], + this.immediateMode._curveVertex[10] + ]); + w_z = this._bezierToCatmull([ + this.immediateMode._curveVertex[2], + this.immediateMode._curveVertex[5], + this.immediateMode._curveVertex[8], + this.immediateMode._curveVertex[11] + ]); + for (i = 0; i < LUTLength; i++) { + _x = + w_x[0] * this._lookUpTableBezier[i][0] + + w_x[1] * this._lookUpTableBezier[i][1] + + w_x[2] * this._lookUpTableBezier[i][2] + + w_x[3] * this._lookUpTableBezier[i][3]; + _y = + w_y[0] * this._lookUpTableBezier[i][0] + + w_y[1] * this._lookUpTableBezier[i][1] + + w_y[2] * this._lookUpTableBezier[i][2] + + w_y[3] * this._lookUpTableBezier[i][3]; + _z = + w_z[0] * this._lookUpTableBezier[i][0] + + w_z[1] * this._lookUpTableBezier[i][1] + + w_z[2] * this._lookUpTableBezier[i][2] + + w_z[3] * this._lookUpTableBezier[i][3]; + this.vertex(_x, _y, _z); + } + for (i = 0; i < argLength; i++) { + this.immediateMode._curveVertex.shift(); + } + } + } +}; + +p5.RendererGL.prototype.image = function( + img, + sx, + sy, + sWidth, + sHeight, + dx, + dy, + dWidth, + dHeight +) { + this._pInst.push(); + + this._pInst.texture(img); + this._pInst.textureMode(constants.NORMAL); + + var u0 = 0; + if (sx <= img.width) { + u0 = sx / img.width; + } + + var u1 = 1; + if (sx + sWidth <= img.width) { + u1 = (sx + sWidth) / img.width; + } + + var v0 = 0; + if (sy <= img.height) { + v0 = sy / img.height; + } + + var v1 = 1; + if (sy + sHeight <= img.height) { + v1 = (sy + sHeight) / img.height; + } + + this.beginShape(); + this.vertex(dx, dy, 0, u0, v0); + this.vertex(dx + dWidth, dy, 0, u1, v0); + this.vertex(dx + dWidth, dy + dHeight, 0, u1, v1); + this.vertex(dx, dy + dHeight, 0, u0, v1); + this.endShape(constants.CLOSE); + + this._pInst.pop(); +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/main":24,"./p5.Geometry":70}],65:[function(_dereq_,module,exports){ +/** + * @module Lights, Camera + * @submodule Interaction + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); + +/** + * Allows movement around a 3D sketch using a mouse or trackpad. Left-clicking + * and dragging will rotate the camera position about the center of the sketch, + * right-clicking and dragging will pan the camera position without rotation, + * and using the mouse wheel (scrolling) will move the camera closer or further + * from the center of the sketch. This function can be called with parameters + * dictating sensitivity to mouse movement along the X and Y axes. Calling + * this function without parameters is equivalent to calling orbitControl(1,1). + * To reverse direction of movement in either axis, enter a negative number + * for sensitivity. + * @method orbitControl + * @for p5 + * @param {Number} [sensitivityX] sensitivity to mouse movement along X axis + * @param {Number} [sensitivityY] sensitivity to mouse movement along Y axis + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * } + * function draw() { + * background(200); + * orbitControl(); + * rotateY(0.5); + * box(30, 50); + * } + * + *
    + * + * @alt + * Camera orbits around a box when mouse is hold-clicked & then moved. + */ + +// implementation based on three.js 'orbitControls': +// https://github.com/mrdoob/three.js/blob/dev/examples/js/controls/OrbitControls.js +p5.prototype.orbitControl = function(sensitivityX, sensitivityY) { + this._assert3d('orbitControl'); + p5._validateParameters('orbitControl', arguments); + + // If the mouse is not in bounds of the canvas, disable all behaviors: + var mouseInCanvas = + this.mouseX < this.width && + this.mouseX > 0 && + this.mouseY < this.height && + this.mouseY > 0; + if (!mouseInCanvas) return; + + var cam = this._renderer._curCamera; + + if (typeof sensitivityX === 'undefined') { + sensitivityX = 1; + } + if (typeof sensitivityY === 'undefined') { + sensitivityY = sensitivityX; + } + + // default right-mouse and mouse-wheel behaviors (context menu and scrolling, + // respectively) are disabled here to allow use of those events for panning and + // zooming + + // disable context menu for canvas element and add 'contextMenuDisabled' + // flag to p5 instance + if (this.contextMenuDisabled !== true) { + this.canvas.oncontextmenu = function() { + return false; + }; + this._setProperty('contextMenuDisabled', true); + } + + // disable default scrolling behavior on the canvas element and add + // 'wheelDefaultDisabled' flag to p5 instance + if (this.wheelDefaultDisabled !== true) { + this.canvas.onwheel = function() { + return false; + }; + this._setProperty('wheelDefaultDisabled', true); + } + + var scaleFactor = this.height < this.width ? this.height : this.width; + + // ZOOM if there is a change in mouseWheelDelta + if (this._mouseWheelDeltaY !== this._pmouseWheelDeltaY) { + // zoom according to direction of mouseWheelDeltaY rather than value + if (this._mouseWheelDeltaY > 0) { + this._renderer._curCamera._orbit(0, 0, 0.5 * scaleFactor); + } else { + this._renderer._curCamera._orbit(0, 0, -0.5 * scaleFactor); + } + } + + if (this.mouseIsPressed) { + // ORBIT BEHAVIOR + if (this.mouseButton === this.LEFT) { + var deltaTheta = + -sensitivityX * (this.mouseX - this.pmouseX) / scaleFactor; + var deltaPhi = sensitivityY * (this.mouseY - this.pmouseY) / scaleFactor; + this._renderer._curCamera._orbit(deltaTheta, deltaPhi, 0); + } else if (this.mouseButton === this.RIGHT) { + // PANNING BEHAVIOR along X/Z camera axes and restricted to X/Z plane + // in world space + var local = cam._getLocalAxes(); + + // normalize portions along X/Z axes + var xmag = Math.sqrt(local.x[0] * local.x[0] + local.x[2] * local.x[2]); + if (xmag !== 0) { + local.x[0] /= xmag; + local.x[2] /= xmag; + } + + // normalize portions along X/Z axes + var ymag = Math.sqrt(local.y[0] * local.y[0] + local.y[2] * local.y[2]); + if (ymag !== 0) { + local.y[0] /= ymag; + local.y[2] /= ymag; + } + + // move along those vectors by amount controlled by mouseX, pmouseY + var dx = -1 * sensitivityX * (this.mouseX - this.pmouseX); + var dz = -1 * sensitivityY * (this.mouseY - this.pmouseY); + + // restrict movement to XZ plane in world space + cam.setPosition( + cam.eyeX + dx * local.x[0] + dz * local.z[0], + cam.eyeY, + cam.eyeZ + dx * local.x[2] + dz * local.z[2] + ); + } + } + return this; +}; + +/** + * debugMode() helps visualize 3D space by adding a grid to indicate where the + * ‘ground’ is in a sketch and an axes icon which indicates the +X, +Y, and +Z + * directions. This function can be called without parameters to create a + * default grid and axes icon, or it can be called according to the examples + * above to customize the size and position of the grid and/or axes icon. The + * grid is drawn using the most recently set stroke color and weight. To + * specify these parameters, add a call to stroke() and strokeWeight() + * just before the end of the draw() loop. + * + * By default, the grid will run through the origin (0,0,0) of the sketch + * along the XZ plane + * and the axes icon will be offset from the origin. Both the grid and axes + * icon will be sized according to the current canvas size. Note that because the + * grid runs parallel to the default camera view, it is often helpful to use + * debugMode along with orbitControl to allow full view of the grid. + * @method debugMode + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * camera(0, -30, 100, 0, 0, 0, 0, 1, 0); + * normalMaterial(); + * debugMode(); + * } + * + * function draw() { + * background(200); + * orbitControl(); + * box(15, 30); + * // Press the spacebar to turn debugMode off! + * if (keyIsDown(32)) { + * noDebugMode(); + * } + * } + * + *
    + * @alt + * a 3D box is centered on a grid in a 3D sketch. an icon + * indicates the direction of each axis: a red line points +X, + * a green line +Y, and a blue line +Z. the grid and icon disappear when the + * spacebar is pressed. + * + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * camera(0, -30, 100, 0, 0, 0, 0, 1, 0); + * normalMaterial(); + * debugMode(GRID); + * } + * + * function draw() { + * background(200); + * orbitControl(); + * box(15, 30); + * } + * + *
    + * @alt + * a 3D box is centered on a grid in a 3D sketch. + * + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * camera(0, -30, 100, 0, 0, 0, 0, 1, 0); + * normalMaterial(); + * debugMode(AXES); + * } + * + * function draw() { + * background(200); + * orbitControl(); + * box(15, 30); + * } + * + *
    + * @alt + * a 3D box is centered in a 3D sketch. an icon + * indicates the direction of each axis: a red line points +X, + * a green line +Y, and a blue line +Z. + * + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * camera(0, -30, 100, 0, 0, 0, 0, 1, 0); + * normalMaterial(); + * debugMode(GRID, 100, 10, 0, 0, 0); + * } + * + * function draw() { + * background(200); + * orbitControl(); + * box(15, 30); + * } + * + *
    + * @alt + * a 3D box is centered on a grid in a 3D sketch + * + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * camera(0, -30, 100, 0, 0, 0, 0, 1, 0); + * normalMaterial(); + * debugMode(100, 10, 0, 0, 0, 20, 0, -40, 0); + * } + * + * function draw() { + * noStroke(); + * background(200); + * orbitControl(); + * box(15, 30); + * // set the stroke color and weight for the grid! + * stroke(255, 0, 150); + * strokeWeight(0.8); + * } + * + *
    + * @alt + * a 3D box is centered on a grid in a 3D sketch. an icon + * indicates the direction of each axis: a red line points +X, + * a green line +Y, and a blue line +Z. + */ + +/** + * @method debugMode + * @param {Constant} mode either GRID or AXES + */ + +/** + * @method debugMode + * @param {Constant} mode + * @param {Number} [gridSize] size of one side of the grid + * @param {Number} [gridDivisions] number of divisions in the grid + * @param {Number} [xOff] X axis offset from origin (0,0,0) + * @param {Number} [yOff] Y axis offset from origin (0,0,0) + * @param {Number} [zOff] Z axis offset from origin (0,0,0) + */ + +/** + * @method debugMode + * @param {Constant} mode + * @param {Number} [axesSize] size of axes icon + * @param {Number} [xOff] + * @param {Number} [yOff] + * @param {Number} [zOff] + */ + +/** + * @method debugMode + * @param {Number} [gridSize] + * @param {Number} [gridDivisions] + * @param {Number} [gridXOff] + * @param {Number} [gridYOff] + * @param {Number} [gridZOff] + * @param {Number} [axesSize] + * @param {Number} [axesXOff] + * @param {Number} [axesYOff] + * @param {Number} [axesZOff] + */ + +p5.prototype.debugMode = function() { + this._assert3d('debugMode'); + p5._validateParameters('debugMode', arguments); + + // start by removing existing 'post' registered debug methods + for (var i = this._registeredMethods.post.length - 1; i >= 0; i--) { + // test for equality... + if ( + this._registeredMethods.post[i].toString() === this._grid().toString() || + this._registeredMethods.post[i].toString() === this._axesIcon().toString() + ) { + this._registeredMethods.post.splice(i, 1); + } + } + + // then add new debugMode functions according to the argument list + if (arguments[0] === constants.GRID) { + this.registerMethod( + 'post', + this._grid.call( + this, + arguments[1], + arguments[2], + arguments[3], + arguments[4], + arguments[5] + ) + ); + } else if (arguments[0] === constants.AXES) { + this.registerMethod( + 'post', + this._axesIcon.call( + this, + arguments[1], + arguments[2], + arguments[3], + arguments[4] + ) + ); + } else { + this.registerMethod( + 'post', + this._grid.call( + this, + arguments[0], + arguments[1], + arguments[2], + arguments[3], + arguments[4] + ) + ); + this.registerMethod( + 'post', + this._axesIcon.call( + this, + arguments[5], + arguments[6], + arguments[7], + arguments[8] + ) + ); + } +}; + +/** + * Turns off debugMode() in a 3D sketch. + * @method noDebugMode + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * camera(0, -30, 100, 0, 0, 0, 0, 1, 0); + * normalMaterial(); + * debugMode(); + * } + * + * function draw() { + * background(200); + * orbitControl(); + * box(15, 30); + * // Press the spacebar to turn debugMode off! + * if (keyIsDown(32)) { + * noDebugMode(); + * } + * } + * + *
    + * @alt + * a 3D box is centered on a grid in a 3D sketch. an icon + * indicates the direction of each axis: a red line points +X, + * a green line +Y, and a blue line +Z. the grid and icon disappear when the + * spacebar is pressed. + */ +p5.prototype.noDebugMode = function() { + this._assert3d('noDebugMode'); + + // start by removing existing 'post' registered debug methods + for (var i = this._registeredMethods.post.length - 1; i >= 0; i--) { + // test for equality... + if ( + this._registeredMethods.post[i].toString() === this._grid().toString() || + this._registeredMethods.post[i].toString() === this._axesIcon().toString() + ) { + this._registeredMethods.post.splice(i, 1); + } + } +}; + +/** + * For use with debugMode + * @private + * @method _grid + * @param {Number} [size] size of grid sides + * @param {Number} [div] number of grid divisions + * @param {Number} [xOff] offset of grid center from origin in X axis + * @param {Number} [yOff] offset of grid center from origin in Y axis + * @param {Number} [zOff] offset of grid center from origin in Z axis + */ +p5.prototype._grid = function(size, numDivs, xOff, yOff, zOff) { + if (typeof size === 'undefined') { + size = this.width / 2; + } + if (typeof numDivs === 'undefined') { + // ensure at least 2 divisions + numDivs = Math.round(size / 30) < 4 ? 4 : Math.round(size / 30); + } + if (typeof xOff === 'undefined') { + xOff = 0; + } + if (typeof yOff === 'undefined') { + yOff = 0; + } + if (typeof zOff === 'undefined') { + zOff = 0; + } + + var spacing = size / numDivs; + var halfSize = size / 2; + + return function() { + this.push(); + this.stroke( + this._renderer.curStrokeColor[0] * 255, + this._renderer.curStrokeColor[1] * 255, + this._renderer.curStrokeColor[2] * 255 + ); + this._renderer.uMVMatrix.set( + this._renderer._curCamera.cameraMatrix.mat4[0], + this._renderer._curCamera.cameraMatrix.mat4[1], + this._renderer._curCamera.cameraMatrix.mat4[2], + this._renderer._curCamera.cameraMatrix.mat4[3], + this._renderer._curCamera.cameraMatrix.mat4[4], + this._renderer._curCamera.cameraMatrix.mat4[5], + this._renderer._curCamera.cameraMatrix.mat4[6], + this._renderer._curCamera.cameraMatrix.mat4[7], + this._renderer._curCamera.cameraMatrix.mat4[8], + this._renderer._curCamera.cameraMatrix.mat4[9], + this._renderer._curCamera.cameraMatrix.mat4[10], + this._renderer._curCamera.cameraMatrix.mat4[11], + this._renderer._curCamera.cameraMatrix.mat4[12], + this._renderer._curCamera.cameraMatrix.mat4[13], + this._renderer._curCamera.cameraMatrix.mat4[14], + this._renderer._curCamera.cameraMatrix.mat4[15] + ); + + // Lines along X axis + for (var q = 0; q <= numDivs; q++) { + this.beginShape(this.LINES); + this.vertex(-halfSize + xOff, yOff, q * spacing - halfSize + zOff); + this.vertex(+halfSize + xOff, yOff, q * spacing - halfSize + zOff); + this.endShape(); + } + + // Lines along Z axis + for (var i = 0; i <= numDivs; i++) { + this.beginShape(this.LINES); + this.vertex(i * spacing - halfSize + xOff, yOff, -halfSize + zOff); + this.vertex(i * spacing - halfSize + xOff, yOff, +halfSize + zOff); + this.endShape(); + } + + this.pop(); + }; +}; + +/** + * For use with debugMode + * @private + * @method _axesIcon + * @param {Number} [size] size of axes icon lines + * @param {Number} [xOff] offset of icon from origin in X axis + * @param {Number} [yOff] offset of icon from origin in Y axis + * @param {Number} [zOff] offset of icon from origin in Z axis + */ +p5.prototype._axesIcon = function(size, xOff, yOff, zOff) { + if (typeof size === 'undefined') { + size = this.width / 20 > 40 ? this.width / 20 : 40; + } + if (typeof xOff === 'undefined') { + xOff = -this.width / 4; + } + if (typeof yOff === 'undefined') { + yOff = xOff; + } + if (typeof zOff === 'undefined') { + zOff = xOff; + } + + return function() { + this.push(); + this._renderer.uMVMatrix.set( + this._renderer._curCamera.cameraMatrix.mat4[0], + this._renderer._curCamera.cameraMatrix.mat4[1], + this._renderer._curCamera.cameraMatrix.mat4[2], + this._renderer._curCamera.cameraMatrix.mat4[3], + this._renderer._curCamera.cameraMatrix.mat4[4], + this._renderer._curCamera.cameraMatrix.mat4[5], + this._renderer._curCamera.cameraMatrix.mat4[6], + this._renderer._curCamera.cameraMatrix.mat4[7], + this._renderer._curCamera.cameraMatrix.mat4[8], + this._renderer._curCamera.cameraMatrix.mat4[9], + this._renderer._curCamera.cameraMatrix.mat4[10], + this._renderer._curCamera.cameraMatrix.mat4[11], + this._renderer._curCamera.cameraMatrix.mat4[12], + this._renderer._curCamera.cameraMatrix.mat4[13], + this._renderer._curCamera.cameraMatrix.mat4[14], + this._renderer._curCamera.cameraMatrix.mat4[15] + ); + + // X axis + this.strokeWeight(2); + this.stroke(255, 0, 0); + this.beginShape(this.LINES); + this.vertex(xOff, yOff, zOff); + this.vertex(xOff + size, yOff, zOff); + this.endShape(); + // Y axis + this.stroke(0, 255, 0); + this.beginShape(this.LINES); + this.vertex(xOff, yOff, zOff); + this.vertex(xOff, yOff + size, zOff); + this.endShape(); + // Z axis + this.stroke(0, 0, 255); + this.beginShape(this.LINES); + this.vertex(xOff, yOff, zOff); + this.vertex(xOff, yOff, zOff + size); + this.endShape(); + this.pop(); + }; +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/main":24}],66:[function(_dereq_,module,exports){ +/** + * @module Lights, Camera + * @submodule Lights + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * Creates an ambient light with a color + * + * @method ambientLight + * @param {Number} v1 red or hue value relative to + * the current color range + * @param {Number} v2 green or saturation value + * relative to the current color range + * @param {Number} v3 blue or brightness value + * relative to the current color range + * @param {Number} [alpha] the alpha value + * @chainable + * + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(0); + * ambientLight(150); + * ambientMaterial(250); + * noStroke(); + * sphere(40); + * } + * + *
    + * + * @alt + * evenly distributed light across a sphere + * + */ + +/** + * @method ambientLight + * @param {String} value a color string + * @chainable + */ + +/** + * @method ambientLight + * @param {Number} gray a gray value + * @param {Number} [alpha] + * @chainable + */ + +/** + * @method ambientLight + * @param {Number[]} values an array containing the red,green,blue & + * and alpha components of the color + * @chainable + */ + +/** + * @method ambientLight + * @param {p5.Color} color the ambient light color + * @chainable + */ +p5.prototype.ambientLight = function(v1, v2, v3, a) { + this._assert3d('ambientLight'); + p5._validateParameters('ambientLight', arguments); + var color = this.color.apply(this, arguments); + + this._renderer.ambientLightColors.push( + color._array[0], + color._array[1], + color._array[2] + ); + + this._renderer._enableLighting = true; + + return this; +}; + +/** + * Creates a directional light with a color and a direction + * @method directionalLight + * @param {Number} v1 red or hue value (depending on the current + * color mode), + * @param {Number} v2 green or saturation value + * @param {Number} v3 blue or brightness value + * @param {p5.Vector} position the direction of the light + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(0); + * //move your mouse to change light direction + * let dirX = (mouseX / width - 0.5) * 2; + * let dirY = (mouseY / height - 0.5) * 2; + * directionalLight(250, 250, 250, -dirX, -dirY, -1); + * noStroke(); + * sphere(40); + * } + * + *
    + * + * @alt + * light source on canvas changeable with mouse position + * + */ + +/** + * @method directionalLight + * @param {Number[]|String|p5.Color} color color Array, CSS color string, + * or p5.Color value + * @param {Number} x x axis direction + * @param {Number} y y axis direction + * @param {Number} z z axis direction + * @chainable + */ + +/** + * @method directionalLight + * @param {Number[]|String|p5.Color} color + * @param {p5.Vector} position + * @chainable + */ + +/** + * @method directionalLight + * @param {Number} v1 + * @param {Number} v2 + * @param {Number} v3 + * @param {Number} x + * @param {Number} y + * @param {Number} z + * @chainable + */ +p5.prototype.directionalLight = function(v1, v2, v3, x, y, z) { + this._assert3d('directionalLight'); + p5._validateParameters('directionalLight', arguments); + + //@TODO: check parameters number + var color; + if (v1 instanceof p5.Color) { + color = v1; + } else { + color = this.color(v1, v2, v3); + } + + var _x, _y, _z; + var v = arguments[arguments.length - 1]; + if (typeof v === 'number') { + _x = arguments[arguments.length - 3]; + _y = arguments[arguments.length - 2]; + _z = arguments[arguments.length - 1]; + } else { + _x = v.x; + _y = v.y; + _z = v.z; + } + + // normalize direction + var l = Math.sqrt(_x * _x + _y * _y + _z * _z); + this._renderer.directionalLightDirections.push(_x / l, _y / l, _z / l); + + this._renderer.directionalLightColors.push( + color._array[0], + color._array[1], + color._array[2] + ); + + this._renderer._enableLighting = true; + + return this; +}; + +/** + * Creates a point light with a color and a light position + * @method pointLight + * @param {Number} v1 red or hue value (depending on the current + * color mode), + * @param {Number} v2 green or saturation value + * @param {Number} v3 blue or brightness value + * @param {Number} x x axis position + * @param {Number} y y axis position + * @param {Number} z z axis position + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(0); + * //move your mouse to change light position + * let locX = mouseX - width / 2; + * let locY = mouseY - height / 2; + * // to set the light position, + * // think of the world's coordinate as: + * // -width/2,-height/2 -------- width/2,-height/2 + * // | | + * // | 0,0 | + * // | | + * // -width/2,height/2--------width/2,height/2 + * pointLight(250, 250, 250, locX, locY, 50); + * noStroke(); + * sphere(40); + * } + * + *
    + * + * @alt + * spot light on canvas changes position with mouse + * + */ + +/** + * @method pointLight + * @param {Number} v1 + * @param {Number} v2 + * @param {Number} v3 + * @param {p5.Vector} position the position of the light + * @chainable + */ + +/** + * @method pointLight + * @param {Number[]|String|p5.Color} color color Array, CSS color string, + * or p5.Color value + * @param {Number} x + * @param {Number} y + * @param {Number} z + * @chainable + */ + +/** + * @method pointLight + * @param {Number[]|String|p5.Color} color + * @param {p5.Vector} position + * @chainable + */ +p5.prototype.pointLight = function(v1, v2, v3, x, y, z) { + this._assert3d('pointLight'); + p5._validateParameters('pointLight', arguments); + + //@TODO: check parameters number + var color; + if (v1 instanceof p5.Color) { + color = v1; + } else { + color = this.color(v1, v2, v3); + } + + var _x, _y, _z; + var v = arguments[arguments.length - 1]; + if (typeof v === 'number') { + _x = arguments[arguments.length - 3]; + _y = arguments[arguments.length - 2]; + _z = arguments[arguments.length - 1]; + } else { + _x = v.x; + _y = v.y; + _z = v.z; + } + + this._renderer.pointLightPositions.push(_x, _y, _z); + this._renderer.pointLightColors.push( + color._array[0], + color._array[1], + color._array[2] + ); + + this._renderer._enableLighting = true; + + return this; +}; + +/** + * Sets the default ambient and directional light. The defaults are ambientLight(128, 128, 128) and directionalLight(128, 128, 128, 0, 0, -1). Lights need to be included in the draw() to remain persistent in a looping program. Placing them in the setup() of a looping program will cause them to only have an effect the first time through the loop. + * @method lights + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(0); + * lights(); + * rotateX(millis() / 1000); + * rotateY(millis() / 1000); + * rotateZ(millis() / 1000); + * box(); + * } + * + *
    + * + * @alt + * the light is partially ambient and partially directional + */ +p5.prototype.lights = function() { + this._assert3d('lights'); + this.ambientLight(128, 128, 128); + this.directionalLight(128, 128, 128, 0, 0, -1); + return this; +}; + +module.exports = p5; + +},{"../core/main":24}],67:[function(_dereq_,module,exports){ +/** + * @module Shape + * @submodule 3D Models + * @for p5 + * @requires core + * @requires p5.Geometry + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +_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.Geometry)} [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.Geometry object + * + * @example + *
    + * + * //draw a spinning octahedron + * let octahedron; + * + * function preload() { + * octahedron = loadModel('assets/octahedron.obj'); + * } + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * model(octahedron); + * } + * + *
    + * + * @alt + * Vertically rotating 3-d octahedron. + * + * @example + *
    + * + * //draw a spinning teapot + * let teapot; + * + * function preload() { + * // Load model with normalise parameter set to true + * teapot = loadModel('assets/teapot.obj', true); + * } + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * scale(0.4); // Scaled to make model fit into canvas + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * normalMaterial(); // For effect + * model(teapot); + * } + * + *
    + * + * @alt + * Vertically rotating 3-d teapot with red, green and blue gradient. + */ +/** + * @method loadModel + * @param {String} path + * @param {function(p5.Geometry)} [successCallback] + * @param {function(Event)} [failureCallback] + * @return {p5.Geometry} the p5.Geometry object + */ +p5.prototype.loadModel = function(path) { + p5._validateParameters('loadModel', arguments); + var normalize; + var successCallback; + var failureCallback; + if (typeof arguments[1] === 'boolean') { + 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; + var self = this; + this.loadStrings( + path, + function(strings) { + parseObj(model, strings); + + if (normalize) { + model.normalize(); + } + + self._decrementPreload(); + 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); + } + + if ( + face[0] !== face[1] && + face[0] !== face[2] && + face[1] !== face[2] + ) { + model.faces.push(face); + } + } + } + } + } + // If the model doesn't have normals, compute the normals + if (model.vertexNormals.length === 0) { + model.computeNormals(); + } + + return model; +} + +/** + * Render a 3d model to the screen. + * + * @method model + * @param {p5.Geometry} model Loaded 3d model to be rendered + * @example + *
    + * + * //draw a spinning octahedron + * let octahedron; + * + * function preload() { + * octahedron = loadModel('assets/octahedron.obj'); + * } + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * model(octahedron); + * } + * + *
    + * + * @alt + * Vertically rotating 3-d octahedron. + * + */ +p5.prototype.model = function(model) { + this._assert3d('model'); + p5._validateParameters('model', arguments); + if (model.vertices.length > 0) { + if (!this._renderer.geometryInHash(model.gid)) { + model._makeTriangleEdges()._edgesToVertices(); + this._renderer.createBuffers(model.gid, model); + } + + this._renderer.drawBuffers(model.gid); + } +}; + +module.exports = p5; + +},{"../core/main":24,"./p5.Geometry":70}],68:[function(_dereq_,module,exports){ +/** + * @module Lights, Camera + * @submodule Material + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); +_dereq_('./p5.Texture'); + +/** + * Loads a custom shader from the provided vertex and fragment + * shader paths. The shader files are loaded asynchronously in the + * background, so this method should be used in preload(). + * + * For now, there are three main types of shaders. p5 will automatically + * supply appropriate vertices, normals, colors, and lighting attributes + * if the parameters defined in the shader match the names. + * + * @method loadShader + * @param {String} vertFilename path to file containing vertex shader + * source code + * @param {String} fragFilename path to file containing fragment shader + * source code + * @param {function} [callback] callback to be executed after loadShader + * completes. On success, the Shader object is passed as the first argument. + * @param {function} [errorCallback] callback to be executed when an error + * occurs inside loadShader. On error, the error is passed as the first + * argument. + * @return {p5.Shader} a shader object created from the provided + * vertex and fragment shader files. + * + * @example + *
    + * + * let mandel; + * function preload() { + * // load the shader definitions from files + * mandel = loadShader('assets/shader.vert', 'assets/shader.frag'); + * } + * function setup() { + * createCanvas(100, 100, WEBGL); + * // use the shader + * shader(mandel); + * noStroke(); + * mandel.setUniform('p', [-0.74364388703, 0.13182590421]); + * } + * + * function draw() { + * mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000)))); + * quad(-1, -1, 1, -1, 1, 1, -1, 1); + * } + * + *
    + * + * @alt + * zooming Mandelbrot set. a colorful, infinitely detailed fractal. + */ +p5.prototype.loadShader = function( + vertFilename, + fragFilename, + callback, + errorCallback +) { + p5._validateParameters('loadShader', arguments); + if (!errorCallback) { + errorCallback = console.error; + } + + var loadedShader = new p5.Shader(); + + var self = this; + var loadedFrag = false; + var loadedVert = false; + + var onLoad = function() { + self._decrementPreload(); + if (callback) { + callback(loadedShader); + } + }; + + this.loadStrings( + vertFilename, + function(result) { + loadedShader._vertSrc = result.join('\n'); + loadedVert = true; + if (loadedFrag) { + onLoad(); + } + }, + errorCallback + ); + + this.loadStrings( + fragFilename, + function(result) { + loadedShader._fragSrc = result.join('\n'); + loadedFrag = true; + if (loadedVert) { + onLoad(); + } + }, + errorCallback + ); + + return loadedShader; +}; + +/** + * @method createShader + * @param {String} vertSrc source code for the vertex shader + * @param {String} fragSrc source code for the fragment shader + * @returns {p5.Shader} a shader object created from the provided + * vertex and fragment shaders. + * + * @example + *
    + * + * // the 'varying's are shared between both vertex & fragment shaders + * let varying = 'precision highp float; varying vec2 vPos;'; + * + * // the vertex shader is called for each vertex + * let vs = + * varying + + * 'attribute vec3 aPosition;' + + * 'void main() { vPos = (gl_Position = vec4(aPosition,1.0)).xy; }'; + * + * // the fragment shader is called for each pixel + * let fs = + * varying + + * 'uniform vec2 p;' + + * 'uniform float r;' + + * 'const int I = 500;' + + * 'void main() {' + + * ' vec2 c = p + vPos * r, z = c;' + + * ' float n = 0.0;' + + * ' for (int i = I; i > 0; i --) {' + + * ' if(z.x*z.x+z.y*z.y > 4.0) {' + + * ' n = float(i)/float(I);' + + * ' break;' + + * ' }' + + * ' z = vec2(z.x*z.x-z.y*z.y, 2.0*z.x*z.y) + c;' + + * ' }' + + * ' gl_FragColor = vec4(0.5-cos(n*17.0)/2.0,0.5-cos(n*13.0)/2.0,0.5-cos(n*23.0)/2.0,1.0);' + + * '}'; + * + * let mandel; + * function setup() { + * createCanvas(100, 100, WEBGL); + * + * // create and initialize the shader + * mandel = createShader(vs, fs); + * shader(mandel); + * noStroke(); + * + * // 'p' is the center point of the Mandelbrot image + * mandel.setUniform('p', [-0.74364388703, 0.13182590421]); + * } + * + * function draw() { + * // 'r' is the size of the image in Mandelbrot-space + * mandel.setUniform('r', 1.5 * exp(-6.5 * (1 + sin(millis() / 2000)))); + * quad(-1, -1, 1, -1, 1, 1, -1, 1); + * } + * + *
    + * + * @alt + * zooming Mandelbrot set. a colorful, infinitely detailed fractal. + */ +p5.prototype.createShader = function(vertSrc, fragSrc) { + this._assert3d('createShader'); + p5._validateParameters('createShader', arguments); + return new p5.Shader(this._renderer, vertSrc, fragSrc); +}; + +/** + * The shader() function lets the user provide a custom shader + * to fill in shapes in WEBGL mode. Users can create their + * own shaders by loading vertex and fragment shaders with + * loadShader(). + * + * @method shader + * @chainable + * @param {p5.Shader} [s] the desired p5.Shader to use for rendering + * shapes. + */ +p5.prototype.shader = function(s) { + this._assert3d('shader'); + p5._validateParameters('shader', arguments); + + if (s._renderer === undefined) { + s._renderer = this._renderer; + } + + if (s.isStrokeShader()) { + this._renderer.userStrokeShader = s; + } else { + this._renderer.userFillShader = s; + this._renderer._useNormalMaterial = false; + } + + s.init(); + + return this; +}; + +/** + * This function restores the default shaders in WEBGL mode. Code that runs + * after resetShader() will not be affected by previously defined + * shaders. Should be run after shader(). + * + * @method resetShader + * @chainable + */ +p5.prototype.resetShader = function() { + this._renderer.userFillShader = this._renderer.userStrokeShader = null; + return this; +}; + +/** + * Normal material for geometry. You can view all + * possible materials in this + * example. + * @method normalMaterial + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(200); + * normalMaterial(); + * sphere(40); + * } + * + *
    + * + * @alt + * Red, green and blue gradient. + * + */ +p5.prototype.normalMaterial = function() { + this._assert3d('normalMaterial'); + p5._validateParameters('normalMaterial', arguments); + this._renderer.drawMode = constants.FILL; + this._renderer._useSpecularMaterial = false; + this._renderer._useNormalMaterial = true; + this._renderer.curFillColor = [1, 1, 1, 1]; + this._renderer._setProperty('_doFill', true); + this.noStroke(); + return this; +}; + +/** + * Texture for geometry. You can view other possible materials in this + * example. + * @method texture + * @param {p5.Image|p5.MediaElement|p5.Graphics} tex 2-dimensional graphics + * to render as texture + * @chainable + * @example + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/laDefense.jpg'); + * } + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(0); + * rotateZ(frameCount * 0.01); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * //pass image as texture + * texture(img); + * box(200, 200, 200); + * } + * + *
    + * + *
    + * + * let pg; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * pg = createGraphics(200, 200); + * pg.textSize(75); + * } + * + * function draw() { + * background(0); + * pg.background(255); + * pg.text('hello!', 0, 100); + * //pass image as texture + * texture(pg); + * rotateX(0.5); + * noStroke(); + * plane(50); + * } + * + *
    + * + *
    + * + * let vid; + * function preload() { + * vid = createVideo('assets/fingers.mov'); + * vid.hide(); + * } + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(0); + * //pass video frame as texture + * texture(vid); + * rect(-40, -40, 80, 80); + * } + * + * function mousePressed() { + * vid.loop(); + * } + * + *
    + * + * @alt + * Rotating view of many images umbrella and grid roof on a 3d plane + * black canvas + * black canvas + * + */ +p5.prototype.texture = function(tex) { + this._assert3d('texture'); + p5._validateParameters('texture', arguments); + + this._renderer.drawMode = constants.TEXTURE; + this._renderer._useSpecularMaterial = false; + this._renderer._useNormalMaterial = false; + this._renderer._tex = tex; + this._renderer._setProperty('_doFill', true); + + return this; +}; + +/** + * Sets the coordinate space for texture mapping. The default mode is IMAGE + * which refers to the actual coordinates of the image. + * NORMAL refers to a normalized space of values ranging from 0 to 1. + * This function only works in WEBGL mode. + * + * With IMAGE, if an image is 100 x 200 pixels, mapping the image onto the entire + * size of a quad would require the points (0,0) (100, 0) (100,200) (0,200). + * The same mapping in NORMAL is (0,0) (1,0) (1,1) (0,1). + * @method textureMode + * @param {Constant} mode either IMAGE or NORMAL + * @example + *
    + * + * let img; + * + * function preload() { + * img = loadImage('assets/laDefense.jpg'); + * } + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * texture(img); + * textureMode(NORMAL); + * beginShape(); + * vertex(-50, -50, 0, 0); + * vertex(50, -50, 1, 0); + * vertex(50, 50, 1, 1); + * vertex(-50, 50, 0, 1); + * endShape(); + * } + * + *
    + * + * @alt + * the underside of a white umbrella and gridded ceiling above + * + *
    + * + * let img; + * + * function preload() { + * img = loadImage('assets/laDefense.jpg'); + * } + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * texture(img); + * textureMode(NORMAL); + * beginShape(); + * vertex(-50, -50, 0, 0); + * vertex(50, -50, img.width, 0); + * vertex(50, 50, img.width, img.height); + * vertex(-50, 50, 0, img.height); + * endShape(); + * } + * + *
    + * + * @alt + * the underside of a white umbrella and gridded ceiling above + * + */ +p5.prototype.textureMode = function(mode) { + if (mode !== constants.IMAGE && mode !== constants.NORMAL) { + console.warn( + 'You tried to set ' + mode + ' textureMode only supports IMAGE & NORMAL ' + ); + } else { + this._renderer.textureMode = mode; + } +}; + +/** + * Sets the global texture wrapping mode. This controls how textures behave + * when their uv's go outside of the 0 - 1 range. There are three options: + * CLAMP, REPEAT, and MIRROR. + * + * CLAMP causes the pixels at the edge of the texture to extend to the bounds + * REPEAT causes the texture to tile repeatedly until reaching the bounds + * MIRROR works similarly to REPEAT but it flips the texture with every new tile + * + * REPEAT & MIRROR are only available if the texture + * is a power of two size (128, 256, 512, 1024, etc.). + * + * This method will affect all textures in your sketch until a subsequent + * textureWrap call is made. + * + * If only one argument is provided, it will be applied to both the + * horizontal and vertical axes. + * @method textureWrap + * @param {Constant} wrapX either CLAMP, REPEAT, or MIRROR + * @param {Constant} [wrapY] either CLAMP, REPEAT, or MIRROR + * @example + *
    + * + * let img; + * function preload() { + * img = loadImage('assets/rockies128.jpg'); + * } + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * textureWrap(MIRROR); + * } + * + * function draw() { + * background(0); + * + * let dX = mouseX; + * let dY = mouseY; + * + * let u = lerp(1.0, 2.0, dX); + * let v = lerp(1.0, 2.0, dY); + * + * scale(width / 2); + * + * texture(img); + * + * beginShape(TRIANGLES); + * vertex(-1, -1, 0, 0, 0); + * vertex(1, -1, 0, u, 0); + * vertex(1, 1, 0, u, v); + * + * vertex(1, 1, 0, u, v); + * vertex(-1, 1, 0, 0, v); + * vertex(-1, -1, 0, 0, 0); + * endShape(); + * } + * + *
    + * + * @alt + * an image of the rocky mountains repeated in mirrored tiles + * + */ +p5.prototype.textureWrap = function(wrapX, wrapY) { + wrapY = wrapY || wrapX; + + this._renderer.textureWrapX = wrapX; + this._renderer.textureWrapY = wrapY; + + var textures = this._renderer.textures; + for (var i = 0; i < textures.length; i++) { + textures[i].setWrapMode(wrapX, wrapY); + } +}; + +/** + * Ambient material for geometry with a given color. You can view all + * possible materials in this + * example. + * @method ambientMaterial + * @param {Number} v1 gray value, red or hue value + * (depending on the current color mode), + * @param {Number} [v2] green or saturation value + * @param {Number} [v3] blue or brightness value + * @param {Number} [a] opacity + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(0); + * noStroke(); + * ambientLight(200); + * ambientMaterial(70, 130, 230); + * sphere(40); + * } + * + *
    + * + * @alt + * radiating light source from top right of canvas + * + */ +/** + * @method ambientMaterial + * @param {Number[]|String|p5.Color} color color, color Array, or CSS color string + * @chainable + */ +p5.prototype.ambientMaterial = function(v1, v2, v3, a) { + this._assert3d('ambientMaterial'); + p5._validateParameters('ambientMaterial', arguments); + + var color = p5.prototype.color.apply(this, arguments); + this._renderer.curFillColor = color._array; + this._renderer._useSpecularMaterial = false; + this._renderer._useNormalMaterial = false; + this._renderer._enableLighting = true; + this._renderer._tex = null; + + return this; +}; + +/** + * Specular material for geometry with a given color. You can view all + * possible materials in this + * example. + * @method specularMaterial + * @param {Number} v1 gray value, red or hue value + * (depending on the current color mode), + * @param {Number} [v2] green or saturation value + * @param {Number} [v3] blue or brightness value + * @param {Number} [a] opacity + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(0); + * noStroke(); + * ambientLight(50); + * pointLight(250, 250, 250, 100, 100, 30); + * specularMaterial(250); + * sphere(40); + * } + * + *
    + * + * @alt + * diffused radiating light source from top right of canvas + * + */ +/** + * @method specularMaterial + * @param {Number[]|String|p5.Color} color color Array, or CSS color string + * @chainable + */ +p5.prototype.specularMaterial = function(v1, v2, v3, a) { + this._assert3d('specularMaterial'); + p5._validateParameters('specularMaterial', arguments); + + var color = p5.prototype.color.apply(this, arguments); + this._renderer.curFillColor = color._array; + this._renderer._useSpecularMaterial = true; + this._renderer._useNormalMaterial = false; + this._renderer._enableLighting = true; + this._renderer._tex = null; + + return this; +}; + +/** + * Sets the amount of gloss in the surface of shapes. + * Used in combination with specularMaterial() in setting + * the material properties of shapes. The default and minimum value is 1. + * @method shininess + * @param {Number} shine Degree of Shininess. + * Defaults to 1. + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(0); + * noStroke(); + * let locX = mouseX - width / 2; + * let locY = mouseY - height / 2; + * ambientLight(60, 60, 60); + * pointLight(255, 255, 255, locX, locY, 50); + * specularMaterial(250); + * translate(-25, 0, 0); + * shininess(1); + * sphere(20); + * translate(50, 0, 0); + * shininess(20); + * sphere(20); + * } + * + *
    + * @alt + * Shininess on Camera changes position with mouse + */ +p5.prototype.shininess = function(shine) { + this._assert3d('shininess'); + p5._validateParameters('shininess', arguments); + + if (shine < 1) { + shine = 1; + } + this._renderer._useShininess = shine; + return this; +}; + +/** + * @private blends colors according to color components. + * If alpha value is less than 1, we need to enable blending + * on our gl context. Otherwise opaque objects need to a depthMask. + * @param {Number[]} color [description] + * @return {Number[]]} Normalized numbers array + */ +p5.RendererGL.prototype._applyColorBlend = function(colors) { + var gl = this.GL; + + var isTexture = this.drawMode === constants.TEXTURE; + if (isTexture || colors[colors.length - 1] < 1.0) { + gl.depthMask(isTexture); + gl.enable(gl.BLEND); + this._applyBlendMode(); + } else { + gl.depthMask(true); + gl.disable(gl.BLEND); + } + return colors; +}; + +/** + * @private sets blending in gl context to curBlendMode + * @param {Number[]} color [description] + * @return {Number[]]} Normalized numbers array + */ +p5.RendererGL.prototype._applyBlendMode = function() { + var gl = this.GL; + switch (this.curBlendMode) { + case constants.BLEND: + case constants.ADD: + gl.blendEquation(gl.FUNC_ADD); + gl.blendFunc(gl.SRC_ALPHA, gl.ONE_MINUS_SRC_ALPHA); + break; + case constants.MULTIPLY: + gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_ADD); + gl.blendFuncSeparate(gl.ZERO, gl.SRC_COLOR, gl.ONE, gl.ONE); + break; + case constants.SCREEN: + gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_ADD); + gl.blendFuncSeparate(gl.ONE_MINUS_DST_COLOR, gl.ONE, gl.ONE, gl.ONE); + break; + case constants.EXCLUSION: + gl.blendEquationSeparate(gl.FUNC_ADD, gl.FUNC_ADD); + gl.blendFuncSeparate( + gl.ONE_MINUS_DST_COLOR, + gl.ONE_MINUS_SRC_COLOR, + gl.ONE, + gl.ONE + ); + break; + case constants.REPLACE: + gl.blendEquation(gl.FUNC_ADD); + gl.blendFunc(gl.ONE, gl.ZERO); + break; + case constants.SUBTRACT: + gl.blendEquationSeparate(gl.FUNC_REVERSE_SUBTRACT, gl.FUNC_ADD); + gl.blendFuncSeparate(gl.SRC_ALPHA, gl.ONE, gl.ONE, gl.ONE); + break; + case constants.DARKEST: + if (this.blendExt) { + gl.blendEquationSeparate(this.blendExt.MIN_EXT, gl.FUNC_ADD); + gl.blendFuncSeparate(gl.ONE, gl.ONE, gl.ONE, gl.ONE); + } else { + console.warn( + 'blendMode(DARKEST) does not work in your browser in WEBGL mode.' + ); + } + break; + case constants.LIGHTEST: + if (this.blendExt) { + gl.blendEquationSeparate(this.blendExt.MAX_EXT, gl.FUNC_ADD); + gl.blendFuncSeparate(gl.ONE, gl.ONE, gl.ONE, gl.ONE); + } else { + console.warn( + 'blendMode(LIGHTEST) does not work in your browser in WEBGL mode.' + ); + } + break; + default: + console.error( + 'Oops! Somehow RendererGL set curBlendMode to an unsupported mode.' + ); + break; + } +}; + +module.exports = p5; + +},{"../core/constants":18,"../core/main":24,"./p5.Texture":76}],69:[function(_dereq_,module,exports){ +/** + * @module Lights, Camera + * @submodule Camera + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +//////////////////////////////////////////////////////////////////////////////// +// p5.Prototype Methods +//////////////////////////////////////////////////////////////////////////////// + +/** + * Sets the camera position for a 3D sketch. Parameters for this function define + * the position for the camera, the center of the sketch (where the camera is + * pointing), and an up direction (the orientation of the camera). + * + * When called with no arguments, this function creates a default camera + * equivalent to + * camera(0, 0, (height/2.0) / tan(PI*30.0 / 180.0), 0, 0, 0, 0, 1, 0); + * @method camera + * @for p5 + * @param {Number} [x] camera position value on x axis + * @param {Number} [y] camera position value on y axis + * @param {Number} [z] camera position value on z axis + * @param {Number} [centerX] x coordinate representing center of the sketch + * @param {Number} [centerY] y coordinate representing center of the sketch + * @param {Number} [centerZ] z coordinate representing center of the sketch + * @param {Number} [upX] x component of direction 'up' from camera + * @param {Number} [upY] y component of direction 'up' from camera + * @param {Number} [upZ] z component of direction 'up' from camera + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * function draw() { + * background(204); + * //move the camera away from the plane by a sin wave + * camera(0, 0, 20 + sin(frameCount * 0.01) * 10, 0, 0, 0, 0, 1, 0); + * plane(10, 10); + * } + * + *
    + * + * @alt + * White square repeatedly grows to fill canvas and then shrinks. + * + */ +p5.prototype.camera = function() { + this._assert3d('camera'); + p5._validateParameters('camera', arguments); + this._renderer._curCamera.camera.apply(this._renderer._curCamera, arguments); + return this; +}; + +/** + * Sets a perspective projection for the camera in a 3D sketch. This projection + * represents depth through foreshortening: objects that are close to the camera + * appear their actual size while those that are further away from the camera + * appear smaller. The parameters to this function define the viewing frustum + * (the truncated pyramid within which objects are seen by the camera) through + * vertical field of view, aspect ratio (usually width/height), and near and far + * clipping planes. + * + * When called with no arguments, the defaults + * provided are equivalent to + * perspective(PI/3.0, width/height, eyeZ/10.0, eyeZ*10.0), where eyeZ + * is equal to ((height/2.0) / tan(PI*60.0/360.0)); + * @method perspective + * @for p5 + * @param {Number} [fovy] camera frustum vertical field of view, + * from bottom to top of view, in angleMode units + * @param {Number} [aspect] camera frustum aspect ratio + * @param {Number} [near] frustum near plane length + * @param {Number} [far] frustum far plane length + * @chainable + * @example + *
    + * + * //drag the mouse to look around! + * //you will see there's a vanishing point + * function setup() { + * createCanvas(100, 100, WEBGL); + * perspective(PI / 3.0, width / height, 0.1, 500); + * } + * function draw() { + * background(200); + * orbitControl(); + * normalMaterial(); + * + * rotateX(-0.3); + * rotateY(-0.2); + * translate(0, 0, -50); + * + * push(); + * translate(-15, 0, sin(frameCount / 30) * 95); + * box(30); + * pop(); + * push(); + * translate(15, 0, sin(frameCount / 30 + PI) * 95); + * box(30); + * pop(); + * } + * + *
    + * + * @alt + * two colored 3D boxes move back and forth, rotating as mouse is dragged. + * + */ +p5.prototype.perspective = function() { + this._assert3d('perspective'); + p5._validateParameters('perspective', arguments); + this._renderer._curCamera.perspective.apply( + this._renderer._curCamera, + arguments + ); + return this; +}; + +/** + * Sets an orthographic projection for the camera in a 3D sketch and defines a + * box-shaped viewing frustum within which objects are seen. In this projection, + * all objects with the same dimension appear the same size, regardless of + * whether they are near or far from the camera. The parameters to this + * function specify the viewing frustum where left and right are the minimum and + * maximum x values, top and bottom are the minimum and maximum y values, and near + * and far are the minimum and maximum z values. If no parameters are given, the + * default is used: ortho(-width/2, width/2, -height/2, height/2). + * @method ortho + * @for p5 + * @param {Number} [left] camera frustum left plane + * @param {Number} [right] camera frustum right plane + * @param {Number} [bottom] camera frustum bottom plane + * @param {Number} [top] camera frustum top plane + * @param {Number} [near] camera frustum near plane + * @param {Number} [far] camera frustum far plane + * @chainable + * @example + *
    + * + * //drag the mouse to look around! + * //there's no vanishing point + * function setup() { + * createCanvas(100, 100, WEBGL); + * ortho(-width / 2, width / 2, height / 2, -height / 2, 0, 500); + * } + * function draw() { + * background(200); + * orbitControl(); + * normalMaterial(); + * + * rotateX(0.2); + * rotateY(-0.2); + * push(); + * translate(-15, 0, sin(frameCount / 30) * 65); + * box(30); + * pop(); + * push(); + * translate(15, 0, sin(frameCount / 30 + PI) * 65); + * box(30); + * pop(); + * } + * + *
    + * + * @alt + * two 3D boxes move back and forth along same plane, rotating as mouse is dragged. + * + */ +p5.prototype.ortho = function() { + this._assert3d('ortho'); + p5._validateParameters('ortho', arguments); + this._renderer._curCamera.ortho.apply(this._renderer._curCamera, arguments); + return this; +}; + +//////////////////////////////////////////////////////////////////////////////// +// p5.Camera +//////////////////////////////////////////////////////////////////////////////// + +/** + * Creates a new p5.Camera object and tells the + * renderer to use that camera. + * Returns the p5.Camera object. + * @method createCamera + * @return {p5.Camera} The newly created camera object. + * @for p5 + */ +p5.prototype.createCamera = function() { + this._assert3d('createCamera'); + var _cam = new p5.Camera(this._renderer); + + // compute default camera settings, then set a default camera + _cam._computeCameraDefaultSettings(); + _cam._setDefaultCamera(); + + // set renderer current camera to the new camera + this._renderer._curCamera = _cam; + + return _cam; +}; + +/** + * This class describes a camera for use in p5's + * + * WebGL mode. It contains camera position, orientation, and projection + * information necessary for rendering a 3D scene. + * + * New p5.Camera objects can be made through the + * createCamera() function and controlled through + * the methods described below. A camera created in this way will use a default + * position in the scene and a default perspective projection until these + * properties are changed through the various methods available. It is possible + * to create multiple cameras, in which case the current camera + * can be set through the setCamera() method. + * + * + * Note: + * The methods below operate in two coordinate systems: the 'world' coordinate + * system describe positions in terms of their relationship to the origin along + * the X, Y and Z axes whereas the camera's 'local' coordinate system + * describes positions from the camera's point of view: left-right, up-down, + * and forward-backward. The move() method, + * for instance, moves the camera along its own axes, whereas the + * setPosition() + * method sets the camera's position in world-space. + * + * + * @class p5.Camera + * @param {rendererGL} rendererGL instance of WebGL renderer + * @example + *
    + * + * let cam; + * let delta = 0.01; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * cam = createCamera(); + * // set initial pan angle + * cam.pan(-0.8); + * } + * + * function draw() { + * background(200); + * + * // pan camera according to angle 'delta' + * cam.pan(delta); + * + * // every 160 frames, switch direction + * if (frameCount % 160 === 0) { + * delta *= -1; + * } + * + * rotateX(frameCount * 0.01); + * translate(-100, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * } + * + *
    + * + * @alt + * camera view pans left and right across a series of rotating 3D boxes. + * + */ +p5.Camera = function(renderer) { + this._renderer = renderer; + + this.cameraType = 'default'; + + this.cameraMatrix = new p5.Matrix(); + this.projMatrix = new p5.Matrix(); +}; + +//////////////////////////////////////////////////////////////////////////////// +// Camera Projection Methods +//////////////////////////////////////////////////////////////////////////////// + +/** + * Sets a perspective projection for a p5.Camera object and sets parameters + * for that projection according to perspective() + * syntax. + * @method perspective + * @for p5.Camera + */ +p5.Camera.prototype.perspective = function(fovy, aspect, near, far) { + if (typeof fovy === 'undefined') { + fovy = this.defaultCameraFOV; + // this avoids issue where setting angleMode(DEGREES) before calling + // perspective leads to a smaller than expected FOV (because + // _computeCameraDefaultSettings computes in radians) + this.cameraFOV = fovy; + } else { + this.cameraFOV = this._renderer._pInst._toRadians(fovy); + } + if (typeof aspect === 'undefined') { + aspect = this.defaultAspectRatio; + } + if (typeof near === 'undefined') { + near = this.defaultCameraNear; + } + if (typeof far === 'undefined') { + far = this.defaultCameraFar; + } + + if (near <= 0.0001) { + near = 0.01; + console.log( + 'Avoid perspective near plane values close to or below 0. ' + + 'Setting value to 0.01.' + ); + } + + if (far < near) { + console.log( + 'Perspective far plane value is less than near plane value. ' + + 'Nothing will be shown.' + ); + } + + this.aspectRatio = aspect; + this.cameraNear = near; + this.cameraFar = far; + + this.projMatrix = p5.Matrix.identity(); + + var f = 1.0 / Math.tan(this.cameraFOV / 2); + var nf = 1.0 / (this.cameraNear - this.cameraFar); + + // prettier-ignore + this.projMatrix.set(f / aspect, 0, 0, 0, + 0, -f, 0, 0, + 0, 0, (far + near) * nf, -1, + 0, 0, (2 * far * near) * nf, 0); + + if (this._isActive()) { + this._renderer.uPMatrix.set( + this.projMatrix.mat4[0], + this.projMatrix.mat4[1], + this.projMatrix.mat4[2], + this.projMatrix.mat4[3], + this.projMatrix.mat4[4], + this.projMatrix.mat4[5], + this.projMatrix.mat4[6], + this.projMatrix.mat4[7], + this.projMatrix.mat4[8], + this.projMatrix.mat4[9], + this.projMatrix.mat4[10], + this.projMatrix.mat4[11], + this.projMatrix.mat4[12], + this.projMatrix.mat4[13], + this.projMatrix.mat4[14], + this.projMatrix.mat4[15] + ); + } + + this.cameraType = 'custom'; +}; + +/** + * Sets an orthographic projection for a p5.Camera object and sets parameters + * for that projection according to ortho() syntax. + * @method ortho + * @for p5.Camera + */ +p5.Camera.prototype.ortho = function(left, right, bottom, top, near, far) { + if (left === undefined) left = -this._renderer.width / 2; + if (right === undefined) right = +this._renderer.width / 2; + if (bottom === undefined) bottom = -this._renderer.height / 2; + if (top === undefined) top = +this._renderer.height / 2; + if (near === undefined) near = 0; + if (far === undefined) + far = Math.max(this._renderer.width, this._renderer.height); + + var w = right - left; + var h = top - bottom; + var d = far - near; + + var x = +2.0 / w; + var y = +2.0 / h; + var z = -2.0 / d; + + var tx = -(right + left) / w; + var ty = -(top + bottom) / h; + var tz = -(far + near) / d; + + this.projMatrix = p5.Matrix.identity(); + + // prettier-ignore + this.projMatrix.set( x, 0, 0, 0, + 0, -y, 0, 0, + 0, 0, z, 0, + tx, ty, tz, 1); + + if (this._isActive()) { + this._renderer.uPMatrix.set( + this.projMatrix.mat4[0], + this.projMatrix.mat4[1], + this.projMatrix.mat4[2], + this.projMatrix.mat4[3], + this.projMatrix.mat4[4], + this.projMatrix.mat4[5], + this.projMatrix.mat4[6], + this.projMatrix.mat4[7], + this.projMatrix.mat4[8], + this.projMatrix.mat4[9], + this.projMatrix.mat4[10], + this.projMatrix.mat4[11], + this.projMatrix.mat4[12], + this.projMatrix.mat4[13], + this.projMatrix.mat4[14], + this.projMatrix.mat4[15] + ); + } + + this.cameraType = 'custom'; +}; + +//////////////////////////////////////////////////////////////////////////////// +// Camera Orientation Methods +//////////////////////////////////////////////////////////////////////////////// + +/** + * Rotate camera view about arbitrary axis defined by x,y,z + * based on http://learnwebgl.brown37.net/07_cameras/camera_rotating_motion.html + * @method _rotateView + * @private + */ +p5.Camera.prototype._rotateView = function(a, x, y, z) { + var centerX = this.centerX; + var centerY = this.centerY; + var centerZ = this.centerZ; + + // move center by eye position such that rotation happens around eye position + centerX -= this.eyeX; + centerY -= this.eyeY; + centerZ -= this.eyeZ; + + var rotation = p5.Matrix.identity(this._renderer._pInst); + rotation.rotate(this._renderer._pInst._toRadians(a), x, y, z); + + // prettier-ignore + var rotatedCenter = [ + centerX * rotation.mat4[0]+ centerY * rotation.mat4[4]+ centerZ * rotation.mat4[8], + centerX * rotation.mat4[1]+ centerY * rotation.mat4[5]+ centerZ * rotation.mat4[9], + centerX * rotation.mat4[2]+ centerY * rotation.mat4[6]+ centerZ * rotation.mat4[10] + ] + + // add eye position back into center + rotatedCenter[0] += this.eyeX; + rotatedCenter[1] += this.eyeY; + rotatedCenter[2] += this.eyeZ; + + this.camera( + this.eyeX, + this.eyeY, + this.eyeZ, + rotatedCenter[0], + rotatedCenter[1], + rotatedCenter[2], + this.upX, + this.upY, + this.upZ + ); +}; + +/** + * Panning rotates the camera view to the left and right. + * @method pan + * @param {Number} angle amount to rotate camera in current + * angleMode units. + * Greater than 0 values rotate counterclockwise (to the left). + * @example + *
    + * + * let cam; + * let delta = 0.01; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * cam = createCamera(); + * // set initial pan angle + * cam.pan(-0.8); + * } + * + * function draw() { + * background(200); + * + * // pan camera according to angle 'delta' + * cam.pan(delta); + * + * // every 160 frames, switch direction + * if (frameCount % 160 === 0) { + * delta *= -1; + * } + * + * rotateX(frameCount * 0.01); + * translate(-100, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * } + * + *
    + * + * @alt + * camera view pans left and right across a series of rotating 3D boxes. + * + */ +p5.Camera.prototype.pan = function(amount) { + var local = this._getLocalAxes(); + this._rotateView(amount, local.y[0], local.y[1], local.y[2]); +}; + +/** + * Tilting rotates the camera view up and down. + * @method tilt + * @param {Number} angle amount to rotate camera in current + * angleMode units. + * Greater than 0 values rotate counterclockwise (to the left). + * @example + *
    + * + * let cam; + * let delta = 0.01; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * cam = createCamera(); + * // set initial tilt + * cam.tilt(-0.8); + * } + * + * function draw() { + * background(200); + * + * // pan camera according to angle 'delta' + * cam.tilt(delta); + * + * // every 160 frames, switch direction + * if (frameCount % 160 === 0) { + * delta *= -1; + * } + * + * rotateY(frameCount * 0.01); + * translate(0, -100, 0); + * box(20); + * translate(0, 35, 0); + * box(20); + * translate(0, 35, 0); + * box(20); + * translate(0, 35, 0); + * box(20); + * translate(0, 35, 0); + * box(20); + * translate(0, 35, 0); + * box(20); + * translate(0, 35, 0); + * box(20); + * } + * + *
    + * + * @alt + * camera view tilts up and down across a series of rotating 3D boxes. + */ +p5.Camera.prototype.tilt = function(amount) { + var local = this._getLocalAxes(); + this._rotateView(amount, local.x[0], local.x[1], local.x[2]); +}; + +/** + * Reorients the camera to look at a position in world space. + * @method lookAt + * @for p5.Camera + * @param {Number} x x position of a point in world space + * @param {Number} y y position of a point in world space + * @param {Number} z z position of a point in world space + * @example + *
    + * + * let cam; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * cam = createCamera(); + * } + * + * function draw() { + * background(200); + * + * // look at a new random point every 60 frames + * if (frameCount % 60 === 0) { + * cam.lookAt(random(-100, 100), random(-50, 50), 0); + * } + * + * rotateX(frameCount * 0.01); + * translate(-100, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * } + * + *
    + * + * @alt + * camera view of rotating 3D cubes changes to look at a new random + * point every second . + */ +p5.Camera.prototype.lookAt = function(x, y, z) { + this.camera( + this.eyeX, + this.eyeY, + this.eyeZ, + x, + y, + z, + this.upX, + this.upY, + this.upZ + ); +}; + +//////////////////////////////////////////////////////////////////////////////// +// Camera Position Methods +//////////////////////////////////////////////////////////////////////////////// + +/** + * Sets a camera's position and orientation. This is equivalent to calling + * camera() on a p5.Camera object. + * @method camera + * @for p5.Camera + */ +p5.Camera.prototype.camera = function( + eyeX, + eyeY, + eyeZ, + centerX, + centerY, + centerZ, + upX, + upY, + upZ +) { + if (typeof eyeX === 'undefined') { + eyeX = this.defaultEyeX; + eyeY = this.defaultEyeY; + eyeZ = this.defaultEyeZ; + centerX = eyeX; + centerY = eyeY; + centerZ = 0; + upX = 0; + upY = 1; + upZ = 0; + } + + this.eyeX = eyeX; + this.eyeY = eyeY; + this.eyeZ = eyeZ; + + this.centerX = centerX; + this.centerY = centerY; + this.centerZ = centerZ; + + this.upX = upX; + this.upY = upY; + this.upZ = upZ; + + var local = this._getLocalAxes(); + + // the camera affects the model view matrix, insofar as it + // inverse translates the world to the eye position of the camera + // and rotates it. + // prettier-ignore + this.cameraMatrix.set(local.x[0], local.y[0], local.z[0], 0, + local.x[1], local.y[1], local.z[1], 0, + local.x[2], local.y[2], local.z[2], 0, + 0, 0, 0, 1); + + var tx = -eyeX; + var ty = -eyeY; + var tz = -eyeZ; + + this.cameraMatrix.translate([tx, ty, tz]); + + if (this._isActive()) { + this._renderer.uMVMatrix.set( + this.cameraMatrix.mat4[0], + this.cameraMatrix.mat4[1], + this.cameraMatrix.mat4[2], + this.cameraMatrix.mat4[3], + this.cameraMatrix.mat4[4], + this.cameraMatrix.mat4[5], + this.cameraMatrix.mat4[6], + this.cameraMatrix.mat4[7], + this.cameraMatrix.mat4[8], + this.cameraMatrix.mat4[9], + this.cameraMatrix.mat4[10], + this.cameraMatrix.mat4[11], + this.cameraMatrix.mat4[12], + this.cameraMatrix.mat4[13], + this.cameraMatrix.mat4[14], + this.cameraMatrix.mat4[15] + ); + } + return this; +}; + +/** + * Move camera along its local axes while maintaining current camera orientation. + * @method move + * @param {Number} x amount to move along camera's left-right axis + * @param {Number} y amount to move along camera's up-down axis + * @param {Number} z amount to move along camera's forward-backward axis + * @example + *
    + * + * // see the camera move along its own axes while maintaining its orientation + * let cam; + * let delta = 0.5; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * cam = createCamera(); + * } + * + * function draw() { + * background(200); + * + * // move the camera along its local axes + * cam.move(delta, delta, 0); + * + * // every 100 frames, switch direction + * if (frameCount % 150 === 0) { + * delta *= -1; + * } + * + * translate(-10, -10, 0); + * box(50, 8, 50); + * translate(15, 15, 0); + * box(50, 8, 50); + * translate(15, 15, 0); + * box(50, 8, 50); + * translate(15, 15, 0); + * box(50, 8, 50); + * translate(15, 15, 0); + * box(50, 8, 50); + * translate(15, 15, 0); + * box(50, 8, 50); + * } + * + *
    + * + * @alt + * camera view moves along a series of 3D boxes, maintaining the same + * orientation throughout the move + */ +p5.Camera.prototype.move = function(x, y, z) { + var local = this._getLocalAxes(); + + // scale local axes by movement amounts + // based on http://learnwebgl.brown37.net/07_cameras/camera_linear_motion.html + var dx = [local.x[0] * x, local.x[1] * x, local.x[2] * x]; + var dy = [local.y[0] * y, local.y[1] * y, local.y[2] * y]; + var dz = [local.z[0] * z, local.z[1] * z, local.z[2] * z]; + + this.camera( + this.eyeX + dx[0] + dy[0] + dz[0], + this.eyeY + dx[1] + dy[1] + dz[1], + this.eyeZ + dx[2] + dy[2] + dz[2], + this.centerX + dx[0] + dy[0] + dz[0], + this.centerY + dx[1] + dy[1] + dz[1], + this.centerZ + dx[2] + dy[2] + dz[2], + 0, + 1, + 0 + ); +}; + +/** + * Set camera position in world-space while maintaining current camera + * orientation. + * @method setPosition + * @param {Number} x x position of a point in world space + * @param {Number} y y position of a point in world space + * @param {Number} z z position of a point in world space + * @example + *
    + * + * // press '1' '2' or '3' keys to set camera position + * + * let cam; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * cam = createCamera(); + * } + * + * function draw() { + * background(200); + * + * // '1' key + * if (keyIsDown(49)) { + * cam.setPosition(30, 0, 80); + * } + * // '2' key + * if (keyIsDown(50)) { + * cam.setPosition(0, 0, 80); + * } + * // '3' key + * if (keyIsDown(51)) { + * cam.setPosition(-30, 0, 80); + * } + * + * box(20); + * } + * + *
    + * + * @alt + * camera position changes as the user presses keys, altering view of a 3D box + */ +p5.Camera.prototype.setPosition = function(x, y, z) { + var diffX = x - this.eyeX; + var diffY = y - this.eyeY; + var diffZ = z - this.eyeZ; + + this.camera( + x, + y, + z, + this.centerX + diffX, + this.centerY + diffY, + this.centerZ + diffZ, + 0, + 1, + 0 + ); +}; + +//////////////////////////////////////////////////////////////////////////////// +// Camera Helper Methods +//////////////////////////////////////////////////////////////////////////////// + +// @TODO: combine this function with _setDefaultCamera to compute these values +// as-needed +p5.Camera.prototype._computeCameraDefaultSettings = function() { + this.defaultCameraFOV = 60 / 180 * Math.PI; + this.defaultAspectRatio = this._renderer.width / this._renderer.height; + this.defaultEyeX = 0; + this.defaultEyeY = 0; + this.defaultEyeZ = + this._renderer.height / 2.0 / Math.tan(this.defaultCameraFOV / 2.0); + this.defaultCenterX = 0; + this.defaultCenterY = 0; + this.defaultCenterZ = 0; + this.defaultCameraNear = this.defaultEyeZ * 0.1; + this.defaultCameraFar = this.defaultEyeZ * 10; +}; + +//detect if user didn't set the camera +//then call this function below +p5.Camera.prototype._setDefaultCamera = function() { + this.cameraFOV = this.defaultCameraFOV; + this.aspectRatio = this.defaultAspectRatio; + this.eyeX = this.defaultEyeX; + this.eyeY = this.defaultEyeY; + this.eyeZ = this.defaultEyeZ; + this.centerX = this.defaultCenterX; + this.centerY = this.defaultCenterY; + this.centerZ = this.defaultCenterZ; + this.upX = 0; + this.upY = 1; + this.upZ = 0; + this.cameraNear = this.defaultCameraNear; + this.cameraFar = this.defaultCameraFar; + + this.perspective(); + this.camera(); + + this.cameraType = 'default'; +}; + +p5.Camera.prototype._resize = function() { + // If we're using the default camera, update the aspect ratio + if (this.cameraType === 'default') { + this._computeCameraDefaultSettings(); + this._setDefaultCamera(); + } else { + this.perspective( + this.cameraFOV, + this._renderer.width / this._renderer.height + ); + } +}; + +/** + * Returns a copy of a camera. + * @method copy + * @private + */ +p5.Camera.prototype.copy = function() { + var _cam = new p5.Camera(this._renderer); + _cam.cameraFOV = this.cameraFOV; + _cam.aspectRatio = this.aspectRatio; + _cam.eyeX = this.eyeX; + _cam.eyeY = this.eyeY; + _cam.eyeZ = this.eyeZ; + _cam.centerX = this.centerX; + _cam.centerY = this.centerY; + _cam.centerZ = this.centerZ; + _cam.cameraNear = this.cameraNear; + _cam.cameraFar = this.cameraFar; + + _cam.cameraType = this.cameraType; + + _cam.cameraMatrix = this.cameraMatrix.copy(); + _cam.projMatrix = this.projMatrix.copy(); + + return _cam; +}; + +/** + * Returns a camera's local axes: left-right, up-down, and forward-backward, + * as defined by vectors in world-space. + * @method _getLocalAxes + * @private + */ +p5.Camera.prototype._getLocalAxes = function() { + // calculate camera local Z vector + var z0 = this.eyeX - this.centerX; + var z1 = this.eyeY - this.centerY; + var z2 = this.eyeZ - this.centerZ; + + // normalize camera local Z vector + var eyeDist = Math.sqrt(z0 * z0 + z1 * z1 + z2 * z2); + if (eyeDist !== 0) { + z0 /= eyeDist; + z1 /= eyeDist; + z2 /= eyeDist; + } + + // calculate camera Y vector + var y0 = this.upX; + var y1 = this.upY; + var y2 = this.upZ; + + // compute camera local X vector as up vector (local Y) cross local Z + var x0 = y1 * z2 - y2 * z1; + var x1 = -y0 * z2 + y2 * z0; + var x2 = y0 * z1 - y1 * z0; + + // recompute y = z cross x + y0 = z1 * x2 - z2 * x1; + y1 = -z0 * x2 + z2 * x0; + y2 = z0 * x1 - z1 * x0; + + // cross product gives area of parallelogram, which is < 1.0 for + // non-perpendicular unit-length vectors; so normalize x, y here: + var xmag = Math.sqrt(x0 * x0 + x1 * x1 + x2 * x2); + if (xmag !== 0) { + x0 /= xmag; + x1 /= xmag; + x2 /= xmag; + } + + var ymag = Math.sqrt(y0 * y0 + y1 * y1 + y2 * y2); + if (ymag !== 0) { + y0 /= ymag; + y1 /= ymag; + y2 /= ymag; + } + + return { + x: [x0, x1, x2], + y: [y0, y1, y2], + z: [z0, z1, z2] + }; +}; + +/** + * Orbits the camera about center point. For use with orbitControl(). + * @method _orbit + * @private + * @param {Number} dTheta change in spherical coordinate theta + * @param {Number} dPhi change in spherical coordinate phi + * @param {Number} dRadius change in radius + */ +p5.Camera.prototype._orbit = function(dTheta, dPhi, dRadius) { + var diffX = this.eyeX - this.centerX; + var diffY = this.eyeY - this.centerY; + var diffZ = this.eyeZ - this.centerZ; + + // get spherical coorinates for current camera position about origin + var camRadius = Math.sqrt(diffX * diffX + diffY * diffY + diffZ * diffZ); + // from https://github.com/mrdoob/three.js/blob/dev/src/math/Spherical.js#L72-L73 + var camTheta = Math.atan2(diffX, diffZ); // equatorial angle + var camPhi = Math.acos(Math.max(-1, Math.min(1, diffY / camRadius))); // polar angle + + // add change + camTheta += dTheta; + camPhi += dPhi; + camRadius += dRadius; + + // prevent zooming through the center: + if (camRadius < 0) { + camRadius = 0.1; + } + + // prevent rotation over the zenith / under bottom + if (camPhi > Math.PI) { + camPhi = Math.PI; + } else if (camPhi <= 0) { + camPhi = 0.001; + } + + // from https://github.com/mrdoob/three.js/blob/dev/src/math/Vector3.js#L628-L632 + var _x = Math.sin(camPhi) * camRadius * Math.sin(camTheta); + var _y = Math.cos(camPhi) * camRadius; + var _z = Math.sin(camPhi) * camRadius * Math.cos(camTheta); + + this.camera( + _x + this.centerX, + _y + this.centerY, + _z + this.centerZ, + this.centerX, + this.centerY, + this.centerZ, + 0, + 1, + 0 + ); +}; + +/** + * Returns true if camera is currently attached to renderer. + * @method _isActive + * @private + */ +p5.Camera.prototype._isActive = function() { + return this === this._renderer._curCamera; +}; + +/** + * Sets rendererGL's current camera to a p5.Camera object. Allows switching + * between multiple cameras. + * @method setCamera + * @param {p5.Camera} cam p5.Camera object + * @for p5 + * @example + *
    + * + * let cam1, cam2; + * let currentCamera; + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * normalMaterial(); + * + * cam1 = createCamera(); + * cam2 = createCamera(); + * cam2.setPosition(30, 0, 50); + * cam2.lookAt(0, 0, 0); + * cam2.ortho(); + * + * // set variable for previously active camera: + * currentCamera = 1; + * } + * + * function draw() { + * background(200); + * + * // camera 1: + * cam1.lookAt(0, 0, 0); + * cam1.setPosition(sin(frameCount / 60) * 200, 0, 100); + * + * // every 100 frames, switch between the two cameras + * if (frameCount % 100 === 0) { + * if (currentCamera === 1) { + * setCamera(cam1); + * currentCamera = 0; + * } else { + * setCamera(cam2); + * currentCamera = 1; + * } + * } + * + * drawBoxes(); + * } + * + * function drawBoxes() { + * rotateX(frameCount * 0.01); + * translate(-100, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * translate(35, 0, 0); + * box(20); + * } + * + *
    + * + * @alt + * Canvas switches between two camera views, each showing a series of spinning + * 3D boxes. + */ +p5.prototype.setCamera = function(cam) { + this._renderer._curCamera = cam; + + // set the projection matrix (which is not normally updated each frame) + this._renderer.uPMatrix.set( + cam.projMatrix.mat4[0], + cam.projMatrix.mat4[1], + cam.projMatrix.mat4[2], + cam.projMatrix.mat4[3], + cam.projMatrix.mat4[4], + cam.projMatrix.mat4[5], + cam.projMatrix.mat4[6], + cam.projMatrix.mat4[7], + cam.projMatrix.mat4[8], + cam.projMatrix.mat4[9], + cam.projMatrix.mat4[10], + cam.projMatrix.mat4[11], + cam.projMatrix.mat4[12], + cam.projMatrix.mat4[13], + cam.projMatrix.mat4[14], + cam.projMatrix.mat4[15] + ); +}; + +module.exports = p5.Camera; + +},{"../core/main":24}],70:[function(_dereq_,module,exports){ +//some of the functions are adjusted from Three.js(http://threejs.org) + +'use strict'; + +var p5 = _dereq_('../core/main'); +/** + * p5 Geometry class + * @class p5.Geometry + * @constructor + * @param {Integer} [detailX] number of vertices on horizontal surface + * @param {Integer} [detailY] number of vertices on horizontal surface + * @param {function} [callback] function to call upon object instantiation. + * + */ +p5.Geometry = function(detailX, detailY, callback) { + //an array containing every vertex + //@type [p5.Vector] + this.vertices = []; + + //an array containing every vertex for stroke drawing + this.lineVertices = []; + + //an array 1 normal per lineVertex with + //final position representing which direction to + //displace for strokeWeight + //[[0,0,-1,1], [0,1,0,-1] ...]; + this.lineNormals = []; + + //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 = []; + // a 2D array containing edge connectivity pattern for create line vertices + //based on faces for most objects; + this.edges = []; + this.detailX = detailX !== undefined ? detailX : 1; + this.detailY = detailY !== undefined ? detailY : 1; + if (callback instanceof Function) { + callback.call(this); + } + return this; // TODO: is this a constructor? +}; + +/** + * @method computeFaces + * @chainable + */ +p5.Geometry.prototype.computeFaces = function() { + this.faces.length = 0; + var sliceCount = this.detailX + 1; + var a, b, c, d; + for (var i = 0; i < this.detailY; i++) { + for (var j = 0; j < this.detailX; j++) { + a = i * sliceCount + j; // + offset; + b = i * sliceCount + j + 1; // + offset; + c = (i + 1) * sliceCount + j + 1; // + offset; + d = (i + 1) * sliceCount + j; // + offset; + this.faces.push([a, b, d]); + this.faces.push([d, b, c]); + } + } + return this; +}; + +p5.Geometry.prototype._getFaceNormal = function(faceId) { + //This assumes that vA->vB->vC is a counter-clockwise ordering + var face = this.faces[faceId]; + var vA = this.vertices[face[0]]; + var vB = this.vertices[face[1]]; + var vC = this.vertices[face[2]]; + var ab = p5.Vector.sub(vB, vA); + var ac = p5.Vector.sub(vC, vA); + var n = p5.Vector.cross(ab, ac); + var ln = p5.Vector.mag(n); + var sinAlpha = ln / (p5.Vector.mag(ab) * p5.Vector.mag(ac)); + if (sinAlpha === 0 || isNaN(sinAlpha)) { + console.warn( + 'p5.Geometry.prototype._getFaceNormal:', + 'face has colinear sides or a repeated vertex' + ); + return n; + } + if (sinAlpha > 1) sinAlpha = 1; // handle float rounding error + return n.mult(Math.asin(sinAlpha) / ln); +}; +/** + * computes smooth normals per vertex as an average of each + * face. + * @method computeNormals + * @chainable + */ +p5.Geometry.prototype.computeNormals = function() { + var vertexNormals = this.vertexNormals; + var vertices = this.vertices; + var faces = this.faces; + var iv; + + // initialize the vertexNormals array with empty vectors + vertexNormals.length = 0; + for (iv = 0; iv < vertices.length; ++iv) { + vertexNormals.push(new p5.Vector()); + } + + // loop through all the faces adding its normal to the normal + // of each of its vertices + for (var f = 0; f < faces.length; ++f) { + var face = faces[f]; + var faceNormal = this._getFaceNormal(f); + + // all three vertices get the normal added + for (var fv = 0; fv < 3; ++fv) { + var vertexIndex = face[fv]; + vertexNormals[vertexIndex].add(faceNormal); + } + } + + // normalize the normals + for (iv = 0; iv < vertices.length; ++iv) { + vertexNormals[iv].normalize(); + } + + return this; +}; + +/** + * Averages the vertex normals. Used in curved + * surfaces + * @method averageNormals + * @chainable + */ +p5.Geometry.prototype.averageNormals = function() { + for (var i = 0; i <= this.detailY; i++) { + 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 + * @method averagePoleNormals + * @chainable + */ +p5.Geometry.prototype.averagePoleNormals = function() { + //average the north pole + var sum = new p5.Vector(0, 0, 0); + for (var i = 0; i < this.detailX; i++) { + 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; +}; + +/** + * Create a 2D array for establishing stroke connections + * @private + * @chainable + */ +p5.Geometry.prototype._makeTriangleEdges = function() { + this.edges.length = 0; + if (Array.isArray(this.strokeIndices)) { + for (var i = 0, max = this.strokeIndices.length; i < max; i++) { + this.edges.push(this.strokeIndices[i]); + } + } else { + for (var j = 0; j < this.faces.length; j++) { + this.edges.push([this.faces[j][0], this.faces[j][1]]); + this.edges.push([this.faces[j][1], this.faces[j][2]]); + this.edges.push([this.faces[j][2], this.faces[j][0]]); + } + } + return this; +}; + +/** + * Create 4 vertices for each stroke line, two at the beginning position + * and two at the end position. These vertices are displaced relative to + * that line's normal on the GPU + * @private + * @chainable + */ +p5.Geometry.prototype._edgesToVertices = function() { + this.lineVertices.length = 0; + this.lineNormals.length = 0; + + for (var i = 0; i < this.edges.length; i++) { + var begin = this.vertices[this.edges[i][0]]; + var end = this.vertices[this.edges[i][1]]; + var dir = end + .copy() + .sub(begin) + .normalize(); + var a = begin.array(); + var b = begin.array(); + var c = end.array(); + var d = end.array(); + var dirAdd = dir.array(); + var dirSub = dir.array(); + // below is used to displace the pair of vertices at beginning and end + // in opposite directions + dirAdd.push(1); + dirSub.push(-1); + this.lineNormals.push(dirAdd, dirSub, dirAdd, dirAdd, dirSub, dirSub); + this.lineVertices.push(a, b, c, c, b, d); + } + return this; +}; + +/** + * Modifies all vertices to be centered within the range -100 to 100. + * @method normalize + * @chainable + */ +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/main":24}],71:[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/main'); + +var GLMAT_ARRAY_TYPE = Array; +var isMatrixArray = function(x) { + return x instanceof Array; +}; +if (typeof Float32Array !== 'undefined') { + GLMAT_ARRAY_TYPE = Float32Array; + isMatrixArray = function(x) { + return x instanceof Array || x instanceof Float32Array; + }; +} + +/** + * A class to describe a 4x4 matrix + * for model and view matrix manipulation in the p5js webgl renderer. + * @class p5.Matrix + * @private + * @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.length && args[args.length - 1] instanceof p5) { + this.p5 = args[args.length - 1]; + } + + if (args[0] === 'mat3') { + this.mat3 = Array.isArray(args[1]) + ? args[1] + : new GLMAT_ARRAY_TYPE([1, 0, 0, 0, 1, 0, 0, 0, 1]); + } else { + this.mat4 = Array.isArray(args[0]) + ? args[0] + : new GLMAT_ARRAY_TYPE([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]); + } + 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. + * + * @method set + * @param {p5.Matrix|Float32Array|Number[]} [inMatrix] the input p5.Matrix or + * an Array of length 16 + * @chainable + */ +/** + * @method set + * @param {Number[]} elements 16 numbers passed by value to avoid + * array copying. + * @chainable + */ +p5.Matrix.prototype.set = function(inMatrix) { + if (inMatrix instanceof p5.Matrix) { + this.mat4 = inMatrix.mat4; + return this; + } else if (isMatrixArray(inMatrix)) { + this.mat4 = inMatrix; + return this; + } else if (arguments.length === 16) { + this.mat4[0] = arguments[0]; + this.mat4[1] = arguments[1]; + this.mat4[2] = arguments[2]; + this.mat4[3] = arguments[3]; + this.mat4[4] = arguments[4]; + this.mat4[5] = arguments[5]; + this.mat4[6] = arguments[6]; + this.mat4[7] = arguments[7]; + this.mat4[8] = arguments[8]; + this.mat4[9] = arguments[9]; + this.mat4[10] = arguments[10]; + this.mat4[11] = arguments[11]; + this.mat4[12] = arguments[12]; + this.mat4[13] = arguments[13]; + this.mat4[14] = arguments[14]; + this.mat4[15] = arguments[15]; + } + return this; +}; + +/** + * Gets a copy of the vector, returns a p5.Matrix object. + * + * @method get + * @return {p5.Matrix} the copy of the p5.Matrix object + */ +p5.Matrix.prototype.get = function() { + return new p5.Matrix(this.mat4, this.p5); +}; + +/** + * return a copy of a matrix + * @method copy + * @return {p5.Matrix} the result matrix + */ +p5.Matrix.prototype.copy = function() { + var copied = new p5.Matrix(this.p5); + 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 + * @method identity + * @return {p5.Matrix} the result matrix + */ +p5.Matrix.identity = function(pInst) { + return new p5.Matrix(pInst); +}; + +/** + * transpose according to a given matrix + * @method transpose + * @param {p5.Matrix|Float32Array|Number[]} a the matrix to be + * based on to transpose + * @chainable + */ +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 (isMatrixArray(a)) { + 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 + * @method invert + * @param {p5.Matrix|Float32Array|Number[]} a the matrix to be + * based on to invert + * @chainable + */ +p5.Matrix.prototype.invert = function(a) { + var a00, a01, a02, a03, a10, a11, a12, a13; + var a20, a21, a22, a23, a30, a31, a32, a33; + if (a instanceof p5.Matrix) { + a00 = a.mat4[0]; + a01 = a.mat4[1]; + a02 = a.mat4[2]; + 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 (isMatrixArray(a)) { + 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; + var b01 = a00 * a12 - a02 * a10; + var b02 = a00 * a13 - a03 * a10; + var b03 = a01 * a12 - a02 * a11; + var b04 = a01 * a13 - a03 * a11; + var b05 = a02 * a13 - a03 * a12; + var b06 = a20 * a31 - a21 * a30; + var b07 = a20 * a32 - a22 * a30; + var b08 = a20 * a33 - a23 * a30; + var b09 = a21 * a32 - a22 * a31; + var b10 = a21 * a33 - a23 * a31; + var b11 = a22 * a33 - a23 * a32; + + // Calculate the determinant + var 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 + * @method invert3x3 + * @chainable + */ +p5.Matrix.prototype.invert3x3 = function() { + var a00 = this.mat3[0]; + var a01 = this.mat3[1]; + var a02 = this.mat3[2]; + var a10 = this.mat3[3]; + var a11 = this.mat3[4]; + var a12 = this.mat3[5]; + var a20 = this.mat3[6]; + var a21 = this.mat3[7]; + var a22 = this.mat3[8]; + var b01 = a22 * a11 - a12 * a21; + var b11 = -a22 * a10 + a12 * a20; + var b21 = a21 * a10 - a11 * a20; + + // Calculate the determinant + var 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 + * @method transpose3x3 + * @param {Number[]} mat3 1-dimensional array + * @chainable + */ +p5.Matrix.prototype.transpose3x3 = function(mat3) { + var a01 = mat3[1], + a02 = mat3[2], + a12 = mat3[5]; + 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. + * @method invertTranspose + * @param {p5.Matrix} mat4 the matrix to be based on to invert + * @chainable + * @todo finish implementation + */ +p5.Matrix.prototype.inverseTranspose = function(matrix) { + if (this.mat3 === undefined) { + 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]; + } + + var inverse = this.invert3x3(); + // check inverse succeded + if (inverse) { + inverse.transpose3x3(this.mat3); + } else { + // in case of singularity, just zero the matrix + for (var i = 0; i < 9; i++) { + this.mat3[i] = 0; + } + } + return this; +}; + +/** + * inspired by Toji's mat4 determinant + * @method determinant + * @return {Number} Determinant of our 4x4 matrix + */ +p5.Matrix.prototype.determinant = function() { + var d00 = this.mat4[0] * this.mat4[5] - this.mat4[1] * this.mat4[4], + d01 = this.mat4[0] * this.mat4[6] - this.mat4[2] * this.mat4[4], + d02 = this.mat4[0] * this.mat4[7] - this.mat4[3] * this.mat4[4], + d03 = this.mat4[1] * this.mat4[6] - this.mat4[2] * this.mat4[5], + d04 = this.mat4[1] * this.mat4[7] - this.mat4[3] * this.mat4[5], + d05 = this.mat4[2] * this.mat4[7] - this.mat4[3] * this.mat4[6], + d06 = this.mat4[8] * this.mat4[13] - this.mat4[9] * this.mat4[12], + d07 = this.mat4[8] * this.mat4[14] - this.mat4[10] * this.mat4[12], + d08 = this.mat4[8] * this.mat4[15] - this.mat4[11] * this.mat4[12], + d09 = this.mat4[9] * this.mat4[14] - this.mat4[10] * this.mat4[13], + d10 = this.mat4[9] * this.mat4[15] - this.mat4[11] * this.mat4[13], + d11 = this.mat4[10] * this.mat4[15] - this.mat4[11] * this.mat4[14]; + + // Calculate the determinant + return d00 * d11 - d01 * d10 + d02 * d09 + d03 * d08 - d04 * d07 + d05 * d06; +}; + +/** + * multiply two mat4s + * @method mult + * @param {p5.Matrix|Float32Array|Number[]} multMatrix The matrix + * we want to multiply by + * @chainable + */ +p5.Matrix.prototype.mult = function(multMatrix) { + var _src; + + if (multMatrix === this || multMatrix === this.mat4) { + _src = this.copy().mat4; // only need to allocate in this rare case + } else if (multMatrix instanceof p5.Matrix) { + _src = multMatrix.mat4; + } else if (isMatrixArray(multMatrix)) { + _src = multMatrix; + } else if (arguments.length === 16) { + _src = arguments; + } else { + return; // nothing to do. + } + + // each row is used for the multiplier + var b0 = this.mat4[0], + b1 = this.mat4[1], + b2 = this.mat4[2], + b3 = this.mat4[3]; + this.mat4[0] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12]; + this.mat4[1] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13]; + this.mat4[2] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14]; + this.mat4[3] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15]; + + b0 = this.mat4[4]; + b1 = this.mat4[5]; + b2 = this.mat4[6]; + b3 = this.mat4[7]; + this.mat4[4] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12]; + this.mat4[5] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13]; + this.mat4[6] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14]; + this.mat4[7] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15]; + + b0 = this.mat4[8]; + b1 = this.mat4[9]; + b2 = this.mat4[10]; + b3 = this.mat4[11]; + this.mat4[8] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12]; + this.mat4[9] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13]; + this.mat4[10] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14]; + this.mat4[11] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15]; + + b0 = this.mat4[12]; + b1 = this.mat4[13]; + b2 = this.mat4[14]; + b3 = this.mat4[15]; + this.mat4[12] = b0 * _src[0] + b1 * _src[4] + b2 * _src[8] + b3 * _src[12]; + this.mat4[13] = b0 * _src[1] + b1 * _src[5] + b2 * _src[9] + b3 * _src[13]; + this.mat4[14] = b0 * _src[2] + b1 * _src[6] + b2 * _src[10] + b3 * _src[14]; + this.mat4[15] = b0 * _src[3] + b1 * _src[7] + b2 * _src[11] + b3 * _src[15]; + + return this; +}; + +p5.Matrix.prototype.apply = function(multMatrix) { + var _src; + + if (multMatrix === this || multMatrix === this.mat4) { + _src = this.copy().mat4; // only need to allocate in this rare case + } else if (multMatrix instanceof p5.Matrix) { + _src = multMatrix.mat4; + } else if (isMatrixArray(multMatrix)) { + _src = multMatrix; + } else if (arguments.length === 16) { + _src = arguments; + } else { + return; // nothing to do. + } + + var mat4 = this.mat4; + + // each row is used for the multiplier + var m0 = mat4[0]; + var m4 = mat4[4]; + var m8 = mat4[8]; + var m12 = mat4[12]; + mat4[0] = _src[0] * m0 + _src[1] * m4 + _src[2] * m8 + _src[3] * m12; + mat4[4] = _src[4] * m0 + _src[5] * m4 + _src[6] * m8 + _src[7] * m12; + mat4[8] = _src[8] * m0 + _src[9] * m4 + _src[10] * m8 + _src[11] * m12; + mat4[12] = _src[12] * m0 + _src[13] * m4 + _src[14] * m8 + _src[15] * m12; + + var m1 = mat4[1]; + var m5 = mat4[5]; + var m9 = mat4[9]; + var m13 = mat4[13]; + mat4[1] = _src[0] * m1 + _src[1] * m5 + _src[2] * m9 + _src[3] * m13; + mat4[5] = _src[4] * m1 + _src[5] * m5 + _src[6] * m9 + _src[7] * m13; + mat4[9] = _src[8] * m1 + _src[9] * m5 + _src[10] * m9 + _src[11] * m13; + mat4[13] = _src[12] * m1 + _src[13] * m5 + _src[14] * m9 + _src[15] * m13; + + var m2 = mat4[2]; + var m6 = mat4[6]; + var m10 = mat4[10]; + var m14 = mat4[14]; + mat4[2] = _src[0] * m2 + _src[1] * m6 + _src[2] * m10 + _src[3] * m14; + mat4[6] = _src[4] * m2 + _src[5] * m6 + _src[6] * m10 + _src[7] * m14; + mat4[10] = _src[8] * m2 + _src[9] * m6 + _src[10] * m10 + _src[11] * m14; + mat4[14] = _src[12] * m2 + _src[13] * m6 + _src[14] * m10 + _src[15] * m14; + + var m3 = mat4[3]; + var m7 = mat4[7]; + var m11 = mat4[11]; + var m15 = mat4[15]; + mat4[3] = _src[0] * m3 + _src[1] * m7 + _src[2] * m11 + _src[3] * m15; + mat4[7] = _src[4] * m3 + _src[5] * m7 + _src[6] * m11 + _src[7] * m15; + mat4[11] = _src[8] * m3 + _src[9] * m7 + _src[10] * m11 + _src[11] * m15; + mat4[15] = _src[12] * m3 + _src[13] * m7 + _src[14] * m11 + _src[15] * m15; + + return this; +}; + +/** + * scales a p5.Matrix by scalars or a vector + * @method scale + * @param {p5.Vector|Float32Array|Number[]} s vector to scale by + * @chainable + */ +p5.Matrix.prototype.scale = function(x, y, z) { + if (x instanceof p5.Vector) { + // x is a vector, extract the components from it. + y = x.y; + z = x.z; + x = x.x; // must be last + } else if (x instanceof Array) { + // x is an array, extract the components from it. + y = x[1]; + z = x[2]; + x = x[0]; // must be last + } + + this.mat4[0] *= x; + this.mat4[1] *= x; + this.mat4[2] *= x; + this.mat4[3] *= x; + this.mat4[4] *= y; + this.mat4[5] *= y; + this.mat4[6] *= y; + this.mat4[7] *= y; + this.mat4[8] *= z; + this.mat4[9] *= z; + this.mat4[10] *= z; + this.mat4[11] *= z; + + return this; +}; + +/** + * rotate our Matrix around an axis by the given angle. + * @method rotate + * @param {Number} a The angle of rotation in radians + * @param {p5.Vector|Number[]} axis the axis(es) to rotate around + * @chainable + * inspired by Toji's gl-matrix lib, mat4 rotation + */ +p5.Matrix.prototype.rotate = function(a, x, y, z) { + if (x instanceof p5.Vector) { + // x is a vector, extract the components from it. + y = x.y; + z = x.z; + x = x.x; //must be last + } else if (x instanceof Array) { + // x is an array, extract the components from it. + y = x[1]; + z = x[2]; + x = x[0]; //must be last + } + + var len = Math.sqrt(x * x + y * y + z * z); + x *= 1 / len; + y *= 1 / len; + z *= 1 / len; + + var a00 = this.mat4[0]; + var a01 = this.mat4[1]; + 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 + * @method translate + * @param {Number[]} v vector to translate by + * @chainable + */ +p5.Matrix.prototype.translate = function(v) { + var x = v[0], + y = v[1], + z = v[2] || 0; + this.mat4[12] += this.mat4[0] * x + this.mat4[4] * y + this.mat4[8] * z; + this.mat4[13] += this.mat4[1] * x + this.mat4[5] * y + this.mat4[9] * z; + this.mat4[14] += this.mat4[2] * x + this.mat4[6] * y + this.mat4[10] * z; + this.mat4[15] += this.mat4[3] * x + this.mat4[7] * y + this.mat4[11] * z; +}; + +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 + * @method perspective + * @param {Number} fovy [description] + * @param {Number} aspect [description] + * @param {Number} near near clipping plane + * @param {Number} far far clipping plane + * @chainable + */ +p5.Matrix.prototype.perspective = function(fovy, aspect, near, far) { + 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 + * @method ortho + * @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 + * @chainable + */ +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/main":24}],72:[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/main'); +var constants = _dereq_('../core/constants'); + +/** + * Begin shape drawing. This is a helpful way of generating + * custom shapes quickly. However in WEBGL mode, application + * performance will likely drop as a result of too many calls to + * beginShape() / endShape(). As a high performance alternative, + * please use p5.js geometry primitives. + * @private + * @method beginShape + * @param {Number} mode webgl primitives mode. beginShape supports the + * following modes: + * POINTS,LINES,LINE_STRIP,LINE_LOOP,TRIANGLES, + * TRIANGLE_STRIP,and TRIANGLE_FAN. + * @chainable + */ +p5.RendererGL.prototype.beginShape = function(mode) { + //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.vertices === undefined) { + this.immediateMode.vertices = []; + this.immediateMode.edges = []; + this.immediateMode.lineVertices = []; + this.immediateMode.vertexColors = []; + this.immediateMode.lineNormals = []; + this.immediateMode.uvCoords = []; + this.immediateMode.vertexBuffer = this.GL.createBuffer(); + this.immediateMode.colorBuffer = this.GL.createBuffer(); + this.immediateMode.uvBuffer = this.GL.createBuffer(); + this.immediateMode.lineVertexBuffer = this.GL.createBuffer(); + this.immediateMode.lineNormalBuffer = this.GL.createBuffer(); + this.immediateMode.pointVertexBuffer = this.GL.createBuffer(); + this.immediateMode._bezierVertex = []; + this.immediateMode._quadraticVertex = []; + this.immediateMode._curveVertex = []; + } else { + this.immediateMode.vertices.length = 0; + this.immediateMode.edges.length = 0; + this.immediateMode.lineVertices.length = 0; + this.immediateMode.lineNormals.length = 0; + this.immediateMode.vertexColors.length = 0; + this.immediateMode.uvCoords.length = 0; + } + this.isImmediateDrawing = true; + return this; +}; +/** + * adds a vertex to be drawn in a custom Shape. + * @private + * @method vertex + * @param {Number} x x-coordinate of vertex + * @param {Number} y y-coordinate of vertex + * @param {Number} z z-coordinate of vertex + * @chainable + * @TODO implement handling of p5.Vector args + */ +p5.RendererGL.prototype.vertex = function(x, y) { + var z, u, v; + + // default to (x, y) mode: all other arugments assumed to be 0. + z = u = v = 0; + + if (arguments.length === 3) { + // (x, y, z) mode: (u, v) assumed to be 0. + z = arguments[2]; + } else if (arguments.length === 4) { + // (x, y, u, v) mode: z assumed to be 0. + u = arguments[2]; + v = arguments[3]; + } else if (arguments.length === 5) { + // (x, y, z, u, v) mode + z = arguments[2]; + u = arguments[3]; + v = arguments[4]; + } + var vert = new p5.Vector(x, y, z); + this.immediateMode.vertices.push(vert); + var vertexColor = this.curFillColor || [0.5, 0.5, 0.5, 1.0]; + this.immediateMode.vertexColors.push( + vertexColor[0], + vertexColor[1], + vertexColor[2], + vertexColor[3] + ); + + if (this.textureMode === constants.IMAGE) { + if (this._tex !== null) { + if (this._tex.width > 0 && this._tex.height > 0) { + u /= this._tex.width; + v /= this._tex.height; + } + } else if (this._tex === null && arguments.length >= 4) { + // Only throw this warning if custom uv's have been provided + console.warn( + 'You must first call texture() before using' + + ' vertex() with image based u and v coordinates' + ); + } + } + + this.immediateMode.uvCoords.push(u, v); + + this.immediateMode._bezierVertex[0] = x; + this.immediateMode._bezierVertex[1] = y; + this.immediateMode._bezierVertex[2] = z; + + this.immediateMode._quadraticVertex[0] = x; + this.immediateMode._quadraticVertex[1] = y; + this.immediateMode._quadraticVertex[2] = z; + + return this; +}; + +/** + * End shape drawing and render vertices to screen. + * @chainable + */ +p5.RendererGL.prototype.endShape = function( + mode, + isCurve, + isBezier, + isQuadratic, + isContour, + shapeKind +) { + if (this.immediateMode.shapeMode === constants.POINTS) { + this._drawPoints( + this.immediateMode.vertices, + this.immediateMode.pointVertexBuffer + ); + } else if (this.immediateMode.vertices.length > 1) { + if (this._doStroke && this.drawMode !== constants.TEXTURE) { + if (this.immediateMode.shapeMode === constants.TRIANGLE_STRIP) { + var i; + for (i = 0; i < this.immediateMode.vertices.length - 2; i++) { + this.immediateMode.edges.push([i, i + 1]); + this.immediateMode.edges.push([i, i + 2]); + } + this.immediateMode.edges.push([i, i + 1]); + } else if (this.immediateMode.shapeMode === constants.TRIANGLES) { + for (i = 0; i < this.immediateMode.vertices.length - 2; i = i + 3) { + this.immediateMode.edges.push([i, i + 1]); + this.immediateMode.edges.push([i + 1, i + 2]); + this.immediateMode.edges.push([i + 2, i]); + } + } else if (this.immediateMode.shapeMode === constants.LINES) { + for (i = 0; i < this.immediateMode.vertices.length - 1; i = i + 2) { + this.immediateMode.edges.push([i, i + 1]); + } + } else { + for (i = 0; i < this.immediateMode.vertices.length - 1; i++) { + this.immediateMode.edges.push([i, i + 1]); + } + } + if (mode === constants.CLOSE) { + this.immediateMode.edges.push([ + this.immediateMode.vertices.length - 1, + 0 + ]); + } + + p5.Geometry.prototype._edgesToVertices.call(this.immediateMode); + this._drawStrokeImmediateMode(); + } + + if (this._doFill && this.immediateMode.shapeMode !== constants.LINES) { + if (this.isBezier || this.isQuadratic || this.isCurve) { + var contours = [ + new Float32Array(this._vToNArray(this.immediateMode.vertices)) + ]; + var polyTriangles = this._triangulate(contours); + this.immediateMode.vertices = []; + for ( + var j = 0, polyTriLength = polyTriangles.length; + j < polyTriLength; + j = j + 3 + ) { + this.vertex( + polyTriangles[j], + polyTriangles[j + 1], + polyTriangles[j + 2] + ); + } + } + this._drawFillImmediateMode( + mode, + isCurve, + isBezier, + isQuadratic, + isContour, + shapeKind + ); + } + } + //clear out our vertexPositions & colors arrays + //after rendering + this.immediateMode.vertices.length = 0; + this.immediateMode.vertexColors.length = 0; + this.immediateMode.uvCoords.length = 0; + this.isImmediateDrawing = false; + this.isBezier = false; + this.isQuadratic = false; + this.isCurve = false; + this.immediateMode._bezierVertex.length = 0; + this.immediateMode._quadraticVertex.length = 0; + + this.immediateMode._curveVertex.length = 0; + + return this; +}; + +p5.RendererGL.prototype._drawFillImmediateMode = function( + mode, + isCurve, + isBezier, + isQuadratic, + isContour, + shapeKind +) { + var gl = this.GL; + var shader = this._getImmediateFillShader(); + this._setFillUniforms(shader); + + // initialize the fill shader's 'aPosition' buffer + if (shader.attributes.aPosition) { + //vertex position Attribute + this._bindBuffer( + this.immediateMode.vertexBuffer, + gl.ARRAY_BUFFER, + this._vToNArray(this.immediateMode.vertices), + Float32Array, + gl.DYNAMIC_DRAW + ); + + shader.enableAttrib( + shader.attributes.aPosition.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // initialize the fill shader's 'aVertexColor' buffer + if (this.drawMode === constants.FILL && shader.attributes.aVertexColor) { + this._bindBuffer( + this.immediateMode.colorBuffer, + gl.ARRAY_BUFFER, + this.immediateMode.vertexColors, + Float32Array, + gl.DYNAMIC_DRAW + ); + + shader.enableAttrib( + shader.attributes.aVertexColor.location, + 4, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // initialize the fill shader's 'aTexCoord' buffer + if (this.drawMode === constants.TEXTURE && shader.attributes.aTexCoord) { + //texture coordinate Attribute + this._bindBuffer( + this.immediateMode.uvBuffer, + gl.ARRAY_BUFFER, + this.immediateMode.uvCoords, + Float32Array, + gl.DYNAMIC_DRAW + ); + + shader.enableAttrib( + shader.attributes.aTexCoord.location, + 2, + gl.FLOAT, + false, + 0, + 0 + ); + } + + //if (true || mode) { + if (this.drawMode === constants.FILL || this.drawMode === constants.TEXTURE) { + switch (this.immediateMode.shapeMode) { + case constants.LINE_STRIP: + case constants.LINES: + case constants.TRIANGLES: + this.immediateMode.shapeMode = + this.isBezier || + this.isQuadratic || + this.isCurve || + this.immediateMode.shapeMode === constants.TRIANGLES + ? constants.TRIANGLES + : constants.TRIANGLE_FAN; + break; + } + } else { + switch (this.immediateMode.shapeMode) { + case constants.LINE_STRIP: + case constants.LINES: + this.immediateMode.shapeMode = constants.LINE_LOOP; + break; + } + } + //} + //QUADS & QUAD_STRIP are not supported primitives modes + //in webgl. + if ( + this.immediateMode.shapeMode === constants.QUADS || + this.immediateMode.shapeMode === constants.QUAD_STRIP + ) { + throw new Error( + 'sorry, ' + + this.immediateMode.shapeMode + + ' not yet implemented in webgl mode.' + ); + } else { + this._applyColorBlend(this.curFillColor); + gl.enable(gl.BLEND); + gl.drawArrays( + this.immediateMode.shapeMode, + 0, + this.immediateMode.vertices.length + ); + + this._pixelsState._pixelsDirty = true; + } + // todo / optimizations? leave bound until another shader is set? + shader.unbindShader(); +}; + +p5.RendererGL.prototype._drawStrokeImmediateMode = function() { + var gl = this.GL; + var shader = this._getImmediateStrokeShader(); + this._setStrokeUniforms(shader); + + // initialize the stroke shader's 'aPosition' buffer + if (shader.attributes.aPosition) { + this._bindBuffer( + this.immediateMode.lineVertexBuffer, + gl.ARRAY_BUFFER, + this._flatten(this.immediateMode.lineVertices), + Float32Array, + gl.STATIC_DRAW + ); + + shader.enableAttrib( + shader.attributes.aPosition.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // initialize the stroke shader's 'aDirection' buffer + if (shader.attributes.aDirection) { + this._bindBuffer( + this.immediateMode.lineNormalBuffer, + gl.ARRAY_BUFFER, + this._flatten(this.immediateMode.lineNormals), + Float32Array, + gl.STATIC_DRAW + ); + shader.enableAttrib( + shader.attributes.aDirection.location, + 4, + gl.FLOAT, + false, + 0, + 0 + ); + } + + this._applyColorBlend(this.curStrokeColor); + gl.drawArrays(gl.TRIANGLES, 0, this.immediateMode.lineVertices.length); + + this._pixelsState._pixelsDirty = true; + + shader.unbindShader(); +}; + +module.exports = p5.RendererGL; + +},{"../core/constants":18,"../core/main":24}],73:[function(_dereq_,module,exports){ +//Retained Mode. The default mode for rendering 3D primitives +//in WEBGL. +'use strict'; + +var p5 = _dereq_('../core/main'); + +var hashCount = 0; +/** + * _initBufferDefaults + * @private + * @description initializes buffer defaults. runs each time a new geometry is + * registered + * @param {String} gId key of the geometry object + */ +p5.RendererGL.prototype._initBufferDefaults = function(gId) { + this._freeBuffers(gId); + + //@TODO remove this limit on hashes in gHash + hashCount++; + if (hashCount > 1000) { + var key = Object.keys(this.gHash)[0]; + delete this.gHash[key]; + hashCount--; + } + + //create a new entry in our gHash + this.gHash[gId] = {}; +}; + +p5.RendererGL.prototype._freeBuffers = function(gId) { + var geometry = this.gHash[gId]; + if (!geometry) { + return; + } + + delete this.gHash[gId]; + hashCount--; + + var gl = this.GL; + geometry.vertexBuffer && gl.deleteBuffer(geometry.vertexBuffer); + geometry.normalBuffer && gl.deleteBuffer(geometry.normalBuffer); + geometry.lineNormalBuffer && gl.deleteBuffer(geometry.lineNormalBuffer); + geometry.uvBuffer && gl.deleteBuffer(geometry.uvBuffer); + geometry.indexBuffer && gl.deleteBuffer(geometry.indexBuffer); + geometry.lineVertexBuffer && gl.deleteBuffer(geometry.lineVertexBuffer); +}; +/** + * createBuffers description + * @private + * @param {String} gId key of the geometry object + * @param {p5.Geometry} obj contains geometry data + */ +p5.RendererGL.prototype.createBuffers = function(gId, obj) { + var gl = this.GL; + //initialize the gl buffers for our geom groups + this._initBufferDefaults(gId); + + var geometry = this.gHash[gId]; + + geometry.numberOfItems = obj.faces.length * 3; + geometry.lineVertexCount = obj.lineVertices.length; + + var strokeShader = this._getRetainedStrokeShader(); + strokeShader.bindShader(); + + // initialize the stroke shader's 'aPosition' buffer, if used + if (strokeShader.attributes.aPosition) { + geometry.lineVertexBuffer = gl.createBuffer(); + + this._bindBuffer( + geometry.lineVertexBuffer, + gl.ARRAY_BUFFER, + this._flatten(obj.lineVertices), + Float32Array, + gl.STATIC_DRAW + ); + + strokeShader.enableAttrib( + strokeShader.attributes.aPosition.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // initialize the stroke shader's 'aDirection' buffer, if used + if (strokeShader.attributes.aDirection) { + geometry.lineNormalBuffer = gl.createBuffer(); + + this._bindBuffer( + geometry.lineNormalBuffer, + gl.ARRAY_BUFFER, + this._flatten(obj.lineNormals), + Float32Array, + gl.STATIC_DRAW + ); + + strokeShader.enableAttrib( + strokeShader.attributes.aDirection.location, + 4, + gl.FLOAT, + false, + 0, + 0 + ); + } + strokeShader.unbindShader(); + + var fillShader = this._getRetainedFillShader(); + fillShader.bindShader(); + + // initialize the fill shader's 'aPosition' buffer, if used + if (fillShader.attributes.aPosition) { + geometry.vertexBuffer = gl.createBuffer(); + + // allocate space for vertex positions + this._bindBuffer( + geometry.vertexBuffer, + gl.ARRAY_BUFFER, + this._vToNArray(obj.vertices), + Float32Array, + gl.STATIC_DRAW + ); + + fillShader.enableAttrib( + fillShader.attributes.aPosition.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // allocate space for faces + geometry.indexBuffer = gl.createBuffer(); + this._bindBuffer( + geometry.indexBuffer, + gl.ELEMENT_ARRAY_BUFFER, + this._flatten(obj.faces), + Uint16Array, + gl.STATIC_DRAW + ); + + // initialize the fill shader's 'aNormal' buffer, if used + if (fillShader.attributes.aNormal) { + geometry.normalBuffer = gl.createBuffer(); + + // allocate space for normals + this._bindBuffer( + geometry.normalBuffer, + gl.ARRAY_BUFFER, + this._vToNArray(obj.vertexNormals), + Float32Array, + gl.STATIC_DRAW + ); + + fillShader.enableAttrib( + fillShader.attributes.aNormal.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // initialize the fill shader's 'aTexCoord' buffer, if used + if (fillShader.attributes.aTexCoord) { + geometry.uvBuffer = gl.createBuffer(); + + // tex coords + this._bindBuffer( + geometry.uvBuffer, + gl.ARRAY_BUFFER, + this._flatten(obj.uvs), + Float32Array, + gl.STATIC_DRAW + ); + + fillShader.enableAttrib( + fillShader.attributes.aTexCoord.location, + 2, + gl.FLOAT, + false, + 0, + 0 + ); + } + fillShader.unbindShader(); + return geometry; +}; + +/** + * Draws buffers given a geometry key ID + * @private + * @param {String} gId ID in our geom hash + * @chainable + */ +p5.RendererGL.prototype.drawBuffers = function(gId) { + var gl = this.GL; + var geometry = this.gHash[gId]; + + if (this._doStroke && geometry.lineVertexCount > 0) { + var strokeShader = this._getRetainedStrokeShader(); + this._setStrokeUniforms(strokeShader); + + // bind the stroke shader's 'aPosition' buffer + if (geometry.lineVertexBuffer) { + this._bindBuffer(geometry.lineVertexBuffer, gl.ARRAY_BUFFER); + strokeShader.enableAttrib( + strokeShader.attributes.aPosition.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // bind the stroke shader's 'aDirection' buffer + if (geometry.lineNormalBuffer) { + this._bindBuffer(geometry.lineNormalBuffer, gl.ARRAY_BUFFER); + strokeShader.enableAttrib( + strokeShader.attributes.aDirection.location, + 4, + gl.FLOAT, + false, + 0, + 0 + ); + } + + this._applyColorBlend(this.curStrokeColor); + this._drawArrays(gl.TRIANGLES, gId); + strokeShader.unbindShader(); + } + + if (this._doFill !== false) { + var fillShader = this._getRetainedFillShader(); + this._setFillUniforms(fillShader); + + // bind the fill shader's 'aPosition' buffer + if (geometry.vertexBuffer) { + //vertex position buffer + this._bindBuffer(geometry.vertexBuffer, gl.ARRAY_BUFFER); + fillShader.enableAttrib( + fillShader.attributes.aPosition.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + if (geometry.indexBuffer) { + //vertex index buffer + this._bindBuffer(geometry.indexBuffer, gl.ELEMENT_ARRAY_BUFFER); + } + + // bind the fill shader's 'aNormal' buffer + if (geometry.normalBuffer) { + this._bindBuffer(geometry.normalBuffer, gl.ARRAY_BUFFER); + fillShader.enableAttrib( + fillShader.attributes.aNormal.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + } + + // bind the fill shader's 'aTexCoord' buffer + if (geometry.uvBuffer) { + // uv buffer + this._bindBuffer(geometry.uvBuffer, gl.ARRAY_BUFFER); + fillShader.enableAttrib( + fillShader.attributes.aTexCoord.location, + 2, + gl.FLOAT, + false, + 0, + 0 + ); + } + + this._applyColorBlend(this.curFillColor); + this._drawElements(gl.TRIANGLES, gId); + fillShader.unbindShader(); + } + return this; +}; + +/** + * Calls drawBuffers() with a scaled model/view matrix. + * + * This is used by various 3d primitive methods (in primitives.js, eg. plane, + * box, torus, etc...) to allow caching of un-scaled geometries. Those + * geometries are generally created with unit-length dimensions, cached as + * such, and then scaled appropriately in this method prior to rendering. + * + * @private + * @method drawBuffersScaled + * @param {String} gId ID in our geom hash + * @param {Number} scaleX the amount to scale in the X direction + * @param {Number} scaleY the amount to scale in the Y direction + * @param {Number} scaleZ the amount to scale in the Z direction + */ +p5.RendererGL.prototype.drawBuffersScaled = function( + gId, + scaleX, + scaleY, + scaleZ +) { + var uMVMatrix = this.uMVMatrix.copy(); + try { + this.uMVMatrix.scale(scaleX, scaleY, scaleZ); + this.drawBuffers(gId); + } finally { + this.uMVMatrix = uMVMatrix; + } +}; + +p5.RendererGL.prototype._drawArrays = function(drawMode, gId) { + this.GL.drawArrays(drawMode, 0, this.gHash[gId].lineVertexCount); + this._pixelsState._pixelsDirty = true; + return this; +}; + +p5.RendererGL.prototype._drawElements = function(drawMode, gId) { + this.GL.drawElements( + drawMode, + this.gHash[gId].numberOfItems, + this.GL.UNSIGNED_SHORT, + 0 + ); + this._pixelsState._pixelsDirty = true; +}; + +p5.RendererGL.prototype._drawPoints = function(vertices, vertexBuffer) { + var gl = this.GL; + var pointShader = this._getImmediatePointShader(); + this._setPointUniforms(pointShader); + + this._bindBuffer( + vertexBuffer, + gl.ARRAY_BUFFER, + this._vToNArray(vertices), + Float32Array, + gl.STATIC_DRAW + ); + + pointShader.enableAttrib( + pointShader.attributes.aPosition.location, + 3, + gl.FLOAT, + false, + 0, + 0 + ); + + gl.drawArrays(gl.Points, 0, vertices.length); + + pointShader.unbindShader(); + this._pixelsState._pixelsDirty = true; +}; + +module.exports = p5.RendererGL; + +},{"../core/main":24}],74:[function(_dereq_,module,exports){ +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); +var libtess = _dereq_('libtess'); +_dereq_('./p5.Shader'); +_dereq_('./p5.Camera'); +_dereq_('../core/p5.Renderer'); +_dereq_('./p5.Matrix'); + + +var defaultShaders = { + immediateVert: "attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform float uResolution;\nuniform float uPointSize;\n\nvarying vec4 vColor;\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n gl_PointSize = uPointSize;\n}\n", + vertexColorVert: "attribute vec3 aPosition;\nattribute vec4 aVertexColor;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nvarying vec4 vColor;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vColor = aVertexColor;\n}\n", + vertexColorFrag: "precision mediump float;\nvarying vec4 vColor;\nvoid main(void) {\n gl_FragColor = vColor;\n}", + normalVert: "attribute vec3 aPosition;\nattribute vec3 aNormal;\nattribute vec2 aTexCoord;\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform mat3 uNormalMatrix;\n\nvarying vec3 vVertexNormal;\nvarying highp vec2 vVertTexCoord;\n\nvoid main(void) {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vVertexNormal = 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;\nuniform float uShininess;\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 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), uShininess);\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;\nuniform float uShininess;\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 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, uShininess);\n lr.diffuse = lambertDiffuse(L, N);\n return lr;\n}\n\nvoid main(void) {\n\n V = normalize(vViewPosition);\n N = vNormal;\n\n vec3 diffuse = vec3(0.0);\n float specular = 0.0;\n\n for (int j = 0; j < 8; j++) {\n if (uDirectionalLightCount == j) break;\n\n LightResult result = light(uLightingDirection[j]);\n diffuse += result.diffuse * uDirectionalColor[j];\n specular += result.specular;\n }\n\n for (int k = 0; k < 8; k++) {\n if (uPointLightCount == k) break;\n\n vec3 lightPosition = (uViewMatrix * vec4(uPointLightLocation[k], 1.0)).xyz;\n vec3 lightVector = vViewPosition - lightPosition;\n\t\n //calculate attenuation\n float lightDistance = length(lightVector);\n float falloff = 500.0 / (lightDistance + 500.0);\n\n LightResult result = light(lightVector);\n diffuse += result.diffuse * falloff * uPointLightColor[k];\n specular += result.specular * falloff;\n }\n\n gl_FragColor = isTexture ? texture2D(uSampler, vTexCoord) : uMaterialColor;\n gl_FragColor.rgb = gl_FragColor.rgb * (diffuse * diffuseFactor + vAmbientColor) + specular * specularFactor;\n}", + fontVert: "precision mediump float;\n\nattribute vec3 aPosition;\nattribute vec2 aTexCoord;\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\n\nuniform vec4 uGlyphRect;\nuniform float uGlyphOffset;\n\nvarying vec2 vTexCoord;\nvarying float w;\n\nvoid main() {\n vec4 positionVec4 = vec4(aPosition, 1.0);\n\n // scale by the size of the glyph's rectangle\n positionVec4.xy *= uGlyphRect.zw - uGlyphRect.xy;\n\n // move to the corner of the glyph\n positionVec4.xy += uGlyphRect.xy;\n\n // move to the letter's line offset\n positionVec4.x += uGlyphOffset;\n \n gl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n vTexCoord = aTexCoord;\n w = gl_Position.w;\n}\n", + fontFrag: "#extension GL_OES_standard_derivatives : enable\nprecision mediump float;\n\n#if 0\n // simulate integer math using floats\n\t#define int float\n\t#define ivec2 vec2\n\t#define INT(x) float(x)\n\n\tint ifloor(float v) { return floor(v); }\n\tivec2 ifloor(vec2 v) { return floor(v); }\n\n#else\n // use native integer math\n\tprecision mediump int;\n\t#define INT(x) x\n\n\tint ifloor(float v) { return int(v); }\n\tint ifloor(int v) { return v; }\n\tivec2 ifloor(vec2 v) { return ivec2(v); }\n\n#endif\n\nuniform sampler2D uSamplerStrokes;\nuniform sampler2D uSamplerRowStrokes;\nuniform sampler2D uSamplerRows;\nuniform sampler2D uSamplerColStrokes;\nuniform sampler2D uSamplerCols;\n\nuniform ivec2 uStrokeImageSize;\nuniform ivec2 uCellsImageSize;\nuniform ivec2 uGridImageSize;\n\nuniform ivec2 uGridOffset;\nuniform ivec2 uGridSize;\nuniform vec4 uMaterialColor;\n\nvarying vec2 vTexCoord;\n\n// some helper functions\nint round(float v) { return ifloor(v + 0.5); }\nivec2 round(vec2 v) { return ifloor(v + 0.5); }\nfloat saturate(float v) { return clamp(v, 0.0, 1.0); }\nvec2 saturate(vec2 v) { return clamp(v, 0.0, 1.0); }\n\nint mul(float v1, int v2) {\n return ifloor(v1 * float(v2));\n}\n\nivec2 mul(vec2 v1, ivec2 v2) {\n return ifloor(v1 * vec2(v2) + 0.5);\n}\n\n// unpack a 16-bit integer from a float vec2\nint getInt16(vec2 v) {\n ivec2 iv = round(v * 255.0);\n return iv.x * INT(128) + iv.y;\n}\n\nvec2 pixelScale;\nvec2 coverage = vec2(0.0);\nvec2 weight = vec2(0.5);\nconst float minDistance = 1.0/8192.0;\nconst float hardness = 1.05; // amount of antialias\n\n// the maximum number of curves in a glyph\nconst int N = INT(250);\n\n// retrieves an indexed pixel from a sampler\nvec4 getTexel(sampler2D sampler, int pos, ivec2 size) {\n int width = size.x;\n int y = ifloor(pos / width);\n int x = pos - y * width; // pos % width\n\n return texture2D(sampler, (vec2(x, y) + 0.5) / vec2(size));\n}\n\nvoid calulateCrossings(vec2 p0, vec2 p1, vec2 p2, out vec2 C1, out vec2 C2) {\n\n // get the coefficients of the quadratic in t\n vec2 a = p0 - p1 * 2.0 + p2;\n vec2 b = p0 - p1;\n vec2 c = p0 - vTexCoord;\n\n // found out which values of 't' it crosses the axes\n vec2 surd = sqrt(max(vec2(0.0), b * b - a * c));\n vec2 t1 = ((b - surd) / a).yx;\n vec2 t2 = ((b + surd) / a).yx;\n\n // approximate straight lines to avoid rounding errors\n if (abs(a.y) < 0.001)\n t1.x = t2.x = c.y / (2.0 * b.y);\n\n if (abs(a.x) < 0.001)\n t1.y = t2.y = c.x / (2.0 * b.x);\n\n // plug into quadratic formula to find the corrdinates of the crossings\n C1 = ((a * t1 - b * 2.0) * t1 + c) * pixelScale;\n C2 = ((a * t2 - b * 2.0) * t2 + c) * pixelScale;\n}\n\nvoid coverageX(vec2 p0, vec2 p1, vec2 p2) {\n\n vec2 C1, C2;\n calulateCrossings(p0, p1, p2, C1, C2);\n\n // determine on which side of the x-axis the points lie\n bool y0 = p0.y > vTexCoord.y;\n bool y1 = p1.y > vTexCoord.y;\n bool y2 = p2.y > vTexCoord.y;\n\n // could web be under the curve (after t1)?\n if (y1 ? !y2 : y0) {\n // add the coverage for t1\n coverage.x += saturate(C1.x + 0.5);\n // calculate the anti-aliasing for t1\n weight.x = min(weight.x, abs(C1.x));\n }\n\n // are we outside the curve (after t2)?\n if (y1 ? !y0 : y2) {\n // subtract the coverage for t2\n coverage.x -= saturate(C2.x + 0.5);\n // calculate the anti-aliasing for t2\n weight.x = min(weight.x, abs(C2.x));\n }\n}\n\n// this is essentially the same as coverageX, but with the axes swapped\nvoid coverageY(vec2 p0, vec2 p1, vec2 p2) {\n\n vec2 C1, C2;\n calulateCrossings(p0, p1, p2, C1, C2);\n\n bool x0 = p0.x > vTexCoord.x;\n bool x1 = p1.x > vTexCoord.x;\n bool x2 = p2.x > vTexCoord.x;\n\n if (x1 ? !x2 : x0) {\n coverage.y -= saturate(C1.y + 0.5);\n weight.y = min(weight.y, abs(C1.y));\n }\n\n if (x1 ? !x0 : x2) {\n coverage.y += saturate(C2.y + 0.5);\n weight.y = min(weight.y, abs(C2.y));\n }\n}\n\nvoid main() {\n\n // calculate the pixel scale based on screen-coordinates\n pixelScale = hardness / fwidth(vTexCoord);\n\n // which grid cell is this pixel in?\n ivec2 gridCoord = ifloor(vTexCoord * vec2(uGridSize));\n\n // intersect curves in this row\n {\n // the index into the row info bitmap\n int rowIndex = gridCoord.y + uGridOffset.y;\n // fetch the info texel\n vec4 rowInfo = getTexel(uSamplerRows, rowIndex, uGridImageSize);\n // unpack the rowInfo\n int rowStrokeIndex = getInt16(rowInfo.xy);\n int rowStrokeCount = getInt16(rowInfo.zw);\n\n for (int iRowStroke = INT(0); iRowStroke < N; iRowStroke++) {\n if (iRowStroke >= rowStrokeCount)\n break;\n\n // each stroke is made up of 3 points: the start and control point\n // and the start of the next curve.\n // fetch the indices of this pair of strokes:\n vec4 strokeIndices = getTexel(uSamplerRowStrokes, rowStrokeIndex++, uCellsImageSize);\n\n // unpack the stroke index\n int strokePos = getInt16(strokeIndices.xy);\n\n // fetch the two strokes\n vec4 stroke0 = getTexel(uSamplerStrokes, strokePos + INT(0), uStrokeImageSize);\n vec4 stroke1 = getTexel(uSamplerStrokes, strokePos + INT(1), uStrokeImageSize);\n\n // calculate the coverage\n coverageX(stroke0.xy, stroke0.zw, stroke1.xy);\n }\n }\n\n // intersect curves in this column\n {\n int colIndex = gridCoord.x + uGridOffset.x;\n vec4 colInfo = getTexel(uSamplerCols, colIndex, uGridImageSize);\n int colStrokeIndex = getInt16(colInfo.xy);\n int colStrokeCount = getInt16(colInfo.zw);\n \n for (int iColStroke = INT(0); iColStroke < N; iColStroke++) {\n if (iColStroke >= colStrokeCount)\n break;\n\n vec4 strokeIndices = getTexel(uSamplerColStrokes, colStrokeIndex++, uCellsImageSize);\n\n int strokePos = getInt16(strokeIndices.xy);\n vec4 stroke0 = getTexel(uSamplerStrokes, strokePos + INT(0), uStrokeImageSize);\n vec4 stroke1 = getTexel(uSamplerStrokes, strokePos + INT(1), uStrokeImageSize);\n coverageY(stroke0.xy, stroke0.zw, stroke1.xy);\n }\n }\n\n weight = saturate(1.0 - weight * 2.0);\n float distance = max(weight.x + weight.y, minDistance); // manhattan approx.\n float antialias = abs(dot(coverage, weight) / distance);\n float cover = min(abs(coverage.x), abs(coverage.y));\n gl_FragColor = uMaterialColor;\n gl_FragColor.a *= saturate(max(antialias, cover));\n}", + lineVert: "/*\n Part of the Processing project - http://processing.org\n Copyright (c) 2012-15 The Processing Foundation\n Copyright (c) 2004-12 Ben Fry and Casey Reas\n Copyright (c) 2001-04 Massachusetts Institute of Technology\n This library is free software; you can redistribute it and/or\n modify it under the terms of the GNU Lesser General Public\n License as published by the Free Software Foundation, version 2.1.\n This library is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n Lesser General Public License for more details.\n You should have received a copy of the GNU Lesser General\n Public License along with this library; if not, write to the\n Free Software Foundation, Inc., 59 Temple Place, Suite 330,\n Boston, MA 02111-1307 USA\n*/\n\n#define PROCESSING_LINE_SHADER\n\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nuniform float uStrokeWeight;\n\nuniform vec4 uViewport;\n\n// using a scale <1 moves the lines towards the camera\n// in order to prevent popping effects due to half of\n// the line disappearing behind the geometry faces.\nvec3 scale = vec3(0.9995);\n\nattribute vec4 aPosition;\nattribute vec4 aDirection;\n \nvoid main() {\n vec4 posp = uModelViewMatrix * aPosition;\n vec4 posq = uModelViewMatrix * (aPosition + vec4(aDirection.xyz, 0));\n\n // Moving vertices slightly toward the camera\n // to avoid depth-fighting with the fill triangles.\n // Discussed here:\n // http://www.opengl.org/discussion_boards/ubbthreads.php?ubb=showflat&Number=252848 \n posp.xyz = posp.xyz * scale;\n posq.xyz = posq.xyz * scale;\n\n vec4 p = uProjectionMatrix * posp;\n vec4 q = uProjectionMatrix * posq;\n\n // formula to convert from clip space (range -1..1) to screen space (range 0..[width or height])\n // screen_p = (p.xy/p.w + <1,1>) * 0.5 * uViewport.zw\n\n // prevent division by W by transforming the tangent formula (div by 0 causes\n // the line to disappear, see https://github.com/processing/processing/issues/5183)\n // t = screen_q - screen_p\n //\n // tangent is normalized and we don't care which aDirection it points to (+-)\n // t = +- normalize( screen_q - screen_p )\n // t = +- normalize( (q.xy/q.w+<1,1>)*0.5*uViewport.zw - (p.xy/p.w+<1,1>)*0.5*uViewport.zw )\n //\n // extract common factor, <1,1> - <1,1> cancels out\n // t = +- normalize( (q.xy/q.w - p.xy/p.w) * 0.5 * uViewport.zw )\n //\n // convert to common divisor\n // t = +- normalize( ((q.xy*p.w - p.xy*q.w) / (p.w*q.w)) * 0.5 * uViewport.zw )\n //\n // remove the common scalar divisor/factor, not needed due to normalize and +-\n // (keep uViewport - can't remove because it has different components for x and y\n // and corrects for aspect ratio, see https://github.com/processing/processing/issues/5181)\n // t = +- normalize( (q.xy*p.w - p.xy*q.w) * uViewport.zw )\n\n vec2 tangent = normalize((q.xy*p.w - p.xy*q.w) * uViewport.zw);\n\n // flip tangent to normal (it's already normalized)\n vec2 normal = vec2(-tangent.y, tangent.x);\n\n float thickness = aDirection.w * uStrokeWeight;\n vec2 offset = normal * thickness / 2.0;\n\n // Perspective ---\n // convert from world to clip by multiplying with projection scaling factor\n // to get the right thickness (see https://github.com/processing/processing/issues/5182)\n // invert Y, projections in Processing invert Y\n vec2 perspScale = (uProjectionMatrix * vec4(1, -1, 0, 0)).xy;\n\n // No Perspective ---\n // multiply by W (to cancel out division by W later in the pipeline) and\n // convert from screen to clip (derived from clip to screen above)\n vec2 noPerspScale = p.w / (0.5 * uViewport.zw);\n\n //gl_Position.xy = p.xy + offset.xy * mix(noPerspScale, perspScale, float(perspective > 0));\n gl_Position.xy = p.xy + offset.xy * perspScale;\n gl_Position.zw = p.zw;\n}\n", + lineFrag: "precision mediump float;\nprecision mediump int;\n\nuniform vec4 uMaterialColor;\n\nvoid main() {\n gl_FragColor = uMaterialColor;\n}", + pointVert: "attribute vec3 aPosition;\nuniform float uPointSize;\nvarying float vStrokeWeight;\nuniform mat4 uModelViewMatrix;\nuniform mat4 uProjectionMatrix;\nvoid main() {\n\tvec4 positionVec4 = vec4(aPosition, 1.0);\n\tgl_Position = uProjectionMatrix * uModelViewMatrix * positionVec4;\n\tgl_PointSize = uPointSize;\n\tvStrokeWeight = uPointSize;\n}", + pointFrag: "precision mediump float;\nprecision mediump int;\nuniform vec4 uMaterialColor;\nvarying float vStrokeWeight;\n\nvoid main(){\n\tfloat mask = 0.0;\n\n\t// make a circular mask using the gl_PointCoord (goes from 0 - 1 on a point)\n // might be able to get a nicer edge on big strokeweights with smoothstep but slightly less performant\n\n\tmask = step(0.98, length(gl_PointCoord * 2.0 - 1.0));\n\n\t// if strokeWeight is 1 or less lets just draw a square\n\t// this prevents weird artifacting from carving circles when our points are really small\n\t// if strokeWeight is larger than 1, we just use it as is\n\n\tmask = mix(0.0, mask, clamp(floor(vStrokeWeight - 0.5),0.0,1.0));\n\n\t// throw away the borders of the mask\n // otherwise we get weird alpha blending issues\n\n\tif(mask > 0.98){\n discard;\n \t}\n\n \tgl_FragColor = vec4(uMaterialColor.rgb * (1.0 - mask), uMaterialColor.a) ;\n}" +}; + +/** + * 3D graphics class + * @private + * @class p5.RendererGL + * @constructor + * @extends p5.Renderer + * @todo extend class to include public method for offscreen + * rendering (FBO). + * + */ +p5.RendererGL = function(elt, pInst, isMainCanvas, attr) { + p5.Renderer.call(this, elt, pInst, isMainCanvas); + this._setAttributeDefaults(pInst); + this._initContext(); + this.isP3D = true; //lets us know we're in 3d mode + this.GL = this.drawingContext; + + // lights + + this._enableLighting = false; + + this.ambientLightColors = []; + this.directionalLightDirections = []; + this.directionalLightColors = []; + + this.pointLightPositions = []; + this.pointLightColors = []; + + this.curFillColor = [1, 1, 1, 1]; + this.curStrokeColor = [0, 0, 0, 1]; + this.curBlendMode = constants.BLEND; + this.blendExt = this.GL.getExtension('EXT_blend_minmax'); + + this._useSpecularMaterial = false; + this._useNormalMaterial = false; + this._useShininess = 1; + + /** + * model view, projection, & normal + * matrices + */ + this.uMVMatrix = new p5.Matrix(); + this.uPMatrix = new p5.Matrix(); + this.uNMatrix = new p5.Matrix('mat3'); + + // Camera + this._curCamera = new p5.Camera(this); + this._curCamera._computeCameraDefaultSettings(); + this._curCamera._setDefaultCamera(); + + //Geometry & Material hashes + this.gHash = {}; + + this._defaultLightShader = undefined; + this._defaultImmediateModeShader = undefined; + this._defaultNormalShader = undefined; + this._defaultColorShader = undefined; + this._defaultPointShader = undefined; + + this._pointVertexBuffer = this.GL.createBuffer(); + + this.userFillShader = undefined; + this.userStrokeShader = undefined; + this.userPointShader = undefined; + + //Imediate Mode + //default drawing is done in Retained Mode + this.isImmediateDrawing = false; + this.immediateMode = {}; + + this.pointSize = 5.0; //default point size + this.curStrokeWeight = 1; + + // array of textures created in this gl context via this.getTexture(src) + this.textures = []; + + this.textureMode = constants.IMAGE; + // default wrap settings + this.textureWrapX = constants.CLAMP; + this.textureWrapY = constants.CLAMP; + this._tex = null; + this._curveTightness = 6; + + // lookUpTable for coefficients needed to be calculated for bezierVertex, same are used for curveVertex + this._lookUpTableBezier = []; + // lookUpTable for coefficients needed to be calculated for quadraticVertex + this._lookUpTableQuadratic = []; + + // current curveDetail in the Bezier lookUpTable + this._lutBezierDetail = 0; + // current curveDetail in the Quadratic lookUpTable + this._lutQuadraticDetail = 0; + + this._tessy = this._initTessy(); + + this.fontInfos = {}; + + return this; +}; + +p5.RendererGL.prototype = Object.create(p5.Renderer.prototype); + +////////////////////////////////////////////// +// Setting +////////////////////////////////////////////// + +p5.RendererGL.prototype._setAttributeDefaults = function(pInst) { + var defaults = { + alpha: false, + depth: true, + stencil: true, + antialias: false, + premultipliedAlpha: false, + preserveDrawingBuffer: true, + perPixelLighting: false + }; + if (pInst._glAttributes === null) { + pInst._glAttributes = defaults; + } else { + pInst._glAttributes = Object.assign(defaults, pInst._glAttributes); + } + return; +}; + +p5.RendererGL.prototype._initContext = function() { + try { + this.drawingContext = + this.canvas.getContext('webgl', this._pInst._glAttributes) || + this.canvas.getContext('experimental-webgl', this._pInst._glAttributes); + 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); + this._viewport = this.drawingContext.getParameter( + this.drawingContext.VIEWPORT + ); + } + } catch (er) { + throw er; + } +}; + +//This is helper function to reset the context anytime the attributes +//are changed with setAttributes() + +p5.RendererGL.prototype._resetContext = function(options, callback) { + var w = this.width; + var h = this.height; + var defaultId = this.canvas.id; + var c = this.canvas; + if (c) { + c.parentNode.removeChild(c); + } + c = document.createElement('canvas'); + c.id = defaultId; + if (this._pInst._userNode) { + this._pInst._userNode.appendChild(c); + } else { + document.body.appendChild(c); + } + this._pInst.canvas = c; + + var renderer = new p5.RendererGL(this._pInst.canvas, this._pInst, true); + this._pInst._setProperty('_renderer', renderer); + renderer.resize(w, h); + renderer._applyDefaults(); + this._pInst._elements.push(renderer); + + if (typeof callback === 'function') { + //setTimeout with 0 forces the task to the back of the queue, this ensures that + //we finish switching out the renderer + setTimeout(function() { + callback.apply(window._renderer, options); + }, 0); + } +}; +/** + * @module Rendering + * @submodule Rendering + * @for p5 + */ +/** + * Set attributes for the WebGL Drawing context. + * This is a way of adjusting how the WebGL + * renderer works to fine-tune the display and performance. + *

    + * Note that this will reinitialize the drawing context + * if called after the WebGL canvas is made. + *

    + * If an object is passed as the parameter, all attributes + * not declared in the object will be set to defaults. + *

    + * The available attributes are: + *
    + * alpha - indicates if the canvas contains an alpha buffer + * default is false + *

    + * depth - indicates whether the drawing buffer has a depth buffer + * of at least 16 bits - default is true + *

    + * stencil - indicates whether the drawing buffer has a stencil buffer + * of at least 8 bits + *

    + * antialias - indicates whether or not to perform anti-aliasing + * default is false + *

    + * premultipliedAlpha - indicates that the page compositor will assume + * the drawing buffer contains colors with pre-multiplied alpha + * default is false + *

    + * preserveDrawingBuffer - if true the buffers will not be cleared and + * and will preserve their values until cleared or overwritten by author + * (note that p5 clears automatically on draw loop) + * default is true + *

    + * perPixelLighting - if true, per-pixel lighting will be used in the + * lighting shader. + * default is false + *

    + * @method setAttributes + * @for p5 + * @param {String} key Name of attribute + * @param {Boolean} value New value of named attribute + * @example + *
    + * + * function setup() { + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(255); + * push(); + * rotateZ(frameCount * 0.02); + * rotateX(frameCount * 0.02); + * rotateY(frameCount * 0.02); + * fill(0, 0, 0); + * box(50); + * pop(); + * } + * + *
    + *
    + * Now with the antialias attribute set to true. + *
    + *
    + * + * function setup() { + * setAttributes('antialias', true); + * createCanvas(100, 100, WEBGL); + * } + * + * function draw() { + * background(255); + * push(); + * rotateZ(frameCount * 0.02); + * rotateX(frameCount * 0.02); + * rotateY(frameCount * 0.02); + * fill(0, 0, 0); + * box(50); + * pop(); + * } + * + *
    + * + *
    + * + * // press the mouse button to enable perPixelLighting + * function setup() { + * createCanvas(100, 100, WEBGL); + * noStroke(); + * fill(255); + * } + * + * var lights = [ + * { c: '#f00', t: 1.12, p: 1.91, r: 0.2 }, + * { c: '#0f0', t: 1.21, p: 1.31, r: 0.2 }, + * { c: '#00f', t: 1.37, p: 1.57, r: 0.2 }, + * { c: '#ff0', t: 1.12, p: 1.91, r: 0.7 }, + * { c: '#0ff', t: 1.21, p: 1.31, r: 0.7 }, + * { c: '#f0f', t: 1.37, p: 1.57, r: 0.7 } + * ]; + * + * function draw() { + * var t = millis() / 1000 + 1000; + * background(0); + * directionalLight(color('#222'), 1, 1, 1); + * + * for (var i = 0; i < lights.length; i++) { + * var light = lights[i]; + * pointLight( + * color(light.c), + * p5.Vector.fromAngles(t * light.t, t * light.p, width * light.r) + * ); + * } + * + * specularMaterial(255); + * sphere(width * 0.1); + * + * rotateX(t * 0.77); + * rotateY(t * 0.83); + * rotateZ(t * 0.91); + * torus(width * 0.3, width * 0.07, 24, 10); + * } + * + * function mousePressed() { + * setAttributes('perPixelLighting', true); + * noStroke(); + * fill(255); + * } + * function mouseReleased() { + * setAttributes('perPixelLighting', false); + * noStroke(); + * fill(255); + * } + * + *
    + * + * @alt a rotating cube with smoother edges + */ +/** + * @method setAttributes + * @for p5 + * @param {Object} obj object with key-value pairs + */ + +p5.prototype.setAttributes = function(key, value) { + var unchanged = true; + if (typeof value !== 'undefined') { + //first time modifying the attributes + if (this._glAttributes === null) { + this._glAttributes = {}; + } + if (this._glAttributes[key] !== value) { + //changing value of previously altered attribute + this._glAttributes[key] = value; + unchanged = false; + } + //setting all attributes with some change + } else if (key instanceof Object) { + if (this._glAttributes !== key) { + this._glAttributes = key; + unchanged = false; + } + } + //@todo_FES + if (!this._renderer.isP3D || unchanged) { + return; + } + + if (!this._setupDone) { + for (var x in this._renderer.gHash) { + if (this._renderer.gHash.hasOwnProperty(x)) { + console.error( + 'Sorry, Could not set the attributes, you need to call setAttributes() ' + + 'before calling the other drawing methods in setup()' + ); + return; + } + } + } + + this.push(); + this._renderer._resetContext(); + this.pop(); + + if (this._renderer._curCamera) { + this._renderer._curCamera._renderer = this._renderer; + } +}; + +/** + * @class p5.RendererGL + */ + +p5.RendererGL.prototype._update = function() { + // reset model view and apply initial camera transform + // (containing only look at info; no projection). + this.uMVMatrix.set( + this._curCamera.cameraMatrix.mat4[0], + this._curCamera.cameraMatrix.mat4[1], + this._curCamera.cameraMatrix.mat4[2], + this._curCamera.cameraMatrix.mat4[3], + this._curCamera.cameraMatrix.mat4[4], + this._curCamera.cameraMatrix.mat4[5], + this._curCamera.cameraMatrix.mat4[6], + this._curCamera.cameraMatrix.mat4[7], + this._curCamera.cameraMatrix.mat4[8], + this._curCamera.cameraMatrix.mat4[9], + this._curCamera.cameraMatrix.mat4[10], + this._curCamera.cameraMatrix.mat4[11], + this._curCamera.cameraMatrix.mat4[12], + this._curCamera.cameraMatrix.mat4[13], + this._curCamera.cameraMatrix.mat4[14], + this._curCamera.cameraMatrix.mat4[15] + ); + + // reset light data for new frame. + + this.ambientLightColors.length = 0; + this.directionalLightDirections.length = 0; + this.directionalLightColors.length = 0; + + this.pointLightPositions.length = 0; + this.pointLightColors.length = 0; + + this._enableLighting = false; +}; + +/** + * [background description] + */ +p5.RendererGL.prototype.background = function() { + var _col = this._pInst.color.apply(this._pInst, arguments); + var _r = _col.levels[0] / 255; + var _g = _col.levels[1] / 255; + var _b = _col.levels[2] / 255; + var _a = _col.levels[3] / 255; + this.GL.clearColor(_r, _g, _b, _a); + this.GL.depthMask(true); + this.GL.clear(this.GL.COLOR_BUFFER_BIT | this.GL.DEPTH_BUFFER_BIT); + this._pixelsState._pixelsDirty = true; +}; + +////////////////////////////////////////////// +// COLOR +////////////////////////////////////////////// +/** + * Basic fill material for geometry with a given color + * @method fill + * @class p5.RendererGL + * @param {Number|Number[]|String|p5.Color} v1 gray value, + * red or hue value (depending on the current color mode), + * or color Array, or CSS color string + * @param {Number} [v2] green or saturation value + * @param {Number} [v3] blue or brightness value + * @param {Number} [a] opacity + * @chainable + * @example + *
    + * + * function setup() { + * createCanvas(200, 200, WEBGL); + * } + * + * function draw() { + * background(0); + * noStroke(); + * fill(100, 100, 240); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * box(75, 75, 75); + * } + * + *
    + * + * @alt + * black canvas with purple cube spinning + * + */ +p5.RendererGL.prototype.fill = function(v1, v2, v3, a) { + //see material.js for more info on color blending in webgl + var color = p5.prototype.color.apply(this._pInst, arguments); + this.curFillColor = color._array; + this.drawMode = constants.FILL; + this._useNormalMaterial = false; + this._tex = null; +}; + +/** + * Basic stroke material for geometry with a given color + * @method stroke + * @param {Number|Number[]|String|p5.Color} v1 gray value, + * red or hue value (depending on the current color mode), + * or color Array, or CSS color string + * @param {Number} [v2] green or saturation value + * @param {Number} [v3] blue or brightness value + * @param {Number} [a] opacity + * @example + *
    + * + * function setup() { + * createCanvas(200, 200, WEBGL); + * } + * + * function draw() { + * background(0); + * stroke(240, 150, 150); + * fill(100, 100, 240); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * box(75, 75, 75); + * } + * + *
    + * + * @alt + * black canvas with purple cube with pink outline spinning + * + */ +p5.RendererGL.prototype.stroke = function(r, g, b, a) { + //@todo allow transparency in stroking currently doesn't have + //any impact and causes problems with specularMaterial + arguments[3] = 255; + var color = p5.prototype.color.apply(this._pInst, arguments); + this.curStrokeColor = color._array; +}; + +p5.RendererGL.prototype.strokeCap = function(cap) { + // @TODO : to be implemented + console.error('Sorry, strokeCap() is not yet implemented in WEBGL mode'); +}; + +p5.RendererGL.prototype.blendMode = function(mode) { + if ( + mode === constants.DARKEST || + mode === constants.LIGHTEST || + mode === constants.ADD || + mode === constants.BLEND || + mode === constants.SUBTRACT || + mode === constants.SCREEN || + mode === constants.EXCLUSION || + mode === constants.REPLACE || + mode === constants.MULTIPLY + ) + this.curBlendMode = mode; + else if ( + mode === constants.BURN || + mode === constants.OVERLAY || + mode === constants.HARD_LIGHT || + mode === constants.SOFT_LIGHT || + mode === constants.DODGE + ) { + console.warn( + 'BURN, OVERLAY, HARD_LIGHT, SOFT_LIGHT, and DODGE only work for blendMode in 2D mode.' + ); + } +}; + +/** + * Change weight of stroke + * @method strokeWeight + * @param {Number} stroke weight to be used for drawing + * @example + *
    + * + * function setup() { + * createCanvas(200, 400, WEBGL); + * setAttributes('antialias', true); + * } + * + * function draw() { + * background(0); + * noStroke(); + * translate(0, -100, 0); + * stroke(240, 150, 150); + * fill(100, 100, 240); + * push(); + * strokeWeight(8); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * sphere(75); + * pop(); + * push(); + * translate(0, 200, 0); + * strokeWeight(1); + * rotateX(frameCount * 0.01); + * rotateY(frameCount * 0.01); + * sphere(75); + * pop(); + * } + * + *
    + * + * @alt + * black canvas with two purple rotating spheres with pink + * outlines the sphere on top has much heavier outlines, + * + */ +p5.RendererGL.prototype.strokeWeight = function(w) { + if (this.curStrokeWeight !== w) { + this.pointSize = w; + this.curStrokeWeight = w; + } +}; + +// x,y are canvas-relative (pre-scaled by _pixelDensity) +p5.RendererGL.prototype._getPixel = function(x, y) { + var pixelsState = this._pixelsState; + var imageData, index; + if (pixelsState._pixelsDirty) { + imageData = new Uint8Array(4); + // prettier-ignore + this.drawingContext.readPixels( + x, y, 1, 1, + this.drawingContext.RGBA, this.drawingContext.UNSIGNED_BYTE, + imageData + ); + index = 0; + } else { + imageData = pixelsState.pixels; + index = (Math.floor(x) + Math.floor(y) * this.canvas.width) * 4; + } + return [ + imageData[index + 0], + imageData[index + 1], + imageData[index + 2], + imageData[index + 3] + ]; +}; + +/** + * Loads the pixels data for this canvas into the pixels[] attribute. + * Note that updatePixels() and set() do not work. + * Any pixel manipulation must be done directly to the pixels[] array. + * + * @private + * @method loadPixels + * + */ + +p5.RendererGL.prototype.loadPixels = function() { + var pixelsState = this._pixelsState; + if (!pixelsState._pixelsDirty) return; + pixelsState._pixelsDirty = false; + + //@todo_FES + if (this._pInst._glAttributes.preserveDrawingBuffer !== true) { + console.log( + 'loadPixels only works in WebGL when preserveDrawingBuffer ' + 'is true.' + ); + return; + } + + //if there isn't a renderer-level temporary pixels buffer + //make a new one + var pixels = pixelsState.pixels; + var len = this.GL.drawingBufferWidth * this.GL.drawingBufferHeight * 4; + if (!(pixels instanceof Uint8Array) || pixels.length !== len) { + pixels = new Uint8Array(len); + this._pixelsState._setProperty('pixels', pixels); + } + + var pd = this._pInst._pixelDensity; + // prettier-ignore + this.GL.readPixels( + 0, 0, this.width * pd, this.height * pd, + this.GL.RGBA, this.GL.UNSIGNED_BYTE, + pixels + ); +}; + +////////////////////////////////////////////// +// HASH | for geometry +////////////////////////////////////////////// + +p5.RendererGL.prototype.geometryInHash = function(gId) { + return this.gHash[gId] !== undefined; +}; + +/** + * [resize description] + * @private + * @param {Number} w [description] + * @param {Number} h [description] + */ +p5.RendererGL.prototype.resize = function(w, h) { + p5.Renderer.prototype.resize.call(this, w, h); + this.GL.viewport( + 0, + 0, + this.GL.drawingBufferWidth, + this.GL.drawingBufferHeight + ); + this._viewport = this.GL.getParameter(this.GL.VIEWPORT); + + this._curCamera._resize(); + + //resize pixels buffer + var pixelsState = this._pixelsState; + pixelsState._pixelsDirty = true; + if (typeof pixelsState.pixels !== 'undefined') { + pixelsState._setProperty( + 'pixels', + new Uint8Array( + this.GL.drawingBufferWidth * this.GL.drawingBufferHeight * 4 + ) + ); + } +}; + +/** + * clears color and depth buffers + * with r,g,b,a + * @private + * @param {Number} r normalized red val. + * @param {Number} g normalized green val. + * @param {Number} b normalized blue val. + * @param {Number} a normalized alpha val. + */ +p5.RendererGL.prototype.clear = function() { + var _r = arguments[0] || 0; + var _g = arguments[1] || 0; + var _b = arguments[2] || 0; + var _a = arguments[3] || 0; + this.GL.clearColor(_r, _g, _b, _a); + this.GL.clear(this.GL.COLOR_BUFFER_BIT | this.GL.DEPTH_BUFFER_BIT); + this._pixelsState._pixelsDirty = true; +}; + +p5.RendererGL.prototype.applyMatrix = function(a, b, c, d, e, f) { + if (arguments.length === 16) { + p5.Matrix.prototype.apply.apply(this.uMVMatrix, arguments); + } else { + // prettier-ignore + this.uMVMatrix.apply([ + a, b, 0, 0, + c, d, 0, 0, + 0, 0, 1, 0, + e, f, 0, 1, + ]); + } +}; + +/** + * [translate description] + * @private + * @param {Number} x [description] + * @param {Number} y [description] + * @param {Number} z [description] + * @chainable + * @todo implement handle for components or vector as args + */ +p5.RendererGL.prototype.translate = function(x, y, z) { + if (x instanceof p5.Vector) { + z = x.z; + y = x.y; + x = x.x; + } + this.uMVMatrix.translate([x, y, z]); + return this; +}; + +/** + * Scales the Model View Matrix by a vector + * @private + * @param {Number | p5.Vector | Array} x [description] + * @param {Number} [y] y-axis scalar + * @param {Number} [z] z-axis scalar + * @chainable + */ +p5.RendererGL.prototype.scale = function(x, y, z) { + this.uMVMatrix.scale(x, y, z); + return this; +}; + +p5.RendererGL.prototype.rotate = function(rad, axis) { + if (typeof axis === 'undefined') { + return this.rotateZ(rad); + } + p5.Matrix.prototype.rotate.apply(this.uMVMatrix, arguments); + 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; +}; + +p5.RendererGL.prototype.push = function() { + // get the base renderer style + var style = p5.Renderer.prototype.push.apply(this); + + // add webgl-specific style properties + var properties = style.properties; + + properties.uMVMatrix = this.uMVMatrix.copy(); + properties.uPMatrix = this.uPMatrix.copy(); + properties._curCamera = this._curCamera; + + // make a copy of the current camera for the push state + // this preserves any references stored using 'createCamera' + this._curCamera = this._curCamera.copy(); + + properties.ambientLightColors = this.ambientLightColors.slice(); + + properties.directionalLightDirections = this.directionalLightDirections.slice(); + properties.directionalLightColors = this.directionalLightColors.slice(); + + properties.pointLightPositions = this.pointLightPositions.slice(); + properties.pointLightColors = this.pointLightColors.slice(); + + properties.userFillShader = this.userFillShader; + properties.userStrokeShader = this.userStrokeShader; + properties.userPointShader = this.userPointShader; + + properties.pointSize = this.pointSize; + properties.curStrokeWeight = this.curStrokeWeight; + properties.curStrokeColor = this.curStrokeColor; + properties.curFillColor = this.curFillColor; + + properties._useSpecularMaterial = this._useSpecularMaterial; + properties._useShininess = this._useShininess; + + properties._enableLighting = this._enableLighting; + properties._useNormalMaterial = this._useNormalMaterial; + properties._tex = this._tex; + properties.drawMode = this.drawMode; + + return style; +}; + +p5.RendererGL.prototype.resetMatrix = function() { + this.uMVMatrix = p5.Matrix.identity(this._pInst); + return this; +}; + +////////////////////////////////////////////// +// SHADER +////////////////////////////////////////////// + +/* + * shaders are created and cached on a per-renderer basis, + * on the grounds that each renderer will have its own gl context + * and the shader must be valid in that context. + */ + +p5.RendererGL.prototype._getImmediateStrokeShader = function() { + // select the stroke shader to use + var stroke = this.userStrokeShader; + if (!stroke || !stroke.isStrokeShader()) { + return this._getLineShader(); + } + return stroke; +}; + +p5.RendererGL.prototype._getRetainedStrokeShader = + p5.RendererGL.prototype._getImmediateStrokeShader; + +/* + * selects which fill shader should be used based on renderer state, + * for use with begin/endShape and immediate vertex mode. + */ +p5.RendererGL.prototype._getImmediateFillShader = function() { + if (this._useNormalMaterial) { + return this._getNormalShader(); + } + + var fill = this.userFillShader; + if (this._enableLighting) { + if (!fill || !fill.isLightShader()) { + return this._getLightShader(); + } + } else if (this._tex) { + if (!fill || !fill.isTextureShader()) { + return this._getLightShader(); + } + } else if (!fill /*|| !fill.isColorShader()*/) { + return this._getImmediateModeShader(); + } + return fill; +}; + +/* + * selects which fill shader should be used based on renderer state + * for retained mode. + */ +p5.RendererGL.prototype._getRetainedFillShader = function() { + if (this._useNormalMaterial) { + return this._getNormalShader(); + } + + var fill = this.userFillShader; + if (this._enableLighting) { + if (!fill || !fill.isLightShader()) { + return this._getLightShader(); + } + } else if (this._tex) { + if (!fill || !fill.isTextureShader()) { + return this._getLightShader(); + } + } else if (!fill /* || !fill.isColorShader()*/) { + return this._getColorShader(); + } + return fill; +}; + +p5.RendererGL.prototype._getImmediatePointShader = function() { + // select the point shader to use + var point = this.userPointShader; + if (!point || !point.isPointShader()) { + return this._getPointShader(); + } + return point; +}; + +p5.RendererGL.prototype._getRetainedLineShader = + p5.RendererGL.prototype._getImmediateLineShader; + +p5.RendererGL.prototype._getLightShader = function() { + if (!this._defaultLightShader) { + if (this._pInst._glAttributes.perPixelLighting) { + this._defaultLightShader = new p5.Shader( + this, + defaultShaders.phongVert, + defaultShaders.phongFrag + ); + } else { + this._defaultLightShader = new p5.Shader( + this, + defaultShaders.lightVert, + defaultShaders.lightTextureFrag + ); + } + } + + return this._defaultLightShader; +}; + +p5.RendererGL.prototype._getImmediateModeShader = function() { + if (!this._defaultImmediateModeShader) { + this._defaultImmediateModeShader = new p5.Shader( + this, + defaultShaders.immediateVert, + defaultShaders.vertexColorFrag + ); + } + + return this._defaultImmediateModeShader; +}; + +p5.RendererGL.prototype._getNormalShader = function() { + if (!this._defaultNormalShader) { + this._defaultNormalShader = new p5.Shader( + this, + defaultShaders.normalVert, + defaultShaders.normalFrag + ); + } + + return this._defaultNormalShader; +}; + +p5.RendererGL.prototype._getColorShader = function() { + if (!this._defaultColorShader) { + this._defaultColorShader = new p5.Shader( + this, + defaultShaders.normalVert, + defaultShaders.basicFrag + ); + } + + return this._defaultColorShader; +}; + +p5.RendererGL.prototype._getPointShader = function() { + if (!this._defaultPointShader) { + this._defaultPointShader = new p5.Shader( + this, + defaultShaders.pointVert, + defaultShaders.pointFrag + ); + } + return this._defaultPointShader; +}; + +p5.RendererGL.prototype._getLineShader = function() { + if (!this._defaultLineShader) { + this._defaultLineShader = new p5.Shader( + this, + defaultShaders.lineVert, + defaultShaders.lineFrag + ); + } + + return this._defaultLineShader; +}; + +p5.RendererGL.prototype._getFontShader = function() { + if (!this._defaultFontShader) { + this.GL.getExtension('OES_standard_derivatives'); + this._defaultFontShader = new p5.Shader( + this, + defaultShaders.fontVert, + defaultShaders.fontFrag + ); + } + return this._defaultFontShader; +}; + +p5.RendererGL.prototype._getEmptyTexture = function() { + if (!this._emptyTexture) { + // a plain white texture RGBA, full alpha, single pixel. + var im = new p5.Image(1, 1); + im.set(0, 0, 255); + this._emptyTexture = new p5.Texture(this, im); + } + return this._emptyTexture; +}; + +p5.RendererGL.prototype.getTexture = function(img) { + var textures = this.textures; + for (var it = 0; it < textures.length; ++it) { + var texture = textures[it]; + if (texture.src === img) return texture; + } + + var tex = new p5.Texture(this, img); + textures.push(tex); + return tex; +}; + +p5.RendererGL.prototype._setStrokeUniforms = function(strokeShader) { + strokeShader.bindShader(); + + // set the uniform values + strokeShader.setUniform('uMaterialColor', this.curStrokeColor); + strokeShader.setUniform('uStrokeWeight', this.curStrokeWeight); +}; + +p5.RendererGL.prototype._setFillUniforms = function(fillShader) { + fillShader.bindShader(); + + // TODO: optimize + fillShader.setUniform('uMaterialColor', this.curFillColor); + fillShader.setUniform('isTexture', !!this._tex); + if (this._tex) { + fillShader.setUniform('uSampler', this._tex); + } + fillShader.setUniform('uSpecular', this._useSpecularMaterial); + fillShader.setUniform('uShininess', this._useShininess); + + fillShader.setUniform('uUseLighting', this._enableLighting); + + var pointLightCount = this.pointLightColors.length / 3; + fillShader.setUniform('uPointLightCount', pointLightCount); + fillShader.setUniform('uPointLightLocation', this.pointLightPositions); + fillShader.setUniform('uPointLightColor', this.pointLightColors); + + var directionalLightCount = this.directionalLightColors.length / 3; + fillShader.setUniform('uDirectionalLightCount', directionalLightCount); + fillShader.setUniform('uLightingDirection', this.directionalLightDirections); + fillShader.setUniform('uDirectionalColor', this.directionalLightColors); + + // TODO: sum these here... + var ambientLightCount = this.ambientLightColors.length / 3; + fillShader.setUniform('uAmbientLightCount', ambientLightCount); + fillShader.setUniform('uAmbientColor', this.ambientLightColors); + fillShader.bindTextures(); +}; + +p5.RendererGL.prototype._setPointUniforms = function(pointShader) { + pointShader.bindShader(); + + // set the uniform values + pointShader.setUniform('uMaterialColor', this.curStrokeColor); + // @todo is there an instance where this isn't stroke weight? + // should be they be same var? + pointShader.setUniform('uPointSize', this.pointSize); +}; + +/* Binds a buffer to the drawing context + * when passed more than two arguments it also updates or initializes + * the data associated with the buffer + */ +p5.RendererGL.prototype._bindBuffer = function( + buffer, + target, + values, + type, + usage +) { + this.GL.bindBuffer(target, buffer); + if (values !== undefined) { + var data = new type(values); + this.GL.bufferData(target, data, usage); + } +}; + +/////////////////////////////// +//// UTILITY FUNCTIONS +////////////////////////////// +/** + * turn a two dimensional array into one dimensional array + * @private + * @param {Array} arr 2-dimensional array + * @return {Array} 1-dimensional array + * [[1, 2, 3],[4, 5, 6]] -> [1, 2, 3, 4, 5, 6] + */ +p5.RendererGL.prototype._flatten = function(arr) { + //when empty, return empty + if (arr.length === 0) { + return []; + } else if (arr.length > 20000) { + //big models , load slower to avoid stack overflow + //faster non-recursive flatten via axelduch + //stackoverflow.com/questions/27266550/how-to-flatten-nested-array-in-javascript + var toString = Object.prototype.toString; + var arrayTypeStr = '[object Array]'; + var result = []; + var nodes = arr.slice(); + var node; + node = nodes.pop(); + do { + if (toString.call(node) === arrayTypeStr) { + nodes.push.apply(nodes, node); + } else { + result.push(node); + } + } while (nodes.length && (node = nodes.pop()) !== undefined); + result.reverse(); // we reverse result to restore the original order + return result; + } else { + //otherwise if model within limits for browser + //use faster recursive loading + return [].concat.apply([], arr); + } +}; + +/** + * turn a p5.Vector Array into a one dimensional number array + * @private + * @param {p5.Vector[]} arr an array of p5.Vector + * @return {Number[]} a one dimensional array of numbers + * [p5.Vector(1, 2, 3), p5.Vector(4, 5, 6)] -> + * [1, 2, 3, 4, 5, 6] + */ +p5.RendererGL.prototype._vToNArray = function(arr) { + return this._flatten( + arr.map(function(item) { + return [item.x, item.y, item.z]; + }) + ); +}; + +/** + * ensures that p5 is using a 3d renderer. throws an error if not. + */ +p5.prototype._assert3d = function(name) { + if (!this._renderer.isP3D) + throw new Error( + name + + "() is only supported in WEBGL mode. If you'd like to use 3D graphics" + + ' and WebGL, see https://p5js.org/examples/form-3d-primitives.html' + + ' for more information.' + ); +}; + +// function to initialize GLU Tesselator + +p5.RendererGL.prototype._initTessy = function initTesselator() { + // function called for each vertex of tesselator output + function vertexCallback(data, polyVertArray) { + polyVertArray[polyVertArray.length] = data[0]; + polyVertArray[polyVertArray.length] = data[1]; + polyVertArray[polyVertArray.length] = data[2]; + } + + function begincallback(type) { + if (type !== libtess.primitiveType.GL_TRIANGLES) { + console.log('expected TRIANGLES but got type: ' + type); + } + } + + function errorcallback(errno) { + console.log('error callback'); + console.log('error number: ' + errno); + } + // callback for when segments intersect and must be split + function combinecallback(coords, data, weight) { + return [coords[0], coords[1], coords[2]]; + } + + function edgeCallback(flag) { + // don't really care about the flag, but need no-strip/no-fan behavior + } + + var tessy = new libtess.GluTesselator(); + tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_VERTEX_DATA, vertexCallback); + tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_BEGIN, begincallback); + tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_ERROR, errorcallback); + tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_COMBINE, combinecallback); + tessy.gluTessCallback(libtess.gluEnum.GLU_TESS_EDGE_FLAG, edgeCallback); + + return tessy; +}; + +p5.RendererGL.prototype._triangulate = function(contours) { + // libtess will take 3d verts and flatten to a plane for tesselation + // since only doing 2d tesselation here, provide z=1 normal to skip + // iterating over verts only to get the same answer. + // comment out to test normal-generation code + this._tessy.gluTessNormal(0, 0, 1); + + var triangleVerts = []; + this._tessy.gluTessBeginPolygon(triangleVerts); + + for (var i = 0; i < contours.length; i++) { + this._tessy.gluTessBeginContour(); + var contour = contours[i]; + for (var j = 0; j < contour.length; j += 3) { + var coords = [contour[j], contour[j + 1], contour[j + 2]]; + this._tessy.gluTessVertex(coords, coords); + } + this._tessy.gluTessEndContour(); + } + + // finish polygon + this._tessy.gluTessEndPolygon(); + + return triangleVerts; +}; + +// function to calculate BezierVertex Coefficients +p5.RendererGL.prototype._bezierCoefficients = function(t) { + var t2 = t * t; + var t3 = t2 * t; + var mt = 1 - t; + var mt2 = mt * mt; + var mt3 = mt2 * mt; + return [mt3, 3 * mt2 * t, 3 * mt * t2, t3]; +}; + +// function to calculate QuadraticVertex Coefficients +p5.RendererGL.prototype._quadraticCoefficients = function(t) { + var t2 = t * t; + var mt = 1 - t; + var mt2 = mt * mt; + return [mt2, 2 * mt * t, t2]; +}; + +// function to convert Bezier coordinates to Catmull Rom Splines +p5.RendererGL.prototype._bezierToCatmull = function(w) { + var p1 = w[1]; + var p2 = w[1] + (w[2] - w[0]) / this._curveTightness; + var p3 = w[2] - (w[3] - w[1]) / this._curveTightness; + var p4 = w[2]; + var p = [p1, p2, p3, p4]; + return p; +}; + +module.exports = p5.RendererGL; + +},{"../core/constants":18,"../core/main":24,"../core/p5.Renderer":27,"./p5.Camera":69,"./p5.Matrix":71,"./p5.Shader":75,"libtess":9}],75:[function(_dereq_,module,exports){ +/** + * This module defines the p5.Shader class + * @module Lights, Camera + * @submodule Shaders + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); + +/** + * Shader class for WEBGL Mode + * @class p5.Shader + * @param {p5.RendererGL} renderer an instance of p5.RendererGL that + * will provide the GL context for this new p5.Shader + * @param {String} vertSrc source code for the vertex shader (as a string) + * @param {String} fragSrc source code for the fragment shader (as a string) + */ +p5.Shader = function(renderer, vertSrc, fragSrc) { + // TODO: adapt this to not take ids, but rather, + // to take the source for a vertex and fragment shader + // to enable custom shaders at some later date + this._renderer = renderer; + this._vertSrc = vertSrc; + this._fragSrc = fragSrc; + this._vertShader = -1; + this._fragShader = -1; + this._glProgram = 0; + this._loadedAttributes = false; + this.attributes = {}; + this._loadedUniforms = false; + this.uniforms = {}; + this._bound = false; + this.samplers = []; +}; + +/** + * Creates, compiles, and links the shader based on its + * sources for the vertex and fragment shaders (provided + * to the constructor). Populates known attributes and + * uniforms from the shader. + * @method init + * @chainable + * @private + */ +p5.Shader.prototype.init = function() { + if (this._glProgram === 0 /* or context is stale? */) { + var gl = this._renderer.GL; + + // @todo: once custom shading is allowed, + // friendly error messages should be used here to share + // compiler and linker errors. + + //set up the shader by + // 1. creating and getting a gl id for the shader program, + // 2. compliling its vertex & fragment sources, + // 3. linking the vertex and fragment shaders + this._vertShader = gl.createShader(gl.VERTEX_SHADER); + //load in our default vertex shader + gl.shaderSource(this._vertShader, this._vertSrc); + gl.compileShader(this._vertShader); + // if our vertex shader failed compilation? + if (!gl.getShaderParameter(this._vertShader, gl.COMPILE_STATUS)) { + console.error( + 'Yikes! An error occurred compiling the vertex shader:' + + gl.getShaderInfoLog(this._vertShader) + ); + return null; + } + + this._fragShader = gl.createShader(gl.FRAGMENT_SHADER); + //load in our material frag shader + gl.shaderSource(this._fragShader, this._fragSrc); + gl.compileShader(this._fragShader); + // if our frag shader failed compilation? + if (!gl.getShaderParameter(this._fragShader, gl.COMPILE_STATUS)) { + console.error( + 'Darn! An error occurred compiling the fragment shader:' + + gl.getShaderInfoLog(this._fragShader) + ); + return null; + } + + this._glProgram = gl.createProgram(); + gl.attachShader(this._glProgram, this._vertShader); + gl.attachShader(this._glProgram, this._fragShader); + gl.linkProgram(this._glProgram); + if (!gl.getProgramParameter(this._glProgram, gl.LINK_STATUS)) { + console.error( + 'Snap! Error linking shader program: ' + + gl.getProgramInfoLog(this._glProgram) + ); + } + + this._loadAttributes(); + this._loadUniforms(); + } + return this; +}; + +/** + * Queries the active attributes for this shader and loads + * their names and locations into the attributes array. + * @method _loadAttributes + * @private + */ +p5.Shader.prototype._loadAttributes = function() { + if (this._loadedAttributes) { + return; + } + + this.attributes = {}; + + var gl = this._renderer.GL; + + var numAttributes = gl.getProgramParameter( + this._glProgram, + gl.ACTIVE_ATTRIBUTES + ); + for (var i = 0; i < numAttributes; ++i) { + var attributeInfo = gl.getActiveAttrib(this._glProgram, i); + var name = attributeInfo.name; + var location = gl.getAttribLocation(this._glProgram, name); + var attribute = {}; + attribute.name = name; + attribute.location = location; + attribute.type = attributeInfo.type; + attribute.size = attributeInfo.size; + this.attributes[name] = attribute; + } + + this._loadedAttributes = true; +}; + +/** + * Queries the active uniforms for this shader and loads + * their names and locations into the uniforms array. + * @method _loadUniforms + * @private + */ +p5.Shader.prototype._loadUniforms = function() { + if (this._loadedUniforms) { + return; + } + + var gl = this._renderer.GL; + + // Inspect shader and cache uniform info + var numUniforms = gl.getProgramParameter(this._glProgram, gl.ACTIVE_UNIFORMS); + + var samplerIndex = 0; + for (var i = 0; i < numUniforms; ++i) { + var uniformInfo = gl.getActiveUniform(this._glProgram, i); + var uniform = {}; + uniform.location = gl.getUniformLocation(this._glProgram, uniformInfo.name); + uniform.size = uniformInfo.size; + var uniformName = uniformInfo.name; + //uniforms thats are arrays have their name returned as + //someUniform[0] which is a bit silly so we trim it + //off here. The size property tells us that its an array + //so we dont lose any information by doing this + if (uniformInfo.size > 1) { + uniformName = uniformName.substring(0, uniformName.indexOf('[0]')); + } + uniform.name = uniformName; + uniform.type = uniformInfo.type; + if (uniform.type === gl.SAMPLER_2D) { + uniform.samplerIndex = samplerIndex; + samplerIndex++; + this.samplers.push(uniform); + } + this.uniforms[uniformName] = uniform; + } + this._loadedUniforms = true; +}; + +p5.Shader.prototype.compile = function() { + // TODO +}; + +/** + * initializes (if needed) and binds the shader program. + * @method bindShader + * @private + */ +p5.Shader.prototype.bindShader = function() { + this.init(); + if (!this._bound) { + this.useProgram(); + this._bound = true; + + this._setMatrixUniforms(); + + this.setUniform('uViewport', this._renderer._viewport); + } +}; + +/** + * @method unbindShader + * @chainable + * @private + */ +p5.Shader.prototype.unbindShader = function() { + if (this._bound) { + this.unbindTextures(); + //this._renderer.GL.useProgram(0); ?? + this._bound = false; + } + return this; +}; + +p5.Shader.prototype.bindTextures = function() { + var gl = this._renderer.GL; + for (var i = 0; i < this.samplers.length; i++) { + var uniform = this.samplers[i]; + var tex = uniform.texture; + if (tex === undefined) { + // user hasn't yet supplied a texture for this slot. + // (or there may not be one--maybe just lighting), + // so we supply a default texture instead. + tex = this._renderer._getEmptyTexture(); + } + gl.activeTexture(gl.TEXTURE0 + uniform.samplerIndex); + tex.bindTexture(); + tex.update(); + gl.uniform1i(uniform.location, uniform.samplerIndex); + } +}; + +p5.Shader.prototype.updateTextures = function() { + for (var i = 0; i < this.samplers.length; i++) { + var uniform = this.samplers[i]; + var tex = uniform.texture; + if (tex) { + tex.update(); + } + } +}; + +p5.Shader.prototype.unbindTextures = function() { + // TODO: migrate stuff from material.js here + // - OR - have material.js define this function +}; + +p5.Shader.prototype._setMatrixUniforms = function() { + this.setUniform('uProjectionMatrix', this._renderer.uPMatrix.mat4); + this.setUniform('uModelViewMatrix', this._renderer.uMVMatrix.mat4); + this.setUniform('uViewMatrix', this._renderer._curCamera.cameraMatrix.mat4); + if (this.uniforms.uNormalMatrix) { + this._renderer.uNMatrix.inverseTranspose(this._renderer.uMVMatrix); + this.setUniform('uNormalMatrix', this._renderer.uNMatrix.mat3); + } +}; + +/** + * @method useProgram + * @chainable + * @private + */ +p5.Shader.prototype.useProgram = function() { + var gl = this._renderer.GL; + gl.useProgram(this._glProgram); + return this; +}; + +/** + * Wrapper around gl.uniform functions. + * As we store uniform info in the shader we can use that + * to do type checking on the supplied data and call + * the appropriate function. + * @method setUniform + * @chainable + * @param {String} uniformName the name of the uniform in the + * shader program + * @param {Object|Number|Boolean|Number[]} data the data to be associated + * with that uniform; type varies (could be a single numerical value, array, + * matrix, or texture / sampler reference) + */ +p5.Shader.prototype.setUniform = function(uniformName, data) { + //@todo update all current gl.uniformXX calls + + var uniform = this.uniforms[uniformName]; + if (!uniform) { + return; + } + + var location = uniform.location; + + var gl = this._renderer.GL; + this.useProgram(); + + switch (uniform.type) { + case gl.BOOL: + if (data === true) { + gl.uniform1i(location, 1); + } else { + gl.uniform1i(location, 0); + } + break; + case gl.INT: + if (uniform.size > 1) { + data.length && gl.uniform1iv(location, data); + } else { + gl.uniform1i(location, data); + } + break; + case gl.FLOAT: + if (uniform.size > 1) { + data.length && gl.uniform1fv(location, data); + } else { + gl.uniform1f(location, data); + } + break; + case gl.FLOAT_MAT3: + gl.uniformMatrix3fv(location, false, data); + break; + case gl.FLOAT_MAT4: + gl.uniformMatrix4fv(location, false, data); + break; + case gl.FLOAT_VEC2: + if (uniform.size > 1) { + data.length && gl.uniform2fv(location, data); + } else { + gl.uniform2f(location, data[0], data[1]); + } + break; + case gl.FLOAT_VEC3: + if (uniform.size > 1) { + data.length && gl.uniform3fv(location, data); + } else { + gl.uniform3f(location, data[0], data[1], data[2]); + } + break; + case gl.FLOAT_VEC4: + if (uniform.size > 1) { + data.length && gl.uniform4fv(location, data); + } else { + gl.uniform4f(location, data[0], data[1], data[2], data[3]); + } + break; + case gl.INT_VEC2: + if (uniform.size > 1) { + data.length && gl.uniform2iv(location, data); + } else { + gl.uniform2i(location, data[0], data[1]); + } + break; + case gl.INT_VEC3: + if (uniform.size > 1) { + data.length && gl.uniform3iv(location, data); + } else { + gl.uniform3i(location, data[0], data[1], data[2]); + } + break; + case gl.INT_VEC4: + if (uniform.size > 1) { + data.length && gl.uniform4iv(location, data); + } else { + gl.uniform4i(location, data[0], data[1], data[2], data[3]); + } + break; + case gl.SAMPLER_2D: + gl.activeTexture(gl.TEXTURE0 + uniform.samplerIndex); + uniform.texture = this._renderer.getTexture(data); + gl.uniform1i(uniform.location, uniform.samplerIndex); + break; + //@todo complete all types + } + return this; +}; + +/* NONE OF THIS IS FAST OR EFFICIENT BUT BEAR WITH ME + * + * these shader "type" query methods are used by various + * facilities of the renderer to determine if changing + * the shader type for the required action (for example, + * do we need to load the default lighting shader if the + * current shader cannot handle lighting?) + * + **/ + +p5.Shader.prototype.isLightShader = function() { + return ( + this.attributes.aNormal !== undefined || + this.uniforms.uUseLighting !== undefined || + this.uniforms.uAmbientLightCount !== undefined || + this.uniforms.uDirectionalLightCount !== undefined || + this.uniforms.uPointLightCount !== undefined || + this.uniforms.uAmbientColor !== undefined || + this.uniforms.uDirectionalColor !== undefined || + this.uniforms.uPointLightLocation !== undefined || + this.uniforms.uPointLightColor !== undefined || + this.uniforms.uLightingDirection !== undefined || + this.uniforms.uSpecular !== undefined + ); +}; + +p5.Shader.prototype.isTextureShader = function() { + return this.samplerIndex > 0; +}; + +p5.Shader.prototype.isColorShader = function() { + return ( + this.attributes.aVertexColor !== undefined || + this.uniforms.uMaterialColor !== undefined + ); +}; + +p5.Shader.prototype.isTexLightShader = function() { + return this.isLightShader() && this.isTextureShader(); +}; + +p5.Shader.prototype.isStrokeShader = function() { + return this.uniforms.uStrokeWeight !== undefined; +}; + +/** + * @method enableAttrib + * @chainable + * @private + */ +p5.Shader.prototype.enableAttrib = function( + loc, + size, + type, + normalized, + stride, + offset +) { + var gl = this._renderer.GL; + if (loc !== -1) { + gl.enableVertexAttribArray(loc); + gl.vertexAttribPointer(loc, size, type, normalized, stride, offset); + } + return this; +}; + +module.exports = p5.Shader; + +},{"../core/main":24}],76:[function(_dereq_,module,exports){ +/** + * This module defines the p5.Texture class + * @module Lights, Camera + * @submodule Material + * @for p5 + * @requires core + */ + +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); + +/** + * Texture class for WEBGL Mode + * @private + * @class p5.Texture + * @param {p5.RendererGL} renderer an instance of p5.RendererGL that + * will provide the GL context for this new p5.Texture + * @param {p5.Image|p5.Graphics|p5.Element|p5.MediaElement|ImageData} [obj] the + * object containing the image data to store in the texture. + */ +p5.Texture = function(renderer, obj) { + this._renderer = renderer; + + var gl = this._renderer.GL; + + this.src = obj; + this.glTex = undefined; + this.glTarget = gl.TEXTURE_2D; + this.glFormat = gl.RGBA; + this.mipmaps = false; + this.glMinFilter = gl.LINEAR; + this.glMagFilter = gl.LINEAR; + this.glWrapS = gl.CLAMP_TO_EDGE; + this.glWrapT = gl.CLAMP_TO_EDGE; + + // used to determine if this texture might need constant updating + // because it is a video or gif. + this.isSrcMediaElement = + typeof p5.MediaElement !== 'undefined' && obj instanceof p5.MediaElement; + this._videoPrevUpdateTime = 0; + this.isSrcHTMLElement = + typeof p5.Element !== 'undefined' && + obj instanceof p5.Element && + !(obj instanceof p5.Graphics); + this.isSrcP5Image = obj instanceof p5.Image; + this.isSrcP5Graphics = obj instanceof p5.Graphics; + this.isImageData = + typeof ImageData !== 'undefined' && obj instanceof ImageData; + + var textureData = this._getTextureDataFromSource(); + this.width = textureData.width; + this.height = textureData.height; + + this.init(textureData); + return this; +}; + +p5.Texture.prototype._getTextureDataFromSource = function() { + var textureData; + if (this.isSrcP5Image) { + // param is a p5.Image + textureData = this.src.canvas; + } else if ( + this.isSrcMediaElement || + this.isSrcP5Graphics || + this.isSrcHTMLElement + ) { + // if param is a video HTML element + textureData = this.src.elt; + } else if (this.isImageData) { + textureData = this.src; + } + return textureData; +}; + +/** + * Initializes common texture parameters, creates a gl texture, + * tries to upload the texture for the first time if data is + * already available. + * @private + * @method init + */ +p5.Texture.prototype.init = function(data) { + var gl = this._renderer.GL; + this.glTex = gl.createTexture(); + + this.glWrapS = this._renderer.textureWrapX; + this.glWrapT = this._renderer.textureWrapY; + + this.setWrapMode(this.glWrapS, this.glWrapT); + this.bindTexture(); + + //gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true); + gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, this.glMagFilter); + gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, this.glMinFilter); + + if ( + this.width === 0 || + this.height === 0 || + (this.isSrcMediaElement && !this.src.loadedmetadata) + ) { + // assign a 1x1 empty texture initially, because data is not yet ready, + // so that no errors occur in gl console! + var tmpdata = new Uint8Array([1, 1, 1, 1]); + gl.texImage2D( + this.glTarget, + 0, + gl.RGBA, + 1, + 1, + 0, + this.glFormat, + gl.UNSIGNED_BYTE, + tmpdata + ); + } else { + // data is ready: just push the texture! + gl.texImage2D( + this.glTarget, + 0, + this.glFormat, + this.glFormat, + gl.UNSIGNED_BYTE, + data + ); + } +}; + +/** + * Checks if the source data for this texture has changed (if it's + * easy to do so) and reuploads the texture if necessary. If it's not + * possible or to expensive to do a calculation to determine wheter or + * not the data has occurred, this method simply re-uploads the texture. + * @method update + */ +p5.Texture.prototype.update = function() { + var data = this.src; + if (data.width === 0 || data.height === 0) { + return false; // nothing to do! + } + + var textureData = this._getTextureDataFromSource(); + var updated = false; + + var gl = this._renderer.GL; + // pull texture from data, make sure width & height are appropriate + if (textureData.width !== this.width || textureData.height !== this.height) { + updated = true; + + // make sure that if the width and height of this.src have changed + // for some reason, we update our metadata and upload the texture again + this.width = textureData.width; + this.height = textureData.height; + + if (this.isSrcP5Image) { + data.setModified(false); + } else if (this.isSrcMediaElement || this.isSrcHTMLElement) { + // on the first frame the metadata comes in, the size will be changed + // from 0 to actual size, but pixels may not be available. + // flag for update in a future frame. + // if we don't do this, a paused video, for example, may not + // send the first frame to texture memory. + data.setModified(true); + } + } else if (this.isSrcP5Image) { + // for an image, we only update if the modified field has been set, + // for example, by a call to p5.Image.set + if (data.isModified()) { + updated = true; + data.setModified(false); + } + } else if (this.isSrcMediaElement) { + // for a media element (video), we'll check if the current time in + // the video frame matches the last time. if it doesn't match, the + // video has advanced or otherwise been taken to a new frame, + // and we need to upload it. + if (data.isModified()) { + // p5.MediaElement may have also had set/updatePixels, etc. called + // on it and should be updated, or may have been set for the first + // time! + updated = true; + data.setModified(false); + } else if (data.loadedmetadata) { + // if the meta data has been loaded, we can ask the video + // what it's current position (in time) is. + if (this._videoPrevUpdateTime !== data.time()) { + // update the texture in gpu mem only if the current + // video timestamp does not match the timestamp of the last + // time we uploaded this texture (and update the time we + // last uploaded, too) + this._videoPrevUpdateTime = data.time(); + updated = true; + } + } + } else if (this.isImageData) { + if (data._dirty) { + data._dirty = false; + updated = true; + } + } else { + /* data instanceof p5.Graphics, probably */ + // there is not enough information to tell if the texture can be + // conditionally updated; so to be safe, we just go ahead and upload it. + updated = true; + } + + if (updated) { + this.bindTexture(); + gl.texImage2D( + this.glTarget, + 0, + this.glFormat, + this.glFormat, + gl.UNSIGNED_BYTE, + textureData + ); + } + + return updated; +}; + +/** + * Binds the texture to the appropriate GL target. + * @method bindTexture + */ +p5.Texture.prototype.bindTexture = function() { + // bind texture using gl context + glTarget and + // generated gl texture object + var gl = this._renderer.GL; + gl.bindTexture(this.glTarget, this.glTex); + + return this; +}; + +/** + * Unbinds the texture from the appropriate GL target. + * @method unbindTexture + */ +p5.Texture.prototype.unbindTexture = function() { + // unbind per above, disable texturing on glTarget + var gl = this._renderer.GL; + gl.bindTexture(this.glTarget, null); +}; + +/** + * Sets how a texture is be interpolated when upscaled or downscaled. + * Nearest filtering uses nearest neighbor scaling when interpolating + * Linear filtering uses WebGL's linear scaling when interpolating + * @method setInterpolation + * @param {String} downScale Specifies the texture filtering when + * textures are shrunk. Options are LINEAR or NEAREST + * @param {String} upScale Specifies the texture filtering when + * textures are magnified. Options are LINEAR or NEAREST + * @todo implement mipmapping filters + */ +p5.Texture.prototype.setInterpolation = function(downScale, upScale) { + var gl = this._renderer.GL; + + if (downScale === constants.NEAREST) { + this.glMinFilter = gl.NEAREST; + } else { + this.glMinFilter = gl.LINEAR; + } + + if (upScale === constants.NEAREST) { + this.glMagFilter = gl.NEAREST; + } else { + this.glMagFilter = gl.LINEAR; + } + + this.bindTexture(); + gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, this.glMinFilter); + gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, this.glMagFilter); + this.unbindTexture(); +}; + +/** + * Sets the texture wrapping mode. This controls how textures behave + * when their uv's go outside of the 0 - 1 range. There are three options: + * CLAMP, REPEAT, and MIRROR. REPEAT & MIRROR are only available if the texture + * is a power of two size (128, 256, 512, 1024, etc.). + * @method setWrapMode + * @param {String} wrapX Controls the horizontal texture wrapping behavior + * @param {String} wrapY Controls the vertical texture wrapping behavior + */ +p5.Texture.prototype.setWrapMode = function(wrapX, wrapY) { + var gl = this._renderer.GL; + + // for webgl 1 we need to check if the texture is power of two + // if it isn't we will set the wrap mode to CLAMP + // webgl2 will support npot REPEAT and MIRROR but we don't check for it yet + var isPowerOfTwo = function(x) { + return (x & (x - 1)) === 0; + }; + + var widthPowerOfTwo = isPowerOfTwo(this.width); + var heightPowerOfTwo = isPowerOfTwo(this.height); + + if (wrapX === constants.REPEAT) { + if (widthPowerOfTwo && heightPowerOfTwo) { + this.glWrapS = gl.REPEAT; + } else { + console.warn( + 'You tried to set the wrap mode to REPEAT but the texture size is not a power of two. Setting to CLAMP instead' + ); + this.glWrapS = gl.CLAMP_TO_EDGE; + } + } else if (wrapX === constants.MIRROR) { + if (widthPowerOfTwo && heightPowerOfTwo) { + this.glWrapS = gl.MIRRORED_REPEAT; + } else { + console.warn( + 'You tried to set the wrap mode to MIRROR but the texture size is not a power of two. Setting to CLAMP instead' + ); + this.glWrapS = gl.CLAMP_TO_EDGE; + } + } else { + // falling back to default if didn't get a proper mode + this.glWrapS = gl.CLAMP_TO_EDGE; + } + + if (wrapY === constants.REPEAT) { + if (widthPowerOfTwo && heightPowerOfTwo) { + this.glWrapT = gl.REPEAT; + } else { + console.warn( + 'You tried to set the wrap mode to REPEAT but the texture size is not a power of two. Setting to CLAMP instead' + ); + this.glWrapT = gl.CLAMP_TO_EDGE; + } + } else if (wrapY === constants.MIRROR) { + if (widthPowerOfTwo && heightPowerOfTwo) { + this.glWrapT = gl.MIRRORED_REPEAT; + } else { + console.warn( + 'You tried to set the wrap mode to MIRROR but the texture size is not a power of two. Setting to CLAMP instead' + ); + this.glWrapT = gl.CLAMP_TO_EDGE; + } + } else { + // falling back to default if didn't get a proper mode + this.glWrapT = gl.CLAMP_TO_EDGE; + } + + this.bindTexture(); + gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, this.glWrapS); + gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, this.glWrapT); + this.unbindTexture(); +}; + +module.exports = p5.Texture; + +},{"../core/constants":18,"../core/main":24}],77:[function(_dereq_,module,exports){ +'use strict'; + +var p5 = _dereq_('../core/main'); +var constants = _dereq_('../core/constants'); +_dereq_('./p5.Shader'); +_dereq_('./p5.RendererGL'); + +// Text/Typography +// @TODO: +p5.RendererGL.prototype._applyTextProperties = function() { + //@TODO finish implementation + //console.error('text commands not yet implemented in webgl'); +}; + +p5.RendererGL.prototype.textWidth = function(s) { + if (this._isOpenType()) { + return this._textFont._textWidth(s, this._textSize); + } + + return 0; // TODO: error +}; + +// rendering constants + +// the number of rows/columns dividing each glyph +var charGridWidth = 9; +var charGridHeight = charGridWidth; + +// size of the image holding the bezier stroke info +var strokeImageWidth = 64; +var strokeImageHeight = 64; + +// size of the image holding the stroke indices for each row/col +var gridImageWidth = 64; +var gridImageHeight = 64; + +// size of the image holding the offset/length of each row/col stripe +var cellImageWidth = 64; +var cellImageHeight = 64; + +/** + * @private + * @class ImageInfos + * @param {Integer} width + * @param {Integer} height + * + * the ImageInfos class holds a list of ImageDatas of a given size. + */ +function ImageInfos(width, height) { + this.width = width; + this.height = height; + this.infos = []; // the list of images + + /** + * + * @method findImage + * @param {Integer} space + * @return {Object} contains the ImageData, and pixel index into that + * ImageData where the free space was allocated. + * + * finds free space of a given size in the ImageData list + */ + this.findImage = function(space) { + var imageSize = this.width * this.height; + if (space > imageSize) + throw new Error('font is too complex to render in 3D'); + + // search through the list of images, looking for one with + // anough unused space. + var imageInfo, imageData; + for (var ii = this.infos.length - 1; ii >= 0; --ii) { + var imageInfoTest = this.infos[ii]; + if (imageInfoTest.index + space < imageSize) { + // found one + imageInfo = imageInfoTest; + imageData = imageInfoTest.imageData; + break; + } + } + + if (!imageInfo) { + try { + // create a new image + imageData = new ImageData(this.width, this.height); + } catch (err) { + // for browsers that don't support ImageData constructors (ie IE11) + // create an ImageData using the old method + var canvas = document.getElementsByTagName('canvas')[0]; + var created = !canvas; + if (!canvas) { + // create a temporary canvas + canvas = document.createElement('canvas'); + canvas.style.display = 'none'; + document.body.appendChild(canvas); + } + var ctx = canvas.getContext('2d'); + if (ctx) { + imageData = ctx.createImageData(this.width, this.height); + } + if (created) { + // distroy the temporary canvas, if necessary + document.body.removeChild(canvas); + } + } + // construct & dd the new image info + imageInfo = { index: 0, imageData: imageData }; + this.infos.push(imageInfo); + } + + var index = imageInfo.index; + imageInfo.index += space; // move to the start of the next image + imageData._dirty = true; + return { imageData: imageData, index: index }; + }; +} + +/** + * @function setPixel + * @param {Object} imageInfo + * @param {Number} r + * @param {Number} g + * @param {Number} b + * @param {Number} a + * + * writes the next pixel into an indexed ImageData + */ +function setPixel(imageInfo, r, g, b, a) { + var imageData = imageInfo.imageData; + var pixels = imageData.data; + var index = imageInfo.index++ * 4; + pixels[index++] = r; + pixels[index++] = g; + pixels[index++] = b; + pixels[index++] = a; +} + +var SQRT3 = Math.sqrt(3); + +/** + * @private + * @class FontInfo + * @param {Object} font an opentype.js font object + * + * contains cached images and glyph information for an opentype font + */ +var FontInfo = function(font) { + this.font = font; + // the bezier curve coordinates + this.strokeImageInfos = new ImageInfos(strokeImageWidth, strokeImageHeight); + // lists of curve indices for each row/column slice + this.colDimImageInfos = new ImageInfos(gridImageWidth, gridImageHeight); + this.rowDimImageInfos = new ImageInfos(gridImageWidth, gridImageHeight); + // the offset & length of each row/col slice in the glyph + this.colCellImageInfos = new ImageInfos(cellImageWidth, cellImageHeight); + this.rowCellImageInfos = new ImageInfos(cellImageWidth, cellImageHeight); + + // the cached information for each glyph + this.glyphInfos = {}; + + /** + * @method getGlyphInfo + * @param {Glyph} glyph the x positions of points in the curve + * @returns {Object} the glyphInfo for that glyph + * + * calculates rendering info for a glyph, including the curve information, + * row & column stripes compiled into textures. + */ + + this.getGlyphInfo = function(glyph) { + // check the cache + var gi = this.glyphInfos[glyph.index]; + if (gi) return gi; + + // get the bounding box of the glyph from opentype.js + var bb = glyph.getBoundingBox(); + var xMin = bb.x1; + var yMin = bb.y1; + var gWidth = bb.x2 - xMin; + var gHeight = bb.y2 - yMin; + var cmds = glyph.path.commands; + // don't bother rendering invisible glyphs + if (gWidth === 0 || gHeight === 0 || !cmds.length) { + return (this.glyphInfos[glyph.index] = {}); + } + + var i; + var strokes = []; // the strokes in this glyph + var rows = []; // the indices of strokes in each row + var cols = []; // the indices of strokes in each column + for (i = charGridWidth - 1; i >= 0; --i) cols.push([]); + for (i = charGridHeight - 1; i >= 0; --i) rows.push([]); + + /** + * @function push + * @param {Number[]} xs the x positions of points in the curve + * @param {Number[]} ys the y positions of points in the curve + * @param {Object} v the curve information + * + * adds a curve to the rows & columns that it intersects with + */ + function push(xs, ys, v) { + var index = strokes.length; // the index of this stroke + strokes.push(v); // add this stroke to the list + + /** + * @function minMax + * @param {Number[]} rg the list of values to compare + * @param {Number} min the initial minimum value + * @param {Number} max the initial maximum value + * + * find the minimum & maximum value in a list of values + */ + function minMax(rg, min, max) { + for (var i = rg.length; i-- > 0; ) { + var v = rg[i]; + if (min > v) min = v; + if (max < v) max = v; + } + return { min: min, max: max }; + } + + // loop through the rows & columns that the curve intersects + // adding the curve to those slices + var mmX = minMax(xs, 1, 0); + var ixMin = Math.max(Math.floor(mmX.min * charGridWidth), 0); + var ixMax = Math.min(Math.ceil(mmX.max * charGridWidth), charGridWidth); + for (var iCol = ixMin; iCol < ixMax; ++iCol) cols[iCol].push(index); + + var mmY = minMax(ys, 1, 0); + var iyMin = Math.max(Math.floor(mmY.min * charGridHeight), 0); + var iyMax = Math.min(Math.ceil(mmY.max * charGridHeight), charGridHeight); + for (var iRow = iyMin; iRow < iyMax; ++iRow) rows[iRow].push(index); + } + + /** + * @function clamp + * @param {Number} v the value to clamp + * @param {Number} min the minimum value + * @param {Number} max the maxmimum value + * + * clamps a value between a minimum & maximum value + */ + function clamp(v, min, max) { + if (v < min) return min; + if (v > max) return max; + return v; + } + + /** + * @function byte + * @param {Number} v the value to scale + * + * converts a floating-point number in the range 0-1 to a byte 0-255 + */ + function byte(v) { + return clamp(255 * v, 0, 255); + } + + /** + * @private + * @class Cubic + * @param {Number} p0 the start point of the curve + * @param {Number} c0 the first control point + * @param {Number} c1 the second control point + * @param {Number} p1 the end point + * + * a cubic curve + */ + function Cubic(p0, c0, c1, p1) { + this.p0 = p0; + this.c0 = c0; + this.c1 = c1; + this.p1 = p1; + + /** + * @method toQuadratic + * @return {Object} the quadratic approximation + * + * converts the cubic to a quadtratic approximation by + * picking an appropriate quadratic control point + */ + this.toQuadratic = function() { + return { + x: this.p0.x, + y: this.p0.y, + x1: this.p1.x, + y1: this.p1.y, + cx: ((this.c0.x + this.c1.x) * 3 - (this.p0.x + this.p1.x)) / 4, + cy: ((this.c0.y + this.c1.y) * 3 - (this.p0.y + this.p1.y)) / 4 + }; + }; + + /** + * @method quadError + * @return {Number} the error + * + * calculates the magnitude of error of this curve's + * quadratic approximation. + */ + this.quadError = function() { + return ( + p5.Vector.sub( + p5.Vector.sub(this.p1, this.p0), + p5.Vector.mult(p5.Vector.sub(this.c1, this.c0), 3) + ).mag() / 2 + ); + }; + + /** + * @method split + * @param {Number} t the value (0-1) at which to split + * @return {Cubic} the second part of the curve + * + * splits the cubic into two parts at a point 't' along the curve. + * this cubic keeps its start point and its end point becomes the + * point at 't'. the 'end half is returned. + */ + this.split = function(t) { + var m1 = p5.Vector.lerp(this.p0, this.c0, t); + var m2 = p5.Vector.lerp(this.c0, this.c1, t); + var mm1 = p5.Vector.lerp(m1, m2, t); + + this.c1 = p5.Vector.lerp(this.c1, this.p1, t); + this.c0 = p5.Vector.lerp(m2, this.c1, t); + var pt = p5.Vector.lerp(mm1, this.c0, t); + var part1 = new Cubic(this.p0, m1, mm1, pt); + this.p0 = pt; + return part1; + }; + + /** + * @method splitInflections + * @return {Cubic[]} the non-inflecting pieces of this cubic + * + * returns an array containing 0, 1 or 2 cubics split resulting + * from splitting this cubic at its inflection points. + * this cubic is (potentially) altered and returned in the list. + */ + this.splitInflections = function() { + var a = p5.Vector.sub(this.c0, this.p0); + var b = p5.Vector.sub(p5.Vector.sub(this.c1, this.c0), a); + var c = p5.Vector.sub( + p5.Vector.sub(p5.Vector.sub(this.p1, this.c1), a), + p5.Vector.mult(b, 2) + ); + + var cubics = []; + + // find the derivative coefficients + var A = b.x * c.y - b.y * c.x; + if (A !== 0) { + var B = a.x * c.y - a.y * c.x; + var C = a.x * b.y - a.y * b.x; + var disc = B * B - 4 * A * C; + if (disc >= 0) { + if (A < 0) { + A = -A; + B = -B; + C = -C; + } + + var Q = Math.sqrt(disc); + var t0 = (-B - Q) / (2 * A); // the first inflection point + var t1 = (-B + Q) / (2 * A); // the second inflection point + + // test if the first inflection point lies on the curve + if (t0 > 0 && t0 < 1) { + // split at the first inflection point + cubics.push(this.split(t0)); + // scale t2 into the second part + t1 = 1 - (1 - t1) / (1 - t0); + } + + // test if the second inflection point lies on the curve + if (t1 > 0 && t1 < 1) { + // split at the second inflection point + cubics.push(this.split(t1)); + } + } + } + + cubics.push(this); + return cubics; + }; + } + + /** + * @function cubicToQuadratics + * @param {Number} x0 + * @param {Number} y0 + * @param {Number} cx0 + * @param {Number} cy0 + * @param {Number} cx1 + * @param {Number} cy1 + * @param {Number} x1 + * @param {Number} y1 + * @returns {Cubic[]} an array of cubics whose quadratic approximations + * closely match the civen cubic. + * + * converts a cubic curve to a list of quadratics. + */ + function cubicToQuadratics(x0, y0, cx0, cy0, cx1, cy1, x1, y1) { + // create the Cubic object and split it at its inflections + var cubics = new Cubic( + new p5.Vector(x0, y0), + new p5.Vector(cx0, cy0), + new p5.Vector(cx1, cy1), + new p5.Vector(x1, y1) + ).splitInflections(); + + var qs = []; // the final list of quadratics + var precision = 30 / SQRT3; + + // for each of the non-inflected pieces of the original cubic + for (var i = 0; i < cubics.length; i++) { + var cubic = cubics[i]; + + // the cubic is iteratively split in 3 pieces: + // the first piece is accumulated in 'qs', the result. + // the last piece is accumulated in 'tail', temporarily. + // the middle piece is repeatedly split again, while necessary. + var tail = []; + + var t3; + for (;;) { + // calculate this cubic's precision + t3 = precision / cubic.quadError(); + if (t3 >= 0.5 * 0.5 * 0.5) { + break; // not too bad, we're done + } + + // find a split point based on the error + var t = Math.pow(t3, 1.0 / 3.0); + // split the cubic in 3 + var start = cubic.split(t); + var middle = cubic.split(1 - t / (1 - t)); + + qs.push(start); // the first part + tail.push(cubic); // the last part + cubic = middle; // iterate on the middle piece + } + + if (t3 < 1) { + // a little excess error, split the middle in two + qs.push(cubic.split(0.5)); + } + // add the middle piece to the result + qs.push(cubic); + + // finally add the tail, reversed, onto the result + Array.prototype.push.apply(qs, tail.reverse()); + } + + return qs; + } + + /** + * @function pushLine + * @param {Number} x0 + * @param {Number} y0 + * @param {Number} x1 + * @param {Number} y1 + * + * add a straight line to the row/col grid of a glyph + */ + function pushLine(x0, y0, x1, y1) { + var mx = (x0 + x1) / 2; + var my = (y0 + y1) / 2; + push([x0, x1], [y0, y1], { x: x0, y: y0, cx: mx, cy: my }); + } + + /** + * @function samePoint + * @param {Number} x0 + * @param {Number} y0 + * @param {Number} x1 + * @param {Number} y1 + * @return {Boolean} true if the two points are sufficiently close + * + * tests if two points are close enough to be considered the same + */ + function samePoint(x0, y0, x1, y1) { + return Math.abs(x1 - x0) < 0.00001 && Math.abs(y1 - y0) < 0.00001; + } + + var x0, y0, xs, ys; + for (var iCmd = 0; iCmd < cmds.length; ++iCmd) { + var cmd = cmds[iCmd]; + // scale the coordinates to the range 0-1 + var x1 = (cmd.x - xMin) / gWidth; + var y1 = (cmd.y - yMin) / gHeight; + + // don't bother if this point is the same as the last + if (samePoint(x0, y0, x1, y1)) continue; + + switch (cmd.type) { + case 'M': // move + xs = x1; + ys = y1; + break; + case 'L': // line + pushLine(x0, y0, x1, y1); + break; + case 'Q': // quadratic + var cx = (cmd.x1 - xMin) / gWidth; + var cy = (cmd.y1 - yMin) / gHeight; + push([x0, x1, cx], [y0, y1, cy], { x: x0, y: y0, cx: cx, cy: cy }); + break; + case 'Z': // end + if (!samePoint(x0, y0, xs, ys)) { + // add an extra line closing the loop, if necessary + pushLine(x0, y0, xs, ys); + strokes.push({ x: xs, y: ys }); + } else { + strokes.push({ x: x0, y: y0 }); + } + break; + case 'C': // cubic + var cx1 = (cmd.x1 - xMin) / gWidth; + var cy1 = (cmd.y1 - yMin) / gHeight; + var cx2 = (cmd.x2 - xMin) / gWidth; + var cy2 = (cmd.y2 - yMin) / gHeight; + var qs = cubicToQuadratics(x0, y0, cx1, cy1, cx2, cy2, x1, y1); + for (var iq = 0; iq < qs.length; iq++) { + var q = qs[iq].toQuadratic(); + push([q.x, q.x1, q.cx], [q.y, q.y1, q.cy], q); + } + break; + default: + throw new Error('unknown command type: ' + cmd.type); + } + x0 = x1; + y0 = y1; + } + + // allocate space for the strokes + var strokeCount = strokes.length; + var strokeImageInfo = this.strokeImageInfos.findImage(strokeCount); + var strokeOffset = strokeImageInfo.index; + + // fill the stroke image + for (var il = 0; il < strokeCount; ++il) { + var s = strokes[il]; + setPixel(strokeImageInfo, byte(s.x), byte(s.y), byte(s.cx), byte(s.cy)); + } + + /** + * @function layout + * @param {Number[][]} dim + * @param {ImageInfo[]} dimImageInfos + * @param {ImageInfo[]} cellImageInfos + * @return {Object} + * + * lays out the curves in a dimension (row or col) into two + * images, one for the indices of the curves themselves, and + * one containing the offset and length of those index spans. + */ + function layout(dim, dimImageInfos, cellImageInfos) { + var dimLength = dim.length; // the number of slices in this dimension + var dimImageInfo = dimImageInfos.findImage(dimLength); + var dimOffset = dimImageInfo.index; + // calculate the total number of stroke indices in this dimension + var totalStrokes = 0; + for (var id = 0; id < dimLength; ++id) { + totalStrokes += dim[id].length; + } + + // allocate space for the stroke indices + var cellImageInfo = cellImageInfos.findImage(totalStrokes); + + // for each slice in the glyph + for (var i = 0; i < dimLength; ++i) { + var strokeIndices = dim[i]; + var strokeCount = strokeIndices.length; + var cellLineIndex = cellImageInfo.index; + + // write the offset and count into the glyph slice image + setPixel( + dimImageInfo, + cellLineIndex >> 7, + cellLineIndex & 0x7f, + strokeCount >> 7, + strokeCount & 0x7f + ); + + // for each stroke index in that slice + for (var iil = 0; iil < strokeCount; ++iil) { + // write the stroke index into the slice's image + var strokeIndex = strokeIndices[iil] + strokeOffset; + setPixel(cellImageInfo, strokeIndex >> 7, strokeIndex & 0x7f, 0, 0); + } + } + + return { + cellImageInfo: cellImageInfo, + dimOffset: dimOffset, + dimImageInfo: dimImageInfo + }; + } + + // initialize the info for this glyph + gi = this.glyphInfos[glyph.index] = { + glyph: glyph, + uGlyphRect: [bb.x1, -bb.y1, bb.x2, -bb.y2], + strokeImageInfo: strokeImageInfo, + strokes: strokes, + colInfo: layout(cols, this.colDimImageInfos, this.colCellImageInfos), + rowInfo: layout(rows, this.rowDimImageInfos, this.rowCellImageInfos) + }; + gi.uGridOffset = [gi.colInfo.dimOffset, gi.rowInfo.dimOffset]; + return gi; + }; +}; + +p5.RendererGL.prototype._renderText = function(p, line, x, y, maxY) { + if (y >= maxY || !this._doFill) { + return; // don't render lines beyond our maxY position + } + + if (!this._isOpenType()) { + console.log('WEBGL: only opentype fonts are supported'); + return p; + } + + p.push(); // fix to #803 + + // remember this state, so it can be restored later + var doStroke = this._doStroke; + var drawMode = this.drawMode; + + this._doStroke = false; + this.drawMode = constants.TEXTURE; + + // get the cached FontInfo object + var font = this._textFont.font; + var fontInfo = this._textFont._fontInfo; + if (!fontInfo) { + fontInfo = this._textFont._fontInfo = new FontInfo(font); + } + + // calculate the alignment and move/scale the view accordingly + var pos = this._textFont._handleAlignment(this, line, x, y); + var fontSize = this._textSize; + var scale = fontSize / font.unitsPerEm; + this.translate(pos.x, pos.y, 0); + this.scale(scale, scale, 1); + + // initialize the font shader + var gl = this.GL; + var initializeShader = !this._defaultFontShader; + var sh = this._getFontShader(); + sh.init(); + + if (initializeShader) { + // these are constants, really. just initialize them one-time. + sh.setUniform('uGridImageSize', [gridImageWidth, gridImageHeight]); + sh.setUniform('uCellsImageSize', [cellImageWidth, cellImageHeight]); + sh.setUniform('uStrokeImageSize', [strokeImageWidth, strokeImageHeight]); + sh.setUniform('uGridSize', [charGridWidth, charGridHeight]); + } + this._applyColorBlend(this.curFillColor); + + var g = this.gHash['glyph']; + if (!g) { + // create the geometry for rendering a quad + var geom = (this._textGeom = new p5.Geometry(1, 1, function() { + for (var i = 0; i <= 1; i++) { + for (var j = 0; j <= 1; j++) { + this.vertices.push(new p5.Vector(j, i, 0)); + this.uvs.push(j, i); + } + } + })); + geom.computeFaces().computeNormals(); + g = this.createBuffers('glyph', geom); + } + + // bind the shader buffers + this._bindBuffer(g.vertexBuffer, gl.ARRAY_BUFFER); + sh.enableAttrib(sh.attributes.aPosition.location, 3, gl.FLOAT, false, 0, 0); + this._bindBuffer(g.indexBuffer, gl.ELEMENT_ARRAY_BUFFER); + this._bindBuffer(g.uvBuffer, gl.ARRAY_BUFFER); + sh.enableAttrib(sh.attributes.aTexCoord.location, 2, gl.FLOAT, false, 0, 0); + + // this will have to do for now... + sh.setUniform('uMaterialColor', this.curFillColor); + + try { + var dx = 0; // the x position in the line + var glyphPrev = null; // the previous glyph, used for kerning + var shaderBound = false; + // fetch the glyphs in the line of text + var glyphs = font.stringToGlyphs(line); + for (var ig = 0; ig < glyphs.length; ++ig) { + var glyph = glyphs[ig]; + // kern + if (glyphPrev) dx += font.getKerningValue(glyphPrev, glyph); + + var gi = fontInfo.getGlyphInfo(glyph); + if (gi.uGlyphRect) { + var rowInfo = gi.rowInfo; + var colInfo = gi.colInfo; + sh.setUniform('uSamplerStrokes', gi.strokeImageInfo.imageData); + sh.setUniform('uSamplerRowStrokes', rowInfo.cellImageInfo.imageData); + sh.setUniform('uSamplerRows', rowInfo.dimImageInfo.imageData); + sh.setUniform('uSamplerColStrokes', colInfo.cellImageInfo.imageData); + sh.setUniform('uSamplerCols', colInfo.dimImageInfo.imageData); + sh.setUniform('uGridOffset', gi.uGridOffset); + sh.setUniform('uGlyphRect', gi.uGlyphRect); + sh.setUniform('uGlyphOffset', dx); + + if (!shaderBound) { + shaderBound = true; + sh.bindShader(); // first time around, bind the shader fully + } else { + sh.bindTextures(); // afterwards, only textures need updating + } + + // draw it + gl.drawElements(gl.TRIANGLES, 6, this.GL.UNSIGNED_SHORT, 0); + } + dx += glyph.advanceWidth; + glyphPrev = glyph; + } + } finally { + // clean up + sh.unbindShader(); + + this._doStroke = doStroke; + this.drawMode = drawMode; + + p.pop(); + } + + this._pixelsState._pixelsDirty = true; + return p; +}; + +},{"../core/constants":18,"../core/main":24,"./p5.RendererGL":74,"./p5.Shader":75}]},{},[13])(13) +}); diff --git a/p5/p5.min.js b/p5/p5.min.js new file mode 100644 index 0000000..27791bf --- /dev/null +++ b/p5/p5.min.js @@ -0,0 +1,3 @@ +/*! p5.js v0.8.0 April 08, 2019 */ + +!function(e){if("object"==typeof exports&&"undefined"!=typeof module)module.exports=e();else if("function"==typeof define&&define.amd)define([],e);else{("undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof self?self:this).p5=e()}}(function(){return function o(a,s,h){function l(t,e){if(!s[t]){if(!a[t]){var r="function"==typeof require&&require;if(!e&&r)return r(t,!0);if(u)return u(t,!0);var i=new Error("Cannot find module '"+t+"'");throw i.code="MODULE_NOT_FOUND",i}var n=s[t]={exports:{}};a[t][0].call(n.exports,function(e){return l(a[t][1][e]||e)},n,n.exports,o,a,s,h)}return s[t].exports}for(var u="function"==typeof require&&require,e=0;e>16&255,o[a++]=t>>8&255,o[a++]=255&t;var l,u;2===n&&(t=c[e.charCodeAt(h)]<<2|c[e.charCodeAt(h+1)]>>4,o[a++]=255&t);1===n&&(t=c[e.charCodeAt(h)]<<10|c[e.charCodeAt(h+1)]<<4|c[e.charCodeAt(h+2)]>>2,o[a++]=t>>8&255,o[a++]=255&t);return o},r.fromByteArray=function(e){for(var t,r=e.length,i=r%3,n=[],o=0,a=r-i;o>2]+s[t<<4&63]+"==")):2===i&&(t=(e[r-2]<<8)+e[r-1],n.push(s[t>>10]+s[t>>4&63]+s[t<<2&63]+"="));return n.join("")};for(var s=[],c=[],p="undefined"!=typeof Uint8Array?Uint8Array:Array,i="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",n=0,o=i.length;n>18&63]+s[n>>12&63]+s[n>>6&63]+s[63&n]);return o.join("")}c["-".charCodeAt(0)]=62,c["_".charCodeAt(0)]=63},{}],2:[function(e,t,r){},{}],3:[function(e,t,r){"use strict";var i=e("base64-js"),o=e("ieee754");r.Buffer=c,r.SlowBuffer=function(e){+e!=e&&(e=0);return c.alloc(+e)},r.INSPECT_MAX_BYTES=50;var n=2147483647;function a(e){if(n>>1;case"base64":return I(e).length;default:if(n)return i?-1:k(e).length;t=(""+t).toLowerCase(),n=!0}}function f(e,t,r){var i=e[t];e[t]=e[r],e[r]=i}function m(e,t,r,i,n){if(0===e.length)return-1;if("string"==typeof r?(i=r,r=0):2147483647=e.length){if(n)return-1;r=e.length-1}else if(r<0){if(!n)return-1;r=0}if("string"==typeof t&&(t=c.from(t,i)),c.isBuffer(t))return 0===t.length?-1:v(e,t,r,i,n);if("number"==typeof t)return t&=255,"function"==typeof Uint8Array.prototype.indexOf?n?Uint8Array.prototype.indexOf.call(e,t,r):Uint8Array.prototype.lastIndexOf.call(e,t,r):v(e,[t],r,i,n);throw new TypeError("val must be string, number or Buffer")}function v(e,t,r,i,n){var o,a=1,s=e.length,h=t.length;if(void 0!==i&&("ucs2"===(i=String(i).toLowerCase())||"ucs-2"===i||"utf16le"===i||"utf-16le"===i)){if(e.length<2||t.length<2)return-1;s/=a=2,h/=2,r/=2}function l(e,t){return 1===a?e[t]:e.readUInt16BE(t*a)}if(n){var u=-1;for(o=r;o>>10&1023|55296),u=56320|1023&u),i.push(u),n+=c}return function(e){var t=e.length;if(t<=x)return String.fromCharCode.apply(String,e);var r="",i=0;for(;ithis.length)return"";if((void 0===r||r>this.length)&&(r=this.length),r<=0)return"";if((r>>>=0)<=(t>>>=0))return"";for(e||(e="utf8");;)switch(e){case"hex":return T(this,t,r);case"utf8":case"utf-8":return _(this,t,r);case"ascii":return w(this,t,r);case"latin1":case"binary":return S(this,t,r);case"base64":return b(this,t,r);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return M(this,t,r);default:if(i)throw new TypeError("Unknown encoding: "+e);e=(e+"").toLowerCase(),i=!0}}.apply(this,arguments)},c.prototype.equals=function(e){if(!c.isBuffer(e))throw new TypeError("Argument must be a Buffer");return this===e||0===c.compare(this,e)},c.prototype.inspect=function(){var e="",t=r.INSPECT_MAX_BYTES;return e=this.toString("hex",0,t).replace(/(.{2})/g,"$1 ").trim(),this.length>t&&(e+=" ... "),""},c.prototype.compare=function(e,t,r,i,n){if(O(e,Uint8Array)&&(e=c.from(e,e.offset,e.byteLength)),!c.isBuffer(e))throw new TypeError('The "target" argument must be one of type Buffer or Uint8Array. Received type '+typeof e);if(void 0===t&&(t=0),void 0===r&&(r=e?e.length:0),void 0===i&&(i=0),void 0===n&&(n=this.length),t<0||r>e.length||i<0||n>this.length)throw new RangeError("out of range index");if(n<=i&&r<=t)return 0;if(n<=i)return-1;if(r<=t)return 1;if(this===e)return 0;for(var o=(n>>>=0)-(i>>>=0),a=(r>>>=0)-(t>>>=0),s=Math.min(o,a),h=this.slice(i,n),l=e.slice(t,r),u=0;u>>=0,isFinite(r)?(r>>>=0,void 0===i&&(i="utf8")):(i=r,r=void 0)}var n=this.length-t;if((void 0===r||nthis.length)throw new RangeError("Attempt to write outside buffer bounds");i||(i="utf8");for(var o,a,s,h,l,u,c,p,d,f=!1;;)switch(i){case"hex":return g(this,e,t,r);case"utf8":case"utf-8":return p=t,d=r,U(k(e,(c=this).length-p),c,p,d);case"ascii":return y(this,e,t,r);case"latin1":case"binary":return y(this,e,t,r);case"base64":return h=this,l=t,u=r,U(I(e),h,l,u);case"ucs2":case"ucs-2":case"utf16le":case"utf-16le":return a=t,s=r,U(function(e,t){for(var r,i,n,o=[],a=0;a>8,n=r%256,o.push(n),o.push(i);return o}(e,(o=this).length-a),o,a,s);default:if(f)throw new TypeError("Unknown encoding: "+i);i=(""+i).toLowerCase(),f=!0}},c.prototype.toJSON=function(){return{type:"Buffer",data:Array.prototype.slice.call(this._arr||this,0)}};var x=4096;function w(e,t,r){var i="";r=Math.min(e.length,r);for(var n=t;ne.length)throw new RangeError("Index out of range")}function R(e,t,r,i,n,o){if(r+i>e.length)throw new RangeError("Index out of range");if(r<0)throw new RangeError("Index out of range")}function L(e,t,r,i,n){return t=+t,r>>>=0,n||R(e,0,r,4),o.write(e,t,r,i,23,4),r+4}function P(e,t,r,i,n){return t=+t,r>>>=0,n||R(e,0,r,8),o.write(e,t,r,i,52,8),r+8}c.prototype.slice=function(e,t){var r=this.length;(e=~~e)<0?(e+=r)<0&&(e=0):r>>=0,t>>>=0,r||E(e,t,this.length);for(var i=this[e],n=1,o=0;++o>>=0,t>>>=0,r||E(e,t,this.length);for(var i=this[e+--t],n=1;0>>=0,t||E(e,1,this.length),this[e]},c.prototype.readUInt16LE=function(e,t){return e>>>=0,t||E(e,2,this.length),this[e]|this[e+1]<<8},c.prototype.readUInt16BE=function(e,t){return e>>>=0,t||E(e,2,this.length),this[e]<<8|this[e+1]},c.prototype.readUInt32LE=function(e,t){return e>>>=0,t||E(e,4,this.length),(this[e]|this[e+1]<<8|this[e+2]<<16)+16777216*this[e+3]},c.prototype.readUInt32BE=function(e,t){return e>>>=0,t||E(e,4,this.length),16777216*this[e]+(this[e+1]<<16|this[e+2]<<8|this[e+3])},c.prototype.readIntLE=function(e,t,r){e>>>=0,t>>>=0,r||E(e,t,this.length);for(var i=this[e],n=1,o=0;++o>>=0,t>>>=0,r||E(e,t,this.length);for(var i=t,n=1,o=this[e+--i];0>>=0,t||E(e,1,this.length),128&this[e]?-1*(255-this[e]+1):this[e]},c.prototype.readInt16LE=function(e,t){e>>>=0,t||E(e,2,this.length);var r=this[e]|this[e+1]<<8;return 32768&r?4294901760|r:r},c.prototype.readInt16BE=function(e,t){e>>>=0,t||E(e,2,this.length);var r=this[e+1]|this[e]<<8;return 32768&r?4294901760|r:r},c.prototype.readInt32LE=function(e,t){return e>>>=0,t||E(e,4,this.length),this[e]|this[e+1]<<8|this[e+2]<<16|this[e+3]<<24},c.prototype.readInt32BE=function(e,t){return e>>>=0,t||E(e,4,this.length),this[e]<<24|this[e+1]<<16|this[e+2]<<8|this[e+3]},c.prototype.readFloatLE=function(e,t){return e>>>=0,t||E(e,4,this.length),o.read(this,e,!0,23,4)},c.prototype.readFloatBE=function(e,t){return e>>>=0,t||E(e,4,this.length),o.read(this,e,!1,23,4)},c.prototype.readDoubleLE=function(e,t){return e>>>=0,t||E(e,8,this.length),o.read(this,e,!0,52,8)},c.prototype.readDoubleBE=function(e,t){return e>>>=0,t||E(e,8,this.length),o.read(this,e,!1,52,8)},c.prototype.writeUIntLE=function(e,t,r,i){(e=+e,t>>>=0,r>>>=0,i)||C(this,e,t,r,Math.pow(2,8*r)-1,0);var n=1,o=0;for(this[t]=255&e;++o>>=0,r>>>=0,i)||C(this,e,t,r,Math.pow(2,8*r)-1,0);var n=r-1,o=1;for(this[t+n]=255&e;0<=--n&&(o*=256);)this[t+n]=e/o&255;return t+r},c.prototype.writeUInt8=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,1,255,0),this[t]=255&e,t+1},c.prototype.writeUInt16LE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,2,65535,0),this[t]=255&e,this[t+1]=e>>>8,t+2},c.prototype.writeUInt16BE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,2,65535,0),this[t]=e>>>8,this[t+1]=255&e,t+2},c.prototype.writeUInt32LE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,4,4294967295,0),this[t+3]=e>>>24,this[t+2]=e>>>16,this[t+1]=e>>>8,this[t]=255&e,t+4},c.prototype.writeUInt32BE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,4,4294967295,0),this[t]=e>>>24,this[t+1]=e>>>16,this[t+2]=e>>>8,this[t+3]=255&e,t+4},c.prototype.writeIntLE=function(e,t,r,i){if(e=+e,t>>>=0,!i){var n=Math.pow(2,8*r-1);C(this,e,t,r,n-1,-n)}var o=0,a=1,s=0;for(this[t]=255&e;++o>0)-s&255;return t+r},c.prototype.writeIntBE=function(e,t,r,i){if(e=+e,t>>>=0,!i){var n=Math.pow(2,8*r-1);C(this,e,t,r,n-1,-n)}var o=r-1,a=1,s=0;for(this[t+o]=255&e;0<=--o&&(a*=256);)e<0&&0===s&&0!==this[t+o+1]&&(s=1),this[t+o]=(e/a>>0)-s&255;return t+r},c.prototype.writeInt8=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,1,127,-128),e<0&&(e=255+e+1),this[t]=255&e,t+1},c.prototype.writeInt16LE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,2,32767,-32768),this[t]=255&e,this[t+1]=e>>>8,t+2},c.prototype.writeInt16BE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,2,32767,-32768),this[t]=e>>>8,this[t+1]=255&e,t+2},c.prototype.writeInt32LE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,4,2147483647,-2147483648),this[t]=255&e,this[t+1]=e>>>8,this[t+2]=e>>>16,this[t+3]=e>>>24,t+4},c.prototype.writeInt32BE=function(e,t,r){return e=+e,t>>>=0,r||C(this,e,t,4,2147483647,-2147483648),e<0&&(e=4294967295+e+1),this[t]=e>>>24,this[t+1]=e>>>16,this[t+2]=e>>>8,this[t+3]=255&e,t+4},c.prototype.writeFloatLE=function(e,t,r){return L(this,e,t,!0,r)},c.prototype.writeFloatBE=function(e,t,r){return L(this,e,t,!1,r)},c.prototype.writeDoubleLE=function(e,t,r){return P(this,e,t,!0,r)},c.prototype.writeDoubleBE=function(e,t,r){return P(this,e,t,!1,r)},c.prototype.copy=function(e,t,r,i){if(!c.isBuffer(e))throw new TypeError("argument should be a Buffer");if(r||(r=0),i||0===i||(i=this.length),t>=e.length&&(t=e.length),t||(t=0),0=this.length)throw new RangeError("Index out of range");if(i<0)throw new RangeError("sourceEnd out of bounds");i>this.length&&(i=this.length),e.length-t>>=0,r=void 0===r?this.length:r>>>0,e||(e=0),"number"==typeof e)for(o=t;o>6|192,63&r|128)}else if(r<65536){if((t-=3)<0)break;o.push(r>>12|224,r>>6&63|128,63&r|128)}else{if(!(r<1114112))throw new Error("Invalid code point");if((t-=4)<0)break;o.push(r>>18|240,r>>12&63|128,r>>6&63|128,63&r|128)}}return o}function I(e){return i.toByteArray(function(e){if((e=(e=e.split("=")[0]).trim().replace(D,"")).length<2)return"";for(;e.length%4!=0;)e+="=";return e}(e))}function U(e,t,r,i){for(var n=0;n=t.length||n>=e.length);++n)t[n+r]=e[n];return n}function O(e,t){return e instanceof t||null!=e&&null!=e.constructor&&null!=e.constructor.name&&e.constructor.name===t.name}function B(e){return e!=e}},{"base64-js":1,ieee754:7}],4:[function(z,r,i){(function(G,V){var e,t;e=this,t=function(){"use strict";function l(e){return"function"==typeof e}var r=Array.isArray?Array.isArray:function(e){return"[object Array]"===Object.prototype.toString.call(e)},i=0,t=void 0,n=void 0,s=function(e,t){p[i]=e,p[i+1]=t,2===(i+=2)&&(n?n(d):y())};var e="undefined"!=typeof window?window:void 0,o=e||{},a=o.MutationObserver||o.WebKitMutationObserver,h="undefined"==typeof self&&void 0!==G&&"[object process]"==={}.toString.call(G),u="undefined"!=typeof Uint8ClampedArray&&"undefined"!=typeof importScripts&&"undefined"!=typeof MessageChannel;function c(){var e=setTimeout;return function(){return e(d,1)}}var p=new Array(1e3);function d(){for(var e=0;e>1,u=-7,c=r?n-1:0,p=r?-1:1,d=e[t+c];for(c+=p,o=d&(1<<-u)-1,d>>=-u,u+=s;0>=-u,u+=i;0>1,p=23===n?Math.pow(2,-24)-Math.pow(2,-77):0,d=i?0:o-1,f=i?1:-1,m=t<0||0===t&&1/t<0?1:0;for(t=Math.abs(t),isNaN(t)||t===1/0?(s=isNaN(t)?1:0,a=u):(a=Math.floor(Math.log(t)/Math.LN2),t*(h=Math.pow(2,-a))<1&&(a--,h*=2),2<=(t+=1<=a+c?p/h:p*Math.pow(2,1-c))*h&&(a++,h/=2),u<=a+c?(s=0,a=u):1<=a+c?(s=(t*h-1)*Math.pow(2,n),a+=c):(s=t*Math.pow(2,c-1)*Math.pow(2,n),a=0));8<=n;e[r+d]=255&s,d+=f,s/=256,n-=8);for(a=a<Math.abs(e[0])&&(t=1),Math.abs(e[2])>Math.abs(e[t])&&(t=2),t}var C=4e150;function R(e,t){e.f+=t.f,e.b.f+=t.b.f}function l(e,t,r){return e=e.a,t=t.a,r=r.a,t.b.a===e?r.b.a===e?g(t.a,r.a)?b(r.b.a,t.a,r.a)<=0:0<=b(t.b.a,r.a,t.a):b(r.b.a,e,r.a)<=0:r.b.a===e?0<=b(t.b.a,e,t.a):(t=y(t.b.a,e,t.a),(e=y(r.b.a,e,r.a))<=t)}function L(e){e.a.i=null;var t=e.e;t.a.c=t.c,t.c.a=t.a,e.e=null}function u(e,t){c(e.a),e.c=!1,(e.a=t).i=e}function P(e){for(var t=e.a.a;(e=pe(e)).a.a===t;);return e.c&&(u(e,t=p(ce(e).a.b,e.a.e)),e=pe(e)),e}function D(e,t,r){var i=new ue;return i.a=r,i.e=W(e.f,t.e,i),r.i=i}function A(e,t){switch(e.s){case 100130:return 0!=(1&t);case 100131:return 0!==t;case 100132:return 0>1]],s[a[l]])?he(r,l):le(r,l)),s[o]=null,h[o]=r.b,r.b=o}else for(r.c[-(o+1)]=null;0Math.max(a.a,h.a))return!1;if(g(o,a)){if(0i.f&&(i.f*=2,i.c=oe(i.c,i.f+1)),0===i.b?r=n:(r=i.b,i.b=i.c[i.b]),i.e[r]=t,i.c[r]=n,i.d[n]=r,i.h&&le(i,n),r}return i=e.a++,e.c[i]=t,-(i+1)}function ie(e){if(0===e.a)return se(e.b);var t=e.c[e.d[e.a-1]];if(0!==e.b.a&&g(ae(e.b),t))return se(e.b);for(;--e.a,0e.a||g(i[a],i[h])){n[r[o]=a]=o;break}n[r[o]=h]=o,o=s}}function le(e,t){for(var r=e.d,i=e.e,n=e.c,o=t,a=r[o];;){var s=o>>1,h=r[s];if(0===s||g(i[h],i[a])){n[r[o]=a]=o;break}n[r[o]=h]=o,o=s}}function ue(){this.e=this.a=null,this.f=0,this.c=this.b=this.h=this.d=!1}function ce(e){return e.e.c.b}function pe(e){return e.e.a.b}(i=q.prototype).x=function(){Y(this,0)},i.B=function(e,t){switch(e){case 100142:return;case 100140:switch(t){case 100130:case 100131:case 100132:case 100133:case 100134:return void(this.s=t)}break;case 100141:return void(this.m=!!t);default:return void Z(this,100900)}Z(this,100901)},i.y=function(e){switch(e){case 100142:return 0;case 100140:return this.s;case 100141:return this.m;default:Z(this,100900)}return!1},i.A=function(e,t,r){this.j[0]=e,this.j[1]=t,this.j[2]=r},i.z=function(e,t){var r=t||null;switch(e){case 100100:case 100106:this.h=r;break;case 100104:case 100110:this.l=r;break;case 100101:case 100107:this.k=r;break;case 100102:case 100108:this.i=r;break;case 100103:case 100109:this.p=r;break;case 100105:case 100111:this.o=r;break;case 100112:this.r=r;break;default:Z(this,100900)}},i.C=function(e,t){var r=!1,i=[0,0,0];Y(this,2);for(var n=0;n<3;++n){var o=e[n];o<-1e150&&(o=-1e150,r=!0),1e150n[l]&&(n[l]=u,a[l]=h)}if(h=0,n[1]-o[1]>n[0]-o[0]&&(h=1),n[2]-o[2]>n[h]-o[h]&&(h=2),o[h]>=n[h])i[0]=0,i[1]=0,i[2]=1;else{for(n=0,o=s[h],a=a[h],s=[0,0,0],o=[o.g[0]-a.g[0],o.g[1]-a.g[1],o.g[2]-a.g[2]],l=[0,0,0],h=r.e;h!==r;h=h.e)l[0]=h.g[0]-a.g[0],l[1]=h.g[1]-a.g[1],l[2]=h.g[2]-a.g[2],s[0]=o[1]*l[2]-o[2]*l[1],s[1]=o[2]*l[0]-o[0]*l[2],s[2]=o[0]*l[1]-o[1]*l[0],n<(u=s[0]*s[0]+s[1]*s[1]+s[2]*s[2])&&(n=u,i[0]=s[0],i[1]=s[1],i[2]=s[2]);n<=0&&(i[0]=i[1]=i[2]=0,i[E(o)]=1)}r=!0}for(s=E(i),h=this.b.c,n=(s+1)%3,a=(s+2)%3,s=0>>=1,t}function _(e,t,r){if(!t)return r;for(;e.bitcount<24;)e.tag|=e.source[e.sourceIndex++]<>>16-t;return e.tag>>>=t,e.bitcount-=t,i+r}function x(e,t){for(;e.bitcount<24;)e.tag|=e.source[e.sourceIndex++]<>>=1,++n,r+=t.table[n],0<=(i-=t.table[n]););return e.tag=o,e.bitcount-=n,t.trans[r+i]}function w(e,t,r){var i,n,o,a,s,h;for(i=_(e,5,257),n=_(e,5,1),o=_(e,4,4),a=0;a<19;++a)v[a]=0;for(a=0;athis.x2&&(this.x2=e)),"number"==typeof t&&((isNaN(this.y1)||isNaN(this.y2))&&(this.y1=t,this.y2=t),tthis.y2&&(this.y2=t))},C.prototype.addX=function(e){this.addPoint(e,null)},C.prototype.addY=function(e){this.addPoint(null,e)},C.prototype.addBezier=function(e,t,r,i,n,o,a,s){var h=this,l=[e,t],u=[r,i],c=[n,o],p=[a,s];this.addPoint(e,t),this.addPoint(a,s);for(var d=0;d<=1;d++){var f=6*l[d]-12*u[d]+6*c[d],m=-3*l[d]+9*u[d]-9*c[d]+3*p[d],v=3*u[d]-3*l[d];if(0!==m){var g=Math.pow(f,2)-4*v*m;if(!(g<0)){var y=(-f+Math.sqrt(g))/(2*m);0>8&255,255&e]},I.USHORT=O(2),k.SHORT=function(e){return 32768<=e&&(e=-(65536-e)),[e>>8&255,255&e]},I.SHORT=O(2),k.UINT24=function(e){return[e>>16&255,e>>8&255,255&e]},I.UINT24=O(3),k.ULONG=function(e){return[e>>24&255,e>>16&255,e>>8&255,255&e]},I.ULONG=O(4),k.LONG=function(e){return D<=e&&(e=-(2*D-e)),[e>>24&255,e>>16&255,e>>8&255,255&e]},I.LONG=O(4),k.FIXED=k.ULONG,I.FIXED=I.ULONG,k.FWORD=k.SHORT,I.FWORD=I.SHORT,k.UFWORD=k.USHORT,I.UFWORD=I.USHORT,k.LONGDATETIME=function(e){return[0,0,0,0,e>>24&255,e>>16&255,e>>8&255,255&e]},I.LONGDATETIME=O(8),k.TAG=function(e){return P.argument(4===e.length,"Tag should be exactly 4 ASCII characters."),[e.charCodeAt(0),e.charCodeAt(1),e.charCodeAt(2),e.charCodeAt(3)]},I.TAG=O(4),k.Card8=k.BYTE,I.Card8=I.BYTE,k.Card16=k.USHORT,I.Card16=I.USHORT,k.OffSize=k.BYTE,I.OffSize=I.BYTE,k.SID=k.USHORT,I.SID=I.USHORT,k.NUMBER=function(e){return-107<=e&&e<=107?[e+139]:108<=e&&e<=1131?[247+((e-=108)>>8),255&e]:-1131<=e&&e<=-108?[251+((e=-e-108)>>8),255&e]:-32768<=e&&e<=32767?k.NUMBER16(e):k.NUMBER32(e)},I.NUMBER=function(e){return k.NUMBER(e).length},k.NUMBER16=function(e){return[28,e>>8&255,255&e]},I.NUMBER16=O(3),k.NUMBER32=function(e){return[29,e>>24&255,e>>16&255,e>>8&255,255&e]},I.NUMBER32=O(5),k.REAL=function(e){var t=e.toString(),r=/\.(\d*?)(?:9{5,20}|0{5,20})\d{0,2}(?:e(.+)|$)/.exec(t);if(r){var i=parseFloat("1e"+((r[2]?+r[2]:0)+r[1].length));t=(Math.round(e*i)/i).toString()}for(var n="",o=0,a=t.length;o>8&255,t[t.length]=255&i}return t},I.UTF16=function(e){return 2*e.length};var B={"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":"ÄÅÇÉÑÖÜáàâäãåçéèêëíìîïñóòôöõúùûü†°¢£§•¶ß®©™´¨≠ÆØ∞±≤≥¥µ∂∑∏π∫ªºΩæø¿¡¬√ƒ≈∆«»… ÀÃÕŒœ–—“”‘’÷◊ÿŸĞğİıŞş‡·‚„‰ÂÊÁËÈÍÎÏÌÓÔÒÚÛÙˆ˜¯˘˙˚¸˝˛ˇ"};A.MACSTRING=function(e,t,r,i){var n=B[i];if(void 0!==n){for(var o="",a=0;a>8&255,h+256&255)}return o}k.MACSTRING=function(e,t){var r=function(e){if(!N)for(var t in N={},B)N[t]=new String(t);var r=N[e];if(void 0!==r){if(F){var i=F.get(r);if(void 0!==i)return i}var n=B[e];if(void 0!==n){for(var o={},a=0;a>8,t[c+1]=255&p,t=t.concat(i[u])}return t},I.TABLE=function(e){for(var t=0,r=e.fields.length,i=0;i>1,t.skip("uShort",3),e.glyphIndexMap={};for(var a=new se.Parser(r,i+n+14),s=new se.Parser(r,i+n+16+2*o),h=new se.Parser(r,i+n+16+4*o),l=new se.Parser(r,i+n+16+6*o),u=i+n+16+8*o,c=0;c>4,o=15&i;if(15===n)break;if(t+=r[n],15===o)break;t+=r[o]}return parseFloat(t)}(e);if(32<=t&&t<=246)return t-139;if(247<=t&&t<=250)return 256*(t-247)+e.parseByte()+108;if(251<=t&&t<=254)return 256*-(t-251)-e.parseByte()-108;throw new Error("Invalid b0 "+t)}function Ee(e,t,r){t=void 0!==t?t:0;var i=new se.Parser(e,t),n=[],o=[];for(r=void 0!==r?r:e.length;i.relativeOffset>1,E.length=0,R=!0}return function e(t){for(var r,i,n,o,a,s,h,l,u,c,p,d,f=0;fMath.abs(d-D)?P=p+E.shift():D=d+E.shift(),M.curveTo(y,b,_,x,h,l),M.curveTo(u,c,p,d,P,D);break;default:console.log("Glyph "+g.index+": unknown operator 1200"+m),E.length=0}break;case 14:0>3;break;case 21:2>16),f+=2;break;case 29:a=E.pop()+v.gsubrsBias,(s=v.gsubrs[a])&&e(s);break;case 30:for(;0=r.begin&&e=pe.length){var a=i.parseChar();r.names.push(i.parseString(a))}break;case 2.5:r.numberOfGlyphs=i.parseUShort(),r.offset=new Array(r.numberOfGlyphs);for(var s=0;st.value.tag?1:-1}),t.fields=t.fields.concat(i),t.fields=t.fields.concat(n),t}function vt(e,t,r){for(var i=0;i 123 are reserved for internal usage");d|=1<>>1,o=e[n].tag;if(o===t)return n;o>>1,o=e[n];if(o===t)return n;o>>1,a=(r=e[o]).start;if(a===t)return r;a(r=e[i-1]).end?0:r}function xt(e,t){this.font=e,this.tableName=t}function wt(e){xt.call(this,e,"gpos")}function St(e){xt.call(this,e,"gsub")}function Tt(e,t){var r=e.length;if(r!==t.length)return!1;for(var i=0;it.points.length-1||i.matchedPoints[1]>n.points.length-1)throw Error("Matched points out of range in "+t.name);var a=t.points[i.matchedPoints[0]],s=n.points[i.matchedPoints[1]],h={xScale:i.xScale,scale01:i.scale01,scale10:i.scale10,yScale:i.yScale,dx:0,dy:0};s=Pt([s],h)[0],h.dx=a.x-s.x,h.dy=a.y-s.y,o=Pt(n.points,h)}t.points=t.points.concat(o)}}return Dt(t.points)}(wt.prototype=xt.prototype={searchTag:yt,binSearch:bt,getTable:function(e){var t=this.font.tables[this.tableName];return!t&&e&&(t=this.font.tables[this.tableName]=this.createDefaultTable()),t},getScriptNames:function(){var e=this.getTable();return e?e.scripts.map(function(e){return e.tag}):[]},getDefaultScriptName:function(){var e=this.getTable();if(e){for(var t=!1,r=0;r=s[l-1].tag,"Features must be added in alphabetical order."),o={tag:r,feature:{params:0,lookupListIndexes:[]}},s.push(o),a.push(l),o.feature}}},getLookupTables:function(e,t,r,i,n){var o=this.getFeatureTable(e,t,r,n),a=[];if(o){for(var s,h=o.lookupListIndexes,l=this.font.tables[this.tableName].lookups,u=0;u",s),t.stack.push(Math.round(64*s))}function gr(e,t){var r=t.stack,i=r.pop(),n=t.fv,o=t.pv,a=t.ppem,s=t.deltaBase+16*(e-1),h=t.deltaShift,l=t.z0;M.DEBUG&&console.log(t.step,"DELTAP["+e+"]",i,r);for(var u=0;u>4)===a){var d=(15&p)-8;0<=d&&d++,M.DEBUG&&console.log(t.step,"DELTAPFIX",c,"by",d*h);var f=l[c];n.setRelative(f,f,d*h,o)}}}function yr(e,t){var r=t.stack,i=r.pop();M.DEBUG&&console.log(t.step,"ROUND[]"),r.push(64*t.round(i/64))}function br(e,t){var r=t.stack,i=r.pop(),n=t.ppem,o=t.deltaBase+16*(e-1),a=t.deltaShift;M.DEBUG&&console.log(t.step,"DELTAC["+e+"]",i,r);for(var s=0;s>4)===n){var u=(15&l)-8;0<=u&&u++;var c=u*a;M.DEBUG&&console.log(t.step,"DELTACFIX",h,"by",c),t.cvt[h]+=c}}}function _r(e,t){var r,i,n=t.stack,o=n.pop(),a=n.pop(),s=t.z2[o],h=t.z1[a];M.DEBUG&&console.log(t.step,"SDPVTL["+e+"]",o,a),i=e?(r=s.y-h.y,h.x-s.x):(r=h.x-s.x,h.y-s.y),t.dpv=Zt(r,i)}function xr(e,t){var r=t.stack,i=t.prog,n=t.ip;M.DEBUG&&console.log(t.step,"PUSHB["+e+"]");for(var o=0;o":"_")+(i?"R":"_")+(0===n?"Gr":1===n?"Bl":2===n?"Wh":"")+"]",e?c+"("+o.cvt[c]+","+l+")":"",p,"(d =",a,"->",h*s,")"),o.rp1=o.rp0,o.rp2=p,t&&(o.rp0=p)}Nt.prototype.exec=function(e,t){if("number"!=typeof t)throw new Error("Point size is not a number!");if(!(2",i),s.interpolate(c,o,a,h),s.touch(c)}e.loop=1},dr.bind(void 0,0),dr.bind(void 0,1),function(e){for(var t=e.stack,r=e.rp0,i=e.z0[r],n=e.loop,o=e.fv,a=e.pv,s=e.z1;n--;){var h=t.pop(),l=s[h];M.DEBUG&&console.log(e.step,(1=a.width||t>=a.height?[0,0,0,0]:this._getPixel(e,t);var s=new h.Image(r,i);return s.canvas.getContext("2d").drawImage(a,e,t,r*o,i*o,0,0,r,i),s},h.Renderer.prototype.textLeading=function(e){return"number"==typeof e?(this._setProperty("_textLeading",e),this._pInst):this._textLeading},h.Renderer.prototype.textSize=function(e){return"number"==typeof e?(this._setProperty("_textSize",e),this._setProperty("_textLeading",e*y._DEFAULT_LEADMULT),this._applyTextProperties()):this._textSize},h.Renderer.prototype.textStyle=function(e){return e?(e!==y.NORMAL&&e!==y.ITALIC&&e!==y.BOLD&&e!==y.BOLDITALIC||this._setProperty("_textStyle",e),this._applyTextProperties()):this._textStyle},h.Renderer.prototype.textAscent=function(){return null===this._textAscent&&this._updateTextMetrics(),this._textAscent},h.Renderer.prototype.textDescent=function(){return null===this._textDescent&&this._updateTextMetrics(),this._textDescent},h.Renderer.prototype.textAlign=function(e,t){return void 0!==e?(this._setProperty("_textAlign",e),void 0!==t&&this._setProperty("_textBaseline",t),this._applyTextProperties()):{horizontal:this._textAlign,vertical:this._textBaseline}},h.Renderer.prototype.text=function(e,t,r,i,n){var o,a,s,h,l,u,c,p,d=this._pInst,f=Number.MAX_VALUE;if((this._doFill||this._doStroke)&&void 0!==e){if("string"!=typeof e&&(e=e.toString()),o=(e=e.replace(/(\t)/g," ")).split("\n"),void 0!==i){for(s=p=0;sa.HALF_PI&&e<=3*a.HALF_PI?Math.atan(r/i*Math.tan(e))+a.PI:Math.atan(r/i*Math.tan(e))+a.TWO_PI,t=t<=a.HALF_PI?Math.atan(r/i*Math.tan(t)):t>a.HALF_PI&&t<=3*a.HALF_PI?Math.atan(r/i*Math.tan(t))+a.PI:Math.atan(r/i*Math.tan(t))+a.TWO_PI),t_||Math.abs(this.accelerationY-this.pAccelerationY)>_||Math.abs(this.accelerationZ-this.pAccelerationZ)>_)&&e();var t=this.deviceTurned||window.deviceTurned;if("function"==typeof t){var r=this.rotationX+180,i=this.pRotationX+180,n=f+180;0>>24],i+=x[(16711680&C)>>16],n+=x[(65280&C)>>8],o+=x[255&C],r+=P[_],s++}w[h=E+y]=a/r,S[h]=i/r,T[h]=n/r,M[h]=o/r}E+=d}for(u=(l=-R)*d,b=E=0;b>>16,e[r+1]=(65280&t[i])>>>8,e[r+2]=255&t[i],e[r+3]=(4278190080&t[i])>>>24},A._toImageData=function(e){return e instanceof ImageData?e:e.getContext("2d").getImageData(0,0,e.width,e.height)},A._createImageData=function(e,t){return A._tmpCanvas=document.createElement("canvas"),A._tmpCtx=A._tmpCanvas.getContext("2d"),this._tmpCtx.createImageData(e,t)},A.apply=function(e,t,r){var i=e.getContext("2d"),n=i.getImageData(0,0,e.width,e.height),o=t(n,r);o instanceof ImageData?i.putImageData(o,0,0,0,0,e.width,e.height):i.putImageData(n,0,0,0,0,e.width,e.height)},A.threshold=function(e,t){var r=A._toPixels(e);void 0===t&&(t=.5);for(var i=Math.floor(255*t),n=0;n>8)/i,r[n+1]=255*(a*t>>8)/i,r[n+2]=255*(s*t>>8)/i}},A.dilate=function(e){for(var t,r,i,n,o,a,s,h,l,u,c,p,d,f,m,v,g,y=A._toPixels(e),b=0,_=y.length?y.length/4:0,x=new Int32Array(_);b<_;)for(r=(t=b)+e.width;b>16&255)+151*(i>>8&255)+28*(255&i))<(m=77*(c>>16&255)+151*(c>>8&255)+28*(255&c))&&(n=c,o=m),o<(f=77*((u=A._getARGB(y,a))>>16&255)+151*(u>>8&255)+28*(255&u))&&(n=u,o=f),o<(v=77*(p>>16&255)+151*(p>>8&255)+28*(255&p))&&(n=p,o=v),o<(g=77*(d>>16&255)+151*(d>>8&255)+28*(255&d))&&(n=d,o=g),x[b++]=n;A._setPixels(y,x)},A.erode=function(e){for(var t,r,i,n,o,a,s,h,l,u,c,p,d,f,m,v,g,y=A._toPixels(e),b=0,_=y.length?y.length/4:0,x=new Int32Array(_);b<_;)for(r=(t=b)+e.width;b>16&255)+151*(c>>8&255)+28*(255&c))<(o=77*(i>>16&255)+151*(i>>8&255)+28*(255&i))&&(n=c,o=m),(f=77*((u=A._getARGB(y,a))>>16&255)+151*(u>>8&255)+28*(255&u))>16&255)+151*(p>>8&255)+28*(255&p))>16&255)+151*(d>>8&255)+28*(255&d))/g,">").replace(/"/g,""").replace(/'/g,"'")}function h(e,t){t&&!0!==t&&"true"!==t||(t=""),e||(e="untitled");var r="";return e&&-1"),n.print("");if('="text/html;charset=utf-8" />',n.print(' '),n.print(""),n.print(""),n.print(" "),"0"!==o[0]){n.print(" ");for(var u=0;u"+c),n.print(" ")}n.print(" ")}for(var p=0;p");for(var d=0;d"+f),n.print(" ")}n.print(" ")}n.print("
    "),n.print(""),n.print("")}n.close(),n.clear()},v.prototype.writeFile=function(e,t,r){var i="application/octet-stream";v.prototype._isSafari()&&(i="text/plain");var n=new Blob(e,{type:i});v.prototype.downloadFile(n,t,r)},v.prototype.downloadFile=function(e,t,r){var i=h(t,r),n=i[0];if(e instanceof Blob){s("file-saver").saveAs(e,n)}else{var o=document.createElement("a");if(o.href=e,o.download=n,o.onclick=function(e){var t;t=e,document.body.removeChild(t.target),e.stopPropagation()},o.style.display="none",document.body.appendChild(o),v.prototype._isSafari()){var a="Hello, Safari user! To download this file...\n";a+="1. Go to File --\x3e Save As.\n",a+='2. Choose "Page Source" as the Format.\n',a+='3. Name it with this extension: ."'+i[1]+'"',alert(a)}o.click()}},v.prototype._checkFileExtension=h,v.prototype._isSafari=function(){return 0>>0},getSeed:function(){return t},rand:function(){return(r=(1664525*r+1013904223)%i)/i}});n.setSeed(e),b=new Array(4096);for(var o=0;o<4096;o++)b[o]=n.rand()},t.exports=i},{"../core/main":23}],53:[function(e,t,r){"use strict";var s=e("../core/main"),o=e("../core/constants");s.Vector=function(){var e,t,r;r=arguments[0]instanceof s?(this.p5=arguments[0],e=arguments[1][0]||0,t=arguments[1][1]||0,arguments[1][2]||0):(e=arguments[0]||0,t=arguments[1]||0,arguments[2]||0),this.x=e,this.y=t,this.z=r},s.Vector.prototype.toString=function(){return"p5.Vector Object : ["+this.x+", "+this.y+", "+this.z+"]"},s.Vector.prototype.set=function(e,t,r){return e instanceof s.Vector?(this.x=e.x||0,this.y=e.y||0,this.z=e.z||0):e instanceof Array?(this.x=e[0]||0,this.y=e[1]||0,this.z=e[2]||0):(this.x=e||0,this.y=t||0,this.z=r||0),this},s.Vector.prototype.copy=function(){return this.p5?new s.Vector(this.p5,[this.x,this.y,this.z]):new s.Vector(this.x,this.y,this.z)},s.Vector.prototype.add=function(e,t,r){return e instanceof s.Vector?(this.x+=e.x||0,this.y+=e.y||0,this.z+=e.z||0):e instanceof Array?(this.x+=e[0]||0,this.y+=e[1]||0,this.z+=e[2]||0):(this.x+=e||0,this.y+=t||0,this.z+=r||0),this},s.Vector.prototype.sub=function(e,t,r){return e instanceof s.Vector?(this.x-=e.x||0,this.y-=e.y||0,this.z-=e.z||0):e instanceof Array?(this.x-=e[0]||0,this.y-=e[1]||0,this.z-=e[2]||0):(this.x-=e||0,this.y-=t||0,this.z-=r||0),this},s.Vector.prototype.mult=function(e){return"number"==typeof e&&isFinite(e)?(this.x*=e,this.y*=e,this.z*=e):console.warn("p5.Vector.prototype.mult:","n is undefined or not a finite number"),this},s.Vector.prototype.div=function(e){return"number"==typeof e&&isFinite(e)?0===e?console.warn("p5.Vector.prototype.div:","divide by 0"):(this.x/=e,this.y/=e,this.z/=e):console.warn("p5.Vector.prototype.div:","n is undefined or not a finite number"),this},s.Vector.prototype.mag=function(){return Math.sqrt(this.magSq())},s.Vector.prototype.magSq=function(){var e=this.x,t=this.y,r=this.z;return e*e+t*t+r*r},s.Vector.prototype.dot=function(e,t,r){return e instanceof s.Vector?this.dot(e.x,e.y,e.z):this.x*(e||0)+this.y*(t||0)+this.z*(r||0)},s.Vector.prototype.cross=function(e){var t=this.y*e.z-this.z*e.y,r=this.z*e.x-this.x*e.z,i=this.x*e.y-this.y*e.x;return this.p5?new s.Vector(this.p5,[t,r,i]):new s.Vector(t,r,i)},s.Vector.prototype.dist=function(e){return e.copy().sub(this).mag()},s.Vector.prototype.normalize=function(){var e=this.mag();return 0!==e&&this.mult(1/e),this},s.Vector.prototype.limit=function(e){var t=this.magSq();return e*e>>0},getSeed:function(){return i},rand:function(){return(n=(1664525*n+1013904223)%o)/o}});a.prototype.randomSeed=function(e){u.setSeed(e),h=!(s=!0)},a.prototype.random=function(e,t){var r;if(r=s?u.rand():Math.random(),void 0===e)return r;if(void 0===t)return e instanceof Array?e[Math.floor(r*e.length)]:r*e;if(tg){var R=p,L=h,P=l;p=c+g*(s&&c=t&&(r=r.substring(r.length-t,r.length)),r}},i.prototype.unhex=function(e){return e instanceof Array?e.map(i.prototype.unhex):parseInt("0x"+e,16)},t.exports=i},{"../core/main":23}],61:[function(e,t,r){"use strict";var a=e("../core/main");function i(e,t,r){var i=e<0,n=i?e.toString().substring(1):e.toString(),o=n.indexOf("."),a=-1!==o?n.substring(0,o):n,s=-1!==o?n.substring(o+1):"",h=i?"-":"";if(void 0!==r){var l="";(-1!==o||0r&&(s=s.substring(0,r));for(var u=0;ui.length)for(var o=t-(i+=-1===r?".":"").length+1,a=0;a=d.TWO_PI?(t="ellipse")+"|"+u+"|":(t="arc")+"|"+s+"|"+h+"|"+l+"|"+u+"|",!this.geometryInHash(r)){var c=new E.Geometry(u,1,function(){if(this.strokeIndices=[],s.toFixed(10)!==h.toFixed(10)){l!==d.PIE&&void 0!==l||(this.vertices.push(new E.Vector(.5,.5,0)),this.uvs.push([.5,.5]));for(var e=0;e<=u;e++){var t=e/u*(h-s)+s,r=.5+Math.cos(t)/2,i=.5+Math.sin(t)/2;this.vertices.push(new E.Vector(r,i,0)),this.uvs.push([r,i]),eMath.PI?h=Math.PI:h<=0&&(h=.001);var l=Math.sin(h)*a*Math.sin(s),u=Math.cos(h)*a,c=Math.sin(h)*a*Math.cos(s);this.camera(l+this.centerX,u+this.centerY,c+this.centerZ,this.centerX,this.centerY,this.centerZ,0,1,0)},m.Camera.prototype._isActive=function(){return this===this._renderer._curCamera},m.prototype.setCamera=function(e){this._renderer._curCamera=e,this._renderer.uPMatrix.set(e.projMatrix.mat4[0],e.projMatrix.mat4[1],e.projMatrix.mat4[2],e.projMatrix.mat4[3],e.projMatrix.mat4[4],e.projMatrix.mat4[5],e.projMatrix.mat4[6],e.projMatrix.mat4[7],e.projMatrix.mat4[8],e.projMatrix.mat4[9],e.projMatrix.mat4[10],e.projMatrix.mat4[11],e.projMatrix.mat4[12],e.projMatrix.mat4[13],e.projMatrix.mat4[14],e.projMatrix.mat4[15])},t.exports=m.Camera},{"../core/main":23}],69:[function(e,t,r){"use strict";var u=e("../core/main");u.Geometry=function(e,t,r){return this.vertices=[],this.lineVertices=[],this.lineNormals=[],this.vertexNormals=[],this.faces=[],this.uvs=[],this.edges=[],this.detailX=void 0!==e?e:1,this.detailY=void 0!==t?t:1,r instanceof Function&&r.call(this),this},u.Geometry.prototype.computeFaces=function(){this.faces.length=0;for(var e,t,r,i,n=this.detailX+1,o=0;othis.vertices.length-1-this.detailX;t--)e.add(this.vertexNormals[t]);for(e=u.Vector.div(e,this.detailX),t=this.vertices.length-1;t>this.vertices.length-1-this.detailX;t--)this.vertexNormals[t]=e;return this},u.Geometry.prototype._makeTriangleEdges=function(){if(this.edges.length=0,Array.isArray(this.strokeIndices))for(var e=0,t=this.strokeIndices.length;e>7,127&p,c>>7,127&c);for(var d=0;d>7,127&f,0,0)}}return{cellImageInfo:h,dimOffset:o,dimImageInfo:n}}return(t=this.glyphInfos[e.index]={glyph:e,uGlyphRect:[i.x1,-i.y1,i.x2,-i.y2],strokeImageInfo:A,strokes:d,colInfo:O(m,this.colDimImageInfos,this.colCellImageInfos),rowInfo:O(f,this.rowDimImageInfos,this.rowCellImageInfos)}).uGridOffset=[t.colInfo.dimOffset,t.rowInfo.dimOffset],t}};B.RendererGL.prototype._renderText=function(e,t,r,i,n){if(!(n<=i)&&this._doFill){if(!this._isOpenType())return console.log("WEBGL: only opentype fonts are supported"),e;e.push();var o=this._doStroke,a=this.drawMode;this._doStroke=!1,this.drawMode=M.TEXTURE;var s=this._textFont.font,h=this._textFont._fontInfo;h||(h=this._textFont._fontInfo=new E(s));var l=this._textFont._handleAlignment(this,t,r,i),u=this._textSize/s.unitsPerEm;this.translate(l.x,l.y,0),this.scale(u,u,1);var c=this.GL,p=!this._defaultFontShader,d=this._getFontShader();d.init(),p&&(d.setUniform("uGridImageSize",[64,64]),d.setUniform("uCellsImageSize",[64,64]),d.setUniform("uStrokeImageSize",[64,64]),d.setUniform("uGridSize",[9,9])),this._applyColorBlend(this.curFillColor);var f=this.gHash.glyph;if(!f){var m=this._textGeom=new B.Geometry(1,1,function(){for(var e=0;e<=1;e++)for(var t=0;t<=1;t++)this.vertices.push(new B.Vector(t,e,0)),this.uvs.push(t,e)});m.computeFaces().computeNormals(),f=this.createBuffers("glyph",m)}this._bindBuffer(f.vertexBuffer,c.ARRAY_BUFFER),d.enableAttrib(d.attributes.aPosition.location,3,c.FLOAT,!1,0,0),this._bindBuffer(f.indexBuffer,c.ELEMENT_ARRAY_BUFFER),this._bindBuffer(f.uvBuffer,c.ARRAY_BUFFER),d.enableAttrib(d.attributes.aTexCoord.location,2,c.FLOAT,!1,0,0),d.setUniform("uMaterialColor",this.curFillColor);try{for(var v=0,g=null,y=!1,b=s.stringToGlyphs(t),_=0;_= 0; i--){ + pew[i].display(pew, i); + + for (var j = rock.length - 1; j >= 0; j--) { + if (pew[i]) { + rock[j].getShot(pew[i], j); + } + } + + for (var j = alien.length - 1; j >= 0; j--) { + if (pew[i]) { + alien[j].getShot(pew[i], j); + } + } + } + + //show the rocks + for (var i = rock.length - 1; i >= 0; i--) { + ship.handleCollision(rock[i]); + rock[i].display(); + } + + //show the explosion + for (var z = dust.length - 1; z >= 0; z--) { + dust[z].display(ship); + } + + //send out alien ship + if (frameCount % 1250 === 0){ + alien.push(new Alien()); + } + + //show alien ship + for (var q = alien.length -1; q >= 0; q--){ + alien[q].main(q); + } + + //show alien pew + for (var b = alienPew.length - 1; b >= 0; b--) { + alienPew[b].display(alienPew, b, isAlienPew=true); + } + + //show power up + for (var u = powerup.length -1; u >= 0; u--){ + console.log(powerup[u].type) + if (powerup[u].type !== null) { + powerup[u].display(u); + } + } + + startNewLevel(); + } +} + +function startNewLevel(){ + if (rock.length === 0){ + + ship.pos.x = width/2; + ship.pos.y = height/2; + + dust = []; + alien = []; + alienPew = []; + powerup = []; + + level++; + + clear(); + background(22); + fill(255); + textSize(25); + text("Great Job", width/2, height/2 - 50); + text("Get Ready for Level " + level, width/2, height/2); + textSize(15); + text("Press Enter to Begin!", width/2, height/2+50); + + if (keyCode === 13){ + frameCount = 0; + clear(); + background(22); + amountOfRocks += 2; + generateRocks(); + + } + } +} + + + +//Controls +function keyPressed() { + if (keyCode === 77){ + if (song.isLooping()){ + song.pause(); + } else if (song.isPaused()) { + song.loop(); + } + } + + if (keyCode === 32){ + if (ship.powerup !== null){ + if (ship.powerup.type === 'triShot') { + pew.push(new Flame(ship.pos.x, ship.pos.y, p5.Vector.fromAngle(ship.angle + 0.2))); + pew.push(new Flame(ship.pos.x, ship.pos.y, p5.Vector.fromAngle(ship.angle))); + pew.push(new Flame(ship.pos.x, ship.pos.y, p5.Vector.fromAngle(ship.angle - 0.2))); + } + } else { + pew.push(new Flame(ship.pos.x, ship.pos.y, p5.Vector.fromAngle(ship.angle))); + } + } +} + +function startScreen() { + lives = []; + level = 0; + + if (points > 0){ + for (var a = dust.length - 1; a >= 0; a--){ + dust.pop(); + } + + for (var b = alien.length - 1; b >= 0; b--){ + alien.pop(); + } + + for (var c = rock.length - 1; c >= 0; c--){ + rock.pop(); + } + + for (var d = alienPew.length - 1; d >= 0; d--){ + alienPew.pop(); + } + + if (points > hiscore){ + hiscore = points; + } + } + + points = 0; + background(22); + fill(0,128,128); + textSize(15); + text('HI-SCORE', width/2, 20); + textSize(15); + fill(255); + text(hiscore, width/2, 35); + textSize(45); + text('Asteroids', width/2, height/5); + + fill(0,128,128); + textSize(30); + + var instructiontext = height/2 - 50; + + text('Instructions: ', width/2, instructiontext); + fill(255); + textSize(20); + + text('-L and R arrows rotate ship', width/2, instructiontext + 40); + text('-Up arrow engages boosters', width/2, instructiontext + 70); + text('-Space Bar shoots', width/2, instructiontext + 100); + text('-Down arrow activates power up', width/2, instructiontext + 130); + + textSize(35); + fill(255); + text('Press Enter to Begin!', width/2, height/1.2); + + var name = 'Dominic DiTaranto'; + + textSize(15); + fill(0,128,128); + text('Game and Music by ', width/2 + 150, height -20); + + if (int(dist(mouseX, mouseY, width-120, height-20)) <= 80){ + fill(0,128,0); + } else { + fill(128,0,0); + } + + text(name, width-120, height -20); + + amountOfRocks = 10; + generateRocks(); + + //show the rocks + for (var x = rock.length - 1; x >= 0; x--) { + rock[x].show(); + rock[x].update(); + rock[x].edges(); + } + + if (keyCode === 13){ + if (songPlayed === false){ + song.loop(); + songPlayed = true; + } + + for (var i = rock.length - 1; i >= 0; i--) { + rock.splice(i, 1); + } + + ship.lives = 4; + // level++; + amountOfRocks = -2; + + //setup lives + for (var n = 0; n <= ship.lives - 1; n++) { + lives.push(new Ship()); + } + + ship.dead = false; + startNewLevel(); + + } +} \ No newline at end of file diff --git a/utils.js b/utils.js new file mode 100644 index 0000000..0f39cbd --- /dev/null +++ b/utils.js @@ -0,0 +1,104 @@ +function displayPoints(points) { + textSize(25); + fill(255); + text(points, 60, 30); +} + +function displayLives (lives) { + for (var l = lives.length - 1; l >= 0; l--){ + lives[l].pos = createVector(25, 60); + lives[l].shield = false; + if (lives[l] !== lives[0]){ + lives[l].pos.x = lives[l-1].pos.x + 20; + } + lives[l].show(); + } +} + +function alertMusicMuteOption () { + textSize(15); + text(musicToggleText, width/2, height-50); + + setTimeout(function(){ + musicToggleText = ''; + }, 5000); +} + +function explode(x, y, size){ + for(var n = 0; n <= size; n++) { + dust.push(new Dust(x, y)); + setTimeout(function(){dust.shift(dust[n])}, 5000) + } +} + +//recursively find random position for rock to make sure it does not spawn on the ship +function randomRockPos(range, excludeLow, excludeHigh){ + this.randomPos = Math.floor(Math.random() * range); + if (this.randomPos < excludeLow || this.randomPos > excludeHigh){ + return this.randomPos; + } + return randomRockPos(range, excludeLow, excludeHigh); +} + +//create the rocks +function generateRocks(){ + for (var r = rock.length; r <= amountOfRocks; r++){ + rock.push(new Asteroid(randomRockPos(width, 400, 500), + randomRockPos(height, 250, 350), 'full')); + } +} + +//handle the points +function handlePoints(pointsGained){ + for (var p = 0; p <= pointsGained-1; p++){ + points++; + ship.lifelock = false; + if (points % 5000 === 0 && points !== 0){ + if (ship.lifelock === false){ + ship.lives++; + lives.push(new Ship()); + } + ship.lifelock = true; + } + } +} + +function displayPowerUpText() { + var powerupText = "Press down arrow to activate " + ship.powerup.type + "!"; + textSize(20); + fill(255); + + if (ship.powerup){ + text(powerupText, width/2, height/1.2); + } else { + clear(); + } +} + +//randomly select a powerup +function generatePowerup(a){ + return powerup.push(new Powerup(alien[a].pos.x, alien[a].pos.y)); +} + +//handle the power ups +function usePowerUp(){ + if (ship.powerup !== null){ + //trishot powerup + if (ship.powerup.type === 'triShot'){ + ship.powerup.typeMap[ship.powerup.type]['function'](); + } else { + displayPowerUpText(); + + if (keyCode === DOWN_ARROW){ + ship.powerup.typeMap[ship.powerup.type]['function'](); + ship.powerup = null; + } + } + } +} + +function mousePressed() { + if (int(dist(mouseX, mouseY, width-120, height-20)) <= 100){ + window.open('http://www.domdit.com'); + } +} \ No newline at end of file

    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̄zTC-&3?6M!YLw~xab3i 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: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�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Ξ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%0A1ocsxU&~gI4f+7yNTS~l0 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