diff --git a/doc/classes/Mesh.xml b/doc/classes/Mesh.xml index 4b9fa7bca97..ebee089a3a8 100644 --- a/doc/classes/Mesh.xml +++ b/doc/classes/Mesh.xml @@ -162,14 +162,14 @@ - Returns the number of surfaces that the [Mesh] holds. + Returns the number of surfaces that the [Mesh] holds. This is equivalent to [method MeshInstance3D.get_surface_override_material_count]. - Returns the arrays for the vertices, normals, uvs, etc. that make up the requested surface (see [method ArrayMesh.add_surface_from_arrays]). + Returns the arrays for the vertices, normals, UVs, etc. that make up the requested surface (see [method ArrayMesh.add_surface_from_arrays]). @@ -184,6 +184,7 @@ Returns a [Material] in a given surface. Surface is rendered using this material. + [b]Note:[/b] This returns the material within the [Mesh] resource, not the [Material] associated to the [MeshInstance3D]'s Surface Material Override properties. To get the [Material] associated to the [MeshInstance3D]'s Surface Material Override properties, use [method MeshInstance3D.get_surface_override_material] instead. @@ -192,6 +193,7 @@ Sets a [Material] for a given surface. Surface will be rendered using this material. + [b]Note:[/b] This assigns the material within the [Mesh] resource, not the [Material] associated to the [MeshInstance3D]'s Surface Material Override properties. To set the [Material] associated to the [MeshInstance3D]'s Surface Material Override properties, use [method MeshInstance3D.set_surface_override_material] instead. diff --git a/doc/classes/MeshInstance3D.xml b/doc/classes/MeshInstance3D.xml index fb6702263eb..1dd47d609aa 100644 --- a/doc/classes/MeshInstance3D.xml +++ b/doc/classes/MeshInstance3D.xml @@ -74,13 +74,14 @@ - Returns the override [Material] for the specified [param surface] of the [Mesh] resource. + Returns the override [Material] for the specified [param surface] of the [Mesh] resource. See also [method get_surface_override_material_count]. + [b]Note:[/b] This returns the [Material] associated to the [MeshInstance3D]'s Surface Material Override properties, not the material within the [Mesh] resource. To get the material within the [Mesh] resource, use [method Mesh.surface_get_material] instead. - Returns the number of surface override materials. This is equivalent to [method Mesh.get_surface_count]. + Returns the number of surface override materials. This is equivalent to [method Mesh.get_surface_count]. See also [method get_surface_override_material]. @@ -97,6 +98,7 @@ Sets the override [param material] for the specified [param surface] of the [Mesh] resource. This material is associated with this [MeshInstance3D] rather than with [member mesh]. + [b]Note:[/b] This assigns the [Material] associated to the [MeshInstance3D]'s Surface Material Override properties, not the material within the [Mesh] resource. To set the material within the [Mesh] resource, use [method Mesh.surface_get_material] instead.