Struct Collider 

pub struct Collider { /* private fields */ }

Collider component for physics collision detection.

Defines the collision shape, material properties (friction, restitution), and filtering (layers, masks) for an entity.

Examples

use goud_engine::ecs::components::Collider;
use goud_engine::core::math::Vec2;

// Circle collider
let ball = Collider::circle(0.5);

// Box collider
let wall = Collider::aabb(Vec2::new(5.0, 1.0));

// Capsule collider
let player = Collider::capsule(0.3, 1.0);

// Sensor (trigger)
let trigger = Collider::circle(2.0).with_is_sensor(true);

Implementations

impl Collider

pub fn circle(radius: f32) -> Collider

Creates a new circle collider with the given radius.

Examples

use goud_engine::ecs::components::Collider;

let ball = Collider::circle(0.5);

pub fn aabb(half_extents: Vec2) -> Collider

Creates a new axis-aligned box collider with the given half-extents.

Examples

use goud_engine::ecs::components::Collider;
use goud_engine::core::math::Vec2;

// 10x2 box (half-extents are half the size)
let wall = Collider::aabb(Vec2::new(5.0, 1.0));

pub fn obb(half_extents: Vec2) -> Collider

Creates a new oriented box collider with the given half-extents.

Similar to aabb() but supports rotation via the entity’s Transform2D.

pub fn capsule(half_height: f32, radius: f32) -> Collider

Creates a new capsule collider with the given half-height and radius.

Good for character controllers with smooth movement.

Examples

use goud_engine::ecs::components::Collider;

// Capsule with 0.6 radius and 2.0 total height
let player = Collider::capsule(0.3, 1.0);

pub fn polygon(vertices: Vec<Vec2>) -> Collider

Creates a new convex polygon collider with the given vertices.

Vertices must be in counter-clockwise order and form a convex hull.

Panics

Panics if fewer than 3 vertices are provided.

pub fn with_restitution(self, restitution: f32) -> Collider

Sets the restitution (bounciness) coefficient.

0.0 = no bounce, 1.0 = perfect bounce.

pub fn with_friction(self, friction: f32) -> Collider

Sets the friction coefficient.

0.0 = frictionless, 1.0 = high friction.

pub fn with_density(self, density: f32) -> Collider

Sets the density for automatic mass calculation.

Mass will be calculated as: area × density

pub fn with_layer(self, layer: u32) -> Collider

Sets the collision layer bitmask.

pub fn with_mask(self, mask: u32) -> Collider

Sets the collision mask bitmask.

pub fn with_is_sensor(self, is_sensor: bool) -> Collider

Sets whether this collider is a sensor (trigger).

pub fn with_enabled(self, enabled: bool) -> Collider

Sets whether this collider is enabled.

pub fn shape(&self) -> &ColliderShape

Returns a reference to the collision shape.

pub fn restitution(&self) -> f32

Returns the restitution coefficient.

pub fn friction(&self) -> f32

Returns the friction coefficient.

pub fn density(&self) -> Option<f32>

Returns the density, if set.

pub fn layer(&self) -> u32

Returns the collision layer.

pub fn mask(&self) -> u32

Returns the collision mask.

pub fn is_sensor(&self) -> bool

Returns true if this collider is a sensor (trigger).

pub fn is_enabled(&self) -> bool

Returns true if this collider is enabled.

pub fn compute_aabb(&self) -> Rect

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

pub fn can_collide_with(&self, other: &Collider) -> bool

Checks if this collider can collide with another based on layer filtering.

Returns true if: (self.layer & other.mask) != 0 && (other.layer & self.mask) != 0

pub fn set_restitution(&mut self, restitution: f32)

Sets the restitution coefficient.

pub fn set_friction(&mut self, friction: f32)

Sets the friction coefficient.

pub fn set_density(&mut self, density: Option<f32>)

Sets the density for automatic mass calculation.

pub fn set_layer(&mut self, layer: u32)

Sets the collision layer.

pub fn set_mask(&mut self, mask: u32)

Sets the collision mask.

pub fn set_is_sensor(&mut self, is_sensor: bool)

Sets whether this collider is a sensor.

pub fn set_enabled(&mut self, enabled: bool)

Sets whether this collider is enabled.

pub fn set_shape(&mut self, shape: ColliderShape)

Replaces the collision shape.

Trait Implementations

impl Clone for Collider

fn clone(&self) -> Collider

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Collider

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

Formats the value using the given formatter.

impl Default for Collider

fn default() -> Collider

Returns a default circle collider with radius 0.5.

impl Display for Collider

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

Formats the value using the given formatter.

impl PartialEq for Collider

fn eq(&self, other: &Collider) -> 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 Component for Collider

impl StructuralPartialEq for Collider