34 releases (17 breaking)

0.18.0 Feb 23, 2024
0.17.1 Oct 8, 2022
0.17.0 Sep 25, 2022
0.16.0 Feb 12, 2022
0.3.2 Mar 24, 2019

#12 in Rendering

Download history 19/week @ 2023-12-04 22/week @ 2023-12-11 36/week @ 2023-12-18 25/week @ 2023-12-25 13/week @ 2024-01-01 43/week @ 2024-01-08 15/week @ 2024-01-15 13/week @ 2024-01-22 13/week @ 2024-01-29 39/week @ 2024-02-05 34/week @ 2024-02-12 242/week @ 2024-02-19 178/week @ 2024-02-26 110/week @ 2024-03-04 110/week @ 2024-03-11 95/week @ 2024-03-18

512 downloads per month
Used in 2 crates

MIT/Apache

2MB
39K SLoC

Rust 23K SLoC // 0.0% comments C++ 14K SLoC // 0.1% comments Python 1K SLoC // 0.2% comments C 369 SLoC // 0.3% comments Visual Studio Project 278 SLoC PowerShell 98 SLoC // 0.2% comments AsciiDoc 95 SLoC // 0.0% comments Bazel 33 SLoC Perl 4 SLoC

OpenXRS

Documentation Crates.io License: MIT License: Apache 2.0

Rust bindings for the OpenXR virtual/augmented reality runtime API. Refer to the specification for detailed documentation on individual API calls.

openxr

The high-level bindings provide abstractions focusing on ergonomics and safety. Escape hatches to the raw API are exposed to support unforeseen requirements, and patterns that cannot be efficiently exposed in safe terms are preserved as unsafe.

The crate exposes a number of cargo features:

  • static builds in the Khronos OpenXR loader, which can then be accessed with Entry::linked(). This is the easiest way to get going, provided your environment has a working C++ compiler and CMake installation.
  • loaded allows access to a manually identified OpenXR implementation at run time. This allows for cases where a built-in Khronos loader, normally responsible for that task, cannot be used.
  • linked attempts to link to an OpenXR loader in the build environment. This is appropriate for target environments like desktop Linux which guarantee the presence of an OpenXR implementation or loader at a specific location, making a built-in loader redundant.
  • mint exposes From impls for converting to and from mint types where appropriate.

See openxr/examples/vulkan.rs for an example high-performance Vulkan rendering workflow.

openxr-sys

The low-level bindings provide faithful unsafe access to the raw API, with ergonomics and type safety improved as much as feasible compared to a bindgen-style binding without reducing expressiveness. For example, symbols are named according to Rust conventions, enums and bitmasks are strongly typed, and many types have helpful Debug impls. This crate is almost entirely generated from the Khronos XML registry.

Dependencies

~0–6MB