Struct ViewCamera 

pub struct ViewCamera {
    pub eye: [f64; 3],
    pub target: [f64; 3],
    pub up: [f64; 3],
    pub projection: Projection,
    pub width: f64,
    pub height: f64,
    pub near: f64,
    pub far: f64,
}

Fields

eye: [f64; 3]

target: [f64; 3]

up: [f64; 3]

projection: Projection

width: f64

Viewport CSS size.

height: f64

near: f64

View-space depth window (positive distances along the view direction); maintained by ViewCamera::fit_depth_range. Ortho near may go negative (scene behind the eye plane is still projectable).

far: f64

Implementations

impl ViewCamera

pub fn aspect(&self) -> f64

pub fn basis(&self) -> ([f64; 3], [f64; 3], [f64; 3])

Camera basis: (right, true-up, forward) with forward pointing INTO the scene (eye → target).

pub fn distance(&self) -> f64

pub fn world_per_pixel(&self) -> f64

World units per CSS pixel at the target plane (R21/R25 — the query the pickers, gizmos and sketch glyph sizing key off).

pub fn view_proj_cols(&self) -> [[f64; 4]; 4]

The world→clip view-projection as column-major [col][row] in f64. This is the exact matrix [resolve] feeds the GPU, kept in f64 so the CSS-pixel projection the host overlays derive from it matches [project] to sub-pixel precision. wgpu clip space: x,y in −1..1, z in 0..1.

pub fn resolve(&self) -> Camera

Resolve to the GPU camera (column-major view-proj, f32).

pub fn view_proj_flat(&self) -> [f64; 16]

The view-projection flattened column-major (index = col*4 + row) — the world→clip matrix for the host overlays’ per-frame world→screen hot path (dimensions + sketch), letting them drop the compat mirror camera. Pair with the CSS viewport for NDC→pixel.

pub fn view_proj_inverse_flat(&self) -> [f64; 16]

Inverse of [view_proj_flat] (clip→world), column-major, for the host overlays’ screen→world / screen→ray path. Falls back to the identity if the matrix is singular (never in practice for a valid camera).

pub fn project(&self, world: [f64; 3]) -> (f64, f64, f64)

Project a world point to CSS-pixel screen coordinates (origin top-left, y down). Returns (x, y, view_depth); view_depth is the distance along the view direction (positive in front of the eye plane).

pub fn pick_ray(&self, x: f64, y: f64) -> Ray

A world-space picking ray through CSS-pixel (x, y). Ortho rays start far behind the eye plane so huge scenes are always in front (the retired picker pushed its ray origin back the same way).

pub fn fit_depth_range(&mut self, bbox: &Aabb)

Fit the depth window to the scene (the _updateDepthRange port): the whole bbox lands inside [near, far] with generous padding.

pub fn zoom_to_fit(&mut self, bbox: &Aabb, margin: f64)

Zoom-to-fit (R21): recenters the target on the bbox and scales the frustum/distance so the whole bbox fits with margin, preserving the view direction (the ArcballControls focus behavior).

pub fn toggle_projection(&mut self) -> &'static str

Toggle ortho ↔ perspective preserving the apparent size at the target plane (the toggleCameraProjection port). Returns the new kind name.

pub fn standard_view(&mut self, name: &str) -> bool

Snap to a standard view (future ViewCube seam), preserving distance and frustum scale. Directions are world-axis views with sensible ups.

pub fn state_json(&self) -> String

Serialize the full camera state (R3: the host holds plain JSON only).

pub fn apply_state_json(&mut self, json: &str) -> Result<(), String>

Restore from ViewCamera::state_json output (viewport size is NOT restored — it belongs to the canvas).

Trait Implementations

impl Clone for ViewCamera

fn clone(&self) -> ViewCamera

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ViewCamera

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

Formats the value using the given formatter.

impl Default for ViewCamera

fn default() -> Self

Returns the “default value” for a type.