Struct Scale
#[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;
Tuple Fields§
§0: T
Implementations§
§impl<T, Src, Dst> Scale<T, Src, Dst>
impl<T, Src, Dst> Scale<T, Src, Dst>
pub const fn new(x: T) -> Scale<T, Src, Dst>
pub fn transform_point(
self,
point: Point2D<T, Src>,
) -> Point2D<<T as Mul>::Output, Dst>
pub fn transform_point( self, point: Point2D<T, Src>, ) -> Point2D<<T as Mul>::Output, Dst>
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 as Mul>::Output, Dst>
pub fn transform_point3d( self, point: Point3D<T, Src>, ) -> Point3D<<T as Mul>::Output, Dst>
Returns the given point transformed by this scale.
pub fn transform_vector(
self,
vec: Vector2D<T, Src>,
) -> Vector2D<<T as Mul>::Output, Dst>
pub fn transform_vector( self, vec: Vector2D<T, Src>, ) -> Vector2D<<T as Mul>::Output, Dst>
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 as Mul>::Output, Dst>
pub fn transform_size( self, size: Size2D<T, Src>, ) -> Size2D<<T as Mul>::Output, Dst>
Returns the given size 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 as Mul>::Output, Dst>
pub fn transform_rect( self, rect: &Rect<T, Src>, ) -> Rect<<T as Mul>::Output, Dst>
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 as Mul>::Output, Dst>
pub fn transform_box2d( self, b: &Box2D<T, Src>, ) -> Box2D<<T as Mul>::Output, Dst>
Returns the given box transformed by this scale.
pub fn transform_box3d(
self,
b: &Box3D<T, Src>,
) -> Box3D<<T as Mul>::Output, Dst>
pub fn transform_box3d( self, b: &Box3D<T, Src>, ) -> Box3D<<T as Mul>::Output, Dst>
Returns the given box transformed by this scale.
pub fn is_identity(self) -> bool
pub fn is_identity(self) -> bool
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());
pub fn get(self) -> T
pub fn get(self) -> T
Returns the underlying scalar scale factor.
§impl<T, Src, Dst> Scale<T, Src, Dst>where
T: PartialOrd,
impl<T, Src, Dst> Scale<T, Src, Dst>where
T: PartialOrd,
§impl<T, Src, Dst> Scale<T, Src, Dst>where
T: NumCast,
impl<T, Src, Dst> Scale<T, Src, Dst>where
T: NumCast,
pub fn cast<NewT>(self) -> Scale<NewT, Src, Dst>where
NewT: NumCast,
pub fn cast<NewT>(self) -> Scale<NewT, Src, Dst>where
NewT: NumCast,
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>(self) -> Option<Scale<NewT, Src, Dst>>where
NewT: NumCast,
pub fn try_cast<NewT>(self) -> Option<Scale<NewT, Src, Dst>>where
NewT: NumCast,
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<'de, T, Src, Dst> Deserialize<'de> for Scale<T, Src, Dst>where
T: Deserialize<'de>,
impl<'de, T, Src, Dst> Deserialize<'de> for Scale<T, Src, Dst>where
T: Deserialize<'de>,
§fn deserialize<__D>(
__deserializer: __D,
) -> Result<Scale<T, Src, Dst>, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(
__deserializer: __D,
) -> Result<Scale<T, Src, Dst>, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
source§impl<T, U1, U2> Div<Scale<T, U1, U2>> for SideOffsets2D<T, U2>
impl<T, U1, U2> Div<Scale<T, U1, U2>> for SideOffsets2D<T, U2>
§impl<T, U1, U2> Div<Scale<T, U1, U2>> for SideOffsets2D<T, U2>
impl<T, U1, U2> Div<Scale<T, U1, U2>> for SideOffsets2D<T, U2>
§impl<T, U> DivAssign<Scale<T, U, U>> for Box2D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Box2D<T, U>
§fn div_assign(&mut self, scale: Scale<T, U, U>)
fn div_assign(&mut self, scale: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Box3D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Box3D<T, U>
§fn div_assign(&mut self, scale: Scale<T, U, U>)
fn div_assign(&mut self, scale: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Point2D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Point2D<T, U>
§fn div_assign(&mut self, scale: Scale<T, U, U>)
fn div_assign(&mut self, scale: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Point3D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Point3D<T, U>
§fn div_assign(&mut self, scale: Scale<T, U, U>)
fn div_assign(&mut self, scale: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Rect<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Rect<T, U>
§fn div_assign(&mut self, scale: Scale<T, U, U>)
fn div_assign(&mut self, scale: Scale<T, U, U>)
/=
operation. Read moresource§impl<T, U> DivAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
source§fn div_assign(&mut self, other: Scale<T, U, U>)
fn div_assign(&mut self, other: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
§fn div_assign(&mut self, other: Scale<T, U, U>)
fn div_assign(&mut self, other: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Size2D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Size2D<T, U>
§fn div_assign(&mut self, other: Scale<T, U, U>)
fn div_assign(&mut self, other: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Size3D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Size3D<T, U>
§fn div_assign(&mut self, other: Scale<T, U, U>)
fn div_assign(&mut self, other: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Vector2D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Vector2D<T, U>
§fn div_assign(&mut self, scale: Scale<T, U, U>)
fn div_assign(&mut self, scale: Scale<T, U, U>)
/=
operation. Read more§impl<T, U> DivAssign<Scale<T, U, U>> for Vector3D<T, U>
impl<T, U> DivAssign<Scale<T, U, U>> for Vector3D<T, U>
§fn div_assign(&mut self, scale: Scale<T, U, U>)
fn div_assign(&mut self, scale: Scale<T, U, U>)
/=
operation. Read moresource§impl<T, U1, U2> Mul<Scale<T, U1, U2>> for SideOffsets2D<T, U1>
impl<T, U1, U2> Mul<Scale<T, U1, U2>> for SideOffsets2D<T, U1>
§impl<T, U1, U2> Mul<Scale<T, U1, U2>> for SideOffsets2D<T, U1>
impl<T, U1, U2> Mul<Scale<T, U1, U2>> for SideOffsets2D<T, U1>
§impl<T, U> MulAssign<Scale<T, U, U>> for Box2D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Box2D<T, U>
§fn mul_assign(&mut self, scale: Scale<T, U, U>)
fn mul_assign(&mut self, scale: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Box3D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Box3D<T, U>
§fn mul_assign(&mut self, scale: Scale<T, U, U>)
fn mul_assign(&mut self, scale: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Point2D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Point2D<T, U>
§fn mul_assign(&mut self, scale: Scale<T, U, U>)
fn mul_assign(&mut self, scale: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Point3D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Point3D<T, U>
§fn mul_assign(&mut self, scale: Scale<T, U, U>)
fn mul_assign(&mut self, scale: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Rect<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Rect<T, U>
§fn mul_assign(&mut self, scale: Scale<T, U, U>)
fn mul_assign(&mut self, scale: Scale<T, U, U>)
*=
operation. Read moresource§impl<T, U> MulAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
source§fn mul_assign(&mut self, other: Scale<T, U, U>)
fn mul_assign(&mut self, other: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for SideOffsets2D<T, U>
§fn mul_assign(&mut self, other: Scale<T, U, U>)
fn mul_assign(&mut self, other: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Size2D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Size2D<T, U>
§fn mul_assign(&mut self, other: Scale<T, U, U>)
fn mul_assign(&mut self, other: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Size3D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Size3D<T, U>
§fn mul_assign(&mut self, other: Scale<T, U, U>)
fn mul_assign(&mut self, other: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Vector2D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Vector2D<T, U>
§fn mul_assign(&mut self, scale: Scale<T, U, U>)
fn mul_assign(&mut self, scale: Scale<T, U, U>)
*=
operation. Read more§impl<T, U> MulAssign<Scale<T, U, U>> for Vector3D<T, U>
impl<T, U> MulAssign<Scale<T, U, U>> for Vector3D<T, U>
§fn mul_assign(&mut self, scale: Scale<T, U, U>)
fn mul_assign(&mut self, scale: Scale<T, U, U>)
*=
operation. Read more§impl<T, Src, Dst> Ord for Scale<T, Src, Dst>where
T: Ord,
impl<T, Src, Dst> Ord for Scale<T, Src, Dst>where
T: Ord,
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
§impl<T, Src, Dst> PartialOrd for Scale<T, Src, Dst>where
T: PartialOrd,
impl<T, Src, Dst> PartialOrd for Scale<T, Src, Dst>where
T: PartialOrd,
§impl<T, Src, Dst> Serialize for Scale<T, Src, Dst>where
T: Serialize,
impl<T, Src, Dst> Serialize for Scale<T, Src, Dst>where
T: Serialize,
§fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
fn serialize<__S>(
&self,
__serializer: __S,
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
impl<T, Src, Dst> Copy for Scale<T, Src, Dst>where
T: Copy,
impl<T, Src, Dst> Eq for Scale<T, Src, Dst>where
T: Eq,
impl<T, Src, Dst> Pod for Scale<T, Src, Dst>where
T: Pod,
Src: 'static,
Dst: 'static,
Auto Trait Implementations§
impl<T, Src, Dst> Freeze for Scale<T, Src, Dst>where
T: Freeze,
impl<T, Src, Dst> RefUnwindSafe for Scale<T, Src, Dst>
impl<T, Src, Dst> Send for Scale<T, Src, Dst>
impl<T, Src, Dst> Sync for Scale<T, Src, Dst>
impl<T, Src, Dst> Unpin for Scale<T, Src, Dst>
impl<T, Src, Dst> UnwindSafe for Scale<T, Src, Dst>
Blanket Implementations§
source§impl<T> AnyVarValue for Twhere
T: VarValue,
impl<T> AnyVarValue for Twhere
T: VarValue,
source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
dyn Any
methods.source§fn clone_boxed(&self) -> Box<dyn AnyVarValue>
fn clone_boxed(&self) -> Box<dyn AnyVarValue>
source§fn clone_boxed_var(&self) -> Box<dyn AnyVar>
fn clone_boxed_var(&self) -> Box<dyn AnyVar>
LocalVar<Self>
.source§fn eq_any(&self, other: &(dyn AnyVarValue + 'static)) -> bool
fn eq_any(&self, other: &(dyn AnyVarValue + 'static)) -> bool
self
equals other
.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
§impl<T> CheckedBitPattern for Twhere
T: AnyBitPattern,
impl<T> CheckedBitPattern for Twhere
T: AnyBitPattern,
§type Bits = T
type Bits = T
Self
must have the same layout as the specified Bits
except for
the possible invalid bit patterns being checked during
is_valid_bit_pattern
.§fn is_valid_bit_pattern(_bits: &T) -> bool
fn is_valid_bit_pattern(_bits: &T) -> bool
bits
as &Self
.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
)§impl<Q, K> Comparable<K> for Q
impl<Q, K> Comparable<K> for Q
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more