godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-03 05:48:42 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #10835 from aaronfranke/opt-out-name-suffix

Browse Source 
Document how to opt out of name suffix customization in 3D import
This commit is contained in:
Matthew
2025-05-04 12:44:13 -04:00
committed by GitHub
parent 9ca65ff427 f2110357a2
commit 604d3d8dcf
1 changed files with 39 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
tutorials/assets_pipeline/importing_3d_scenes/node_type_customization.rst
View File

@@ -20,11 +20,33 @@ will detect suffixes in object names and will perform actions automatically.
All the suffixes described below can be used with ``-``, ``$``, and ``_`` and are
**case-insensitive**.
Remove nodes (-noimp)
---------------------
Opting out
----------
Objects that have the ``-noimp`` suffix will be removed at import-time no matter
what their type is. They will not appear in the imported scene.
If you do not want Godot to perform any of the actions described below, you
can set the ``nodes/use_node_type_suffixes`` import option to ``false``.
This will disable all node type suffixes, which keeps nodes the same type
as the original file indicated. However, the ``-noimp`` suffix will still
be respected, as well as non-node suffixes like ``-vcol`` or ``-loop``.
Alternatively, you can completely opt out of all name suffixes by setting
the ``nodes/use_name_suffixes`` import option to ``false``. This will
completely stop the general scene import code from looking at name suffixes.
However, the format-specific import code may still look at name suffixes,
such as the glTF importer checking for the ``-loop`` suffix.
Disabling these options makes editor-imported files more similar to the
original files, and more similar to importing files at runtime.
For an import workflow that works at runtime, gives more predictable
results, and only has explicitly defined behavior, consider setting these
options to ``false`` and using :ref:`class_GLTFDocumentExtension` instead.
Remove nodes and animations (-noimp)
------------------------------------
Nodes and animations that have the ``-noimp`` suffix will be removed at
import time no matter what their type is. They will not appear in the
imported scene.
This is equivalent to enabling **Skip Import** for a node in the Advanced Import
Settings dialog.
@@ -132,3 +154,16 @@ will be imported as a Godot :ref:`class_Animation` with the loop flag set.
In Blender, this requires using the NLA Editor and naming the Action with the ``loop`` or
``cycle`` prefix or suffix.
Material alpha (-alpha)
-----------------------
A material with the ``-alpha`` suffix will be imported with the
:ref:`TRANSPARENCY_ALPHA<class_BaseMaterial3D_constant_TRANSPARENCY_ALPHA>` transparency mode.
Material vertex color (-vcol)
-----------------------------
A material with the ``-vcol`` suffix will be imported with the
:ref:`FLAG_ALBEDO_FROM_VERTEX_COLOR<class_BaseMaterial3D_constant_FLAG_ALBEDO_FROM_VERTEX_COLOR>` and
:ref:`FLAG_SRGB_VERTEX_COLOR<class_BaseMaterial3D_constant_FLAG_SRGB_VERTEX_COLOR>` flags set.