Inno.Rendering.Assets
Section titled “Inno.Rendering.Assets”
- Persistent neutral shader, material, texture, geometry and pipeline assets.
Persistent neutral shader, material, texture, geometry and pipeline assets.
Start with rendering tasks and frame ownership.
Persistent data boundary
Section titled “Persistent data boundary”This assembly owns runtime asset protocols, open IDs, serialization and target artifacts for Shader, Material, Texture, Geometry and Pipeline data. It depends on neutral Rendering, Assets, References and required Foundation services, not runtime composition, shader graph tooling or AssetPipeline. It can participate in a static Player closure.
ShaderDefinition is an editable declaration. ShaderAsset.SetDefinition captures and validates the complete nested state before replacing it; failure preserves the old definition and getters return independent copies. Material defaults and texture Asset references belong here. Pure compiled binding-interface facts belong to Rendering Core.
Material technique selection uses open ShaderContractId, ShaderPassRoleId and actual device capabilities. The resolver has no built-in sprite/PBR or fixed-pass-tag worldview. Pipeline assets save an extension’s Stable Type ID and neutral settings rather than a live provider.
Content and resource ownership
Section titled “Content and resource ownership”RenderTargetArtifactPath returns a logical location. Read an artifact through ArtifactLease.OpenRead or the owning content store while retaining its lease/owner. Persistent models expose no physical cache path and save no device handles. GPU allocation, caching and retirement belong to Rendering.Runtime.
Authoring import, graph editing and target compilation live in the separate authoring assembly. Persisted types retain their Stable Type IDs; the logical runtime script namespace remains InnoEngine.Rendering. A public host member is still subject to the actual script export manifest.
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;using Inno.Rendering.Assets;
static MaterialPassResolution? SelectPass( MaterialAsset material, GraphicsCapabilities capabilities) { return MaterialPassResolver.Resolve(material, new ShaderContractId("sample.surface"), new ShaderPassRoleId("sample.draw"), capabilities);}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.Assets
Source: src/services/rendering/Inno.Rendering.Assets/Inno.Rendering.Assets.csproj
| Type | API | Description |
|---|---|---|
| GeometryArtifact | engine | Encodes and validates the stable backend-neutral geometry artifact shared by import and runtime stages. |
| GeometryAsset | engine | Represents imported geometry without prescribing scene or draw semantics. |
| GeometryAssetRuntime | engine | Decodes normalized CPU geometry committed by mesh importers. |
| GeometryData | engine | Contains normalized CPU mesh data ready for backend upload. |
| GeometrySection | engine | Identifies a contiguous triangle-index range. |
| GeometryVertex | engine | Stores one normalized vertex shared by all rendering backends. |
| IRenderTextureArtifactSource | engine | Exposes one or more portable image artifacts owned by an imported asset. |
| MaterialAsset | engine | Represents material state keyed by stable shader property identifiers. |
| MaterialMetadataEntry | engine | Stores one open material metadata key and value. |
| MaterialPassResolution | engine | Describes one capability-compatible material pass selection. |
| MaterialPassResolver | engine | Resolves materials through open provider-owned shader contracts and roles. |
| MaterialPropertyBlock | engine | Holds frame-local material overrides without modifying a shared asset. |
| MaterialPropertyEntry | engine | Stores one persistent material property entry. |
| MaterialValue | engine | Stores one native-serializable material value without a GPU binding. |
| MaterialValueKind | engine | Identifies the neutral value stored by a material property. |
| RenderFeatureConfiguration | engine | Stores one ordered feature extension selection using only stable data. |
| RenderPipelineAsset | engine | Selects a pipeline extension and ordered feature configuration without defining a render path. |
| RenderShaderArtifact | engine | Contains one immutable, source-free shader artifact ready for runtime GPU resource creation. |
| RenderShaderArtifactCodec | engine | Encodes and validates the strict source-free binary format shared by game builds and Players. |
| RenderShaderPassArtifact | engine | Carries one immutable compiled shader pass and its reflected runtime bindings. |
| RenderShaderStageArtifact | engine | Stores one immutable target shader stage without retaining authoring source or compiler state. |
| RenderShaderVariant | engine | Identifies one deterministic selection of static shader keyword options shared by authoring and runtime. |
| RenderTargetArtifactPath | engine | Defines deterministic relative paths shared by target-artifact producers and runtime consumers. |
| RenderTextureArtifactReference | engine | Identifies one immutable texture source across authoring, deployment, and runtime generations. |
| RenderTextureArtifactSlot | engine | Declares an immutable source artifact that is compiled into one sampled texture slot. |
| SerializedRenderExtensionState | engine | Stores reload-safe configuration for one pipeline or feature extension generation. |
| ShaderAsset | engine | Represents the runtime contract imported from a shader graph. |
| ShaderCompareFunction | engine | Selects the comparison used by depth testing. |
| ShaderContractId | engine | Identifies an open shader and pipeline compatibility contract. |
| ShaderCullMode | engine | Selects the triangle face rejected by a raster pass. |
| ShaderDefinition | engine | Contains the source-of-truth definition shared by shader import and material tooling. |
| ShaderDefinitionValidator | engine | Validates the source-free material, pass and technique contract shared by graph compilation and deployed shaders. |
| ShaderDiagnostic | engine | Reports one structured shader validation or compilation issue. |
| ShaderKeywordDefinition | engine | Declares one static shader keyword that may produce compiled variants. |
| ShaderMetadataEntry | engine | Stores one open metadata key and value. |
| ShaderPassDefinition | engine | Defines one backend-neutral raster or compute shader pass. |
| ShaderPassRoleId | engine | Identifies an open pass purpose defined by a rendering provider. |
| ShaderPropertyBindingOwner | engine | Identifies which layer supplies a declared shader property’s value for each dispatch or draw. |
| ShaderPropertyDefinition | engine | Declares one shader property and its reflected stage visibility. |
| ShaderRenderState | engine | Declares backend-neutral fixed-function state for one shader pass. |
| ShaderSourceLocation | engine | Maps a shader diagnostic back to an asset, pass, stage, and source position. |
| ShaderTechniqueDefinition | engine | Declares one contract-compatible pass mapping selectable by materials. |
| ShaderTechniqueId | engine | Identifies one material-selectable technique in a shader. |
| ShaderTechniquePass | engine | Maps one provider-defined role to one concrete shader pass. |
| TextureAsset | engine | Represents imported texture content without owning a GPU handle. |
| TextureColorSpace | engine | Selects how texture samples are decoded for shader use. |
| GeometryAsset | Runtime | Represents imported geometry without prescribing scene or draw semantics. |
| IRenderTextureArtifactSource | Runtime | Exposes one or more portable image artifacts owned by an imported asset. |
| MaterialAsset | Runtime | Represents material state keyed by stable shader property identifiers. |
| MaterialMetadataEntry | Runtime | Stores one open material metadata key and value. |
| MaterialPassResolution | Runtime | Describes one capability-compatible material pass selection. |
| MaterialPassResolver | Runtime | Resolves materials through open provider-owned shader contracts and roles. |
| MaterialPropertyBlock | Runtime | Holds frame-local material overrides without modifying a shared asset. |
| MaterialPropertyEntry | Runtime | Stores one persistent material property entry. |
| MaterialValue | Runtime | Stores one native-serializable material value without a GPU binding. |
| MaterialValueKind | Runtime | Identifies the neutral value stored by a material property. |
| RenderFeatureConfiguration | Runtime | Stores one ordered feature extension selection using only stable data. |
| RenderPipelineAsset | Runtime | Selects a pipeline extension and ordered feature configuration without defining a render path. |
| RenderShaderArtifact | Runtime | Contains one immutable, source-free shader artifact ready for runtime GPU resource creation. |
| RenderShaderPassArtifact | Runtime | Carries one immutable compiled shader pass and its reflected runtime bindings. |
| RenderShaderStageArtifact | Runtime | Stores one immutable target shader stage without retaining authoring source or compiler state. |
| RenderShaderVariant | Runtime | Identifies one deterministic selection of static shader keyword options shared by authoring and runtime. |
| RenderTextureArtifactReference | Runtime | Identifies one immutable texture source across authoring, deployment, and runtime generations. |
| RenderTextureArtifactSlot | Runtime | Declares an immutable source artifact that is compiled into one sampled texture slot. |
| SerializedRenderExtensionState | Runtime | Stores reload-safe configuration for one pipeline or feature extension generation. |
| ShaderAsset | Runtime | Represents the runtime contract imported from a shader graph. |
| ShaderCompareFunction | Runtime | Selects the comparison used by depth testing. |
| ShaderContractId | Runtime | Identifies an open shader and pipeline compatibility contract. |
| ShaderCullMode | Runtime | Selects the triangle face rejected by a raster pass. |
| ShaderDefinition | Runtime | Contains the source-of-truth definition shared by shader import and material tooling. |
| ShaderDiagnostic | Runtime | Reports one structured shader validation or compilation issue. |
| ShaderKeywordDefinition | Runtime | Declares one static shader keyword that may produce compiled variants. |
| ShaderMetadataEntry | Runtime | Stores one open metadata key and value. |
| ShaderPassDefinition | Runtime | Defines one backend-neutral raster or compute shader pass. |
| ShaderPassRoleId | Runtime | Identifies an open pass purpose defined by a rendering provider. |
| ShaderPropertyBindingOwner | Runtime | Identifies which layer supplies a declared shader property’s value for each dispatch or draw. |
| ShaderPropertyDefinition | Runtime | Declares one shader property and its reflected stage visibility. |
| ShaderRenderState | Runtime | Declares backend-neutral fixed-function state for one shader pass. |
| ShaderSourceLocation | Runtime | Maps a shader diagnostic back to an asset, pass, stage, and source position. |
| ShaderTechniqueDefinition | Runtime | Declares one contract-compatible pass mapping selectable by materials. |
| ShaderTechniqueId | Runtime | Identifies one material-selectable technique in a shader. |
| ShaderTechniquePass | Runtime | Maps one provider-defined role to one concrete shader pass. |
| TextureAsset | Runtime | Represents imported texture content without owning a GPU handle. |
| TextureColorSpace | Runtime | Selects how texture samples are decoded for shader use. |