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 color: [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).

color: [f32; 4]

RGBA line color. 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);

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.