Struct pbrt::core::transform::Transform

pub struct Transform { /* fields omitted */ }

Transform represents a Matrix4x4 and its inverse.

Methods

impl Transform

pub fn identity() -> Transform

Returns a new Transform set to the identity matrix.

Examples

use pbrt::core::transform::Matrix4x4;
use pbrt::core::transform::Transform;

assert_eq!(
    Transform::identity(),
    Matrix4x4::new(
        [1., 0., 0., 0.],
        [0., 1., 0., 0.],
        [0., 0., 1., 0.],
        [0., 0., 0., 1.]
    )
    .into()
);

pub fn inverse(&self) -> Transform

Returns the inverse Transform of self.

Examples

use pbrt::core::transform::Matrix4x4;
use pbrt::core::transform::Transform;

let t = Transform::identity();
assert_eq!(
    t.inverse(),
    Matrix4x4::new(
        [1., 0., 0., 0.],
        [0., 1., 0., 0.],
        [0., 0., 1., 0.],
        [0., 0., 0., 1.]
    )
    .into()
);

pub fn translate<V>(delta: V) -> Transform where
    V: Into<Vector3f>, 

Creates a Transform representing the given translate factors.

Examples

use pbrt::core::transform::Matrix4x4;
use pbrt::core::transform::Transform;

assert_eq!(
    Transform::translate([2., 4., 6.]),
    Matrix4x4::new(
        [1., 0., 0., 2.],
        [0., 1., 0., 4.],
        [0., 0., 1., 6.],
        [0., 0., 0., 1.]
    )
    .into()
);

pub fn rotate<V>(theta: Degree, axis: V) -> Transform where
    V: Into<Vector3f>, 

Creates a Transform representing a rotation of theta about axis.

Examples

use pbrt::core::transform::Matrix4x4;
use pbrt::core::transform::Transform;
use pbrt::Degree;
use pbrt::Float;

let t_deg: Float = 180.;
let t_rad = t_deg.to_radians();
let s = t_rad.sin();
let c = t_rad.cos();

// Rotate about the x-axis.
assert_eq!(
    Transform::rotate(t_deg.into(), [1., 0., 0.]),
    Matrix4x4::new(
        [1., 0., 0., 0.],
        [0., c, -s, 0.],
        [0., s, c, 0.],
        [0., 0., 0., 1.]
    )
    .into()
);

// Rotate about the y-axis.
assert_eq!(
    Transform::rotate(t_deg.into(), [0., 1., 0.]),
    Matrix4x4::new(
        [c, 0., s, 0.],
        [0., 1., 0., 0.],
        [-s, 0., c, 0.],
        [0., 0., 0., 1.]
    )
    .into()
);

// Rotate about the z-axis.
assert_eq!(
    Transform::rotate(t_deg.into(), [0., 0., 1.]),
    Matrix4x4::new(
        [c, -s, 0., 0.],
        [s, c, 0., 0.],
        [0., 0., 1., 0.],
        [0., 0., 0., 1.]
    )
    .into()
);

pub fn scale(sx: Float, sy: Float, sz: Float) -> Transform

Creates a Transform representing the given scale factors.

Examples

use pbrt::core::transform::Matrix4x4;
use pbrt::core::transform::Transform;

assert_eq!(
    Transform::scale(2., 4., 6.),
    Matrix4x4::new(
        [2., 0., 0., 0.],
        [0., 4., 0., 0.],
        [0., 0., 6., 0.],
        [0., 0., 0., 1.]
    )
    .into()
);

pub fn matrix(self) -> Matrix4x4

Returns the internal Matrix4x4 of self.

Examples

use pbrt::core::transform::Matrix4x4;
use pbrt::core::transform::Transform;

let t = Transform::identity();
assert_eq!(
    t.matrix(),
    Matrix4x4::new(
        [1., 0., 0., 0.],
        [0., 1., 0., 0.],
        [0., 0., 1., 0.],
        [0., 0., 0., 1.]
    )
);

pub fn matrix_inverse(self) -> Matrix4x4

Returns the internal inverse Matrix4x4 of self.

Examples

use pbrt::core::transform::Matrix4x4;
use pbrt::core::transform::Transform;

let t = Transform::identity();
assert_eq!(
    t.matrix_inverse(),
    Matrix4x4::new(
        [1., 0., 0., 0.],
        [0., 1., 0., 0.],
        [0., 0., 1., 0.],
        [0., 0., 0., 1.]
    )
);

Trait Implementations

impl Clone for Transform

fn clone(&self) -> Transform

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Transform

impl Debug for Transform

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

Formats the value using the given formatter.

impl Default for Transform

fn default() -> Transform

Returns the "default value" for a type.

impl From<[f32; 16]> for Transform

fn from(t: [Float; 16]) -> Self

Performs the conversion.

impl From<Matrix4x4> for Transform

fn from(m: Matrix4x4) -> Transform

Performs the conversion.

impl<'a, 'b> Mul<&'b mut Transform> for &'a mut Transform

type Output = Transform

The resulting type after applying the * operator.

fn mul(self, rhs: &'b mut Transform) -> Transform

Performs the * operation.

impl Mul<Transform> for Transform

type Output = Transform

The resulting type after applying the * operator.

fn mul(self, rhs: Transform) -> Transform

Performs the * operation.

impl PartialEq<Transform> for Transform

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for Transform