Bläddra i källkod

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

Aaron Franke 1 år sedan
förälder
incheckning
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
 separate from the material file. If you don't need either of those, glTF binary
 files are fine.
 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::
 .. warning::
 
 
     If your model contains blend shapes (also known as "shape keys" and "morph
     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
 be imported by Godot, disable **Filesystem > Import > Blender > Enabled** in the
 advanced Project Settings.
 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::
 .. note::
 
 
     When working in a team, keep in mind using ``.blend`` files in your project
     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
 be imported by Godot, disable **Filesystem > Import > FBX > Enabled** in the
 advanced Project Settings.
 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::
 .. seealso::
 
 
     The full installation process for using FBX in Godot is described on the
     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