Eve library

V3 Stage UE5.5 render worker

Other

Revision 1

On this page

This is the minimal headless Unreal project used by the V10 Stage release adapter. It renders a persisted, release-bound /Game level and LevelSequence; it never authors a production scene, substitutes an engine sample, chooses a camera, encodes media, or publishes a catalog row.

The Python commandlet accepts one absolute request path through V3_STAGE_RENDER_REQUEST. Its strict v1 request binds candidate/version, concert, export content hash, published Sequencer asset, level, exact CineCameraActor label, frame range, raster size, and a private empty output directory. It emits only contiguous frame-NNNNNN.png files and a SHA-256-bound render-manifest.json. Missing or ambiguous assets, a mismatched display rate, a short playback range, noncanonical output, or an absent frame fails loud.

V3StageRenderWorkerLibrary is a deliberately tiny editor module. Before the first capture and before process exit it finishes asynchronous asset work, submits material shaders required by the loaded world, waits for shader compilation, and flushes rendering commands. The barrier prevents a commandlet from returning black placeholder frames or crashing while cancelling live shader jobs. Build products, fixture content, frames, and manifests are verification artifacts and must not be committed.

author_release_gate_fixture.py creates a two-second, 12 fps test-only scene from engine primitives in an isolated project copy. It proves the commandlet against real UE5.5 serialization and Sequencer evaluation; it is not V3 inventory and carries no publication authority.

From the repository root, sudo V3/ue/StageRenderWorker/Scripts/verify_release_gate.sh creates an isolated project copy, builds the editor module, authors that fixture, runs the complete server adapter through UE5.5 with the Mesa Lavapipe ICD, performs real FFmpeg/FFprobe encoding and verification, and removes the copy on every exit. UE_ROOT, the run-as user/group, and the Vulkan ICD may be overridden through the environment; the script fails before mutation when any dependency is missing.

The server-side V3StageUnrealRenderer in @oshun/v10-rail-channel-stage/release owns the process boundary. It validates the manifest and every PNG independently, rejects static/extra/changed output, copies exact authorized audio bytes into its private workspace, performs real FFmpeg encoding, requires FFprobe geometry/rate/frame-count/duration evidence, and returns bytes to the existing immutable cook path only after all checks agree.