openusd 0.4.0

Rust native USD library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Shared low-level authoring helpers used across the per-prim
//! modules under [`super`].
//!
//! These wrap [`crate::usd::Stage`]'s public authoring entry points
//! (`create_attribute` + `Attribute` fluent setters) with default
//! choices that match Pixar's per-attribute schema declarations
//! (variability, type name, custom flag). Keeping the wrapping local
//! to one file means each schema-specific module reads as pure spec
//! plumbing rather than repeated boilerplate.

use anyhow::Result;

use crate::sdf::{Path, Value, Variability};
use crate::usd::Stage;

pub(super) use crate::schemas::common::{author_uniform_token_vec as author_uniform_token_array, varying_attribute};

/// Author a `uniform matrix4d[]` attribute on `prim` with the given default.
/// Matrices are USD's row-major flattened `[f64; 16]` representation.
pub(super) fn author_uniform_matrix4d_array(
    stage: &Stage,
    prim: &Path,
    name: &str,
    matrices: Vec<[f64; 16]>,
) -> Result<()> {
    let attr_path = prim.append_property(name)?;
    stage
        .create_attribute(attr_path, "matrix4d[]")?
        .set_variability(Variability::Uniform)?
        .set_custom(false)?
        .set(Value::Matrix4dVec(matrices))?;
    Ok(())
}