Version: 2017.3 (switch to 2017.4)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

Mesh.SetTriangles

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

Switch to Manual
public method SetTriangles(triangles: int[], submesh: int, calculateBounds: bool = true, baseVertex: int = 0): void;
public void SetTriangles(int[] triangles, int submesh, bool calculateBounds = true, int baseVertex = 0);
public method SetTriangles(triangles: int[], submesh: int): void;
public void SetTriangles(int[] triangles, int submesh);
public method SetTriangles(triangles: List<int>, submesh: int, calculateBounds: bool = true, baseVertex: int = 0): void;
public void SetTriangles(List<int> triangles, int submesh, bool calculateBounds = true, int baseVertex = 0);
public method SetTriangles(triangles: List<int>, submesh: int): void;
public void SetTriangles(List<int> triangles, int submesh);

Parameters

triangles The list of indices that define the triangles.
submesh The submesh to modify.
calculateBounds Calculate the bounding box of the Mesh after setting the triangles. This is done by default. Use false when you want to use the existing bounding box and reduce the CPU cost of setting the triangles.
baseVertex Optional vertex offset that is added to all triangle vertex indices.

Description

Sets the triangle list for the sub-Mesh.

A sub-Mesh is simply a separate triangle list. When the Mesh Renderer uses multiple Materials, you should ensure that there are as many sub-Meshes as Materials.

It is recommended to assign the triangle array after assigning the vertex array, in order to avoid out-of-bounds errors.

The baseVertex argument can be used to achieve meshes that are larger than 65535 vertices while using 16 bit index buffers, as long as each submesh fits within its own 65535 vertex area. For example, if the index buffer that is passed to SetTriangles contains indices 10,11,12 and baseVertex is set to 100000, then effectively vertices 100010, 100011 and 100012 will be used for rendering.

See Also: subMeshCount, SetIndices.

Did you find this page useful? Please give it a rating: