@@ -0,0 +1,140 @@
1+<!DOCTYPE html> <html> <head> <title>flying-functions.js</title> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <link rel="stylesheet" media="all" href="docco.css" /> </head> <body> <div id="container"> <div id="background"></div> <table cellpadding="0" cellspacing="0"> <thead> <tr> <th class="docs"> <h1> flying-functions.js </h1> </th> <th class="code"> </th> …
2+<span class="p">(</span><span class="kd">function</span> <span class="p">()</span> <span class="p">{</span>
3+ <span class="s1">'use strict'</span><span class="p">;</span></pre></div> </td> </tr> <tr id="section-2"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-2">¶</a> </div> <p>remember: This is a study, hand build everything, no dependencies
4+ use all the latest and greatest that you can out of JS
5+ Good luck! :-)
6+ Optimistic Sean.</p> </td> <td class="code"> <div class="highlight"><pre></pre></div> </td> </tr> <tr id="section-3"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-3">¶</a> </div> <p>expected:
7+crud for the canvas
8+expose 2d api plus some helpers
9+event based, allow for plugins to listen to events, like frame drawn
10+plugin class
11+ an extendable prototype</p>
12+
13+<p>three.js friendlyness?</p>
14+
15+<p>How do I write tests?
16+ for now maybe just a test class...</p> </td> <td class="code"> <div class="highlight"><pre> <span class="kd">var</span> <span class="nx">FlyingFunctions</span><span class="p">,</span>
17+ <span class="nx">Events</span><span class="p">,</span>
18+ <span class="nx">Plugin</span><span class="p">,</span>
19+
20+ <span class="nx">slice</span> <span class="o">=</span> <span class="nb">Array</span><span class="p">.</span><span class="nx">prototype</span><span class="p">.</span><span class="nx">slice</span><span class="p">,</span>
21+ <span class="nx">animFrame</span><span class="p">;</span></pre></div> </td> </tr> <tr id="section-4"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-4">¶</a> </div> <p>mixer: [s]ource into [d]estination
22+careful, it will overwrite without shame.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="kd">function</span> <span class="nx">mix</span><span class="p">(</span><span class="nx">s</span><span class="p">,</span> <span class="nx">d</span><span class="p">)</span> <span class="p">{</span>
23+ <span class="kd">var</span> <span class="nx">keys</span> <span class="o">=</span> <span class="nb">Object</span><span class="p">.</span><span class="nx">keys</span><span class="p">(</span><span class="nx">s</span><span class="p">),</span>
24+ <span class="nx">key</span><span class="p">;</span>
25+ <span class="k">while</span> <span class="p">(</span><span class="nx">keys</span><span class="p">.</span><span class="nx">length</span><span class="p">)</span> <span class="p">{</span>
26+ <span class="nx">key</span> <span class="o">=</span> <span class="nx">keys</span><span class="p">.</span><span class="nx">shift</span><span class="p">();</span>
27+ <span class="nx">d</span><span class="p">[</span><span class="nx">key</span><span class="p">]</span> <span class="o">=</span> <span class="nx">s</span><span class="p">[</span><span class="nx">key</span><span class="p">];</span>
28+ <span class="p">}</span>
29+
30+ <span class="k">return</span> <span class="nx">d</span><span class="p">;</span>
31+ <span class="p">}</span></pre></div> </td> </tr> <tr id="section-5"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-5">¶</a> </div> <p>Opera engineer Erik Möller wrote about rAF and developed a polyfill that
32+better handles browsers without native support. You can read about it, but
33+basically his code will choose a delay of between 4ms and 16ms in order to
34+more closely match 60fps. Here it is, in case you’d like to use it. Note it
35+uses the standard method name. I have also fixed the cancel* method’s name,
36+as it has changed in WebKit.</p>
37+
38+<p>http://paulirish.com/2011/requestanimationframe-for-smart-animating/</p> </td> <td class="code"> <div class="highlight"><pre> <span class="p">(</span><span class="kd">function</span><span class="p">()</span> <span class="p">{</span>
39+ <span class="kd">var</span> <span class="nx">lastTime</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
40+ <span class="nx">vendors</span> <span class="o">=</span> <span class="p">[</span><span class="s1">'webkit'</span><span class="p">,</span> <span class="s1">'moz'</span><span class="p">],</span>
41+ <span class="nx">x</span><span class="p">;</span>
42+
43+ <span class="k">for</span><span class="p">(</span><span class="nx">x</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="nx">x</span> <span class="o"><</span> <span class="nx">vendors</span><span class="p">.</span><span class="nx">length</span> <span class="o">&&</span> <span class="o">!</span><span class="nb">window</span><span class="p">.</span><span class="nx">requestAnimationFrame</span><span class="p">;</span> <span class="o">++< …
44+ <span class="nb">window</span><span class="p">.</span><span class="nx">requestAnimationFrame</span> <span class="o">=</span> <span class="nb">window</span><span class="p">[</span><span class="nx">vendors</span><span class="p">[</span><span class="nx">x</span><span class="p">]</span><span class="o">+</span><span class="s1">'RequestAnimationFrame'</span><span class="p">];</span>
45+ <span class="nb">window</span><span class="p">.</span><span class="nx">cancelAnimationFrame</span> <span class="o">=</span> <span class="nb">window</span><span class="p">[</span><span class="nx">vendors</span><span class="p">[</span><span class="nx">x</span><span class="p">]</span><span class="o">+</span><span class="s1">'CancelAnimationFrame'</span><span class="p">]</span> <span class="o">||</span>
46+ <span class="nb">window</span><span class="p">[</span><span class="nx">vendors</span><span class="p">[</span><span class="nx">x</span><span class="p">]</span><span class="o">+</span><span class="s1">'CancelRequestAnimationFrame'</span><span class="p">];</span>
47+ <span class="p">}</span>
48+
49+ <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nb">window</span><span class="p">.</span><span class="nx">requestAnimationFrame</span><span class="p">)</span> <span class="p">{</span>
50+ <span class="nb">window</span><span class="p">.</span><span class="nx">requestAnimationFrame</span> <span class="o">=</span> <span class="kd">function</span><span class="p">(</span><span class="nx">callback</span><span class="p">,</span> <span class="nx">element</span><span class="p">)</span> <span class="p">{</span>
51+ <span class="kd">var</span> <span class="nx">currTime</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Date</span><span class="p">().</span><span class="nx">getTime</span><span class="p">(),</span>
52+ <span class="nx">timeToCall</span> <span class="o">=</span> <span class="nb">Math</span><span class="p">.</span><span class="nx">max</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="mi">16</span> <span class="o">-</span> <span class="p">(</span><span class="nx">currTime</span> <span class="o">-</span> <span class="nx">lastTime</span><span class="p">)),</span>
53+ <span class="nx">id</span> <span class="o">=</span> <span class="nb">window</span><span class="p">.</span><span class="nx">setTimeout</span><span class="p">(</span><span class="kd">function</span><span class="p">()</span> <span class="p">{</span> <span class="nx">callback</span><span class="p">(</span><span class="nx">currTime</span> <span class="o">+</span> <span class="nx">timeToCall</span><span class="p">);</span> <span class="p">},</span> <span class="nx">timeToCall</span …
54+ <span class="nx">lastTime</span> <span class="o">=</span> <span class="nx">currTime</span> <span class="o">+</span> <span class="nx">timeToCall</span><span class="p">;</span>
55+ <span class="k">return</span> <span class="nx">id</span><span class="p">;</span>
56+ <span class="p">};</span>
57+ <span class="p">}</span>
58+
59+ <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nb">window</span><span class="p">.</span><span class="nx">cancelAnimationFrame</span><span class="p">)</span> <span class="p">{</span>
60+ <span class="nb">window</span><span class="p">.</span><span class="nx">cancelAnimationFrame</span> <span class="o">=</span> <span class="kd">function</span><span class="p">(</span><span class="nx">id</span><span class="p">)</span> <span class="p">{</span>
61+ <span class="nx">clearTimeout</span><span class="p">(</span><span class="nx">id</span><span class="p">);</span>
62+ <span class="p">};</span>
63+ <span class="p">}</span>
64+ <span class="p">}());</span></pre></div> </td> </tr> <tr id="section-6"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-6">¶</a> </div> <p>https://github.com/jeromeetienne/microevent.js
65+simple events</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">Events</span> <span class="o">=</span> <span class="kd">function</span> <span class="p">(){</span></pre></div> </td> </tr> <tr id="section-7"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-7">¶</a> </div> <p>keep thi …
66+worry about calling this contructor.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="p">};</span>
67+
68+ <span class="nx">Events</span><span class="p">.</span><span class="nx">prototype</span> <span class="o">=</span> <span class="p">{</span></pre></div> </td> </tr> <tr id="section-8"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-8">¶</a> </div> <p>attach the event</p> </td> <td class="code"> <div class= …
69+ <span class="k">this</span><span class="p">.</span><span class="nx">events</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">events</span> <span class="o">||</span> <span class="p">{};</span>
70+ <span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">]</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">]</span> <span class="o">||</span> <span class="p">[];</span>
71+ <span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">].</span><span class="nx">push</span><span class="p">(</span><span class="nx">fn</span><span class="p">);</span></pre></div> </td> </tr> <tr id="section-9"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-9">¶</a> …
72+ <span class="p">},</span>
73+
74+ <span class="nx">off</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">ev</span><span class="p">,</span> <span class="nx">fn</span><span class="p">)</span> <span class="p">{</span>
75+ <span class="k">this</span><span class="p">.</span><span class="nx">events</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">events</span> <span class="o">||</span> <span class="p">{};</span>
76+ <span class="k">if</span> <span class="p">(</span><span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">]</span> <span class="o">===</span> <span class="kc">undefined</span><span class="p">)</span> <span class="p">{</span> <span class="k">return</span> <span class="k">this</span><span class="p">;</span> <span class="p">}</span>
77+ <span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">].</span><span class="nx">splice</span><span class="p">(</span><span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">].</span><span class="nx">indexOf</span><span class="p">(</span><span class="nx">fn</span><span class="p">),</span> <span class="mi …
78+ <span class="p">},</span>
79+
80+ <span class="nx">once</span><span class="o">:</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">ev</span><span class="p">,</span> <span class="nx">fn</span><span class="p">)</span> <span class="p">{</span>
81+ <span class="kd">var</span> <span class="nx">self</span> <span class="o">=</span> <span class="k">this</span><span class="p">;</span>
82+ <span class="k">this</span><span class="p">.</span><span class="nx">on</span><span class="p">(</span><span class="nx">ev</span><span class="p">,</span> <span class="kd">function</span> <span class="p">()</span> <span class="p">{</span>
83+ <span class="nx">fn</span><span class="p">.</span><span class="nx">apply</span><span class="p">(</span><span class="nx">self</span><span class="p">,</span> <span class="nx">arguments</span><span class="p">);</span>
84+ <span class="nx">self</span><span class="p">.</span><span class="nx">off</span><span class="p">(</span><span class="nx">ev</span><span class="p">,</span> <span class="nx">fn</span><span class="p">);</span>
85+ <span class="p">});</span></pre></div> </td> </tr> <tr id="section-11"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-11">¶</a> </div> <p>chainable</p> </td> <td class="code"> <div class="highlight"><pre> <span class="k">return</span> <span class="k">this</span><span class="p">;</spa …
86+ <span class="p">},</span></pre></div> </td> </tr> <tr id="section-12"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-12">¶</a> </div> <p>trigger an event and pass arguments to the handlers</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">trigger</span><span class="o" …
87+ <span class="k">this</span><span class="p">.</span><span class="nx">events</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">events</span> <span class="o">||</span> <span class="p">{};</span>
88+ <span class="k">if</span> <span class="p">(</span><span class="k">this</span><span class="p">.</span><span class="nx">events</span> <span class="o">&&</span> <span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">]</span> <span class="o">===</span> <span class="kc">undefined</span><span class="p">)</span> <span class="p">{</span> <span class="k">return</span> <span class="k">this</span …
89+ <span class="kd">var</span> <span class="nx">handlers</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">events</span><span class="p">[</span><span class="nx">ev</span><span class="p">],</span>
90+ <span class="nx">len</span> <span class="o">=</span> <span class="nx">handlers</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span>
91+ <span class="k">while</span> <span class="p">(</span><span class="nx">len</span><span class="p">)</span> <span class="p">{</span>
92+ <span class="nx">len</span> <span class="o">-=</span> <span class="mi">1</span><span class="p">;</span>
93+ <span class="nx">handlers</span><span class="p">[</span><span class="nx">len</span><span class="p">].</span><span class="nx">apply</span><span class="p">(</span><span class="k">this</span><span class="p">,</span> <span class="nx">slice</span><span class="p">.</span><span class="nx">call</span><span class="p">(</span><span class="nx">arguments</span><span class="p">,</span> <span class="mi">1</span><span class="p">));</span>
94+ <span class="p">}</span></pre></div> </td> </tr> <tr id="section-13"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-13">¶</a> </div> <p>chainable</p> </td> <td class="code"> <div class="highlight"><pre> <span class="k">return</span> <span class="k">this</span><span class="p">;</span>
95+ <span class="p">},</span>
96+ <span class="p">};</span></pre></div> </td> </tr> <tr id="section-14"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-14">¶</a> </div> <h2>Flying functions engine</h2>
97+
98+<p>Usage: <code>new FlyingFunctions({ option: value, ... });</code></p>
99+
100+<p>options:
101+ + fps = an integer between 1 and 60
102+ + canvas = the convas html element
103+ + c = the drawing context
104+ + container = the container to which append the canvas</p> </td> <td class="code"> <div class="highlight"><pre> <span class="nx">FlyingFunctions</span> <span class="o">=</span> <span class="kd">function</span> <span class="p">(</span><span class="nx">opts</span><span class="p">)</span> <span class="p">{</span>
105+ <span class="nx">opts</span> <span class="o">=</span> <span class="nx">opts</span> <span class="o">||</span> <span class="p">{};</span></pre></div> </td> </tr> <tr id="section-15"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-15">¶</a> </div> <p>defaults, mark them on the opts obj that gets passed to the
106+<code>init</code> event.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="k">this</span><span class="p">.</span><span class="nx">fps</span> <span class="o">=</span> <span class="nx">opts</span><span class="p">.</span><span class="nx">fps</span> <span class="o">||</span> <span class="mi">60</span><span class="p">;</span>
107+ <span class="k">this</span><span class="p">.</span><span class="nx">container</span> <span class="o">=</span> <span class="nx">opts</span><span class="p">.</span><span class="nx">container</span> <span class="o">||</span> <span class="nb">document</span><span class="p">.</span><span class="nx">querySelector</span><span class="p">(</span><span class="s1">'body'</span><span class="p">);</span></pre></div> </td> </tr> <tr id="secti …
108+ <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="k">this</span><span class="p">.</span><span class="nx">canvas</span><span class="p">)</span> <span class="p">{</span>
109+ <span class="k">this</span><span class="p">.</span><span class="nx">canvas</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nx">createElement</span><span class="p">(</span><span class="s1">'canvas'</span><span class="p">);</span>
110+ <span class="k">this</span><span class="p">.</span><span class="nx">c</span> <span class="o">=</span> <span class="k">this</span><span class="p">.</span><span class="nx">canvas</span><span class="p">.</span><span class="nx">getContext</span><span class="p">(</span><span class="s1">'2d'</span><span class="p">);</span>
111+ <span class="p">}</span>
112+
113+ <span class="k">this</span><span class="p">.</span><span class="nx">c</span> <span class="o">=</span> <span class="nx">opts</span><span class="p">.</span><span class="nx">c</span> <span class="o">||</span> <span class="k">this</span><span class="p">.</span><span class="nx">canvas</span><span class="p">.</span><span class="nx">getContext</span><span class="p">(</span><span class="s1">'2d'</span><span class="p">);</span></pre></div> </td> </tr> …
114+ <span class="k">this</span><span class="p">.</span><span class="nx">canvas</span><span class="p">.</span><span class="nx">width</span> <span class="o">=</span> <span class="nx">opts</span><span class="p">.</span><span class="nx">width</span> <span class="o">||</span> <span class="k">this</span><span class="p">.</span><span class="nx">container</span><span class="p">.</span><span class="nx">innerWidth</span><span class="p">;</span>
115+ <span class="k">this</span><span class="p">.</span><span class="nx">canvas</span><span class="p">.</span><span class="nx">height</span> <span class="o">=</span> <span class="nx">opts</span><span class="p">.</span><span class="nx">height</span> <span class="o">||</span> <span class="k">this</span><span class="p">.</span><span class="nx">container</span><span class="p">.</span><span class="nx">innerHeight</span><span class="p">;</span></pre></div> </td> </tr> …
116+ <span class="nx">opts</span><span class="p">.</span><span class="nx">init</span><span class="p">.</span><span class="nx">call</span><span class="p">(</span><span class="k">this</span><span class="p">,</span> <span class="nx">opts</span><span class="p">);</span>
117+ <span class="p">}</span></pre></div> </td> </tr> <tr id="section-19"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-19">¶</a> </div> <p>loop needs to be bound.</p> </td> <td class="code"> <div class="highlight"><pre> <span class="k">this</span><span class="p">.</span><span class="nx">loop</s …
118+
119+ <span class="k">return</span> <span class="k">this</span><span class="p">;</span>
120+ <span class="p">};</span>
121+
122+ <span class="nx">FlyingFunctions</span><span class="p">.</span><span class="nx">prototype</span> <span class="o">=</span> <span class="nx">mix</span><span class="p">(</span><span class="nx">Events</span><span class="p">.</span><span class="nx">prototype</span><span class="p">,</span> <span class="p">{</span>
123+ <span class="nx">Plugin</span><span class="o">:</span> <span class="nx">Plugin</span><span class="p">,</span>
124+
125+ <span class="nx">loop</span><span class="o">:</span> <span class="kd">function</span> <span class="p">()</span> <span class="p">{</span>
126+ <span class="kd">var</span> <span class="nx">self</span> <span class="o">=</span> <span class="k">this</span><span class="p">;</span>
127+
128+ <span class="nx">setTimeout</span><span class="p">(</span><span class="kd">function</span> <span class="p">()</span> <span class="p">{</span>
129+ <span class="nb">window</span><span class="p">.</span><span class="nx">requestAnimationFrame</span><span class="p">(</span><span class="nx">self</span><span class="p">.</span><span class="nx">loop</span><span class="p">);</span></pre></div> </td> </tr> <tr id="section-20"> <td class="docs"> <div class="pilwrap"> <a class="pilcrow" href="#section-20">¶</a> </div> …
130+
131+ <span class="p">},</span> <span class="mi">1000</span> <span class="o">/</span> <span class="k">this</span><span class="p">.</span><span class="nx">fps</span><span class="p">);</span>
132+
133+ <span class="k">return</span> <span class="k">this</span><span class="p">;</span>
134+ <span class="p">}</span>
135+ <span class="p">});</span>
136+
137+ <span class="nb">window</span><span class="p">.</span><span class="nx">FlyingFunctions</span> <span class="o">=</span> <span class="nx">FlyingFunctions</span><span class="p">;</span>
138+<span class="p">}());</span>
139+
140+</pre></div> </td> </tr> </tbody> </table> </div> </body> </html>