Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

IntegrateValidity(IDeviceContext, int, int, int, BufferSlice<float>)

Computes validity factors indicating the reliability of each probe position.
Read time 1 minuteLast updated 8 days ago

Definition

IProbeIntegrator.Result IntegrateValidity(IDeviceContext context, int positionOffset, int positionCount, int sampleCount, BufferSlice<float> validityEstimateOut)

Parameters

context

IDeviceContext
Device context for computation and memory operations.

positionOffset

int
Starting index in the probe position buffer.

positionCount

int
Number of probe positions to process.

sampleCount

int
Number of directional samples to take per probe.

validityEstimateOut

BufferSlice<float>
Output buffer for validity values (one float per probe).

Returns

Type

Description

ResultResult indicating success or failure with detailed error information.

Remarks

This method evaluates how reliable each probe position is for lighting interpolation by analyzing the geometric environment around the probe.
The validity calculation:
  • Value 1.0: Probe is in an open area with good visibility.
  • Values between 0-1: Probe has partial validity.
  • Value 0.0: Probe is inside geometry or in an invalid location.
Validity is determined by whether rays hit front-facing vs back-facing surfaces. For more information, refer to Material.doubleSidedGI.
Invalid probes (low validity) should be excluded from lighting calculations or given reduced influence during interpolation.

Examples

// Compute validity for all probesBufferID validityBuffer = context.CreateBuffer(probeCount, sizeof(float));var validitySlice = new BufferSlice<float>(validityBuffer, 0);var result = integrator.IntegrateValidity(context, 0, probeCount, 1024, validitySlice);if (result.type == IProbeIntegrator.ResultType.Success){    // Read back validity values    var validityData = new NativeArray<float>(probeCount, Allocator.Temp);    context.ReadBuffer(validitySlice, validityData);    context.Flush();    // Identify invalid probes    for (int i = 0; i < probeCount; i++)    {        if (validityData[i] < 0.5f)        {            Debug.LogWarning($"Probe {i} has low validity: {validityData[i]}");        }    }}