mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
329 lines
15 KiB
ReStructuredText
329 lines
15 KiB
ReStructuredText
:github_url: hide
|
|
|
|
.. _class_CanvasLayer:
|
|
|
|
CanvasLayer
|
|
===========
|
|
|
|
**Eredita:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
|
|
|
**Ereditato da:** :ref:`ParallaxBackground<class_ParallaxBackground>`
|
|
|
|
Un nodo utilizzato per il rendering indipendente di oggetti all'interno di una scena 2D.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Descrizione
|
|
----------------------
|
|
|
|
I nodi derivati da :ref:`CanvasItem<class_CanvasItem>` che sono figli diretti o indiretti di un **CanvasLayer** saranno disegnati in quel livello. Il livello è un indice numerico che definisce l'ordine di disegno. La scena 2D predefinita renderizza con un indice ``0``, quindi un **CanvasLayer** con indice ``-1`` sarà disegnato sotto, e un **CanvasLayer** con indice ``1`` sarà disegnato sopra. Questo ordine sarà mantenuto a prescindere dal :ref:`CanvasItem.z_index<class_CanvasItem_property_z_index>` dei nodi all'interno di ciascun livello.
|
|
|
|
È possibile nascondere i **CanvasLayer** e anche facoltativamente seguire la viewport. Ciò li rende utili per HUD come overlay di barre della salute (su livelli ``1`` e superiori) o sfondi (su livelli ``-1`` e inferiori).
|
|
|
|
\ **Nota:** I nodi :ref:`Window<class_Window>` incorporati sono posizionati sul livello ``1024``. I :ref:`CanvasItem<class_CanvasItem>` sui livelli ``1025`` e superiori sono visualizzati davanti alle finestre incorporate.
|
|
|
|
\ **Nota:** Ogni **CanvasLayer** è disegnato su una specifica :ref:`Viewport<class_Viewport>` e non può essere condiviso tra più :ref:`Viewport<class_Viewport>`, vedi :ref:`custom_viewport<class_CanvasLayer_property_custom_viewport>`. Quando si utilizzano più :ref:`Viewport<class_Viewport>`, ad esempio in un gioco a schermo diviso, è necessario creare un **CanvasLayer** per ogni :ref:`Viewport<class_Viewport>` su cui si desidera che sia disegnato.
|
|
|
|
.. rst-class:: classref-introduction-group
|
|
|
|
Tutorial
|
|
----------------
|
|
|
|
- :doc:`Viewport e trasformazioni di canvas <../tutorials/2d/2d_transforms>`
|
|
|
|
- :doc:`Livelli del canvas <../tutorials/2d/canvas_layers>`
|
|
|
|
- `Demo 2D "Dodge The Creeps" <https://godotengine.org/asset-library/asset/2712>`__
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Proprietà
|
|
------------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`Node<class_Node>` | :ref:`custom_viewport<class_CanvasLayer_property_custom_viewport>` | |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`follow_viewport_enabled<class_CanvasLayer_property_follow_viewport_enabled>` | ``false`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`follow_viewport_scale<class_CanvasLayer_property_follow_viewport_scale>` | ``1.0`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`layer<class_CanvasLayer_property_layer>` | ``1`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`Vector2<class_Vector2>` | :ref:`offset<class_CanvasLayer_property_offset>` | ``Vector2(0, 0)`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`rotation<class_CanvasLayer_property_rotation>` | ``0.0`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`Vector2<class_Vector2>` | :ref:`scale<class_CanvasLayer_property_scale>` | ``Vector2(1, 1)`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`Transform2D<class_Transform2D>` | :ref:`transform<class_CanvasLayer_property_transform>` | ``Transform2D(1, 0, 0, 1, 0, 0)`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`visible<class_CanvasLayer_property_visible>` | ``true`` |
|
|
+---------------------------------------+------------------------------------------------------------------------------------+-----------------------------------+
|
|
|
|
.. rst-class:: classref-reftable-group
|
|
|
|
Metodi
|
|
------------
|
|
|
|
.. table::
|
|
:widths: auto
|
|
|
|
+---------------------------------------+----------------------------------------------------------------------------------------+
|
|
| :ref:`RID<class_RID>` | :ref:`get_canvas<class_CanvasLayer_method_get_canvas>`\ (\ ) |const| |
|
|
+---------------------------------------+----------------------------------------------------------------------------------------+
|
|
| :ref:`Transform2D<class_Transform2D>` | :ref:`get_final_transform<class_CanvasLayer_method_get_final_transform>`\ (\ ) |const| |
|
|
+---------------------------------------+----------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`hide<class_CanvasLayer_method_hide>`\ (\ ) |
|
|
+---------------------------------------+----------------------------------------------------------------------------------------+
|
|
| |void| | :ref:`show<class_CanvasLayer_method_show>`\ (\ ) |
|
|
+---------------------------------------+----------------------------------------------------------------------------------------+
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Segnali
|
|
--------------
|
|
|
|
.. _class_CanvasLayer_signal_visibility_changed:
|
|
|
|
.. rst-class:: classref-signal
|
|
|
|
**visibility_changed**\ (\ ) :ref:`🔗<class_CanvasLayer_signal_visibility_changed>`
|
|
|
|
Emesso quando la visibilità del livello viene modificata. Vedi :ref:`visible<class_CanvasLayer_property_visible>`.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descrizioni delle proprietà
|
|
------------------------------------------------------
|
|
|
|
.. _class_CanvasLayer_property_custom_viewport:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Node<class_Node>` **custom_viewport** :ref:`🔗<class_CanvasLayer_property_custom_viewport>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_custom_viewport**\ (\ value\: :ref:`Node<class_Node>`\ )
|
|
- :ref:`Node<class_Node>` **get_custom_viewport**\ (\ )
|
|
|
|
Il nodo :ref:`Viewport<class_Viewport>` personalizzato assegnato al **CanvasLayer**. Se ``null``, utilizza invece la viewport predefinita.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_follow_viewport_enabled:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **follow_viewport_enabled** = ``false`` :ref:`🔗<class_CanvasLayer_property_follow_viewport_enabled>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_follow_viewport**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_following_viewport**\ (\ )
|
|
|
|
Se abilitato, il **CanvasLayer** mantiene la sua pozione in spazio globale. Se disabilitato, il **CanvasLayer** rimarrà in una posizione fissa sullo schermo.
|
|
|
|
Insieme a :ref:`follow_viewport_scale<class_CanvasLayer_property_follow_viewport_scale>` può essere utilizzato per un effetto pseudo 3D.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_follow_viewport_scale:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`float<class_float>` **follow_viewport_scale** = ``1.0`` :ref:`🔗<class_CanvasLayer_property_follow_viewport_scale>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_follow_viewport_scale**\ (\ value\: :ref:`float<class_float>`\ )
|
|
- :ref:`float<class_float>` **get_follow_viewport_scale**\ (\ )
|
|
|
|
Ridimensiona il livello quando si usa :ref:`follow_viewport_enabled<class_CanvasLayer_property_follow_viewport_enabled>`. I livelli che si spostano in primo piano dovrebbero avere scale crescenti, mentre i livelli che si spostano sullo sfondo dovrebbero avere scale decrescenti.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_layer:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`int<class_int>` **layer** = ``1`` :ref:`🔗<class_CanvasLayer_property_layer>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_layer**\ (\ value\: :ref:`int<class_int>`\ )
|
|
- :ref:`int<class_int>` **get_layer**\ (\ )
|
|
|
|
Indice di livello per l'ordine di visualizzazione. I valori più bassi sono disegnati dietro i valori più alti.
|
|
|
|
\ **Nota:** Se più CanvasLayer hanno lo stesso indice di livello, i figli :ref:`CanvasItem<class_CanvasItem>` di un CanvasLayer sono disegnati dietro i figli :ref:`CanvasItem<class_CanvasItem>` dell'altro CanvasLayer. Quale dei CanvasLayer è disegnato in primo piano non è deterministico.
|
|
|
|
\ **Nota:** L'indice di livello deve essere compreso tra :ref:`RenderingServer.CANVAS_LAYER_MIN<class_RenderingServer_constant_CANVAS_LAYER_MIN>` e :ref:`RenderingServer.CANVAS_LAYER_MAX<class_RenderingServer_constant_CANVAS_LAYER_MAX>` (inclusi). Qualsiasi altro valore verrà avvolto.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_offset:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Vector2<class_Vector2>` **offset** = ``Vector2(0, 0)`` :ref:`🔗<class_CanvasLayer_property_offset>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_offset**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
|
- :ref:`Vector2<class_Vector2>` **get_offset**\ (\ )
|
|
|
|
Lo spostamento di base del livello.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_rotation:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`float<class_float>` **rotation** = ``0.0`` :ref:`🔗<class_CanvasLayer_property_rotation>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_rotation**\ (\ value\: :ref:`float<class_float>`\ )
|
|
- :ref:`float<class_float>` **get_rotation**\ (\ )
|
|
|
|
La rotazione del livello in radianti.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_scale:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Vector2<class_Vector2>` **scale** = ``Vector2(1, 1)`` :ref:`🔗<class_CanvasLayer_property_scale>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_scale**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
|
|
- :ref:`Vector2<class_Vector2>` **get_scale**\ (\ )
|
|
|
|
La scala del livello.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_transform:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`Transform2D<class_Transform2D>` **transform** = ``Transform2D(1, 0, 0, 1, 0, 0)`` :ref:`🔗<class_CanvasLayer_property_transform>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_transform**\ (\ value\: :ref:`Transform2D<class_Transform2D>`\ )
|
|
- :ref:`Transform2D<class_Transform2D>` **get_transform**\ (\ )
|
|
|
|
La trasformazione del livello.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_property_visible:
|
|
|
|
.. rst-class:: classref-property
|
|
|
|
:ref:`bool<class_bool>` **visible** = ``true`` :ref:`🔗<class_CanvasLayer_property_visible>`
|
|
|
|
.. rst-class:: classref-property-setget
|
|
|
|
- |void| **set_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
|
|
- :ref:`bool<class_bool>` **is_visible**\ (\ )
|
|
|
|
Se ``false``, qualsiasi :ref:`CanvasItem<class_CanvasItem>` sotto questo **CanvasLayer** sarà nascosto.
|
|
|
|
A differenza di :ref:`CanvasItem.visible<class_CanvasItem_property_visible>`, la visibilità di un **CanvasLayer** non è propagata ai livelli sottostanti.
|
|
|
|
.. rst-class:: classref-section-separator
|
|
|
|
----
|
|
|
|
.. rst-class:: classref-descriptions-group
|
|
|
|
Descrizioni dei metodi
|
|
--------------------------------------------
|
|
|
|
.. _class_CanvasLayer_method_get_canvas:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`RID<class_RID>` **get_canvas**\ (\ ) |const| :ref:`🔗<class_CanvasLayer_method_get_canvas>`
|
|
|
|
Restituisce il RID del canvas utilizzato da questo livello.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_method_get_final_transform:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
:ref:`Transform2D<class_Transform2D>` **get_final_transform**\ (\ ) |const| :ref:`🔗<class_CanvasLayer_method_get_final_transform>`
|
|
|
|
Restituisce la trasformazione dal sistema di coordinate del **CanvasLayer** al sistema di coordinate della :ref:`Viewport<class_Viewport>`.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_method_hide:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **hide**\ (\ ) :ref:`🔗<class_CanvasLayer_method_hide>`
|
|
|
|
Nasconde qualsiasi :ref:`CanvasItem<class_CanvasItem>` sotto questo **CanvasLayer**. Ciò equivale a impostare :ref:`visible<class_CanvasLayer_property_visible>` su ``false``.
|
|
|
|
.. rst-class:: classref-item-separator
|
|
|
|
----
|
|
|
|
.. _class_CanvasLayer_method_show:
|
|
|
|
.. rst-class:: classref-method
|
|
|
|
|void| **show**\ (\ ) :ref:`🔗<class_CanvasLayer_method_show>`
|
|
|
|
Mostra qualsiasi :ref:`CanvasItem<class_CanvasItem>` sotto questo **CanvasLayer**. Ciò equivale a impostare :ref:`visible<class_CanvasLayer_property_visible>` su ``true``.
|
|
|
|
.. |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.)`
|