Struct MaterialTable 

pub struct MaterialTable {
    pub default_friction_combine: CombineRule,
    pub default_restitution_combine: CombineRule,
    /* private fields */
}

Material pair lookup table

Fields

default_friction_combine: CombineRule

Global friction combine rule (fallback)

default_restitution_combine: CombineRule

Global restitution combine rule (fallback)

Implementations

impl MaterialTable

pub fn new() -> Self

Create a new material table with a default material

pub fn register(&mut self, material: PhysicsMaterial) -> MaterialId

Register a material, returns its ID

The material’s id field is overwritten with the assigned ID.

Panics

Panics when the table already holds u16::MAX as usize + 1 (65,536) materials, i.e. every MaterialId is in use (the default material created by MaterialTable::new occupies ID 0, so at most 65,535 materials can be added after construction). Use MaterialTable::try_register to handle that case without panicking.

pub fn try_register( &mut self, material: PhysicsMaterial, ) -> Result<MaterialId, PhysicsError>

Register a material, returns its ID, or an error when every MaterialId is already in use.

IDs are assigned in registration order, so a table can hold at most u16::MAX as usize + 1 (65,536) materials, including the default material at ID 0. A successful call never reuses or overwrites an existing ID.

Errors

Returns PhysicsError::CapacityExceeded with limit = 65_536 when the table already holds 65,536 materials. The table is left unchanged.

pub fn get(&self, id: MaterialId) -> &PhysicsMaterial

Get material by ID

pub fn set_pair_override( &mut self, mat_a: MaterialId, mat_b: MaterialId, friction: Fix128, restitution: Fix128, )

Set a pair-specific override

pub fn combine(&self, mat_a: MaterialId, mat_b: MaterialId) -> CombinedMaterial

Combine materials for a contact pair

pub fn len(&self) -> usize

Number of registered materials

pub fn is_empty(&self) -> bool

Check if empty

pub fn register_metal(&mut self) -> MaterialId

Register a “Metal” material

pub fn register_wood(&mut self) -> MaterialId

Register a “Wood” material

pub fn register_rubber(&mut self) -> MaterialId

Register a “Rubber” material

pub fn register_ice(&mut self) -> MaterialId

Register an “Ice” material

pub fn register_concrete(&mut self) -> MaterialId

Register a “Concrete” material

Trait Implementations

impl Default for MaterialTable

fn default() -> Self

Returns the “default value” for a type.