Files
godot-docs-l10n/classes/it/class_backbuffercopy.rst
2025-09-30 13:31:55 +02:00

129 lines
5.4 KiB
ReStructuredText

:github_url: hide
.. _class_BackBufferCopy:
BackBufferCopy
==============
**Eredita:** :ref:`Node2D<class_Node2D>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Un nodo che copia una regione dello schermo in un buffer per l'accesso nel codice di shader.
.. rst-class:: classref-introduction-group
Descrizione
----------------------
Nodo per il back-buffering dello schermo attualmente visualizzato. La regione definita nel nodo **BackBufferCopy** viene bufferizzata con il contenuto dello schermo che esso copre, o l'intero schermo in base a :ref:`copy_mode<class_BackBufferCopy_property_copy_mode>`. È possibile accedervi negli script degli shader attraverso la texture dello schermo (ovvero un campionatore uniforme con ``hint_screen_texture``).
\ **Nota:** Poiché questo nodo eredita da :ref:`Node2D<class_Node2D>` (e non da :ref:`Control<class_Control>`), gli ancoraggi e i margini non si applicheranno ai nodi figlio derivati da :ref:`Control<class_Control>`. Ciò può essere problematico quando si ridimensiona la finestra. Per evitare ciò, aggiungi i nodi derivati da :ref:`Control<class_Control>` come *fratelli* al nodo **BackBufferCopy** anziché aggiungerli come figli.
.. rst-class:: classref-introduction-group
Tutorial
----------------
- :doc:`Shader di lettura dello schermo <../tutorials/shaders/screen-reading_shaders>`
.. rst-class:: classref-reftable-group
Proprietà
------------------
.. table::
:widths: auto
+-----------------------------------------------+-----------------------------------------------------------+---------------------------------+
| :ref:`CopyMode<enum_BackBufferCopy_CopyMode>` | :ref:`copy_mode<class_BackBufferCopy_property_copy_mode>` | ``1`` |
+-----------------------------------------------+-----------------------------------------------------------+---------------------------------+
| :ref:`Rect2<class_Rect2>` | :ref:`rect<class_BackBufferCopy_property_rect>` | ``Rect2(-100, -100, 200, 200)`` |
+-----------------------------------------------+-----------------------------------------------------------+---------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Enumerazioni
------------------------
.. _enum_BackBufferCopy_CopyMode:
.. rst-class:: classref-enumeration
enum **CopyMode**: :ref:`🔗<enum_BackBufferCopy_CopyMode>`
.. _class_BackBufferCopy_constant_COPY_MODE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`CopyMode<enum_BackBufferCopy_CopyMode>` **COPY_MODE_DISABLED** = ``0``
Disabilita la modalità di buffering. Ciò significa che il nodo **BackBufferCopy** userà direttamente la porzione dello schermo che esso copre.
.. _class_BackBufferCopy_constant_COPY_MODE_RECT:
.. rst-class:: classref-enumeration-constant
:ref:`CopyMode<enum_BackBufferCopy_CopyMode>` **COPY_MODE_RECT** = ``1``
**BackBufferCopy** bufferizza una regione rettangolare.
.. _class_BackBufferCopy_constant_COPY_MODE_VIEWPORT:
.. rst-class:: classref-enumeration-constant
:ref:`CopyMode<enum_BackBufferCopy_CopyMode>` **COPY_MODE_VIEWPORT** = ``2``
**BackBufferCopy** bufferizza l'intero schermo.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà
------------------------------------------------------
.. _class_BackBufferCopy_property_copy_mode:
.. rst-class:: classref-property
:ref:`CopyMode<enum_BackBufferCopy_CopyMode>` **copy_mode** = ``1`` :ref:`🔗<class_BackBufferCopy_property_copy_mode>`
.. rst-class:: classref-property-setget
- |void| **set_copy_mode**\ (\ value\: :ref:`CopyMode<enum_BackBufferCopy_CopyMode>`\ )
- :ref:`CopyMode<enum_BackBufferCopy_CopyMode>` **get_copy_mode**\ (\ )
Modalità di buffer.
.. rst-class:: classref-item-separator
----
.. _class_BackBufferCopy_property_rect:
.. rst-class:: classref-property
:ref:`Rect2<class_Rect2>` **rect** = ``Rect2(-100, -100, 200, 200)`` :ref:`🔗<class_BackBufferCopy_property_rect>`
.. rst-class:: classref-property-setget
- |void| **set_rect**\ (\ value\: :ref:`Rect2<class_Rect2>`\ )
- :ref:`Rect2<class_Rect2>` **get_rect**\ (\ )
L'area coperta dal **BackBufferCopy**. Utilizzato solo se :ref:`copy_mode<class_BackBufferCopy_property_copy_mode>` è :ref:`COPY_MODE_RECT<class_BackBufferCopy_constant_COPY_MODE_RECT>`.
.. |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.)`