openusd 0.8.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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

//! The core family's generated views over the public API.
//!
//! [`usd::CollectionAPI`] and [`usd::ClipsAPI`] carry hand-written behaviour
//! and are tested with it. The colour-space views carry none, so these check
//! that what the generator gave them — application, instance naming, the
//! declared properties — works on a stage.

use openusd::usd::{self, ColorSpaceAPI, ColorSpaceDefinitionAPI};
use openusd::{sdf, tf};

fn stage() -> usd::Stage {
    usd::Stage::builder()
        .in_memory("anon.usda")
        .expect("an in-memory stage")
}

/// A single-apply schema applies, is found again, and authors its property
/// under the name the schema declares.
#[test]
fn color_space_applies() {
    let stage = stage();
    let prim = stage.define_prim("/World").expect("a prim");
    assert!(ColorSpaceAPI::get(&stage, "/World").expect("a read").is_none());

    let api = ColorSpaceAPI::apply(&prim).expect("applies");
    api.create_color_space_name_attr()
        .expect("authors")
        .set(sdf::Value::token("lin_rec709_scene"))
        .expect("sets");

    let found = ColorSpaceAPI::get(&stage, "/World").expect("a read").expect("applied");
    assert_eq!(
        found.color_space_name_attr().path().to_string(),
        "/World.colorSpace:name"
    );
    assert_eq!(
        found.color_space_name().expect("a read"),
        Some(tf::Token::from("lin_rec709_scene"))
    );
}

/// A multiple-apply schema keeps each instance apart: its properties live
/// under the instance name, and enumeration finds exactly what was applied.
#[test]
fn color_space_definition_instances() {
    let stage = stage();
    let prim = stage.define_prim("/World").expect("a prim");

    let custom = ColorSpaceDefinitionAPI::apply(&prim, "custom").expect("applies");
    ColorSpaceDefinitionAPI::apply(&prim, "other").expect("applies");
    assert_eq!(custom.name().as_str(), "custom");

    custom.create_gamma_attr().expect("authors").set(2.2_f32).expect("sets");
    assert_eq!(
        custom.gamma_attr().path().to_string(),
        "/World.colorSpaceDefinition:custom:gamma"
    );

    let found = ColorSpaceDefinitionAPI::get_instance(&prim, "custom")
        .expect("a read")
        .expect("applied");
    assert_eq!(found.gamma().expect("a read"), Some(2.2));

    let mut names: Vec<String> = ColorSpaceDefinitionAPI::get_all(&prim)
        .expect("a read")
        .iter()
        .map(|instance| instance.name().to_string())
        .collect();
    names.sort();
    assert_eq!(names, ["custom", "other"]);
    assert!(
        ColorSpaceDefinitionAPI::get_instance(&prim, "absent")
            .expect("a read")
            .is_none()
    );
}