Struct PlaneWidget 

pub struct PlaneWidget {
    pub center: Vec3,
    pub normal: Vec3,
    pub colour: [f32; 4],
    pub handle_colour: [f32; 4],
    pub display_half_size: f32,
    pub normal_display_length: f32,
    /* private fields */
}

An interactive plane widget defined by a center point and unit normal.

Two handles: the center (moves the plane freely in 3D) and a normal tip (orbits the normal direction around the center by dragging).

Usage

let mut plane = PlaneWidget::new(glam::Vec3::ZERO, glam::Vec3::Z);

// Each frame:
plane.update(&ctx);
fd.scene.polylines.push(plane.plane_item(PLANE_ID));
fd.scene.glyphs.push(plane.handle_glyphs(HANDLE_ID, &ctx));

// Suppress orbit while dragging:
if plane.is_active() { orbit.resolve(); } else { orbit.apply_to_camera(&mut camera); }

Fields

center: Vec3

World-space center of the plane.

normal: Vec3

Unit normal vector of the plane (always normalized on output).

colour: [f32; 4]

RGBA colour for the wireframe square outline and normal line.

handle_colour: [f32; 4]

RGBA colour for the drag handles. Non-zero alpha overrides LUT colouring.

display_half_size: f32

Half-size of the visual square in world space.

normal_display_length: f32

Distance from center to the normal-tip handle sphere.

Implementations

impl PlaneWidget

pub fn new(center: Vec3, normal: Vec3) -> Self

Create a new plane widget.

normal is normalized internally; if zero, defaults to Vec3::Z.

pub fn is_active(&self) -> bool

True while a drag is in progress on either handle.

pub fn update(&mut self, ctx: &WidgetContext) -> WidgetResult

Process input for this frame. Returns Updated if state changed.

pub fn plane_item(&self, id: u64) -> PolylineItem

Build a PolylineItem for the wireframe square outline and normal indicator.

The square is oriented by normal and centered at center. A line segment from the center to the normal-tip handle is included.

pub fn handle_glyphs(&self, id_base: u64, ctx: &WidgetContext) -> GlyphItem

Build a GlyphItem with two sphere handles: center and normal tip.

id_base is the pick ID for the center handle; id_base + 1 for the normal-tip handle.