ChipmunkSpace.h

@interface ChipmunkSpace : NSObject {
@private
  cpSpace _space;
  ChipmunkBody *_staticBody;
  
  NSMutableSet *_children;
  NSMutableArray *_handlers;
  
  id _data;
}

@property int iterations;

@property cpVect gravity;

@property cpFloat damping;

@property cpFloat idleSpeedThreshold;

@property cpFloat sleepTimeThreshold;

/*
  Amount of encouraged penetration between colliding shapes..
  Used to reduce oscillating contacts and keep the collision cache warm.
  Defaults to 0.1. If you have poor simulation quality,
  increase this number as much as possible without allowing visible amounts of overlap.
*/
@property cpFloat collisionSlop;

/*
  Determines how fast overlapping shapes are pushed apart.
  Expressed as a fraction of the error remaining after each second.
  Defaults to pow(1.0 - 0.1, 60.0) meaning that Chipmunk fixes 10% of overlap each frame at 60Hz.
*/
@property cpFloat collisionBias;

/*
  Number of frames that contact information should persist.
  Defaults to 3. There is probably never a reason to change this value.
*/
@property cpTimestamp collisionPersistence;

/*
  Rebuild the contact graph during each step. Must be enabled to use the cpBodyEachArbiter() function.
  Disabled by default for a small performance boost. Enabled implicitly when the sleeping feature is enabled.
*/
@property bool enableContactGraph;

@property (readonly) cpSpace *space;

@property (readonly) ChipmunkBody *staticBody;

@property (readonly) cpFloat currentTimeStep;

@property (assign) id data;

#define CHIPMUNK_ARBITER_GET_SHAPES(arb, a, b) ChipmunkShape *a, *b; { \
  cpShape *shapeA, *shapeB; \
  cpArbiterGetShapes(arb, &shapeA, &shapeB); \
  a = shapeA->data; b = shapeB->data; \
}

- (void)setDefaultCollisionHandler:(id)target
  begin:(SEL)begin
  preSolve:(SEL)preSolve
  postSolve:(SEL)postSolve
  separate:(SEL)separate;

- (void)addCollisionHandler:(id)target
  typeA:(id)a typeB:(id)b
  begin:(SEL)begin
  preSolve:(SEL)preSolve
  postSolve:(SEL)postSolve
  separate:(SEL)separate;


// TODO these might be a really bad idea as they will not call subclass methods.
// The following two methods use the [shape data] object as the collision handler.
// In order to cache the method lookups, it needs to know the class of the object.
// This means that [shape data] objects _must_ be a direct instance of klass and never a subclass.
// See OneWay.m for an example.

- (void)addShapeAHandler:(Class)klass
  typeA:(id)a typeB:(id)b
  begin:(SEL)begin
  preSolve:(SEL)preSolve
  postSolve:(SEL)postSolve
  separate:(SEL)separate
 __attribute__((deprecated));

- (void)addShapeBHandler:(Class)klass
  typeA:(id)a typeB:(id)b
  begin:(SEL)begin
  preSolve:(SEL)preSolve
  postSolve:(SEL)postSolve
  separate:(SEL)separate
 __attribute__((deprecated));

- (void)removeCollisionHandlerForTypeA:(id)a andB:(id)b;

- (id)add:(NSObject<ChipmunkObject> *)obj;

- (void)addBaseObjects:(id <NSFastEnumeration>)objects;

- (id)remove:(NSObject<ChipmunkObject> *)obj;

- (void)removeBaseObjects:(id <NSFastEnumeration>)objects;

- (void)addPostStepCallback:(id)target selector:(SEL)selector key:(id)key;

- (void)addPostStepRemoval:(id <ChipmunkObject>)obj;

- (NSArray *)pointQueryAll:(cpVect)point layers:(cpLayers)layers group:(id)group;

// TODO?
//- (void)pointQuery:(cpVect)point layers:(cpLayers)layers group:(id)group target:(id)target selector:(SEL)selector;

- (ChipmunkShape *)pointQueryFirst:(cpVect)point layers:(cpLayers)layers group:(id)group;

- (NSArray *)segmentQueryAllFrom:(cpVect)start to:(cpVect)end layers:(cpLayers)layers group:(id)group;

// TODO?
//- (void)segmentQueryFrom:(cpVect)start to:(cpVect)end layers:(cpLayers)layers group:(id)group target:(id)target selector:(SEL)selector;

- (ChipmunkSegmentQueryInfo *)segmentQueryFirstFrom:(cpVect)start to:(cpVect)end layers:(cpLayers)layers group:(id)group;

- (NSArray *)bbQueryAll:(cpBB)bb layers:(cpLayers)layers group:(id)group;

// TODO?
//- (void)bbQuery:(cpBB)bb layers:(cpLayers)layers group:(id)group target:(id)target selector:(SEL)selector;

- (NSArray *)shapeQueryAll:(ChipmunkShape *)shape;

- (BOOL)shapeTest:shape;

- (void)activateShapesTouchingShape:(ChipmunkShape *)shape;

- (NSArray *)bodies;

- (NSArray *)shapes;

- (NSArray *)constraints;

- (void)reindexStatic;

- (void)reindexShape:(ChipmunkShape *)shape;

- (void)reindexShapesForBody:(ChipmunkBody *)body;

- (void)step:(cpFloat)dt;

@end