# CopySHCoefficientArraysFrom

> This function converts and copies the entire source array into 7 Vector4 property arrays named unity_SHAr, unity_SHAg, unity_SHAb, unity_SHBr, unity_SHBg, unity_SHBb and unity_SHC for use with instanced light probe rendering.

## Definition

* **Type:** Method
* **Namespace:** [UnityEngine](/engine/6000.0/script-reference/unityengine.md)
* **Assembly:** UnityEngine.CoreModule

## CopySHCoefficientArraysFrom(List\<SphericalHarmonicsL2>)

This function converts and copies the entire source array into 7 Vector4 property arrays named unity\_SHAr, unity\_SHAg, unity\_SHAb, unity\_SHBr, unity\_SHBg, unity\_SHBb and unity\_SHC for use with instanced [light probe](/engine/6000.0/script-reference/unityengine/lightprobes.md) rendering.

```csharp
public void CopySHCoefficientArraysFrom(List<SphericalHarmonicsL2> lightProbes)
```

### Parameters

**** (\[List\<SphericalHarmonicsL2>]\(https\://learn.microsoft.com/dotnet/api/system.collections.generic.list-1)): The array of SH values to copy from.

### Remarks

If the array properties don't exist on the MaterialPropertyBlock, they will be created with the length of the source array.

Call [LightProbes.CalculateInterpolatedLightAndOcclusionProbes](/engine/6000.0/script-reference/unityengine/lightprobes/calculateinterpolatedlightandocclusionprobes.md) to calculate SH values at the given world space positions.

ArgumentNullException is thrown if lightProbes 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: [MaterialPropertyBlock.CopyProbeOcclusionArrayFrom](/engine/6000.0/script-reference/unityengine/materialpropertyblock/copyprobeocclusionarrayfrom.md), [Graphics.RenderMeshInstanced](/engine/6000.0/script-reference/unityengine/graphics/rendermeshinstanced.md), [CommandBuffer.DrawMeshInstanced](/engine/6000.0/script-reference/unityengine/rendering/commandbuffer/drawmeshinstanced.md).

## CopySHCoefficientArraysFrom(SphericalHarmonicsL2\[])

This function converts and copies the entire source array into 7 Vector4 property arrays named unity\_SHAr, unity\_SHAg, unity\_SHAb, unity\_SHBr, unity\_SHBg, unity\_SHBb and unity\_SHC for use with instanced [light probe](/engine/6000.0/script-reference/unityengine/lightprobes.md) rendering.

```csharp
public void CopySHCoefficientArraysFrom(SphericalHarmonicsL2[] lightProbes)
```

### Parameters

**** (\[SphericalHarmonicsL2\[]]\(/engine/6000.0/script-reference/unityengine/rendering/sphericalharmonicsl2)): The array of SH values to copy from.

### Remarks

If the array properties don't exist on the MaterialPropertyBlock, they will be created with the length of the source array.

Call [LightProbes.CalculateInterpolatedLightAndOcclusionProbes](/engine/6000.0/script-reference/unityengine/lightprobes/calculateinterpolatedlightandocclusionprobes.md) to calculate SH values at the given world space positions.

ArgumentNullException is thrown if lightProbes 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: [MaterialPropertyBlock.CopyProbeOcclusionArrayFrom](/engine/6000.0/script-reference/unityengine/materialpropertyblock/copyprobeocclusionarrayfrom.md), [Graphics.RenderMeshInstanced](/engine/6000.0/script-reference/unityengine/graphics/rendermeshinstanced.md), [CommandBuffer.DrawMeshInstanced](/engine/6000.0/script-reference/unityengine/rendering/commandbuffer/drawmeshinstanced.md).

## CopySHCoefficientArraysFrom(List\<SphericalHarmonicsL2>, int, int, int)

This function converts and copies the source array into 7 Vector4 property arrays named unity\_SHAr, unity\_SHAg, unity\_SHAb, unity\_SHBr, unity\_SHBg, unity\_SHBb and unity\_SHC with the specified source and destination range for use with instanced [light probe](/engine/6000.0/script-reference/unityengine/lightprobes.md) rendering.

```csharp
public void CopySHCoefficientArraysFrom(List<SphericalHarmonicsL2> lightProbes, int sourceStart, int destStart, int count)
```

### Parameters

**** (\[List\<SphericalHarmonicsL2>]\(https\://learn.microsoft.com/dotnet/api/system.collections.generic.list-1)): The array of SH values to copy from.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The index of the first element in the source array to copy from.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The index of the first element in the destination MaterialPropertyBlock array to copy to.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The number of elements to copy.

### Remarks

If the array properties don't exist on the MaterialPropertyBlock, they will be created with the length of the spcified range.

Call [LightProbes.CalculateInterpolatedLightAndOcclusionProbes](/engine/6000.0/script-reference/unityengine/lightprobes/calculateinterpolatedlightandocclusionprobes.md) to calculate SH 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: [MaterialPropertyBlock.CopyProbeOcclusionArrayFrom](/engine/6000.0/script-reference/unityengine/materialpropertyblock/copyprobeocclusionarrayfrom.md), [Graphics.RenderMeshInstanced](/engine/6000.0/script-reference/unityengine/graphics/rendermeshinstanced.md), [CommandBuffer.DrawMeshInstanced](/engine/6000.0/script-reference/unityengine/rendering/commandbuffer/drawmeshinstanced.md).

## CopySHCoefficientArraysFrom(SphericalHarmonicsL2\[], int, int, int)

This function converts and copies the source array into 7 Vector4 property arrays named unity\_SHAr, unity\_SHAg, unity\_SHAb, unity\_SHBr, unity\_SHBg, unity\_SHBb and unity\_SHC with the specified source and destination range for use with instanced [light probe](/engine/6000.0/script-reference/unityengine/lightprobes.md) rendering.

```csharp
public void CopySHCoefficientArraysFrom(SphericalHarmonicsL2[] lightProbes, int sourceStart, int destStart, int count)
```

### Parameters

**** (\[SphericalHarmonicsL2\[]]\(/engine/6000.0/script-reference/unityengine/rendering/sphericalharmonicsl2)): The array of SH values to copy from.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The index of the first element in the source array to copy from.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The index of the first element in the destination MaterialPropertyBlock array to copy to.**** (\[int]\(https\://learn.microsoft.com/dotnet/api/system.int32)): The number of elements to copy.

### Remarks

If the array properties don't exist on the MaterialPropertyBlock, they will be created with the length of the spcified range.

Call [LightProbes.CalculateInterpolatedLightAndOcclusionProbes](/engine/6000.0/script-reference/unityengine/lightprobes/calculateinterpolatedlightandocclusionprobes.md) to calculate SH 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: [MaterialPropertyBlock.CopyProbeOcclusionArrayFrom](/engine/6000.0/script-reference/unityengine/materialpropertyblock/copyprobeocclusionarrayfrom.md), [Graphics.RenderMeshInstanced](/engine/6000.0/script-reference/unityengine/graphics/rendermeshinstanced.md), [CommandBuffer.DrawMeshInstanced](/engine/6000.0/script-reference/unityengine/rendering/commandbuffer/drawmeshinstanced.md).