Version: 2021.3
LanguageEnglish
  • C#

MaterialPropertyBlock.CopyProbeOcclusionArrayFrom

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public void CopyProbeOcclusionArrayFrom(Vector4[] occlusionProbes);

Declaration

public void CopyProbeOcclusionArrayFrom(List<Vector4> occlusionProbes);

Parameters

occlusionProbes The array of probe occlusion values to copy from.

Description

This function copies the entire source array into a Vector4 property array named unity_ProbesOcclusion for use with instanced Shadowmask rendering.

If the array property doesn't exist on the MaterialPropertyBlock, it will be created with the length of the source array.
Call LightProbes.CalculateInterpolatedLightAndOcclusionProbes to calculate probe occlusion values at the given world space positions.
ArgumentNullException is thrown if occlusionProbes is null.
Note that all MaterialPropertyBlock arrays can only have a maximum of 1023 elements. Warnings are printed and the excess array elements are ignored if the source array exceeds the range.

Additional resources: CopySHCoefficientArraysFrom, Graphics.DrawMeshInstanced, CommandBuffer.DrawMeshInstanced.


Declaration

public void CopyProbeOcclusionArrayFrom(Vector4[] occlusionProbes, int sourceStart, int destStart, int count);

Declaration

public void CopyProbeOcclusionArrayFrom(List<Vector4> occlusionProbes, int sourceStart, int destStart, int count);

Parameters

occlusionProbes The array of probe occlusion values to copy from.
sourceStart The index of the first element in the source array to copy from.
destStart The index of the first element in the destination MaterialPropertyBlock array to copy to.
count The number of elements to copy.

Description

This function copies the source array into a Vector4 property array named unity_ProbesOcclusion with the specified source and destination range for use with instanced Shadowmask rendering.

If the array property doesn't exist on the MaterialPropertyBlock, it will be created with the length of the spcified range.
Call LightProbes.CalculateInterpolatedLightAndOcclusionProbes to calculate probe occlusion values at the given world space positions.
ArgumentNullException is thrown if occlusionProbes is null.
ArgumentOutOfRangeException is thrown if the source or destination range is invalid.
Note that all MaterialPropertyBlock arrays can only have a maximum of 1023 elements. Warnings are printed and the excess array elements are ignored if the source array exceeds the range.

Additional resources: CopySHCoefficientArraysFrom, Graphics.DrawMeshInstanced, CommandBuffer.DrawMeshInstanced.