Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Neutral devices, resources, commands and transactional render graphs.

Neutral devices, resources, commands and transactional render graphs.

Start with rendering tasks and frame ownership.

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.

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.

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.

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.

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();
}

The source project defines the host declarations. Source API extraction does not establish script visibility, native behavior or completed generation retirement.

Browse types and members.

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.

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.