Sara/this-city
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat: updated engine

Browse source
This commit is contained in:
Sara Gerretsen 2026-07-10 17:04:34 +02:00
parent cbe99774ff
commit f4cf6b3999
6607 changed files with 910135 additions and 430025 deletions
Download patch file Download diff file Expand all files Collapse all files

28
engine/doc/classes/EditorSceneFormatImporter.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="UTF-8" ?>
<class name="EditorSceneFormatImporter" inherits="RefCounted" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<class name="EditorSceneFormatImporter" inherits="RefCounted" api_type="editor" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
<brief_description>
Imports scenes from third-parties' 3D files.
</brief_description>
@ -65,19 +65,31 @@
</method>
</methods>
<constants>
<constant name="IMPORT_SCENE" value="1">
<constant name="IMPORT_SCENE" value="1" enum="ImportFlags" is_bitfield="true">
Unused flag (this has no effect when enabled).
</constant>
<constant name="IMPORT_ANIMATION" value="2">
<constant name="IMPORT_ANIMATION" value="2" enum="ImportFlags" is_bitfield="true">
Import animations from the 3D scene. When importing a scene as an [AnimationLibrary], this flag is always enabled.
</constant>
<constant name="IMPORT_FAIL_ON_MISSING_DEPENDENCIES" value="4">
<constant name="IMPORT_FAIL_ON_MISSING_DEPENDENCIES" value="4" enum="ImportFlags" is_bitfield="true">
Unused flag (this has no effect when enabled).
</constant>
<constant name="IMPORT_GENERATE_TANGENT_ARRAYS" value="8">
<constant name="IMPORT_GENERATE_TANGENT_ARRAYS" value="8" enum="ImportFlags" is_bitfield="true">
If [code]true[/code], generate vertex tangents using [url=http://www.mikktspace.com/]Mikktspace[/url] if the input meshes don't have tangent data. When possible, it's recommended to let the 3D modeling software generate tangents on export instead of relying on this option. Tangents are required for correct display of normal and height maps, along with any material/shader features that require tangents.
If you don't need material features that require tangents, disabling this can reduce output file size and speed up importing if the source 3D file doesn't contain tangents.
</constant>
<constant name="IMPORT_USE_NAMED_SKIN_BINDS" value="16">
<constant name="IMPORT_USE_NAMED_SKIN_BINDS" value="16" enum="ImportFlags" is_bitfield="true">
If checked, use named [Skin]s for animation. The [MeshInstance3D] node contains 3 properties of relevance here: a skeleton [NodePath] pointing to the [Skeleton3D] node (usually [code]..[/code]), a mesh, and a skin:
- The [Skeleton3D] node contains a list of bones with names, their pose and rest, a name, and a parent bone.
- The mesh is all of the raw vertex data needed to display a mesh. In terms of the mesh, it knows how vertices are weight-painted and uses some internal numbering often imported from 3D modeling software.
- The skin contains the information necessary to bind this mesh onto this Skeleton3D. For each of the internal bone IDs chosen by the 3D modeling software, it contains two things. Firstly, a matrix known as the Bind Pose Matrix, Inverse Bind Matrix, or IBM for short. Secondly, the [Skin] contains each bone's name (if this flag is enabled), or the bone's index within the [Skeleton3D] list (if this flag is disabled).
Together, this information is enough to tell Godot how to use the bone poses in the [Skeleton3D] node to render the mesh from each [MeshInstance3D]. Note that each [MeshInstance3D] may share binds, as is common in models exported from Blender, or each [MeshInstance3D] may use a separate [Skin] object, as is common in models exported from other tools such as Maya.
</constant>
<constant name="IMPORT_DISCARD_MESHES_AND_MATERIALS" value="32">
<constant name="IMPORT_DISCARD_MESHES_AND_MATERIALS" value="32" enum="ImportFlags" is_bitfield="true">
Ignore meshes and materials on import. When importing a scene as an [AnimationLibrary], this flag is always enabled.
</constant>
<constant name="IMPORT_FORCE_DISABLE_MESH_COMPRESSION" value="64">
<constant name="IMPORT_FORCE_DISABLE_MESH_COMPRESSION" value="64" enum="ImportFlags" is_bitfield="true">
If [code]true[/code], mesh compression will not be used. Consider enabling if you notice blocky artifacts in your mesh normals or UVs, or if you have meshes that are larger than a few thousand meters in each direction.
</constant>
</constants>
</class>