08 — Camera RGB and PNG

This case downloads the same scene-camera modality in two representations: packed raw RGB24 for fast data pipelines and lossless PNG for browsers and human inspection.

Verification level

Visible native Isaac scene-camera rendering at exactly 1280×720. The images must come from sensors.overview inside the simulated scene. Desktop, window, or viewport capture is not accepted.

Run it

Terminal A, with a working GPU and display:

bash

cd demo/server/08_camera_rgb_and_png
fastsim config validate run.yaml --json
fastsim-server run.yaml

Terminal B:

bash

cd demo/server/08_camera_rgb_and_png
python main.py --timeout 60

The camera component fixes width 1280, height 720, RGB modality, field of view, and clipping planes. main.py validates the raw byte count is exactly 1280 × 720 × 3, checks the PNG signature, and saves both files under output/. It does not resize, recolor, or screenshot the native application window.

Run ID, exact entity ID, generation, simulation tick/time, dtype, shape, and encoding travel in X-FastSim-* headers. main.py checks both formats belong to the opened Run and sensors.overview; callers should preserve this identity with recorded bytes. PNG encoding happens only when /png is requested; clients that prioritize throughput can request /rgb and avoid that encoding work.

Next: 09 — Particle fluid.