Skip to main content

Transform2D

Struct Transform2D 

Source
pub struct Transform2D {
    pub tx: f64,
    pub ty: f64,
    pub angle: f64,
}
Expand description

A 2D rigid transformation (rotation + translation).

Internally uses nalgebra Isometry2 for correct composition and inversion. The representation stores translation (tx, ty) and rotation angle in radians.

§Example

use u_geometry::transform::Transform2D;
use std::f64::consts::PI;

let t = Transform2D::new(10.0, 20.0, PI / 2.0);
let (x, y) = t.apply(1.0, 0.0);
assert!((x - 10.0).abs() < 1e-10);
assert!((y - 21.0).abs() < 1e-10);

Fields§

§tx: f64

Translation x.

§ty: f64

Translation y.

§angle: f64

Rotation angle in radians.

Implementations§

Source§

impl Transform2D

Source

pub fn identity() -> Self

Identity transform (no rotation, no translation).

Source

pub fn translation(tx: f64, ty: f64) -> Self

Creates a translation-only transform.

Source

pub fn rotation(angle: f64) -> Self

Creates a rotation-only transform (about the origin).

Source

pub fn new(tx: f64, ty: f64, angle: f64) -> Self

Creates a transform with translation and rotation.

Source

pub fn to_isometry(&self) -> Isometry2<f64>

Converts to a nalgebra Isometry2.

Source

pub fn from_isometry(iso: &Isometry2<f64>) -> Self

Creates from a nalgebra Isometry2.

Source

pub fn apply(&self, x: f64, y: f64) -> (f64, f64)

Applies this transform to a point.

Source

pub fn apply_point(&self, p: &Point2) -> Point2

Applies this transform to a Point2.

Source

pub fn apply_points(&self, points: &[(f64, f64)]) -> Vec<(f64, f64)>

Transforms a slice of points.

Source

pub fn then(&self, other: &Self) -> Self

Composes two transforms: applies self first, then other.

Source

pub fn inverse(&self) -> Self

Returns the inverse transform.

Source

pub fn is_identity(&self, epsilon: f64) -> bool

Whether this is approximately an identity transform.

Trait Implementations§

Source§

impl Clone for Transform2D

Source§

fn clone(&self) -> Transform2D

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Transform2D

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Transform2D

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl PartialEq for Transform2D

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl Copy for Transform2D

Source§

impl StructuralPartialEq for Transform2D

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

Source§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
Source§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
Source§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
Source§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Scalar for T
where T: 'static + Clone + PartialEq + Debug,