Create a capsule with the given total width and height.
Total width (tip to tip). Must be >= height.
Total height (diameter of the end-caps). Must be > 0.
OptionallocalCOM: Vec2
Local centre offset (defaults to origin).
Optionalmaterial: Material
Material to assign (uses default if omitted).
Optionalfilter: InteractionFilter
InteractionFilter to assign (uses default if omitted).
Angular drag coefficient for this shape.
Cross-sectional area of this shape.
World-space AABB of this shape (updated each step).
Cast to Body — returns the Body wrapper if this is a Body, else null.
Cast to Capsule, or null if this is not a capsule.
Cast to Circle, or null if this is not a circle.
Cast to Compound — returns the Compound wrapper if this is a Compound, else null.
Cast to Polygon, or null if this is not a polygon.
Cast to Shape — returns the Shape wrapper if this is a Shape, else null.
Set of callback types registered on this shape for event dispatch.
The InteractionFilter controlling which shapes interact with this one.
If true, this shape participates in fluid interaction.
Fluid simulation properties for this shape. Auto-created on first access.
The interaction group this interactor belongs to.
Half the spine length. Total width = 2 * (halfLength + radius).
Total height of the capsule (diameter of end-caps).
Unique numeric identifier for this interactor.
Contribution to moment of inertia (about local centroid, unit density).
The capsule's end-cap radius (half the height).
If true, this shape acts as a sensor (no physical response, only callbacks).
Cannot be changed during space.step(), which includes PreListener
handlers (they run mid-step). Record the desired state in the handler and
apply it after step() returns. Body / interaction / constraint listener
callbacks are delivered after the step and may change it directly.
Override type to return CAPSULE (internally backed by polygon).
User-defined data storage object.
Total width of the capsule (tip to tip).
World-space centre of mass of this shape (read-only, lazy-computed).
Return true if the given world-space point lies inside this shape. Requires the shape to be attached to a Body.
The world-space point to test.
True if the point is inside this shape.
Create a deep copy of this shape with the same type, geometry, material, and filter.
A new Shape instance independent of this one.
Returns true if this interactor is a Body.
A capsule identifies as capsule.
Returns true if this is a Circle shape.
Returns true if this interactor is a Compound.
A capsule is not a plain polygon from the user's perspective.
Returns true if this interactor is a Shape.
Rotate the shape's local vertices by angle radians.
Rotation in radians.
this for chaining.
Scale the shape's local geometry. Circles require uniform scaling.
Horizontal scale factor (must be non-zero).
Vertical scale factor (must be non-zero).
this for chaining.
A capsule physics shape — a line segment with a radius (stadium geometry).
Internally backed by a convex polygon approximation for robust collision detection. The polygon uses the engine's well-tested SAT narrowphase.
Example