From 9484ee7a9ef3a4bd7ca3731eda954f0ad425db3d Mon Sep 17 00:00:00 2001
From: "K. S. Ernest (iFire) Lee" <ernest.lee@chibifire.com>
Date: Mon, 13 Dec 2021 21:34:18 -0800
Subject: Add support for importing .blend files
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Lets you drag or place .blend files in the project folder and it will import the files.

Checks for Blender 3.0's gltf2 `export_keep_originals` option.

Add basepath support to GLTFDocument append_from_file.

Co-authored-by: Rémi Verschelde <rverschelde@gmail.com>
---
 .../gltf/doc_classes/EditorSceneFormatImporterBlend.xml   | 15 +++++++++++++++
 .../gltf/doc_classes/EditorSceneFormatImporterGLTF.xml    |  9 +++++++++
 modules/gltf/doc_classes/GLTFDocument.xml                 |  1 +
 3 files changed, 25 insertions(+)
 create mode 100644 modules/gltf/doc_classes/EditorSceneFormatImporterBlend.xml
 create mode 100644 modules/gltf/doc_classes/EditorSceneFormatImporterGLTF.xml

(limited to 'modules/gltf/doc_classes')

diff --git a/modules/gltf/doc_classes/EditorSceneFormatImporterBlend.xml b/modules/gltf/doc_classes/EditorSceneFormatImporterBlend.xml
new file mode 100644
index 0000000000..b3a0381efc
--- /dev/null
+++ b/modules/gltf/doc_classes/EditorSceneFormatImporterBlend.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<class name="EditorSceneFormatImporterBlend" inherits="EditorSceneFormatImporter" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
+	<brief_description>
+		Importer for Blender's [code].blend[/code] scene file format.
+	</brief_description>
+	<description>
+		Imports Blender scenes in the [code].blend[/code] file format through the glTF 2.0 3D import pipeline. This importer requires Blender to be installed by the user, so that it can be used to export the scene as glTF 2.0.
+		The location of the Blender binary is set via the [code]filesystem/import/blend/blender_path[/code] editor setting.
+		This importer is only used if [member ProjectSettings.filesystem/import/blend/enabled] is enabled, otherwise [code].blend[/code] present in the project folder are not imported.
+		Blend import requires Blender 3.0.
+		Internally, the EditorSceneFormatImporterBlend uses the Blender glTF "Use Original" mode to reference external textures.
+	</description>
+	<tutorials>
+	</tutorials>
+</class>
diff --git a/modules/gltf/doc_classes/EditorSceneFormatImporterGLTF.xml b/modules/gltf/doc_classes/EditorSceneFormatImporterGLTF.xml
new file mode 100644
index 0000000000..5a6a2f52d9
--- /dev/null
+++ b/modules/gltf/doc_classes/EditorSceneFormatImporterGLTF.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<class name="EditorSceneFormatImporterGLTF" inherits="EditorSceneFormatImporter" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../../../doc/class.xsd">
+	<brief_description>
+	</brief_description>
+	<description>
+	</description>
+	<tutorials>
+	</tutorials>
+</class>
diff --git a/modules/gltf/doc_classes/GLTFDocument.xml b/modules/gltf/doc_classes/GLTFDocument.xml
index 7adabdc605..cb0e3b6754 100644
--- a/modules/gltf/doc_classes/GLTFDocument.xml
+++ b/modules/gltf/doc_classes/GLTFDocument.xml
@@ -24,6 +24,7 @@
 			<argument index="1" name="state" type="GLTFState" />
 			<argument index="2" name="flags" type="int" default="0" />
 			<argument index="3" name="bake_fps" type="int" default="30" />
+			<argument index="4" name="base_path" type="String" default="&quot;&quot;" />
 			<description>
 			</description>
 		</method>
-- 
cgit v1.2.3