Frustum
The Frustum component visualizes camera frustums in 3D space. This is ideal for:
- Visualizing camera field of view
- Debugging camera placements
- Displaying camera trajectories
- Creating multi-camera visualization setups
Basic Usage
A minimal example that creates a camera frustum:
Key Parameters
| Parameter | Type | Description |
|---|---|---|
key | str | Unique identifier for the frustum |
position | tuple[float, float, float] | Position of the frustum in 3D space |
rotation | tuple[float, float, float] | Rotation of the frustum (Euler angles) |
matrix | tuple[float, ...] | 16-element transformation matrix (overrides position and rotation) |
aspect | float | Aspect ratio (width/height) of the camera |
focus | float | Focus distance |
fov | float | Vertical field of view in degrees |
near | float | Near clipping plane distance |
far | float | Far clipping plane distance |
scale | float | Scale factor for the frustum visualization |
upScale | float | Scale factor for the up direction indicator |
focalLength | float | Focal length of the camera |
showUp | bool | Whether to show the up direction indicator |
showFrustum | bool | Whether to show the frustum wireframe |
showFocalPlane | bool | Whether to show the focal plane |
showImagePlane | bool | Whether to show the image plane |
src | str | Source image to display on the image plane |
colorOrigin | ColorRepresentation | Color of the camera origin marker |
colorFrustum | ColorRepresentation | Color of the frustum wireframe |
colorCone | ColorRepresentation | Color of the cone |
colorFocalPlane | ColorRepresentation | Color of the focal plane |
colorUp | ColorRepresentation | Color of the up direction indicator |
colorTarget | ColorRepresentation | Color of the target marker |
colorCross | ColorRepresentation | Color of the cross marker |
Learn More
- Spline Frustum - Animated camera paths