/**************************************************************************** Copyright (c) 2010 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. ****************************************************************************/ #ifndef __CCGEMETRY_H__ #define __CCGEMETRY_H__ #include "platform/CCPlatformMacros.h" #include "CCObject.h" #include NS_CC_BEGIN /** * @addtogroup data_structures * @{ */ // for Point assignement operator and copy constructor class CC_DLL Size; class CC_DLL Point { public: float x; float y; public: Point(); Point(float x, float y); Point(const Point& other); Point(const Size& size); Point& operator= (const Point& other); Point& operator= (const Size& size); Point operator+(const Point& right) const; Point operator-(const Point& right) const; Point operator-() const; Point operator*(float a) const; Point operator/(float a) const; void setPoint(float x, float y); bool equals(const Point& target) const; /** @returns if points have fuzzy equality which means equal with some degree of variance. @since v2.1.4 */ bool fuzzyEquals(const Point& target, float variance) const; /** Calculates distance between point an origin @return float @since v2.1.4 */ inline float getLength() const { return sqrtf(x*x + y*y); }; /** Calculates the square length of a Point (not calling sqrt() ) @return float @since v2.1.4 */ inline float getLengthSq() const { return dot(*this); //x*x + y*y; }; /** Calculates the square distance between two points (not calling sqrt() ) @return float @since v2.1.4 */ inline float getDistanceSq(const Point& other) const { return (*this - other).getLengthSq(); }; /** Calculates the distance between two points @return float @since v2.1.4 */ inline float getDistance(const Point& other) const { return (*this - other).getLength(); }; /** @returns the angle in radians between this vector and the x axis @since v2.1.4 */ inline float getAngle() const { return atan2f(y, x); }; /** @returns the angle in radians between two vector directions @since v2.1.4 */ float getAngle(const Point& other) const; /** Calculates dot product of two points. @return float @since v2.1.4 */ inline float dot(const Point& other) const { return x*other.x + y*other.y; }; /** Calculates cross product of two points. @return float @since v2.1.4 */ inline float cross(const Point& other) const { return x*other.y - y*other.x; }; /** Calculates perpendicular of v, rotated 90 degrees counter-clockwise -- cross(v, perp(v)) >= 0 @return Point @since v2.1.4 */ inline Point getPerp() const { return Point(-y, x); }; /** Calculates perpendicular of v, rotated 90 degrees clockwise -- cross(v, rperp(v)) <= 0 @return Point @since v2.1.4 */ inline Point getRPerp() const { return Point(y, -x); }; /** Calculates the projection of this over other. @return Point @since v2.1.4 */ inline Point project(const Point& other) const { return other * (dot(other)/other.dot(other)); }; /** Complex multiplication of two points ("rotates" two points). @return Point vector with an angle of this.getAngle() + other.getAngle(), and a length of this.getLength() * other.getLength(). @since v2.1.4 */ inline Point rotate(const Point& other) const { return Point(x*other.x - y*other.y, x*other.y + y*other.x); }; /** Unrotates two points. @return Point vector with an angle of this.getAngle() - other.getAngle(), and a length of this.getLength() * other.getLength(). @since v2.1.4 */ inline Point unrotate(const Point& other) const { return Point(x*other.x + y*other.y, y*other.x - x*other.y); }; /** Returns point multiplied to a length of 1. * If the point is 0, it returns (1, 0) @return Point @since v2.1.4 */ inline Point normalize() const { float length = getLength(); if(length == 0.) return Point(1.f, 0); return *this / getLength(); }; /** Linear Interpolation between two points a and b @returns alpha == 0 ? a alpha == 1 ? b otherwise a value between a..b @since v2.1.4 */ inline Point lerp(const Point& other, float alpha) const { return *this * (1.f - alpha) + other * alpha; }; /** Rotates a point counter clockwise by the angle around a pivot @param pivot is the pivot, naturally @param angle is the angle of rotation ccw in radians @returns the rotated point @since v2.1.4 */ Point rotateByAngle(const Point& pivot, float angle) const; static inline Point forAngle(const float a) { return Point(cosf(a), sinf(a)); } }; class CC_DLL Size { public: float width; float height; public: Size(); Size(float width, float height); Size(const Size& other); Size(const Point& point); Size& operator= (const Size& other); Size& operator= (const Point& point); Size operator+(const Size& right) const; Size operator-(const Size& right) const; Size operator*(float a) const; Size operator/(float a) const; void setSize(float width, float height); bool equals(const Size& target) const; }; class CC_DLL Rect { public: Point origin; Size size; public: Rect(); Rect(float x, float y, float width, float height); Rect(const Rect& other); Rect& operator= (const Rect& other); void setRect(float x, float y, float width, float height); float getMinX() const; /// return the leftmost x-value of current rect float getMidX() const; /// return the midpoint x-value of current rect float getMaxX() const; /// return the rightmost x-value of current rect float getMinY() const; /// return the bottommost y-value of current rect float getMidY() const; /// return the midpoint y-value of current rect float getMaxY() const; /// return the topmost y-value of current rect bool equals(const Rect& rect) const; bool containsPoint(const Point& point) const; bool intersectsRect(const Rect& rect) const; Rect unionWithRect(const Rect & rect) const; }; #define CCPointMake(x, y) Point((float)(x), (float)(y)) #define CCSizeMake(width, height) Size((float)(width), (float)(height)) #define CCRectMake(x, y, width, height) Rect((float)(x), (float)(y), (float)(width), (float)(height)) const Point PointZero = CCPointMake(0,0); /* The "zero" size -- equivalent to CCSizeMake(0, 0). */ const Size SizeZero = CCSizeMake(0,0); /* The "zero" rectangle -- equivalent to CCRectMake(0, 0, 0, 0). */ const Rect RectZero = CCRectMake(0,0,0,0); // end of data_structure group /// @} NS_CC_END #endif // __CCGEMETRY_H__