Functions and constants for NSPoint.

//NSPointFunctions_CocoaDevUsersAdditions.h

#import <Cocoa/Cocoa.h> #import #import /* Standard C lib that contains some constants, look at http://www.acm.uiuc.edu/webmonkeys/book/c_guide/2.4.html -- JP */

const NSPoint NSFarAwayPoint = {FLT_MAX, FLT_MAX}; // FLT_MAX = 1E+27. – JP

static inline NSPoint NSAddPoints(NSPoint firstPoint, NSPoint secondPoint) { return NSMakePoint(firstPoint.x+secondPoint.x, firstPoint.y+secondPoint.y); }

static inline NSPoint NSSubtractPoints(NSPoint firstPoint, NSPoint secondPoint) { return NSMakePoint(firstPoint.x-secondPoint.x, firstPoint.y-secondPoint.y); }

static inline NSPoint NSOffsetPoint(NSPoint point, float amountX, float amountY) { return NSAddPoints(point, NSMakePoint(amountX, amountY)); }

static inline NSPoint NSReflectedPointAboutXAxis(NSPoint point) { return NSMakePoint(-point.x, point.y); }

static inline NSPoint NSReflectedPointAboutYAxis(NSPoint point) { return NSMakePoint(point.x, -point.y); }

static inline NSPoint NSReflectedPointAboutOrigin(NSPoint point) { return NSMakePoint(-point.x, -point.y); }

static inline NSPoint NSTransformedPoint(NSPoint point,NSAffineTransform *transform) { return [transform transformPoint:point]; }

static inline NSPoint NSCartesianToPolar(NSPoint cartesianPoint) { return NSMakePoint(sqrtf(cartesianPoint.xcartesianPoint.x+cartesianPoint.ycartesianPoint.y), atan2f(cartesianPoint.y,cartesianPoint.x)); }

static inline NSPoint NSPolarToCartesian(NSPoint polarPoint) { return NSMakePoint(polarPoint.xcosf(polarPoint.y), polarPoint.xsinf(polarPoint.y)); }

Maybe they should be split into NSPolarAngle(NSPoint point) and NSPolarRadius(NSPoint point) unless we’re going to make an NSPolarPoint.

Personally, I don’t care that much. (: But someone else can if they want, certainly. Conversion between Cartesian and Polar coordinates would be nice, though, if a new struct were made.

Something should be done : split or new struct

Isn’t there some function for converting a point to a string? NSStringFromPoint() in the Foundation API

Otherwise this could be wrapped in a class with four methods returning the different co-ordinates. But if we did that it may as well handle more than two dimensions, and I suspect the whole point of these functions is that they’re just little fast things to make the point that we don’t need an NSPoint class. :)

– AngelaBrett

If you want a class that handles an arbitrary number of dimensions, ask me about LSVector. It’s a reasonably well-tested (although not with UnitTests) nesting vector class.

– RobRix

How about using hypot(a, b) for the radius part of the cartesian-to-polar conversion? It does the whole sqrt(a^2+b^2) thing for you pretty fast. Plus its a whole lot easier to type. Also, there is an issue with using atan(y/x), since nothing over Pi radians will be correct. And when x is 0 there is a minor issue with infinity. A cartesian to polar conversion isn’t possible in one (efficient) line as far as I can figure out.

What I usually do is find the asin of fabs(y)/hypot, then put in a case for each quadrant. For quadrant I, keep the asin, for II, it’s pi - asin, for III, pi + asin, and for IV, 2*pi - asin. That usually works out alright for me. I have missed the conversion a lot of times before, though, so feel free to correct me. And if you have a simpler method, I’d love to hear it. Adios!

– BrianMoore

Some changes on the cartesian to polar function�:

• x*x is more efficient than x^2

• atanf is a bad solution : return an angle between 0 and pi, not between 0 and 2*pi. Use atan2f instead.

– DamienBob