Struct ManipulationController 

pub struct ManipulationController { /* private fields */ }

Manages a single object-manipulation session (G/R/S + axis constraints + gizmo drag).

Owns all session state; the app only supplies per-frame context and applies the resulting TransformDelta.

Implementations

impl ManipulationController

pub fn new() -> Self

Create a controller with no active session.

pub fn update( &mut self, frame: &ActionFrame, ctx: ManipulationContext, ) -> ManipResult

Drive the controller for one frame.

Priority order:

1. Confirm (Enter, or left-click while not a gizmo drag) → ManipResult::Commit
2. Cancel (Escape) → ManipResult::Cancel
3. Gizmo drag release → ManipResult::Commit
4. Update constraints and numeric input
5. Compute and return ManipResult::Update
6. Gizmo drag start → begins session, returns ManipResult::None this frame
7. G/R/S keys (when selection_center is Some) → begins session
8. Otherwise → ManipResult::None

pub fn is_active(&self) -> bool

Returns true when a manipulation session is in progress.

Use this to suppress camera orbit:

if manip.is_active() { orbit.resolve() } else { orbit.apply_to_camera(&mut cam) }

pub fn state(&self) -> Option<ManipulationState>

Returns an inspectable snapshot of the current session, or None when idle.

pub fn begin(&mut self, kind: ManipulationKind, center: Vec3)

Force-begin a manipulation (e.g. from a UI button).

No-op if a session is already active.

pub fn reset(&mut self)

Force-cancel any active session without emitting ManipResult::Cancel.

Trait Implementations

impl Default for ManipulationController

fn default() -> Self

Returns the “default value” for a type.