/**************************************************************************** Copyright (c) 2008-2010 Ricardo Quesada Copyright (c) 2011-2012 cocos2d-x.org Copyright (c) 2013-2014 Chukong Technologies Inc. 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. ****************************************************************************/ /** * cc.Point is the class for point object, please do not use its constructor to create points, use cc.p() alias function instead. * @class cc.Point * @param {Number} x * @param {Number} y * @see cc.p */ cc.Point = function (x, y) { this.x = x || 0; this.y = y || 0; }; /** * Helper function that creates a cc.Point. * @function * @param {Number|cc.Point} x a Number or a size object * @param {Number} y * @return {cc.Point} * @example * var point1 = cc.p(); * var point2 = cc.p(100, 100); * var point3 = cc.p(point2); * var point4 = cc.p({x: 100, y: 100}); */ cc.p = function (x, y) { // This can actually make use of "hidden classes" in JITs and thus decrease // memory usage and overall performance drastically // return cc.p(x, y); // but this one will instead flood the heap with newly allocated hash maps // giving little room for optimization by the JIT, // note: we have tested this item on Chrome and firefox, it is faster than cc.p(x, y) if (x == undefined) return {x: 0, y: 0}; if (y == undefined) return {x: x.x, y: x.y}; return {x: x, y: y}; }; /** * Check whether a point's value equals to another * @function * @param {cc.Point} point1 * @param {cc.Point} point2 * @return {Boolean} */ cc.pointEqualToPoint = function (point1, point2) { return point1 && point2 && (point1.x === point2.x) && (point1.y === point2.y); }; /** * cc.Size is the class for size object, please do not use its constructor to create sizes, use cc.size() alias function instead. * @class cc.Size * @param {Number} width * @param {Number} height * @see cc.size */ cc.Size = function (width, height) { this.width = width || 0; this.height = height || 0; }; /** * Helper function that creates a cc.Size. * @function * @param {Number|cc.Size} w width or a size object * @param {Number} h height * @return {cc.Size} * @example * var size1 = cc.size(); * var size2 = cc.size(100,100); * var size3 = cc.size(size2); * var size4 = cc.size({width: 100, height: 100}); */ cc.size = function (w, h) { // This can actually make use of "hidden classes" in JITs and thus decrease // memory usage and overall performance drastically //return cc.size(w, h); // but this one will instead flood the heap with newly allocated hash maps // giving little room for optimization by the JIT // note: we have tested this item on Chrome and firefox, it is faster than cc.size(w, h) if (w === undefined) return {width: 0, height: 0}; if (h === undefined) return {width: w.width, height: w.height}; return {width: w, height: h}; }; /** * Check whether a point's value equals to another * @function * @param {cc.Size} size1 * @param {cc.Size} size2 * @return {Boolean} */ cc.sizeEqualToSize = function (size1, size2) { return (size1 && size2 && (size1.width == size2.width) && (size1.height == size2.height)); }; /** * cc.Rect is the class for rect object, please do not use its constructor to create rects, use cc.rect() alias function instead. * @class cc.Rect * @param {Number} width * @param {Number} height * @see cc.rect */ cc.Rect = function (x, y, width, height) { this.x = x||0; this.y = y||0; this.width = width||0; this.height = height||0; }; /** * Helper function that creates a cc.Rect. * @function * @param {Number|cc.Rect} x a number or a rect object * @param {Number} y * @param {Number} w * @param {Number} h * @returns {cc.Rect} * @example * var rect1 = cc.rect(); * var rect2 = cc.rect(100,100,100,100); * var rect3 = cc.rect(rect2); * var rect4 = cc.rect({x: 100, y: 100, width: 100, height: 100}); */ cc.rect = function (x, y, w, h) { if (x === undefined) return {x: 0, y: 0, width: 0, height: 0}; if (y === undefined) return {x: x.x, y: x.y, width: x.width, height: x.height}; return {x: x, y: y, width: w, height: h }; }; /** * Check whether a rect's value equals to another * @function * @param {cc.Rect} rect1 * @param {cc.Rect} rect2 * @return {Boolean} */ cc.rectEqualToRect = function (rect1, rect2) { return rect1 && rect2 && (rect1.x === rect2.x) && (rect1.y === rect2.y) && (rect1.width === rect2.width) && (rect1.height === rect2.height); }; cc._rectEqualToZero = function(rect){ return rect && (rect.x === 0) && (rect.y === 0) && (rect.width === 0) && (rect.height === 0); }; /** * Check whether the rect1 contains rect2 * @function * @param {cc.Rect} rect1 * @param {cc.Rect} rect2 * @return {Boolean} */ cc.rectContainsRect = function (rect1, rect2) { if (!rect1 || !rect2) return false; return !((rect1.x >= rect2.x) || (rect1.y >= rect2.y) || ( rect1.x + rect1.width <= rect2.x + rect2.width) || ( rect1.y + rect1.height <= rect2.y + rect2.height)); }; /** * Returns the rightmost x-value of a rect * @function * @param {cc.Rect} rect * @return {Number} The rightmost x value */ cc.rectGetMaxX = function (rect) { return (rect.x + rect.width); }; /** * Return the midpoint x-value of a rect * @function * @param {cc.Rect} rect * @return {Number} The midpoint x value */ cc.rectGetMidX = function (rect) { return (rect.x + rect.width / 2.0); }; /** * Returns the leftmost x-value of a rect * @function * @param {cc.Rect} rect * @return {Number} The leftmost x value */ cc.rectGetMinX = function (rect) { return rect.x; }; /** * Return the topmost y-value of a rect * @function * @param {cc.Rect} rect * @return {Number} The topmost y value */ cc.rectGetMaxY = function (rect) { return(rect.y + rect.height); }; /** * Return the midpoint y-value of `rect' * @function * @param {cc.Rect} rect * @return {Number} The midpoint y value */ cc.rectGetMidY = function (rect) { return rect.y + rect.height / 2.0; }; /** * Return the bottommost y-value of a rect * @function * @param {cc.Rect} rect * @return {Number} The bottommost y value */ cc.rectGetMinY = function (rect) { return rect.y; }; /** * Check whether a rect contains a point * @function * @param {cc.Rect} rect * @param {cc.Point} point * @return {Boolean} */ cc.rectContainsPoint = function (rect, point) { return (point.x >= cc.rectGetMinX(rect) && point.x <= cc.rectGetMaxX(rect) && point.y >= cc.rectGetMinY(rect) && point.y <= cc.rectGetMaxY(rect)) ; }; /** * Check whether a rect intersect with another * @function * @param {cc.Rect} rectA * @param {cc.Rect} rectB * @return {Boolean} */ cc.rectIntersectsRect = function (ra, rb) { var maxax = ra.x + ra.width, maxay = ra.y + ra.height, maxbx = rb.x + rb.width, maxby = rb.y + rb.height; return !(maxax < rb.x || maxbx < ra.x || maxay < rb.y || maxby < ra.y); }; /** * Check whether a rect overlaps another * @function * @param {cc.Rect} rectA * @param {cc.Rect} rectB * @return {Boolean} */ cc.rectOverlapsRect = function (rectA, rectB) { return !((rectA.x + rectA.width < rectB.x) || (rectB.x + rectB.width < rectA.x) || (rectA.y + rectA.height < rectB.y) || (rectB.y + rectB.height < rectA.y)); }; /** * Returns the smallest rectangle that contains the two source rectangles. * @function * @param {cc.Rect} rectA * @param {cc.Rect} rectB * @return {cc.Rect} */ cc.rectUnion = function (rectA, rectB) { var rect = cc.rect(0, 0, 0, 0); rect.x = Math.min(rectA.x, rectB.x); rect.y = Math.min(rectA.y, rectB.y); rect.width = Math.max(rectA.x + rectA.width, rectB.x + rectB.width) - rect.x; rect.height = Math.max(rectA.y + rectA.height, rectB.y + rectB.height) - rect.y; return rect; }; /** * Returns the overlapping portion of 2 rectangles * @function * @param {cc.Rect} rectA * @param {cc.Rect} rectB * @return {cc.Rect} */ cc.rectIntersection = function (rectA, rectB) { var intersection = cc.rect( Math.max(cc.rectGetMinX(rectA), cc.rectGetMinX(rectB)), Math.max(cc.rectGetMinY(rectA), cc.rectGetMinY(rectB)), 0, 0); intersection.width = Math.min(cc.rectGetMaxX(rectA), cc.rectGetMaxX(rectB)) - cc.rectGetMinX(intersection); intersection.height = Math.min(cc.rectGetMaxY(rectA), cc.rectGetMaxY(rectB)) - cc.rectGetMinY(intersection); return intersection; };