Struct Similarity 

pub struct Similarity {
    pub scale: f64,
    pub rotation: DQuat,
    pub translation: DVec3,
}

The similarity group Sim(3): uniform scale + rotation + translation.

This is the closure group of shapes defined by angles and length ratios (circles, spheres, squares, regular polygons, circular arcs): baking any similarity into them preserves their semantics.

Fields

scale: f64

The finite, strictly positive uniform scale factor.

rotation: DQuat

The rotation part.

translation: DVec3

The translation part.

Implementations

impl Similarity

pub const IDENTITY: Self

The identity similarity.

pub fn from_scale(scale: f64) -> Self

A pure uniform scale.

Panics

Panics if scale is not finite and strictly positive, because zero and orientation-reversing scales are not elements of Sim(3) as modeled here.

pub fn transform_point(&self, p: DVec3) -> DVec3

Transform a point: s * (R * p) + t.

pub fn transform_direction(&self, v: DVec3) -> DVec3

Transform a direction vector (rotation only, preserving unit length).

Trait Implementations

impl Clone for Similarity

fn clone(&self) -> Similarity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Similarity

impl Debug for Similarity

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

Formats the value using the given formatter.

impl From<Rigid> for Similarity

fn from(r: Rigid) -> Self

Converts to this type from the input type.

impl From<Similarity> for DAffine3

fn from(s: Similarity) -> Self

Converts to this type from the input type.

impl From<Translation> for Similarity

fn from(t: Translation) -> Self

Converts to this type from the input type.

impl Interpolatable for Similarity

fn lerp(&self, target: &Self, t: f64) -> Self

Lerping between values

impl PartialEq for Similarity

fn eq(&self, other: &Similarity) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Similarity

impl TransformGroup for Similarity

fn identity() -> Self

The identity transformation.

fn compose(&self, inner: &Self) -> Self

Compose self outside inner, returning self * inner.

impl TryFrom<DAffine3> for Similarity

fn try_from(affine: DAffine3) -> Result<Self, Self::Error>

Extract a similarity from an affine transform, checking that the linear part is a uniform-scale rotation (three equal singular values, no shear, no reflection).

type Error = NotSimilarity

The type returned in the event of a conversion error.