Python: Status Queries Example#

This example is based on the minimal Python example and adds operation status queries for USD loading and rendering.

It demonstrates:

  1. Loading a USD layer from a remote S3 scene URL with open_usd_async()

  2. Polling Operation.query_status() while waiting

  3. Running one shader-cache warm-up step with shader compilation progress

  4. Stepping the renderer with step_async()

  5. Fetching and mapping the rendered output

This compatibility example intentionally retains deprecated renderer population operations because ovstage population does not expose equivalent progress counters. New applications should otherwise use the attached ovstage workflow.

Renderer logs are written to _output/status-queries-ovrtx.log.

“Create a Python rendering example that demonstrates progress reporting for long-running ovrtx operations, including asynchronous scene loading, status polling while waiting, shader warmup feedback, final frame rendering, and save-or-display output.”

Status queries example output

Prerequisites#

  • Python 3.10-3.13

  • uv

  • NVIDIA RTX-capable GPU

  • Supported NVIDIA driver

  • Internet access to download the remote S3 scene asset

  • Unsandboxed runtime execution

Running#

uv run main.py

To save the render instead of displaying it:

uv run main.py --png
On this page