Struct Camera 

pub struct Camera {
    pub projection: ProjectionType,
    pub aspect_ratio: f32,
    pub z_near: f32,
    pub z_far: f32,
    pub is_active: bool,
}

A component that defines a camera’s projection parameters.

This component is used to configure how the 3D world is projected onto the 2D screen. It supports both perspective and orthographic projections.

Fields

projection: ProjectionType

The type of projection (perspective or orthographic).

aspect_ratio: f32

The aspect ratio of the viewport (width / height). This is typically updated when the window is resized.

z_near: f32

The distance to the near clipping plane. Objects closer than this will not be rendered. Should be a small positive value (e.g., 0.1).

z_far: f32

The distance to the far clipping plane. Objects farther than this will not be rendered. Should be larger than z_near (e.g., 1000.0).

is_active: bool

Whether this camera is the active/primary camera. Only one camera should be active at a time.

Implementations

impl Camera

pub fn new_perspective( fov_y_radians: f32, aspect_ratio: f32, z_near: f32, z_far: f32, ) -> Self

Creates a new perspective camera with the given parameters.

pub fn new_orthographic( width: f32, height: f32, z_near: f32, z_far: f32, ) -> Self

Creates a new orthographic camera with the given parameters.

pub fn default_perspective() -> Self

Creates a default perspective camera suitable for most 3D applications.

• FOV: 60 degrees (~1.047 radians)
• Aspect ratio: 16:9 (~1.777)
• Near plane: 0.1
• Far plane: 1000.0

pub fn default_orthographic() -> Self

Creates a default orthographic camera.

• Width: 1920.0
• Height: 1080.0
• Near plane: -1.0
• Far plane: 1000.0

pub fn projection_matrix(&self) -> Mat4

Calculates the projection matrix for this camera.

This uses a right-handed coordinate system with a [0, 1] depth range, which is standard for modern rendering APIs like Vulkan and WebGPU.

pub fn set_aspect_ratio(&mut self, width: u32, height: u32)

Updates the aspect ratio, typically called when the window is resized.

Trait Implementations

impl Clone for Camera

fn clone(&self) -> Camera

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Camera

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

Formats the value using the given formatter.

impl Default for Camera

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Camera

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

impl Copy for Camera

impl StructuralPartialEq for Camera