Version: 2021.1
LanguageEnglish
  • C#

Mesh.CombineMeshes

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

Declaration

public void CombineMeshes(CombineInstance[] combine, bool mergeSubMeshes = true, bool useMatrices = true, bool hasLightmapData = false);

Parameters

combine Descriptions of the Meshes to combine.
mergeSubMeshes Defines whether Meshes should be combined into a single sub-mesh.
useMatrices Defines whether the transforms supplied in the CombineInstance array should be used or ignored.

Description

Combines several Meshes into this Mesh.

Combining Meshes is useful for performance optimization.

If mergeSubMeshes is true, all the Meshes are combined together into a single sub-mesh. Otherwise, each Mesh is placed in a different sub-mesh. If all Meshes share the same Material, this property should be set to true.

If useMatrices is true, the transform matrices in CombineInstance structs are used. Otherwise, they are ignored.

Set hasLightmapData to true to transform the input Mesh lightmap UV data by the lightmap scale offset data in CombineInstance structs. The Meshes must share the same lightmap texture.

using UnityEngine;
using System.Collections;

// Copy meshes from children into the parent's Mesh. // CombineInstance stores the list of meshes. These are combined // and assigned to the attached Mesh.

[RequireComponent(typeof(MeshFilter))] [RequireComponent(typeof(MeshRenderer))] public class ExampleClass : MonoBehaviour { void Start() { MeshFilter[] meshFilters = GetComponentsInChildren<MeshFilter>(); CombineInstance[] combine = new CombineInstance[meshFilters.Length];

int i = 0; while (i < meshFilters.Length) { combine[i].mesh = meshFilters[i].sharedMesh; combine[i].transform = meshFilters[i].transform.localToWorldMatrix; meshFilters[i].gameObject.SetActive(false);

i++; } transform.GetComponent<MeshFilter>().mesh = new Mesh(); transform.GetComponent<MeshFilter>().mesh.CombineMeshes(combine); transform.gameObject.SetActive(true); } }