:github_url: hide .. _class_VisualInstance3D: VisualInstance3D ================ **Eredita:** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` **Ereditato da:** :ref:`Decal`, :ref:`FogVolume`, :ref:`GeometryInstance3D`, :ref:`GPUParticlesAttractor3D`, :ref:`GPUParticlesCollision3D`, :ref:`Light3D`, :ref:`LightmapGI`, :ref:`OccluderInstance3D`, :ref:`OpenXRVisibilityMask`, :ref:`ReflectionProbe`, :ref:`RootMotionView`, :ref:`VisibleOnScreenNotifier3D`, :ref:`VoxelGI` Il padre di tutti i nodi visivi 3D. .. rst-class:: classref-introduction-group Descrizione ---------------------- **VisualInstance3D** serve per connettere una risorsa a una rappresentazione visiva. Tutti i nodi visuali 3D ereditano da **VisualInstance3D**. In generale, non dovresti accedere direttamente alle proprietà di **VisualInstance3D** poiché sono accessibili e gestite dai nodi che ereditano da **VisualInstance3D**. **VisualInstance3D** è la rappresentazione nodo dell'istanza :ref:`RenderingServer`. .. rst-class:: classref-reftable-group Proprietà ------------------ .. table:: :widths: auto +---------------------------+-----------------------------------------------------------------------------------------+-------+ | :ref:`int` | :ref:`layers` | ``1`` | +---------------------------+-----------------------------------------------------------------------------------------+-------+ | :ref:`float` | :ref:`sorting_offset` | | +---------------------------+-----------------------------------------------------------------------------------------+-------+ | :ref:`bool` | :ref:`sorting_use_aabb_center` | | +---------------------------+-----------------------------------------------------------------------------------------+-------+ .. rst-class:: classref-reftable-group Metodi ------------ .. table:: :widths: auto +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`AABB` | :ref:`_get_aabb`\ (\ ) |virtual| |const| | +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`AABB` | :ref:`get_aabb`\ (\ ) |const| | +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_base`\ (\ ) |const| | +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_instance`\ (\ ) |const| | +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`get_layer_mask_value`\ (\ layer_number\: :ref:`int`\ ) |const| | +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_base`\ (\ base\: :ref:`RID`\ ) | +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_layer_mask_value`\ (\ layer_number\: :ref:`int`, value\: :ref:`bool`\ ) | +-------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni delle proprietà ------------------------------------------------------ .. _class_VisualInstance3D_property_layers: .. rst-class:: classref-property :ref:`int` **layers** = ``1`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_layer_mask**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_layer_mask**\ (\ ) Gli strati di rendering su cui è disegnato questo **VisualInstance3D**. Questo oggetto sarà visibile solo per i :ref:`Camera3D` la cui maschera di cull include uno qualsiasi degli strati di rendering su cui è impostato questo **VisualInstance3D**. Per i :ref:`Light3D`, ciò può essere usato per controllare quali **VisualInstance3D** sono influenzati da una luce specifica. Per i :ref:`GPUParticles3D`, questo può essere usato per controllare quali particelle sono influenzate da un attrattore specifico. Per i :ref:`Decal`, questo può essere usato per controllare quali **VisualInstance3D** sono influenzati da una decalcomania specifica. Per regolare più facilmente i :ref:`layers` attraverso uno script, usa :ref:`get_layer_mask_value()` e :ref:`set_layer_mask_value()`. \ **Nota:** :ref:`VoxelGI`, SDFGI e :ref:`LightmapGI` terranno sempre in considerazione tutti gli strati per determinare cosa contribuisce all'illuminazione globale. Se questo è un problema, imposta :ref:`GeometryInstance3D.gi_mode` su :ref:`GeometryInstance3D.GI_MODE_DISABLED` per le mesh e :ref:`Light3D.light_bake_mode` su :ref:`Light3D.BAKE_DISABLED` per le luci per escluderle dall'illuminazione globale. .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_property_sorting_offset: .. rst-class:: classref-property :ref:`float` **sorting_offset** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_sorting_offset**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_sorting_offset**\ (\ ) La quantità in base alla quale la profondità di questo **VisualInstance3D** verrà regolata durante l'ordinamento per profondità. Utilizza le stesse unità del motore (che in genere sono metri). Aggiustandolo su un valore più alto, il **VisualInstance3D** sarà disegnato in modo affidabile sopra altri **VisualInstance3D** che sono altrimenti posizionati nello stesso punto. Per garantire che sia sempre disegnato sopra altri oggetti attorno a sé (non posizionati nello stesso punto), imposta il valore in modo che sia maggiore della distanza tra questo **VisualInstance3D** e gli altri **VisualInstance3D** vicini. .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_property_sorting_use_aabb_center: .. rst-class:: classref-property :ref:`bool` **sorting_use_aabb_center** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_sorting_use_aabb_center**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_sorting_use_aabb_center**\ (\ ) Se ``true``, l'oggetto è ordinato in base al centro dell':ref:`AABB`. Altrimenti, l'oggetto sarà ordinato in base alla posizione globale. L'ordinamento basato sul centro dell':ref:`AABB` è generalmente più accurato per i modelli 3D. L'ordinamento basato sulla posizione consente invece di controllare meglio l'ordine di disegno quando si lavora con :ref:`GPUParticles3D` e :ref:`CPUParticles3D`. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni dei metodi -------------------------------------------- .. _class_VisualInstance3D_private_method__get_aabb: .. rst-class:: classref-method :ref:`AABB` **_get_aabb**\ (\ ) |virtual| |const| :ref:`🔗` .. container:: contribute There is currently no description for this method. Please help us by `contributing one `__! .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_method_get_aabb: .. rst-class:: classref-method :ref:`AABB` **get_aabb**\ (\ ) |const| :ref:`🔗` Restituisce l':ref:`AABB` (noto anche come riquadro di delimitazione) per questo **VisualInstance3D**. .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_method_get_base: .. rst-class:: classref-method :ref:`RID` **get_base**\ (\ ) |const| :ref:`🔗` Restituisce il RID della risorsa associata a questo **VisualInstance3D**. Ad esempio, se il nodo è un :ref:`MeshInstance3D`, sarà restituito il RID della :ref:`Mesh` associata. .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_method_get_instance: .. rst-class:: classref-method :ref:`RID` **get_instance**\ (\ ) |const| :ref:`🔗` Restituisce il RID di questa istanza. Questo RID è lo stesso del RID restituito da :ref:`RenderingServer.instance_create()`. Questo RID è necessario se si desidera chiamare le funzioni :ref:`RenderingServer` direttamente su questo **VisualInstance3D**. .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_method_get_layer_mask_value: .. rst-class:: classref-method :ref:`bool` **get_layer_mask_value**\ (\ layer_number\: :ref:`int`\ ) |const| :ref:`🔗` Restituisce se è abilitato o meno lo strato specificato di :ref:`layers`, fornito un ``layer_number`` tra 1 e 20. .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_method_set_base: .. rst-class:: classref-method |void| **set_base**\ (\ base\: :ref:`RID`\ ) :ref:`🔗` Imposta la risorsa istanziata da questo **VisualInstance3D**, che modifica il modo in cui il motore gestisce il **VisualInstance3D** internamente. Equivale a :ref:`RenderingServer.instance_set_base()`. .. rst-class:: classref-item-separator ---- .. _class_VisualInstance3D_method_set_layer_mask_value: .. rst-class:: classref-method |void| **set_layer_mask_value**\ (\ layer_number\: :ref:`int`, value\: :ref:`bool`\ ) :ref:`🔗` In base a ``value``, abilita o disabilita lo strato specificato nei :ref:`layers`, fornito un ``layer_number`` compreso tra 1 e 20. .. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)` .. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)` .. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)` .. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)` .. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)` .. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)` .. |void| replace:: :abbr:`void (Nessun valore restituito.)`