POP Display

. - * - * @method addClass - * @param {string} className name of class to add - */ - Surface.prototype.addClass = function addClass(className) { - if (this.classList.indexOf(className) < 0) { - this.classList.push(className); - this._classesDirty = true; - } - }; - - /** - * Remove CSS-style class from the list of classes on this Surface. - * Note this will map directly to the HTML property of the actual - * corresponding rendered

. - * - * @method removeClass - * @param {string} className name of class to remove - */ - Surface.prototype.removeClass = function removeClass(className) { - var i = this.classList.indexOf(className); - if (i >= 0) { - this._dirtyClasses.push(this.classList.splice(i, 1)[0]); - this._classesDirty = true; - } - }; - - /** - * Reset class list to provided dictionary. - * @method setClasses - * @param {Array.string} classList - */ - Surface.prototype.setClasses = function setClasses(classList) { - var i = 0; - var removal = []; - for (i = 0; i < this.classList.length; i++) { - if (classList.indexOf(this.classList[i]) < 0) removal.push(this.classList[i]); - } - for (i = 0; i < removal.length; i++) this.removeClass(removal[i]); - // duplicates are already checked by addClass() - for (i = 0; i < classList.length; i++) this.addClass(classList[i]); - }; - - /** - * Get array of CSS-style classes attached to this div. - * - * @method getClasslist - * @return {Array.string} array of class names - */ - Surface.prototype.getClassList = function getClassList() { - return this.classList; - }; - - /** - * Set or overwrite inner (HTML) content of this surface. Note that this - * causes a re-rendering if the content has changed. - * - * @method setContent - * @param {string|Document Fragment} content HTML content - */ - Surface.prototype.setContent = function setContent(content) { - if (this.content !== content) { - this.content = content; - this._contentDirty = true; - } - }; - - /** - * Return inner (HTML) content of this surface. - * - * @method getContent - * - * @return {string} inner (HTML) content - */ - Surface.prototype.getContent = function getContent() { - return this.content; - }; - - /** - * Set options for this surface - * - * @method setOptions - * @param {Object} [options] overrides for default options. See constructor. - */ - Surface.prototype.setOptions = function setOptions(options) { - if (options.size) this.setSize(options.size); - if (options.classes) this.setClasses(options.classes); - if (options.properties) this.setProperties(options.properties); - if (options.content) this.setContent(options.content); - }; - - // Attach Famous event handling to document events emanating from target - // document element. This occurs just after deployment to the document. - // Calling this enables methods like #on and #pipe. - function _addEventListeners(target) { - for (var i in this.eventHandler.listeners) { - target.addEventListener(i, this.eventForwarder); - } - } - - // Detach Famous event handling from document events emanating from target - // document element. This occurs just before recall from the document. - function _removeEventListeners(target) { - for (var i in this.eventHandler.listeners) { - target.removeEventListener(i, this.eventForwarder); - } - } - - // Apply to document all changes from removeClass() since last setup(). - function _cleanupClasses(target) { - for (var i = 0; i < this._dirtyClasses.length; i++) target.classList.remove(this._dirtyClasses[i]); - this._dirtyClasses = []; - } - - // Apply values of all Famous-managed styles to the document element. - // These will be deployed to the document on call to #setup(). - function _applyStyles(target) { - for (var n in this.properties) { - target.style[n] = this.properties[n]; - } - } - - // Clear all Famous-managed styles from the document element. - // These will be deployed to the document on call to #setup(). - function _cleanupStyles(target) { - for (var n in this.properties) { - target.style[n] = ''; - } - } - - /** - * Return a Matrix's webkit css representation to be used with the - * CSS3 -webkit-transform style. - * Example: -webkit-transform: matrix3d(1,0,0,0,0,1,0,0,0,0,1,0,716,243,0,1) - * - * @method _formatCSSTransform - * @private - * @param {FamousMatrix} m matrix - * @return {string} matrix3d CSS style representation of the transform - */ - function _formatCSSTransform(m) { - m[12] = Math.round(m[12] * devicePixelRatio) / devicePixelRatio; - m[13] = Math.round(m[13] * devicePixelRatio) / devicePixelRatio; - - var result = 'matrix3d('; - for (var i = 0; i < 15; i++) { - result += (m[i] < 0.000001 && m[i] > -0.000001) ? '0,' : m[i] + ','; - } - result += m[15] + ')'; - return result; - } - - /** - * Directly apply given FamousMatrix to the document element as the - * appropriate webkit CSS style. - * - * @method setMatrix - * - * @static - * @private - * @param {Element} element document element - * @param {FamousMatrix} matrix - */ - - var _setMatrix; - if (navigator.userAgent.toLowerCase().indexOf('firefox') > -1) { - _setMatrix = function(element, matrix) { - element.style.zIndex = (matrix[14] * 1000000) | 0; // fix for Firefox z-buffer issues - element.style.transform = _formatCSSTransform(matrix); - }; - } - else if (usePrefix) { - _setMatrix = function(element, matrix) { - element.style.webkitTransform = _formatCSSTransform(matrix); - }; - } - else { - _setMatrix = function(element, matrix) { - element.style.transform = _formatCSSTransform(matrix); - }; - } - - // format origin as CSS percentage string - function _formatCSSOrigin(origin) { - return (100 * origin[0]) + '% ' + (100 * origin[1]) + '%'; - } - - // Directly apply given origin coordinates to the document element as the - // appropriate webkit CSS style. - var _setOrigin = usePrefix ? function(element, origin) { - element.style.webkitTransformOrigin = _formatCSSOrigin(origin); - } : function(element, origin) { - element.style.transformOrigin = _formatCSSOrigin(origin); - }; - - // Shrink given document element until it is effectively invisible. - var _setInvisible = usePrefix ? function(element) { - element.style.webkitTransform = 'scale3d(0.0001,0.0001,1)'; - element.style.opacity = 0; - } : function(element) { - element.style.transform = 'scale3d(0.0001,0.0001,1)'; - element.style.opacity = 0; - }; - - function _xyNotEquals(a, b) { - return (a && b) ? (a[0] !== b[0] || a[1] !== b[1]) : a !== b; - } - - /** - * One-time setup for an element to be ready for commits to document. - * - * @private - * @method setup - * - * @param {ElementAllocator} allocator document element pool for this context - */ - Surface.prototype.setup = function setup(allocator) { - var target = allocator.allocate(this.elementType); - if (this.elementClass) { - if (this.elementClass instanceof Array) { - for (var i = 0; i < this.elementClass.length; i++) { - target.classList.add(this.elementClass[i]); - } - } - else { - target.classList.add(this.elementClass); - } - } - target.style.display = ''; - _addEventListeners.call(this, target); - this._currTarget = target; - this._stylesDirty = true; - this._classesDirty = true; - this._sizeDirty = true; - this._contentDirty = true; - this._matrix = null; - this._opacity = undefined; - this._origin = null; - this._size = null; - }; - - /** - * Apply changes from this component to the corresponding document element. - * This includes changes to classes, styles, size, content, opacity, origin, - * and matrix transforms. - * - * @private - * @method commit - * @param {Context} context commit context - */ - Surface.prototype.commit = function commit(context) { - if (!this._currTarget) this.setup(context.allocator); - var target = this._currTarget; - - var matrix = context.transform; - var opacity = context.opacity; - var origin = context.origin; - var size = context.size; - - if (this._classesDirty) { - _cleanupClasses.call(this, target); - var classList = this.getClassList(); - for (var i = 0; i < classList.length; i++) target.classList.add(classList[i]); - this._classesDirty = false; - } - - if (this._stylesDirty) { - _applyStyles.call(this, target); - this._stylesDirty = false; - } - - if (this._contentDirty) { - this.deploy(target); - this.eventHandler.emit('deploy'); - this._contentDirty = false; - } - - if (this.size) { - var origSize = size; - size = [this.size[0], this.size[1]]; - if (size[0] === undefined && origSize[0]) size[0] = origSize[0]; - if (size[1] === undefined && origSize[1]) size[1] = origSize[1]; - } - - if (size[0] === true) size[0] = target.clientWidth; - if (size[1] === true) size[1] = target.clientHeight; - - if (_xyNotEquals(this._size, size)) { - if (!this._size) this._size = [0, 0]; - this._size[0] = size[0]; - this._size[1] = size[1]; - this._sizeDirty = true; - } - - if (!matrix && this._matrix) { - this._matrix = null; - this._opacity = 0; - _setInvisible(target); - return; - } - - if (this._opacity !== opacity) { - this._opacity = opacity; - target.style.opacity = (opacity >= 1) ? '0.999999' : opacity; - } - - if (_xyNotEquals(this._origin, origin) || Transform.notEquals(this._matrix, matrix) || this._sizeDirty) { - if (!matrix) matrix = Transform.identity; - this._matrix = matrix; - var aaMatrix = matrix; - if (origin) { - if (!this._origin) this._origin = [0, 0]; - this._origin[0] = origin[0]; - this._origin[1] = origin[1]; - aaMatrix = Transform.thenMove(matrix, [-this._size[0] * origin[0], -this._size[1] * origin[1], 0]); - _setOrigin(target, origin); - } - _setMatrix(target, aaMatrix); - } - - if (this._sizeDirty) { - if (this._size) { - target.style.width = (this.size && this.size[0] === true) ? '' : this._size[0] + 'px'; - target.style.height = (this.size && this.size[1] === true) ? '' : this._size[1] + 'px'; - } - this._sizeDirty = false; - } - }; - - /** - * Remove all Famous-relevant attributes from a document element. - * This is called by SurfaceManager's detach(). - * This is in some sense the reverse of .deploy(). - * - * @private - * @method cleanup - * @param {ElementAllocator} allocator - */ - Surface.prototype.cleanup = function cleanup(allocator) { - var i = 0; - var target = this._currTarget; - this.eventHandler.emit('recall'); - this.recall(target); - target.style.display = 'none'; - target.style.width = ''; - target.style.height = ''; - this._size = null; - _cleanupStyles.call(this, target); - var classList = this.getClassList(); - _cleanupClasses.call(this, target); - for (i = 0; i < classList.length; i++) target.classList.remove(classList[i]); - if (this.elementClass) { - if (this.elementClass instanceof Array) { - for (i = 0; i < this.elementClass.length; i++) { - target.classList.remove(this.elementClass[i]); - } - } - else { - target.classList.remove(this.elementClass); - } - } - _removeEventListeners.call(this, target); - this._currTarget = null; - allocator.deallocate(target); - _setInvisible(target); - }; - - /** - * Place the document element that this component manages into the document. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - Surface.prototype.deploy = function deploy(target) { - var content = this.getContent(); - if (content instanceof Node) { - while (target.hasChildNodes()) target.removeChild(target.firstChild); - target.appendChild(content); - } - else target.innerHTML = content; - }; - - /** - * Remove any contained document content associated with this surface - * from the actual document. - * - * @private - * @method recall - */ - Surface.prototype.recall = function recall(target) { - var df = document.createDocumentFragment(); - while (target.hasChildNodes()) df.appendChild(target.firstChild); - this.setContent(df); - }; - - /** - * Get the x and y dimensions of the surface. - * - * @method getSize - * @param {boolean} actual return computed size rather than provided - * @return {Array.Number} [x,y] size of surface - */ - Surface.prototype.getSize = function getSize(actual) { - return actual ? this._size : (this.size || this._size); - }; - - /** - * Set x and y dimensions of the surface. - * - * @method setSize - * @param {Array.Number} size as [width, height] - */ - Surface.prototype.setSize = function setSize(size) { - this.size = size ? [size[0], size[1]] : null; - this._sizeDirty = true; - }; - - module.exports = Surface; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/core/Group',['require','exports','module','./Context','./Transform','./Surface'],function(require, exports, module) { - var Context = require('./Context'); - var Transform = require('./Transform'); - var Surface = require('./Surface'); - - /** - * A Context designed to contain surfaces and set properties - * to be applied to all of them at once. - * This is primarily used for specific performance improvements in the rendering engine. - * Private. - * - * @private - * @class Group - * @extends Surface - * @constructor - * @param {Object} [options] Surface options array (see Surface}) - */ - function Group(options) { - Surface.call(this, options); - this._shouldRecalculateSize = false; - this._container = document.createDocumentFragment(); - this.context = new Context(this._container); - this.setContent(this._container); - this._groupSize = [undefined, undefined]; - } - - /** @const */ - Group.SIZE_ZERO = [0, 0]; - - Group.prototype = Object.create(Surface.prototype); - Group.prototype.elementType = 'div'; - Group.prototype.elementClass = 'famous-group'; - - /** - * Add renderables to this component's render tree. - * - * @method add - * @private - * @param {Object} obj renderable object - * @return {RenderNode} Render wrapping provided object, if not already a RenderNode - */ - Group.prototype.add = function add() { - return this.context.add.apply(this.context, arguments); - }; - - /** - * Generate a render spec from the contents of this component. - * - * @private - * @method render - * @return {Number} Render spec for this component - */ - Group.prototype.render = function render() { - return Surface.prototype.render.call(this); - }; - - /** - * Place the document element this component manages into the document. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - Group.prototype.deploy = function deploy(target) { - this.context.migrate(target); - }; - - /** - * Remove this component and contained content from the document - * - * @private - * @method recall - * - * @param {Node} target node to which the component was deployed - */ - Group.prototype.recall = function recall(target) { - this._container = document.createDocumentFragment(); - this.context.migrate(this._container); - }; - - /** - * Apply changes from this component to the corresponding document element. - * - * @private - * @method commit - * - * @param {Object} context update spec passed in from above in the render tree. - */ - Group.prototype.commit = function commit(context) { - var transform = context.transform; - var origin = context.origin; - var opacity = context.opacity; - var size = context.size; - var result = Surface.prototype.commit.call(this, { - allocator: context.allocator, - transform: Transform.thenMove(transform, [-origin[0] * size[0], -origin[1] * size[1], 0]), - opacity: opacity, - origin: origin, - size: Group.SIZE_ZERO - }); - if (size[0] !== this._groupSize[0] || size[1] !== this._groupSize[1]) { - this._groupSize[0] = size[0]; - this._groupSize[1] = size[1]; - this.context.setSize(size); - } - this.context.update({ - transform: Transform.translate(-origin[0] * size[0], -origin[1] * size[1], 0), - origin: origin, - size: size - }); - return result; - }; - - module.exports = Group; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/transitions/TransitionableTransform',['require','exports','module','./Transitionable','famous/core/Transform','famous/utilities/Utility'],function(require, exports, module) { - var Transitionable = require('./Transitionable'); - var Transform = require('famous/core/Transform'); - var Utility = require('famous/utilities/Utility'); - - /** - * A class for transitioning the state of a Transform by transitioning - * its translate, scale, skew and rotate components independently. - * - * @class TransitionableTransform - * @constructor - * - * @param [transform=Transform.identity] {Transform} The initial transform state - */ - function TransitionableTransform(transform) { - this._final = Transform.identity.slice(); - this.translate = new Transitionable([0, 0, 0]); - this.rotate = new Transitionable([0, 0, 0]); - this.skew = new Transitionable([0, 0, 0]); - this.scale = new Transitionable([1, 1, 1]); - - if (transform) this.set(transform); - } - - function _build() { - return Transform.build({ - translate: this.translate.get(), - rotate: this.rotate.get(), - skew: this.skew.get(), - scale: this.scale.get() - }); - } - - /** - * An optimized way of setting only the translation component of a Transform - * - * @method setTranslate - * @chainable - * - * @param translate {Array} New translation state - * @param [transition] {Object} Transition definition - * @param [callback] {Function} Callback - * @return {TransitionableTransform} - */ - TransitionableTransform.prototype.setTranslate = function setTranslate(translate, transition, callback) { - this.translate.set(translate, transition, callback); - this._final = this._final.slice(); - this._final[12] = translate[0]; - this._final[13] = translate[1]; - if (translate[2] !== undefined) this._final[14] = translate[2]; - return this; - }; - - /** - * An optimized way of setting only the scale component of a Transform - * - * @method setScale - * @chainable - * - * @param scale {Array} New scale state - * @param [transition] {Object} Transition definition - * @param [callback] {Function} Callback - * @return {TransitionableTransform} - */ - TransitionableTransform.prototype.setScale = function setScale(scale, transition, callback) { - this.scale.set(scale, transition, callback); - this._final = this._final.slice(); - this._final[0] = scale[0]; - this._final[5] = scale[1]; - if (scale[2] !== undefined) this._final[10] = scale[2]; - return this; - }; - - /** - * An optimized way of setting only the rotational component of a Transform - * - * @method setRotate - * @chainable - * - * @param eulerAngles {Array} Euler angles for new rotation state - * @param [transition] {Object} Transition definition - * @param [callback] {Function} Callback - * @return {TransitionableTransform} - */ - TransitionableTransform.prototype.setRotate = function setRotate(eulerAngles, transition, callback) { - this.rotate.set(eulerAngles, transition, callback); - this._final = _build.call(this); - this._final = Transform.build({ - translate: this.translate.get(), - rotate: eulerAngles, - scale: this.scale.get(), - skew: this.skew.get() - }); - return this; - }; - - /** - * An optimized way of setting only the skew component of a Transform - * - * @method setSkew - * @chainable - * - * @param skewAngles {Array} New skew state - * @param [transition] {Object} Transition definition - * @param [callback] {Function} Callback - * @return {TransitionableTransform} - */ - TransitionableTransform.prototype.setSkew = function setSkew(skewAngles, transition, callback) { - this.skew.set(skewAngles, transition, callback); - this._final = Transform.build({ - translate: this.translate.get(), - rotate: this.rotate.get(), - scale: this.scale.get(), - skew: skewAngles - }); - return this; - }; - - /** - * Setter for a TransitionableTransform with optional parameters to transition - * between Transforms - * - * @method set - * @chainable - * - * @param transform {Array} New transform state - * @param [transition] {Object} Transition definition - * @param [callback] {Function} Callback - * @return {TransitionableTransform} - */ - TransitionableTransform.prototype.set = function set(transform, transition, callback) { - this._final = transform; - var components = Transform.interpret(transform); - - var _callback = callback ? Utility.after(4, callback) : null; - this.translate.set(components.translate, transition, _callback); - this.rotate.set(components.rotate, transition, _callback); - this.skew.set(components.skew, transition, _callback); - this.scale.set(components.scale, transition, _callback); - return this; - }; - - /** - * Sets the default transition to use for transitioning betwen Transform states - * - * @method setDefaultTransition - * - * @param transition {Object} Transition definition - */ - TransitionableTransform.prototype.setDefaultTransition = function setDefaultTransition(transition) { - this.translate.setDefault(transition); - this.rotate.setDefault(transition); - this.skew.setDefault(transition); - this.scale.setDefault(transition); - }; - - /** - * Getter. Returns the current state of the Transform - * - * @method get - * - * @return {Transform} - */ - TransitionableTransform.prototype.get = function get() { - if (this.isActive()) { - return _build.call(this); - } - else return this._final; - }; - - /** - * Get the destination state of the Transform - * - * @method getFinal - * - * @return Transform {Transform} - */ - TransitionableTransform.prototype.getFinal = function getFinal() { - return this._final; - }; - - /** - * Determine if the TransitionalTransform is currently transitioning - * - * @method isActive - * - * @return {Boolean} - */ - TransitionableTransform.prototype.isActive = function isActive() { - return this.translate.isActive() || this.rotate.isActive() || this.scale.isActive() || this.skew.isActive(); - }; - - /** - * Halts the transition - * - * @method halt - */ - TransitionableTransform.prototype.halt = function halt() { - this._final = this.get(); - this.translate.halt(); - this.rotate.halt(); - this.skew.halt(); - this.scale.halt(); - }; - - module.exports = TransitionableTransform; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/core/Modifier',['require','exports','module','./Transform','famous/transitions/Transitionable','famous/transitions/TransitionableTransform'],function(require, exports, module) { - var Transform = require('./Transform'); - - /* TODO: remove these dependencies when deprecation complete */ - var Transitionable = require('famous/transitions/Transitionable'); - var TransitionableTransform = require('famous/transitions/TransitionableTransform'); - - /** - * - * A collection of visual changes to be - * applied to another renderable component. This collection includes a - * transform matrix, an opacity constant, a size, an origin specifier. - * Modifier objects can be added to any RenderNode or object - * capable of displaying renderables. The Modifier's children and descendants - * are transformed by the amounts specified in the Modifier's properties. - * - * @class Modifier - * @constructor - * @param {Object} [options] overrides of default options - * @param {Transform} [options.transform] affine transformation matrix - * @param {Number} [options.opacity] - * @param {Array.Number} [options.origin] origin adjustment - * @param {Array.Number} [options.size] size to apply to descendants - */ - function Modifier(options) { - this._transformGetter = null; - this._opacityGetter = null; - this._originGetter = null; - this._alignGetter = null; - this._sizeGetter = null; - - /* TODO: remove this when deprecation complete */ - this._legacyStates = {}; - - this._output = { - transform: Transform.identity, - opacity: 1, - origin: null, - align: null, - size: null, - target: null - }; - - if (options) { - if (options.transform) this.transformFrom(options.transform); - if (options.opacity !== undefined) this.opacityFrom(options.opacity); - if (options.origin) this.originFrom(options.origin); - if (options.align) this.alignFrom(options.align); - if (options.size) this.sizeFrom(options.size); - } - } - - /** - * Function, object, or static transform matrix which provides the transform. - * This is evaluated on every tick of the engine. - * - * @method transformFrom - * - * @param {Object} transform transform provider object - * @return {Modifier} this - */ - Modifier.prototype.transformFrom = function transformFrom(transform) { - if (transform instanceof Function) this._transformGetter = transform; - else if (transform instanceof Object && transform.get) this._transformGetter = transform.get.bind(transform); - else { - this._transformGetter = null; - this._output.transform = transform; - } - return this; - }; - - /** - * Set function, object, or number to provide opacity, in range [0,1]. - * - * @method opacityFrom - * - * @param {Object} opacity provider object - * @return {Modifier} this - */ - Modifier.prototype.opacityFrom = function opacityFrom(opacity) { - if (opacity instanceof Function) this._opacityGetter = opacity; - else if (opacity instanceof Object && opacity.get) this._opacityGetter = opacity.get.bind(opacity); - else { - this._opacityGetter = null; - this._output.opacity = opacity; - } - return this; - }; - - /** - * Set function, object, or numerical array to provide origin, as [x,y], - * where x and y are in the range [0,1]. - * - * @method originFrom - * - * @param {Object} origin provider object - * @return {Modifier} this - */ - Modifier.prototype.originFrom = function originFrom(origin) { - if (origin instanceof Function) this._originGetter = origin; - else if (origin instanceof Object && origin.get) this._originGetter = origin.get.bind(origin); - else { - this._originGetter = null; - this._output.origin = origin; - } - return this; - }; - - /** - * Set function, object, or numerical array to provide align, as [x,y], - * where x and y are in the range [0,1]. - * - * @method alignFrom - * - * @param {Object} align provider object - * @return {Modifier} this - */ - Modifier.prototype.alignFrom = function alignFrom(align) { - if (align instanceof Function) this._alignGetter = align; - else if (align instanceof Object && align.get) this._alignGetter = align.get.bind(align); - else { - this._alignGetter = null; - this._output.align = align; - } - return this; - }; - - /** - * Set function, object, or numerical array to provide size, as [width, height]. - * - * @method sizeFrom - * - * @param {Object} size provider object - * @return {Modifier} this - */ - Modifier.prototype.sizeFrom = function sizeFrom(size) { - if (size instanceof Function) this._sizeGetter = size; - else if (size instanceof Object && size.get) this._sizeGetter = size.get.bind(size); - else { - this._sizeGetter = null; - this._output.size = size; - } - return this; - }; - - /** - * Deprecated: Prefer transformFrom with static Transform, or use a TransitionableTransform. - * @deprecated - * @method setTransform - * - * @param {Transform} transform Transform to transition to - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {Modifier} this - */ - Modifier.prototype.setTransform = function setTransform(transform, transition, callback) { - if (transition || this._legacyStates.transform) { - if (!this._legacyStates.transform) { - this._legacyStates.transform = new TransitionableTransform(this._output.transform); - } - if (!this._transformGetter) this.transformFrom(this._legacyStates.transform); - - this._legacyStates.transform.set(transform, transition, callback); - return this; - } - else return this.transformFrom(transform); - }; - - /** - * Deprecated: Prefer opacityFrom with static opacity array, or use a Transitionable with that opacity. - * @deprecated - * @method setOpacity - * - * @param {Number} opacity Opacity value to transition to. - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {Modifier} this - */ - Modifier.prototype.setOpacity = function setOpacity(opacity, transition, callback) { - if (transition || this._legacyStates.opacity) { - if (!this._legacyStates.opacity) { - this._legacyStates.opacity = new Transitionable(this._output.opacity); - } - if (!this._opacityGetter) this.opacityFrom(this._legacyStates.opacity); - - return this._legacyStates.opacity.set(opacity, transition, callback); - } - else return this.opacityFrom(opacity); - }; - - /** - * Deprecated: Prefer originFrom with static origin array, or use a Transitionable with that origin. - * @deprecated - * @method setOrigin - * - * @param {Array.Number} origin two element array with values between 0 and 1. - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {Modifier} this - */ - Modifier.prototype.setOrigin = function setOrigin(origin, transition, callback) { - /* TODO: remove this if statement when deprecation complete */ - if (transition || this._legacyStates.origin) { - - if (!this._legacyStates.origin) { - this._legacyStates.origin = new Transitionable(this._output.origin || [0, 0]); - } - if (!this._originGetter) this.originFrom(this._legacyStates.origin); - - this._legacyStates.origin.set(origin, transition, callback); - return this; - } - else return this.originFrom(origin); - }; - - /** - * Deprecated: Prefer alignFrom with static align array, or use a Transitionable with that align. - * @deprecated - * @method setAlign - * - * @param {Array.Number} align two element array with values between 0 and 1. - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {Modifier} this - */ - Modifier.prototype.setAlign = function setAlign(align, transition, callback) { - /* TODO: remove this if statement when deprecation complete */ - if (transition || this._legacyStates.align) { - - if (!this._legacyStates.align) { - this._legacyStates.align = new Transitionable(this._output.align || [0, 0]); - } - if (!this._alignGetter) this.alignFrom(this._legacyStates.align); - - this._legacyStates.align.set(align, transition, callback); - return this; - } - else return this.alignFrom(align); - }; - - /** - * Deprecated: Prefer sizeFrom with static origin array, or use a Transitionable with that size. - * @deprecated - * @method setSize - * @param {Array.Number} size two element array of [width, height] - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {Modifier} this - */ - Modifier.prototype.setSize = function setSize(size, transition, callback) { - if (size && (transition || this._legacyStates.size)) { - if (!this._legacyStates.size) { - this._legacyStates.size = new Transitionable(this._output.size || [0, 0]); - } - if (!this._sizeGetter) this.sizeFrom(this._legacyStates.size); - - this._legacyStates.size.set(size, transition, callback); - return this; - } - else return this.sizeFrom(size); - }; - - /** - * Deprecated: Prefer to stop transform in your provider object. - * @deprecated - * @method halt - */ - Modifier.prototype.halt = function halt() { - if (this._legacyStates.transform) this._legacyStates.transform.halt(); - if (this._legacyStates.opacity) this._legacyStates.opacity.halt(); - if (this._legacyStates.origin) this._legacyStates.origin.halt(); - if (this._legacyStates.align) this._legacyStates.align.halt(); - if (this._legacyStates.size) this._legacyStates.size.halt(); - this._transformGetter = null; - this._opacityGetter = null; - this._originGetter = null; - this._alignGetter = null; - this._sizeGetter = null; - }; - - /** - * Deprecated: Prefer to use your provided transform or output of your transform provider. - * @deprecated - * @method getTransform - * @return {Object} transform provider object - */ - Modifier.prototype.getTransform = function getTransform() { - return this._transformGetter(); - }; - - /** - * Deprecated: Prefer to determine the end state of your transform from your transform provider - * @deprecated - * @method getFinalTransform - * @return {Transform} transform matrix - */ - Modifier.prototype.getFinalTransform = function getFinalTransform() { - return this._legacyStates.transform ? this._legacyStates.transform.getFinal() : this._output.transform; - }; - - /** - * Deprecated: Prefer to use your provided opacity or output of your opacity provider. - * @deprecated - * @method getOpacity - * @return {Object} opacity provider object - */ - Modifier.prototype.getOpacity = function getOpacity() { - return this._opacityGetter(); - }; - - /** - * Deprecated: Prefer to use your provided origin or output of your origin provider. - * @deprecated - * @method getOrigin - * @return {Object} origin provider object - */ - Modifier.prototype.getOrigin = function getOrigin() { - return this._originGetter(); - }; - - /** - * Deprecated: Prefer to use your provided align or output of your align provider. - * @deprecated - * @method getAlign - * @return {Object} align provider object - */ - Modifier.prototype.getAlign = function getAlign() { - return this._alignGetter(); - }; - - /** - * Deprecated: Prefer to use your provided size or output of your size provider. - * @deprecated - * @method getSize - * @return {Object} size provider object - */ - Modifier.prototype.getSize = function getSize() { - return this._sizeGetter ? this._sizeGetter() : this._output.size; - }; - - // call providers on tick to receive render spec elements to apply - function _update() { - if (this._transformGetter) this._output.transform = this._transformGetter(); - if (this._opacityGetter) this._output.opacity = this._opacityGetter(); - if (this._originGetter) this._output.origin = this._originGetter(); - if (this._alignGetter) this._output.align = this._alignGetter(); - if (this._sizeGetter) this._output.size = this._sizeGetter(); - } - - /** - * Return render spec for this Modifier, applying to the provided - * target component. This is similar to render() for Surfaces. - * - * @private - * @method modify - * - * @param {Object} target (already rendered) render spec to - * which to apply the transform. - * @return {Object} render spec for this Modifier, including the - * provided target - */ - Modifier.prototype.modify = function modify(target) { - _update.call(this); - this._output.target = target; - return this._output; - }; - - module.exports = Modifier; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/core/Scene',['require','exports','module','./Transform','./Modifier','./RenderNode'],function(require, exports, module) { - var Transform = require('./Transform'); - var Modifier = require('./Modifier'); - var RenderNode = require('./RenderNode'); - - /** - * Builds and renders a scene graph based on a declarative structure definition. - * See the Scene examples in the examples distribution (http://github.com/Famous/examples.git). - * - * @class Scene - * @constructor - * @param {Object} definition in the format of a render spec. - */ - function Scene(definition) { - this.id = null; - this._objects = null; - - this.node = new RenderNode(); - this._definition = null; - - if (definition) this.load(definition); - } - - var _MATRIX_GENERATORS = { - 'translate': Transform.translate, - 'rotate': Transform.rotate, - 'rotateX': Transform.rotateX, - 'rotateY': Transform.rotateY, - 'rotateZ': Transform.rotateZ, - 'rotateAxis': Transform.rotateAxis, - 'scale': Transform.scale, - 'skew': Transform.skew, - 'matrix3d': function() { - return arguments; - } - }; - - /** - * Clone this scene - * - * @method create - * @return {Scene} deep copy of this scene - */ - Scene.prototype.create = function create() { - return new Scene(this._definition); - }; - - function _resolveTransformMatrix(matrixDefinition) { - for (var type in _MATRIX_GENERATORS) { - if (type in matrixDefinition) { - var args = matrixDefinition[type]; - if (!(args instanceof Array)) args = [args]; - return _MATRIX_GENERATORS[type].apply(this, args); - } - } - } - - // parse transform into tree of render nodes, doing matrix multiplication - // when available - function _parseTransform(definition) { - var transformDefinition = definition.transform; - var opacity = definition.opacity; - var origin = definition.origin; - var size = definition.size; - var transform = Transform.identity; - if (transformDefinition instanceof Array) { - if (transformDefinition.length === 16 && typeof transformDefinition[0] === 'number') { - transform = transformDefinition; - } - else { - for (var i = 0; i < transformDefinition.length; i++) { - transform = Transform.multiply(transform, _resolveTransformMatrix(transformDefinition[i])); - } - } - } - else if (transformDefinition instanceof Object) { - transform = _resolveTransformMatrix(transformDefinition); - } - - var result = new Modifier({ - transform: transform, - opacity: opacity, - origin: origin, - size: size - }); - return result; - } - - function _parseArray(definition) { - var result = new RenderNode(); - for (var i = 0; i < definition.length; i++) { - var obj = _parse.call(this, definition[i]); - if (obj) result.add(obj); - } - return result; - } - - // parse object directly into tree of RenderNodes - function _parse(definition) { - var result; - var id; - if (definition instanceof Array) { - result = _parseArray.call(this, definition); - } - else { - id = this._objects.length; - if (definition.render && (definition.render instanceof Function)) { - result = definition; - } - else if (definition.target) { - var targetObj = _parse.call(this, definition.target); - var obj = _parseTransform.call(this, definition); - - result = new RenderNode(obj); - result.add(targetObj); - if (definition.id) this.id[definition.id] = obj; - } - else if (definition.id) { - result = new RenderNode(); - this.id[definition.id] = result; - } - } - this._objects[id] = result; - return result; - } - - /** - * Builds and renders a scene graph based on a canonical declarative scene definition. - * See examples/Scene/example.js. - * - * @method load - * @param {Object} definition definition in the format of a render spec. - */ - Scene.prototype.load = function load(definition) { - this._definition = definition; - this.id = {}; - this._objects = []; - this.node.set(_parse.call(this, definition)); - }; - - /** - * Add renderables to this component's render tree - * - * @method add - * - * @param {Object} obj renderable object - * @return {RenderNode} Render wrapping provided object, if not already a RenderNode - */ - Scene.prototype.add = function add() { - return this.node.add.apply(this.node, arguments); - }; - - /** - * Generate a render spec from the contents of this component. - * - * @private - * @method render - * @return {number} Render spec for this component - */ - Scene.prototype.render = function render() { - return this.node.render.apply(this.node, arguments); - }; - - module.exports = Scene; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/core/View',['require','exports','module','./EventHandler','./OptionsManager','./RenderNode'],function(require, exports, module) { - var EventHandler = require('./EventHandler'); - var OptionsManager = require('./OptionsManager'); - var RenderNode = require('./RenderNode'); - - /** - * Useful for quickly creating elements within applications - * with large event systems. Consists of a RenderNode paired with - * an input EventHandler and an output EventHandler. - * Meant to be extended by the developer. - * - * @class View - * @uses EventHandler - * @uses OptionsManager - * @uses RenderNode - * @constructor - */ - function View(options) { - this._node = new RenderNode(); - - this._eventInput = new EventHandler(); - this._eventOutput = new EventHandler(); - EventHandler.setInputHandler(this, this._eventInput); - EventHandler.setOutputHandler(this, this._eventOutput); - - this.options = Object.create(this.constructor.DEFAULT_OPTIONS || View.DEFAULT_OPTIONS); - this._optionsManager = new OptionsManager(this.options); - - if (options) this.setOptions(options); - } - - View.DEFAULT_OPTIONS = {}; // no defaults - - /** - * Look up options value by key - * @method getOptions - * - * @param {string} key key - * @return {Object} associated object - */ - View.prototype.getOptions = function getOptions() { - return this._optionsManager.value(); - }; - - /* - * Set internal options. - * No defaults options are set in View. - * - * @method setOptions - * @param {Object} options - */ - View.prototype.setOptions = function setOptions(options) { - this._optionsManager.patch(options); - }; - - /** - * Add a child renderable to the view. - * Note: This is meant to be used by an inheriting class - * rather than from outside the prototype chain. - * - * @method add - * @return {RenderNode} - * @protected - */ - View.prototype.add = function add() { - return this._node.add.apply(this._node, arguments); - }; - - /** - * Alias for add - * @method _add - */ - View.prototype._add = View.prototype.add; - - /** - * Generate a render spec from the contents of this component. - * - * @private - * @method render - * @return {number} Render spec for this component - */ - View.prototype.render = function render() { - return this._node.render(); - }; - - /** - * Return size of contained element. - * - * @method getSize - * @return {Array.Number} [width, height] - */ - View.prototype.getSize = function getSize() { - if (this._node && this._node.getSize) { - return this._node.getSize.apply(this._node, arguments) || this.options.size; - } - else return this.options.size; - }; - - module.exports = View; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/core/ViewSequence',['require','exports','module'],function(require, exports, module) { - - /** - * Helper object used to iterate through items sequentially. Used in - * views that deal with layout. A ViewSequence object conceptually points - * to a node in a linked list. - * - * @class ViewSequence - * - * @constructor - * @param {Object|Array} options Options object, or content array. - * @param {Number} [options.index] starting index. - * @param {Number} [options.array] Array of elements to populate the ViewSequence - * @param {Object} [options._] Optional backing store (internal - * @param {Boolean} [options.loop] Whether to wrap when accessing elements just past the end - * (or beginning) of the sequence. - */ - function ViewSequence(options) { - if (!options) options = []; - if (options instanceof Array) options = {array: options}; - - this._ = null; - this.index = options.index || 0; - - if (options.array) this._ = new (this.constructor.Backing)(options.array); - else if (options._) this._ = options._; - - if (this.index === this._.firstIndex) this._.firstNode = this; - if (this.index === this._.firstIndex + this._.array.length - 1) this._.lastNode = this; - - if (options.loop !== undefined) this._.loop = options.loop; - - this._previousNode = null; - this._nextNode = null; - } - - // constructor for internal storage - ViewSequence.Backing = function Backing(array) { - this.array = array; - this.firstIndex = 0; - this.loop = false; - this.firstNode = null; - this.lastNode = null; - }; - - // Get value "i" slots away from the first index. - ViewSequence.Backing.prototype.getValue = function getValue(i) { - var _i = i - this.firstIndex; - if (_i < 0 || _i >= this.array.length) return null; - return this.array[_i]; - }; - - // Set value "i" slots away from the first index. - ViewSequence.Backing.prototype.setValue = function setValue(i, value) { - this.array[i - this.firstIndex] = value; - }; - - // After splicing into the backing store, restore the indexes of each node correctly. - ViewSequence.Backing.prototype.reindex = function reindex(start, removeCount, insertCount) { - if (!this.array[0]) return; - - var i = 0; - var index = this.firstIndex; - var indexShiftAmount = insertCount - removeCount; - var node = this.firstNode; - - // find node to begin - while (index < start - 1) { - node = node.getNext(); - index++; - } - // skip removed nodes - var spliceStartNode = node; - for (i = 0; i < removeCount; i++) { - node = node.getNext(); - if (node) node._previousNode = spliceStartNode; - } - var spliceResumeNode = node ? node.getNext() : null; - // generate nodes for inserted items - spliceStartNode._nextNode = null; - node = spliceStartNode; - for (i = 0; i < insertCount; i++) node = node.getNext(); - index += insertCount; - // resume the chain - if (node !== spliceResumeNode) { - node._nextNode = spliceResumeNode; - if (spliceResumeNode) spliceResumeNode._previousNode = node; - } - if (spliceResumeNode) { - node = spliceResumeNode; - index++; - while (node && index < this.array.length + this.firstIndex) { - if (node._nextNode) node.index += indexShiftAmount; - else node.index = index; - node = node.getNext(); - index++; - } - } - }; - - /** - * Return ViewSequence node previous to this node in the list, respecting looping if applied. - * - * @method getPrevious - * @return {ViewSequence} previous node. - */ - ViewSequence.prototype.getPrevious = function getPrevious() { - if (this.index === this._.firstIndex) { - if (this._.loop) { - this._previousNode = this._.lastNode || new (this.constructor)({_: this._, index: this._.firstIndex + this._.array.length - 1}); - this._previousNode._nextNode = this; - } - else { - this._previousNode = null; - } - } - else if (!this._previousNode) { - this._previousNode = new (this.constructor)({_: this._, index: this.index - 1}); - this._previousNode._nextNode = this; - } - return this._previousNode; - }; - - /** - * Return ViewSequence node next after this node in the list, respecting looping if applied. - * - * @method getNext - * @return {ViewSequence} previous node. - */ - ViewSequence.prototype.getNext = function getNext() { - if (this.index === this._.firstIndex + this._.array.length - 1) { - if (this._.loop) { - this._nextNode = this._.firstNode || new (this.constructor)({_: this._, index: this._.firstIndex}); - this._nextNode._previousNode = this; - } - else { - this._nextNode = null; - } - } - else if (!this._nextNode) { - this._nextNode = new (this.constructor)({_: this._, index: this.index + 1}); - this._nextNode._previousNode = this; - } - return this._nextNode; - }; - - /** - * Return index of this ViewSequence node. - * - * @method getIndex - * @return {Number} index - */ - ViewSequence.prototype.getIndex = function getIndex() { - return this.index; - }; - - /** - * Return printable version of this ViewSequence node. - * - * @method toString - * @return {string} this index as a string - */ - ViewSequence.prototype.toString = function toString() { - return '' + this.index; - }; - - /** - * Add one or more objects to the beginning of the sequence. - * - * @method unshift - * @param {...Object} value arguments array of objects - */ - ViewSequence.prototype.unshift = function unshift(value) { - this._.array.unshift.apply(this._.array, arguments); - this._.firstIndex -= arguments.length; - }; - - /** - * Add one or more objects to the end of the sequence. - * - * @method push - * @param {...Object} value arguments array of objects - */ - ViewSequence.prototype.push = function push(value) { - this._.array.push.apply(this._.array, arguments); - }; - - /** - * Remove objects from the sequence - * - * @method splice - * @param {Number} index starting index for removal - * @param {Number} howMany how many elements to remove - * @param {...Object} value arguments array of objects - */ - ViewSequence.prototype.splice = function splice(index, howMany) { - var values = Array.prototype.slice.call(arguments, 2); - this._.array.splice.apply(this._.array, [index - this._.firstIndex, howMany].concat(values)); - this._.reindex(index, howMany, values.length); - }; - - /** - * Exchange this element's sequence position with another's. - * - * @method swap - * @param {ViewSequence} other element to swap with. - */ - ViewSequence.prototype.swap = function swap(other) { - var otherValue = other.get(); - var myValue = this.get(); - this._.setValue(this.index, otherValue); - this._.setValue(other.index, myValue); - - var myPrevious = this._previousNode; - var myNext = this._nextNode; - var myIndex = this.index; - var otherPrevious = other._previousNode; - var otherNext = other._nextNode; - var otherIndex = other.index; - - this.index = otherIndex; - this._previousNode = (otherPrevious === this) ? other : otherPrevious; - if (this._previousNode) this._previousNode._nextNode = this; - this._nextNode = (otherNext === this) ? other : otherNext; - if (this._nextNode) this._nextNode._previousNode = this; - - other.index = myIndex; - other._previousNode = (myPrevious === other) ? this : myPrevious; - if (other._previousNode) other._previousNode._nextNode = other; - other._nextNode = (myNext === other) ? this : myNext; - if (other._nextNode) other._nextNode._previousNode = other; - - if (this.index === this._.firstIndex) this._.firstNode = this; - else if (this.index === this._.firstIndex + this._.array.length - 1) this._.lastNode = this; - if (other.index === this._.firstIndex) this._.firstNode = other; - else if (other.index === this._.firstIndex + this._.array.length - 1) this._.lastNode = other; - }; - - /** - * Return value of this ViewSequence node. - * - * @method get - * @return {Object} value of thiss - */ - ViewSequence.prototype.get = function get() { - return this._.getValue(this.index); - }; - - /** - * Call getSize() on the contained View. - * - * @method getSize - * @return {Array.Number} [width, height] - */ - ViewSequence.prototype.getSize = function getSize() { - var target = this.get(); - return target ? target.getSize() : null; - }; - - /** - * Generate a render spec from the contents of this component. - * Specifically, this will render the value at the current index. - * @private - * @method render - * @return {number} Render spec for this component - */ - ViewSequence.prototype.render = function render() { - var target = this.get(); - return target ? target.render.apply(target, arguments) : null; - }; - - module.exports = ViewSequence; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/math/Utilities',['require','exports','module'],function(require, exports, module) { - /** - * A few static methods. - * - * @class Utilities - * @static - */ - var Utilities = {}; - - /** - * Constrain input to range. - * - * @method clamp - * @param {Number} value input - * @param {Array.Number} range [min, max] - * @static - */ - Utilities.clamp = function clamp(value, range) { - return Math.max(Math.min(value, range[1]), range[0]); - }; - - /** - * Euclidean length of numerical array. - * - * @method length - * @param {Array.Number} array array of numbers - * @static - */ - Utilities.length = function length(array) { - var distanceSquared = 0; - for (var i = 0; i < array.length; i++) { - distanceSquared += array[i] * array[i]; - } - return Math.sqrt(distanceSquared); - }; - - module.exports = Utilities; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/GenericSync',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * Combines multiple types of sync classes (e.g. mouse, touch, - * scrolling) into one standardized interface for inclusion in widgets. - * - * Sync classes are first registered with a key, and then can be accessed - * globally by key. - * - * Emits 'start', 'update' and 'end' events as a union of the sync class - * providers. - * - * @class GenericSync - * @constructor - * @param syncs {Object|Array} object with fields {sync key : sync options} - * or an array of registered sync keys - * @param [options] {Object|Array} options object to set on all syncs - */ - function GenericSync(syncs, options) { - this._eventInput = new EventHandler(); - this._eventOutput = new EventHandler(); - - EventHandler.setInputHandler(this, this._eventInput); - EventHandler.setOutputHandler(this, this._eventOutput); - - this._syncs = {}; - if (syncs) this.addSync(syncs); - if (options) this.setOptions(options); - } - - GenericSync.DIRECTION_X = 0; - GenericSync.DIRECTION_Y = 1; - GenericSync.DIRECTION_Z = 2; - - // Global registry of sync classes. Append only. - var registry = {}; - - /** - * Register a global sync class with an identifying key - * - * @static - * @method register - * - * @param syncObject {Object} an object of {sync key : sync options} fields - */ - GenericSync.register = function register(syncObject) { - for (var key in syncObject){ - if (registry[key]){ - if (registry[key] === syncObject[key]) return; // redundant registration - else throw new Error('this key is registered to a different sync class'); - } - else registry[key] = syncObject[key]; - } - }; - - /** - * Helper to set options on all sync instances - * - * @method setOptions - * @param options {Object} options object - */ - GenericSync.prototype.setOptions = function(options) { - for (var key in this._syncs){ - this._syncs[key].setOptions(options); - } - }; - - /** - * Pipe events to a sync class - * - * @method pipeSync - * @param key {String} identifier for sync class - */ - GenericSync.prototype.pipeSync = function pipeToSync(key) { - var sync = this._syncs[key]; - this._eventInput.pipe(sync); - sync.pipe(this._eventOutput); - }; - - /** - * Unpipe events from a sync class - * - * @method unpipeSync - * @param key {String} identifier for sync class - */ - GenericSync.prototype.unpipeSync = function unpipeFromSync(key) { - var sync = this._syncs[key]; - this._eventInput.unpipe(sync); - sync.unpipe(this._eventOutput); - }; - - function _addSingleSync(key, options) { - if (!registry[key]) return; - this._syncs[key] = new (registry[key])(options); - this.pipeSync(key); - } - - /** - * Add a sync class to from the registered classes - * - * @method addSync - * @param syncs {Object|Array.String} an array of registered sync keys - * or an object with fields {sync key : sync options} - */ - GenericSync.prototype.addSync = function addSync(syncs) { - if (syncs instanceof Array) - for (var i = 0; i < syncs.length; i++) - _addSingleSync.call(this, syncs[i]); - else if (syncs instanceof Object) - for (var key in syncs) - _addSingleSync.call(this, key, syncs[key]); - }; - - module.exports = GenericSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/MouseSync',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * Handles piped in mouse drag events. Outputs an object with two - * properties, position and velocity. - * Emits 'start', 'update' and 'end' events with DOM event passthroughs, - * with position, velocity, and a delta key. - * - * @class MouseSync - * @constructor - * - * @param [options] {Object} default options overrides - * @param [options.direction] {Number} read from a particular axis - * @param [options.rails] {Boolean} read from axis with greatest differential - * @param [options.propogate] {Boolean} add listened to document on mouseleave - */ - function MouseSync(options) { - this.options = Object.create(MouseSync.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._eventInput = new EventHandler(); - this._eventOutput = new EventHandler(); - - EventHandler.setInputHandler(this, this._eventInput); - EventHandler.setOutputHandler(this, this._eventOutput); - - this._eventInput.on('mousedown', _handleStart.bind(this)); - this._eventInput.on('mousemove', _handleMove.bind(this)); - this._eventInput.on('mouseup', _handleEnd.bind(this)); - - if (this.options.propogate) this._eventInput.on('mouseleave', _handleLeave.bind(this)); - else this._eventInput.on('mouseleave', _handleEnd.bind(this)); - - this._payload = { - delta : null, - position : null, - velocity : null, - clientX : 0, - clientY : 0, - offsetX : 0, - offsetY : 0 - }; - - this._position = null; // to be deprecated - this._prevCoord = undefined; - this._prevTime = undefined; - this._down = false; - this._moved = false; - } - - MouseSync.DEFAULT_OPTIONS = { - direction: undefined, - rails: false, - scale: 1, - propogate: true // events piped to document on mouseleave - }; - - MouseSync.DIRECTION_X = 0; - MouseSync.DIRECTION_Y = 1; - - var MINIMUM_TICK_TIME = 8; - - var _now = Date.now; - - function _handleStart(event) { - var delta; - var velocity; - event.preventDefault(); // prevent drag - - var x = event.clientX; - var y = event.clientY; - - this._prevCoord = [x, y]; - this._prevTime = _now(); - this._down = true; - this._move = false; - - if (this.options.direction !== undefined){ - this._position = 0; - delta = 0; - velocity = 0; - } - else { - this._position = [0, 0]; - delta = [0, 0]; - velocity = [0, 0]; - } - - var payload = this._payload; - payload.delta = delta; - payload.position = this._position; - payload.velocity = velocity; - payload.clientX = x; - payload.clientY = y; - payload.offsetX = event.offsetX; - payload.offsetY = event.offsetY; - - this._eventOutput.emit('start', payload); - } - - function _handleMove(event) { - if (!this._prevCoord) return; - - var prevCoord = this._prevCoord; - var prevTime = this._prevTime; - - var x = event.clientX; - var y = event.clientY; - - var currTime = _now(); - - var diffX = x - prevCoord[0]; - var diffY = y - prevCoord[1]; - - if (this.options.rails) { - if (Math.abs(diffX) > Math.abs(diffY)) diffY = 0; - else diffX = 0; - } - - var diffTime = Math.max(currTime - prevTime, MINIMUM_TICK_TIME); // minimum tick time - - var velX = diffX / diffTime; - var velY = diffY / diffTime; - - var scale = this.options.scale; - var nextVel; - var nextDelta; - - if (this.options.direction === MouseSync.DIRECTION_X) { - nextDelta = scale * diffX; - nextVel = scale * velX; - this._position += nextDelta; - } - else if (this.options.direction === MouseSync.DIRECTION_Y) { - nextDelta = scale * diffY; - nextVel = scale * velY; - this._position += nextDelta; - } - else { - nextDelta = [scale * diffX, scale * diffY]; - nextVel = [scale * velX, scale * velY]; - this._position[0] += nextDelta[0]; - this._position[1] += nextDelta[1]; - } - - var payload = this._payload; - payload.delta = nextDelta; - payload.position = this._position; - payload.velocity = nextVel; - payload.clientX = x; - payload.clientY = y; - payload.offsetX = event.offsetX; - payload.offsetY = event.offsetY; - - this._eventOutput.emit('update', payload); - - this._prevCoord = [x, y]; - this._prevTime = currTime; - this._move = true; - } - - function _handleEnd(event) { - if (!this._down) return; - - this._eventOutput.emit('end', this._payload); - this._prevCoord = undefined; - this._prevTime = undefined; - this._down = false; - this._move = false; - } - - function _handleLeave(event) { - if (!this._down || !this._move) return; - - var boundMove = _handleMove.bind(this); - var boundEnd = function(event) { - _handleEnd.call(this, event); - document.removeEventListener('mousemove', boundMove); - document.removeEventListener('mouseup', boundEnd); - }.bind(this, event); - - document.addEventListener('mousemove', boundMove); - document.addEventListener('mouseup', boundEnd); - } - - /** - * Return entire options dictionary, including defaults. - * - * @method getOptions - * @return {Object} configuration options - */ - MouseSync.prototype.getOptions = function getOptions() { - return this.options; - }; - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param [options] {Object} default options overrides - * @param [options.direction] {Number} read from a particular axis - * @param [options.rails] {Boolean} read from axis with greatest differential - * @param [options.propogate] {Boolean} add listened to document on mouseleave - */ - MouseSync.prototype.setOptions = function setOptions(options) { - if (options.direction !== undefined) this.options.direction = options.direction; - if (options.rails !== undefined) this.options.rails = options.rails; - if (options.scale !== undefined) this.options.scale = options.scale; - if (options.propogate !== undefined) this.options.propogate = options.propogate; - }; - - module.exports = MouseSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/TouchTracker',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - var _now = Date.now; - - function _timestampTouch(touch, event, history) { - return { - x: touch.clientX, - y: touch.clientY, - identifier : touch.identifier, - origin: event.origin, - timestamp: _now(), - count: event.touches.length, - history: history - }; - } - - function _handleStart(event) { - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - var data = _timestampTouch(touch, event, null); - this.eventOutput.emit('trackstart', data); - if (!this.selective && !this.touchHistory[touch.identifier]) this.track(data); - } - } - - function _handleMove(event) { - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - var history = this.touchHistory[touch.identifier]; - if (history) { - var data = _timestampTouch(touch, event, history); - this.touchHistory[touch.identifier].push(data); - this.eventOutput.emit('trackmove', data); - } - } - } - - function _handleEnd(event) { - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - var history = this.touchHistory[touch.identifier]; - if (history) { - var data = _timestampTouch(touch, event, history); - this.eventOutput.emit('trackend', data); - delete this.touchHistory[touch.identifier]; - } - } - } - - function _handleUnpipe() { - for (var i in this.touchHistory) { - var history = this.touchHistory[i]; - this.eventOutput.emit('trackend', { - touch: history[history.length - 1].touch, - timestamp: Date.now(), - count: 0, - history: history - }); - delete this.touchHistory[i]; - } - } - - /** - * Helper to TouchSync – tracks piped in touch events, organizes touch - * events by ID, and emits track events back to TouchSync. - * Emits 'trackstart', 'trackmove', and 'trackend' events upstream. - * - * @class TouchTracker - * @constructor - * @param {Boolean} selective if false, save state for each touch. - */ - function TouchTracker(selective) { - this.selective = selective; - this.touchHistory = {}; - - this.eventInput = new EventHandler(); - this.eventOutput = new EventHandler(); - - EventHandler.setInputHandler(this, this.eventInput); - EventHandler.setOutputHandler(this, this.eventOutput); - - this.eventInput.on('touchstart', _handleStart.bind(this)); - this.eventInput.on('touchmove', _handleMove.bind(this)); - this.eventInput.on('touchend', _handleEnd.bind(this)); - this.eventInput.on('touchcancel', _handleEnd.bind(this)); - this.eventInput.on('unpipe', _handleUnpipe.bind(this)); - } - - /** - * Record touch data, if selective is false. - * @private - * @method track - * @param {Object} data touch data - */ - TouchTracker.prototype.track = function track(data) { - this.touchHistory[data.identifier] = [data]; - }; - - module.exports = TouchTracker; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/TouchSync',['require','exports','module','./TouchTracker','famous/core/EventHandler'],function(require, exports, module) { - var TouchTracker = require('./TouchTracker'); - var EventHandler = require('famous/core/EventHandler'); - - /** - * Handles piped in touch events. Emits 'start', 'update', and 'events' - * events with position, velocity, acceleration, and touch id. - * Useful for dealing with inputs on touch devices. - * - * - * @class TouchSync - * @constructor - * - * @param [options] {Object} default options overrides - * @param [options.direction] {Number} read from a particular axis - * @param [options.rails] {Boolean} read from axis with greatest differential - * @param [options.scale] {Number} constant factor to scale velocity output - */ - function TouchSync(options) { - this.options = Object.create(TouchSync.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._eventOutput = new EventHandler(); - this._touchTracker = new TouchTracker(); - - EventHandler.setOutputHandler(this, this._eventOutput); - EventHandler.setInputHandler(this, this._touchTracker); - - this._touchTracker.on('trackstart', _handleStart.bind(this)); - this._touchTracker.on('trackmove', _handleMove.bind(this)); - this._touchTracker.on('trackend', _handleEnd.bind(this)); - - this._payload = { - delta : null, - position : null, - velocity : null, - clientX : undefined, - clientY : undefined, - count : 0, - touch : undefined - }; - - this._position = null; // to be deprecated - } - - TouchSync.DEFAULT_OPTIONS = { - direction: undefined, - rails: false, - scale: 1 - }; - - TouchSync.DIRECTION_X = 0; - TouchSync.DIRECTION_Y = 1; - - var MINIMUM_TICK_TIME = 8; - - // handle 'trackstart' - function _handleStart(data) { - var velocity; - var delta; - if (this.options.direction !== undefined){ - this._position = 0; - velocity = 0; - delta = 0; - } - else { - this._position = [0, 0]; - velocity = [0, 0]; - delta = [0, 0]; - } - - var payload = this._payload; - payload.delta = delta; - payload.position = this._position; - payload.velocity = velocity; - payload.clientX = data.x; - payload.clientY = data.y; - payload.count = data.count; - payload.touch = data.identifier; - - this._eventOutput.emit('start', payload); - } - - // handle 'trackmove' - function _handleMove(data) { - var history = data.history; - - var currHistory = history[history.length - 1]; - var prevHistory = history[history.length - 2]; - - var prevTime = prevHistory.timestamp; - var currTime = currHistory.timestamp; - - var diffX = currHistory.x - prevHistory.x; - var diffY = currHistory.y - prevHistory.y; - - if (this.options.rails) { - if (Math.abs(diffX) > Math.abs(diffY)) diffY = 0; - else diffX = 0; - } - - var diffTime = Math.max(currTime - prevTime, MINIMUM_TICK_TIME); - - var velX = diffX / diffTime; - var velY = diffY / diffTime; - - var scale = this.options.scale; - var nextVel; - var nextDelta; - - if (this.options.direction === TouchSync.DIRECTION_X) { - nextDelta = scale * diffX; - nextVel = scale * velX; - this._position += nextDelta; - } - else if (this.options.direction === TouchSync.DIRECTION_Y) { - nextDelta = scale * diffY; - nextVel = scale * velY; - this._position += nextDelta; - } - else { - nextDelta = [scale * diffX, scale * diffY]; - nextVel = [scale * velX, scale * velY]; - this._position[0] += nextDelta[0]; - this._position[1] += nextDelta[1]; - } - - var payload = this._payload; - payload.delta = nextDelta; - payload.velocity = nextVel; - payload.position = this._position; - payload.clientX = data.x; - payload.clientY = data.y; - payload.count = data.count; - payload.touch = data.identifier; - - this._eventOutput.emit('update', payload); - } - - // handle 'trackend' - function _handleEnd(data) { - this._payload.count = data.count; - this._eventOutput.emit('end', this._payload); - } - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param [options] {Object} default options overrides - * @param [options.direction] {Number} read from a particular axis - * @param [options.rails] {Boolean} read from axis with greatest differential - * @param [options.scale] {Number} constant factor to scale velocity output - */ - TouchSync.prototype.setOptions = function setOptions(options) { - if (options.direction !== undefined) this.options.direction = options.direction; - if (options.rails !== undefined) this.options.rails = options.rails; - if (options.scale !== undefined) this.options.scale = options.scale; - }; - - /** - * Return entire options dictionary, including defaults. - * - * @method getOptions - * @return {Object} configuration options - */ - TouchSync.prototype.getOptions = function getOptions() { - return this.options; - }; - - module.exports = TouchSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/modifiers/Draggable',['require','exports','module','famous/core/Transform','famous/transitions/Transitionable','famous/core/EventHandler','famous/math/Utilities','famous/inputs/GenericSync','famous/inputs/MouseSync','famous/inputs/TouchSync'],function(require, exports, module) { - var Transform = require('famous/core/Transform'); - var Transitionable = require('famous/transitions/Transitionable'); - var EventHandler = require('famous/core/EventHandler'); - var Utilities = require('famous/math/Utilities'); - - var GenericSync = require('famous/inputs/GenericSync'); - var MouseSync = require('famous/inputs/MouseSync'); - var TouchSync = require('famous/inputs/TouchSync'); - GenericSync.register({'mouse': MouseSync, 'touch': TouchSync}); - - /** - * Makes added render nodes responsive to drag beahvior. - * Emits events 'start', 'update', 'end'. - * @class Draggable - * @constructor - * @param {Object} [options] options configuration object. - * @param {Number} [options.snapX] grid width for snapping during drag - * @param {Number} [options.snapY] grid height for snapping during drag - * @param {Array.Number} [options.xRange] maxmimum [negative, positive] x displacement from start of drag - * @param {Array.Number} [options.yRange] maxmimum [negative, positive] y displacement from start of drag - * @param {Number} [options.scale] one pixel of input motion translates to this many pixels of output drag motion - * @param {Number} [options.projection] User should set to Draggable._direction.x or - * Draggable._direction.y to constrain to one axis. - * - */ - function Draggable(options) { - this.options = Object.create(Draggable.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._positionState = new Transitionable([0,0]); - this._differential = [0,0]; - this._active = true; - - this.sync = new GenericSync(['mouse', 'touch'], {scale : this.options.scale}); - this.eventOutput = new EventHandler(); - EventHandler.setInputHandler(this, this.sync); - EventHandler.setOutputHandler(this, this.eventOutput); - - _bindEvents.call(this); - } - - //binary representation of directions for bitwise operations - var _direction = { - x : 0x01, //001 - y : 0x02 //010 - }; - - Draggable.DIRECTION_X = _direction.x; - Draggable.DIRECTION_Y = _direction.y; - - var _clamp = Utilities.clamp; - - Draggable.DEFAULT_OPTIONS = { - projection : _direction.x | _direction.y, - scale : 1, - xRange : null, - yRange : null, - snapX : 0, - snapY : 0, - transition : {duration : 0} - }; - - function _mapDifferential(differential) { - var opts = this.options; - var projection = opts.projection; - var snapX = opts.snapX; - var snapY = opts.snapY; - - //axes - var tx = (projection & _direction.x) ? differential[0] : 0; - var ty = (projection & _direction.y) ? differential[1] : 0; - - //snapping - if (snapX > 0) tx -= tx % snapX; - if (snapY > 0) ty -= ty % snapY; - - return [tx, ty]; - } - - function _handleStart() { - if (!this._active) return; - if (this._positionState.isActive()) this._positionState.halt(); - this.eventOutput.emit('start', {position : this.getPosition()}); - } - - function _handleMove(event) { - if (!this._active) return; - - var options = this.options; - this._differential = event.position; - var newDifferential = _mapDifferential.call(this, this._differential); - - //buffer the differential if snapping is set - this._differential[0] -= newDifferential[0]; - this._differential[1] -= newDifferential[1]; - - var pos = this.getPosition(); - - //modify position, retain reference - pos[0] += newDifferential[0]; - pos[1] += newDifferential[1]; - - //handle bounding box - if (options.xRange){ - var xRange = [options.xRange[0] + 0.5 * options.snapX, options.xRange[1] - 0.5 * options.snapX]; - pos[0] = _clamp(pos[0], xRange); - } - - if (options.yRange){ - var yRange = [options.yRange[0] + 0.5 * options.snapY, options.yRange[1] - 0.5 * options.snapY]; - pos[1] = _clamp(pos[1], yRange); - } - - this.eventOutput.emit('update', {position : pos}); - } - - function _handleEnd() { - if (!this._active) return; - this.eventOutput.emit('end', {position : this.getPosition()}); - } - - function _bindEvents() { - this.sync.on('start', _handleStart.bind(this)); - this.sync.on('update', _handleMove.bind(this)); - this.sync.on('end', _handleEnd.bind(this)); - } - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param {Object} [options] overrides of default options. See constructor. - */ - Draggable.prototype.setOptions = function setOptions(options) { - var currentOptions = this.options; - if (options.projection !== undefined) { - var proj = options.projection; - this.options.projection = 0; - ['x', 'y'].forEach(function(val) { - if (proj.indexOf(val) !== -1) currentOptions.projection |= _direction[val]; - }); - } - if (options.scale !== undefined) { - currentOptions.scale = options.scale; - this.sync.setOptions({ - scale: options.scale - }); - } - if (options.xRange !== undefined) currentOptions.xRange = options.xRange; - if (options.yRange !== undefined) currentOptions.yRange = options.yRange; - if (options.snapX !== undefined) currentOptions.snapX = options.snapX; - if (options.snapY !== undefined) currentOptions.snapY = options.snapY; - }; - - /** - * Get current delta in position from where this draggable started. - * - * @method getPosition - * - * @return {array} [x, y] position delta from start. - */ - Draggable.prototype.getPosition = function getPosition() { - return this._positionState.get(); - }; - - /** - * Transition the element to the desired relative position via provided transition. - * For example, calling this with [0,0] will not change the position. - * Callback will be executed on completion. - * - * @method setRelativePosition - * - * @param {array} position end state to which we interpolate - * @param {transition} transition transition object specifying how object moves to new position - * @param {function} callback zero-argument function to call on observed completion - */ - Draggable.prototype.setRelativePosition = function setRelativePosition(position, transition, callback) { - var currPos = this.getPosition(); - var relativePosition = [currPos[0] + position[0], currPos[1] + position[1]]; - this.setPosition(relativePosition, transition, callback); - }; - - /** - * Transition the element to the desired absolute position via provided transition. - * Callback will be executed on completion. - * - * @method setPosition - * - * @param {array} position end state to which we interpolate - * @param {transition} transition transition object specifying how object moves to new position - * @param {function} callback zero-argument function to call on observed completion - */ - Draggable.prototype.setPosition = function setPosition(position, transition, callback) { - if (this._positionState.isActive()) this._positionState.halt(); - this._positionState.set(position, transition, callback); - }; - - /** - * Set this draggable to respond to user input. - * - * @method activate - * - */ - Draggable.prototype.activate = function activate() { - this._active = true; - }; - - /** - * Set this draggable to ignore user input. - * - * @method deactivate - * - */ - Draggable.prototype.deactivate = function deactivate() { - this._active = false; - }; - - /** - * Switch the input response stage between active and inactive. - * - * @method toggle - * - */ - Draggable.prototype.toggle = function toggle() { - this._active = !this._active; - }; - - /** - * Return render spec for this Modifier, applying to the provided - * target component. This is similar to render() for Surfaces. - * - * @private - * @method modify - * - * @param {Object} target (already rendered) render spec to - * which to apply the transform. - * @return {Object} render spec for this Modifier, including the - * provided target - */ - Draggable.prototype.modify = function modify(target) { - var pos = this.getPosition(); - return { - transform: Transform.translate(pos[0], pos[1]), - target: target - }; - }; - - module.exports = Draggable; -}); - -define('famous/modifiers/Fader',['require','exports','module','famous/transitions/Transitionable','famous/core/OptionsManager'],function(require, exports, module) { - var Transitionable = require('famous/transitions/Transitionable'); - var OptionsManager = require('famous/core/OptionsManager'); - - /** - * Modifier that allows you to fade the opacity of affected renderables in and out. - * @class Fader - * @constructor - * @param {Object} [options] options configuration object. - * @param {Boolean} [options.cull=false] Stops returning affected renderables up the tree when they're fully faded when true. - * @param {Transition} [options.transition=true] The main transition for showing and hiding. - * @param {Transition} [options.pulseInTransition=true] Controls the transition to a pulsed state when the Fader instance's pulse - * method is called. - * @param {Transition} [options.pulseOutTransition=true]Controls the transition back from a pulsed state when the Fader instance's pulse - * method is called. - * - */ - function Fader(options, startState) { - this.options = Object.create(Fader.DEFAULT_OPTIONS); - this._optionsManager = new OptionsManager(this.options); - - if (options) this.setOptions(options); - - if (!startState) startState = 0; - this.transitionHelper = new Transitionable(startState); - } - - Fader.DEFAULT_OPTIONS = { - cull: false, - transition: true, - pulseInTransition: true, - pulseOutTransition: true - }; - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param {Object} [options] overrides of default options. See constructor. - */ - Fader.prototype.setOptions = function setOptions(options) { - return this._optionsManager.setOptions(options); - }; - - /** - * Fully displays the Fader instance's associated renderables. - * - * @method show - * @param {Transition} [transition] The transition that coordinates setting to the new state. - * @param {Function} [callback] A callback that executes once you've transitioned to the fully shown state. - */ - Fader.prototype.show = function show(transition, callback) { - transition = transition || this.options.transition; - this.set(1, transition, callback); - }; - - /** - * Fully fades the Fader instance's associated renderables. - * - * @method hide - * @param {Transition} [transition] The transition that coordinates setting to the new state. - * @param {Function} [callback] A callback that executes once you've transitioned to the fully faded state. - */ - Fader.prototype.hide = function hide(transition, callback) { - transition = transition || this.options.transition; - this.set(0, transition, callback); - }; - - /** - * Manually sets the opacity state of the fader to the passed-in one. Executes with an optional - * transition and callback. - * - * @method set - * @param {Number} state A number from zero to one: the amount of opacity you want to set to. - * @param {Transition} [transition] The transition that coordinates setting to the new state. - * @param {Function} [callback] A callback that executes once you've finished executing the pulse. - */ - Fader.prototype.set = function set(state, transition, callback) { - this.halt(); - this.transitionHelper.set(state, transition, callback); - }; - - /** - * Halt the transition - * - * @method halt - */ - Fader.prototype.halt = function halt() { - this.transitionHelper.halt(); - }; - - /** - * Tells you if your Fader instance is above its visibility threshold. - * - * @method isVisible - * @return {Boolean} Whether or not your Fader instance is visible. - */ - Fader.prototype.isVisible = function isVisible() { - return (this.transitionHelper.get() > 0); - }; - - /** - * Return render spec for this Modifier, applying to the provided - * target component. This is similar to render() for Surfaces. - * - * @private - * @method modify - * - * @param {Object} target (already rendered) render spec to - * which to apply the transform. - * @return {Object} render spec for this Modifier, including the - * provided target - */ - Fader.prototype.modify = function modify(target) { - var currOpacity = this.transitionHelper.get(); - if (this.options.cull && !currOpacity) return undefined; - else return {opacity: currOpacity, target: target}; - }; - - module.exports = Fader; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/modifiers/ModifierChain',['require','exports','module'],function(require, exports, module) { - - /** - * A class to add and remove a chain of modifiers - * at a single point in the render tree - * - * @class ModifierChain - * @constructor - */ - function ModifierChain() { - this._chain = []; - if (arguments.length) this.addModifier.apply(this, arguments); - } - - /** - * Add a modifier, or comma separated modifiers, to the modifier chain. - * - * @method addModifier - * - * @param {...Modifier*} varargs args list of Modifiers - */ - ModifierChain.prototype.addModifier = function addModifier(varargs) { - Array.prototype.push.apply(this._chain, arguments); - }; - - /** - * Remove a modifier from the modifier chain. - * - * @method removeModifier - * - * @param {Modifier} modifier - */ - ModifierChain.prototype.removeModifier = function removeModifier(modifier) { - var index = this._chain.indexOf(modifier); - if (index < 0) return; - this._chain.splice(index, 1); - }; - - /** - * Return render spec for this Modifier, applying to the provided - * target component. This is similar to render() for Surfaces. - * - * @private - * @method modify - * - * @param {Object} input (already rendered) render spec to - * which to apply the transform. - * @return {Object} render spec for this Modifier, including the - * provided target - */ - ModifierChain.prototype.modify = function modify(input) { - var chain = this._chain; - var result = input; - for (var i = 0; i < chain.length; i++) { - result = chain[i].modify(result); - } - return result; - }; - - module.exports = ModifierChain; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/modifiers/StateModifier',['require','exports','module','famous/core/Modifier','famous/core/Transform','famous/transitions/Transitionable','famous/transitions/TransitionableTransform'],function(require, exports, module) { - var Modifier = require('famous/core/Modifier'); - var Transform = require('famous/core/Transform'); - var Transitionable = require('famous/transitions/Transitionable'); - var TransitionableTransform = require('famous/transitions/TransitionableTransform'); - - /** - * A collection of visual changes to be - * applied to another renderable component, strongly coupled with the state that defines - * those changes. This collection includes a - * transform matrix, an opacity constant, a size, an origin specifier, and an alignment specifier. - * StateModifier objects can be added to any RenderNode or object - * capable of displaying renderables. The StateModifier's children and descendants - * are transformed by the amounts specified in the modifier's properties. - * - * @class StateModifier - * @constructor - * @param {Object} [options] overrides of default options - * @param {Transform} [options.transform] affine transformation matrix - * @param {Number} [options.opacity] - * @param {Array.Number} [options.origin] origin adjustment - * @param {Array.Number} [options.align] align adjustment - * @param {Array.Number} [options.size] size to apply to descendants - */ - function StateModifier(options) { - this._transformState = new TransitionableTransform(Transform.identity); - this._opacityState = new Transitionable(1); - this._originState = new Transitionable([0, 0]); - this._alignState = new Transitionable([0, 0]); - this._sizeState = new Transitionable([0, 0]); - - this._modifier = new Modifier({ - transform: this._transformState, - opacity: this._opacityState, - origin: null, - align: null, - size: null - }); - - this._hasOrigin = false; - this._hasAlign = false; - this._hasSize = false; - - if (options) { - if (options.transform) this.setTransform(options.transform); - if (options.opacity !== undefined) this.setOpacity(options.opacity); - if (options.origin) this.setOrigin(options.origin); - if (options.align) this.setAlign(options.align); - if (options.size) this.setSize(options.size); - } - } - - /** - * Set the transform matrix of this modifier, either statically or - * through a provided Transitionable. - * - * @method setTransform - * - * @param {Transform} transform Transform to transition to. - * @param {Transitionable} [transition] Valid transitionable object - * @param {Function} [callback] callback to call after transition completes - * @return {StateModifier} this - */ - StateModifier.prototype.setTransform = function setTransform(transform, transition, callback) { - this._transformState.set(transform, transition, callback); - return this; - }; - - /** - * Set the opacity of this modifier, either statically or - * through a provided Transitionable. - * - * @method setOpacity - * - * @param {Number} opacity Opacity value to transition to. - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {StateModifier} this - */ - StateModifier.prototype.setOpacity = function setOpacity(opacity, transition, callback) { - this._opacityState.set(opacity, transition, callback); - return this; - }; - - /** - * Set the origin of this modifier, either statically or - * through a provided Transitionable. - * - * @method setOrigin - * - * @param {Array.Number} origin two element array with values between 0 and 1. - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {StateModifier} this - */ - StateModifier.prototype.setOrigin = function setOrigin(origin, transition, callback) { - if (origin === null) { - if (this._hasOrigin) { - this._modifier.originFrom(null); - this._hasOrigin = false; - } - return this; - } - else if (!this._hasOrigin) { - this._hasOrigin = true; - this._modifier.originFrom(this._originState); - } - this._originState.set(origin, transition, callback); - return this; - }; - - /** - * Set the alignment of this modifier, either statically or - * through a provided Transitionable. - * - * @method setAlign - * - * @param {Array.Number} align two element array with values between 0 and 1. - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {StateModifier} this - */ - StateModifier.prototype.setAlign = function setOrigin(align, transition, callback) { - if (align === null) { - if (this._hasAlign) { - this._modifier.alignFrom(null); - this._hasAlign = false; - } - return this; - } - else if (!this._hasAlign) { - this._hasAlign = true; - this._modifier.alignFrom(this._alignState); - } - this._alignState.set(align, transition, callback); - return this; - }; - - /** - * Set the size of this modifier, either statically or - * through a provided Transitionable. - * - * @method setSize - * - * @param {Array.Number} size two element array with values between 0 and 1. - * @param {Transitionable} transition Valid transitionable object - * @param {Function} callback callback to call after transition completes - * @return {StateModifier} this - */ - StateModifier.prototype.setSize = function setSize(size, transition, callback) { - if (size === null) { - if (this._hasSize) { - this._modifier.sizeFrom(null); - this._hasSize = false; - } - return this; - } - else if (!this._hasSize) { - this._hasSize = true; - this._modifier.sizeFrom(this._sizeState); - } - this._sizeState.set(size, transition, callback); - return this; - }; - - /** - * Stop the transition. - * - * @method halt - */ - StateModifier.prototype.halt = function halt() { - this._transformState.halt(); - this._opacityState.halt(); - this._originState.halt(); - this._alignState.halt(); - this._sizeState.halt(); - }; - - /** - * Get the current state of the transform matrix component. - * - * @method getTransform - * @return {Object} transform provider object - */ - StateModifier.prototype.getTransform = function getTransform() { - return this._transformState.get(); - }; - - /** - * Get the destination state of the transform component. - * - * @method getFinalTransform - * @return {Transform} transform matrix - */ - StateModifier.prototype.getFinalTransform = function getFinalTransform() { - return this._transformState.getFinal(); - }; - - /** - * Get the current state of the opacity component. - * - * @method getOpacity - * @return {Object} opacity provider object - */ - StateModifier.prototype.getOpacity = function getOpacity() { - return this._opacityState.get(); - }; - - /** - * Get the current state of the origin component. - * - * @method getOrigin - * @return {Object} origin provider object - */ - StateModifier.prototype.getOrigin = function getOrigin() { - return this._hasOrigin ? this._originState.get() : null; - }; - - /** - * Get the current state of the align component. - * - * @method getAlign - * @return {Object} align provider object - */ - StateModifier.prototype.getAlign = function getAlign() { - return this._hasAlign ? this._alignState.get() : null; - }; - - /** - * Get the current state of the size component. - * - * @method getSize - * @return {Object} size provider object - */ - StateModifier.prototype.getSize = function getSize() { - return this._hasSize ? this._sizeState.get() : null; - }; - - /** - * Return render spec for this StateModifier, applying to the provided - * target component. This is similar to render() for Surfaces. - * - * @private - * @method modify - * - * @param {Object} target (already rendered) render spec to - * which to apply the transform. - * @return {Object} render spec for this StateModifier, including the - * provided target - */ - StateModifier.prototype.modify = function modify(target) { - return this._modifier.modify(target); - }; - - module.exports = StateModifier; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/math/Vector',['require','exports','module'],function(require, exports, module) { - - /** - * Three-element floating point vector. - * - * @class Vector - * @constructor - * - * @param {number} x x element value - * @param {number} y y element value - * @param {number} z z element value - */ - function Vector(x,y,z) { - if (arguments.length === 1) this.set(x); - else { - this.x = x || 0; - this.y = y || 0; - this.z = z || 0; - } - return this; - } - - var _register = new Vector(0,0,0); - - /** - * Add this element-wise to another Vector, element-wise. - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method add - * @param {Vector} v addend - * @return {Vector} vector sum - */ - Vector.prototype.add = function add(v) { - return _setXYZ.call(_register, - this.x + v.x, - this.y + v.y, - this.z + v.z - ); - }; - - /** - * Subtract another vector from this vector, element-wise. - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method sub - * @param {Vector} v subtrahend - * @return {Vector} vector difference - */ - Vector.prototype.sub = function sub(v) { - return _setXYZ.call(_register, - this.x - v.x, - this.y - v.y, - this.z - v.z - ); - }; - - /** - * Scale Vector by floating point r. - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method mult - * - * @param {number} r scalar - * @return {Vector} vector result - */ - Vector.prototype.mult = function mult(r) { - return _setXYZ.call(_register, - r * this.x, - r * this.y, - r * this.z - ); - }; - - /** - * Scale Vector by floating point 1/r. - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method div - * - * @param {number} r scalar - * @return {Vector} vector result - */ - Vector.prototype.div = function div(r) { - return this.mult(1 / r); - }; - - /** - * Given another vector v, return cross product (v)x(this). - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method cross - * @param {Vector} v Left Hand Vector - * @return {Vector} vector result - */ - Vector.prototype.cross = function cross(v) { - var x = this.x; - var y = this.y; - var z = this.z; - var vx = v.x; - var vy = v.y; - var vz = v.z; - - return _setXYZ.call(_register, - z * vy - y * vz, - x * vz - z * vx, - y * vx - x * vy - ); - }; - - /** - * Component-wise equality test between this and Vector v. - * @method equals - * @param {Vector} v vector to compare - * @return {boolean} - */ - Vector.prototype.equals = function equals(v) { - return (v.x === this.x && v.y === this.y && v.z === this.z); - }; - - /** - * Rotate clockwise around x-axis by theta radians. - * Note: This sets the internal result register, so other references to that vector will change. - * @method rotateX - * @param {number} theta radians - * @return {Vector} rotated vector - */ - Vector.prototype.rotateX = function rotateX(theta) { - var x = this.x; - var y = this.y; - var z = this.z; - - var cosTheta = Math.cos(theta); - var sinTheta = Math.sin(theta); - - return _setXYZ.call(_register, - x, - y * cosTheta - z * sinTheta, - y * sinTheta + z * cosTheta - ); - }; - - /** - * Rotate clockwise around y-axis by theta radians. - * Note: This sets the internal result register, so other references to that vector will change. - * @method rotateY - * @param {number} theta radians - * @return {Vector} rotated vector - */ - Vector.prototype.rotateY = function rotateY(theta) { - var x = this.x; - var y = this.y; - var z = this.z; - - var cosTheta = Math.cos(theta); - var sinTheta = Math.sin(theta); - - return _setXYZ.call(_register, - z * sinTheta + x * cosTheta, - y, - z * cosTheta - x * sinTheta - ); - }; - - /** - * Rotate clockwise around z-axis by theta radians. - * Note: This sets the internal result register, so other references to that vector will change. - * @method rotateZ - * @param {number} theta radians - * @return {Vector} rotated vector - */ - Vector.prototype.rotateZ = function rotateZ(theta) { - var x = this.x; - var y = this.y; - var z = this.z; - - var cosTheta = Math.cos(theta); - var sinTheta = Math.sin(theta); - - return _setXYZ.call(_register, - x * cosTheta - y * sinTheta, - x * sinTheta + y * cosTheta, - z - ); - }; - - /** - * Return dot product of this with a second Vector - * @method dot - * @param {Vector} v second vector - * @return {number} dot product - */ - Vector.prototype.dot = function dot(v) { - return this.x * v.x + this.y * v.y + this.z * v.z; - }; - - /** - * Return squared length of this vector - * @method normSquared - * @return {number} squared length - */ - Vector.prototype.normSquared = function normSquared() { - return this.dot(this); - }; - - /** - * Return length of this vector - * @method norm - * @return {number} length - */ - Vector.prototype.norm = function norm() { - return Math.sqrt(this.normSquared()); - }; - - /** - * Scale Vector to specified length. - * If length is less than internal tolerance, set vector to [length, 0, 0]. - * Note: This sets the internal result register, so other references to that vector will change. - * @method normalize - * - * @param {number} length target length, default 1.0 - * @return {Vector} - */ - Vector.prototype.normalize = function normalize(length) { - if (arguments.length === 0) length = 1; - var norm = this.norm(); - - if (norm > 1e-7) return _setFromVector.call(_register, this.mult(length / norm)); - else return _setXYZ.call(_register, length, 0, 0); - }; - - /** - * Make a separate copy of the Vector. - * - * @method clone - * - * @return {Vector} - */ - Vector.prototype.clone = function clone() { - return new Vector(this); - }; - - /** - * True if and only if every value is 0 (or falsy) - * - * @method isZero - * - * @return {boolean} - */ - Vector.prototype.isZero = function isZero() { - return !(this.x || this.y || this.z); - }; - - function _setXYZ(x,y,z) { - this.x = x; - this.y = y; - this.z = z; - return this; - } - - function _setFromArray(v) { - return _setXYZ.call(this,v[0],v[1],v[2] || 0); - } - - function _setFromVector(v) { - return _setXYZ.call(this, v.x, v.y, v.z); - } - - function _setFromNumber(x) { - return _setXYZ.call(this,x,0,0); - } - - /** - * Set this Vector to the values in the provided Array or Vector. - * - * @method set - * @param {object} v array, Vector, or number - * @return {Vector} this - */ - Vector.prototype.set = function set(v) { - if (v instanceof Array) return _setFromArray.call(this, v); - if (v instanceof Vector) return _setFromVector.call(this, v); - if (typeof v === 'number') return _setFromNumber.call(this, v); - }; - - Vector.prototype.setXYZ = function(x,y,z) { - return _setXYZ.apply(this, arguments); - }; - - Vector.prototype.set1D = function(x) { - return _setFromNumber.call(this, x); - }; - - /** - * Put result of last internal register calculation in specified output vector. - * - * @method put - * @param {Vector} v destination vector - * @return {Vector} destination vector - */ - - Vector.prototype.put = function put(v) { - _setFromVector.call(v, _register); - }; - - /** - * Set this vector to [0,0,0] - * - * @method clear - */ - Vector.prototype.clear = function clear() { - return _setXYZ.call(this,0,0,0); - }; - - /** - * Scale this Vector down to specified "cap" length. - * If Vector shorter than cap, or cap is Infinity, do nothing. - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method cap - * @return {Vector} capped vector - */ - Vector.prototype.cap = function cap(cap) { - if (cap === Infinity) return _setFromVector.call(_register, this); - var norm = this.norm(); - if (norm > cap) return _setFromVector.call(_register, this.mult(cap / norm)); - else return _setFromVector.call(_register, this); - }; - - /** - * Return projection of this Vector onto another. - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method project - * @param {Vector} n vector to project upon - * @return {Vector} projected vector - */ - Vector.prototype.project = function project(n) { - return n.mult(this.dot(n)); - }; - - /** - * Reflect this Vector across provided vector. - * Note: This sets the internal result register, so other references to that vector will change. - * - * @method reflectAcross - * @param {Vector} n vector to reflect across - * @return {Vector} reflected vector - */ - Vector.prototype.reflectAcross = function reflectAcross(n) { - n.normalize().put(n); - return _setFromVector(_register, this.sub(this.project(n).mult(2))); - }; - - /** - * Convert Vector to three-element array. - * - * @method get - * @return {array} three-element array - */ - Vector.prototype.get = function get() { - return [this.x, this.y, this.z]; - }; - - Vector.prototype.get1D = function() { - return this.x; - }; - - module.exports = Vector; - -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/math/Matrix',['require','exports','module','./Vector'],function(require, exports, module) { - var Vector = require('./Vector'); - - /** - * A library for using a 3x3 numerical matrix, represented as a two-level array. - * - * @class Matrix - * @constructor - * - * @param {Array.Array} values array of rows - */ - function Matrix(values) { - this.values = values || - [ - [1,0,0], - [0,1,0], - [0,0,1] - ]; - - return this; - } - - var _register = new Matrix(); - var _vectorRegister = new Vector(); - - /** - * Return the values in the matrix as an array of numerical row arrays - * - * @method get - * - * @return {Array.array} matrix values as array of rows. - */ - Matrix.prototype.get = function get() { - return this.values; - }; - - /** - * Set the nested array of rows in the matrix. - * - * @method set - * - * @param {Array.array} values matrix values as array of rows. - */ - Matrix.prototype.set = function set(values) { - this.values = values; - }; - - /** - * Take this matrix as A, input vector V as a column vector, and return matrix product (A)(V). - * Note: This sets the internal vector register. Current handles to the vector register - * will see values changed. - * - * @method vectorMultiply - * - * @param {Vector} v input vector V - * @return {Vector} result of multiplication, as a handle to the internal vector register - */ - Matrix.prototype.vectorMultiply = function vectorMultiply(v) { - var M = this.get(); - var v0 = v.x; - var v1 = v.y; - var v2 = v.z; - - var M0 = M[0]; - var M1 = M[1]; - var M2 = M[2]; - - var M00 = M0[0]; - var M01 = M0[1]; - var M02 = M0[2]; - var M10 = M1[0]; - var M11 = M1[1]; - var M12 = M1[2]; - var M20 = M2[0]; - var M21 = M2[1]; - var M22 = M2[2]; - - return _vectorRegister.setXYZ( - M00*v0 + M01*v1 + M02*v2, - M10*v0 + M11*v1 + M12*v2, - M20*v0 + M21*v1 + M22*v2 - ); - }; - - /** - * Multiply the provided matrix M2 with this matrix. Result is (this) * (M2). - * Note: This sets the internal matrix register. Current handles to the register - * will see values changed. - * - * @method multiply - * - * @param {Matrix} M2 input matrix to multiply on the right - * @return {Matrix} result of multiplication, as a handle to the internal register - */ - Matrix.prototype.multiply = function multiply(M2) { - var M1 = this.get(); - var result = [[]]; - for (var i = 0; i < 3; i++) { - result[i] = []; - for (var j = 0; j < 3; j++) { - var sum = 0; - for (var k = 0; k < 3; k++) { - sum += M1[i][k] * M2[k][j]; - } - result[i][j] = sum; - } - } - return _register.set(result); - }; - - /** - * Creates a Matrix which is the transpose of this matrix. - * Note: This sets the internal matrix register. Current handles to the register - * will see values changed. - * - * @method transpose - * - * @return {Matrix} result of transpose, as a handle to the internal register - */ - Matrix.prototype.transpose = function transpose() { - var result = []; - var M = this.get(); - for (var row = 0; row < 3; row++) { - for (var col = 0; col < 3; col++) { - result[row][col] = M[col][row]; - } - } - return _register.set(result); - }; - - /** - * Clones the matrix - * - * @method clone - * @return {Matrix} New copy of the original matrix - */ - Matrix.prototype.clone = function clone() { - var values = this.get(); - var M = []; - for (var row = 0; row < 3; row++) - M[row] = values[row].slice(); - return new Matrix(M); - }; - - module.exports = Matrix; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/math/Quaternion',['require','exports','module','./Matrix'],function(require, exports, module) { - var Matrix = require('./Matrix'); - - /** - * @class Quaternion - * @constructor - * - * @param {Number} w - * @param {Number} x - * @param {Number} y - * @param {Number} z - */ - function Quaternion(w,x,y,z) { - if (arguments.length === 1) this.set(w); - else { - this.w = (w !== undefined) ? w : 1; //Angle - this.x = (x !== undefined) ? x : 0; //Axis.x - this.y = (y !== undefined) ? y : 0; //Axis.y - this.z = (z !== undefined) ? z : 0; //Axis.z - } - return this; - } - - var register = new Quaternion(1,0,0,0); - - /** - * Doc: TODO - * @method add - * @param {Quaternion} q - * @return {Quaternion} - */ - Quaternion.prototype.add = function add(q) { - return register.setWXYZ( - this.w + q.w, - this.x + q.x, - this.y + q.y, - this.z + q.z - ); - }; - - /* - * Docs: TODO - * - * @method sub - * @param {Quaternion} q - * @return {Quaternion} - */ - Quaternion.prototype.sub = function sub(q) { - return register.setWXYZ( - this.w - q.w, - this.x - q.x, - this.y - q.y, - this.z - q.z - ); - }; - - /** - * Doc: TODO - * - * @method scalarDivide - * @param {Number} s - * @return {Quaternion} - */ - Quaternion.prototype.scalarDivide = function scalarDivide(s) { - return this.scalarMultiply(1/s); - }; - - /* - * Docs: TODO - * - * @method scalarMultiply - * @param {Number} s - * @return {Quaternion} - */ - Quaternion.prototype.scalarMultiply = function scalarMultiply(s) { - return register.setWXYZ( - this.w * s, - this.x * s, - this.y * s, - this.z * s - ); - }; - - /* - * Docs: TODO - * - * @method multiply - * @param {Quaternion} q - * @return {Quaternion} - */ - Quaternion.prototype.multiply = function multiply(q) { - //left-handed coordinate system multiplication - var x1 = this.x; - var y1 = this.y; - var z1 = this.z; - var w1 = this.w; - var x2 = q.x; - var y2 = q.y; - var z2 = q.z; - var w2 = q.w || 0; - - return register.setWXYZ( - w1*w2 - x1*x2 - y1*y2 - z1*z2, - x1*w2 + x2*w1 + y2*z1 - y1*z2, - y1*w2 + y2*w1 + x1*z2 - x2*z1, - z1*w2 + z2*w1 + x2*y1 - x1*y2 - ); - }; - - var conj = new Quaternion(1,0,0,0); - - /* - * Docs: TODO - * - * @method rotateVector - * @param {Vector} v - * @return {Quaternion} - */ - Quaternion.prototype.rotateVector = function rotateVector(v) { - conj.set(this.conj()); - return register.set(this.multiply(v).multiply(conj)); - }; - - /* - * Docs: TODO - * - * @method inverse - * @return {Quaternion} - */ - Quaternion.prototype.inverse = function inverse() { - return register.set(this.conj().scalarDivide(this.normSquared())); - }; - - /* - * Docs: TODO - * - * @method negate - * @return {Quaternion} - */ - Quaternion.prototype.negate = function negate() { - return this.scalarMultiply(-1); - }; - - /* - * Docs: TODO - * - * @method conj - * @return {Quaternion} - */ - Quaternion.prototype.conj = function conj() { - return register.setWXYZ( - this.w, - -this.x, - -this.y, - -this.z - ); - }; - - /* - * Docs: TODO - * - * @method normalize - * @param {Number} length - * @return {Quaternion} - */ - Quaternion.prototype.normalize = function normalize(length) { - length = (length === undefined) ? 1 : length; - return this.scalarDivide(length * this.norm()); - }; - - /* - * Docs: TODO - * - * @method makeFromAngleAndAxis - * @param {Number} angle - * @param {Vector} v - * @return {Quaternion} - */ - Quaternion.prototype.makeFromAngleAndAxis = function makeFromAngleAndAxis(angle, v) { - //left handed quaternion creation: theta -> -theta - var n = v.normalize(); - var ha = angle*0.5; - var s = -Math.sin(ha); - this.x = s*n.x; - this.y = s*n.y; - this.z = s*n.z; - this.w = Math.cos(ha); - return this; - }; - - /* - * Docs: TODO - * - * @method setWXYZ - * @param {Number} w - * @param {Number} x - * @param {Number} y - * @param {Number} z - * @return {Quaternion} - */ - Quaternion.prototype.setWXYZ = function setWXYZ(w,x,y,z) { - register.clear(); - this.w = w; - this.x = x; - this.y = y; - this.z = z; - return this; - }; - - /* - * Docs: TODO - * - * @method set - * @param {Array|Quaternion} v - * @return {Quaternion} - */ - Quaternion.prototype.set = function set(v) { - if (v instanceof Array) { - this.w = v[0]; - this.x = v[1]; - this.y = v[2]; - this.z = v[3]; - } - else { - this.w = v.w; - this.x = v.x; - this.y = v.y; - this.z = v.z; - } - if (this !== register) register.clear(); - return this; - }; - - /** - * Docs: TODO - * - * @method put - * @param {Quaternion} q - * @return {Quaternion} - */ - Quaternion.prototype.put = function put(q) { - q.set(register); - }; - - /** - * Doc: TODO - * - * @method clone - * @return {Quaternion} - */ - Quaternion.prototype.clone = function clone() { - return new Quaternion(this); - }; - - /** - * Doc: TODO - * - * @method clear - * @return {Quaternion} - */ - Quaternion.prototype.clear = function clear() { - this.w = 1; - this.x = 0; - this.y = 0; - this.z = 0; - return this; - }; - - /** - * Doc: TODO - * - * @method isEqual - * @param {Quaternion} q - * @return {Boolean} - */ - Quaternion.prototype.isEqual = function isEqual(q) { - return q.w === this.w && q.x === this.x && q.y === this.y && q.z === this.z; - }; - - /** - * Doc: TODO - * - * @method dot - * @param {Quaternion} q - * @return {Number} - */ - Quaternion.prototype.dot = function dot(q) { - return this.w * q.w + this.x * q.x + this.y * q.y + this.z * q.z; - }; - - /** - * Doc: TODO - * - * @method normSquared - * @return {Number} - */ - Quaternion.prototype.normSquared = function normSquared() { - return this.dot(this); - }; - - /** - * Doc: TODO - * - * @method norm - * @return {Number} - */ - Quaternion.prototype.norm = function norm() { - return Math.sqrt(this.normSquared()); - }; - - /** - * Doc: TODO - * - * @method isZero - * @return {Boolean} - */ - Quaternion.prototype.isZero = function isZero() { - return !(this.x || this.y || this.z); - }; - - /** - * Doc: TODO - * - * @method getTransform - * @return {Transform} - */ - Quaternion.prototype.getTransform = function getTransform() { - var temp = this.normalize(1); - var x = temp.x; - var y = temp.y; - var z = temp.z; - var w = temp.w; - - //LHC system flattened to column major = RHC flattened to row major - return [ - 1 - 2*y*y - 2*z*z, - 2*x*y - 2*z*w, - 2*x*z + 2*y*w, - 0, - 2*x*y + 2*z*w, - 1 - 2*x*x - 2*z*z, - 2*y*z - 2*x*w, - 0, - 2*x*z - 2*y*w, - 2*y*z + 2*x*w, - 1 - 2*x*x - 2*y*y, - 0, - 0, - 0, - 0, - 1 - ]; - }; - - var matrixRegister = new Matrix(); - - /** - * Doc: TODO - * - * @method getMatrix - * @return {Transform} - */ - Quaternion.prototype.getMatrix = function getMatrix() { - var temp = this.normalize(1); - var x = temp.x; - var y = temp.y; - var z = temp.z; - var w = temp.w; - - //LHC system flattened to row major - return matrixRegister.set([ - [ - 1 - 2*y*y - 2*z*z, - 2*x*y + 2*z*w, - 2*x*z - 2*y*w - ], - [ - 2*x*y - 2*z*w, - 1 - 2*x*x - 2*z*z, - 2*y*z + 2*x*w - ], - [ - 2*x*z + 2*y*w, - 2*y*z - 2*x*w, - 1 - 2*x*x - 2*y*y - ] - ]); - }; - - var epsilon = 1e-5; - - /** - * Doc: TODO - * - * @method slerp - * @param {Quaternion} q - * @param {Number} t - * @return {Transform} - */ - Quaternion.prototype.slerp = function slerp(q, t) { - var omega; - var cosomega; - var sinomega; - var scaleFrom; - var scaleTo; - - cosomega = this.dot(q); - if ((1.0 - cosomega) > epsilon) { - omega = Math.acos(cosomega); - sinomega = Math.sin(omega); - scaleFrom = Math.sin((1.0 - t) * omega) / sinomega; - scaleTo = Math.sin(t * omega) / sinomega; - } - else { - scaleFrom = 1.0 - t; - scaleTo = t; - } - return register.set(this.scalarMultiply(scaleFrom/scaleTo).add(q).multiply(scaleTo)); - }; - - module.exports = Quaternion; - -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/math/Random',['require','exports','module'],function(require, exports, module) { - - var RAND = Math.random; - - function _randomFloat(min,max) { - return min + RAND() * (max - min); - } - - function _randomInteger(min,max) { - return (min + RAND() * (max - min + 1)) >> 0; - } - - /** - * Very simple uniform random number generator library wrapping Math.random(). - * - * @class Random - * @static - */ - var Random = {}; - - /** - * Get single random integer between min and max (inclusive), or array - * of size dim if specified. - * - * @method integer - * - * @param {Number} min lower bound, default 0 - * @param {Number} max upper bound, default 1 - * @param {Number} dim (optional) dimension of output array, if specified - * @return {number | array} random integer, or optionally, an array of random integers - */ - Random.integer = function integer(min,max,dim) { - min = (min !== undefined) ? min : 0; - max = (max !== undefined) ? max : 1; - if (dim !== undefined) { - var result = []; - for (var i = 0; i < dim; i++) result.push(_randomInteger(min,max)); - return result; - } - else return _randomInteger(min,max); - }; - - /** - * Get single random float between min and max (inclusive), or array - * of size dim if specified - * - * @method range - * - * @param {Number} min lower bound, default 0 - * @param {Number} max upper bound, default 1 - * @param {Number} [dim] dimension of output array, if specified - * @return {Number} random float, or optionally an array - */ - Random.range = function range(min,max,dim) { - min = (min !== undefined) ? min : 0; - max = (max !== undefined) ? max : 1; - if (dim !== undefined) { - var result = []; - for (var i = 0; i < dim; i++) result.push(_randomFloat(min,max)); - return result; - } - else return _randomFloat(min,max); - }; - - /** - * Return random number among the set {-1 ,1} - * - * @method sign - * - * @param {Number} prob probability of returning 1, default 0.5 - * @return {Number} random sign (-1 or 1) - */ - Random.sign = function sign(prob) { - prob = (prob !== undefined) ? prob : 0.5; - return (RAND() < prob) ? 1 : -1; - }; - - /** - * Return random boolean value, true or false. - * - * @method bool - * - * @param {Number} prob probability of returning true, default 0.5 - * @return {Boolean} random boolean - */ - Random.bool = function bool(prob) { - prob = (prob !== undefined) ? prob : 0.5; - return RAND() < prob; - }; - - module.exports = Random; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/events/EventArbiter',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * A switch which wraps several event destinations and - * redirects received events to at most one of them. - * Setting the 'mode' of the object dictates which one - * of these destinations will receive events. - * - * @class EventArbiter - * @constructor - * - * @param {Number | string} startMode initial setting of switch, - */ - function EventArbiter(startMode) { - this.dispatchers = {}; - this.currMode = undefined; - this.setMode(startMode); - } - - /** - * Set switch to this mode, passing events to the corresponding - * EventHandler. If mode has changed, emits 'change' event, - * emits 'unpipe' event to the old mode's handler, and emits 'pipe' - * event to the new mode's handler. - * - * @method setMode - * - * @param {string | number} mode indicating which event handler to send to. - */ - EventArbiter.prototype.setMode = function setMode(mode) { - if (mode !== this.currMode) { - var startMode = this.currMode; - - if (this.dispatchers[this.currMode]) this.dispatchers[this.currMode].trigger('unpipe'); - this.currMode = mode; - if (this.dispatchers[mode]) this.dispatchers[mode].emit('pipe'); - this.emit('change', {from: startMode, to: mode}); - } - }; - - /** - * Return the existing EventHandler corresponding to this - * mode, creating one if it doesn't exist. - * - * @method forMode - * - * @param {string | number} mode mode to which this eventHandler corresponds - * - * @return {EventHandler} eventHandler corresponding to this mode - */ - EventArbiter.prototype.forMode = function forMode(mode) { - if (!this.dispatchers[mode]) this.dispatchers[mode] = new EventHandler(); - return this.dispatchers[mode]; - }; - - /** - * Trigger an event, sending to currently selected handler, if - * it is listening for provided 'type' key. - * - * @method emit - * - * @param {string} eventType event type key (for example, 'click') - * @param {Object} event event data - * @return {EventHandler} this - */ - EventArbiter.prototype.emit = function emit(eventType, event) { - if (this.currMode === undefined) return false; - if (!event) event = {}; - var dispatcher = this.dispatchers[this.currMode]; - if (dispatcher) return dispatcher.trigger(eventType, event); - }; - - module.exports = EventArbiter; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/events/EventFilter',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * EventFilter regulates the broadcasting of events based on - * a specified condition function of standard event type: function(type, data). - * - * @class EventFilter - * @constructor - * - * @param {function} condition function to determine whether or not - * events are emitted. - */ - function EventFilter(condition) { - EventHandler.call(this); - this._condition = condition; - } - EventFilter.prototype = Object.create(EventHandler.prototype); - EventFilter.prototype.constructor = EventFilter; - - /** - * If filter condition is met, trigger an event, sending to all downstream handlers - * listening for provided 'type' key. - * - * @method emit - * - * @param {string} type event type key (for example, 'click') - * @param {Object} data event data - * @return {EventHandler} this - */ - EventFilter.prototype.emit = function emit(type, data) { - if (this._condition(type, data)) - return EventHandler.prototype.emit.apply(this, arguments); - }; - - /** - * An alias of emit. Trigger determines whether to send - * events based on the return value of it's condition function - * when passed the event type and associated data. - * - * @method trigger - * @param {string} type name of the event - * @param {object} data associated data - */ - EventFilter.prototype.trigger = EventFilter.prototype.emit; - - module.exports = EventFilter; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/events/EventMapper',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * EventMapper routes events to various event destinations - * based on custom logic. The function signature is arbitrary. - * - * @class EventMapper - * @constructor - * - * @param {function} mappingFunction function to determine where - * events are routed to. - */ - function EventMapper(mappingFunction) { - EventHandler.call(this); - this._mappingFunction = mappingFunction; - } - EventMapper.prototype = Object.create(EventHandler.prototype); - EventMapper.prototype.constructor = EventMapper; - - EventMapper.prototype.subscribe = null; - EventMapper.prototype.unsubscribe = null; - - /** - * Trigger an event, sending to all mapped downstream handlers - * listening for provided 'type' key. - * - * @method emit - * - * @param {string} type event type key (for example, 'click') - * @param {Object} data event data - * @return {EventHandler} this - */ - EventMapper.prototype.emit = function emit(type, data) { - var target = this._mappingFunction.apply(this, arguments); - if (target && (target.emit instanceof Function)) target.emit(type, data); - }; - - /** - * Alias of emit. - * @method trigger - */ - EventMapper.prototype.trigger = EventMapper.prototype.emit; - - module.exports = EventMapper; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ -define('famous/physics/PhysicsEngine',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * The Physics Engine is responsible for mediating Bodies and their - * interaction with forces and constraints. The Physics Engine handles the - * logic of adding and removing bodies, updating their state of the over - * time. - * - * @class PhysicsEngine - * @constructor - * @param options {Object} options - */ - function PhysicsEngine(options) { - this.options = Object.create(PhysicsEngine.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._particles = []; //list of managed particles - this._bodies = []; //list of managed bodies - this._agents = {}; //hash of managed agents - this._forces = []; //list of IDs of agents that are forces - this._constraints = []; //list of IDs of agents that are constraints - - this._buffer = 0.0; - this._prevTime = now(); - this._isSleeping = false; - this._eventHandler = null; - this._currAgentId = 0; - this._hasBodies = false; - } - - var TIMESTEP = 17; - var MIN_TIME_STEP = 1000 / 120; - var MAX_TIME_STEP = 17; - - /** - * @property PhysicsEngine.DEFAULT_OPTIONS - * @type Object - * @protected - * @static - */ - PhysicsEngine.DEFAULT_OPTIONS = { - - /** - * The number of iterations the engine takes to resolve constraints - * @attribute constraintSteps - * @type Number - */ - constraintSteps : 1, - - /** - * The energy threshold before the Engine stops updating - * @attribute sleepTolerance - * @type Number - */ - sleepTolerance : 1e-7 - }; - - var now = (function() { - return Date.now; - })(); - - /** - * Options setter - * @method setOptions - * @param options {Object} - */ - PhysicsEngine.prototype.setOptions = function setOptions(opts) { - for (var key in opts) if (this.options[key]) this.options[key] = opts[key]; - }; - - /** - * Method to add a physics body to the engine. Necessary to update the - * body over time. - * - * @method addBody - * @param body {Body} - * @return body {Body} - */ - PhysicsEngine.prototype.addBody = function addBody(body) { - body._engine = this; - if (body.isBody) { - this._bodies.push(body); - this._hasBodies = true; - } - else this._particles.push(body); - return body; - }; - - /** - * Remove a body from the engine. Detaches body from all forces and - * constraints. - * - * @method removeBody - * @param body {Body} - */ - PhysicsEngine.prototype.removeBody = function removeBody(body) { - var array = (body.isBody) ? this._bodies : this._particles; - var index = array.indexOf(body); - if (index > -1) { - for (var i = 0; i < Object.keys(this._agents).length; i++) this.detachFrom(i, body); - array.splice(index,1); - } - if (this.getBodies().length === 0) this._hasBodies = false; - }; - - function _mapAgentArray(agent) { - if (agent.applyForce) return this._forces; - if (agent.applyConstraint) return this._constraints; - } - - function _attachOne(agent, targets, source) { - if (targets === undefined) targets = this.getParticlesAndBodies(); - if (!(targets instanceof Array)) targets = [targets]; - - this._agents[this._currAgentId] = { - agent : agent, - targets : targets, - source : source - }; - - _mapAgentArray.call(this, agent).push(this._currAgentId); - return this._currAgentId++; - } - - /** - * Attaches a force or constraint to a Body. Returns an AgentId of the - * attached agent which can be used to detach the agent. - * - * @method attach - * @param agent {Agent|Array.Agent} A force, constraint, or array of them. - * @param [targets=All] {Body|Array.Body} The Body or Bodies affected by the agent - * @param [source] {Body} The source of the agent - * @return AgentId {Number} - */ - PhysicsEngine.prototype.attach = function attach(agents, targets, source) { - if (agents instanceof Array) { - var agentIDs = []; - for (var i = 0; i < agents.length; i++) - agentIDs[i] = _attachOne.call(this, agents[i], targets, source); - return agentIDs; - } - else return _attachOne.call(this, agents, targets, source); - }; - - /** - * Append a body to the targets of a previously defined physics agent. - * - * @method attachTo - * @param agentID {AgentId} The agentId of a previously defined agent - * @param target {Body} The Body affected by the agent - */ - PhysicsEngine.prototype.attachTo = function attachTo(agentID, target) { - _getBoundAgent.call(this, agentID).targets.push(target); - }; - - /** - * Undoes PhysicsEngine.attach. Removes an agent and its associated - * effect on its affected Bodies. - * - * @method detach - * @param agentID {AgentId} The agentId of a previously defined agent - */ - PhysicsEngine.prototype.detach = function detach(id) { - // detach from forces/constraints array - var agent = this.getAgent(id); - var agentArray = _mapAgentArray.call(this, agent); - var index = agentArray.indexOf(id); - agentArray.splice(index,1); - - // detach agents array - delete this._agents[id]; - }; - - /** - * Remove a single Body from a previously defined agent. - * - * @method detach - * @param agentID {AgentId} The agentId of a previously defined agent - * @param target {Body} The body to remove from the agent - */ - PhysicsEngine.prototype.detachFrom = function detachFrom(id, target) { - var boundAgent = _getBoundAgent.call(this, id); - if (boundAgent.source === target) this.detach(id); - else { - var targets = boundAgent.targets; - var index = targets.indexOf(target); - if (index > -1) targets.splice(index,1); - } - }; - - /** - * A convenience method to give the Physics Engine a clean slate of - * agents. Preserves all added Body objects. - * - * @method detachAll - */ - PhysicsEngine.prototype.detachAll = function detachAll() { - this._agents = {}; - this._forces = []; - this._constraints = []; - this._currAgentId = 0; - }; - - function _getBoundAgent(id) { - return this._agents[id]; - } - - /** - * Returns the corresponding agent given its agentId. - * - * @method getAgent - * @param id {AgentId} - */ - PhysicsEngine.prototype.getAgent = function getAgent(id) { - return _getBoundAgent.call(this, id).agent; - }; - - /** - * Returns all particles that are currently managed by the Physics Engine. - * - * @method getParticles - * @return particles {Array.Particles} - */ - PhysicsEngine.prototype.getParticles = function getParticles() { - return this._particles; - }; - - /** - * Returns all bodies, except particles, that are currently managed by the Physics Engine. - * - * @method getBodies - * @return bodies {Array.Bodies} - */ - PhysicsEngine.prototype.getBodies = function getBodies() { - return this._bodies; - }; - - /** - * Returns all bodies that are currently managed by the Physics Engine. - * - * @method getBodies - * @return bodies {Array.Bodies} - */ - PhysicsEngine.prototype.getParticlesAndBodies = function getParticlesAndBodies() { - return this.getParticles().concat(this.getBodies()); - }; - - /** - * Iterates over every Particle and applies a function whose first - * argument is the Particle - * - * @method forEachParticle - * @param fn {Function} Function to iterate over - * @param [dt] {Number} Delta time - */ - PhysicsEngine.prototype.forEachParticle = function forEachParticle(fn, dt) { - var particles = this.getParticles(); - for (var index = 0, len = particles.length; index < len; index++) - fn.call(this, particles[index], dt); - }; - - /** - * Iterates over every Body that isn't a Particle and applies - * a function whose first argument is the Body - * - * @method forEachBody - * @param fn {Function} Function to iterate over - * @param [dt] {Number} Delta time - */ - PhysicsEngine.prototype.forEachBody = function forEachBody(fn, dt) { - if (!this._hasBodies) return; - var bodies = this.getBodies(); - for (var index = 0, len = bodies.length; index < len; index++) - fn.call(this, bodies[index], dt); - }; - - /** - * Iterates over every Body and applies a function whose first - * argument is the Body - * - * @method forEach - * @param fn {Function} Function to iterate over - * @param [dt] {Number} Delta time - */ - PhysicsEngine.prototype.forEach = function forEach(fn, dt) { - this.forEachParticle(fn, dt); - this.forEachBody(fn, dt); - }; - - function _updateForce(index) { - var boundAgent = _getBoundAgent.call(this, this._forces[index]); - boundAgent.agent.applyForce(boundAgent.targets, boundAgent.source); - } - - function _updateForces() { - for (var index = this._forces.length - 1; index > -1; index--) - _updateForce.call(this, index); - } - - function _updateConstraint(index, dt) { - var boundAgent = this._agents[this._constraints[index]]; - return boundAgent.agent.applyConstraint(boundAgent.targets, boundAgent.source, dt); - } - - function _updateConstraints(dt) { - var iteration = 0; - while (iteration < this.options.constraintSteps) { - for (var index = this._constraints.length - 1; index > -1; index--) - _updateConstraint.call(this, index, dt); - iteration++; - } - } - - function _updateVelocities(particle, dt) { - particle.integrateVelocity(dt); - } - - function _updateAngularVelocities(body, dt) { - body.integrateAngularMomentum(dt); - body.updateAngularVelocity(); - } - - function _updateOrientations(body, dt) { - body.integrateOrientation(dt); - } - - function _updatePositions(particle, dt) { - particle.integratePosition(dt); - particle.emit('update', particle); - } - - function _integrate(dt) { - _updateForces.call(this, dt); - this.forEach(_updateVelocities, dt); - this.forEachBody(_updateAngularVelocities, dt); - _updateConstraints.call(this, dt); - this.forEachBody(_updateOrientations, dt); - this.forEach(_updatePositions, dt); - } - - function _getEnergyParticles() { - var energy = 0.0; - var particleEnergy = 0.0; - this.forEach(function(particle) { - particleEnergy = particle.getEnergy(); - energy += particleEnergy; - if (particleEnergy < particle.sleepTolerance) particle.sleep(); - }); - return energy; - } - - function _getEnergyForces() { - var energy = 0; - for (var index = this._forces.length - 1; index > -1; index--) - energy += this._forces[index].getEnergy() || 0.0; - return energy; - } - - function _getEnergyConstraints() { - var energy = 0; - for (var index = this._constraints.length - 1; index > -1; index--) - energy += this._constraints[index].getEnergy() || 0.0; - return energy; - } - - /** - * Calculates the kinetic energy of all Body objects and potential energy - * of all attached agents. - * - * TODO: implement. - * @method getEnergy - * @return energy {Number} - */ - PhysicsEngine.prototype.getEnergy = function getEnergy() { - return _getEnergyParticles.call(this) + _getEnergyForces.call(this) + _getEnergyConstraints.call(this); - }; - - /** - * Updates all Body objects managed by the physics engine over the - * time duration since the last time step was called. - * - * @method step - */ - PhysicsEngine.prototype.step = function step() { -// if (this.getEnergy() < this.options.sleepTolerance) { -// this.sleep(); -// return; -// }; - - //set current frame's time - var currTime = now(); - - //milliseconds elapsed since last frame - var dtFrame = currTime - this._prevTime; - - this._prevTime = currTime; - - if (dtFrame < MIN_TIME_STEP) return; - if (dtFrame > MAX_TIME_STEP) dtFrame = MAX_TIME_STEP; - - //robust integration -// this._buffer += dtFrame; -// while (this._buffer > this._timestep){ -// _integrate.call(this, this._timestep); -// this._buffer -= this._timestep; -// }; -// _integrate.call(this, this._buffer); -// this._buffer = 0.0; - _integrate.call(this, TIMESTEP); - -// this.emit('update', this); - }; - - /** - * Tells whether the Physics Engine is sleeping or awake. - * @method isSleeping - * @return {Boolean} - */ - PhysicsEngine.prototype.isSleeping = function isSleeping() { - return this._isSleeping; - }; - - /** - * Stops the Physics Engine from updating. Emits an 'end' event. - * @method sleep - */ - PhysicsEngine.prototype.sleep = function sleep() { - this.emit('end', this); - this._isSleeping = true; - }; - - /** - * Starts the Physics Engine from updating. Emits an 'start' event. - * @method wake - */ - PhysicsEngine.prototype.wake = function wake() { - this._prevTime = now(); - this.emit('start', this); - this._isSleeping = false; - }; - - PhysicsEngine.prototype.emit = function emit(type, data) { - if (this._eventHandler === null) return; - this._eventHandler.emit(type, data); - }; - - PhysicsEngine.prototype.on = function on(event, fn) { - if (this._eventHandler === null) this._eventHandler = new EventHandler(); - this._eventHandler.on(event, fn); - }; - - module.exports = PhysicsEngine; -}); - -define('famous/inputs/Accumulator',['require','exports','module','famous/core/EventHandler','famous/transitions/Transitionable'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - var Transitionable = require('famous/transitions/Transitionable'); - - /** - * Accumulates differentials of event sources that emit a `delta` - * attribute taking a Number or Array of Number types. The accumulated - * value is stored in a getter/setter. - * - * @class Accumulator - * @constructor - * @param value {Number|Array|Transitionable} Initializing value - * @param [eventName='update'] {String} Name of update event - */ - function Accumulator(value, eventName) { - if (eventName === undefined) eventName = 'update'; - - this._state = (value && value.get && value.set) - ? value - : new Transitionable(value || 0); - - this._eventInput = new EventHandler(); - EventHandler.setInputHandler(this, this._eventInput); - - this._eventInput.on(eventName, _handleUpdate.bind(this)); - } - - function _handleUpdate(data) { - var delta = data.delta; - var state = this.get(); - - if (delta.constructor === state.constructor){ - var newState = (delta instanceof Array) - ? [state[0] + delta[0], state[1] + delta[1]] - : state + delta; - this.set(newState); - } - } - - /** - * Basic getter - * - * @method get - * @return {Number|Array} current value - */ - Accumulator.prototype.get = function get() { - return this._state.get(); - }; - - /** - * Basic setter - * - * @method set - * @param value {Number|Array} new value - */ - Accumulator.prototype.set = function set(value) { - this._state.set(value); - }; - - module.exports = Accumulator; -}); - -define('famous/inputs/DesktopEmulationMode',['require','exports','module'],function(require, exports, module) { - var hasTouch = 'ontouchstart' in window; - - function kill(type) { - window.addEventListener(type, function(event) { - event.stopPropagation(); - return false; - }, true); - } - - if (hasTouch) { - kill('mousedown'); - kill('mousemove'); - kill('mouseup'); - kill('mouseleave'); - } -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/FastClick',['require','exports','module'],function(require, exports, module) { - /** - * FastClick is an override shim which maps event pairs of - * 'touchstart' and 'touchend' which differ by less than a certain - * threshold to the 'click' event. - * This is used to speed up clicks on some browsers. - */ - if (!window.CustomEvent) return; - var clickThreshold = 300; - var clickWindow = 500; - var potentialClicks = {}; - var recentlyDispatched = {}; - var _now = Date.now; - - window.addEventListener('touchstart', function(event) { - var timestamp = _now(); - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - potentialClicks[touch.identifier] = timestamp; - } - }); - - window.addEventListener('touchmove', function(event) { - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - delete potentialClicks[touch.identifier]; - } - }); - - window.addEventListener('touchend', function(event) { - var currTime = _now(); - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - var startTime = potentialClicks[touch.identifier]; - if (startTime && currTime - startTime < clickThreshold) { - var clickEvt = new window.CustomEvent('click', { - 'bubbles': true, - 'details': touch - }); - recentlyDispatched[currTime] = event; - event.target.dispatchEvent(clickEvt); - } - delete potentialClicks[touch.identifier]; - } - }); - - window.addEventListener('click', function(event) { - var currTime = _now(); - for (var i in recentlyDispatched) { - var previousEvent = recentlyDispatched[i]; - if (currTime - i < clickWindow) { - if (event instanceof window.MouseEvent && event.target === previousEvent.target) event.stopPropagation(); - } - else delete recentlyDispatched[i]; - } - }, true); -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/TwoFingerSync',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * Helper to PinchSync, RotateSync, and ScaleSync. Generalized handling of - * two-finger touch events. - * This class is meant to be overridden and not used directly. - * - * @class TwoFingerSync - * @constructor - */ - function TwoFingerSync() { - this._eventInput = new EventHandler(); - this._eventOutput = new EventHandler(); - - EventHandler.setInputHandler(this, this._eventInput); - EventHandler.setOutputHandler(this, this._eventOutput); - - this.touchAEnabled = false; - this.touchAId = 0; - this.posA = null; - this.timestampA = 0; - this.touchBEnabled = false; - this.touchBId = 0; - this.posB = null; - this.timestampB = 0; - - this._eventInput.on('touchstart', this.handleStart.bind(this)); - this._eventInput.on('touchmove', this.handleMove.bind(this)); - this._eventInput.on('touchend', this.handleEnd.bind(this)); - this._eventInput.on('touchcancel', this.handleEnd.bind(this)); - } - - TwoFingerSync.calculateAngle = function(posA, posB) { - var diffX = posB[0] - posA[0]; - var diffY = posB[1] - posA[1]; - return Math.atan2(diffY, diffX); - }; - - TwoFingerSync.calculateDistance = function(posA, posB) { - var diffX = posB[0] - posA[0]; - var diffY = posB[1] - posA[1]; - return Math.sqrt(diffX * diffX + diffY * diffY); - }; - - TwoFingerSync.calculateCenter = function(posA, posB) { - return [(posA[0] + posB[0]) / 2.0, (posA[1] + posB[1]) / 2.0]; - }; - - var _now = Date.now; - - // private - TwoFingerSync.prototype.handleStart = function handleStart(event) { - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - if (!this.touchAEnabled) { - this.touchAId = touch.identifier; - this.touchAEnabled = true; - this.posA = [touch.pageX, touch.pageY]; - this.timestampA = _now(); - } - else if (!this.touchBEnabled) { - this.touchBId = touch.identifier; - this.touchBEnabled = true; - this.posB = [touch.pageX, touch.pageY]; - this.timestampB = _now(); - this._startUpdate(event); - } - } - }; - - // private - TwoFingerSync.prototype.handleMove = function handleMove(event) { - if (!(this.touchAEnabled && this.touchBEnabled)) return; - var prevTimeA = this.timestampA; - var prevTimeB = this.timestampB; - var diffTime; - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - if (touch.identifier === this.touchAId) { - this.posA = [touch.pageX, touch.pageY]; - this.timestampA = _now(); - diffTime = this.timestampA - prevTimeA; - } - else if (touch.identifier === this.touchBId) { - this.posB = [touch.pageX, touch.pageY]; - this.timestampB = _now(); - diffTime = this.timestampB - prevTimeB; - } - } - if (diffTime) this._moveUpdate(diffTime); - }; - - // private - TwoFingerSync.prototype.handleEnd = function handleEnd(event) { - for (var i = 0; i < event.changedTouches.length; i++) { - var touch = event.changedTouches[i]; - if (touch.identifier === this.touchAId || touch.identifier === this.touchBId) { - if (this.touchAEnabled && this.touchBEnabled) { - this._eventOutput.emit('end', { - touches : [this.touchAId, this.touchBId], - angle : this._angle - }); - } - this.touchAEnabled = false; - this.touchAId = 0; - this.touchBEnabled = false; - this.touchBId = 0; - } - } - }; - - module.exports = TwoFingerSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/PinchSync',['require','exports','module','./TwoFingerSync'],function(require, exports, module) { - var TwoFingerSync = require('./TwoFingerSync'); - - /** - * Handles piped in two-finger touch events to change position via pinching / expanding. - * Emits 'start', 'update' and 'end' events with - * position, velocity, touch ids, and distance between fingers. - * - * @class PinchSync - * @extends TwoFingerSync - * @constructor - * @param {Object} options default options overrides - * @param {Number} [options.scale] scale velocity by this factor - */ - function PinchSync(options) { - TwoFingerSync.call(this); - - this.options = Object.create(PinchSync.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._displacement = 0; - this._previousDistance = 0; - } - - PinchSync.prototype = Object.create(TwoFingerSync.prototype); - PinchSync.prototype.constructor = PinchSync; - - PinchSync.DEFAULT_OPTIONS = { - scale : 1 - }; - - PinchSync.prototype._startUpdate = function _startUpdate(event) { - this._previousDistance = TwoFingerSync.calculateDistance(this.posA, this.posB); - this._displacement = 0; - - this._eventOutput.emit('start', { - count: event.touches.length, - touches: [this.touchAId, this.touchBId], - distance: this._dist, - center: TwoFingerSync.calculateCenter(this.posA, this.posB) - }); - }; - - PinchSync.prototype._moveUpdate = function _moveUpdate(diffTime) { - var currDist = TwoFingerSync.calculateDistance(this.posA, this.posB); - var center = TwoFingerSync.calculateCenter(this.posA, this.posB); - - var scale = this.options.scale; - var delta = scale * (currDist - this._previousDistance); - var velocity = delta / diffTime; - - this._previousDistance = currDist; - this._displacement += delta; - - this._eventOutput.emit('update', { - delta : delta, - velocity: velocity, - distance: currDist, - displacement: this._displacement, - center: center, - touches: [this.touchAId, this.touchBId] - }); - }; - - /** - * Return entire options dictionary, including defaults. - * - * @method getOptions - * @return {Object} configuration options - */ - PinchSync.prototype.getOptions = function getOptions() { - return this.options; - }; - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param {Object} [options] overrides of default options - * @param {Number} [options.scale] scale velocity by this factor - */ - PinchSync.prototype.setOptions = function setOptions(options) { - if (options.scale !== undefined) this.options.scale = options.scale; - }; - - module.exports = PinchSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/RotateSync',['require','exports','module','./TwoFingerSync'],function(require, exports, module) { - var TwoFingerSync = require('./TwoFingerSync'); - - /** - * Handles piped in two-finger touch events to increase or decrease scale via pinching / expanding. - * Emits 'start', 'update' and 'end' events an object with position, velocity, touch ids, and angle. - * Useful for determining a rotation factor from initial two-finger touch. - * - * @class RotateSync - * @extends TwoFingerSync - * @constructor - * @param {Object} options default options overrides - * @param {Number} [options.scale] scale velocity by this factor - */ - function RotateSync(options) { - TwoFingerSync.call(this); - - this.options = Object.create(RotateSync.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._angle = 0; - this._previousAngle = 0; - } - - RotateSync.prototype = Object.create(TwoFingerSync.prototype); - RotateSync.prototype.constructor = RotateSync; - - RotateSync.DEFAULT_OPTIONS = { - scale : 1 - }; - - RotateSync.prototype._startUpdate = function _startUpdate(event) { - this._angle = 0; - this._previousAngle = TwoFingerSync.calculateAngle(this.posA, this.posB); - var center = TwoFingerSync.calculateCenter(this.posA, this.posB); - this._eventOutput.emit('start', { - count: event.touches.length, - angle: this._angle, - center: center, - touches: [this.touchAId, this.touchBId] - }); - }; - - RotateSync.prototype._moveUpdate = function _moveUpdate(diffTime) { - var scale = this.options.scale; - - var currAngle = TwoFingerSync.calculateAngle(this.posA, this.posB); - var center = TwoFingerSync.calculateCenter(this.posA, this.posB); - - var diffTheta = scale * (currAngle - this._previousAngle); - var velTheta = diffTheta / diffTime; - - this._angle += diffTheta; - - this._eventOutput.emit('update', { - delta : diffTheta, - velocity: velTheta, - angle: this._angle, - center: center, - touches: [this.touchAId, this.touchBId] - }); - - this._previousAngle = currAngle; - }; - - /** - * Return entire options dictionary, including defaults. - * - * @method getOptions - * @return {Object} configuration options - */ - RotateSync.prototype.getOptions = function getOptions() { - return this.options; - }; - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param {Object} [options] overrides of default options - * @param {Number} [options.scale] scale velocity by this factor - */ - RotateSync.prototype.setOptions = function setOptions(options) { - if (options.scale !== undefined) this.options.scale = options.scale; - }; - - module.exports = RotateSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/ScaleSync',['require','exports','module','./TwoFingerSync'],function(require, exports, module) { - var TwoFingerSync = require('./TwoFingerSync'); - - /** - * Handles piped in two-finger touch events to increase or decrease scale via pinching / expanding. - * Emits 'start', 'update' and 'end' events an object with position, velocity, touch ids, distance, and scale factor. - * Useful for determining a scaling factor from initial two-finger touch. - * - * @class ScaleSync - * @extends TwoFingerSync - * @constructor - * @param {Object} options default options overrides - * @param {Number} [options.scale] scale velocity by this factor - */ - function ScaleSync(options) { - TwoFingerSync.call(this); - - this.options = Object.create(ScaleSync.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._scaleFactor = 1; - this._startDist = 0; - this._eventInput.on('pipe', _reset.bind(this)); - } - - ScaleSync.prototype = Object.create(TwoFingerSync.prototype); - ScaleSync.prototype.constructor = ScaleSync; - - ScaleSync.DEFAULT_OPTIONS = { - scale : 1 - }; - - function _reset() { - this.touchAId = undefined; - this.touchBId = undefined; - } - - // handles initial touch of two fingers - ScaleSync.prototype._startUpdate = function _startUpdate(event) { - this._scaleFactor = 1; - this._startDist = TwoFingerSync.calculateDistance(this.posA, this.posB); - this._eventOutput.emit('start', { - count: event.touches.length, - touches: [this.touchAId, this.touchBId], - distance: this._startDist, - center: TwoFingerSync.calculateCenter(this.posA, this.posB) - }); - }; - - // handles movement of two fingers - ScaleSync.prototype._moveUpdate = function _moveUpdate(diffTime) { - var scale = this.options.scale; - - var currDist = TwoFingerSync.calculateDistance(this.posA, this.posB); - var center = TwoFingerSync.calculateCenter(this.posA, this.posB); - - var delta = (currDist - this._startDist) / this._startDist; - var newScaleFactor = Math.max(1 + scale * delta, 0); - var veloScale = (newScaleFactor - this._scaleFactor) / diffTime; - - this._eventOutput.emit('update', { - delta : delta, - scale: newScaleFactor, - velocity: veloScale, - distance: currDist, - center : center, - touches: [this.touchAId, this.touchBId] - }); - - this._scaleFactor = newScaleFactor; - }; - - /** - * Return entire options dictionary, including defaults. - * - * @method getOptions - * @return {Object} configuration options - */ - ScaleSync.prototype.getOptions = function getOptions() { - return this.options; - }; - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param {Object} [options] overrides of default options - * @param {Number} [options.scale] scale velocity by this factor - */ - ScaleSync.prototype.setOptions = function setOptions(options) { - if (options.scale !== undefined) this.options.scale = options.scale; - }; - - module.exports = ScaleSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/inputs/ScrollSync',['require','exports','module','famous/core/EventHandler','famous/core/Engine'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - var Engine = require('famous/core/Engine'); - - /** - * Handles piped in mousewheel events. - * Emits 'start', 'update', and 'end' events with payloads including: - * delta: change since last position, - * position: accumulated deltas, - * velocity: speed of change in pixels per ms, - * slip: true (unused). - * - * Can be used as delegate of GenericSync. - * - * @class ScrollSync - * @constructor - * @param {Object} [options] overrides of default options - * @param {Number} [options.direction] Pay attention to x changes (ScrollSync.DIRECTION_X), - * y changes (ScrollSync.DIRECTION_Y) or both (undefined) - * @param {Number} [options.minimumEndSpeed] End speed calculation floors at this number, in pixels per ms - * @param {boolean} [options.rails] whether to snap position calculations to nearest axis - * @param {Number | Array.Number} [options.scale] scale outputs in by scalar or pair of scalars - * @param {Number} [options.stallTime] reset time for velocity calculation in ms - */ - function ScrollSync(options) { - this.options = Object.create(ScrollSync.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - this._payload = { - delta : null, - position : null, - velocity : null, - slip : true - }; - - this._eventInput = new EventHandler(); - this._eventOutput = new EventHandler(); - - EventHandler.setInputHandler(this, this._eventInput); - EventHandler.setOutputHandler(this, this._eventOutput); - - this._position = (this.options.direction === undefined) ? [0,0] : 0; - this._prevTime = undefined; - this._prevVel = undefined; - this._eventInput.on('mousewheel', _handleMove.bind(this)); - this._eventInput.on('wheel', _handleMove.bind(this)); - this._inProgress = false; - this._loopBound = false; - } - - ScrollSync.DEFAULT_OPTIONS = { - direction: undefined, - minimumEndSpeed: Infinity, - rails: false, - scale: 1, - stallTime: 50, - lineHeight: 40 - }; - - ScrollSync.DIRECTION_X = 0; - ScrollSync.DIRECTION_Y = 1; - - var MINIMUM_TICK_TIME = 8; - - var _now = Date.now; - - function _newFrame() { - if (this._inProgress && (_now() - this._prevTime) > this.options.stallTime) { - this._position = (this.options.direction === undefined) ? [0,0] : 0; - this._inProgress = false; - - var finalVel = (Math.abs(this._prevVel) >= this.options.minimumEndSpeed) - ? this._prevVel - : 0; - - var payload = this._payload; - payload.position = this._position; - payload.velocity = finalVel; - payload.slip = true; - - this._eventOutput.emit('end', payload); - } - } - - function _handleMove(event) { - event.preventDefault(); - - if (!this._inProgress) { - this._inProgress = true; - - payload = this._payload; - payload.slip = true; - payload.position = this._position; - payload.clientX = event.clientX; - payload.clientY = event.clientY; - payload.offsetX = event.offsetX; - payload.offsetY = event.offsetY; - this._eventOutput.emit('start', payload); - if (!this._loopBound) { - Engine.on('prerender', _newFrame.bind(this)); - this._loopBound = true; - } - } - - var currTime = _now(); - var prevTime = this._prevTime || currTime; - - var diffX = (event.wheelDeltaX !== undefined) ? event.wheelDeltaX : -event.deltaX; - var diffY = (event.wheelDeltaY !== undefined) ? event.wheelDeltaY : -event.deltaY; - - if (event.deltaMode === 1) { // units in lines, not pixels - diffX *= this.options.lineHeight; - diffY *= this.options.lineHeight; - } - - if (this.options.rails) { - if (Math.abs(diffX) > Math.abs(diffY)) diffY = 0; - else diffX = 0; - } - - var diffTime = Math.max(currTime - prevTime, MINIMUM_TICK_TIME); // minimum tick time - - var velX = diffX / diffTime; - var velY = diffY / diffTime; - - var scale = this.options.scale; - var nextVel; - var nextDelta; - - if (this.options.direction === ScrollSync.DIRECTION_X) { - nextDelta = scale * diffX; - nextVel = scale * velX; - this._position += nextDelta; - } - else if (this.options.direction === ScrollSync.DIRECTION_Y) { - nextDelta = scale * diffY; - nextVel = scale * velY; - this._position += nextDelta; - } - else { - nextDelta = [scale * diffX, scale * diffY]; - nextVel = [scale * velX, scale * velY]; - this._position[0] += nextDelta[0]; - this._position[1] += nextDelta[1]; - } - - var payload = this._payload; - payload.delta = nextDelta; - payload.velocity = nextVel; - payload.position = this._position; - payload.slip = true; - - this._eventOutput.emit('update', payload); - - this._prevTime = currTime; - this._prevVel = nextVel; - } - - /** - * Return entire options dictionary, including defaults. - * - * @method getOptions - * @return {Object} configuration options - */ - ScrollSync.prototype.getOptions = function getOptions() { - return this.options; - }; - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param {Object} [options] overrides of default options - * @param {Number} [options.minimimEndSpeed] If final velocity smaller than this, round down to 0. - * @param {Number} [options.stallTime] ms of non-motion before 'end' emitted - * @param {Number} [options.rails] whether to constrain to nearest axis. - * @param {Number} [options.direction] ScrollSync.DIRECTION_X, DIRECTION_Y - - * pay attention to one specific direction. - * @param {Number} [options.scale] constant factor to scale velocity output - */ - ScrollSync.prototype.setOptions = function setOptions(options) { - if (options.direction !== undefined) this.options.direction = options.direction; - if (options.minimumEndSpeed !== undefined) this.options.minimumEndSpeed = options.minimumEndSpeed; - if (options.rails !== undefined) this.options.rails = options.rails; - if (options.scale !== undefined) this.options.scale = options.scale; - if (options.stallTime !== undefined) this.options.stallTime = options.stallTime; - }; - - module.exports = ScrollSync; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/transitions/CachedMap',['require','exports','module'],function(require, exports, module) { - /** - * A simple in-memory object cache. Used as a helper for Views with - * provider functions. - * @class CachedMap - * @constructor - */ - function CachedMap(mappingFunction) { - this._map = mappingFunction || null; - this._cachedOutput = null; - this._cachedInput = Number.NaN; //never valid as input - } - - /** - * Creates a mapping function with a cache. - * This is the main entrypoint for this object. - * @static - * @method create - * @param {function} mappingFunction mapping - * @return {function} memoized mapping function - */ - CachedMap.create = function create(mappingFunction) { - var instance = new CachedMap(mappingFunction); - return instance.get.bind(instance); - }; - - /** - * Retrieve items from cache or from mapping functin. - * - * @method get - * @param {Object} input input key - */ - CachedMap.prototype.get = function get(input) { - if (input !== this._cachedInput) { - this._cachedInput = input; - this._cachedOutput = this._map(input); - } - return this._cachedOutput; - }; - - module.exports = CachedMap; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/transitions/Easing',['require','exports','module'],function(require, exports, module) { - - /* - * A library of curves which map an animation explicitly as a function of time. - * - * @class Easing - */ - var Easing = { - - /** - * @property inQuad - * @static - */ - inQuad: function(t) { - return t*t; - }, - - /** - * @property outQuad - * @static - */ - outQuad: function(t) { - return -(t-=1)*t+1; - }, - - /** - * @property inOutQuad - * @static - */ - inOutQuad: function(t) { - if ((t/=.5) < 1) return .5*t*t; - return -.5*((--t)*(t-2) - 1); - }, - - /** - * @property inCubic - * @static - */ - inCubic: function(t) { - return t*t*t; - }, - - /** - * @property outCubic - * @static - */ - outCubic: function(t) { - return ((--t)*t*t + 1); - }, - - /** - * @property inOutCubic - * @static - */ - inOutCubic: function(t) { - if ((t/=.5) < 1) return .5*t*t*t; - return .5*((t-=2)*t*t + 2); - }, - - /** - * @property inQuart - * @static - */ - inQuart: function(t) { - return t*t*t*t; - }, - - /** - * @property outQuart - * @static - */ - outQuart: function(t) { - return -((--t)*t*t*t - 1); - }, - - /** - * @property inOutQuart - * @static - */ - inOutQuart: function(t) { - if ((t/=.5) < 1) return .5*t*t*t*t; - return -.5 * ((t-=2)*t*t*t - 2); - }, - - /** - * @property inQuint - * @static - */ - inQuint: function(t) { - return t*t*t*t*t; - }, - - /** - * @property outQuint - * @static - */ - outQuint: function(t) { - return ((--t)*t*t*t*t + 1); - }, - - /** - * @property inOutQuint - * @static - */ - inOutQuint: function(t) { - if ((t/=.5) < 1) return .5*t*t*t*t*t; - return .5*((t-=2)*t*t*t*t + 2); - }, - - /** - * @property inSine - * @static - */ - inSine: function(t) { - return -1.0*Math.cos(t * (Math.PI/2)) + 1.0; - }, - - /** - * @property outSine - * @static - */ - outSine: function(t) { - return Math.sin(t * (Math.PI/2)); - }, - - /** - * @property inOutSine - * @static - */ - inOutSine: function(t) { - return -.5*(Math.cos(Math.PI*t) - 1); - }, - - /** - * @property inExpo - * @static - */ - inExpo: function(t) { - return (t===0) ? 0.0 : Math.pow(2, 10 * (t - 1)); - }, - - /** - * @property outExpo - * @static - */ - outExpo: function(t) { - return (t===1.0) ? 1.0 : (-Math.pow(2, -10 * t) + 1); - }, - - /** - * @property inOutExpo - * @static - */ - inOutExpo: function(t) { - if (t===0) return 0.0; - if (t===1.0) return 1.0; - if ((t/=.5) < 1) return .5 * Math.pow(2, 10 * (t - 1)); - return .5 * (-Math.pow(2, -10 * --t) + 2); - }, - - /** - * @property inCirc - * @static - */ - inCirc: function(t) { - return -(Math.sqrt(1 - t*t) - 1); - }, - - /** - * @property outCirc - * @static - */ - outCirc: function(t) { - return Math.sqrt(1 - (--t)*t); - }, - - /** - * @property inOutCirc - * @static - */ - inOutCirc: function(t) { - if ((t/=.5) < 1) return -.5 * (Math.sqrt(1 - t*t) - 1); - return .5 * (Math.sqrt(1 - (t-=2)*t) + 1); - }, - - /** - * @property inElastic - * @static - */ - inElastic: function(t) { - var s=1.70158;var p=0;var a=1.0; - if (t===0) return 0.0; if (t===1) return 1.0; if (!p) p=.3; - s = p/(2*Math.PI) * Math.asin(1.0/a); - return -(a*Math.pow(2,10*(t-=1)) * Math.sin((t-s)*(2*Math.PI)/ p)); - }, - - /** - * @property outElastic - * @static - */ - outElastic: function(t) { - var s=1.70158;var p=0;var a=1.0; - if (t===0) return 0.0; if (t===1) return 1.0; if (!p) p=.3; - s = p/(2*Math.PI) * Math.asin(1.0/a); - return a*Math.pow(2,-10*t) * Math.sin((t-s)*(2*Math.PI)/p) + 1.0; - }, - - /** - * @property inOutElastic - * @static - */ - inOutElastic: function(t) { - var s=1.70158;var p=0;var a=1.0; - if (t===0) return 0.0; if ((t/=.5)===2) return 1.0; if (!p) p=(.3*1.5); - s = p/(2*Math.PI) * Math.asin(1.0/a); - if (t < 1) return -.5*(a*Math.pow(2,10*(t-=1)) * Math.sin((t-s)*(2*Math.PI)/p)); - return a*Math.pow(2,-10*(t-=1)) * Math.sin((t-s)*(2*Math.PI)/p)*.5 + 1.0; - }, - - /** - * @property inBack - * @static - */ - inBack: function(t, s) { - if (s === undefined) s = 1.70158; - return t*t*((s+1)*t - s); - }, - - /** - * @property outBack - * @static - */ - outBack: function(t, s) { - if (s === undefined) s = 1.70158; - return ((--t)*t*((s+1)*t + s) + 1); - }, - - /** - * @property inOutBack - * @static - */ - inOutBack: function(t, s) { - if (s === undefined) s = 1.70158; - if ((t/=.5) < 1) return .5*(t*t*(((s*=(1.525))+1)*t - s)); - return .5*((t-=2)*t*(((s*=(1.525))+1)*t + s) + 2); - }, - - /** - * @property inBounce - * @static - */ - inBounce: function(t) { - return 1.0 - Easing.outBounce(1.0-t); - }, - - /** - * @property outBounce - * @static - */ - outBounce: function(t) { - if (t < (1/2.75)) { - return (7.5625*t*t); - } else if (t < (2/2.75)) { - return (7.5625*(t-=(1.5/2.75))*t + .75); - } else if (t < (2.5/2.75)) { - return (7.5625*(t-=(2.25/2.75))*t + .9375); - } else { - return (7.5625*(t-=(2.625/2.75))*t + .984375); - } - }, - - /** - * @property inOutBounce - * @static - */ - inOutBounce: function(t) { - if (t < .5) return Easing.inBounce(t*2) * .5; - return Easing.outBounce(t*2-1.0) * .5 + .5; - } - }; - - module.exports = Easing; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/physics/integrators/SymplecticEuler',['require','exports','module','famous/core/OptionsManager'],function(require, exports, module) { - var OptionsManager = require('famous/core/OptionsManager'); - - /** - * Ordinary Differential Equation (ODE) Integrator. - * Manages updating a physics body's state over time. - * - * p = position, v = velocity, m = mass, f = force, dt = change in time - * - * v <- v + dt * f / m - * p <- p + dt * v - * - * q = orientation, w = angular velocity, L = angular momentum - * - * L <- L + dt * t - * q <- q + dt/2 * q * w - * - * @class SymplecticEuler - * @constructor - * @param {Object} options Options to set - */ - function SymplecticEuler(options) { - this.options = Object.create(SymplecticEuler.DEFAULT_OPTIONS); - this._optionsManager = new OptionsManager(this.options); - - if (options) this.setOptions(options); - } - - /** - * @property SymplecticEuler.DEFAULT_OPTIONS - * @type Object - * @protected - * @static - */ - SymplecticEuler.DEFAULT_OPTIONS = { - - /** - * The maximum velocity of a physics body - * Range : [0, Infinity] - * @attribute velocityCap - * @type Number - */ - - velocityCap : undefined, - - /** - * The maximum angular velocity of a physics body - * Range : [0, Infinity] - * @attribute angularVelocityCap - * @type Number - */ - angularVelocityCap : undefined - }; - - /* - * Setter for options - * - * @method setOptions - * @param {Object} options - */ - SymplecticEuler.prototype.setOptions = function setOptions(options) { - this._optionsManager.patch(options); - }; - - /* - * Getter for options - * - * @method getOptions - * @return {Object} options - */ - SymplecticEuler.prototype.getOptions = function getOptions() { - return this._optionsManager.value(); - }; - - /* - * Updates the velocity of a physics body from its accumulated force. - * v <- v + dt * f / m - * - * @method integrateVelocity - * @param {Body} physics body - * @param {Number} dt delta time - */ - SymplecticEuler.prototype.integrateVelocity = function integrateVelocity(body, dt) { - var v = body.velocity; - var w = body.inverseMass; - var f = body.force; - - if (f.isZero()) return; - - v.add(f.mult(dt * w)).put(v); - f.clear(); - }; - - /* - * Updates the position of a physics body from its velocity. - * p <- p + dt * v - * - * @method integratePosition - * @param {Body} physics body - * @param {Number} dt delta time - */ - SymplecticEuler.prototype.integratePosition = function integratePosition(body, dt) { - var p = body.position; - var v = body.velocity; - - if (this.options.velocityCap) v.cap(this.options.velocityCap).put(v); - p.add(v.mult(dt)).put(p); - }; - - /* - * Updates the angular momentum of a physics body from its accumuled torque. - * L <- L + dt * t - * - * @method integrateAngularMomentum - * @param {Body} physics body (except a particle) - * @param {Number} dt delta time - */ - SymplecticEuler.prototype.integrateAngularMomentum = function integrateAngularMomentum(body, dt) { - var L = body.angularMomentum; - var t = body.torque; - - if (t.isZero()) return; - - if (this.options.angularVelocityCap) t.cap(this.options.angularVelocityCap).put(t); - L.add(t.mult(dt)).put(L); - t.clear(); - }; - - /* - * Updates the orientation of a physics body from its angular velocity. - * q <- q + dt/2 * q * w - * - * @method integrateOrientation - * @param {Body} physics body (except a particle) - * @param {Number} dt delta time - */ - SymplecticEuler.prototype.integrateOrientation = function integrateOrientation(body, dt) { - var q = body.orientation; - var w = body.angularVelocity; - - if (w.isZero()) return; - q.add(q.multiply(w).scalarMultiply(0.5 * dt)).put(q); -// q.normalize.put(q); - }; - - module.exports = SymplecticEuler; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/physics/bodies/Particle',['require','exports','module','famous/math/Vector','famous/core/Transform','famous/core/EventHandler','../integrators/SymplecticEuler'],function(require, exports, module) { - var Vector = require('famous/math/Vector'); - var Transform = require('famous/core/Transform'); - var EventHandler = require('famous/core/EventHandler'); - var Integrator = require('../integrators/SymplecticEuler'); - - /** - * A point body that is controlled by the Physics Engine. A particle has - * position and velocity states that are updated by the Physics Engine. - * Ultimately, a particle is a _special type of modifier, and can be added to - * the Famous render tree like any other modifier. - * - * @constructor - * @class Particle - * @uses EventHandler - * @uses Modifier - * @extensionfor Body - * @param {Options} [options] An object of configurable options. - * @param {Array} [options.position] The position of the particle. - * @param {Array} [options.velocity] The velocity of the particle. - * @param {Number} [options.mass] The mass of the particle. - * @param {Hexadecimal} [options.axis] The axis a particle can move along. Can be bitwise ORed e.g., Particle.AXES.X, Particle.AXES.X | Particle.AXES.Y - * - */ - function Particle(options) { - options = options || {}; - - // registers - this.position = new Vector(); - this.velocity = new Vector(); - this.force = new Vector(); - - var defaults = Particle.DEFAULT_OPTIONS; - - // set vectors - this.setPosition(options.position || defaults.position); - this.setVelocity(options.velocity || defaults.velocity); - this.force.set(options.force || [0,0,0]); - - // set scalars - this.mass = (options.mass !== undefined) - ? options.mass - : defaults.mass; - - this.axis = (options.axis !== undefined) - ? options.axis - : defaults.axis; - - this.inverseMass = 1 / this.mass; - - // state variables - this._isSleeping = false; - this._engine = null; - this._eventOutput = null; - this._positionGetter = null; - - this.transform = Transform.identity.slice(); - - // cached _spec - this._spec = { - transform : this.transform, - target : null - }; - } - - Particle.DEFAULT_OPTIONS = { - position : [0,0,0], - velocity : [0,0,0], - mass : 1, - axis : undefined - }; - - /** - * Kinetic energy threshold needed to update the body - * - * @property SLEEP_TOLERANCE - * @type Number - * @static - * @default 1e-7 - */ - Particle.SLEEP_TOLERANCE = 1e-7; - - /** - * Axes by which a body can translate - * - * @property AXES - * @type Hexadecimal - * @static - * @default 1e-7 - */ - Particle.AXES = { - X : 0x00, // hexadecimal for 0 - Y : 0x01, // hexadecimal for 1 - Z : 0x02 // hexadecimal for 2 - }; - - // Integrator for updating the particle's state - // TODO: make this a singleton - Particle.INTEGRATOR = new Integrator(); - - //Catalogue of outputted events - var _events = { - start : 'start', - update : 'update', - end : 'end' - }; - - // Cached timing function - var now = (function() { - return Date.now; - })(); - - /** - * Stops the particle from updating - * @method sleep - */ - Particle.prototype.sleep = function sleep() { - if (this._isSleeping) return; - this.emit(_events.end, this); - this._isSleeping = true; - }; - - /** - * Starts the particle update - * @method wake - */ - Particle.prototype.wake = function wake() { - if (!this._isSleeping) return; - this.emit(_events.start, this); - this._isSleeping = false; - this._prevTime = now(); - }; - - /** - * @attribute isBody - * @type Boolean - * @static - */ - Particle.prototype.isBody = false; - - /** - * Basic setter for position - * @method getPosition - * @param position {Array|Vector} - */ - Particle.prototype.setPosition = function setPosition(position) { - this.position.set(position); - }; - - /** - * 1-dimensional setter for position - * @method setPosition1D - * @param value {Number} - */ - Particle.prototype.setPosition1D = function setPosition1D(x) { - this.position.x = x; - }; - - /** - * Basic getter function for position - * @method getPosition - * @return position {Array} - */ - Particle.prototype.getPosition = function getPosition() { - if (this._positionGetter instanceof Function) - this.setPosition(this._positionGetter()); - - this._engine.step(); - - return this.position.get(); - }; - - /** - * 1-dimensional getter for position - * @method getPosition1D - * @return value {Number} - */ - Particle.prototype.getPosition1D = function getPosition1D() { - this._engine.step(); - return this.position.x; - }; - - /** - * Defines the position from outside the Physics Engine - * @method positionFrom - * @param positionGetter {Function} - */ - Particle.prototype.positionFrom = function positionFrom(positionGetter) { - this._positionGetter = positionGetter; - }; - - /** - * Basic setter function for velocity Vector - * @method setVelocity - * @function - */ - Particle.prototype.setVelocity = function setVelocity(velocity) { - this.velocity.set(velocity); - this.wake(); - }; - - /** - * 1-dimensional setter for velocity - * @method setVelocity1D - * @param velocity {Number} - */ - Particle.prototype.setVelocity1D = function setVelocity1D(x) { - this.velocity.x = x; - this.wake(); - }; - - /** - * Basic getter function for velocity Vector - * @method getVelocity - * @return velocity {Array} - */ - Particle.prototype.getVelocity = function getVelocity() { - return this.velocity.get(); - }; - - /** - * 1-dimensional getter for velocity - * @method getVelocity1D - * @return velocity {Number} - */ - Particle.prototype.getVelocity1D = function getVelocity1D() { - return this.velocity.x; - }; - - /** - * Basic setter function for mass quantity - * @method setMass - * @param mass {Number} mass - */ - Particle.prototype.setMass = function setMass(mass) { - this.mass = mass; - this.inverseMass = 1 / mass; - }; - - /** - * Basic getter function for mass quantity - * @method getMass - * @return mass {Number} - */ - Particle.prototype.getMass = function getMass() { - return this.mass; - }; - - /** - * Reset position and velocity - * @method reset - * @param position {Array|Vector} - * @param velocity {Array|Vector} - */ - Particle.prototype.reset = function reset(position, velocity) { - this.setPosition(position || [0,0,0]); - this.setVelocity(velocity || [0,0,0]); - }; - - /** - * Add force vector to existing internal force Vector - * @method applyForce - * @param force {Vector} - */ - Particle.prototype.applyForce = function applyForce(force) { - if (force.isZero()) return; - this.force.add(force).put(this.force); - this.wake(); - }; - - /** - * Add impulse (change in velocity) Vector to this Vector's velocity. - * @method applyImpulse - * @param impulse {Vector} - */ - Particle.prototype.applyImpulse = function applyImpulse(impulse) { - if (impulse.isZero()) return; - var velocity = this.velocity; - velocity.add(impulse.mult(this.inverseMass)).put(velocity); - }; - - /** - * Update a particle's velocity from its force accumulator - * @method integrateVelocity - * @param dt {Number} Time differential - */ - Particle.prototype.integrateVelocity = function integrateVelocity(dt) { - Particle.INTEGRATOR.integrateVelocity(this, dt); - }; - - /** - * Update a particle's position from its velocity - * @method integratePosition - * @param dt {Number} Time differential - */ - Particle.prototype.integratePosition = function integratePosition(dt) { - Particle.INTEGRATOR.integratePosition(this, dt); - }; - - /** - * Update the position and velocity of the particle - * @method _integrate - * @protected - * @param dt {Number} Time differential - */ - Particle.prototype._integrate = function _integrate(dt) { - this.integrateVelocity(dt); - this.integratePosition(dt); - }; - - /** - * Get kinetic energy of the particle. - * @method getEnergy - * @function - */ - Particle.prototype.getEnergy = function getEnergy() { - return 0.5 * this.mass * this.velocity.normSquared(); - }; - - /** - * Generate transform from the current position state - * @method getTransform - * @return Transform {Transform} - */ - Particle.prototype.getTransform = function getTransform() { - this._engine.step(); - - var position = this.position; - var axis = this.axis; - var transform = this.transform; - - if (axis !== undefined) { - if (axis & ~Particle.AXES.X) { - position.x = 0; - } - if (axis & ~Particle.AXES.Y) { - position.y = 0; - } - if (axis & ~Particle.AXES.Z) { - position.z = 0; - } - } - - transform[12] = position.x; - transform[13] = position.y; - transform[14] = position.z; - - return transform; - }; - - /** - * The modify interface of a Modifier - * @method modify - * @param target {Spec} - * @return Spec {Spec} - */ - Particle.prototype.modify = function modify(target) { - var _spec = this._spec; - _spec.transform = this.getTransform(); - _spec.target = target; - return _spec; - }; - - // private - function _createEventOutput() { - this._eventOutput = new EventHandler(); - this._eventOutput.bindThis(this); - //overrides on/removeListener/pipe/unpipe methods - EventHandler.setOutputHandler(this, this._eventOutput); - } - - Particle.prototype.emit = function emit(type, data) { - if (!this._eventOutput) return; - this._eventOutput.emit(type, data); - }; - - Particle.prototype.on = function on() { - _createEventOutput.call(this); - return this.on.apply(this, arguments); - }; - Particle.prototype.removeListener = function removeListener() { - _createEventOutput.call(this); - return this.removeListener.apply(this, arguments); - }; - Particle.prototype.pipe = function pipe() { - _createEventOutput.call(this); - return this.pipe.apply(this, arguments); - }; - Particle.prototype.unpipe = function unpipe() { - _createEventOutput.call(this); - return this.unpipe.apply(this, arguments); - }; - - module.exports = Particle; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/physics/constraints/Constraint',['require','exports','module','famous/core/EventHandler'],function(require, exports, module) { - var EventHandler = require('famous/core/EventHandler'); - - /** - * Allows for two circular bodies to collide and bounce off each other. - * - * @class Constraint - * @constructor - * @uses EventHandler - * @param options {Object} - */ - function Constraint() { - this.options = this.options || {}; - this._energy = 0.0; - this._eventOutput = null; - } - - /* - * Setter for options. - * - * @method setOptions - * @param options {Objects} - */ - Constraint.prototype.setOptions = function setOptions(options) { - for (var key in options) this.options[key] = options[key]; - }; - - /** - * Adds an impulse to a physics body's velocity due to the constraint - * - * @method applyConstraint - */ - Constraint.prototype.applyConstraint = function applyConstraint() {}; - - /** - * Getter for energy - * - * @method getEnergy - * @return energy {Number} - */ - Constraint.prototype.getEnergy = function getEnergy() { - return this._energy; - }; - - /** - * Setter for energy - * - * @method setEnergy - * @param energy {Number} - */ - Constraint.prototype.setEnergy = function setEnergy(energy) { - this._energy = energy; - }; - - function _createEventOutput() { - this._eventOutput = new EventHandler(); - this._eventOutput.bindThis(this); - EventHandler.setOutputHandler(this, this._eventOutput); - } - - Constraint.prototype.on = function on() { - _createEventOutput.call(this); - return this.on.apply(this, arguments); - }; - Constraint.prototype.addListener = function addListener() { - _createEventOutput.call(this); - return this.addListener.apply(this, arguments); - }; - Constraint.prototype.pipe = function pipe() { - _createEventOutput.call(this); - return this.pipe.apply(this, arguments); - }; - Constraint.prototype.removeListener = function removeListener() { - return this.removeListener.apply(this, arguments); - }; - Constraint.prototype.unpipe = function unpipe() { - return this.unpipe.apply(this, arguments); - }; - - module.exports = Constraint; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/physics/constraints/Snap',['require','exports','module','./Constraint','famous/math/Vector'],function(require, exports, module) { - var Constraint = require('./Constraint'); - var Vector = require('famous/math/Vector'); - - /** - * A spring constraint is like a spring force, except that it is always - * numerically stable (even for low periods), at the expense of introducing - * damping (even with dampingRatio set to 0). - * - * Use this if you need fast spring-like behavior, e.g., snapping - * - * @class Snap - * @constructor - * @extends Constraint - * @param {Options} [options] An object of configurable options. - * @param {Number} [options.period] The amount of time in milliseconds taken for one complete oscillation when there is no damping. Range : [150, Infinity] - * @param {Number} [options.dampingRatio] Additional damping of the spring. Range : [0, 1]. At 0 this spring will still be damped, at 1 the spring will be critically damped (the spring will never oscillate) - * @param {Number} [options.length] The rest length of the spring. Range: [0, Infinity]. - * @param {Array} [options.anchor] The location of the spring's anchor, if not another physics body. - * - */ - function Snap(options) { - this.options = Object.create(this.constructor.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - //registers - this.pDiff = new Vector(); - this.vDiff = new Vector(); - this.impulse1 = new Vector(); - this.impulse2 = new Vector(); - - Constraint.call(this); - } - - Snap.prototype = Object.create(Constraint.prototype); - Snap.prototype.constructor = Snap; - - Snap.DEFAULT_OPTIONS = { - period : 300, - dampingRatio : 0.1, - length : 0, - anchor : undefined - }; - - /** const */ var pi = Math.PI; - - function _calcEnergy(impulse, disp, dt) { - return Math.abs(impulse.dot(disp)/dt); - } - - /** - * Basic options setter - * - * @method setOptions - * @param options {Objects} options - */ - Snap.prototype.setOptions = function setOptions(options) { - if (options.anchor !== undefined) { - if (options.anchor instanceof Vector) this.options.anchor = options.anchor; - if (options.anchor.position instanceof Vector) this.options.anchor = options.anchor.position; - if (options.anchor instanceof Array) this.options.anchor = new Vector(options.anchor); - } - if (options.length !== undefined) this.options.length = options.length; - if (options.dampingRatio !== undefined) this.options.dampingRatio = options.dampingRatio; - if (options.period !== undefined) this.options.period = options.period; - }; - - /** - * Set the anchor position - * - * @method setOptions - * @param {Array} v TODO - */ - - Snap.prototype.setAnchor = function setAnchor(v) { - if (this.options.anchor !== undefined) this.options.anchor = new Vector(); - this.options.anchor.set(v); - }; - - /** - * Calculates energy of spring - * - * @method getEnergy - * @param {Object} target TODO - * @param {Object} source TODO - * @return energy {Number} - */ - Snap.prototype.getEnergy = function getEnergy(target, source) { - var options = this.options; - var restLength = options.length; - var anchor = options.anchor || source.position; - var strength = Math.pow(2 * pi / options.period, 2); - - var dist = anchor.sub(target.position).norm() - restLength; - - return 0.5 * strength * dist * dist; - }; - - /** - * Adds a spring impulse to a physics body's velocity due to the constraint - * - * @method applyConstraint - * @param targets {Array.Body} Array of bodies to apply the constraint to - * @param source {Body} The source of the constraint - * @param dt {Number} Delta time - */ - Snap.prototype.applyConstraint = function applyConstraint(targets, source, dt) { - var options = this.options; - var pDiff = this.pDiff; - var vDiff = this.vDiff; - var impulse1 = this.impulse1; - var impulse2 = this.impulse2; - var length = options.length; - var anchor = options.anchor || source.position; - var period = options.period; - var dampingRatio = options.dampingRatio; - - for (var i = 0; i < targets.length ; i++) { - var target = targets[i]; - - var p1 = target.position; - var v1 = target.velocity; - var m1 = target.mass; - var w1 = target.inverseMass; - - pDiff.set(p1.sub(anchor)); - var dist = pDiff.norm() - length; - var effMass; - - if (source) { - var w2 = source.inverseMass; - var v2 = source.velocity; - vDiff.set(v1.sub(v2)); - effMass = 1/(w1 + w2); - } - else { - vDiff.set(v1); - effMass = m1; - } - - var gamma; - var beta; - - if (this.options.period === 0) { - gamma = 0; - beta = 1; - } - else { - var k = 4 * effMass * pi * pi / (period * period); - var c = 4 * effMass * pi * dampingRatio / period; - - beta = dt * k / (c + dt * k); - gamma = 1 / (c + dt*k); - } - - var antiDrift = beta/dt * dist; - pDiff.normalize(-antiDrift) - .sub(vDiff) - .mult(dt / (gamma + dt/effMass)) - .put(impulse1); - - // var n = new Vector(); - // n.set(pDiff.normalize()); - // var lambda = -(n.dot(vDiff) + antiDrift) / (gamma + dt/effMass); - // impulse2.set(n.mult(dt*lambda)); - - target.applyImpulse(impulse1); - - if (source) { - impulse1.mult(-1).put(impulse2); - source.applyImpulse(impulse2); - } - - this.setEnergy(_calcEnergy(impulse1, pDiff, dt)); - } - }; - - module.exports = Snap; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/transitions/SnapTransition',['require','exports','module','famous/physics/PhysicsEngine','famous/physics/bodies/Particle','famous/physics/constraints/Snap','famous/math/Vector'],function(require, exports, module) { - var PE = require('famous/physics/PhysicsEngine'); - var Particle = require('famous/physics/bodies/Particle'); - var Spring = require('famous/physics/constraints/Snap'); - var Vector = require('famous/math/Vector'); - - /** - * SnapTransition is a method of transitioning between two values (numbers, - * or arrays of numbers). It is similar to SpringTransition except - * the transition can be much faster and always has a damping effect. - * - * @class SnapTransition - * @constructor - * - * @param [state=0] {Number|Array} Initial state - */ - function SnapTransition(state) { - state = state || 0; - - this.endState = new Vector(state); - this.initState = new Vector(); - - this._dimensions = 1; - this._restTolerance = 1e-10; - this._absRestTolerance = this._restTolerance; - this._callback = undefined; - - this.PE = new PE(); - this.particle = new Particle(); - this.spring = new Spring({anchor : this.endState}); - - this.PE.addBody(this.particle); - this.PE.attach(this.spring, this.particle); - } - - SnapTransition.SUPPORTS_MULTIPLE = 3; - - /** - * @property SnapTransition.DEFAULT_OPTIONS - * @type Object - * @protected - * @static - */ - SnapTransition.DEFAULT_OPTIONS = { - - /** - * The amount of time in milliseconds taken for one complete oscillation - * when there is no damping - * Range : [0, Infinity] - * - * @attribute period - * @type Number - * @default 100 - */ - period : 100, - - /** - * The damping of the snap. - * Range : [0, 1] - * - * @attribute dampingRatio - * @type Number - * @default 0.2 - */ - dampingRatio : 0.2, - - /** - * The initial velocity of the transition. - * - * @attribute velocity - * @type Number|Array - * @default 0 - */ - velocity : 0 - }; - - function _getEnergy() { - return this.particle.getEnergy() + this.spring.getEnergy(this.particle); - } - - function _setAbsoluteRestTolerance() { - var distance = this.endState.sub(this.initState).normSquared(); - this._absRestTolerance = (distance === 0) - ? this._restTolerance - : this._restTolerance * distance; - } - - function _setTarget(target) { - this.endState.set(target); - _setAbsoluteRestTolerance.call(this); - } - - function _wake() { - this.PE.wake(); - } - - function _sleep() { - this.PE.sleep(); - } - - function _setParticlePosition(p) { - this.particle.position.set(p); - } - - function _setParticleVelocity(v) { - this.particle.velocity.set(v); - } - - function _getParticlePosition() { - return (this._dimensions === 0) - ? this.particle.getPosition1D() - : this.particle.getPosition(); - } - - function _getParticleVelocity() { - return (this._dimensions === 0) - ? this.particle.getVelocity1D() - : this.particle.getVelocity(); - } - - function _setCallback(callback) { - this._callback = callback; - } - - function _setupDefinition(definition) { - var defaults = SnapTransition.DEFAULT_OPTIONS; - if (definition.period === undefined) definition.period = defaults.period; - if (definition.dampingRatio === undefined) definition.dampingRatio = defaults.dampingRatio; - if (definition.velocity === undefined) definition.velocity = defaults.velocity; - - //setup spring - this.spring.setOptions({ - period : definition.period, - dampingRatio : definition.dampingRatio - }); - - //setup particle - _setParticleVelocity.call(this, definition.velocity); - } - - function _update() { - if (this.PE.isSleeping()) { - if (this._callback) { - var cb = this._callback; - this._callback = undefined; - cb(); - } - return; - } - - if (_getEnergy.call(this) < this._absRestTolerance) { - _setParticlePosition.call(this, this.endState); - _setParticleVelocity.call(this, [0,0,0]); - _sleep.call(this); - } - } - - /** - * Resets the state and velocity - * - * @method reset - * - * @param state {Number|Array} State - * @param [velocity] {Number|Array} Velocity - */ - SnapTransition.prototype.reset = function reset(state, velocity) { - this._dimensions = (state instanceof Array) - ? state.length - : 0; - - this.initState.set(state); - _setParticlePosition.call(this, state); - _setTarget.call(this, state); - if (velocity) _setParticleVelocity.call(this, velocity); - _setCallback.call(this, undefined); - }; - - /** - * Getter for velocity - * - * @method getVelocity - * - * @return velocity {Number|Array} - */ - SnapTransition.prototype.getVelocity = function getVelocity() { - return _getParticleVelocity.call(this); - }; - - /** - * Setter for velocity - * - * @method setVelocity - * - * @return velocity {Number|Array} - */ - SnapTransition.prototype.setVelocity = function setVelocity(velocity) { - this.call(this, _setParticleVelocity(velocity)); - }; - - /** - * Detects whether a transition is in progress - * - * @method isActive - * - * @return {Boolean} - */ - SnapTransition.prototype.isActive = function isActive() { - return !this.PE.isSleeping(); - }; - - /** - * Halt the transition - * - * @method halt - */ - SnapTransition.prototype.halt = function halt() { - this.set(this.get()); - }; - - /** - * Get the current position of the transition -s * - * @method get - * - * @return state {Number|Array} - */ - SnapTransition.prototype.get = function get() { - _update.call(this); - return _getParticlePosition.call(this); - }; - - /** - * Set the end position and transition, with optional callback on completion. - * - * @method set - * - * @param state {Number|Array} Final state - * @param [definition] {Object} Transition definition - * @param [callback] {Function} Callback - */ - SnapTransition.prototype.set = function set(state, definition, callback) { - if (!definition) { - this.reset(state); - if (callback) callback(); - return; - } - - this._dimensions = (state instanceof Array) - ? state.length - : 0; - - _wake.call(this); - _setupDefinition.call(this, definition); - _setTarget.call(this, state); - _setCallback.call(this, callback); - }; - - module.exports = SnapTransition; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/physics/forces/Force',['require','exports','module','famous/math/Vector','famous/core/EventHandler'],function(require, exports, module) { - var Vector = require('famous/math/Vector'); - var EventHandler = require('famous/core/EventHandler'); - - /** - * Force base class. - * - * @class Force - * @uses EventHandler - * @constructor - */ - function Force(force) { - this.force = new Vector(force); - this._energy = 0.0; - this._eventOutput = null; - } - - /** - * Basic setter for options - * - * @method setOptions - * @param options {Objects} - */ - Force.prototype.setOptions = function setOptions(options) { - for (var key in options) this.options[key] = options[key]; - }; - - /** - * Adds a force to a physics body's force accumulator. - * - * @method applyForce - * @param body {Body} - */ - Force.prototype.applyForce = function applyForce(body) { - body.applyForce(this.force); - }; - - /** - * Getter for a force's potential energy. - * - * @method getEnergy - * @return energy {Number} - */ - Force.prototype.getEnergy = function getEnergy() { - return this._energy; - }; - - /* - * Setter for a force's potential energy. - * - * @method setEnergy - * @param energy {Number} - */ - Force.prototype.setEnergy = function setEnergy(energy) { - this._energy = energy; - }; - - function _createEventOutput() { - this._eventOutput = new EventHandler(); - this._eventOutput.bindThis(this); - EventHandler.setOutputHandler(this, this._eventOutput); - } - - Force.prototype.on = function on() { - _createEventOutput.call(this); - return this.on.apply(this, arguments); - }; - Force.prototype.addListener = function addListener() { - _createEventOutput.call(this); - return this.addListener.apply(this, arguments); - }; - Force.prototype.pipe = function pipe() { - _createEventOutput.call(this); - return this.pipe.apply(this, arguments); - }; - Force.prototype.removeListener = function removeListener() { - return this.removeListener.apply(this, arguments); - }; - Force.prototype.unpipe = function unpipe() { - return this.unpipe.apply(this, arguments); - }; - - module.exports = Force; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/physics/forces/Spring',['require','exports','module','./Force','famous/math/Vector'],function(require, exports, module) { - var Force = require('./Force'); - var Vector = require('famous/math/Vector'); - - /** - * A force that moves a physics body to a location with a spring motion. - * The body can be moved to another physics body, or an anchor point. - * - * @class Spring - * @constructor - * @extends Force - * @param {Object} options options to set on drag - */ - function Spring(options) { - this.options = Object.create(this.constructor.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - //registers - this.disp = new Vector(0,0,0); - - _init.call(this); - Force.call(this); - } - - Spring.prototype = Object.create(Force.prototype); - Spring.prototype.constructor = Spring; - - /** @const */ var pi = Math.PI; - - /** - * @property Spring.FORCE_FUNCTIONS - * @type Object - * @protected - * @static - */ - Spring.FORCE_FUNCTIONS = { - - /** - * A FENE (Finitely Extensible Nonlinear Elastic) spring force - * see: http://en.wikipedia.org/wiki/FENE - * @attribute FENE - * @type Function - * @param {Number} dist current distance target is from source body - * @param {Number} rMax maximum range of influence - * @return {Number} unscaled force - */ - FENE : function(dist, rMax) { - var rMaxSmall = rMax * .99; - var r = Math.max(Math.min(dist, rMaxSmall), -rMaxSmall); - return r / (1 - r * r/(rMax * rMax)); - }, - - /** - * A Hookean spring force, linear in the displacement - * see: http://en.wikipedia.org/wiki/FENE - * @attribute FENE - * @type Function - * @param {Number} dist current distance target is from source body - * @return {Number} unscaled force - */ - HOOK : function(dist) { - return dist; - } - }; - - /** - * @property Spring.DEFAULT_OPTIONS - * @type Object - * @protected - * @static - */ - Spring.DEFAULT_OPTIONS = { - - /** - * The amount of time in milliseconds taken for one complete oscillation - * when there is no damping - * Range : [150, Infinity] - * @attribute period - * @type Number - * @default 300 - */ - period : 300, - - /** - * The damping of the spring. - * Range : [0, 1] - * 0 = no damping, and the spring will oscillate forever - * 1 = critically damped (the spring will never oscillate) - * @attribute dampingRatio - * @type Number - * @default 0.1 - */ - dampingRatio : 0.1, - - /** - * The rest length of the spring - * Range : [0, Infinity] - * @attribute length - * @type Number - * @default 0 - */ - length : 0, - - /** - * The maximum length of the spring (for a FENE spring) - * Range : [0, Infinity] - * @attribute length - * @type Number - * @default Infinity - */ - maxLength : Infinity, - - /** - * The location of the spring's anchor, if not another physics body - * - * @attribute anchor - * @type Array - * @optional - */ - anchor : undefined, - - /** - * The type of spring force - * @attribute forceFunction - * @type Function - */ - forceFunction : Spring.FORCE_FUNCTIONS.HOOK - }; - - function _setForceFunction(fn) { - this.forceFunction = fn; - } - - function _calcStiffness() { - var options = this.options; - options.stiffness = Math.pow(2 * pi / options.period, 2); - } - - function _calcDamping() { - var options = this.options; - options.damping = 4 * pi * options.dampingRatio / options.period; - } - - function _calcEnergy(strength, dist) { - return 0.5 * strength * dist * dist; - } - - function _init() { - _setForceFunction.call(this, this.options.forceFunction); - _calcStiffness.call(this); - _calcDamping.call(this); - } - - /** - * Basic options setter - * - * @method setOptions - * @param options {Objects} - */ - Spring.prototype.setOptions = function setOptions(options) { - if (options.anchor !== undefined) { - if (options.anchor.position instanceof Vector) this.options.anchor = options.anchor.position; - if (options.anchor instanceof Vector) this.options.anchor = options.anchor; - if (options.anchor instanceof Array) this.options.anchor = new Vector(options.anchor); - } - if (options.period !== undefined) this.options.period = options.period; - if (options.dampingRatio !== undefined) this.options.dampingRatio = options.dampingRatio; - if (options.length !== undefined) this.options.length = options.length; - if (options.forceFunction !== undefined) this.options.forceFunction = options.forceFunction; - if (options.maxLength !== undefined) this.options.maxLength = options.maxLength; - - _init.call(this); - }; - - /** - * Adds a spring force to a physics body's force accumulator. - * - * @method applyForce - * @param targets {Array.Body} Array of bodies to apply force to. - */ - Spring.prototype.applyForce = function applyForce(targets, source) { - var force = this.force; - var disp = this.disp; - var options = this.options; - - var stiffness = options.stiffness; - var damping = options.damping; - var restLength = options.length; - var lMax = options.maxLength; - var anchor = options.anchor || source.position; - - for (var i = 0; i < targets.length; i++) { - var target = targets[i]; - var p2 = target.position; - var v2 = target.velocity; - - anchor.sub(p2).put(disp); - var dist = disp.norm() - restLength; - - if (dist === 0) return; - - //if dampingRatio specified, then override strength and damping - var m = target.mass; - stiffness *= m; - damping *= m; - - disp.normalize(stiffness * this.forceFunction(dist, lMax)) - .put(force); - - if (damping) - if (source) force.add(v2.sub(source.velocity).mult(-damping)).put(force); - else force.add(v2.mult(-damping)).put(force); - - target.applyForce(force); - if (source) source.applyForce(force.mult(-1)); - - this.setEnergy(_calcEnergy(stiffness, dist)); - } - }; - - /** - * Calculates the potential energy of the spring. - * - * @method getEnergy - * @param target {Body} The physics body attached to the spring - * @return energy {Number} - */ - Spring.prototype.getEnergy = function getEnergy(target) { - var options = this.options; - var restLength = options.length; - var anchor = options.anchor; - var strength = options.stiffness; - - var dist = anchor.sub(target.position).norm() - restLength; - return 0.5 * strength * dist * dist; - }; - - /** - * Sets the anchor to a new position - * - * @method setAnchor - * @param anchor {Array} New anchor of the spring - */ - Spring.prototype.setAnchor = function setAnchor(anchor) { - if (!this.options.anchor) this.options.anchor = new Vector(); - this.options.anchor.set(anchor); - }; - - module.exports = Spring; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -/*global console*/ - -define('famous/transitions/SpringTransition',['require','exports','module','famous/physics/PhysicsEngine','famous/physics/bodies/Particle','famous/physics/forces/Spring','famous/math/Vector'],function(require, exports, module) { - var PE = require('famous/physics/PhysicsEngine'); - var Particle = require('famous/physics/bodies/Particle'); - var Spring = require('famous/physics/forces/Spring'); - var Vector = require('famous/math/Vector'); - - /** - * SpringTransition is a method of transitioning between two values (numbers, - * or arrays of numbers) with a bounce. The transition will overshoot the target - * state depending on the parameters of the transition. - * - * @class SpringTransition - * @constructor - * - * @param {Number|Array} [state=0] Initial state - */ - function SpringTransition(state) { - state = state || 0; - this.endState = new Vector(state); - this.initState = new Vector(); - - this._dimensions = undefined; - this._restTolerance = 1e-10; - this._absRestTolerance = this._restTolerance; - this._callback = undefined; - - this.PE = new PE(); - this.spring = new Spring({anchor : this.endState}); - this.particle = new Particle(); - - this.PE.addBody(this.particle); - this.PE.attach(this.spring, this.particle); - } - - SpringTransition.SUPPORTS_MULTIPLE = 3; - - /** - * @property SpringTransition.DEFAULT_OPTIONS - * @type Object - * @protected - * @static - */ - SpringTransition.DEFAULT_OPTIONS = { - - /** - * The amount of time in milliseconds taken for one complete oscillation - * when there is no damping - * Range : [0, Infinity] - * - * @attribute period - * @type Number - * @default 300 - */ - period : 300, - - /** - * The damping of the snap. - * Range : [0, 1] - * 0 = no damping, and the spring will oscillate forever - * 1 = critically damped (the spring will never oscillate) - * - * @attribute dampingRatio - * @type Number - * @default 0.5 - */ - dampingRatio : 0.5, - - /** - * The initial velocity of the transition. - * - * @attribute velocity - * @type Number|Array - * @default 0 - */ - velocity : 0 - }; - - function _getEnergy() { - return this.particle.getEnergy() + this.spring.getEnergy(this.particle); - } - - function _setParticlePosition(p) { - this.particle.setPosition(p); - } - - function _setParticleVelocity(v) { - this.particle.setVelocity(v); - } - - function _getParticlePosition() { - return (this._dimensions === 0) - ? this.particle.getPosition1D() - : this.particle.getPosition(); - } - - function _getParticleVelocity() { - return (this._dimensions === 0) - ? this.particle.getVelocity1D() - : this.particle.getVelocity(); - } - - function _setCallback(callback) { - this._callback = callback; - } - - function _wake() { - this.PE.wake(); - } - - function _sleep() { - this.PE.sleep(); - } - - function _update() { - if (this.PE.isSleeping()) { - if (this._callback) { - var cb = this._callback; - this._callback = undefined; - cb(); - } - return; - } - - if (_getEnergy.call(this) < this._absRestTolerance) { - _setParticlePosition.call(this, this.endState); - _setParticleVelocity.call(this, [0,0,0]); - _sleep.call(this); - } - } - - function _setupDefinition(definition) { - // TODO fix no-console error - /* eslint no-console: 0 */ - var defaults = SpringTransition.DEFAULT_OPTIONS; - if (definition.period === undefined) definition.period = defaults.period; - if (definition.dampingRatio === undefined) definition.dampingRatio = defaults.dampingRatio; - if (definition.velocity === undefined) definition.velocity = defaults.velocity; - - if (definition.period < 150) { - definition.period = 150; - console.warn('The period of a SpringTransition is capped at 150 ms. Use a SnapTransition for faster transitions'); - } - - //setup spring - this.spring.setOptions({ - period : definition.period, - dampingRatio : definition.dampingRatio - }); - - //setup particle - _setParticleVelocity.call(this, definition.velocity); - } - - function _setAbsoluteRestTolerance() { - var distance = this.endState.sub(this.initState).normSquared(); - this._absRestTolerance = (distance === 0) - ? this._restTolerance - : this._restTolerance * distance; - } - - function _setTarget(target) { - this.endState.set(target); - _setAbsoluteRestTolerance.call(this); - } - - /** - * Resets the position and velocity - * - * @method reset - * - * @param {Number|Array.Number} pos positional state - * @param {Number|Array} vel velocity - */ - SpringTransition.prototype.reset = function reset(pos, vel) { - this._dimensions = (pos instanceof Array) - ? pos.length - : 0; - - this.initState.set(pos); - _setParticlePosition.call(this, pos); - _setTarget.call(this, pos); - if (vel) _setParticleVelocity.call(this, vel); - _setCallback.call(this, undefined); - }; - - /** - * Getter for velocity - * - * @method getVelocity - * - * @return {Number|Array} velocity - */ - SpringTransition.prototype.getVelocity = function getVelocity() { - return _getParticleVelocity.call(this); - }; - - /** - * Setter for velocity - * - * @method setVelocity - * - * @return {Number|Array} velocity - */ - SpringTransition.prototype.setVelocity = function setVelocity(v) { - this.call(this, _setParticleVelocity(v)); - }; - - /** - * Detects whether a transition is in progress - * - * @method isActive - * - * @return {Boolean} - */ - SpringTransition.prototype.isActive = function isActive() { - return !this.PE.isSleeping(); - }; - - /** - * Halt the transition - * - * @method halt - */ - SpringTransition.prototype.halt = function halt() { - this.set(this.get()); - }; - - /** - * Get the current position of the transition - * - * @method get - * - * @return {Number|Array} state - */ - SpringTransition.prototype.get = function get() { - _update.call(this); - return _getParticlePosition.call(this); - }; - - /** - * Set the end position and transition, with optional callback on completion. - * - * @method set - * - * @param {Number|Array} endState Final state - * @param {Object} definition Transition definition - * @param {Function} callback Callback - */ - SpringTransition.prototype.set = function set(endState, definition, callback) { - if (!definition) { - this.reset(endState); - if (callback) callback(); - return; - } - - this._dimensions = (endState instanceof Array) - ? endState.length - : 0; - - _wake.call(this); - _setupDefinition.call(this, definition); - _setTarget.call(this, endState); - _setCallback.call(this, callback); - }; - - module.exports = SpringTransition; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/physics/constraints/Wall',['require','exports','module','./Constraint','famous/math/Vector'],function(require, exports, module) { - var Constraint = require('./Constraint'); - var Vector = require('famous/math/Vector'); - - /** - * A wall describes an infinite two-dimensional plane that physics bodies - * can collide with. To define a wall, you must give it a distance (from - * the center of the physics engine's origin, and a normal defining the plane - * of the wall. - * - * (wall) - * | - * | (normal) (origin) - * | ---> * - * | - * | (distance) - * ................... - * (100px) - * - * e.g., Wall({normal : [1,0,0], distance : 100}) - * would be a wall 100 pixels to the left, whose normal points right - * - * @class Wall - * @constructor - * @extends Constraint - * @param {Options} [options] An object of configurable options. - * @param {Number} [options.restitution] The energy ratio lost in a collision (0 = stick, 1 = elastic). Range : [0, 1] - * @param {Number} [options.drift] Baumgarte stabilization parameter. Makes constraints "loosely" (0) or "tightly" (1) enforced. Range : [0, 1] - * @param {Number} [options.slop] Amount of penetration in pixels to ignore before collision event triggers. - * @param {Array} [options.normal] The normal direction to the wall. - * @param {Number} [options.distance] The distance from the origin that the wall is placed. - * @param {onContact} [options.onContact] How to handle collision against the wall. - * - */ - function Wall(options) { - this.options = Object.create(Wall.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - //registers - this.diff = new Vector(); - this.impulse = new Vector(); - - Constraint.call(this); - } - - Wall.prototype = Object.create(Constraint.prototype); - Wall.prototype.constructor = Wall; - - /** - * @property Wall.ON_CONTACT - * @type Object - * @protected - * @static - */ - Wall.ON_CONTACT = { - - /** - * Physical bodies bounce off the wall - * @attribute REFLECT - */ - REFLECT : 0, - - /** - * Physical bodies are unaffected. Usecase is to fire events on contact. - * @attribute SILENT - */ - SILENT : 1 - }; - - Wall.DEFAULT_OPTIONS = { - restitution : 0.5, - drift : 0.5, - slop : 0, - normal : [1, 0, 0], - distance : 0, - onContact : Wall.ON_CONTACT.REFLECT - }; - - /* - * Setter for options. - * - * @method setOptions - * @param options {Objects} - */ - Wall.prototype.setOptions = function setOptions(options) { - if (options.normal !== undefined) { - if (options.normal instanceof Vector) this.options.normal = options.normal.clone(); - if (options.normal instanceof Array) this.options.normal = new Vector(options.normal); - } - if (options.restitution !== undefined) this.options.restitution = options.restitution; - if (options.drift !== undefined) this.options.drift = options.drift; - if (options.slop !== undefined) this.options.slop = options.slop; - if (options.distance !== undefined) this.options.distance = options.distance; - if (options.onContact !== undefined) this.options.onContact = options.onContact; - }; - - function _getNormalVelocity(n, v) { - return v.dot(n); - } - - function _getDistanceFromOrigin(p) { - var n = this.options.normal; - var d = this.options.distance; - return p.dot(n) + d; - } - - function _onEnter(particle, overlap, dt) { - var p = particle.position; - var v = particle.velocity; - var m = particle.mass; - var n = this.options.normal; - var action = this.options.onContact; - var restitution = this.options.restitution; - var impulse = this.impulse; - - var drift = this.options.drift; - var slop = -this.options.slop; - var gamma = 0; - - if (this._eventOutput) { - var data = {particle : particle, wall : this, overlap : overlap, normal : n}; - this._eventOutput.emit('preCollision', data); - this._eventOutput.emit('collision', data); - } - - switch (action) { - case Wall.ON_CONTACT.REFLECT: - var lambda = (overlap < slop) - ? -((1 + restitution) * n.dot(v) + drift / dt * (overlap - slop)) / (m * dt + gamma) - : -((1 + restitution) * n.dot(v)) / (m * dt + gamma); - - impulse.set(n.mult(dt * lambda)); - particle.applyImpulse(impulse); - particle.setPosition(p.add(n.mult(-overlap))); - break; - } - - if (this._eventOutput) this._eventOutput.emit('postCollision', data); - } - - function _onExit(particle, overlap, dt) { - var action = this.options.onContact; - var p = particle.position; - var n = this.options.normal; - - if (action === Wall.ON_CONTACT.REFLECT) { - particle.setPosition(p.add(n.mult(-overlap))); - } - } - - /** - * Adds an impulse to a physics body's velocity due to the wall constraint - * - * @method applyConstraint - * @param targets {Array.Body} Array of bodies to apply the constraint to - * @param source {Body} The source of the constraint - * @param dt {Number} Delta time - */ - Wall.prototype.applyConstraint = function applyConstraint(targets, source, dt) { - var n = this.options.normal; - - for (var i = 0; i < targets.length; i++) { - var particle = targets[i]; - var p = particle.position; - var v = particle.velocity; - var r = particle.radius || 0; - - var overlap = _getDistanceFromOrigin.call(this, p.add(n.mult(-r))); - var nv = _getNormalVelocity.call(this, n, v); - - if (overlap <= 0) { - if (nv < 0) _onEnter.call(this, particle, overlap, dt); - else _onExit.call(this, particle, overlap, dt); - } - } - }; - - module.exports = Wall; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: david@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/transitions/WallTransition',['require','exports','module','famous/physics/PhysicsEngine','famous/physics/bodies/Particle','famous/physics/forces/Spring','famous/physics/constraints/Wall','famous/math/Vector'],function(require, exports, module) { - var PE = require('famous/physics/PhysicsEngine'); - var Particle = require('famous/physics/bodies/Particle'); - var Spring = require('famous/physics/forces/Spring'); - var Wall = require('famous/physics/constraints/Wall'); - var Vector = require('famous/math/Vector'); - - /** - * WallTransition is a method of transitioning between two values (numbers, - * or arrays of numbers) with a bounce. Unlike a SpringTransition - * The transition will not overshoot the target, but bounce back against it. - * The behavior of the bounce is specified by the transition options. - * - * @class WallTransition - * @constructor - * - * @param {Number|Array} [state=0] Initial state - */ - function WallTransition(state) { - state = state || 0; - - this.endState = new Vector(state); - this.initState = new Vector(); - - this.spring = new Spring({anchor : this.endState}); - this.wall = new Wall(); - - this._restTolerance = 1e-10; - this._dimensions = 1; - this._absRestTolerance = this._restTolerance; - this._callback = undefined; - - this.PE = new PE(); - this.particle = new Particle(); - - this.PE.addBody(this.particle); - this.PE.attach([this.wall, this.spring], this.particle); - } - - WallTransition.SUPPORTS_MULTIPLE = 3; - - /** - * @property WallTransition.DEFAULT_OPTIONS - * @type Object - * @protected - * @static - */ - WallTransition.DEFAULT_OPTIONS = { - - /** - * The amount of time in milliseconds taken for one complete oscillation - * when there is no damping - * Range : [0, Infinity] - * - * @attribute period - * @type Number - * @default 300 - */ - period : 300, - - /** - * The damping of the snap. - * Range : [0, 1] - * 0 = no damping, and the spring will oscillate forever - * 1 = critically damped (the spring will never oscillate) - * - * @attribute dampingRatio - * @type Number - * @default 0.5 - */ - dampingRatio : 0.5, - - /** - * The initial velocity of the transition. - * - * @attribute velocity - * @type Number|Array - * @default 0 - */ - velocity : 0, - - /** - * The percentage of momentum transferred to the wall - * - * @attribute restitution - * @type Number - * @default 0.5 - */ - resitution : 0.5 - }; - - function _getEnergy() { - return this.particle.getEnergy() + this.spring.getEnergy(this.particle); - } - - function _setAbsoluteRestTolerance() { - var distance = this.endState.sub(this.initState).normSquared(); - this._absRestTolerance = (distance === 0) - ? this._restTolerance - : this._restTolerance * distance; - } - - function _wake() { - this.PE.wake(); - } - - function _sleep() { - this.PE.sleep(); - } - - function _setTarget(target) { - this.endState.set(target); - - var dist = this.endState.sub(this.initState).norm(); - - this.wall.setOptions({ - distance : this.endState.norm(), - normal : (dist === 0) - ? this.particle.velocity.normalize(-1) - : this.endState.sub(this.initState).normalize(-1) - }); - - _setAbsoluteRestTolerance.call(this); - } - - function _setParticlePosition(p) { - this.particle.position.set(p); - } - - function _setParticleVelocity(v) { - this.particle.velocity.set(v); - } - - function _getParticlePosition() { - return (this._dimensions === 0) - ? this.particle.getPosition1D() - : this.particle.getPosition(); - } - - function _getParticleVelocity() { - return (this._dimensions === 0) - ? this.particle.getVelocity1D() - : this.particle.getVelocity(); - } - - function _setCallback(callback) { - this._callback = callback; - } - - function _update() { - if (this.PE.isSleeping()) { - if (this._callback) { - var cb = this._callback; - this._callback = undefined; - cb(); - } - return; - } - var energy = _getEnergy.call(this); - if (energy < this._absRestTolerance) { - _sleep.call(this); - _setParticlePosition.call(this, this.endState); - _setParticleVelocity.call(this, [0,0,0]); - } - } - - function _setupDefinition(def) { - var defaults = WallTransition.DEFAULT_OPTIONS; - if (def.period === undefined) def.period = defaults.period; - if (def.dampingRatio === undefined) def.dampingRatio = defaults.dampingRatio; - if (def.velocity === undefined) def.velocity = defaults.velocity; - if (def.restitution === undefined) def.restitution = defaults.restitution; - - //setup spring - this.spring.setOptions({ - period : def.period, - dampingRatio : def.dampingRatio - }); - - //setup wall - this.wall.setOptions({ - restitution : def.restitution - }); - - //setup particle - _setParticleVelocity.call(this, def.velocity); - } - - /** - * Resets the state and velocity - * - * @method reset - * - * @param {Number|Array} state State - * @param {Number|Array} [velocity] Velocity - */ - WallTransition.prototype.reset = function reset(state, velocity) { - this._dimensions = (state instanceof Array) - ? state.length - : 0; - - this.initState.set(state); - _setParticlePosition.call(this, state); - if (velocity) _setParticleVelocity.call(this, velocity); - _setTarget.call(this, state); - _setCallback.call(this, undefined); - }; - - /** - * Getter for velocity - * - * @method getVelocity - * - * @return velocity {Number|Array} - */ - WallTransition.prototype.getVelocity = function getVelocity() { - return _getParticleVelocity.call(this); - }; - - /** - * Setter for velocity - * - * @method setVelocity - * - * @return velocity {Number|Array} - */ - WallTransition.prototype.setVelocity = function setVelocity(velocity) { - this.call(this, _setParticleVelocity(velocity)); - }; - - /** - * Detects whether a transition is in progress - * - * @method isActive - * - * @return {Boolean} - */ - WallTransition.prototype.isActive = function isActive() { - return !this.PE.isSleeping(); - }; - - /** - * Halt the transition - * - * @method halt - */ - WallTransition.prototype.halt = function halt() { - this.set(this.get()); - }; - - /** - * Getter - * - * @method get - * - * @return state {Number|Array} - */ - WallTransition.prototype.get = function get() { - _update.call(this); - return _getParticlePosition.call(this); - }; - - /** - * Set the end position and transition, with optional callback on completion. - * - * @method set - * - * @param state {Number|Array} Final state - * @param [definition] {Object} Transition definition - * @param [callback] {Function} Callback - */ - WallTransition.prototype.set = function set(state, definition, callback) { - if (!definition) { - this.reset(state); - if (callback) callback(); - return; - } - - this._dimensions = (state instanceof Array) - ? state.length - : 0; - - _wake.call(this); - _setupDefinition.call(this, definition); - _setTarget.call(this, state); - _setCallback.call(this, callback); - }; - - module.exports = WallTransition; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/surfaces/CanvasSurface',['require','exports','module','famous/core/Surface'],function(require, exports, module) { - var Surface = require('famous/core/Surface'); - - /** - * A surface containing an HTML5 Canvas element. - * This extends the Surface class. - * - * @class CanvasSurface - * @extends Surface - * @constructor - * @param {Object} [options] overrides of default options - * @param {Array.Number} [options.canvasSize] [width, height] for document element - */ - function CanvasSurface(options) { - if (options && options.canvasSize) this._canvasSize = options.canvasSize; - Surface.apply(this, arguments); - if (!this._canvasSize) this._canvasSize = this.getSize(); - this._backBuffer = document.createElement('canvas'); - if (this._canvasSize) { - this._backBuffer.width = this._canvasSize[0]; - this._backBuffer.height = this._canvasSize[1]; - } - this._contextId = undefined; - } - - CanvasSurface.prototype = Object.create(Surface.prototype); - CanvasSurface.prototype.constructor = CanvasSurface; - CanvasSurface.prototype.elementType = 'canvas'; - CanvasSurface.prototype.elementClass = 'famous-surface'; - - /** - * Set inner document content. Note that this is a noop for CanvasSurface. - * - * @method setContent - * - */ - CanvasSurface.prototype.setContent = function setContent() {}; - - /** - * Place the document element this component manages into the document. - * This will draw the content to the document. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - CanvasSurface.prototype.deploy = function deploy(target) { - if (this._canvasSize) { - target.width = this._canvasSize[0]; - target.height = this._canvasSize[1]; - } - if (this._contextId === '2d') { - target.getContext(this._contextId).drawImage(this._backBuffer, 0, 0); - this._backBuffer.width = 0; - this._backBuffer.height = 0; - } - }; - - /** - * Remove this component and contained content from the document - * - * @private - * @method recall - * - * @param {Node} target node to which the component was deployed - */ - CanvasSurface.prototype.recall = function recall(target) { - var size = this.getSize(); - - this._backBuffer.width = target.width; - this._backBuffer.height = target.height; - - if (this._contextId === '2d') { - this._backBuffer.getContext(this._contextId).drawImage(target, 0, 0); - target.width = 0; - target.height = 0; - } - }; - - /** - * Returns the canvas element's context - * - * @method getContext - * @param {string} contextId context identifier - */ - CanvasSurface.prototype.getContext = function getContext(contextId) { - this._contextId = contextId; - return this._currTarget ? this._currTarget.getContext(contextId) : this._backBuffer.getContext(contextId); - }; - - /** - * Set the size of the surface and canvas element. - * - * @method setSize - * @param {Array.number} size [width, height] of surface - * @param {Array.number} canvasSize [width, height] of canvas surface - */ - CanvasSurface.prototype.setSize = function setSize(size, canvasSize) { - Surface.prototype.setSize.apply(this, arguments); - if (canvasSize) this._canvasSize = [canvasSize[0], canvasSize[1]]; - if (this._currTarget) { - this._currTarget.width = this._canvasSize[0]; - this._currTarget.height = this._canvasSize[1]; - } - }; - - module.exports = CanvasSurface; -}); - - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/surfaces/ContainerSurface',['require','exports','module','famous/core/Surface','famous/core/Context'],function(require, exports, module) { - var Surface = require('famous/core/Surface'); - var Context = require('famous/core/Context'); - - /** - * ContainerSurface is an object designed to contain surfaces and - * set properties to be applied to all of them at once. - * This extends the Surface class. - * A container surface will enforce these properties on the - * surfaces it contains: - * - * size (clips contained surfaces to its own width and height); - * - * origin; - * - * its own opacity and transform, which will be automatically - * applied to all Surfaces contained directly and indirectly. - * - * @class ContainerSurface - * @extends Surface - * @constructor - * @param {Array.Number} [options.size] [width, height] in pixels - * @param {Array.string} [options.classes] CSS classes to set on all inner content - * @param {Array} [options.properties] string dictionary of HTML attributes to set on target div - * @param {string} [options.content] inner (HTML) content of surface (should not be used) - */ - function ContainerSurface(options) { - Surface.call(this, options); - this._container = document.createElement('div'); - this._container.classList.add('famous-group'); - this._container.classList.add('famous-container-group'); - this._shouldRecalculateSize = false; - this.context = new Context(this._container); - this.setContent(this._container); - } - - ContainerSurface.prototype = Object.create(Surface.prototype); - ContainerSurface.prototype.constructor = ContainerSurface; - ContainerSurface.prototype.elementType = 'div'; - ContainerSurface.prototype.elementClass = 'famous-surface'; - - /** - * Add renderables to this object's render tree - * - * @method add - * - * @param {Object} obj renderable object - * @return {RenderNode} RenderNode wrapping this object, if not already a RenderNode - */ - ContainerSurface.prototype.add = function add() { - return this.context.add.apply(this.context, arguments); - }; - - /** - * Return spec for this surface. Note: Can result in a size recalculation. - * - * @private - * @method render - * - * @return {Object} render spec for this surface (spec id) - */ - ContainerSurface.prototype.render = function render() { - if (this._sizeDirty) this._shouldRecalculateSize = true; - return Surface.prototype.render.apply(this, arguments); - }; - - /** - * Place the document element this component manages into the document. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - ContainerSurface.prototype.deploy = function deploy() { - this._shouldRecalculateSize = true; - return Surface.prototype.deploy.apply(this, arguments); - }; - - /** - * Apply changes from this component to the corresponding document element. - * This includes changes to classes, styles, size, content, opacity, origin, - * and matrix transforms. - * - * @private - * @method commit - * @param {Context} context commit context - * @param {Transform} transform unused TODO - * @param {Number} opacity unused TODO - * @param {Array.Number} origin unused TODO - * @param {Array.Number} size unused TODO - * @return {undefined} TODO returns an undefined value - */ - ContainerSurface.prototype.commit = function commit(context, transform, opacity, origin, size) { - var previousSize = this._size ? [this._size[0], this._size[1]] : null; - var result = Surface.prototype.commit.apply(this, arguments); - if (this._shouldRecalculateSize || (previousSize && (this._size[0] !== previousSize[0] || this._size[1] !== previousSize[1]))) { - this.context.setSize(); - this._shouldRecalculateSize = false; - } - this.context.update(); - return result; - }; - - module.exports = ContainerSurface; -}); - -define('famous/surfaces/FormContainerSurface',['require','exports','module','./ContainerSurface'],function(require, exports, module) { - var ContainerSurface = require('./ContainerSurface'); - - function FormContainerSurface(options) { - if (options) this._method = options.method || ''; - ContainerSurface.apply(this, arguments); - } - - FormContainerSurface.prototype = Object.create(ContainerSurface.prototype); - FormContainerSurface.prototype.constructor = FormContainerSurface; - - FormContainerSurface.prototype.elementType = 'form'; - - FormContainerSurface.prototype.deploy = function deploy(target) { - if (this._method) target.method = this._method; - return ContainerSurface.prototype.deploy.apply(this, arguments); - }; - - module.exports = FormContainerSurface; -}); - - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/surfaces/ImageSurface',['require','exports','module','famous/core/Surface'],function(require, exports, module) { - var Surface = require('famous/core/Surface'); - - /** - * A surface containing image content. - * This extends the Surface class. - * - * @class ImageSurface - * - * @extends Surface - * @constructor - * @param {Object} [options] overrides of default options - */ - function ImageSurface(options) { - this._imageUrl = undefined; - Surface.apply(this, arguments); - } - - ImageSurface.prototype = Object.create(Surface.prototype); - ImageSurface.prototype.constructor = ImageSurface; - ImageSurface.prototype.elementType = 'img'; - ImageSurface.prototype.elementClass = 'famous-surface'; - - /** - * Set content URL. This will cause a re-rendering. - * @method setContent - * @param {string} imageUrl - */ - ImageSurface.prototype.setContent = function setContent(imageUrl) { - this._imageUrl = imageUrl; - this._contentDirty = true; - }; - - /** - * Place the document element that this component manages into the document. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - ImageSurface.prototype.deploy = function deploy(target) { - target.src = this._imageUrl || ''; - }; - - /** - * Remove this component and contained content from the document - * - * @private - * @method recall - * - * @param {Node} target node to which the component was deployed - */ - ImageSurface.prototype.recall = function recall(target) { - target.src = ''; - }; - - module.exports = ImageSurface; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/surfaces/InputSurface',['require','exports','module','famous/core/Surface'],function(require, exports, module) { - var Surface = require('famous/core/Surface'); - - /** - * A Famo.us surface in the form of an HTML input element. - * This extends the Surface class. - * - * @class InputSurface - * @extends Surface - * @constructor - * @param {Object} [options] overrides of default options - * @param {string} [options.placeholder] placeholder text hint that describes the expected value of an element - * @param {string} [options.type] specifies the type of element to display (e.g. 'datetime', 'text', 'button', etc.) - * @param {string} [options.value] value of text - */ - function InputSurface(options) { - this._placeholder = options.placeholder || ''; - this._value = options.value || ''; - this._type = options.type || 'text'; - this._name = options.name || ''; - - Surface.apply(this, arguments); - - this.on('click', this.focus.bind(this)); - window.addEventListener('click', function(event) { - if (event.target !== this._currTarget) this.blur(); - }.bind(this)); - } - InputSurface.prototype = Object.create(Surface.prototype); - InputSurface.prototype.constructor = InputSurface; - - InputSurface.prototype.elementType = 'input'; - InputSurface.prototype.elementClass = 'famous-surface'; - - /** - * Set placeholder text. Note: Triggers a repaint. - * - * @method setPlaceholder - * @param {string} str Value to set the placeholder to. - * @return {InputSurface} this, allowing method chaining. - */ - InputSurface.prototype.setPlaceholder = function setPlaceholder(str) { - this._placeholder = str; - this._contentDirty = true; - return this; - }; - - /** - * Focus on the current input, pulling up the keyboard on mobile. - * - * @method focus - * @return {InputSurface} this, allowing method chaining. - */ - InputSurface.prototype.focus = function focus() { - if (this._currTarget) this._currTarget.focus(); - return this; - }; - - /** - * Blur the current input, hiding the keyboard on mobile. - * - * @method blur - * @return {InputSurface} this, allowing method chaining. - */ - InputSurface.prototype.blur = function blur() { - if (this._currTarget) this._currTarget.blur(); - return this; - }; - - /** - * Set the placeholder conent. - * Note: Triggers a repaint next tick. - * - * @method setValue - * @param {string} str Value to set the main input value to. - * @return {InputSurface} this, allowing method chaining. - */ - InputSurface.prototype.setValue = function setValue(str) { - this._value = str; - this._contentDirty = true; - return this; - }; - - /** - * Set the type of element to display conent. - * Note: Triggers a repaint next tick. - * - * @method setType - * @param {string} str type of the input surface (e.g. 'button', 'text') - * @return {InputSurface} this, allowing method chaining. - */ - InputSurface.prototype.setType = function setType(str) { - this._type = str; - this._contentDirty = true; - return this; - }; - - /** - * Get the value of the inner content of the element (e.g. the entered text) - * - * @method getValue - * @return {string} value of element - */ - InputSurface.prototype.getValue = function getValue() { - if (this._currTarget) { - return this._currTarget.value; - } - else { - return this._value; - } - }; - - /** - * Set the name attribute of the element. - * Note: Triggers a repaint next tick. - * - * @method setName - * @param {string} str element name - * @return {InputSurface} this, allowing method chaining. - */ - InputSurface.prototype.setName = function setName(str) { - this._name = str; - this._contentDirty = true; - return this; - }; - - /** - * Get the name attribute of the element. - * - * @method getName - * @return {string} name of element - */ - InputSurface.prototype.getName = function getName() { - return this._name; - }; - - /** - * Place the document element this component manages into the document. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - InputSurface.prototype.deploy = function deploy(target) { - if (this._placeholder !== '') target.placeholder = this._placeholder; - target.value = this._value; - target.type = this._type; - target.name = this._name; - }; - - module.exports = InputSurface; -}); - -define('famous/surfaces/SubmitInputSurface',['require','exports','module','./InputSurface'],function(require, exports, module) { - var InputSurface = require('./InputSurface'); - - function SubmitInputSurface(options) { - InputSurface.apply(this, arguments); - this._type = 'submit'; - if (options && options.onClick) this.setOnClick(options.onClick); - } - - SubmitInputSurface.prototype = Object.create(InputSurface.prototype); - SubmitInputSurface.prototype.constructor = SubmitInputSurface; - - SubmitInputSurface.prototype.setOnClick = function(onClick) { - this.onClick = onClick; - }; - - SubmitInputSurface.prototype.deploy = function deploy(target) { - if (this.onclick) target.onClick = this.onClick; - InputSurface.prototype.deploy.apply(this, arguments); - }; - - module.exports = SubmitInputSurface; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/surfaces/TextareaSurface',['require','exports','module','famous/core/Surface'],function(require, exports, module) { - var Surface = require('famous/core/Surface'); - - /** - * A Famo.us surface in the form of an HTML textarea element. - * This extends the Surface class. - * - * @class TextareaSurface - * @extends Surface - * @constructor - * @param {Object} [options] overrides of default options - * @param {string} [options.placeholder] placeholder text hint that describes the expected value of an textarea element - * @param {string} [options.value] value of text - * @param {string} [options.name] specifies the name of textarea - * @param {string} [options.wrap] specify 'hard' or 'soft' wrap for textarea - * @param {number} [options.cols] number of columns in textarea - * @param {number} [options.rows] number of rows in textarea - */ - function TextareaSurface(options) { - this._placeholder = options.placeholder || ''; - this._value = options.value || ''; - this._name = options.name || ''; - this._wrap = options.wrap || ''; - this._cols = options.cols || ''; - this._rows = options.rows || ''; - - Surface.apply(this, arguments); - this.on('click', this.focus.bind(this)); - } - TextareaSurface.prototype = Object.create(Surface.prototype); - TextareaSurface.prototype.constructor = TextareaSurface; - - TextareaSurface.prototype.elementType = 'textarea'; - TextareaSurface.prototype.elementClass = 'famous-surface'; - - /** - * Set placeholder text. Note: Triggers a repaint. - * - * @method setPlaceholder - * @param {string} str Value to set the placeholder to. - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.setPlaceholder = function setPlaceholder(str) { - this._placeholder = str; - this._contentDirty = true; - return this; - }; - - /** - * Focus on the current input, pulling up the keyboard on mobile. - * - * @method focus - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.focus = function focus() { - if (this._currTarget) this._currTarget.focus(); - return this; - }; - - /** - * Blur the current input, hiding the keyboard on mobile. - * - * @method focus - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.blur = function blur() { - if (this._currTarget) this._currTarget.blur(); - return this; - }; - - /** - * Set the value of textarea. - * Note: Triggers a repaint next tick. - * - * @method setValue - * @param {string} str Value to set the main textarea value to. - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.setValue = function setValue(str) { - this._value = str; - this._contentDirty = true; - return this; - }; - - /** - * Get the value of the inner content of the textarea (e.g. the entered text) - * - * @method getValue - * @return {string} value of element - */ - TextareaSurface.prototype.getValue = function getValue() { - if (this._currTarget) { - return this._currTarget.value; - } - else { - return this._value; - } - }; - - /** - * Set the name attribute of the element. - * Note: Triggers a repaint next tick. - * - * @method setName - * @param {string} str element name - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.setName = function setName(str) { - this._name = str; - this._contentDirty = true; - return this; - }; - - /** - * Get the name attribute of the element. - * - * @method getName - * @return {string} name of element - */ - TextareaSurface.prototype.getName = function getName() { - return this._name; - }; - - /** - * Set the wrap of textarea. - * Note: Triggers a repaint next tick. - * - * @method setWrap - * @param {string} str wrap of the textarea surface (e.g. 'soft', 'hard') - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.setWrap = function setWrap(str) { - this._wrap = str; - this._contentDirty = true; - return this; - }; - - /** - * Set the number of columns visible in the textarea. - * Note: Overridden by surface size; set width to true. (eg. size: [true, *]) - * Triggers a repaint next tick. - * - * @method setColumns - * @param {number} num columns in textarea surface - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.setColumns = function setColumns(num) { - this._cols = num; - this._contentDirty = true; - return this; - }; - - /** - * Set the number of rows visible in the textarea. - * Note: Overridden by surface size; set height to true. (eg. size: [*, true]) - * Triggers a repaint next tick. - * - * @method setRows - * @param {number} num rows in textarea surface - * @return {TextareaSurface} this, allowing method chaining. - */ - TextareaSurface.prototype.setRows = function setRows(num) { - this._rows = num; - this._contentDirty = true; - return this; - }; - - /** - * Place the document element this component manages into the document. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - TextareaSurface.prototype.deploy = function deploy(target) { - if (this._placeholder !== '') target.placeholder = this._placeholder; - if (this._value !== '') target.value = this._value; - if (this._name !== '') target.name = this._name; - if (this._wrap !== '') target.wrap = this._wrap; - if (this._cols !== '') target.cols = this._cols; - if (this._rows !== '') target.rows = this._rows; - }; - - module.exports = TextareaSurface; -}); - -/* This Source Code Form is subject to the terms of the Mozilla Public - * License, v. 2.0. If a copy of the MPL was not distributed with this - * file, You can obtain one at http://mozilla.org/MPL/2.0/. - * - * Owner: mark@famo.us - * @license MPL 2.0 - * @copyright Famous Industries, Inc. 2014 - */ - -define('famous/surfaces/VideoSurface',['require','exports','module','famous/core/Surface'],function(require, exports, module) { - var Surface = require('famous/core/Surface'); - - /** - * Creates a famous surface containing video content. Currently adding - * controls and manipulating the video are not supported through the - * surface interface, but can be accomplished via standard JavaScript - * manipulation of the video DOM element. - * This extends the Surface class. - * - * @class VideoSurface - * @extends Surface - * @constructor - * @param {Object} [options] default option overrides - * @param {Array.Number} [options.size] [width, height] in pixels - * @param {Array.string} [options.classes] CSS classes to set on inner content - * @param {Array} [options.properties] string dictionary of HTML attributes to set on target div - * @param {string} [options.content] inner (HTML) content of surface - * @param {boolean} [options.autoplay] autoplay - */ - function VideoSurface(options) { - this._videoUrl = undefined; - this.options = Object.create(VideoSurface.DEFAULT_OPTIONS); - if (options) this.setOptions(options); - - Surface.apply(this, arguments); - } - VideoSurface.prototype = Object.create(Surface.prototype); - VideoSurface.prototype.constructor = VideoSurface; - - VideoSurface.DEFAULT_OPTIONS = { - autoplay: false - }; - - VideoSurface.prototype.elementType = 'video'; - VideoSurface.prototype.elementClass = 'famous-surface'; - - /** - * Set internal options, overriding any default options - * - * @method setOptions - * - * @param {Object} [options] overrides of default options - * @param {Boolean} [options.autoplay] HTML autoplay - */ - VideoSurface.prototype.setOptions = function setOptions(options) { - for (var key in VideoSurface.DEFAULT_OPTIONS) { - if (options[key] !== undefined) this.options[key] = options[key]; - } - }; - - /** - * Set url of the video. - * - * @method setContent - * @param {string} videoUrl URL - */ - VideoSurface.prototype.setContent = function setContent(videoUrl) { - this._videoUrl = videoUrl; - this._contentDirty = true; - }; - - /** - * Place the document element this component manages into the document. - * Note: In the case of VideoSurface, simply changes the options on the target. - * - * @private - * @method deploy - * @param {Node} target document parent of this container - */ - VideoSurface.prototype.deploy = function deploy(target) { - target.src = this._videoUrl; - target.autoplay = this.options.autoplay; - }; - - /** - * Remove this component and contained content from the document. - * Note: This doesn't actually remove the