Struct GeneralTransform 

pub struct GeneralTransform {
    pub linear: Matrix3,
    pub translation: Vector,
}

A general affine transform: any linear part, plus a translation.

Non-uniform scaling and shear are allowed, so angles are not preserved and analytic geometry does not survive intact. Kept distinct from Transform so that cannot happen by accident.

Fields

linear: Matrix3

The linear part.

translation: Vector

The translation.

Implementations

impl GeneralTransform

pub const IDENTITY: Self

The identity.

pub const fn new(linear: Matrix3, translation: Vector) -> Self

From a linear part and a translation.

pub const fn scaling_xyz(x: f64, y: f64, z: f64) -> Self

Non-uniform scaling about the origin.

pub fn apply(&self, p: Point) -> Point

Apply to a point.

pub fn apply_vector(&self, v: Vector) -> Vector

Apply to a free vector.

pub fn apply_normal(&self, n: Vector) -> OgeomResult<Vector>

Apply to a normal vector.

Normals transform by the inverse transpose, not by the linear part itself. Using the linear part directly is only correct for a similarity; under any shear or non-uniform scale it tilts normals off the surface they belong to, which then breaks every orientation test downstream.

The result is not renormalized; it is a direction, not a length.

Errors

OgeomError::Numeric if the linear part is singular.

pub fn preserves_handedness(&self) -> bool

Whether this transform preserves handedness.

pub fn volume_ratio(&self) -> f64

The factor by which volumes are multiplied. Negative if handedness flips.

pub fn inverse(&self) -> OgeomResult<Self>

The inverse.

Errors

OgeomError::Numeric if the linear part is singular.

pub fn is_similarity(&self, eps: f64) -> bool

Whether this is a similarity, and so can be narrowed to a Transform.

pub fn to_similarity(&self, eps: f64) -> Option<Transform>

This transform as a Transform, if it is in fact a similarity.

Returns None when the linear part contains shear or non-uniform scaling, since no similarity describes it.

Trait Implementations

impl Clone for GeneralTransform

fn clone(&self) -> GeneralTransform

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for GeneralTransform

impl Debug for GeneralTransform

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

Formats the value using the given formatter.

impl Default for GeneralTransform

fn default() -> Self

Returns the “default value” for a type.

impl From<Transform> for GeneralTransform

fn from(t: Transform) -> Self

Converts to this type from the input type.

impl Mul for GeneralTransform

fn mul(self, b: Self) -> Self

Composition. (a * b) applies b first, then a.

type Output = GeneralTransform

The resulting type after applying the * operator.

impl PartialEq for GeneralTransform

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GeneralTransform