Skip to content

usdv26.8

Updated

Universal Scene Description (USD) is an efficient, scalable system for authoring, reading, and streaming time-sampled scene description for interchange between graphics applications.

#Usage

usd provides CMake targets:

find_package(pxr CONFIG REQUIRED)
target_link_libraries(main PRIVATE usd sdf usdGeom)

# pxr exports many library targets (usd, sdf, tf, gf, usdGeom, usdShade,
# usdLux, ...) without a namespace prefix. Link only the libraries your
# application needs.

USD discovers plugins at runtime via plugInfo.json registries. When deploying
an application, copy the USD libraries and plugin directories from the vcpkg
installed tree. The paths below are the release paths; the debug artifacts are
installed under debug/ (debug/bin/*.dll, debug/lib/usd/, debug/plugin/usd/,
...):

Windows:

bin/*.dll         (USD libraries you linked against, and their dependencies)
bin/usd/          (top-level plugInfo.json and core library resource registries)
plugin/usd/       (MODULE plugin DLLs)

  Unix:
lib/*.so*         (USD libraries you linked against, and their dependencies;
                   .dylib on macOS)
lib/usd/          (top-level plugInfo.json and core library resource registries)
plugin/usd/       (MODULE plugin shared objects)

Keep the relative layout of these directories intact: Plug anchors its default
search paths to the directory holding the loaded USD libraries and looks for
"<that directory>/usd/" and "<that directory>/../plugin/usd/". Set the
PXR_PLUGINPATH_NAME environment variable if your application uses a different
layout.

On Windows, the top-level plugInfo.json must be deployed under bin/usd/ next to
the USD libraries so Plug can discover core library plugins.

Optional port features install additional MODULE plugins under plugin/usd/.
For example, imaging adds Hydra and imaging plugins, and usd[imaging,openimageio]
adds the hioOiio image I/O plugin. The hioOiio plugin is only built when imaging
is enabled, so openimageio alone does not install it.

#License

Not declared in the port manifest

#Supported Platforms

!x86 & !(arm & windows) & !android

  • ✅linux
  • ✅osx
  • ✅uwp
  • ✅windows-x64
  • ❌windows-arm64
  • ❌windows-x86

#Features

No default features.

#imaging

Enable the imaging components

Dependencies:
and 2 transitive dependencies:
Host Dependencies:
2 transitive dependencies:

#materialx

Enable MaterialX support

Dependencies:

No transitive dependencies.

Host Dependencies:
2 transitive dependencies:

#openimageio

Build OpenImageIO plugin

Dependencies:
and 17 transitive dependencies:
Host Dependencies:
3 transitive dependencies:

#vulkan

Enable Vulkan based components

Platforms: !ios
  • ✅linux
  • ✅osx
  • ✅uwp
  • ✅windows-x64
    Dependencies:
    and 7 transitive dependencies:
    Host Dependencies:
    2 transitive dependencies:

    #Dependencies

    and one transitive dependency:

    #Host Dependencies

    No transitive dependencies.

    #Used By

    No ports use this.

    #Host Tool For

    No ports use this.

    #Contributors

    • Curtis J Bezault's avatarCurtis J Bezault
    • Stefano Sinigardi's avatarStefano Sinigardi
    • Phoebe's avatarPhoebe
    • Robert Schumacher's avatarRobert Schumacher
    • NancyLi1013's avatarNancyLi1013
    • ousttrue's avatarousttrue
    • Billy O'Neal's avatarBilly O'Neal
    • autoantwort's avatarautoantwort
    • Michael's avatarMichael
    • Ilya Lavrenov's avatarIlya Lavrenov
    • Michael MIGLIORE's avatarMichael MIGLIORE
    • Andréa Machizaud's avatarAndréa Machizaud
    • Alexander Neumann's avatarAlexander Neumann
    • jim wang's avatarjim wang
    • miyanyan's avatarmiyanyan
    • Aleksi Sapon's avatarAleksi Sapon
    • Weihang Ding's avatarWeihang Ding
    • JacksonSun-adsk's avatarJacksonSun-adsk
    • JacksonSun-adsk's avatarJacksonSun-adsk

    #Changelog

    Show 22 earlier changes