Struct CameraFrustumItem 

#[non_exhaustive]
pub struct CameraFrustumItem {
    pub pose: [[f32; 4]; 4],
    pub fov_y: f32,
    pub aspect: f32,
    pub near: f32,
    pub far: f32,
    pub colour: [f32; 4],
    pub line_width: f32,
    pub image_plane_depth: Option<f32>,
}

A renderable camera frustum wireframe item.

Converted to PolylineItem geometry in prepare.rs (no new GPU pipeline). The frustum is drawn as near quad + far quad + 4 lateral edges, with an optional image-plane quad at a configurable depth.

Use CameraFrustumItem::camera_target to get a fly-to target that frames the frustum from a comfortable standoff distance.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

pose: [[f32; 4]; 4]

View-to-world transform (the camera’s world-space pose).

Pass camera.view_matrix().inverse().to_cols_array_2d() for the current viewport camera, or any other camera-world transform.

fov_y: f32

Vertical field of view in radians.

aspect: f32

Viewport aspect ratio (width / height).

near: f32

Near clip distance (world units).

far: f32

Far clip distance (world units).

colour: [f32; 4]

RGBA line colour. Default: [0.8, 0.8, 0.9, 1.0] (light blue-grey).

line_width: f32

Screen-space line width in pixels. Default: 2.0.

image_plane_depth: Option<f32>

If Some(d), draw a closed quad at depth d (world units) inside the frustum. Useful to visualise the image plane of a camera.

Implementations

impl CameraFrustumItem

pub fn camera_target(&self, standoff_factor: f32) -> CameraTarget

Compute a crate::camera::CameraTarget that frames this frustum.

standoff_factor controls how far back the viewing camera sits relative to the frustum diagonal (2.5 is a comfortable default). The returned orientation faces the frustum from its front (along the frustum’s +Z axis).

Feed the result directly into [crate::camera::CameraAnimator::fly_to]:

let t = frustum.camera_target(2.5);
animator.fly_to(&camera, t.center, t.distance, t.orientation, 1.0);

pub fn camera_view_target(&self) -> CameraTarget

Compute a crate::camera::CameraTarget that adopts this frustum’s own viewpoint.

Unlike camera_target, which frames the frustum from outside, this places the orbit camera exactly at the frustum’s eye position looking in the frustum’s forward direction. Use it for “look through this camera” functionality.

let t = frustum.camera_view_target();
animator.fly_to(&camera, t.center, t.distance, t.orientation, 1.0);

Trait Implementations

impl Clone for CameraFrustumItem

fn clone(&self) -> CameraFrustumItem

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CameraFrustumItem

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

Formats the value using the given formatter.

impl Default for CameraFrustumItem

fn default() -> Self

Returns the “default value” for a type.