Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
ResourceImporterScene
Eredita: ResourceImporter < RefCounted < Object
Importa una scena 3D da glTF, FBX, COLLADA o Blender.
Descrizione
Vedi anche ResourceImporterOBJ, che è utilizzato per i modelli OBJ che è possibile importare come Mesh indipendente o come scena.
Ulteriori opzioni (come l'estrazione di singole mesh o materiali in file) sono disponibili nella finestra di dialogo Impostazioni di importazione avanzate. Questa finestra di dialogo è accessibile facendo doppio clic su una scena 3D nel pannello FileSystem o selezionando una scena 3D nel pannello FileSystem, andando al pannello Importazione e scegliendo Avanzate.
Nota: ResourceImporterScene non è utilizzato per i PackedScene, come i file .tscn e .scn.
Tutorial
Proprietà
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
Descrizioni delle proprietà
Dictionary _subresources = {} 🔗
Contiene proprietà per le sotto-risorse della scena. Questa è un'opzione interna che non è visibile nel pannello dell'Importazione.
Il numero di fotogrammi al secondo da utilizzare per preparare le curve di animazione in una serie di punti con interpolazione lineare. Si consiglia di configurare questo valore in modo che corrisponda al valore che si sta usando come base nel software di modellazione 3D. Valori più alti producono un'animazione più precisa con rapidi cambiamenti di movimento, a scapito di maggiori dimensioni del file e utilizzo della memoria. Grazie all'interpolazione, di solito andare oltre i 30 FPS non è molto vantaggioso (poiché l'animazione apparirà comunque fluida a frame rate di rendering più elevati).
bool animation/import = true 🔗
Se true, importa le animazioni dalla scena 3D.
bool animation/import_rest_as_RESET = false 🔗
Se true, aggiunge un'Animation denominata RESET, contenente il Skeleton3D.get_bone_rest() dai nodi Skeleton3D. Questo può essere utile per estrarre un'animazione nella posa di riferimento.
bool animation/remove_immutable_tracks = true 🔗
Se true, rimuovi le tracce di animazione che contengono solo valori predefiniti. Ciò può ridurre le dimensioni del file risultante e l'utilizzo di memoria con alcune scene 3D, a seconda del contenuto delle loro tracce di animazione.
bool animation/trimming = false 🔗
Se true, taglia l'inizio e la fine delle animazioni se non ci sono cambiamenti per i fotogrammi chiave. Ciò può ridurre le dimensioni del file risultante e l'utilizzo di memoria con alcune scene 3D, a seconda del contenuto delle loro tracce di animazione.
bool array_mesh/deduplicate_surfaces = true 🔗
If the 3D model file contains only one mesh, this option has no effect. If true and the 3D model file contains multiple meshes with the same surface names and formats, the surfaces will be merged together when the meshes are merged. This is useful for reducing the number of surfaces in the resulting mesh, and avoids duplicating materials. If false and the 3D model file contains multiple meshes, the surfaces will always be kept separate.
String import_script/path = "" 🔗
Percorso a uno script di importazione, il quale può eseguire codice dopo il completamento del processo di importazione per un'elaborazione personalizzata. Vedi Utilizzo di script di importazione per l'automazione per maggiori informazioni.
Modalità di estrazione dei materiali.
0 (Keep Internal), i materiali non sono estratti.1 (Extract Once), i materiali sono estratti una volta e riutilizzati nelle importazioni successive.2 (Extract and Overwrite), i materiali sono estratti e sovrascritti a ogni importazione.
int materials/extract_format = 0 🔗
Formato dei file dei materiali estratti.
0 (Text), formato di file testuale (*.tres).1 (Binary), formato di file binario (*.res).2 (Material), formato di file bionario (*.material).
String materials/extract_path = "" 🔗
Il percorso in cui i materiali estratti sono salvati. Se vuoto, è utilizzato il percorso della scena sorgente.
bool mesh_library/use_node_names_as_mesh_names = false 🔗
If true, the mesh names will be set to the names of the nodes in the 3D model file. If false, the mesh names will be set to the names of the meshes in the 3D model file. Enabling this is a common work-around when the author of the 3D model file did not properly set the mesh names in Blender or other 3D modeling apps. For example, a file may have a node named "Turret" with a mesh named "Cube.002", so enabling this option will set the mesh name to "Turret" instead of "Cube_002".
bool meshes/create_shadow_meshes = true 🔗
Se true, abilita la generazione di mesh per le ombre all'importazione. Ciò ottimizza il rendering delle ombre senza ridurre la qualità saldando i vertici insieme quando possibile. Ciò a sua volta riduce la banda di memoria richiesta per renderizzare le ombre. La generazione dei mesh per le ombre al momento non supporta l'uso di un livello di dettaglio inferiore rispetto alla mesh sorgente (ma il rendering delle ombre utilizzerà i LOD quando appropriato).
bool meshes/ensure_tangents = true 🔗
If true, generate vertex tangents using Mikktspace 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.
bool meshes/force_disable_compression = false 🔗
Se true, la compressione della mesh non sarà utilizzata. Considera di abilitarla se noti artefatti a blocchi nelle normali o UV della mesh, o se hai mesh più grandi di qualche migliaio di metri in ogni direzione.
bool meshes/generate_lods = true 🔗
Se true, genera variazioni di dettaglio inferiori della mesh che saranno visualizzate in lontananza per migliorare le prestazioni di rendering. Non tutte le mesh approfittano dei LOD, soprattutto se non sono mai renderizzate da lontano. Disattivando questa opzione è possibile ridurre le dimensioni del file risultante e velocizzare l'importazione. Consulta Livello di dettaglio delle mesh (LOD) per maggiori informazioni.
Configura la GeometryInstance3D.gi_mode delle mesh nella scena 3D. Se impostato su Static Lightmaps, imposta la modalità GI delle mesh su Static e genera gli UV2 all'importazione per il precalcolo di LightmapGI.
float meshes/lightmap_texel_size = 0.2 🔗
Controlla la dimensione di ogni texel sulla lightmap precalcolata. Un valore più piccolo produce lightmap più precise, a costo di dimensioni maggiori e tempi di precalcolo più lunghi.
Nota: Efficace solo se meshes/light_baking è impostato su Static Lightmaps.
bool nodes/apply_root_scale = true 🔗
Se true, nodes/root_scale sarà applicato ai nodi discendenti, mesh, animazioni, ossa, ecc. Ciò significa che se aggiungi in seguito un nodo figlio all'interno della scena importata, non sarà ridimensionato. Se false, nodes/root_scale moltiplicherà invece la scala del nodo radice.
bool nodes/import_as_skeleton_bones = false 🔗
Tratta tutti i nodi nella scena importata come se fossero ossa all'interno di un singolo Skeleton3D. Può essere utilizzato per assicurare che le animazioni importate puntino alle ossa dello scheletro piuttosto che ai nodi. Può anche essere utilizzato per assegnare l'osso "Root" in una BoneMap. Consulta Retargeting 3D Skeletons per maggiori informazioni.
Sostituzione per il nome del nodo radice. Se vuoto, il nodo radice usare ciò che specifica la scena, o il nome del file se la scena non specifica un nome radice.
float nodes/root_scale = 1.0 🔗
La scala uniforme da usare per la radice della scena. Il valore predefinito di 1.0 non effettuerà alcun ridimensionamento. Vedi nodes/apply_root_scale per i dettagli su come viene applicata questa scala.
Script nodes/root_script = null 🔗
Se impostato su uno script valido, allega lo script al nodo radice della scena importata. Se il tipo del nodo radice non è compatibile con lo script, il nodo radice sarà sostituito con un tipo compatibile. È possibile utilizzare questa impostazione anche su altri nodi non mesh nella scena per allegarvi degli script.
Sostituzione per il tipo di nodo radice. Se vuoto, il nodo radice utilizzerà ciò che specifica la scena, oppure Node3D se la scena non specifica un tipo radice. Si consiglia di utilizzare un tipo di nodo che eredita da Node3D. Altrimenti, non sarà possibile posizionare il nodo direttamente nell'editor 3D.
bool nodes/use_name_suffixes = true 🔗
Se true, usa i suffissi nei nomi degli oggetti importati, come nodi e risorse, per determinare i tipi e le proprietà, come -noimp per saltare l'importazione di un nodo o di un'animazione, -alpha per abilitare la trasparenza alfa su un materiale, e -vcol per abilitare i colori dei vertici su un materiale. Disattivando questa opzione, i file importati dall'editor diventano più simili ai file originali e ai file importati in fase di esecuzione. Vedi Personalizzazione del tipo di nodo tramite suffissi dei nomi per maggiori informazioni.
bool nodes/use_node_type_suffixes = true 🔗
Se true, userà i suffissi nei nomi dei nodi per determinare il tipo di nodo, come -col per le forme di collisione. Questo è utilizzato solo quando nodes/use_name_suffixes è true. Disattivando questa opzione, i file importati dall'editor diventano più simili ai file originali e ai file importati in fase di esecuzione. Vedi Personalizzazione del tipo di nodo tramite suffissi dei nomi per maggiori informazioni.
bool skins/use_named_skins = true 🔗
If checked, use named Skins for animation. The MeshInstance3D node contains 3 properties of relevance here: a skeleton NodePath pointing to the Skeleton3D node (usually ..), 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 skins/use_named_skins is
true), or the bone's index within the Skeleton3D list (if skins/use_named_skins isfalse).
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.