Inno.Rendering
Section titled “Inno.Rendering”
- Neutral devices, resources, commands and transactional render graphs.
Neutral devices, resources, commands and transactional render graphs.
Start with rendering tasks and frame ownership.
Mechanism boundary
Section titled “Mechanism boundary”This assembly provides devices, capabilities, resource descriptions, commands, binding reflection and RenderGraph mechanisms. It depends only on required Foundation contracts, not Assets, References, Scene, Editor, adapters or Native. It does not define Camera, Light, PBR, a 2D/3D world model or a shader-source parser.
An adapter creates the device; the host retains its unique owner. Graph resources, passes and handles belong to that graph and generation. Accepted pass declarations are frozen. Persistent assets do not store GPU handles; the resource owner controls retirement.
Output and device facts
Section titled “Output and device facts”IRenderDevice.primaryPresentationSize reports real physical pixels or null when no primary output is available. Publish a change with SetPrimaryPresentationSize at the frame safe point; zero is not a valid presentation size. A native SDK’s minimum allocation size does not imply a visible output. Offscreen targets retain their own valid dimensions.
primaryPresentationEncodesSrgb reports actual output encoding; the host injects output-transfer and layer-composition programs. Allocation counters are cumulative for a device generation; an unmeasured implementation returns null rather than fabricated zero evidence.
Validation and graph mutation
Section titled “Validation and graph mutation”Validate checks relationships, capabilities, initialization, dependencies, cycles and view limits without allocating the final graph. Compile reuses analysis for the current revision, allocates resources and produces the executable graph. Mutation invalidates stale analysis; normal runtime frames compile the final graph once.
BeginMutationScope creates a LIFO transaction. Commit validates and freezes new declarations. Failure rolls back resources, passes, outputs, name scopes and the previous accepted analysis. Issued resource identities are not reused after rollback, so an old handle cannot point to a different resource.
Frame-local analysis retains accepted resource initialization and dependency/phase relationships. A new contribution analyzes new declarations, but complete candidate checks still include output validity, live passes, topology, cycles and view limits. A future phase may add a dependency to an earlier pass. Editing an unfrozen analyzed pass or rolling back resets analysis as needed. Scratch never becomes a static extension cache.
Parallel recording contract
Section titled “Parallel recording contract”AllowParallelRecording only parallelizes callbacks that explicitly permit it. Commands replay in compiled pass order on the device’s proper owner. Uniform and transform borrowed data is copied immediately during recording; handles/samplers are values, while raster/stencil states retain their current object semantics.
Execute owns the temporary recording buffers and retained references. Completion, recording failure, replay failure and backend exit errors all release them. With no parallel pass, use direct serial callbacks without an empty recording directory. This feature does not change device-thread ownership, generations or GPU retirement.
Host usage
Section titled “Host usage”Supply live, explicitly owned dependencies as described above. These examples compile against the host contract; they do not initialize a complete product or verify a device.
using Inno.Rendering;
static RenderGraphValidationResult ValidateGraph(RenderGraphBuilder graph){ return graph.Validate();}Source boundary
Section titled “Source boundary”The source project defines the host declarations. Source API extraction does not establish script visibility, native behavior or completed generation retirement.
API reference
Section titled “API reference”Logical script references
Section titled “Logical script references”The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.
Source project facts
Section titled “Source project facts”Project: Inno.Rendering
Source: src/services/rendering/Inno.Rendering/Inno.Rendering.csproj
| Type | API | Description |
|---|---|---|
| CompiledRenderAttachment | engine | Describes one compiled raster attachment. |
| CompiledRenderBuffer | engine | Describes one buffer allocation selected by render-graph compilation. |
| CompiledRenderGraph | engine | Contains validated, culled and topologically scheduled frame work. |
| CompiledRenderPass | engine | Provides immutable backend-facing metadata for one scheduled pass. |
| CompiledRenderTexture | engine | Describes one texture allocation selected by render-graph compilation. |
| ComputePassBuilder | engine | Declares compute resource reads and unordered writes. |
| ComputePipelineDescriptor | engine | Describes a compute program candidate and reflected interface contract. |
| ComputePipelineHandle | engine | Identifies a backend-neutral compute pipeline object. |
| CopyPassBuilder | engine | Declares explicit resource copy access. |
| GraphicsApi | engine | Identifies the graphics API family selected by the host without exposing a backend-native enum. Pipelines use this value only for capability-aware choices and target artifact selection; it does not require separate pipeline or shader source implementations. |
| GraphicsCapabilities | engine | Provides an immutable capability snapshot for one device generation. |
| GraphicsCapability | engine | Declares backend-neutral optional graphics functionality. |
| GraphicsLimits | engine | Captures device limits used to validate and compile render graphs. |
| GraphicsPipelineDescriptor | engine | Describes a graphics program candidate and reflected interface contract. |
| GraphicsPipelineHandle | engine | Identifies a backend-neutral graphics pipeline object. |
| GraphicsProgramArtifactCodec | engine | Transports compiled graphics programs and device binding facts independently of authored assets. |
| IRenderDevice | engine | Owns one graphics backend generation and its frame submission boundary. |
| IRenderFrameGraphContributor | engine | Adds transient frame-final work, such as UI composition, without owning or advancing the graphics frame. |
| IRenderFrameUploadService | engine | Streams immutable CPU data into reusable GPU pages for the current frame. |
| IRenderGraphBackend | engine | Bridges compiled graph execution to a concrete graphics backend. |
| IRenderLayerCompositionProgramProvider | engine | Supplies a backend-specific graphics program for compositing ordered render layers. |
| PersistentBufferDescriptor | engine | Describes a persistent buffer and any vertex/index interpretation required at creation. |
| PersistentBufferHandle | engine | Identifies a persistent device buffer without exposing a backend-native handle. |
| PersistentTextureHandle | engine | Identifies a persistent device texture without exposing a backend-native handle. |
| RasterPassBuilder | engine | Declares raster attachments and resource access. |
| RenderBindingId | engine | Identifies a shader binding by stable manifest name. |
| RenderBlendEquation | engine | Selects the arithmetic operation combining source and destination blend terms. |
| RenderBlendFactor | engine | Selects one source or destination blend multiplier. |
| RenderBlendState | engine | Describes independent color and alpha blending without backend-native flags. |
| RenderBufferDescriptor | engine | Describes a render-graph buffer independently from a graphics backend. |
| RenderBufferHandle | engine | Identifies a frame-scoped render-graph buffer. |
| RenderBufferSlice | engine | Identifies one range in a frame upload page without exposing its persistent backing buffer. |
| RenderBufferUploadDescriptor | engine | Describes one CPU-to-GPU buffer upload that remains valid for the current frame only. |
| RenderBufferUsage | engine | Declares intended buffer operations for capability and hazard validation. |
| RenderClearColor | engine | Stores a linear clear color without depending on an engine math assembly. |
| RenderCommandEncoder | engine | Provides backend-neutral draw, dispatch and copy commands for one compiled pass. |
| RenderCullMode | engine | Selects triangle culling for a backend-neutral raster pipeline. |
| RenderDataChannelId | engine | Identifies one pipeline-owned frame-data channel without constraining its payload model. |
| RenderDepthCompare | engine | Selects depth comparison for a backend-neutral raster pipeline. |
| RenderDevice | engine | Provides the protected opaque-handle boundary required by replaceable render-device backends. |
| RenderDevice.DeviceHandleIdentity | engine | Stores one decoded persistent device identity for use inside a concrete backend. |
| RenderDevice.GraphHandleIdentity | engine | Stores one decoded frame-scoped graph identity for use inside a concrete backend. |
| RenderDeviceAllocationCounters | engine | Reports cumulative successful native allocations made by a device’s transient graph resource pools. Pool reuse does not increment these counters; retirement does not decrement them. They are not live resource counts, managed allocation counts, byte measurements or per-frame command counts. |
| RenderDeviceFrameCounters | engine | Contains backend-recorded GPU command submissions for the current frame. |
| RenderFrameUploadProvider | engine | Provides protected slice construction for replaceable frame-upload service implementations. |
| RenderFrontFace | engine | Selects the winding order interpreted as the front face. |
| RenderGraphBuilder | engine | Builds one generation-scoped render graph from explicit passes and resources. |
| RenderGraphCompileResult | engine | Contains render-graph compilation diagnostics and an optional executable graph. |
| RenderGraphDiagnostic | engine | Reports one structured render-graph compilation problem. |
| RenderGraphMutationScope | engine | Owns isolated graph additions; earlier pass declarations are frozen and failure removes every addition. |
| RenderGraphNameScope | engine | Owns one nested diagnostic-name prefix in a render graph builder. |
| RenderGraphValidationResult | engine | Describes graph validity and scheduling counts without creating resources or executable callbacks. |
| RenderIndexFormat | engine | Selects the integer representation of an index buffer. |
| RenderLoadAction | engine | Controls how existing attachment contents enter a raster pass. |
| RenderPassBuilder | engine | Provides ordering and common resource declarations for one pass. |
| RenderPassContext | engine | Supplies the command encoder and immutable frame identity to a pass callback. |
| RenderPassExecute<TPassData> | engine | Executes one frame-scoped pass payload. |
| RenderPassKind | engine | Distinguishes pass command domains for validation and backend execution. |
| RenderPassRecordingMode | engine | Controls where a frame-local pass callback records backend-neutral commands. |
| RenderPhaseId | engine | Identifies an open render phase protocol value. |
| RenderPresentationSize | engine | Stores one backend-neutral presentation extent in physical pixels. |
| RenderPrimitiveTopology | engine | Selects the primitive assembly used by raster draw commands. |
| RenderRasterState | engine | Stores backend-neutral fixed-function raster state. |
| RenderResourceId | engine | Identifies a pipeline-defined semantic resource without imposing a central resource catalog. |
| RenderSamplerAddressMode | engine | Selects texture addressing independently for each coordinate axis. |
| RenderSamplerFilter | engine | Selects texture filtering independently from a graphics backend. |
| RenderSamplerState | engine | Describes one native-serializable backend-neutral sampler binding. |
| RenderShaderBindingDescriptor | engine | Declares one manifest-derived shader binding used for reflection validation. |
| RenderShaderBindingKind | engine | Identifies a shader interface binding domain. |
| RenderStencilCompare | engine | Selects the comparison applied to stencil reference and stored values. |
| RenderStencilFaceState | engine | Describes stencil behavior for one triangle face orientation. |
| RenderStencilOperation | engine | Selects the update applied to a stencil value. |
| RenderStencilState | engine | Describes complete two-sided stencil state for one draw. |
| RenderStorageAccess | engine | Selects unordered storage-resource access for one shader binding. |
| RenderStoreAction | engine | Controls whether attachment contents remain valid after a raster pass. |
| RenderSurfaceHandle | engine | Identifies a persistent presentation surface without exposing a backend framebuffer or swapchain handle. |
| RenderTarget | engine | Selects one render destination without exposing a swapchain or framebuffer handle. |
| RenderTargetKind | engine | Identifies whether a request renders to the main swapchain or an offscreen target. |
| RenderTexture | engine | Describes a persistent offscreen target without owning a backend-native handle. |
| RenderTextureContainer | engine | Identifies a portable encoded texture container accepted by a render device. |
| RenderTextureDescriptor | engine | Describes a render-graph texture independently from a graphics backend. |
| RenderTextureDimension | engine | Identifies the dimensional shape of a backend-neutral texture resource. |
| RenderTextureFormat | engine | Declares backend-neutral texture storage formats. |
| RenderTextureHandle | engine | Identifies a frame-scoped render-graph texture. |
| RenderTextureReadbackHandle | engine | Identifies one backend-neutral asynchronous texture readback operation. |
| RenderTextureReadbackResult | engine | Contains immutable bytes copied from one complete texture mip. |
| RenderTextureRegion | engine | Describes one texture subresource box for copy and blit commands. |
| RenderTextureUsage | engine | Declares intended texture operations for capability and hazard validation. |
| RenderUniformType | engine | Identifies the native-independent shape of one uniform binding. |
| RenderVertexAttribute | engine | Describes one vertex attribute in stream order. |
| RenderVertexFormat | engine | Identifies one packed vertex attribute representation. |
| RenderVertexLayout | engine | Defines one interleaved vertex stream independently from a graphics backend. |
| RenderVertexSemantic | engine | Identifies one backend-neutral vertex attribute semantic. |
| RenderViewTransform | engine | Stores backend-ready column-major transform matrices for one programmable view. |
| RenderViewport | engine | Defines a destination pixel rectangle without assuming producer or rendering semantics. |
| ShaderInterface | engine | Stores the manifest-derived binding contract verified after backend program creation. |
| ShaderInterfaceBinding | engine | Describes one reflected material binding expected by compiled programs. |
| ShaderProgramKind | engine | Selects the programmable stage combination of a pass. |
| ShaderPropertyBindingKind | engine | Defines how one shader property enters the backend-neutral resource interface. |
| ShaderPropertyId | engine | Identifies a material property using a stable serialized string. |
| ShaderPropertyType | engine | Identifies an artist-facing shader property type. |
| ShaderStage | engine | Identifies a programmable shader stage. |
| ComputePassBuilder | Runtime | Declares compute resource reads and unordered writes. |
| ComputePipelineDescriptor | Runtime | Describes a compute program candidate and reflected interface contract. |
| ComputePipelineHandle | Runtime | Identifies a backend-neutral compute pipeline object. |
| CopyPassBuilder | Runtime | Declares explicit resource copy access. |
| GraphicsApi | Runtime | Identifies the graphics API family selected by the host without exposing a backend-native enum. Pipelines use this value only for capability-aware choices and target artifact selection; it does not require separate pipeline or shader source implementations. |
| GraphicsCapabilities | Runtime | Provides an immutable capability snapshot for one device generation. |
| GraphicsCapability | Runtime | Declares backend-neutral optional graphics functionality. |
| GraphicsLimits | Runtime | Captures device limits used to validate and compile render graphs. |
| GraphicsPipelineDescriptor | Runtime | Describes a graphics program candidate and reflected interface contract. |
| GraphicsPipelineHandle | Runtime | Identifies a backend-neutral graphics pipeline object. |
| IRenderFrameUploadService | Runtime | Streams immutable CPU data into reusable GPU pages for the current frame. |
| PersistentBufferDescriptor | Runtime | Describes a persistent buffer and any vertex/index interpretation required at creation. |
| PersistentBufferHandle | Runtime | Identifies a persistent device buffer without exposing a backend-native handle. |
| PersistentTextureHandle | Runtime | Identifies a persistent device texture without exposing a backend-native handle. |
| RasterPassBuilder | Runtime | Declares raster attachments and resource access. |
| RenderBindingId | Runtime | Identifies a shader binding by stable manifest name. |
| RenderBlendEquation | Runtime | Selects the arithmetic operation combining source and destination blend terms. |
| RenderBlendFactor | Runtime | Selects one source or destination blend multiplier. |
| RenderBlendState | Runtime | Describes independent color and alpha blending without backend-native flags. |
| RenderBufferDescriptor | Runtime | Describes a render-graph buffer independently from a graphics backend. |
| RenderBufferHandle | Runtime | Identifies a frame-scoped render-graph buffer. |
| RenderBufferSlice | Runtime | Identifies one range in a frame upload page without exposing its persistent backing buffer. |
| RenderBufferUploadDescriptor | Runtime | Describes one CPU-to-GPU buffer upload that remains valid for the current frame only. |
| RenderBufferUsage | Runtime | Declares intended buffer operations for capability and hazard validation. |
| RenderClearColor | Runtime | Stores a linear clear color without depending on an engine math assembly. |
| RenderCommandEncoder | Runtime | Provides backend-neutral draw, dispatch and copy commands for one compiled pass. |
| RenderCullMode | Runtime | Selects triangle culling for a backend-neutral raster pipeline. |
| RenderDataChannelId | Runtime | Identifies one pipeline-owned frame-data channel without constraining its payload model. |
| RenderDepthCompare | Runtime | Selects depth comparison for a backend-neutral raster pipeline. |
| RenderDeviceAllocationCounters | Runtime | Reports cumulative successful native allocations made by a device’s transient graph resource pools. Pool reuse does not increment these counters; retirement does not decrement them. They are not live resource counts, managed allocation counts, byte measurements or per-frame command counts. |
| RenderFrontFace | Runtime | Selects the winding order interpreted as the front face. |
| RenderGraphBuilder | Runtime | Builds one generation-scoped render graph from explicit passes and resources. |
| RenderGraphDiagnostic | Runtime | Reports one structured render-graph compilation problem. |
| RenderGraphMutationScope | Runtime | Owns isolated graph additions; earlier pass declarations are frozen and failure removes every addition. |
| RenderGraphNameScope | Runtime | Owns one nested diagnostic-name prefix in a render graph builder. |
| RenderIndexFormat | Runtime | Selects the integer representation of an index buffer. |
| RenderLoadAction | Runtime | Controls how existing attachment contents enter a raster pass. |
| RenderPassBuilder | Runtime | Provides ordering and common resource declarations for one pass. |
| RenderPassContext | Runtime | Supplies the command encoder and immutable frame identity to a pass callback. |
| RenderPassExecute<TPassData> | Runtime | Executes one frame-scoped pass payload. |
| RenderPassKind | Runtime | Distinguishes pass command domains for validation and backend execution. |
| RenderPassRecordingMode | Runtime | Controls where a frame-local pass callback records backend-neutral commands. |
| RenderPhaseId | Runtime | Identifies an open render phase protocol value. |
| RenderPresentationSize | Runtime | Stores one backend-neutral presentation extent in physical pixels. |
| RenderPrimitiveTopology | Runtime | Selects the primitive assembly used by raster draw commands. |
| RenderRasterState | Runtime | Stores backend-neutral fixed-function raster state. |
| RenderResourceId | Runtime | Identifies a pipeline-defined semantic resource without imposing a central resource catalog. |
| RenderSamplerAddressMode | Runtime | Selects texture addressing independently for each coordinate axis. |
| RenderSamplerFilter | Runtime | Selects texture filtering independently from a graphics backend. |
| RenderSamplerState | Runtime | Describes one native-serializable backend-neutral sampler binding. |
| RenderShaderBindingDescriptor | Runtime | Declares one manifest-derived shader binding used for reflection validation. |
| RenderShaderBindingKind | Runtime | Identifies a shader interface binding domain. |
| RenderStencilCompare | Runtime | Selects the comparison applied to stencil reference and stored values. |
| RenderStencilFaceState | Runtime | Describes stencil behavior for one triangle face orientation. |
| RenderStencilOperation | Runtime | Selects the update applied to a stencil value. |
| RenderStencilState | Runtime | Describes complete two-sided stencil state for one draw. |
| RenderStorageAccess | Runtime | Selects unordered storage-resource access for one shader binding. |
| RenderStoreAction | Runtime | Controls whether attachment contents remain valid after a raster pass. |
| RenderSurfaceHandle | Runtime | Identifies a persistent presentation surface without exposing a backend framebuffer or swapchain handle. |
| RenderTarget | Runtime | Selects one render destination without exposing a swapchain or framebuffer handle. |
| RenderTargetKind | Runtime | Identifies whether a request renders to the main swapchain or an offscreen target. |
| RenderTexture | Runtime | Describes a persistent offscreen target without owning a backend-native handle. |
| RenderTextureContainer | Runtime | Identifies a portable encoded texture container accepted by a render device. |
| RenderTextureDescriptor | Runtime | Describes a render-graph texture independently from a graphics backend. |
| RenderTextureDimension | Runtime | Identifies the dimensional shape of a backend-neutral texture resource. |
| RenderTextureFormat | Runtime | Declares backend-neutral texture storage formats. |
| RenderTextureHandle | Runtime | Identifies a frame-scoped render-graph texture. |
| RenderTextureReadbackHandle | Runtime | Identifies one backend-neutral asynchronous texture readback operation. |
| RenderTextureReadbackResult | Runtime | Contains immutable bytes copied from one complete texture mip. |
| RenderTextureRegion | Runtime | Describes one texture subresource box for copy and blit commands. |
| RenderTextureUsage | Runtime | Declares intended texture operations for capability and hazard validation. |
| RenderUniformType | Runtime | Identifies the native-independent shape of one uniform binding. |
| RenderVertexAttribute | Runtime | Describes one vertex attribute in stream order. |
| RenderVertexFormat | Runtime | Identifies one packed vertex attribute representation. |
| RenderVertexLayout | Runtime | Defines one interleaved vertex stream independently from a graphics backend. |
| RenderVertexSemantic | Runtime | Identifies one backend-neutral vertex attribute semantic. |
| RenderViewTransform | Runtime | Stores backend-ready column-major transform matrices for one programmable view. |
| RenderViewport | Runtime | Defines a destination pixel rectangle without assuming producer or rendering semantics. |
| ShaderInterface | Runtime | Stores the manifest-derived binding contract verified after backend program creation. |
| ShaderInterfaceBinding | Runtime | Describes one reflected material binding expected by compiled programs. |
| ShaderProgramKind | Runtime | Selects the programmable stage combination of a pass. |
| ShaderPropertyBindingKind | Runtime | Defines how one shader property enters the backend-neutral resource interface. |
| ShaderPropertyId | Runtime | Identifies a material property using a stable serialized string. |
| ShaderPropertyType | Runtime | Identifies an artist-facing shader property type. |
| ShaderStage | Runtime | Identifies a programmable shader stage. |