/**************************************************************************** Copyright (c) 2013 cocos2d-x.org 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. ****************************************************************************/ /** Add deprecated global functions and variables here */ #ifndef __COCOS2D_CCDEPRECATED_H__ #define __COCOS2D_CCDEPRECATED_H__ #include #include "cocoa/CCGeometry.h" #include "ccTypes.h" NS_CC_BEGIN /** * @addtogroup data_structures * @{ */ /** Helper macro that creates a Point @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE inline Point ccp(float x, float y) { return Point(x, y); } /** Returns opposite of point. @return Point @since v0.7.2 @deprecated please use Point::-, for example: -v1 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpNeg(const Point& v) { return -v; } /** Calculates sum of two points. @return Point @since v0.7.2 @deprecated please use Point::+, for example: v1 + v2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpAdd(const Point& v1, const Point& v2) { return v1 + v2; } /** Calculates difference of two points. @return Point @since v0.7.2 @deprecated please use Point::-, for example: v1 - v2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpSub(const Point& v1, const Point& v2) { return v1 - v2; } /** Returns point multiplied by given factor. @return Point @since v0.7.2 @deprecated please use Point::*, for example: v1 * v2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpMult(const Point& v, const float s) { return v * s; } /** Calculates midpoint between two points. @return Point @since v0.7.2 @deprecated please use it like (v1 + v2) / 2.0f */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpMidpoint(const Point& v1, const Point& v2) { return v1.getMidpoint(v2); } /** Calculates dot product of two points. @return float @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpDot(const Point& v1, const Point& v2) { return v1.dot(v2); } /** Calculates cross product of two points. @return float @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpCross(const Point& v1, const Point& v2) { return v1.cross(v2); } /** Calculates perpendicular of v, rotated 90 degrees counter-clockwise -- cross(v, perp(v)) >= 0 @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpPerp(const Point& v) { return v.getPerp(); } /** Calculates perpendicular of v, rotated 90 degrees clockwise -- cross(v, rperp(v)) <= 0 @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpRPerp(const Point& v) { return v.getRPerp(); } /** Calculates the projection of v1 over v2. @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpProject(const Point& v1, const Point& v2) { return v1.project(v2); } /** Rotates two points. @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpRotate(const Point& v1, const Point& v2) { return v1.rotate(v2); } /** Unrotates two points. @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpUnrotate(const Point& v1, const Point& v2) { return v1.unrotate(v2); } /** Calculates the square length of a Point (not calling sqrt() ) @return float @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpLengthSQ(const Point& v) { return v.getLengthSq(); } /** Calculates the square distance between two points (not calling sqrt() ) @return float @since v1.1 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpDistanceSQ(const Point p1, const Point p2) { return (p1 - p2).getLengthSq(); } /** Calculates distance between point an origin @return float @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpLength(const Point& v) { return v.getLength(); } /** Calculates the distance between two points @return float @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpDistance(const Point& v1, const Point& v2) { return v1.getDistance(v2); } /** Returns point multiplied to a length of 1. @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpNormalize(const Point& v) { return v.normalize(); } /** Converts radians to a normalized vector. @return Point @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpForAngle(const float a) { return Point::forAngle(a); } /** Converts a vector to radians. @return float @since v0.7.2 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpToAngle(const Point& v) { return v.getAngle(); } /** Clamp a point between from and to. @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpClamp(const Point& p, const Point& from, const Point& to) { return p.getClampPoint(from, to); } /** Quickly convert Size to a Point @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpFromSize(const Size& s) { return Point(s); } /** Run a math operation function on each point component * absf, fllorf, ceilf, roundf * any function that has the signature: float func(float); * For example: let's try to take the floor of x,y * ccpCompOp(p,floorf); @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpCompOp(const Point& p, float (*opFunc)(float)) { return p.compOp(opFunc); } /** Linear Interpolation between two points a and b @returns alpha == 0 ? a alpha == 1 ? b otherwise a value between a..b @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpLerp(const Point& a, const Point& b, float alpha) { return a.lerp(b, alpha); } /** @returns if points have fuzzy equality which means equal with some degree of variance. @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline bool ccpFuzzyEqual(const Point& a, const Point& b, float variance) { return a.fuzzyEquals(b, variance); } /** Multiplies a and b components, a.x*b.x, a.y*b.y @returns a component-wise multiplication @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpCompMult(const Point& a, const Point& b) { return Point(a.x * b.x, a.y * b.y); } /** @returns the signed angle in radians between two vector directions @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpAngleSigned(const Point& a, const Point& b) { return a.getAngle(b); } /** @returns the angle in radians between two vector directions @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline float ccpAngle(const Point& a, const Point& b) { return a.getAngle(b); } /** Rotates a point counter clockwise by the angle around a pivot @param v is the point to rotate @param pivot is the pivot, naturally @param angle is the angle of rotation cw in radians @returns the rotated point @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpRotateByAngle(const Point& v, const Point& pivot, float angle) { return v.rotateByAngle(pivot, angle); } /** A general line-line intersection test @param p1 is the startpoint for the first line P1 = (p1 - p2) @param p2 is the endpoint for the first line P1 = (p1 - p2) @param p3 is the startpoint for the second line P2 = (p3 - p4) @param p4 is the endpoint for the second line P2 = (p3 - p4) @param s is the range for a hitpoint in P1 (pa = p1 + s*(p2 - p1)) @param t is the range for a hitpoint in P3 (pa = p2 + t*(p4 - p3)) @return bool indicating successful intersection of a line note that to truly test intersection for segments we have to make sure that s & t lie within [0..1] and for rays, make sure s & t > 0 the hit point is p3 + t * (p4 - p3); the hit point also is p1 + s * (p2 - p1); @since v0.99.1 */ CC_DEPRECATED_ATTRIBUTE static inline bool ccpLineIntersect(const Point& p1, const Point& p2, const Point& p3, const Point& p4, float *s, float *t) { return Point::isLineIntersect(p1, p2, p3, p4, s, t); } /* ccpSegmentIntersect returns YES if Segment A-B intersects with segment C-D @since v1.0.0 */ CC_DEPRECATED_ATTRIBUTE static inline bool ccpSegmentIntersect(const Point& A, const Point& B, const Point& C, const Point& D) { return Point::isSegmentIntersect(A, B, C, D); } /* ccpIntersectPoint returns the intersection point of line A-B, C-D @since v1.0.0 */ CC_DEPRECATED_ATTRIBUTE static inline Point ccpIntersectPoint(const Point& A, const Point& B, const Point& C, const Point& D) { return Point::getIntersectPoint(A, B, C, D); } CC_DEPRECATED_ATTRIBUTE inline Point CCPointMake(float x, float y) { return Point(x, y); } CC_DEPRECATED_ATTRIBUTE inline Size CCSizeMake(float width, float height) { return Size(width, height); } CC_DEPRECATED_ATTRIBUTE inline Rect CCRectMake(float x, float y, float width, float height) { return Rect(x, y, width, height); } CC_DEPRECATED_ATTRIBUTE const Point PointZero = Point::ZERO; /* The "zero" size -- equivalent to Size(0, 0). */ CC_DEPRECATED_ATTRIBUTE const Size SizeZero = Size::ZERO; /* The "zero" rectangle -- equivalent to Rect(0, 0, 0, 0). */ CC_DEPRECATED_ATTRIBUTE const Rect RectZero = Rect::ZERO; CC_DEPRECATED_ATTRIBUTE const Color3B ccWHITE = Color3B::WHITE; CC_DEPRECATED_ATTRIBUTE const Color3B ccYELLOW = Color3B::YELLOW; CC_DEPRECATED_ATTRIBUTE const Color3B ccGREEN = Color3B::GREEN; CC_DEPRECATED_ATTRIBUTE const Color3B ccBLUE = Color3B::BLUE; CC_DEPRECATED_ATTRIBUTE const Color3B ccRED = Color3B::RED; CC_DEPRECATED_ATTRIBUTE const Color3B ccMAGENTA = Color3B::MAGENTA; CC_DEPRECATED_ATTRIBUTE const Color3B ccBLACK = Color3B::BLACK; CC_DEPRECATED_ATTRIBUTE const Color3B ccORANGE = Color3B::ORANGE; CC_DEPRECATED_ATTRIBUTE const Color3B ccGRAY = Color3B::GRAY; CC_DEPRECATED_ATTRIBUTE const BlendFunc kBlendFuncDisable = BlendFunc::BLEND_FUNC_DISABLE; CC_DEPRECATED_ATTRIBUTE static inline Color3B ccc3(GLubyte r, GLubyte g, GLubyte b) { return Color3B(r, g, b); } CC_DEPRECATED_ATTRIBUTE static inline bool ccc3BEqual(const Color3B &col1, const Color3B &col2) { return col1.r == col2.r && col1.g == col2.g && col1.b == col2.b; } CC_DEPRECATED_ATTRIBUTE static inline Color4B ccc4(const GLubyte r, const GLubyte g, const GLubyte b, const GLubyte o) { return Color4B(r, g, b, o); } CC_DEPRECATED_ATTRIBUTE static inline Color4F ccc4FFromccc3B(Color3B c) { return Color4F(c.r/255.f, c.g/255.f, c.b/255.f, 1.f); } CC_DEPRECATED_ATTRIBUTE static inline Color4F ccc4f(const GLfloat r, const GLfloat g, const GLfloat b, const GLfloat a) { return Color4F(r, g, b, a); } CC_DEPRECATED_ATTRIBUTE static inline Color4F ccc4FFromccc4B(Color4B c) { return Color4F(c.r/255.f, c.g/255.f, c.b/255.f, c.a/255.f); } CC_DEPRECATED_ATTRIBUTE static inline Color4B ccc4BFromccc4F(Color4F c) { return Color4B((GLubyte)(c.r*255), (GLubyte)(c.g*255), (GLubyte)(c.b*255), (GLubyte)(c.a*255)); } CC_DEPRECATED_ATTRIBUTE static inline bool ccc4FEqual(Color4F a, Color4F b) { return a.r == b.r && a.g == b.g && a.b == b.b && a.a == b.a; } // end of data_structures group /// @} NS_CC_END #endif // __COCOS2D_CCDEPRECATED_H__