Unity - Scripting API: Mesh.SetColors
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.
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.
Declaration
public void SetColors(Color32[] inColors);
Declaration
public void SetColors(Color[] inColors);
Declaration
public void SetColors(List<Color32> inColors);
Declaration
public void SetColors(List<Color> inColors);
Declaration
public void SetColors(NativeArray<T> inColors);
Parameters
| Parameter | Description |
|---|---|
| inColors | Per-vertex colors. |
Description
Set the per-vertex colors of the Mesh.
Unity internally stores Mesh data in the format matching the data you supply. For example, if you pass a Color32 array Unity will store each color in 4 bytes (low precision, 0..1 range); whereas if you pass a Color array, Unity stores each color in 16 bytes (full 32 bit float per color channel).
If you use a List, Unity copies the values. If you change the List, the Mesh colors won't change unless you call Mesh.SetColors again.
Declaration
public void SetColors(Color32[] inColors, int start, int length, Rendering.MeshUpdateFlags flags = MeshUpdateFlags.Default);
Declaration
public void SetColors(Color[] inColors, int start, int length, Rendering.MeshUpdateFlags flags = MeshUpdateFlags.Default);
Declaration
public void SetColors(List<Color32> inColors, int start, int length, Rendering.MeshUpdateFlags flags = MeshUpdateFlags.Default);
Declaration
public void SetColors(List<Color> inColors, int start, int length, Rendering.MeshUpdateFlags flags = MeshUpdateFlags.Default);
Declaration
public void SetColors(NativeArray<T> inColors, int start, int length, Rendering.MeshUpdateFlags flags = MeshUpdateFlags.Default);
Parameters
| Parameter | Description |
|---|---|
| inColors | Per-vertex colors. |
| start | Index of the first element to take from the input array. |
| length | Number of elements to take from the input array. |
| flags | Flags controlling the function behavior, see MeshUpdateFlags. |
Description
Sets the per-vertex colors of the Mesh, using a part of the input array.
This method behaves as if you called SetColors with an array that is a slice of the whole array, starting at start index and being of a given length. The resulting Mesh has length amount of vertices.