Struct BoxWidget 

pub struct BoxWidget {
    pub center: Vec3,
    pub half_extents: Vec3,
    pub rotation: Quat,
    pub colour: [f32; 4],
    pub handle_colour: [f32; 4],
    /* private fields */
}

An interactive oriented box widget with translation, resize, and rotation handles.

The box orientation is controlled by rotation (default Quat::IDENTITY for axis-aligned). Three rotation arc handles (one per world axis) are rendered as circle overlays.

Use wireframe_item() for the box outline, rotation_arcs_item() for the arc circles, and handle_glyphs() for all 10 draggable sphere handles.

Usage

let mut bw = BoxWidget::new(glam::Vec3::ZERO, glam::Vec3::splat(2.0));

// Each frame:
bw.update(&ctx);
fd.scene.polylines.push(bw.wireframe_item(BOX_ID));
fd.scene.polylines.push(bw.rotation_arcs_item(ARC_ID));
fd.scene.glyphs.push(bw.handle_glyphs(HANDLE_ID, &ctx));

Fields

center: Vec3

World-space center of the box.

half_extents: Vec3

Half-extents along the box’s local X, Y, Z axes.

rotation: Quat

Orientation of the box (rotates the local axes).

colour: [f32; 4]

RGBA colour for the wireframe outline.

handle_colour: [f32; 4]

RGBA colour for the drag handles. When set (non-zero alpha), overrides the default LUT colouring.

Implementations

impl BoxWidget

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

Create a new axis-aligned box widget (rotation defaults to identity).

pub fn is_active(&self) -> bool

True while a drag session is in progress.

pub fn obb(&self) -> (Vec3, Vec3, Quat)

Returns (center, half_extents, rotation) for this oriented box.

pub fn aabb(&self) -> Aabb

World-space AABB that conservatively bounds the oriented box.

When rotation is identity this equals the exact box. Otherwise it is a tight enclosing axis-aligned box computed from all 8 oriented corners.

pub fn contains_point(&self, point: Vec3) -> bool

Returns true if point lies inside the oriented box.

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

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

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

Build a PolylineItem for the oriented box wireframe (12 edges).

id is the pick ID (0 = not pickable).

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

Build a PolylineItem containing three rotation arcs (one per world axis).

Each arc is a full circle at radius arc_radius() around the box center. Arc colours: X = red, Y = green, Z = blue (semi-transparent).

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

Build a GlyphItem with 10 sphere handles: center, 6 face handles, and 3 rotation grips.

Pick IDs: id_base = center, id_base + 1..6 = faces (+X,-X,+Y,-Y,+Z,-Z), id_base + 7..9 = rotation arc grips (X, Y, Z).