Struct gdnative::core_types::Transform

source · [−]

#[repr(C)]pub struct Transform {
    pub basis: Basis,
    pub origin: Vector3,
}

Expand description

Affine 3D transform (3x4 matrix).

Used for 3D linear transformations. Uses a basis + origin representation.

Expressed as a 3x4 matrix, this transform consists of 3 basis (column) vectors a, b, c as well as an origin o; more information in Self::from_basis_origin():

[ a.x  b.x  c.x  o.x ]
[ a.y  b.y  c.y  o.y ]
[ a.z  b.z  c.z  o.z ]

See also Transform in the Godot API doc.

Fields

basis: Basis

The basis is a matrix containing 3 vectors as its columns. They can be interpreted as the basis vectors of the transformed coordinate system.

origin: Vector3

The new origin of the transformed coordinate system.

Implementations

source

impl Transform

source

pub const IDENTITY: Transform = Self{ basis: Basis::IDENTITY, origin: Vector3::ZERO,}

Identity transform; leaves objects unchanged when applied.

source

pub const FLIP_X: Transform = Self{ basis: Basis::FLIP_X, origin: Vector3::ZERO,}

Transform that mirrors along the X axis (perpendicular to the YZ plane).

source

pub const FLIP_Y: Transform = Self{ basis: Basis::FLIP_Y, origin: Vector3::ZERO,}

Transform that mirrors along the Y axis (perpendicular to the XZ plane).

source

pub const FLIP_Z: Transform = Self{ basis: Basis::FLIP_Z, origin: Vector3::ZERO,}

Transform that mirrors along the Z axis (perpendicular to the XY plane).

source

pub const fn from_basis_origin(
    basis_vector_a: Vector3,
    basis_vector_b: Vector3,
    basis_vector_c: Vector3,
    origin: Vector3
) -> Transform

Creates a new transform from three basis vectors and the coordinate system’s origin.

Each vector represents a basis vector in the transformed coordinate system. For example, a is the result of transforming the X unit vector (1, 0, 0). The 3 vectors need to be linearly independent.

Basis vectors are stored as column vectors in the matrix, see also Basis::from_basis_vectors().

The construction Transform::from_basis_origin(a, b, c, o) will create the following 3x4 matrix:

[ a.x  b.x  c.x  o.x ]
[ a.y  b.y  c.y  o.y ]
[ a.z  b.z  c.z  o.z ]

source

pub fn translated(&self, translation: Vector3) -> Transform

Returns this transform, with its origin moved by a certain translation

source

pub fn xform(&self, v: Vector3) -> Vector3

Returns a vector transformed (multiplied) by the matrix.

source

pub fn xform_inv(&self, v: Vector3) -> Vector3

Returns a vector transformed (multiplied) by the transposed basis matrix.

Note: This results in a multiplication by the inverse of the matrix only if it represents a rotation-reflection.

source

pub fn inverse(&self) -> Transform

Returns the inverse of the transform, under the assumption that the transformation is composed of rotation and translation (no scaling, use affine_inverse for transforms with scaling).

source

pub fn affine_inverse(&self) -> Transform

Returns the inverse of the transform, under the assumption that the transformation is composed of rotation, scaling and translation.

source

pub fn looking_at(&self, target: Vector3, up: Vector3) -> Transform

Returns a copy of the transform rotated such that its -Z axis points towards the target position.

The transform will first be rotated around the given up vector, and then fully aligned to the target by a further rotation around an axis perpendicular to both the target and up vectors.