C: Minimal Example#

This example shows basic initialization of the renderer, rendering a single frame from an RGB camera, mapping the output, and writing the result to disk as a PNG.

The example loads a remote S3 scene asset and writes the resulting image to out.png. Runtime validation requires internet access to download that scene asset.

The first step from a newly built application will block for 1-2 minutes while shaders are compiled and cached.

“Create the smallest useful C/C++ example that initializes ovrtx, loads a USD scene asynchronously, waits for it, renders one camera frame, fetches and CPU-maps the color output, writes it to an image file, and releases all ovrtx resources explicitly.”

Minimal example output

Build and Run#

Prerequisites

sudo apt-get install build-essential cmake

Runtime requires an NVIDIA RTX-capable GPU, a supported NVIDIA driver, internet access to download the remote S3 scene asset, and unsandboxed execution.

The ovrtx library is downloaded automatically at configure time. If ovrtx is already installed and available through CMAKE_PREFIX_PATH, the local installation is used instead.

Building

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build

Running

./build/minimal

Prerequisites

  • Visual Studio 2017+

  • NVIDIA RTX-capable GPU

  • Supported NVIDIA driver

  • Internet access to download the remote S3 scene asset

  • Unsandboxed runtime execution

The ovrtx library is downloaded automatically at configure time. If ovrtx is already installed and available through CMAKE_PREFIX_PATH, the local installation is used instead.

Building

cmake -B build
cmake --build build --config Release

Running

.\build\Release\minimal.exe

Licensing#

This example contains stb_image_write.h, © Sean Barrett, released under Public Domain.

On this page