Struct immense::Transform

pub struct Transform { /* private fields */ }

A Transform, when applied, modifies a mesh. When applied to a rule, it transforms all the meshes that rule eventually expands to. Transforms may be translations, scales, rotations, etc.

It may be helpful to think of transforms to rules as transforming the space in which the rule or mesh is evaluated. For example this rule will translate a cube 4.0 on the x axis in our root frame of reference:

let our_translated_cube = Rule::new().push(Tf::tx(4.0), cube());

This rule will translate a cube -4.0 on the x axis in our root frame of reference:

let containing_rule = Rule::new().push(Tf::ry(180.0), our_translated_cube);

This rule will translate a half-sized cube 2.0 on the x axis in our root frame of reference.

let containing_rule = Rule::new().push(Tf::s(0.5), our_translated_cube)

Implementations

impl Transform

pub fn t(x: f32, y: f32, z: f32) -> Self

A translation on all axes.

pub fn tx(x: f32) -> Self

A translation on the x axis.

pub fn ty(y: f32) -> Self

A translation on the y axis.

pub fn tz(z: f32) -> Self

A translation on the z axis.

pub fn s(factor: f32) -> Self

A uniform scale in all dimensions.

pub fn sby(x: f32, y: f32, z: f32) -> Self

A scale in all dimensions.

pub fn rx(x: f32) -> Self

A rotation about the x axis.

pub fn ry(y: f32) -> Self

A rotation about the y axis.

pub fn rz(z: f32) -> Self

A rotation about the z axis.

pub fn color(color: Hsv) -> Self

A color override that takes precedence over colors set higher in the rule tree.

pub fn hue(delta: impl Into<RgbHue<f32>>) -> Self

Adds delta to the current color hue.

pub fn saturation(factor: f32) -> Self

Multiplies the current color saturation by factor

pub fn value(factor: f32) -> Self

Multiplies the current color value by factor.

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 Debug for Transform

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

Formats the value using the given formatter.

impl Default for Transform

fn default() -> Self

Returns the “default value” for a type.

impl From<Transform> for TransformArgument

A single transform will correspond to one invocation.

fn from(transform: Transform) -> Self

Converts to this type from the input type.

impl Copy for Transform