From 793c4ce0ea2227a9fe03b894504e2173b8a416cf Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Wed, 5 Oct 2022 21:46:23 +0200 Subject: [PATCH] Document `SurfaceTool.generate_normals()` interaction with smooth groups --- doc/classes/SurfaceTool.xml | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/classes/SurfaceTool.xml b/doc/classes/SurfaceTool.xml index ccec6911077..d56cc9a31b6 100644 --- a/doc/classes/SurfaceTool.xml +++ b/doc/classes/SurfaceTool.xml @@ -133,6 +133,7 @@ Generates normals from vertices so you do not have to do it manually. If [param flip] is [code]true[/code], the resulting normals will be inverted. [method generate_normals] should be called [i]after[/i] generating geometry and [i]before[/i] committing the mesh using [method commit] or [method commit_to_arrays]. For correct display of normal-mapped surfaces, you will also have to generate tangents using [method generate_tangents]. [b]Note:[/b] [method generate_normals] only works if the primitive type to be set to [constant Mesh.PRIMITIVE_TRIANGLES]. + [b]Note:[/b] [method generate_normals] takes smooth groups into account. If you don't specify any smooth group for each vertex, [method generate_normals] will smooth normals for you.