AmbientCombineAsset

class

Core/Vixen.Rendering.PostFx/PostEffectAssets.cs:529

csharp

public record class AmbientCombineAsset

Puts a split frame back together — the consumer end of the ambient split.

No guide page documents this yet — the page shows what the code says about itself.

Remarks

The node a split document ends its lighting with. ForwardPlus.SplitOutputs (and the resolve, under the same key) writes direct light to one target and holds diffuse ambient back; this multiplies an irradiance plane by the albedo plane, occlusion into that ambient and sun visibility into the direct term, and blends reflections over by validity — direct × sun + albedo × irradiance × occlusion, one full-screen pass. A document names the planes; the first three are the split pass's own targets, and everything after them is optional with a stated stand-in: absent occlusion reads as one, absent irradiance and reflections as nothing.

Sun visibility multiplies DIRECT and occlusion multiplies AMBIENT — !DistanceFieldAo's own channel rule, kept here. Where a shadow map already shadows the sun, the document sets that node's sunShadow: false; the double-application guard is that knob, not arithmetic in this pass.

Fields and properties (11)

public string Name
The node's name, for debug groups and for a human reading the file.
public bool Enabled
Whether the node runs.
public string Direct
The split pass's first target: direct light, emissive and specular ambient.
public string Albedo
Its second: diffuse albedo in rgb, the material's own occlusion in a.
public string Normals
Its third: world normal in xyz, roughness in a. Zero length marks a skyward pixel.
public string Irradiance
Screen irradiance over π — !IndirectDiffuse's output, or !ScreenProbeGather's; both publish the same kind of plane. Empty contributes no ambient at all.
public string Occlusion
!DistanceFieldAo's plane: occlusion in r, sun visibility in g. Empty reads both as one.
public string ContactOcclusion
!Ssao's plane: occlusion in r, contact scale over the field's room scale. Empty reads one.
public string Reflections
!Reflections' plane: radiance in rgb, validity in a. Empty blends none in.
public string Output
The name the combined radiance is published under.
public float Intensity
A multiplier on the rebuilt ambient alone.

Used by (4)

PostEffectFactoryVixen.Rendering.PostFx
PostEffectTestsVixen.Rendering.PostFx.Tests
TypeRegistrationVixen.Rendering.PostFx
Vixen_Rendering_PostFx_AmbientCombineAssetSerializerVixen.Rendering.PostFx