Browse Source

Clarify that MeshInstance surface methods only apply to override materials

(cherry picked from commit 22881a6923415054bbf2a3ac85c666ea87645bf5)
salamandars 3 năm trước cách đây
mục cha
commit
5fcdbfb2be
1 tập tin đã thay đổi với 4 bổ sung3 xóa
  1. 4 3
      doc/classes/MeshInstance.xml

+ 4 - 3
doc/classes/MeshInstance.xml

@@ -52,13 +52,14 @@
 			<return type="Material" />
 			<argument index="0" name="surface" type="int" />
 			<description>
-				Returns the [Material] for a surface of the [Mesh] resource.
+				Returns the override [Material] for a surface of the [Mesh] resource.
+				[b]Note:[/b] This function only returns [i]override[/i] materials associated with this [MeshInstance]. Consider using [method get_active_material] or [method Mesh.surface_get_material] to get materials associated with the [Mesh] resource.
 			</description>
 		</method>
 		<method name="get_surface_material_count" qualifiers="const">
 			<return type="int" />
 			<description>
-				Returns the number of surface materials.
+				Returns the number of surface override materials.
 			</description>
 		</method>
 		<method name="set_surface_material">
@@ -66,7 +67,7 @@
 			<argument index="0" name="surface" type="int" />
 			<argument index="1" name="material" type="Material" />
 			<description>
-				Sets the [Material] for a surface of the [Mesh] resource.
+				Sets the override [Material] for the specified surface of the [Mesh] resource. This material is associated with this [MeshInstance] rather than with the [Mesh] resource.
 			</description>
 		</method>
 	</methods>