euv-engine 0.11.0

A high-performance 2D game engine built on the euv framework, featuring ECS, fixed-timestep game loop, canvas rendering, physics, collision detection, sprite animation, and audio.
Documentation
use crate::*;

/// Configuration parameters for the physics world simulation.
#[derive(Clone, Copy, Data, Debug, New, PartialEq, PartialOrd)]
pub struct PhysicsConfig {
    /// The gravitational acceleration vector in pixels per second squared.
    #[get(type(copy))]
    pub(crate) gravity: Vector2D,
    /// The linear velocity damping coefficient applied per second.
    #[get(type(copy))]
    pub(crate) linear_damping: f64,
    /// The angular velocity damping coefficient applied per second.
    #[get(type(copy))]
    pub(crate) angular_damping: f64,
}

/// A 2D rigid body participating in the physics simulation.
#[derive(Clone, Data, Debug, New, PartialEq)]
pub struct RigidBody2D {
    /// The unique identifier of this body, typically matching a game object ID.
    #[get(type(copy))]
    pub(crate) id: u64,
    /// The world-space position of the body's center.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    pub(crate) position: Vector2D,
    /// The linear velocity in pixels per second.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    #[new(skip)]
    pub(crate) velocity: Vector2D,
    /// The accumulated force to be applied during the next physics step.
    #[get(pub(crate), type(copy))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    #[new(skip)]
    pub(crate) force_accumulator: Vector2D,
    /// The rotation angle in radians.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    #[new(skip)]
    pub(crate) rotation: f64,
    /// The angular velocity in radians per second.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    #[new(skip)]
    pub(crate) angular_velocity: f64,
    /// The mass of the body in kilograms. Static bodies have a mass of 0.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    pub(crate) mass: f64,
    /// The precomputed inverse mass (1/mass). Static bodies have 0 inverse mass.
    #[get(pub(crate), type(copy))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) inverse_mass: f64,
    /// The restitution (bounciness) coefficient in the range 0.0 to 1.0.
    #[get(type(copy))]
    pub(crate) restitution: f64,
    /// The friction coefficient for surface contact.
    #[get(type(copy))]
    pub(crate) friction: f64,
    /// How this body participates in the simulation.
    #[get(type(copy))]
    pub(crate) body_type: BodyType,
    /// The collider shape attached to this body.
    #[get(type(copy))]
    #[new(skip)]
    pub(crate) collider: Option<BodyCollider>,
}

/// The physics world managing all rigid bodies and simulation steps.
#[derive(Clone, Data, Debug, New, PartialEq)]
pub struct PhysicsWorld2D {
    /// All rigid bodies in the world.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    #[new(skip)]
    pub(crate) bodies: Vec<RigidBody2D>,
    /// The simulation configuration.
    #[get(type(copy))]
    pub(crate) config: PhysicsConfig,
}

/// Configuration parameters for the 3D physics world simulation.
#[derive(Clone, Copy, Data, Debug, New, PartialEq, PartialOrd)]
pub struct PhysicsConfig3D {
    /// The gravitational acceleration vector in meters per second squared.
    #[get(type(copy))]
    pub(crate) gravity: Vector3D,
    /// The linear velocity damping coefficient applied per second.
    #[get(type(copy))]
    pub(crate) linear_damping: f64,
    /// The angular velocity damping coefficient applied per second.
    #[get(type(copy))]
    pub(crate) angular_damping: f64,
}

/// A 3D rigid body participating in the physics simulation.
#[derive(Clone, Data, Debug, New, PartialEq)]
pub struct RigidBody3D {
    /// The unique identifier of this body, typically matching a game object ID.
    #[get(type(copy))]
    pub(crate) id: u64,
    /// The world-space position of the body's center.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    pub(crate) position: Vector3D,
    /// The linear velocity in meters per second.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    #[new(skip)]
    pub(crate) velocity: Vector3D,
    /// The accumulated force to be applied during the next physics step.
    #[get(pub(crate), type(copy))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    #[new(skip)]
    pub(crate) force_accumulator: Vector3D,
    /// The rotation as a quaternion.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    #[new(skip)]
    pub(crate) rotation: Quaternion,
    /// The angular velocity as a 3D vector (axis * speed).
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    #[new(skip)]
    pub(crate) angular_velocity: Vector3D,
    /// The accumulated torque to be applied during the next physics step.
    #[get(pub(crate), type(copy))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    #[new(skip)]
    pub(crate) torque_accumulator: Vector3D,
    /// The mass of the body in kilograms. Static bodies have a mass of 0.
    #[get(type(copy))]
    #[get_mut(pub(crate))]
    pub(crate) mass: f64,
    /// The precomputed inverse mass (1/mass). Static bodies have 0 inverse mass.
    #[get(pub(crate), type(copy))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    pub(crate) inverse_mass: f64,
    /// The restitution (bounciness) coefficient in the range 0.0 to 1.0.
    #[get(type(copy))]
    pub(crate) restitution: f64,
    /// The friction coefficient for surface contact.
    #[get(type(copy))]
    pub(crate) friction: f64,
    /// How this body participates in the simulation.
    #[get(type(copy))]
    pub(crate) body_type: BodyType,
    /// The 3D collider shape attached to this body.
    #[get(type(copy))]
    #[new(skip)]
    pub(crate) collider: Option<BodyCollider3D>,
}

/// The 3D physics world managing all rigid bodies and simulation steps.
#[derive(Clone, Data, Debug, New, PartialEq)]
pub struct PhysicsWorld3D {
    /// All rigid bodies in the world.
    #[get(pub(crate))]
    #[get_mut(pub(crate))]
    #[set(pub(crate))]
    #[new(skip)]
    pub(crate) bodies: Vec<RigidBody3D>,
    /// The simulation configuration.
    #[get(type(copy))]
    pub(crate) config: PhysicsConfig3D,
}