Enum ColliderShape 

pub enum ColliderShape {
    Circle {
        radius: f32,
    },
    Aabb {
        half_extents: Vec2,
    },
    Obb {
        half_extents: Vec2,
    },
    Capsule {
        half_height: f32,
        radius: f32,
    },
    Polygon {
        vertices: Vec<Vec2>,
    },
}

The geometric shape of a collider.

Each shape type has different performance characteristics and use cases:

• Circle: Fastest collision detection, best for balls, projectiles
• Box: Axis-aligned (AABB) or oriented (OBB), good for walls and platforms
• Capsule: Good for characters, combines efficiency with smooth edges
• Polygon: Most flexible but slowest, use sparingly for complex shapes

Variants

Circle

Circle collider defined by radius.

Center is at the entity’s position. Fastest collision detection.

Fields

radius: f32

Radius of the circle in world units

Aabb

Axis-Aligned Bounding Box (AABB).

Defined by half-extents (half-width, half-height) from the center. Fast collision detection, no rotation support.

Fields

half_extents: Vec2

Half-extents (half-width, half-height)

Obb

Oriented Bounding Box (OBB).

Similar to AABB but can be rotated. Slightly slower than AABB.

Fields

half_extents: Vec2

Half-extents (half-width, half-height)

Capsule

Capsule collider (rounded rectangle).

Defined by half-height and radius. Good for character controllers. The capsule extends vertically from the center.

Fields

half_height: f32

Half-height of the capsule’s cylindrical section

radius: f32

Radius of the capsule’s rounded ends

Polygon

Convex polygon collider.

Vertices must be in counter-clockwise order and form a convex hull. Slowest collision detection, use sparingly.

Fields

vertices: Vec<Vec2>

Vertices in local space, counter-clockwise order

Implementations

impl ColliderShape

pub fn type_name(&self) -> &'static str

Returns the type name of this shape.

pub fn compute_aabb(&self) -> Rect

Computes the axis-aligned bounding box (AABB) for this shape.

Returns a rectangle in local space that fully contains the shape. For rotated shapes (OBB, Polygon), this is a conservative bound.

pub fn is_circle(&self) -> bool

Returns true if this shape is a circle.

pub fn is_aabb(&self) -> bool

Returns true if this shape is an axis-aligned box (AABB).

pub fn is_obb(&self) -> bool

Returns true if this shape is an oriented box (OBB).

pub fn is_capsule(&self) -> bool

Returns true if this shape is a capsule.

pub fn is_polygon(&self) -> bool

Returns true if this shape is a polygon.

pub fn is_valid(&self) -> bool

Validates that the shape is well-formed.

Returns true if:

• Radii and extents are positive
• Polygons have at least 3 vertices
• Polygon vertices form a convex hull (not checked, assumed by user)

Trait Implementations

impl Clone for ColliderShape

fn clone(&self) -> ColliderShape

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ColliderShape

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for ColliderShape

fn default() -> ColliderShape

Returns a unit circle (radius 1.0) as the default shape.

impl<'de> Deserialize<'de> for ColliderShape

fn deserialize<__D>( __deserializer: __D, ) -> Result<ColliderShape, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ColliderShape

fn eq(&self, other: &ColliderShape) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ColliderShape

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ColliderShape