Struct euclid::Translation2D
source · #[repr(C)]pub struct Translation2D<T, Src, Dst> {
pub x: T,
pub y: T,
/* private fields */
}
Expand description
A 2d transformation from a space to another that can only express translations.
The main benefit of this type over a Vector2D
is the ability to cast
between source and destination spaces.
Example:
use euclid::{Translation2D, Point2D, point2};
struct ParentSpace;
struct ChildSpace;
type ScrollOffset = Translation2D<i32, ParentSpace, ChildSpace>;
type ParentPoint = Point2D<i32, ParentSpace>;
type ChildPoint = Point2D<i32, ChildSpace>;
let scrolling = ScrollOffset::new(0, 100);
let p1: ParentPoint = point2(0, 0);
let p2: ChildPoint = scrolling.transform_point(p1);
Fields§
§x: T
§y: T
Implementations§
source§impl<T, Src, Dst> Translation2D<T, Src, Dst>
impl<T, Src, Dst> Translation2D<T, Src, Dst>
pub const fn new(x: T, y: T) -> Self
pub fn splat(v: T) -> Selfwhere
T: Clone,
sourcepub fn is_identity(&self) -> bool
pub fn is_identity(&self) -> bool
Check if translation does nothing (both x and y is zero()
).
use euclid::default::Translation2D;
assert_eq!(Translation2D::<f32>::identity().is_identity(), true);
assert_eq!(Translation2D::new(0, 0).is_identity(), true);
assert_eq!(Translation2D::new(1, 0).is_identity(), false);
assert_eq!(Translation2D::new(0, 1).is_identity(), false);
sourcepub fn transform_size(&self, s: Size2D<T, Src>) -> Size2D<T, Dst>
pub fn transform_size(&self, s: Size2D<T, Src>) -> Size2D<T, Dst>
No-op, just cast the unit.
source§impl<T: Copy, Src, Dst> Translation2D<T, Src, Dst>
impl<T: Copy, Src, Dst> Translation2D<T, Src, Dst>
sourcepub fn to_untyped(&self) -> Translation2D<T, UnknownUnit, UnknownUnit>
pub fn to_untyped(&self) -> Translation2D<T, UnknownUnit, UnknownUnit>
Drop the units, preserving only the numeric value.
sourcepub fn from_untyped(t: &Translation2D<T, UnknownUnit, UnknownUnit>) -> Self
pub fn from_untyped(t: &Translation2D<T, UnknownUnit, UnknownUnit>) -> Self
Tag a unitless value with units.
sourcepub fn to_transform(&self) -> Transform2D<T, Src, Dst>
pub fn to_transform(&self) -> Transform2D<T, Src, Dst>
Returns the matrix representation of this translation.
sourcepub fn transform_point(&self, p: Point2D<T, Src>) -> Point2D<T::Output, Dst>where
T: Add,
pub fn transform_point(&self, p: Point2D<T, Src>) -> Point2D<T::Output, Dst>where
T: Add,
Translate a point and cast its unit.
sourcepub fn transform_rect(&self, r: &Rect<T, Src>) -> Rect<T::Output, Dst>where
T: Add<Output = T>,
pub fn transform_rect(&self, r: &Rect<T, Src>) -> Rect<T::Output, Dst>where
T: Add<Output = T>,
Translate a rectangle and cast its unit.
sourcepub fn transform_box(&self, r: &Box2D<T, Src>) -> Box2D<T::Output, Dst>where
T: Add,
pub fn transform_box(&self, r: &Box2D<T, Src>) -> Box2D<T::Output, Dst>where
T: Add,
Translate a 2D box and cast its unit.
sourcepub fn inverse(&self) -> Translation2D<T::Output, Dst, Src>where
T: Neg,
pub fn inverse(&self) -> Translation2D<T::Output, Dst, Src>where
T: Neg,
Return the inverse transformation.
source§impl<T: NumCast + Copy, Src, Dst> Translation2D<T, Src, Dst>
impl<T: NumCast + Copy, Src, Dst> Translation2D<T, Src, Dst>
sourcepub fn cast<NewT: NumCast>(self) -> Translation2D<NewT, Src, Dst>
pub fn cast<NewT: NumCast>(self) -> Translation2D<NewT, Src, Dst>
Cast from one numeric representation to another, preserving the units.
When casting from floating vector to integer coordinates, the decimals are truncated
as one would expect from a simple cast, but this behavior does not always make sense
geometrically. Consider using round()
, ceil()
or floor()
before casting.
sourcepub fn try_cast<NewT: NumCast>(self) -> Option<Translation2D<NewT, Src, Dst>>
pub fn try_cast<NewT: NumCast>(self) -> Option<Translation2D<NewT, Src, Dst>>
Fallible cast from one numeric representation to another, preserving the units.
When casting from floating vector to integer coordinates, the decimals are truncated
as one would expect from a simple cast, but this behavior does not always make sense
geometrically. Consider using round()
, ceil()
or floor()
before casting.
sourcepub fn to_f32(self) -> Translation2D<f32, Src, Dst>
pub fn to_f32(self) -> Translation2D<f32, Src, Dst>
Cast into an f32
vector.
sourcepub fn to_f64(self) -> Translation2D<f64, Src, Dst>
pub fn to_f64(self) -> Translation2D<f64, Src, Dst>
Cast into an f64
vector.
sourcepub fn to_usize(self) -> Translation2D<usize, Src, Dst>
pub fn to_usize(self) -> Translation2D<usize, Src, Dst>
Cast into an usize
vector, truncating decimals if any.
When casting from floating vector vectors, it is worth considering whether
to round()
, ceil()
or floor()
before the cast in order to obtain
the desired conversion behavior.
sourcepub fn to_u32(self) -> Translation2D<u32, Src, Dst>
pub fn to_u32(self) -> Translation2D<u32, Src, Dst>
Cast into an u32
vector, truncating decimals if any.
When casting from floating vector vectors, it is worth considering whether
to round()
, ceil()
or floor()
before the cast in order to obtain
the desired conversion behavior.
sourcepub fn to_i32(self) -> Translation2D<i32, Src, Dst>
pub fn to_i32(self) -> Translation2D<i32, Src, Dst>
Cast into an i32 vector, truncating decimals if any.
When casting from floating vector vectors, it is worth considering whether
to round()
, ceil()
or floor()
before the cast in order to obtain
the desired conversion behavior.
sourcepub fn to_i64(self) -> Translation2D<i64, Src, Dst>
pub fn to_i64(self) -> Translation2D<i64, Src, Dst>
Cast into an i64 vector, truncating decimals if any.
When casting from floating vector vectors, it is worth considering whether
to round()
, ceil()
or floor()
before the cast in order to obtain
the desired conversion behavior.
Trait Implementations§
source§impl<T: Add, Src, Dst1, Dst2> Add<Translation2D<T, Dst1, Dst2>> for Translation2D<T, Src, Dst1>
impl<T: Add, Src, Dst1, Dst2> Add<Translation2D<T, Dst1, Dst2>> for Translation2D<T, Src, Dst1>
source§impl<T: AddAssign, Src, Dst> AddAssign<Translation2D<T, Dst, Dst>> for Translation2D<T, Src, Dst>
impl<T: AddAssign, Src, Dst> AddAssign<Translation2D<T, Dst, Dst>> for Translation2D<T, Src, Dst>
source§fn add_assign(&mut self, other: Translation2D<T, Dst, Dst>)
fn add_assign(&mut self, other: Translation2D<T, Dst, Dst>)
+=
operation. Read moresource§impl<T: Clone, Src, Dst> Clone for Translation2D<T, Src, Dst>
impl<T: Clone, Src, Dst> Clone for Translation2D<T, Src, Dst>
source§impl<T: Debug, Src, Dst> Debug for Translation2D<T, Src, Dst>
impl<T: Debug, Src, Dst> Debug for Translation2D<T, Src, Dst>
source§impl<T, Src, Dst> Default for Translation2D<T, Src, Dst>where
T: Zero,
impl<T, Src, Dst> Default for Translation2D<T, Src, Dst>where
T: Zero,
source§impl<T, Src, Dst> From<Translation2D<T, Src, Dst>> for Transform2D<T, Src, Dst>
impl<T, Src, Dst> From<Translation2D<T, Src, Dst>> for Transform2D<T, Src, Dst>
source§fn from(t: Translation2D<T, Src, Dst>) -> Self
fn from(t: Translation2D<T, Src, Dst>) -> Self
source§impl<T, Src, Dst> From<Translation2D<T, Src, Dst>> for Vector2D<T, Src>
impl<T, Src, Dst> From<Translation2D<T, Src, Dst>> for Vector2D<T, Src>
source§fn from(t: Translation2D<T, Src, Dst>) -> Self
fn from(t: Translation2D<T, Src, Dst>) -> Self
source§impl<T, Src, Dst> From<Vector2D<T, Src>> for Translation2D<T, Src, Dst>
impl<T, Src, Dst> From<Vector2D<T, Src>> for Translation2D<T, Src, Dst>
source§impl<T, Src, Dst> Hash for Translation2D<T, Src, Dst>where
T: Hash,
impl<T, Src, Dst> Hash for Translation2D<T, Src, Dst>where
T: Hash,
source§impl<T, Src, Dst> PartialEq for Translation2D<T, Src, Dst>where
T: PartialEq,
impl<T, Src, Dst> PartialEq for Translation2D<T, Src, Dst>where
T: PartialEq,
source§impl<T: Sub, Src, Dst1, Dst2> Sub<Translation2D<T, Dst1, Dst2>> for Translation2D<T, Src, Dst2>
impl<T: Sub, Src, Dst1, Dst2> Sub<Translation2D<T, Dst1, Dst2>> for Translation2D<T, Src, Dst2>
source§impl<T: SubAssign, Src, Dst> SubAssign<Translation2D<T, Dst, Dst>> for Translation2D<T, Src, Dst>
impl<T: SubAssign, Src, Dst> SubAssign<Translation2D<T, Dst, Dst>> for Translation2D<T, Src, Dst>
source§fn sub_assign(&mut self, other: Translation2D<T, Dst, Dst>)
fn sub_assign(&mut self, other: Translation2D<T, Dst, Dst>)
-=
operation. Read moreimpl<T: Copy, Src, Dst> Copy for Translation2D<T, Src, Dst>
impl<T, Src, Dst> Eq for Translation2D<T, Src, Dst>where
T: Eq,
Auto Trait Implementations§
impl<T, Src, Dst> Freeze for Translation2D<T, Src, Dst>where
T: Freeze,
impl<T, Src, Dst> RefUnwindSafe for Translation2D<T, Src, Dst>
impl<T, Src, Dst> Send for Translation2D<T, Src, Dst>
impl<T, Src, Dst> Sync for Translation2D<T, Src, Dst>
impl<T, Src, Dst> Unpin for Translation2D<T, Src, Dst>
impl<T, Src, Dst> UnwindSafe for Translation2D<T, Src, Dst>
Blanket Implementations§
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<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)