mirror of
https://github.com/cocos/cocos4.git
synced 2026-11-20 23:52:40 +08:00
366 lines
9.7 KiB
JavaScript
366 lines
9.7 KiB
JavaScript
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,
|
||
};
|