Explorar o código

Add GLTFDocument documentation.

Co-authored-by: Meow <[email protected]>
Co-authored-by: Aaron Franke <[email protected]>
K. S. Ernest (iFire) Lee %!s(int64=2) %!d(string=hai) anos
pai
achega
5aafa3f54a
Modificáronse 1 ficheiros con 9 adicións e 0 borrados
  1. 9 0
      modules/gltf/doc_classes/GLTFDocument.xml

+ 9 - 0
modules/gltf/doc_classes/GLTFDocument.xml

@@ -16,6 +16,8 @@
 			<param index="3" name="flags" type="int" default="0" />
 			<param index="4" name="bake_fps" type="int" default="30" />
 			<description>
+				Takes a [PackedByteArray] defining a gLTF and returns a [GLTFState] object through the [param state] parameter.
+				[b]Note:[/b] The [param base_path] tells [method append_from_buffer] where to find dependencies and can be empty.
 			</description>
 		</method>
 		<method name="append_from_file">
@@ -26,6 +28,8 @@
 			<param index="3" name="bake_fps" type="int" default="30" />
 			<param index="4" name="base_path" type="String" default="&quot;&quot;" />
 			<description>
+				Takes a path to a gLTF file and returns a [GLTFState] object through the [param state] parameter.
+				[b]Note:[/b] The [param base_path] tells [method append_from_file] where to find dependencies and can be empty.
 			</description>
 		</method>
 		<method name="append_from_scene">
@@ -35,12 +39,14 @@
 			<param index="2" name="flags" type="int" default="0" />
 			<param index="3" name="bake_fps" type="int" default="30" />
 			<description>
+				Takes a Godot Engine scene node and returns a [GLTFState] object through the [param state] parameter.
 			</description>
 		</method>
 		<method name="generate_buffer">
 			<return type="PackedByteArray" />
 			<param index="0" name="state" type="GLTFState" />
 			<description>
+				Takes a [GLTFState] object through the [param state] parameter and returns a gLTF [PackedByteArray].
 			</description>
 		</method>
 		<method name="generate_scene">
@@ -48,6 +54,7 @@
 			<param index="0" name="state" type="GLTFState" />
 			<param index="1" name="bake_fps" type="int" default="30" />
 			<description>
+				Takes a [GLTFState] object through the [param state] parameter and returns a Godot Engine scene node.
 			</description>
 		</method>
 		<method name="register_gltf_document_extension" qualifiers="static">
@@ -64,6 +71,8 @@
 			<param index="0" name="state" type="GLTFState" />
 			<param index="1" name="path" type="String" />
 			<description>
+				Takes a [GLTFState] object through the [param state] parameter and writes a glTF file to the filesystem.
+				[b]Note:[/b] The extension of the glTF file determines if it is a .glb binary file or a .gltf file.
 			</description>
 		</method>
 	</methods>