Struct euclid::Scale [−][src]
#[repr(C)]pub struct Scale<T, Src, Dst>(pub T, _);
Expand description
A scaling factor between two different units of measurement.
This is effectively a type-safe float, intended to be used in combination with other types like
length::Length
to enforce conversion between systems of measurement at compile time.
Src
and Dst
represent the units before and after multiplying a value by a Scale
. They
may be types without values, such as empty enums. For example:
use euclid::Scale; use euclid::Length; enum Mm {}; enum Inch {}; let mm_per_inch: Scale<f32, Inch, Mm> = Scale::new(25.4); let one_foot: Length<f32, Inch> = Length::new(12.0); let one_foot_in_mm: Length<f32, Mm> = one_foot * mm_per_inch;
Implementations
impl<T, Src, Dst> Scale<T, Src, Dst>
[src]
impl<T, Src, Dst> Scale<T, Src, Dst>
[src]pub const fn new(x: T) -> Self
[src]
pub fn transform_point(self, point: Point2D<T, Src>) -> Point2D<T::Output, Dst> where
T: Copy + Mul,
[src]
pub fn transform_point(self, point: Point2D<T, Src>) -> Point2D<T::Output, Dst> where
T: Copy + Mul,
[src]Returns the given point transformed by this scale.
Example
use euclid::{Scale, point2}; enum Mm {}; enum Cm {}; let to_mm: Scale<i32, Cm, Mm> = Scale::new(10); assert_eq!(to_mm.transform_point(point2(42, -42)), point2(420, -420));
pub fn transform_point3d(
self,
point: Point3D<T, Src>
) -> Point3D<T::Output, Dst> where
T: Copy + Mul,
[src]
pub fn transform_point3d(
self,
point: Point3D<T, Src>
) -> Point3D<T::Output, Dst> where
T: Copy + Mul,
[src]Returns the given point transformed by this scale.
pub fn transform_vector(self, vec: Vector2D<T, Src>) -> Vector2D<T::Output, Dst> where
T: Copy + Mul,
[src]
pub fn transform_vector(self, vec: Vector2D<T, Src>) -> Vector2D<T::Output, Dst> where
T: Copy + Mul,
[src]Returns the given vector transformed by this scale.
Example
use euclid::{Scale, vec2}; enum Mm {}; enum Cm {}; let to_mm: Scale<i32, Cm, Mm> = Scale::new(10); assert_eq!(to_mm.transform_vector(vec2(42, -42)), vec2(420, -420));
pub fn transform_size(self, size: Size2D<T, Src>) -> Size2D<T::Output, Dst> where
T: Copy + Mul,
[src]
pub fn transform_size(self, size: Size2D<T, Src>) -> Size2D<T::Output, Dst> where
T: Copy + Mul,
[src]Returns the given vector transformed by this scale.
Example
use euclid::{Scale, size2}; enum Mm {}; enum Cm {}; let to_mm: Scale<i32, Cm, Mm> = Scale::new(10); assert_eq!(to_mm.transform_size(size2(42, -42)), size2(420, -420));
pub fn transform_rect(self, rect: &Rect<T, Src>) -> Rect<T::Output, Dst> where
T: Copy + Mul,
[src]
pub fn transform_rect(self, rect: &Rect<T, Src>) -> Rect<T::Output, Dst> where
T: Copy + Mul,
[src]Returns the given rect transformed by this scale.
Example
use euclid::{Scale, rect}; enum Mm {}; enum Cm {}; let to_mm: Scale<i32, Cm, Mm> = Scale::new(10); assert_eq!(to_mm.transform_rect(&rect(1, 2, 42, -42)), rect(10, 20, 420, -420));
pub fn transform_box2d(self, b: &Box2D<T, Src>) -> Box2D<T::Output, Dst> where
T: Copy + Mul,
[src]
pub fn transform_box2d(self, b: &Box2D<T, Src>) -> Box2D<T::Output, Dst> where
T: Copy + Mul,
[src]Returns the given box transformed by this scale.
pub fn transform_box3d(self, b: &Box3D<T, Src>) -> Box3D<T::Output, Dst> where
T: Copy + Mul,
[src]
pub fn transform_box3d(self, b: &Box3D<T, Src>) -> Box3D<T::Output, Dst> where
T: Copy + Mul,
[src]Returns the given box transformed by this scale.
pub fn is_identity(self) -> bool where
T: PartialEq + One,
[src]
pub fn is_identity(self) -> bool where
T: PartialEq + One,
[src]Returns true
if this scale has no effect.
Example
use euclid::Scale; use euclid::num::One; enum Mm {}; enum Cm {}; let cm_per_mm: Scale<f32, Mm, Cm> = Scale::new(0.1); let mm_per_mm: Scale<f32, Mm, Mm> = Scale::new(1.0); assert_eq!(cm_per_mm.is_identity(), false); assert_eq!(mm_per_mm.is_identity(), true); assert_eq!(mm_per_mm, Scale::one());
impl<T: NumCast, Src, Dst> Scale<T, Src, Dst>
[src]
impl<T: NumCast, Src, Dst> Scale<T, Src, Dst>
[src]pub fn cast<NewT: NumCast>(self) -> Scale<NewT, Src, Dst>
[src]
pub fn cast<NewT: NumCast>(self) -> Scale<NewT, Src, Dst>
[src]Cast from one numeric representation to another, preserving the units.
Panics
If the source value cannot be represented by the target type NewT
, then
method panics. Use try_cast
if that must be case.
Example
use euclid::Scale; enum Mm {}; enum Cm {}; let to_mm: Scale<i32, Cm, Mm> = Scale::new(10); assert_eq!(to_mm.cast::<f32>(), Scale::new(10.0));
That conversion will panic, because i32
not enough to store such big numbers:
use euclid::Scale; enum Mm {};// millimeter = 10^-2 meters enum Em {};// exameter = 10^18 meters // Panics let to_em: Scale<i32, Mm, Em> = Scale::new(10e20).cast();
pub fn try_cast<NewT: NumCast>(self) -> Option<Scale<NewT, Src, Dst>>
[src]
pub fn try_cast<NewT: NumCast>(self) -> Option<Scale<NewT, Src, Dst>>
[src]Fallible cast from one numeric representation to another, preserving the units.
If the source value cannot be represented by the target type NewT
, then None
is returned.
Example
use euclid::Scale; enum Mm {}; enum Cm {}; enum Em {};// Exameter = 10^18 meters let to_mm: Scale<i32, Cm, Mm> = Scale::new(10); let to_em: Scale<f32, Mm, Em> = Scale::new(10e20); assert_eq!(to_mm.try_cast::<f32>(), Some(Scale::new(10.0))); // Integer to small to store that number assert_eq!(to_em.try_cast::<i32>(), None);
Trait Implementations
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Box2D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Box2D<T, U>
[src]fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Box3D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Box3D<T, U>
[src]fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Point2D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Point2D<T, U>
[src]fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Point3D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Point3D<T, U>
[src]fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Rect<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Rect<T, U>
[src]fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
[src]fn div_assign(&mut self, other: Scale<T, U, U>)
[src]
fn div_assign(&mut self, other: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Size2D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Size2D<T, U>
[src]fn div_assign(&mut self, other: Scale<T, U, U>)
[src]
fn div_assign(&mut self, other: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Size3D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Size3D<T, U>
[src]fn div_assign(&mut self, other: Scale<T, U, U>)
[src]
fn div_assign(&mut self, other: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Vector2D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Vector2D<T, U>
[src]fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Vector3D<T, U>
[src]
impl<T: Copy + DivAssign, U> DivAssign<Scale<T, U, U>> for Vector3D<T, U>
[src]fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn div_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the /=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Box2D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Box2D<T, U>
[src]fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Box3D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Box3D<T, U>
[src]fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Point2D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Point2D<T, U>
[src]fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Point3D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Point3D<T, U>
[src]fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Rect<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Rect<T, U>
[src]fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
[src]fn mul_assign(&mut self, other: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, other: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Size2D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Size2D<T, U>
[src]fn mul_assign(&mut self, other: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, other: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Size3D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Size3D<T, U>
[src]fn mul_assign(&mut self, other: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, other: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Vector2D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Vector2D<T, U>
[src]fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Vector3D<T, U>
[src]
impl<T: Copy + MulAssign, U> MulAssign<Scale<T, U, U>> for Vector3D<T, U>
[src]fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]
fn mul_assign(&mut self, scale: Scale<T, U, U>)
[src]Performs the *=
operation. Read more
impl<T: Ord, Src, Dst> Ord for Scale<T, Src, Dst>
[src]
impl<T: Ord, Src, Dst> Ord for Scale<T, Src, Dst>
[src]impl<T: PartialOrd, Src, Dst> PartialOrd<Scale<T, Src, Dst>> for Scale<T, Src, Dst>
[src]
impl<T: PartialOrd, Src, Dst> PartialOrd<Scale<T, Src, Dst>> for Scale<T, Src, Dst>
[src]fn partial_cmp(&self, other: &Self) -> Option<Ordering>
[src]
fn partial_cmp(&self, other: &Self) -> Option<Ordering>
[src]This method returns an ordering between self
and other
values if one exists. Read more
#[must_use]fn lt(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]fn lt(&self, other: &Rhs) -> bool
1.0.0[src]This method tests less than (for self
and other
) and is used by the <
operator. Read more
#[must_use]fn le(&self, other: &Rhs) -> bool
1.0.0[src]
#[must_use]fn le(&self, other: &Rhs) -> bool
1.0.0[src]This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl<T: Copy, Src, Dst> Copy for Scale<T, Src, Dst>
[src]
impl<T: Eq, Src, Dst> Eq for Scale<T, Src, Dst>
[src]
Auto Trait Implementations
impl<T, Src, Dst> RefUnwindSafe for Scale<T, Src, Dst> where
Dst: RefUnwindSafe,
Src: RefUnwindSafe,
T: RefUnwindSafe,
Dst: RefUnwindSafe,
Src: RefUnwindSafe,
T: RefUnwindSafe,
impl<T, Src, Dst> Send for Scale<T, Src, Dst> where
Dst: Send,
Src: Send,
T: Send,
Dst: Send,
Src: Send,
T: Send,
impl<T, Src, Dst> Sync for Scale<T, Src, Dst> where
Dst: Sync,
Src: Sync,
T: Sync,
Dst: Sync,
Src: Sync,
T: Sync,
impl<T, Src, Dst> Unpin for Scale<T, Src, Dst> where
Dst: Unpin,
Src: Unpin,
T: Unpin,
Dst: Unpin,
Src: Unpin,
T: Unpin,
impl<T, Src, Dst> UnwindSafe for Scale<T, Src, Dst> where
Dst: UnwindSafe,
Src: UnwindSafe,
T: UnwindSafe,
Dst: UnwindSafe,
Src: UnwindSafe,
T: UnwindSafe,
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more