Struct UsdaWriter 

pub struct UsdaWriter { /* private fields */ }

USDA text format writer.

Builds a .usda file incrementally. Call methods in the order dictated by the USD hierarchy you wish to produce, then call finish to obtain the final string.

Implementations

impl UsdaWriter

pub fn new() -> Self

Create a new, empty writer.

pub fn write_header(&mut self, up_axis: &str, meters_per_unit: f64)

Write the USDA file header with layer metadata.

up_axis should be "Y" or "Z".

pub fn begin_def(&mut self, kind: &str, name: &str)

Open a def <kind> "<name>" { ... } block.

pub fn end_def(&mut self)

Close the most recent def block.

pub fn write_mesh(&mut self, mesh: &UsdMesh) -> Result<()>

Write a complete Mesh prim.

pub fn write_material(&mut self, mat: &UsdMaterial) -> Result<()>

Write a Material prim with a UsdPreviewSurface shader.

pub fn write_skeleton(&mut self, skel: &UsdSkeleton) -> Result<()>

Write a Skeleton prim.

pub fn write_skin_binding( &mut self, mesh_path: &str, binding: &UsdSkinBinding, ) -> Result<()>

Write skin binding properties on an existing mesh prim.

This writes a SkelBindingAPI block that should appear inside or adjacent to the mesh prim identified by mesh_path.

pub fn write_blend_shapes( &mut self, mesh_path: &str, shapes: &[UsdBlendShape], ) -> Result<()>

Write blend shape prims under the given mesh path scope.

pub fn write_xform(&mut self, name: &str, matrix: &[f64; 16]) -> Result<()>

Write an Xform prim with a 4x4 transform matrix.

pub fn finish(self) -> String

Consume the writer and return the complete USDA string.

Any unclosed def blocks are closed automatically.

impl UsdaWriter

pub fn write_blend_shape_animation( &mut self, mesh_path: &str, samples: &[BlendShapeTimeSamples], ) -> Result<()>

Write a SkelAnimation prim with blendShapeWeights.timeSamples.

The prim is named "BodyAnim" and contains:

• uniform token purpose = "default"
• uniform token[] blendShapes — ordered by first appearance across all BlendShapeTimeSamples entries.
• float[] blendShapeWeights.timeSamples — every unique time code from all samples, sorted ascending; shapes absent at a given time emit 0.0.
• rel skelTargets = <{mesh_path}> — where mesh_path is the USD scene path passed as the second argument (e.g. "/Root/Body").

Errors

Returns an error if formatting the output buffer fails (highly unlikely in practice because String::write_fmt is infallible for in-memory buffers, but the method signature is anyhow::Result<()> for consistency with the rest of the writer API).

Trait Implementations

impl Default for UsdaWriter

fn default() -> Self

Returns the “default value” for a type.