Documentation

Save a recording buffer to a file. Convenience wrapper over your own file I/O.

Returns: false if the file could not be written

Binds b2SaveRecordingToFile.

Load a recording from a file into a new recording buffer. Convenience wrapper over your own file I/O. Destroy the result with b2DestroyRecording.

Returns: NULL if the file is missing or unreadable

Binds b2LoadRecordingFromFile.

Replay a recording by re-running the engine and asserting recorded ids and state match.

Returns: true if replay completed without divergence, false on any mismatch

Binds b2ValidateReplay.

Validate ray cast input data (NaN, etc)

Binds b2IsValidRay.

Make a convex polygon from a convex hull. This will assert if the hull is not valid. Warning: Do not manually fill in the hull data, it must come directly from b2ComputeHull

Binds b2MakePolygon.

Make an offset convex polygon from a convex hull. This will assert if the hull is not valid. Warning: Do not manually fill in the hull data, it must come directly from b2ComputeHull

Binds b2MakeOffsetPolygon.

Make an offset convex polygon from a convex hull. This will assert if the hull is not valid. Warning: Do not manually fill in the hull data, it must come directly from b2ComputeHull

Binds b2MakeOffsetRoundedPolygon.

Make a square polygon, bypassing the need for a convex hull.

Binds b2MakeSquare.

Like makeSquare, but the result is written into a caller-supplied buffer.

Make a box (rectangle) polygon, bypassing the need for a convex hull.

Binds b2MakeBox.

Like makeBox, but the result is written into a caller-supplied buffer.

Make a rounded box, bypassing the need for a convex hull.

Binds b2MakeRoundedBox.

Like makeRoundedBox, but the result is written into a caller-supplied buffer.

Make an offset box, bypassing the need for a convex hull.

Binds b2MakeOffsetBox.

Make an offset rounded box, bypassing the need for a convex hull.

Binds b2MakeOffsetRoundedBox.

Transform a polygon. This is useful for transferring a shape from one body to another.

Binds b2TransformPolygon.

Compute mass properties of a circle

Binds b2ComputeCircleMass.

Compute mass properties of a capsule

Binds b2ComputeCapsuleMass.

Compute mass properties of a polygon

Binds b2ComputePolygonMass.

Compute the bounding box of a transformed circle

Binds b2ComputeCircleAABB.

Compute the bounding box of a transformed capsule

Binds b2ComputeCapsuleAABB.

Compute the bounding box of a transformed polygon

Binds b2ComputePolygonAABB.

Compute the bounding box of a transformed line segment

Binds b2ComputeSegmentAABB.

Test a point for overlap with a circle in local space

Binds b2PointInCircle.

Test a point for overlap with a capsule in local space

Binds b2PointInCapsule.

Test a point for overlap with a convex polygon in local space

Binds b2PointInPolygon.

Ray cast versus circle shape in local space.

Binds b2RayCastCircle.

Ray cast versus capsule shape in local space.

Binds b2RayCastCapsule.

Ray cast versus segment shape in local space. Optionally treat the segment as one-sided with hits from the left side being treated as a miss.

Binds b2RayCastSegment.

Ray cast versus polygon shape in local space.

Binds b2RayCastPolygon.

Shape cast versus a circle.

Binds b2ShapeCastCircle.

Shape cast versus a capsule.

Binds b2ShapeCastCapsule.

Shape cast versus a line segment.

Binds b2ShapeCastSegment.

Shape cast versus a convex polygon.

Binds b2ShapeCastPolygon.

Compute the convex hull of a set of points. Returns an empty hull if it fails. Some failure cases: - all points very close together - all points on a line - less than 3 points - more than B2_MAX_POLYGON_VERTICES points This welds close points and removes collinear points. Warning: Do not modify a hull once it has been computed

Binds b2ComputeHull.

Like computeHull, but the result is written into a caller-supplied buffer.

This determines if a hull is valid. Checks for: - convexity - collinear points This is expensive and should not be called at runtime.

Binds b2ValidateHull.

Compute the distance between two line segments, clamping at the end points if needed.

Binds b2SegmentDistance.

Compute the closest points between two shapes represented as point clouds. b2SimplexCache cache is input/output. On the first call set b2SimplexCache.count to zero. The underlying GJK algorithm may be debugged by passing in debug simplexes and capacity. You may pass in NULL and 0 for these.

Binds b2ShapeDistance.

Perform a linear shape cast of shape B moving and shape A fixed. Determines the hit point, normal, and translation fraction. The query runs in frame A, so the hit point and normal are returned in frame A. Initially touching shapes are a miss.

Binds b2ShapeCast.

Like shapeCast, but the result is written into a caller-supplied buffer.

Make a proxy for use in overlap, shape cast, and related functions. This is a deep copy of the points.

Binds b2MakeProxy.

Make a proxy with a transform. This is a deep copy of the points.

Binds b2MakeOffsetProxy.

Evaluate the transform sweep at a specific time.

Binds b2GetSweepTransform.

Compute the upper bound on time before two shapes penetrate. Time is represented as a fraction between \[0,tMax\]. This uses a swept separating axis and may miss some intermediate, non-tunneling collisions. If you change the time interval, you should call this function again.

Binds b2TimeOfImpact.

Compute the contact manifold between two circles

Binds b2CollideCircles.

Compute the contact manifold between a capsule and circle

Binds b2CollideCapsuleAndCircle.

Compute the contact manifold between an segment and a circle

Binds b2CollideSegmentAndCircle.

Compute the contact manifold between a polygon and a circle

Binds b2CollidePolygonAndCircle.

Compute the contact manifold between a capsule and circle

Binds b2CollideCapsules.

Compute the contact manifold between an segment and a capsule

Binds b2CollideSegmentAndCapsule.

Compute the contact manifold between a polygon and capsule

Binds b2CollidePolygonAndCapsule.

Compute the contact manifold between two polygons

Binds b2CollidePolygons.

Compute the contact manifold between an segment and a polygon

Binds b2CollideSegmentAndPolygon.

Compute the contact manifold between a chain segment and a circle

Binds b2CollideChainSegmentAndCircle.

Compute the contact manifold between a chain segment and a capsule

Binds b2CollideChainSegmentAndCapsule.

Compute the contact manifold between a chain segment and a rounded polygon

Binds b2CollideChainSegmentAndPolygon.

Solves the position of a mover that satisfies the given collision planes.

Binds b2SolvePlanes.

Clips the velocity against the given collision planes. Planes with zero push or clipVelocity set to false are skipped.

Binds b2ClipVector.