Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


RecalculateNormals(MeshUpdateFlags)

Recalculates the normals of the Mesh from the triangles and vertices.
Read time 1 minuteLast updated 11 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.CoreModule
public void RecalculateNormals(MeshUpdateFlags flags)

Parameters

Flags controlling the function behavior, see MeshUpdateFlags.

Remarks

After modifying the vertices it is often useful to update the normals to reflect the change. Normals are calculated from all shared vertices.
Imported Meshes sometimes don't share all vertices. For example, a vertex at a UV seam is split into two vertices, so the RecalculateNormals function creates normals that are not smooth at the UV seam.
Note that RecalculateNormals does not generate tangents automatically, to do that use Mesh.RecalculateTangents.
using UnityEngine;public class Example : MonoBehaviour{ void Start() { Mesh mesh = GetComponent<MeshFilter>().mesh; mesh.RecalculateNormals(); }}
RecalculateNormals converts Mesh vertex position data to VertexAttributeFormat.Float32 format, if the format is different.
Additional Resources: Mesh.RecalculateTangents.