Struct Transformed 

pub struct Transformed<T, G> {
    pub inner: T,
    pub transform: G,
}

An item paired with an external transform represented by G.

inner retains its own representation while transform controls the extracted geometry. Composition is explicit about order:

• compose_outer: transform = outer * transform;
• compose_inner: transform = transform * inner.

Applying an H through ApplyTransform is outer composition and is only available when H embeds into the existing storage type (G: From<H>). Operations never widen the wrapper automatically. Widen explicitly with Into::into when a more general storage type is required.

use ranim_core::{glam::DVec3, prelude::*};

let mut item = ().transformed(Similarity::IDENTITY);
// `Diag` does not embed into `Similarity`; choose `DAffine3` storage first.
item.scale(DVec3::new(2.0, 1.0, 1.0));

Extraction and Aabb calculation convert G to [DAffine3] only at the geometry boundary. Projective transforms remain outside the model-transform system.

Fields

inner: T

The item expressed in its own coordinates.

transform: G

The external transform applied to inner.

Implementations

impl<T, G> Transformed<T, G>

pub fn new(inner: T, transform: G) -> Self

Pair inner with transform without converting either value.

pub fn map_inner<U, F>(self, f: F) -> Transformed<U, G>

where F: FnOnce(T) -> U,

Map the wrapped item to a new type, keeping transform unchanged.

pub fn map_transform<H, F>(self, f: F) -> Transformed<T, H>

where F: FnOnce(G) -> H,

Map the transform storage to a new type while keeping inner unchanged.

This is the general form of converting between transform groups — for example widening a placement or checked-narrowing an affine storage back to a subgroup. Lossless upward conversions need no closure at all: Transformed implements From<Transformed<T, X>> for Transformed<T, Y> whenever X embeds into Y, so prefer plain .into() there.

pub fn compose_outer<H>(&mut self, outer: H) -> &mut Self

where G: TransformGroup + From<H>,

Compose outer on the left: transform = outer * transform.

pub fn compose_inner<H>(&mut self, inner: H) -> &mut Self

where G: TransformGroup + From<H>,

Compose inner on the right: transform = transform * inner.

pub fn bake(self) -> T

where T: ApplyTransform<G>,

Bake the stored transform into inner and remove the wrapper.

This method exists only when T directly supports the wrapper’s exact transform representation G.

Trait Implementations

impl<T, G> Aabb for Transformed<T, G>

where T: Aabb, G: Clone + Into<DAffine3>,

fn aabb(&self) -> [DVec3; 2]

Get the Axis-aligned bounding box represent in [<min>, <max>].

fn aabb_size(&self) -> DVec3

Get the size of the Aabb.

fn aabb_center(&self) -> DVec3

Get the center of the Aabb.

impl<T: Alignable, G: Clone> Alignable for Transformed<T, G>

fn is_aligned(&self, other: &Self) -> bool

Checking if two items are aligned

fn align_with(&mut self, other: &mut Self)

Aligning two items

impl<T, G, H> ApplyTransform<H> for Transformed<T, G>

where G: TransformGroup + From<H>,

fn apply(&mut self, transform: H) -> &mut Self

Bake transform (expressed in world coordinates) into the item’s data, in place.

impl<T: Clone, G: Clone> Clone for Transformed<T, G>

fn clone(&self) -> Transformed<T, G>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug, G: Debug> Debug for Transformed<T, G>

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

Formats the value using the given formatter.

impl<T: Empty, G: TransformGroup> Empty for Transformed<T, G>

fn empty() -> Self

Create an empty placeholder of a wrapped item.

The inner item contributes T::empty() while the pose is G::identity(): an empty placeholder carries no geometry, so there is no meaningful placement to preserve — identity keeps it neutral for composition until real content is placed on it.

impl<T, G> Extract for Transformed<T, G>

where T: Extract<Target = CoreItem>, G: Clone + Into<DAffine3>,

type Target = CoreItem

Extraction target.

fn extract_into(&self, buf: &mut Vec<Self::Target>)

Append extracted values to buf.

fn extract(&self) -> Vec<Self::Target>

Extract into a newly allocated vector.

impl<T: FillColor, G> FillColor for Transformed<T, G>

fn fill_color(&self) -> AlphaColor<Srgb>

Getting fill color of an item

fn set_fill_color(&mut self, color: AlphaColor<Srgb>) -> &mut Self

Setting fill color(rgba) of an item

fn set_fill_opacity(&mut self, opacity: f32) -> &mut Self

Setting fill opacity of an item

impl<T> From<Transformed<T, Diag>> for Transformed<T, DAffine3>

fn from(value: Transformed<T, Diag>) -> Self

Converts to this type from the input type.

impl<T> From<Transformed<T, Rigid>> for Transformed<T, Similarity>

fn from(value: Transformed<T, Rigid>) -> Self

Converts to this type from the input type.

impl<T> From<Transformed<T, Rigid>> for Transformed<T, DAffine3>

fn from(value: Transformed<T, Rigid>) -> Self

Converts to this type from the input type.

impl<T> From<Transformed<T, Similarity>> for Transformed<T, DAffine3>

fn from(value: Transformed<T, Similarity>) -> Self

Converts to this type from the input type.

impl<T> From<Transformed<T, Translation>> for Transformed<T, Rigid>

fn from(value: Transformed<T, Translation>) -> Self

Converts to this type from the input type.

impl<T> From<Transformed<T, Translation>> for Transformed<T, Similarity>

fn from(value: Transformed<T, Translation>) -> Self

Converts to this type from the input type.

impl<T> From<Transformed<T, Translation>> for Transformed<T, DAffine3>

fn from(value: Transformed<T, Translation>) -> Self

Converts to this type from the input type.

impl<T: Interpolatable, G: Interpolatable> Interpolatable for Transformed<T, G>

fn lerp(&self, target: &Self, t: f64) -> Self

Lerping between values

impl<T, G> Locate<Transformed<T, G>> for Centroid

where Centroid: Locate<T>, G: Clone + Into<DAffine3>,

fn locate(&self, target: &Transformed<T, G>) -> DVec3

Locate self on the target

impl<T: Opacity, G> Opacity for Transformed<T, G>

fn set_opacity(&mut self, opacity: f32) -> &mut Self

Setting opacity of an item

impl<T: Partial, G: Clone> Partial for Transformed<T, G>

fn get_partial(&self, range: Range<f64>) -> Self

Take a partial slice of the wrapped item, keeping the pose.

The range is forwarded to inner, so the partial geometry is taken in the item’s own coordinates, while the stored transform G is cloned unchanged. The wrapper therefore keeps its placement while the visible geometry grows from the slice, which is what create-style animations expect.

fn get_partial_closed(&self, range: Range<f64>) -> Self

Take a closed partial slice of the wrapped item, keeping the pose.

Like get_partial, but the inner slice is closed so partially shown curves have caps at both ends; the wrapper’s transform is preserved.

impl<T: PartialEq, G: PartialEq> PartialEq for Transformed<T, G>

fn eq(&self, other: &Transformed<T, G>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<T: StrokeColor, G> StrokeColor for Transformed<T, G>

fn stroke_color(&self) -> AlphaColor<Srgb>

Getting stroke color of an item

fn set_stroke_color(&mut self, color: AlphaColor<Srgb>) -> &mut Self

Setting stroke color(rgba) of an item

fn set_stroke_opacity(&mut self, opacity: f32) -> &mut Self

Setting stroke opacity of an item

impl<T: StrokeWidth, G> StrokeWidth for Transformed<T, G>

fn stroke_width(&self) -> f32

Get the stroke width

fn apply_stroke_func( &mut self, f: impl for<'a> Fn(&'a mut [Width]), ) -> &mut Self

Applying stroke width function to an item

fn set_stroke_width(&mut self, width: f32) -> &mut Self

Setting stroke width of an item

impl<T: PartialEq, G: PartialEq> StructuralPartialEq for Transformed<T, G>