pub struct Orbit<N: Copy + RealField> { /* private fields */ }
Expand description
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§
source§impl Orbit<f32>
impl Orbit<f32>
sourcepub fn compute(
&mut self,
pos: &Point2<f32>,
max: &Point2<f32>
) -> Option<UnitQuaternion<f32>>
Available on crate feature cc
only.
pub fn compute( &mut self, pos: &Point2<f32>, max: &Point2<f32> ) -> Option<UnitQuaternion<f32>>
cc
only.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.
source§impl Orbit<f64>
impl Orbit<f64>
sourcepub fn compute(
&mut self,
pos: &Point2<f64>,
max: &Point2<f64>
) -> Option<UnitQuaternion<f64>>
Available on crate feature cc
only.
pub fn compute( &mut self, pos: &Point2<f64>, max: &Point2<f64> ) -> Option<UnitQuaternion<f64>>
cc
only.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.
Trait Implementations§
Auto Trait Implementations§
impl<N> RefUnwindSafe for Orbit<N>where N: RefUnwindSafe,
impl<N> Send for Orbit<N>
impl<N> Sync for Orbit<N>
impl<N> Unpin for Orbit<N>where N: Unpin,
impl<N> UnwindSafe for Orbit<N>where N: UnwindSafe,
Blanket Implementations§
source§impl<T> ArchivePointee for T
impl<T> ArchivePointee for T
§type ArchivedMetadata = ()
type ArchivedMetadata = ()
source§fn pointer_metadata(
_: &<T as ArchivePointee>::ArchivedMetadata
) -> <T as Pointee>::Metadata
fn pointer_metadata( _: &<T as ArchivePointee>::ArchivedMetadata ) -> <T as Pointee>::Metadata
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere
W: DeserializeWith<F, T, D>,
D: Fallible + ?Sized,
F: ?Sized,
impl<F, W, T, D> Deserialize<With<T, W>, D> for Fwhere W: DeserializeWith<F, T, D>, D: Fallible + ?Sized, F: ?Sized,
source§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere SS: SubsetOf<SP>,
source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read moresource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).source§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.