Struct trackball::Orbit

pub struct Orbit<N: RealField> { /* fields omitted */ }

Orbit induced by displacement on screen.

Implements Default and can be created with Orbit::default().

Both its methods must be invoked on matching events fired by your 3D graphics library of choice.

Implementations

impl<N: RealField> Orbit<N>

pub fn compute(
    &mut self,
    pos: &Point2<N>,
    max: &Point2<N>
) -> Option<UnitQuaternion<N>>

Computes rotation between previous and current cursor/finger position.

Normalization of previous position is cached and has to be discarded on button/finger release via Self::discard(). Current position pos is clamped between origin and maximum position max as screen’s width and height.

Screen space with origin in top left corner:

• x-axis from left to right,
• y-axis from top to bottom.

Camera space with origin at its target, the trackball’s center:

• x-axis from left to right,
• y-axis from bottom to top,
• z-axis from far to near.

Returns None:

• on first invocation and after Self::discard() as there is no previous position yet,
• in the unlikely case that a position event fires twice resulting in zero displacements.

pub fn discard(&mut self)

Discards cached normalization of previous cursor/finger position on button/finger release.

Trait Implementations

impl<N: Clone + RealField> Clone for Orbit<N>

fn clone(&self) -> Orbit<N>

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<N: Debug + RealField> Debug for Orbit<N>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<N: Default + RealField> Default for Orbit<N>

fn default() -> Orbit<N>

Returns the “default value” for a type.