Struct SphereWidget 

pub struct SphereWidget {
    pub center: Vec3,
    pub radius: f32,
    pub colour: [f32; 4],
    pub handle_colour: [f32; 4],
    /* private fields */
}

An interactive sphere widget with a draggable center and radius handle.

Use clip_object() to get the visual fill/outline (push into fd.effects.clip_objects with clip_geometry: false), and handle_glyphs() for the draggable handle spheres (push into fd.scene.glyphs).

Usage

let mut sphere = SphereWidget::new(glam::Vec3::ZERO, 2.0);

// Each frame:
sphere.update(&ctx);
fd.effects.clip_objects.push(sphere.clip_object());
fd.scene.glyphs.push(sphere.handle_glyphs(HANDLE_ID, &ctx));

Fields

center: Vec3

World-space center of the sphere.

radius: f32

Radius in world units.

colour: [f32; 4]

RGBA fill colour (alpha controls transparency of the fill).

handle_colour: [f32; 4]

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

Implementations

impl SphereWidget

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

Create a new sphere widget.

pub fn is_active(&self) -> bool

True while a drag session is in progress.

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

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

pub fn clip_object(&self) -> ClipObject

Build a ClipObject for the sphere visual (fill + outline).

Push into fd.effects.clip_objects. clip_geometry is set to false so the sphere only renders as a visual indicator and does not clip geometry.

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

Build a PolylineItem of three great circle rings (XY, XZ, YZ planes).

Push into fd.scene.polylines for a scene-pass outline consistent with how BoxWidget::wireframe_item is used. id is the pick ID (0 = not pickable).

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

Build a GlyphItem with sphere handles: one at the center, one at the radius edge (along +X from center).

id_base is the pick ID for the center handle; id_base + 1 for the radius handle.