/****************************************************************************
Copyright (c) 2010-2012 cocos2d-x.org
Copyright (c) 2008-2010 Ricardo Quesada
Copyright (c) 2011 Zynga Inc.
Copyright (c) 2008 Radu Gruian
Copyright (c) 2011 Vit Valentin
http://www.cocos2d-x.org
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
Orignal code by Radu Gruian: http://www.codeproject.com/Articles/30838/Overhauser-Catmull-Rom-Splines-for-Camera-Animatio.So
Adapted to cocos2d-x by Vit Valentin
Adapted from cocos2d-x to cocos2d-iphone by Ricardo Quesada
****************************************************************************/
/**
*
Returns the Cardinal Spline position for a given set of control points, tension and time CatmullRom Spline formula:
* s(-ttt + 2tt - t)P1 + s(-ttt + tt)P2 + (2ttt - 3tt + 1)P2 + s(ttt - 2tt + t)P3 + (-2ttt + 3tt)P3 + s(ttt - tt)P4
*
* @function
* @param {cc.Point} p0
* @param {cc.Point} p1
* @param {cc.Point} p2
* @param {cc.Point} p3
* @param {Number} tension
* @param {Number} t
* @return {cc.Point}
*/
cc.CardinalSplineAt = function (p0, p1, p2, p3, tension, t) {
var t2 = t * t;
var t3 = t2 * t;
/*
* Formula: s(-ttt + 2tt - t)P1 + s(-ttt + tt)P2 + (2ttt - 3tt + 1)P2 + s(ttt - 2tt + t)P3 + (-2ttt + 3tt)P3 + s(ttt - tt)P4
*/
var s = (1 - tension) / 2;
var b1 = s * ((-t3 + (2 * t2)) - t); // s(-t3 + 2 t2 - t)P1
var b2 = s * (-t3 + t2) + (2 * t3 - 3 * t2 + 1); // s(-t3 + t2)P2 + (2 t3 - 3 t2 + 1)P2
var b3 = s * (t3 - 2 * t2 + t) + (-2 * t3 + 3 * t2); // s(t3 - 2 t2 + t)P3 + (-2 t3 + 3 t2)P3
var b4 = s * (t3 - t2); // s(t3 - t2)P4
var x = (p0.x * b1 + p1.x * b2 + p2.x * b3 + p3.x * b4);
var y = (p0.y * b1 + p1.y * b2 + p2.y * b3 + p3.y * b4);
return cc.p(x, y);
};
/**
* returns a new copy of the array reversed.
* @return {Array}
*/
cc.reverseControlPoints = function (controlPoints) {
var newArray = [];
for (var i = controlPoints.length - 1; i >= 0; i--) {
newArray.push(cc.p(controlPoints[i].x, controlPoints[i].y));
}
return newArray;
};
cc.copyControlPoints = function (controlPoints) {
var newArray = [];
for (var i = 0; i < controlPoints.length; i++)
newArray.push(cc.p(controlPoints[i].x, controlPoints[i].y));
return newArray;
};
/**
* returns a point from the array
* @param {Array} controlPoints
* @param {Number} pos
* @return {Array}
*/
cc.getControlPointAt = function (controlPoints, pos) {
var p = Math.min(controlPoints.length - 1, Math.max(pos, 0));
return controlPoints[p];
};
/**
* reverse the current control point array inline, without generating a new one
*/
cc.reverseControlPointsInline = function (controlPoints) {
var len = controlPoints.length;
var mid = 0 | (len / 2);
for (var i = 0; i < mid; ++i) {
var temp = controlPoints[i];
controlPoints[i] = controlPoints[len - i - 1];
controlPoints[len - i - 1] = temp;
}
};
/**
* Cardinal Spline path. http://en.wikipedia.org/wiki/Cubic_Hermite_spline#Cardinal_spline
* @class
* @extends cc.ActionInterval
*
* @example
* //create a cc.CardinalSplineTo
* var action1 = cc.CardinalSplineTo.create(3, array, 0);
*/
cc.CardinalSplineTo = cc.ActionInterval.extend(/** @lends cc.CardinalSplineTo# */{
/** Array of control points */
_points:null,
_deltaT:0,
_tension:0,
_previousPosition:null,
_accumulatedDiff:null,
/**
* Constructor
*/
ctor:function () {
cc.ActionInterval.prototype.ctor.call(this);
this._points = [];
this._deltaT = 0;
this._tension = 0;
this._previousPosition = null;
this._accumulatedDiff = null;
},
/**
* initializes the action with a duration and an array of points
* @param {Number} duration
* @param {Array} points array of control points
* @param {Number} tension
* @return {Boolean}
*/
initWithDuration:function (duration, points, tension) {
if(!points || points.length == 0)
throw "Invalid configuration. It must at least have one control point";
if (cc.ActionInterval.prototype.initWithDuration.call(this, duration)) {
this.setPoints(points);
this._tension = tension;
return true;
}
return false;
},
/**
* returns a new clone of the action
* @returns {cc.CardinalSplineTo}
*/
clone:function () {
var action = new cc.CardinalSplineTo();
action.initWithDuration(this._duration, cc.copyControlPoints(this._points), this._tension);
return action;
},
/**
* @param {cc.Node} target
*/
startWithTarget:function (target) {
cc.ActionInterval.prototype.startWithTarget.call(this, target);
// Issue #1441 from cocos2d-iphone
this._deltaT = 1 / (this._points.length - 1);
var locPosition = this._target.getPosition();
this._previousPosition = cc.p(locPosition.x, locPosition.y);
this._accumulatedDiff = cc.p(0, 0);
},
/**
* @param {Number} time
*/
update:function (time) {
var p, lt;
var ps = this._points;
// eg.
// p..p..p..p..p..p..p
// 1..2..3..4..5..6..7
// want p to be 1, 2, 3, 4, 5, 6
if (time == 1) {
p = ps.length - 1;
lt = 1;
} else {
var locDT = this._deltaT;
p = 0 | (time / locDT);
lt = (time - locDT * p) / locDT;
}
var newPos = cc.CardinalSplineAt(
cc.getControlPointAt(ps, p - 1),
cc.getControlPointAt(ps, p - 0),
cc.getControlPointAt(ps, p + 1),
cc.getControlPointAt(ps, p + 2),
this._tension, lt);
if (cc.ENABLE_STACKABLE_ACTIONS) {
var tempX, tempY;
tempX = this._target.getPositionX() - this._previousPosition.x;
tempY = this._target.getPositionY() - this._previousPosition.y;
if (tempX != 0 || tempY != 0) {
var locAccDiff = this._accumulatedDiff;
tempX = locAccDiff.x + tempX;
tempY = locAccDiff.y + tempY;
locAccDiff.x = tempX;
locAccDiff.y = tempY;
newPos.x += tempX;
newPos.y += tempY;
}
}
this.updatePosition(newPos);
},
/**
* reverse a new cc.CardinalSplineTo
* @return {cc.CardinalSplineTo}
*/
reverse:function () {
var reversePoints = cc.reverseControlPoints(this._points);
return cc.CardinalSplineTo.create(this._duration, reversePoints, this._tension);
},
/**
* update position of target
* @param {cc.Point} newPos
*/
updatePosition:function (newPos) {
this._target.setPosition(newPos);
this._previousPosition = newPos;
},
/**
* Points getter
* @return {Array}
*/
getPoints:function () {
return this._points;
},
/**
* Points setter
* @param {Array} points
*/
setPoints:function (points) {
this._points = points;
}
});
/**
* creates an action with a Cardinal Spline array of points and tension
* @function
* @param {Number} duration
* @param {Array} points array of control points
* @param {Number} tension
* @return {cc.CardinalSplineTo}
*
* @example
* //create a cc.CardinalSplineTo
* var action1 = cc.CardinalSplineTo.create(3, array, 0);
*/
cc.CardinalSplineTo.create = function (duration, points, tension) {
var ret = new cc.CardinalSplineTo();
if (ret.initWithDuration(duration, points, tension)) {
return ret;
}
return null;
};
/**
* Cardinal Spline path. http://en.wikipedia.org/wiki/Cubic_Hermite_spline#Cardinal_spline
* @class
* @extends cc.CardinalSplineTo
*
* @example
* //create a cc.CardinalSplineBy
* var action1 = cc.CardinalSplineBy.create(3, array, 0);
*/
cc.CardinalSplineBy = cc.CardinalSplineTo.extend(/** @lends cc.CardinalSplineBy# */{
_startPosition:null,
/**
* Constructor
*/
ctor:function () {
cc.CardinalSplineTo.prototype.ctor.call(this);
this._startPosition = cc.p(0, 0);
},
/**
* @param {cc.Node} target
*/
startWithTarget:function (target) {
cc.CardinalSplineTo.prototype.startWithTarget.call(this, target);
var locPosition = target.getPosition();
this._startPosition.x = locPosition.x;
this._startPosition.y = locPosition.y;
},
/**
* reverse a new cc.CardinalSplineBy
* @return {cc.CardinalSplineBy}
*/
reverse:function () {
var copyConfig = this._points.slice();
var current;
//
// convert "absolutes" to "diffs"
//
var p = copyConfig[0];
for (var i = 1; i < copyConfig.length; ++i) {
current = copyConfig[i];
copyConfig[i] = cc.pSub(current, p);
p = current;
}
// convert to "diffs" to "reverse absolute"
var reverseArray = cc.reverseControlPoints(copyConfig);
// 1st element (which should be 0,0) should be here too
p = reverseArray[ reverseArray.length - 1 ];
reverseArray.pop();
p.x = -p.x;
p.y = -p.y;
reverseArray.unshift(p);
for (var i = 1; i < reverseArray.length; ++i) {
current = reverseArray[i];
current.x = -current.x;
current.y = -current.y;
current.x += p.x;
current.y += p.y;
reverseArray[i] = current;
p = current;
}
return cc.CardinalSplineBy.create(this._duration, reverseArray, this._tension);
},
/**
* update position of target
* @param {cc.Point} newPos
*/
updatePosition:function (newPos) {
var pos = this._startPosition;
var posX = newPos.x + pos.x;
var posY = newPos.y + pos.y;
this._target.setPosition(posX, posY);
this._previousPosition.x = posX;
this._previousPosition.y = posY;
},
/**
* returns a new clone of the action
* @returns {cc.CardinalSplineBy}
*/
clone:function () {
var a = new cc.CardinalSplineBy();
a.initWithDuration(this._duration, cc.copyControlPoints(this._points), this._tension);
return a;
}
});
/**
* creates an action with a Cardinal Spline array of points and tension
* @function
* @param {Number} duration
* @param {Array} points
* @param {Number} tension
* @return {cc.CardinalSplineBy}
*/
cc.CardinalSplineBy.create = function (duration, points, tension) {
var ret = new cc.CardinalSplineBy();
if (ret.initWithDuration(duration, points, tension))
return ret;
return null;
};
/**
*
* An action that moves the target with a CatmullRom curve to a destination point.
* A Catmull Rom is a Cardinal Spline with a tension of 0.5.
* http://en.wikipedia.org/wiki/Cubic_Hermite_spline#Catmull.E2.80.93Rom_spline
*
* @class
* @extends cc.CardinalSplineTo
*
* @example
* var action1 = cc.CatmullRomTo.create(3, array);
*/
cc.CatmullRomTo = cc.CardinalSplineTo.extend(/** @lends cc.CatmullRomTo# */{
/**
* initializes the action with a duration and an array of points
*/
initWithDuration:function (dt, points) {
return cc.CardinalSplineTo.prototype.initWithDuration.call(this, dt, points, 0.5);
},
/**
* returns a new clone of the action
* @returns {cc.CatmullRomTo}
*/
clone:function () {
var action = new cc.CatmullRomTo();
action.initWithDuration(this._duration, cc.copyControlPoints(this._points));
return action;
}
});
/**
* creates an action with a Cardinal Spline array of points and tension
* @param {Number} dt
* @param {Array} points
* @return {cc.CatmullRomTo}
*
* @example
* var action1 = cc.CatmullRomTo.create(3, array);
*/
cc.CatmullRomTo.create = function (dt, points) {
var ret = new cc.CatmullRomTo();
if (ret.initWithDuration(dt, points))
return ret;
return null;
};
/**
*
* An action that moves the target with a CatmullRom curve by a certain distance.
* A Catmull Rom is a Cardinal Spline with a tension of 0.5.
* http://en.wikipedia.org/wiki/Cubic_Hermite_spline#Catmull.E2.80.93Rom_spline
*
* @class
* @extends cc.CardinalSplineBy
*
* @example
* var action1 = cc.CatmullRomBy.create(3, array);
*/
cc.CatmullRomBy = cc.CardinalSplineBy.extend({
/** initializes the action with a duration and an array of points */
initWithDuration:function (dt, points) {
return cc.CardinalSplineTo.prototype.initWithDuration.call(this, dt, points, 0.5);
},
/**
* returns a new clone of the action
* @returns {cc.CatmullRomBy}
*/
clone:function () {
var action = new cc.CatmullRomBy();
action.initWithDuration(this._duration, cc.copyControlPoints(this._points));
return action;
}
});
/**
* creates an action with a Cardinal Spline array of points and tension
*
* @example
* var action1 = cc.CatmullRomBy.create(3, array);
*/
cc.CatmullRomBy.create = function (dt, points) {
var ret = new cc.CatmullRomBy();
if (ret.initWithDuration(dt, points))
return ret;
return null;
};