Sfoglia il codice sorgente

Add diagrams that explain the import process for some 3D scene formats

Aaron Franke 1 anno fa
parent
commit
4f98c5da49

+ 36 - 0
tutorials/assets_pipeline/importing_3d_scenes/available_formats.rst

@@ -51,6 +51,26 @@ changes in a text-based format. The second is you need the texture files
 separate from the material file. If you don't need either of those, glTF binary
 files are fine.
 
+The glTF import process first loads the glTF file's data into an in-memory
+GLTFState class. This data is then used to generate a Godot scene.
+When importing files at runtime, this scene can be directly added to the tree.
+The export process is the reverse of this, a Godot scene is converted to a
+GLTFState class, then the glTF file is generated from that.
+
+.. figure:: img/importing_3d_scenes_available_formats_gltf_runtime.webp
+   :align: center
+   :alt: Diagram explaining the runtime import and export process for glTF files in Godot
+
+When importing glTF files in the editor, there are two more steps.
+After generating the Godot scene, the ResourceImporterScene class is used to
+apply additional import settings, including settings you set through the
+Import dock and the Advanced Import Settings dialog. This is then saved as
+a Godot scene file, which is what gets used when you run/export your game.
+
+.. figure:: img/importing_3d_scenes_available_formats_gltf_editor.webp
+   :align: center
+   :alt: Diagram explaining the editor import process for glTF files in Godot
+
 .. warning::
 
     If your model contains blend shapes (also known as "shape keys" and "morph
@@ -106,6 +126,14 @@ If you keep ``.blend`` files within your project folder but don't want them to
 be imported by Godot, disable **Filesystem > Import > Blender > Enabled** in the
 advanced Project Settings.
 
+The ``.blend`` import process converts to glTF first, so it still uses
+Godot's glTF import code. Therefore, the ``.blend`` import process is the same
+as the glTF import process, but with an extra step at the beginning.
+
+.. figure:: img/importing_3d_scenes_available_formats_blend.webp
+   :align: center
+   :alt: Diagram explaining the import process for Blender files in Godot
+
 .. note::
 
     When working in a team, keep in mind using ``.blend`` files in your project
@@ -166,6 +194,14 @@ If you keep ``.fbx`` files within your project folder but don't want them to
 be imported by Godot, disable **Filesystem > Import > FBX > Enabled** in the
 advanced Project Settings.
 
+The FBX import process converts to glTF first, so it still uses
+Godot's glTF import code. Therefore, the FBX import process is the same
+as the glTF import process, but with an extra step at the beginning.
+
+.. figure:: img/importing_3d_scenes_available_formats_fbx.webp
+   :align: center
+   :alt: Diagram explaining the import process for FBX files in Godot
+
 .. seealso::
 
     The full installation process for using FBX in Godot is described on the

BIN
tutorials/assets_pipeline/importing_3d_scenes/img/importing_3d_scenes_available_formats_blend.webp


BIN
tutorials/assets_pipeline/importing_3d_scenes/img/importing_3d_scenes_available_formats_fbx.webp


BIN
tutorials/assets_pipeline/importing_3d_scenes/img/importing_3d_scenes_available_formats_gltf_editor.webp


BIN
tutorials/assets_pipeline/importing_3d_scenes/img/importing_3d_scenes_available_formats_gltf_runtime.webp