From f110558839e1cd3afcb55200aedcabd48f92c1db Mon Sep 17 00:00:00 2001 From: Matthew Date: Fri, 8 Oct 2021 02:41:44 -0400 Subject: [PATCH] Document exporting gltf files from Godot (3.4) (#5283) --- .../workflow/assets/exporting_3d_scenes.rst | 31 ++++++++++++++++++ .../workflow/assets/img/gltf_godot_export.png | Bin 0 -> 11747 bytes getting_started/workflow/assets/index.rst | 1 + 3 files changed, 32 insertions(+) create mode 100644 getting_started/workflow/assets/exporting_3d_scenes.rst create mode 100644 getting_started/workflow/assets/img/gltf_godot_export.png diff --git a/getting_started/workflow/assets/exporting_3d_scenes.rst b/getting_started/workflow/assets/exporting_3d_scenes.rst new file mode 100644 index 000000000..eb8299c94 --- /dev/null +++ b/getting_started/workflow/assets/exporting_3d_scenes.rst @@ -0,0 +1,31 @@ +.. _doc_exporting_3d_scenes: + +Exporting 3D scenes +=================== + +Overview +-------- + +In Godot it is possible to export 3D scenes as a glTF 2.0 file. You can +export as a glTF binary (``.glb`` file) or glTF embedded with textures +(``gltf`` + ``.bin`` + textures). This allows you to create scenes in Godot, +such as a CSG mesh blockout for a level, export it to clean it up in a +program such as Blender, and then bring it back into Godot. + +.. note:: + + Only Blender 2.83 and newer can import glTF files exported by Godot. + +To export a scene in the editor go to **Project > Tools > Export GLTF...** + +.. image:: img/gltf_godot_export.png + +Limitations +----------- + +There are several limitations with glTF export. + +* No support for exporting particles since their implementation varies across engines. +* ShaderMaterials cannot be exported. +* No support for exporting 2D scenes. +* Only supported in editor builds (``tools=yes``). diff --git a/getting_started/workflow/assets/img/gltf_godot_export.png b/getting_started/workflow/assets/img/gltf_godot_export.png new file mode 100644 index 0000000000000000000000000000000000000000..41ebf4cbf9b0e9ea3ac22a97b7122b2674888bd0 GIT binary patch literal 11747 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 literal 0 HcmV?d00001 diff --git a/getting_started/workflow/assets/index.rst b/getting_started/workflow/assets/index.rst index 840b701b1..34101de4d 100644 --- a/getting_started/workflow/assets/index.rst +++ b/getting_started/workflow/assets/index.rst @@ -10,4 +10,5 @@ Assets workflow importing_audio_samples importing_translations importing_scenes + exporting_3d_scenes escn_exporter/index