NodeProps Reference

NodeProps is the complete configuration surface for node behavior.

All dynamic behavior flows through this structure.

Ownership Model

Owned by the caller
Read-only during execution
Not mutated by the runtime

This ensures predictable frame execution.

Responsibilities

NodeProps supplies:

Shader sources
Parameter values
Mixer weights
Video decode configuration
External texture bindings
Output naming

Runtime Interaction

During execution:

Runtime reads relevant entries by NodeId
Binds shader programs
Sets uniforms
Executes draw calls

No hidden state persists inside nodes.

Update Semantics

Changes to NodeProps:

Take effect on the next frame
Do not invalidate compiled topology
May trigger shader recompilation if source changes

Failure Modes

Incorrect configuration may result in:

Shader compile errors
Missing input bindings
Undefined uniform values

Errors are surfaced to the caller.