Files
cocos4/cocos2d/animation/types.js
T
2016-03-22 17:32:41 +08:00

366 lines
9.7 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
var JS = cc.js;
var Playable = require('./playable');
var WrapModeMask = {
Loop: 1 << 1,
ShouldWrap: 1 << 2,
// Reserved: 1 << 3,
PingPong: 1 << 4 | 1 << 1 | 1 << 2, // Loop, ShouldWrap
Reverse: 1 << 5 | 1 << 2, // ShouldWrap
};
/**
* !#en Specifies how time is treated when it is outside of the keyframe range of an Animation.
* !#zh 动画使用的循环模式。
* @enum WrapMode
* @memberof cc
*/
var WrapMode = cc.Enum({
/**
* !#en Reads the default wrap mode set higher up.
* !#zh 向 Animation Component 或者 AnimationClip 查找 wrapMode
* @property {Number} Default
*/
Default: 0,
/**
* !#en All iterations are played as specified.
* !#zh 动画只播放一遍
* @property {Number} Normal
*/
Normal: 1,
/**
* !#en All iterations are played in the reverse direction from the way they are specified.
* !#zh 从最后一帧或结束位置开始反向播放,到第一帧或开始位置停止
* @property {Number} Reverse
*/
Reverse: WrapModeMask.Reverse,
/**
* !#en When time reaches the end of the animation, time will continue at the beginning.
* !#zh 循环播放
* @property {Number} Loop
*/
Loop: WrapModeMask.Loop,
/**
* !#en All iterations are played in the reverse direction from the way they are specified.
* And when time reaches the start of the animation, time will continue at the ending.
* !#zh 反向循环播放
* @property {Number} LoopReverse
*/
LoopReverse: WrapModeMask.Loop | WrapModeMask.Reverse,
/**
* !#en Even iterations are played as specified, odd iterations are played in the reverse direction from the way they
* are specified.
* !#zh 从第一帧播放到最后一帧,然后反向播放回第一帧,到第一帧后再正向播放,如此循环
* @property {Number} PingPong
*/
PingPong: WrapModeMask.PingPong,
/**
* !#en Even iterations are played in the reverse direction from the way they are specified, odd iterations are played
* as specified.
* !#zh 从最后一帧开始反向播放,其他同 PingPong
* @property {Number} PingPongReverse
*/
PingPongReverse: WrapModeMask.PingPong | WrapModeMask.Reverse
});
cc.WrapMode = WrapMode;
/**
* !#en The abstract interface for all playing animation.
* !#zh 所有播放动画的抽象接口。
* @class AnimationNodeBase
* @constructor
* @extends Playable
* @private
*/
var AnimationNodeBase = function () {
Playable.call(this);
};
JS.extend(AnimationNodeBase, Playable);
/**
* @method update
* @param {Number} deltaTime
* @private
*/
AnimationNodeBase.prototype.update = function (deltaTime) {};
/*
* !#en The collection and instance of playing animations.
* !#zh 动画曲线的集合,根据当前时间计算出每条曲线的状态。
* @class AnimationNode
* @extends AnimationNodeBase
* @constructor
* @param {Animator} animator
* @param {AnimCurve[]} [curves]
* @param {Object} [timingInput] - This dictionary is used as a convenience for specifying the timing properties of an Animation in bulk.
*/
function AnimationNode (animator, curves, timingInput) {
AnimationNodeBase.call(this);
this.animator = animator;
/**
* !#en The curves list.
* !#zh 曲线列表。
* @property curves
* @type {AnimCurve[]}
*/
this.curves = curves || [];
// http://www.w3.org/TR/web-animations/#idl-def-AnimationTiming
/**
* !#en The start delay which represents the number of seconds from an animation's start time to the start of
* the active interval.
* !#zh 延迟多少秒播放。
*
* @property delay
* @type {Number}
* @default 0
*/
this.delay = 0;
/**
* !#en The animation's iteration count property.
*
* A real number greater than or equal to zero (including positive infinity) representing the number of times
* to repeat the animation node.
*
* Values less than zero and NaN values are treated as the value 1.0 for the purpose of timing model
* calculations.
*
* !#zh 迭代次数,指动画播放多少次后结束, normalize time。 如 2.5(2次半)
*
* @property repeatCount
* @type {Number}
* @default 1
*/
this.repeatCount = 1;
/**
* !#en The iteration duration of this animation in seconds. (length)
* !#zh 单次动画的持续时间,秒。
*
* @property duration
* @type {Number}
* @readOnly
*/
this.duration = 1;
/**
* !#en The animation's playback speed. 1 is normal playback speed.
* !#zh 播放速率。
* @property speed
* @type {Number}
* @default: 1.0
*/
this.speed = 1;
/**
* !#en Wrapping mode of the playing animation.
* !#zh 动画循环方式。
*
* @property wrapMode
* @type {WrapMode}
* @default: WrapMode.Normal
*/
this.wrapMode = WrapMode.Normal;
if (timingInput) {
this.delay = timingInput.delay || this.delay;
var duration = timingInput.duration;
if (typeof duration !== 'undefined') {
this.duration = duration;
}
var speed = timingInput.speed;
if (typeof speed !== 'undefined') {
this.speed = speed;
}
//
var wrapMode = timingInput.wrapMode;
if (typeof wrapMode !== 'undefined') {
var isEnum = typeof wrapMode === 'number';
if (isEnum) {
this.wrapMode = wrapMode;
}
else {
this.wrapMode = WrapMode[wrapMode];
}
}
var repeatCount = timingInput.repeatCount;
if (typeof repeatCount !== 'undefined') {
this.repeatCount = repeatCount;
}
else if (this.wrapMode & WrapModeMask.Loop) {
this.repeatCount = Infinity;
}
}
/**
* !#en The current time of this animation in seconds.
* !#zh 动画当前的时间,秒。
* @property time
* @type {Number}
* @default 0
*/
this.time = 0;
this._timeNoScale = 0;
this._firstFramePlayed = false;
this._duringDelay = false;
// play
if (this.delay > 0) {
this._duringDelay = true;
}
}
JS.extend(AnimationNode, AnimationNodeBase);
JS.mixin(AnimationNode.prototype, {
update: function (delta) {
// calculate delay time
if (this._duringDelay) {
this._timeNoScale += delta;
if (this._timeNoScale < this.delay) {
// still waiting
return;
}
else {
this._duringDelay = false;
}
//// start play
// delta -= (this._timeNoScale - this.delay);
}
// make first frame perfect
//var playPerfectFirstFrame = (this.time === 0);
if (this._firstFramePlayed) {
this.time += (delta * this.speed);
}
else {
this._firstFramePlayed = true;
}
// sample
if (this.sample()) {
this.stop();
}
},
_needRevers: function (currentIterations) {
var wrapMode = this.wrapMode;
var needRevers = false;
if ((wrapMode & WrapModeMask.PingPong) === WrapModeMask.PingPong) {
var isEnd = currentIterations - (currentIterations | 0) === 0;
if (isEnd && (currentIterations > 0)) {
currentIterations -= 1;
}
var isOddIteration = currentIterations & 1;
if (isOddIteration) {
needRevers = !needRevers;
}
}
if ((wrapMode & WrapModeMask.Reverse) === WrapModeMask.Reverse) {
needRevers = !needRevers;
}
return needRevers;
},
getWrappedInfo: function (time) {
var stopped = false;
var duration = this.duration;
var ratio = 0;
var wrapMode = this.wrapMode;
var currentIterations = Math.abs(time / duration);
if (currentIterations > this.repeatCount) currentIterations = this.repeatCount;
var needRevers = false;
if (wrapMode & WrapModeMask.ShouldWrap) {
needRevers = this._needRevers(currentIterations);
}
var direction = needRevers ? -1 : 1;
if (this.speed < 0) direction *= -1;
if (currentIterations >= this.repeatCount) {
stopped = true;
var tempRatio = this.repeatCount - (this.repeatCount | 0);
if (tempRatio === 0) {
tempRatio = 1; // 如果播放过,动画不复位
}
time = tempRatio * duration * (time > 0 ? 1 : -1);
}
if (time > duration) {
var tempTime = time % duration;
time = tempTime === 0 ? duration : tempTime;
}
else if (time < 0) {
time = time % duration;
if (time !== 0 ) time += duration;
}
// calculate wrapped time
if (wrapMode & WrapModeMask.ShouldWrap) {
if (needRevers) time = duration - time;
}
ratio = time / duration;
return {
ratio: ratio,
time: time,
direction: direction,
stopped: stopped,
iterations: currentIterations
}
},
sample: function () {
// sample
var info = this.getWrappedInfo(this.time);
var curves = this.curves;
for (var i = 0, len = curves.length; i < len; i++) {
var curve = curves[i];
curve.sample(info.time, info.ratio, this);
}
return info.stopped;
}
});
cc.AnimationNode = AnimationNode;
module.exports = {
WrapModeMask: WrapModeMask,
WrapMode: WrapMode,
AnimationNode: AnimationNode,
};