Merge pull request godotengine#8436 from Calinou/runtime-file-loading-saving-gltf-base-path

Document glTF base path in Runtime file loading and saving

Author: mhilbrunner

tutorials/io/runtime_file_loading_and_saving.rst

@@ -198,6 +198,20 @@ Example of loading a glTF scene and appending its root node to the scene:
     # `GLTFDocument.generate_buffer()` is also available for saving to memory.
     gltf_document_save.write_to_filesystem(gltf_state_save, path)
 
+.. note::
+
+    When loading a glTF scene, a *base path* must be set so that external
+    resources like textures can be loaded correctly. When loading from a file,
+    the base path is automatically set to the folder containing the file. When
+    loading from a buffer, this base path must be manually set as there is no
+    way for Godot to infer this path.
+
+    To set the base path, set
+    :ref:`GLTFState.base_path <class_GLTFState_property_base_path>` on your
+    GLTFState instance *before* calling
+    :ref:`GLTFDocument.append_from_buffer <class_GLTFDocument_method_append_from_buffer>`
+    or :ref:`GLTFDocument.append_from_file <class_GLTFDocument_method_append_from_file>`.
+
 .. _doc_runtime_file_loading_and_saving_fonts:
 
 Fonts