Rust interface for OpenUSD.
This project is in early development and is not ready for production use. Not all of the OpenUSD API is currently exposed.
Documentation and examples are currently lacking but will be the focus once the crates are more stable.
Currently, OpenUSD 22.11 compiled via build options specified via the default features of pxr_sys is the primary target upon which the project is being developed.
The workspace contains these packages:
- pxr_build: Helper crate for building OpenUSD bindings
- pxr_sys: Unsafe Rust bindings for OpenUSD
- pxr: Safe Rust bindings for OpenUSD (WIP)
Most of the bindings are automatically generated from the OpenUSD headers using autocxx, while some are hand-written via rust-cpp and additional macros inside pxr_build. The C++ library of OpenUSD can be automatically downloaded and compiled during the cargo build process if the vendored feature is enabled.
The complete list of dependencies can be found within Dockerfile.
Enabling of additional non-default features might require additional dependencies. This is currently not tested/documented.
Add pxr as a Rust dependency to your Cargo.toml manifest.
[dependencies]
pxr = { version = "0.2" }Note that the first build might take up to 50 minutes because OpenUSD will be automatically downloaded and compiled with the vendored feature enabled. The artifacts will be cached in OUT_DIR and reused for subsequent builds.
Alternatively, you can specify the path to an existing OpenUSD installation directory via the following environment variable.
export OPENUSD_PATH=/path/to/pxr/openusdIt is highly recommended to use lld or mold linker because ld might currently fail.
To install Docker on your system, you can run
.docker/host/install_docker.bashto configure Docker with NVIDIA GPU support..docker/host/install_docker.bash
To build a new Docker image from Dockerfile, you can run .docker/build.bash as shown below.
.docker/build.bash ${TAG:-latest} ${BUILD_ARGS}To run the Docker container, you can use .docker/run.bash as shown below.
.docker/run.bash ${TAG:-latest} ${CMD}To run the Docker container in a development mode (source code mounted as a volume), you can use .docker/dev.bash as shown below.
.docker/dev.bash ${TAG:-latest} ${CMD}As an alternative, VS Code users familiar with Dev Containers can modify the included .devcontainer/devcontainer.json to their needs. For convenience, .devcontainer/open.bash script is available to open this repository as a Dev Container in VS Code.
.devcontainer/open.bashTo join a running Docker container from another terminal, you can use .docker/join.bash as shown below.
.docker/join.bash ${CMD:-bash}This project is not affiliated with the Alliance for OpenUSD (AOUSD).
This project is dual-licensed to be compatible with the Rust project, under either the MIT or Apache 2.0 licenses.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.