omniverse_rs

Rust interface for NVIDIA Omniverse.

Status

This project is in early development and is not ready for production use. Not all of the Omniverse Kit API is currently exposed.

Documentation and examples are currently lacking but will be the focus once the crates are more stable.

Overview

The workspace contains these packages:

• omniverse_sys: Unsafe Rust bindings for Omniverse
• omniverse: Safe Rust bindings for Omniverse (WIP)

Most of the bindings are automatically generated from the Omniverse headers using autocxx, while some are hand-written via rust-cpp. The Omniverse Kit can be automatically downloaded during the cargo build process if the vendored feature is enabled.

Dependencies

The complete list of dependencies can be found within Dockerfile.

Instructions

Rust

Add omniverse as a Rust dependency to your Cargo.toml manifest.

[dependencies]
omniverse = { git = "https://github.com/AndrejOrsula/omniverse_rs.git" }

Note that the first build might take up to 1 hour because OpenUSD and Omniverse Kit will be automatically downloaded with the vendored feature enabled (most of the time is spent compiling OpenUSD). The artifacts will be cached in OUT_DIR and reused for subsequent builds.

Alternatively, you can specify the paths to existing OpenUSD and Omniverse Kit installation directories via the following environment variables.

export OPENUSD_PATH=/path/to/pxr/openusd
export CARB_APP_PATH=/path/to/omniverse/kit

It is highly recommended to use lld or mold linker because ld might currently fail.

.docker/build.bash ${TAG:-latest} ${BUILD_ARGS}

.docker/run.bash ${TAG:-latest} ${CMD}

.docker/dev.bash ${TAG:-latest} ${CMD}

.devcontainer/open.bash

.docker/join.bash ${CMD:-bash}

Disclaimer

This project is not affiliated with NVIDIA Corporation.

License

This project is dual-licensed to be compatible with the Rust project, under either the MIT or Apache 2.0 licenses.

Contributing

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.