Tween.js 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793
  1. /**
  2. @license
  3. tween.js - https://github.com/sole/tween.js
  4. Copyright (c) 2010-2012 Tween.js authors.
  5. Easing equations Copyright (c) 2001 Robert Penner http://robertpenner.com/easing/
  6. Permission is hereby granted, free of charge, to any person obtaining a copy
  7. of this software and associated documentation files (the "Software"), to deal
  8. in the Software without restriction, including without limitation the rights
  9. to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10. copies of the Software, and to permit persons to whom the Software is
  11. furnished to do so, subject to the following conditions:
  12. The above copyright notice and this permission notice shall be included in
  13. all copies or substantial portions of the Software.
  14. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20. THE SOFTWARE.
  21. */
  22. /**
  23. * @author sole / http://soledadpenades.com
  24. * @author mrdoob / http://mrdoob.com
  25. * @author Robert Eisele / http://www.xarg.org
  26. * @author Philippe / http://philippe.elsass.me
  27. * @author Robert Penner / http://www.robertpenner.com/easing_terms_of_use.html
  28. * @author Paul Lewis / http://www.aerotwist.com/
  29. * @author lechecacharro
  30. * @author Josh Faul / http://jocafa.com/
  31. * @author egraether / http://egraether.com/
  32. * @author endel / http://endel.me
  33. * @author Ben Delarre / http://delarre.net
  34. */
  35. /*global define*/
  36. define(function() {
  37. // Date.now shim for (ahem) Internet Explo(d|r)er
  38. if ( Date.now === undefined ) {
  39. Date.now = function () {
  40. return new Date().valueOf();
  41. };
  42. }
  43. var TWEEN = TWEEN || ( function () {
  44. var _tweens = [];
  45. return {
  46. REVISION: '13',
  47. getAll: function () {
  48. return _tweens;
  49. },
  50. removeAll: function () {
  51. _tweens = [];
  52. },
  53. add: function ( tween ) {
  54. _tweens.push( tween );
  55. },
  56. remove: function ( tween ) {
  57. var i = _tweens.indexOf( tween );
  58. if ( i !== -1 ) {
  59. _tweens.splice( i, 1 );
  60. }
  61. },
  62. update: function ( time ) {
  63. if ( _tweens.length === 0 ) return false;
  64. var i = 0;
  65. time = time !== undefined ? time : ( typeof window !== 'undefined' && window.performance !== undefined && window.performance.now !== undefined ? window.performance.now() : Date.now() );
  66. while ( i < _tweens.length ) {
  67. if ( _tweens[ i ].update( time ) ) {
  68. i++;
  69. } else {
  70. _tweens.splice( i, 1 );
  71. }
  72. }
  73. return true;
  74. }
  75. };
  76. } )();
  77. TWEEN.Tween = function ( object ) {
  78. var _object = object;
  79. var _valuesStart = {};
  80. var _valuesEnd = {};
  81. var _valuesStartRepeat = {};
  82. var _duration = 1000;
  83. var _repeat = 0;
  84. var _yoyo = false;
  85. var _isPlaying = false;
  86. var _reversed = false;
  87. var _delayTime = 0;
  88. var _startTime = null;
  89. var _easingFunction = TWEEN.Easing.Linear.None;
  90. var _interpolationFunction = TWEEN.Interpolation.Linear;
  91. var _chainedTweens = [];
  92. var _onStartCallback = null;
  93. var _onStartCallbackFired = false;
  94. var _onUpdateCallback = null;
  95. var _onCompleteCallback = null;
  96. var _onStopCallback = null;
  97. // Set all starting values present on the target object
  98. for ( var field in object ) {
  99. _valuesStart[ field ] = parseFloat(object[field], 10);
  100. }
  101. this.to = function ( properties, duration ) {
  102. if ( duration !== undefined ) {
  103. _duration = duration;
  104. }
  105. _valuesEnd = properties;
  106. return this;
  107. };
  108. this.start = function ( time ) {
  109. TWEEN.add( this );
  110. _isPlaying = true;
  111. _onStartCallbackFired = false;
  112. _startTime = time !== undefined ? time : ( typeof window !== 'undefined' && window.performance !== undefined && window.performance.now !== undefined ? window.performance.now() : Date.now() );
  113. _startTime += _delayTime;
  114. for ( var property in _valuesEnd ) {
  115. // check if an Array was provided as property value
  116. if ( _valuesEnd[ property ] instanceof Array ) {
  117. if ( _valuesEnd[ property ].length === 0 ) {
  118. continue;
  119. }
  120. // create a local copy of the Array with the start value at the front
  121. _valuesEnd[ property ] = [ _object[ property ] ].concat( _valuesEnd[ property ] );
  122. }
  123. _valuesStart[ property ] = _object[ property ];
  124. if( ( _valuesStart[ property ] instanceof Array ) === false ) {
  125. _valuesStart[ property ] *= 1.0; // Ensures we're using numbers, not strings
  126. }
  127. _valuesStartRepeat[ property ] = _valuesStart[ property ] || 0;
  128. }
  129. return this;
  130. };
  131. this.stop = function () {
  132. if ( !_isPlaying ) {
  133. return this;
  134. }
  135. TWEEN.remove( this );
  136. _isPlaying = false;
  137. if ( _onStopCallback !== null ) {
  138. _onStopCallback.call( _object );
  139. }
  140. this.stopChainedTweens();
  141. return this;
  142. };
  143. this.stopChainedTweens = function () {
  144. for ( var i = 0, numChainedTweens = _chainedTweens.length; i < numChainedTweens; i++ ) {
  145. _chainedTweens[ i ].stop();
  146. }
  147. };
  148. this.delay = function ( amount ) {
  149. _delayTime = amount;
  150. return this;
  151. };
  152. this.repeat = function ( times ) {
  153. _repeat = times;
  154. return this;
  155. };
  156. this.yoyo = function( yoyo ) {
  157. _yoyo = yoyo;
  158. return this;
  159. };
  160. this.easing = function ( easing ) {
  161. _easingFunction = easing;
  162. return this;
  163. };
  164. this.interpolation = function ( interpolation ) {
  165. _interpolationFunction = interpolation;
  166. return this;
  167. };
  168. this.chain = function () {
  169. _chainedTweens = arguments;
  170. return this;
  171. };
  172. this.onStart = function ( callback ) {
  173. _onStartCallback = callback;
  174. return this;
  175. };
  176. this.onUpdate = function ( callback ) {
  177. _onUpdateCallback = callback;
  178. return this;
  179. };
  180. this.onComplete = function ( callback ) {
  181. _onCompleteCallback = callback;
  182. return this;
  183. };
  184. this.onStop = function ( callback ) {
  185. _onStopCallback = callback;
  186. return this;
  187. };
  188. this.update = function ( time ) {
  189. var property;
  190. if ( time < _startTime ) {
  191. return true;
  192. }
  193. if ( _onStartCallbackFired === false ) {
  194. if ( _onStartCallback !== null ) {
  195. _onStartCallback.call( _object );
  196. }
  197. _onStartCallbackFired = true;
  198. }
  199. var elapsed = ( time - _startTime ) / _duration;
  200. elapsed = elapsed > 1 ? 1 : elapsed;
  201. var value = _easingFunction( elapsed );
  202. for ( property in _valuesEnd ) {
  203. var start = _valuesStart[ property ] || 0;
  204. var end = _valuesEnd[ property ];
  205. if ( end instanceof Array ) {
  206. _object[ property ] = _interpolationFunction( end, value );
  207. } else {
  208. // Parses relative end values with start as base (e.g.: +10, -3)
  209. if ( typeof(end) === "string" ) {
  210. end = start + parseFloat(end, 10);
  211. }
  212. // protect against non numeric properties.
  213. if ( typeof(end) === "number" ) {
  214. _object[ property ] = start + ( end - start ) * value;
  215. }
  216. }
  217. }
  218. if ( _onUpdateCallback !== null ) {
  219. _onUpdateCallback.call( _object, value );
  220. }
  221. if ( elapsed == 1 ) {
  222. if ( _repeat > 0 ) {
  223. if( isFinite( _repeat ) ) {
  224. _repeat--;
  225. }
  226. // reassign starting values, restart by making startTime = now
  227. for( property in _valuesStartRepeat ) {
  228. if ( typeof( _valuesEnd[ property ] ) === "string" ) {
  229. _valuesStartRepeat[ property ] = _valuesStartRepeat[ property ] + parseFloat(_valuesEnd[ property ], 10);
  230. }
  231. if (_yoyo) {
  232. var tmp = _valuesStartRepeat[ property ];
  233. _valuesStartRepeat[ property ] = _valuesEnd[ property ];
  234. _valuesEnd[ property ] = tmp;
  235. }
  236. _valuesStart[ property ] = _valuesStartRepeat[ property ];
  237. }
  238. if (_yoyo) {
  239. _reversed = !_reversed;
  240. }
  241. _startTime = time + _delayTime;
  242. return true;
  243. } else {
  244. if ( _onCompleteCallback !== null ) {
  245. _onCompleteCallback.call( _object );
  246. }
  247. for ( var i = 0, numChainedTweens = _chainedTweens.length; i < numChainedTweens; i++ ) {
  248. _chainedTweens[ i ].start( time );
  249. }
  250. return false;
  251. }
  252. }
  253. return true;
  254. };
  255. };
  256. TWEEN.Easing = {
  257. Linear: {
  258. None: function ( k ) {
  259. return k;
  260. }
  261. },
  262. Quadratic: {
  263. In: function ( k ) {
  264. return k * k;
  265. },
  266. Out: function ( k ) {
  267. return k * ( 2 - k );
  268. },
  269. InOut: function ( k ) {
  270. if ( ( k *= 2 ) < 1 ) return 0.5 * k * k;
  271. return - 0.5 * ( --k * ( k - 2 ) - 1 );
  272. }
  273. },
  274. Cubic: {
  275. In: function ( k ) {
  276. return k * k * k;
  277. },
  278. Out: function ( k ) {
  279. return --k * k * k + 1;
  280. },
  281. InOut: function ( k ) {
  282. if ( ( k *= 2 ) < 1 ) return 0.5 * k * k * k;
  283. return 0.5 * ( ( k -= 2 ) * k * k + 2 );
  284. }
  285. },
  286. Quartic: {
  287. In: function ( k ) {
  288. return k * k * k * k;
  289. },
  290. Out: function ( k ) {
  291. return 1 - ( --k * k * k * k );
  292. },
  293. InOut: function ( k ) {
  294. if ( ( k *= 2 ) < 1) return 0.5 * k * k * k * k;
  295. return - 0.5 * ( ( k -= 2 ) * k * k * k - 2 );
  296. }
  297. },
  298. Quintic: {
  299. In: function ( k ) {
  300. return k * k * k * k * k;
  301. },
  302. Out: function ( k ) {
  303. return --k * k * k * k * k + 1;
  304. },
  305. InOut: function ( k ) {
  306. if ( ( k *= 2 ) < 1 ) return 0.5 * k * k * k * k * k;
  307. return 0.5 * ( ( k -= 2 ) * k * k * k * k + 2 );
  308. }
  309. },
  310. Sinusoidal: {
  311. In: function ( k ) {
  312. return 1 - Math.cos( k * Math.PI / 2 );
  313. },
  314. Out: function ( k ) {
  315. return Math.sin( k * Math.PI / 2 );
  316. },
  317. InOut: function ( k ) {
  318. return 0.5 * ( 1 - Math.cos( Math.PI * k ) );
  319. }
  320. },
  321. Exponential: {
  322. In: function ( k ) {
  323. return k === 0 ? 0 : Math.pow( 1024, k - 1 );
  324. },
  325. Out: function ( k ) {
  326. return k === 1 ? 1 : 1 - Math.pow( 2, - 10 * k );
  327. },
  328. InOut: function ( k ) {
  329. if ( k === 0 ) return 0;
  330. if ( k === 1 ) return 1;
  331. if ( ( k *= 2 ) < 1 ) return 0.5 * Math.pow( 1024, k - 1 );
  332. return 0.5 * ( - Math.pow( 2, - 10 * ( k - 1 ) ) + 2 );
  333. }
  334. },
  335. Circular: {
  336. In: function ( k ) {
  337. return 1 - Math.sqrt( 1 - k * k );
  338. },
  339. Out: function ( k ) {
  340. return Math.sqrt( 1 - ( --k * k ) );
  341. },
  342. InOut: function ( k ) {
  343. if ( ( k *= 2 ) < 1) return - 0.5 * ( Math.sqrt( 1 - k * k) - 1);
  344. return 0.5 * ( Math.sqrt( 1 - ( k -= 2) * k) + 1);
  345. }
  346. },
  347. Elastic: {
  348. In: function ( k ) {
  349. var s, a = 0.1, p = 0.4;
  350. if ( k === 0 ) return 0;
  351. if ( k === 1 ) return 1;
  352. if ( !a || a < 1 ) { a = 1; s = p / 4; }
  353. else s = p * Math.asin( 1 / a ) / ( 2 * Math.PI );
  354. return - ( a * Math.pow( 2, 10 * ( k -= 1 ) ) * Math.sin( ( k - s ) * ( 2 * Math.PI ) / p ) );
  355. },
  356. Out: function ( k ) {
  357. var s, a = 0.1, p = 0.4;
  358. if ( k === 0 ) return 0;
  359. if ( k === 1 ) return 1;
  360. if ( !a || a < 1 ) { a = 1; s = p / 4; }
  361. else s = p * Math.asin( 1 / a ) / ( 2 * Math.PI );
  362. return ( a * Math.pow( 2, - 10 * k) * Math.sin( ( k - s ) * ( 2 * Math.PI ) / p ) + 1 );
  363. },
  364. InOut: function ( k ) {
  365. var s, a = 0.1, p = 0.4;
  366. if ( k === 0 ) return 0;
  367. if ( k === 1 ) return 1;
  368. if ( !a || a < 1 ) { a = 1; s = p / 4; }
  369. else s = p * Math.asin( 1 / a ) / ( 2 * Math.PI );
  370. if ( ( k *= 2 ) < 1 ) return - 0.5 * ( a * Math.pow( 2, 10 * ( k -= 1 ) ) * Math.sin( ( k - s ) * ( 2 * Math.PI ) / p ) );
  371. return a * Math.pow( 2, -10 * ( k -= 1 ) ) * Math.sin( ( k - s ) * ( 2 * Math.PI ) / p ) * 0.5 + 1;
  372. }
  373. },
  374. Back: {
  375. In: function ( k ) {
  376. var s = 1.70158;
  377. return k * k * ( ( s + 1 ) * k - s );
  378. },
  379. Out: function ( k ) {
  380. var s = 1.70158;
  381. return --k * k * ( ( s + 1 ) * k + s ) + 1;
  382. },
  383. InOut: function ( k ) {
  384. var s = 1.70158 * 1.525;
  385. if ( ( k *= 2 ) < 1 ) return 0.5 * ( k * k * ( ( s + 1 ) * k - s ) );
  386. return 0.5 * ( ( k -= 2 ) * k * ( ( s + 1 ) * k + s ) + 2 );
  387. }
  388. },
  389. Bounce: {
  390. In: function ( k ) {
  391. return 1 - TWEEN.Easing.Bounce.Out( 1 - k );
  392. },
  393. Out: function ( k ) {
  394. if ( k < ( 1 / 2.75 ) ) {
  395. return 7.5625 * k * k;
  396. } else if ( k < ( 2 / 2.75 ) ) {
  397. return 7.5625 * ( k -= ( 1.5 / 2.75 ) ) * k + 0.75;
  398. } else if ( k < ( 2.5 / 2.75 ) ) {
  399. return 7.5625 * ( k -= ( 2.25 / 2.75 ) ) * k + 0.9375;
  400. } else {
  401. return 7.5625 * ( k -= ( 2.625 / 2.75 ) ) * k + 0.984375;
  402. }
  403. },
  404. InOut: function ( k ) {
  405. if ( k < 0.5 ) return TWEEN.Easing.Bounce.In( k * 2 ) * 0.5;
  406. return TWEEN.Easing.Bounce.Out( k * 2 - 1 ) * 0.5 + 0.5;
  407. }
  408. }
  409. };
  410. TWEEN.Interpolation = {
  411. Linear: function ( v, k ) {
  412. var m = v.length - 1, f = m * k, i = Math.floor( f ), fn = TWEEN.Interpolation.Utils.Linear;
  413. if ( k < 0 ) return fn( v[ 0 ], v[ 1 ], f );
  414. if ( k > 1 ) return fn( v[ m ], v[ m - 1 ], m - f );
  415. return fn( v[ i ], v[ i + 1 > m ? m : i + 1 ], f - i );
  416. },
  417. Bezier: function ( v, k ) {
  418. var b = 0, n = v.length - 1, pw = Math.pow, bn = TWEEN.Interpolation.Utils.Bernstein, i;
  419. for ( i = 0; i <= n; i++ ) {
  420. b += pw( 1 - k, n - i ) * pw( k, i ) * v[ i ] * bn( n, i );
  421. }
  422. return b;
  423. },
  424. CatmullRom: function ( v, k ) {
  425. var m = v.length - 1, f = m * k, i = Math.floor( f ), fn = TWEEN.Interpolation.Utils.CatmullRom;
  426. if ( v[ 0 ] === v[ m ] ) {
  427. if ( k < 0 ) i = Math.floor( f = m * ( 1 + k ) );
  428. return fn( v[ ( i - 1 + m ) % m ], v[ i ], v[ ( i + 1 ) % m ], v[ ( i + 2 ) % m ], f - i );
  429. } else {
  430. if ( k < 0 ) return v[ 0 ] - ( fn( v[ 0 ], v[ 0 ], v[ 1 ], v[ 1 ], -f ) - v[ 0 ] );
  431. if ( k > 1 ) return v[ m ] - ( fn( v[ m ], v[ m ], v[ m - 1 ], v[ m - 1 ], f - m ) - v[ m ] );
  432. return fn( v[ i ? i - 1 : 0 ], v[ i ], v[ m < i + 1 ? m : i + 1 ], v[ m < i + 2 ? m : i + 2 ], f - i );
  433. }
  434. },
  435. Utils: {
  436. Linear: function ( p0, p1, t ) {
  437. return ( p1 - p0 ) * t + p0;
  438. },
  439. Bernstein: function ( n , i ) {
  440. var fc = TWEEN.Interpolation.Utils.Factorial;
  441. return fc( n ) / fc( i ) / fc( n - i );
  442. },
  443. Factorial: ( function () {
  444. var a = [ 1 ];
  445. return function ( n ) {
  446. var s = 1, i;
  447. if ( a[ n ] ) return a[ n ];
  448. for ( i = n; i > 1; i-- ) s *= i;
  449. return a[ n ] = s;
  450. };
  451. } )(),
  452. CatmullRom: function ( p0, p1, p2, p3, t ) {
  453. var v0 = ( p2 - p0 ) * 0.5, v1 = ( p3 - p1 ) * 0.5, t2 = t * t, t3 = t * t2;
  454. return ( 2 * p1 - 2 * p2 + v0 + v1 ) * t3 + ( - 3 * p1 + 3 * p2 - 2 * v0 - v1 ) * t2 + v0 * t + p1;
  455. }
  456. }
  457. };
  458. return TWEEN;
  459. });