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
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

//! UsdLux schema reader.
//!
//! Decodes Pixar's `UsdLux` schema family from a composed
//! [`crate::Stage`]. Covers the canonical light prims plus the
//! `LightAPI` / `MeshLightAPI` / `VolumeLightAPI` / `ShapingAPI` /
//! `ShadowAPI` / `LightListAPI` applied schemas:
//!
//! Concrete light prims:
//! - [`tokens::T_DISTANT_LIGHT`] — sun-style parallel light.
//! - [`tokens::T_SPHERE_LIGHT`] — point / spherical area light.
//! - [`tokens::T_RECT_LIGHT`] — rectangular area light.
//! - [`tokens::T_DISK_LIGHT`] — circular area light.
//! - [`tokens::T_CYLINDER_LIGHT`] — tube / strip light.
//! - [`tokens::T_DOME_LIGHT`] / [`tokens::T_DOME_LIGHT_1`] —
//!   image-based environment light.
//! - [`tokens::T_GEOMETRY_LIGHT`] — uses an arbitrary mesh as the
//!   emissive surface.
//! - [`tokens::T_PORTAL_LIGHT`] — aperture for sampling a parent
//!   DomeLight more efficiently.
//!
//! Applied APIs:
//! - [`tokens::API_LIGHT`] — implicit on every concrete light prim.
//!   Surfaces intensity / exposure / colour / temperature, etc.
//! - [`tokens::API_MESH_LIGHT`] / [`tokens::API_VOLUME_LIGHT`] —
//!   make arbitrary meshes or volumes emissive via the same common
//!   LightAPI inputs.
//! - [`tokens::API_SHAPING`] — focus + cone + IES profile.
//! - [`tokens::API_SHADOW`] — shadow casting controls.
//! - [`tokens::API_LIGHT_LIST`] — cached light-list on a parent prim.
//!
//! # Defaults
//!
//! Each `Read*` struct's `Default` impl matches Pixar's `schema.usda`
//! defaults exactly. Unauthored attributes fall back to those values
//! without the consumer needing `Option<f32>` plumbing — callers can
//! always `unwrap_or_default()` if they want a spec-correct fallback.
//!
//! `DistantLight` overrides `LightAPI.inputs:intensity = 1` with
//! `50000` (per Pixar's schema), modelling the sun reaching Earth at
//! ~50000 lux.

pub mod tokens;

mod author;
mod read;
mod types;

pub use author::{
    apply_light_api, apply_light_list, apply_shadow, apply_shaping, define_cylinder_light, define_disk_light,
    define_distant_light, define_dome_light, define_dome_light_1, define_geometry_light, define_portal_light,
    define_rect_light, define_sphere_light, CylinderLightAuthor, DiskLightAuthor, DistantLightAuthor, DomeLight1Author,
    DomeLightAuthor, GeometryLightAuthor, LightApiSetters, LightAuthor, LightListAuthor, PortalLightAuthor,
    RectLightAuthor, ShadowAuthor, ShapingAuthor, SphereLightAuthor,
};

pub use read::{
    find_lux_prims, is_light_type, read_cylinder_light, read_cylinder_light_at, read_disk_light, read_disk_light_at,
    read_distant_light, read_distant_light_at, read_dome_light, read_dome_light_at, read_geometry_light,
    read_geometry_light_at, read_light, read_light_api, read_light_api_at, read_light_at, read_light_list,
    read_portal_light, read_portal_light_at, read_rect_light, read_rect_light_at, read_shadow, read_shadow_at,
    read_shaping, read_shaping_at, read_sphere_light, read_sphere_light_at,
};
pub use types::{
    LightListCacheBehavior, LuxPrims, PoleAxis, ReadAnyLight, ReadCylinderLight, ReadDiskLight, ReadDistantLight,
    ReadDomeLight, ReadGeometryLight, ReadLight, ReadLightList, ReadPortalLight, ReadRectLight, ReadShadow,
    ReadShaping, ReadSphereLight, TextureFormat,
};