ZOA Rendering Core

IRenderPipelineAdapter

interface

The pipeline abstraction. Implemented once per pipeline in com.zoa.rendering.urp and com.zoa.rendering.hdrp, never in this package.

• string PipelineId { get; }
• string DisplayName { get; }
• bool IsAvailable { get; }
• IMaterialVariantResolver MaterialResolver { get; }

RenderPipelineAdapterRegistry

service

Static, case-insensitive registry of adapters plus the active-pipeline pointer. The single place a consumer asks who is rendering right now.

• static void Register(IRenderPipelineAdapter adapter)
• static bool Unregister(string pipelineId)
• static void SetActive(string pipelineId)
• static IRenderPipelineAdapter GetActive()
• static bool TryGet(string pipelineId, out IRenderPipelineAdapter adapter)
• static IReadOnlyCollection<IRenderPipelineAdapter> All { get; }
• static void ClearAll()

IMaterialVariantResolver

interface

Maps a MaterialSemanticId to a pipeline-specific material. Returns false rather than throwing when the id is invalid or unmapped.

• bool TryResolve(MaterialSemanticId semanticId, out ResolvedMaterial result)
• IReadOnlyList<MaterialSemanticId> RegisteredIds { get; }

IFxResolver

interface

The effect-side twin of the material resolver. Maps an FxSemanticId to a pipeline-specific effect asset.

• bool TryResolve(FxSemanticId semanticId, out ResolvedFx result)
• IReadOnlyList<FxSemanticId> RegisteredIds { get; }

IRenderPreviewService

interface

Preview rendering for editor tooling. Creates a PreviewContext for a visual profile and releases it again; IsSupported reports whether the active pipeline can serve previews at all.

• bool IsSupported { get; }
• PreviewContext CreatePreview(VisualProfileId profileId)
• void ReleasePreview(PreviewContext context)

MaterialSemanticId

struct

Readonly string-backed id for a material category, with ordinal equality and operators. Requesting "impact.concrete" costs a gameplay system nothing in pipeline knowledge.

• string Value { get; }
• bool IsValid { get; }

FxSemanticId

struct

The same shape as MaterialSemanticId, for effect categories such as "fx.muzzle.flash.rifle". Throws on a null constructor argument; whitespace makes it invalid rather than throwing.

• string Value { get; }
• bool IsValid { get; }

ResolvedMaterial

class

What a successful material resolution hands back: the semantic id that was asked for, the pipeline-specific AssetPath, and the RenderPipelineTarget that answered.

• MaterialSemanticId SemanticId { get; }
• string AssetPath { get; }
• RenderPipelineTarget Pipeline { get; }

ResolvedFx

class

The effect-side result, carrying FxSemanticId, AssetPath, and the answering pipeline.

• FxSemanticId SemanticId { get; }
• string AssetPath { get; }
• RenderPipelineTarget Pipeline { get; }

RenderPipelineTarget

enum

Unknown, URP, HDRP. Stamped onto every resolution result so a tool can tell which adapter produced a path without asking the registry again.

IVisualEnvironmentService

interface

Scene-visual facade resolved through FoundryServiceRegistry. Consumers apply environment states through it instead of touching RenderSettings or volumes directly.

• VisualEnvironmentState Current { get; }
• bool Apply(in VisualEnvironmentState state)
• event Action<VisualEnvironmentState> Applied
• void RegisterApplier(IVisualEnvironmentApplier applier)
• void UnregisterApplier(IVisualEnvironmentApplier applier)

IVisualEnvironmentApplier

interface

A pipeline-specific hook run after the pipeline-agnostic pass. Implemented by the URP and HDRP packages and registered at bootstrap; ApplierId is a diagnostic string such as "urp.exposure".

• string ApplierId { get; }
• void Apply(in VisualEnvironmentState state)

VisualEnvironmentState

struct

The environment request itself. Has flags gate ambient, fog, exposure, and skybox independently, so partial application is explicit.

• bool HasAmbient; EnvironmentColor AmbientColor; float AmbientIntensity;
• bool HasFog; bool FogEnabled; VisualEnvironmentFogMode FogMode; EnvironmentColor FogColor;
• float FogDensity; float FogStartDistance; float FogEndDistance;
• bool HasExposure; float ExposureEv;
• bool HasSkybox; string SkyboxSemanticId;

RenderSettingsVisualEnvironmentService

class

The default service. Applies ambient, fog, and skybox through RenderSettings, then runs registered appliers in order, catching and logging any that fail. Skybox resolution goes through the active adapter's material resolver.

VisualEnvironmentBootstrap

class

Play-mode self-registration for the default service. Ensure is idempotent and defers to any implementation already registered against the contract.

• static IVisualEnvironmentService Ensure()

RenderingValidator

class

Static configuration check. Reports RENDER_001 when no adapter is registered, RENDER_002 when adapters exist but none is active, and RENDER_003 when the active adapter reports itself unavailable.

• static List<RenderingValidationDiagnostic> ValidateAll()

RenderingValidationDiagnostic

class

One validation finding: a severity, a stable Code, a Message, and optional Context. Severity is Info, Warning, or Error.

• RenderingDiagnosticSeverity Severity { get; }
• string Code { get; }
• string Message { get; }
• string Context { get; }

PreviewContext

class

A live preview handle carrying an Id and the VisualProfileId it previews. Disposable, and IsActive flips to false once released.

• string Id { get; }
• VisualProfileId ProfileId { get; }
• bool IsActive { get; }
• void Dispose()

VisualProfileDefinition

class

A named visual profile bound to a target pipeline. Plain C# rather than a ScriptableObject, so profile data can be constructed and validated without the editor.

• VisualProfileId Id { get; }
• string DisplayName { get; }
• RenderPipelineTarget TargetPipeline { get; }